diff --git a/extensions/matrix/api.ts b/extensions/matrix/api.ts
index c84665236cea..435701091485 100644
--- a/extensions/matrix/api.ts
+++ b/extensions/matrix/api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export { matrixPlugin } from "./src/channel.js";
 export { createMatrixSetupWizardProxy, matrixSetupAdapter } from "./src/setup-core.js";
 export { matrixOnboardingAdapter } from "./src/setup-surface.js";
diff --git a/extensions/matrix/auth-presence.ts b/extensions/matrix/auth-presence.ts
index 6110f079e257..bafa4ee8257f 100644
--- a/extensions/matrix/auth-presence.ts
+++ b/extensions/matrix/auth-presence.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements auth presence behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/cli-metadata.ts b/extensions/matrix/cli-metadata.ts
index a37a38a96960..dfefe790a5e4 100644
--- a/extensions/matrix/cli-metadata.ts
+++ b/extensions/matrix/cli-metadata.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements cli metadata behavior.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { registerMatrixCliMetadata } from "./src/cli-metadata.js";
 
diff --git a/extensions/matrix/contract-api.ts b/extensions/matrix/contract-api.ts
index c7df30d9b2fa..157a22bca51e 100644
--- a/extensions/matrix/contract-api.ts
+++ b/extensions/matrix/contract-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export {
   createMatrixThreadBindingManager,
   resetMatrixThreadBindingsForTests,
diff --git a/extensions/matrix/doctor-contract-api.ts b/extensions/matrix/doctor-contract-api.ts
index a7a56f234421..394ddd9b827b 100644
--- a/extensions/matrix/doctor-contract-api.ts
+++ b/extensions/matrix/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Matrix API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
diff --git a/extensions/matrix/helper-api.ts b/extensions/matrix/helper-api.ts
index 1ed6a08fbc3d..15e576f39bd8 100644
--- a/extensions/matrix/helper-api.ts
+++ b/extensions/matrix/helper-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export * from "./src/account-selection.js";
 export * from "./src/env-vars.js";
 export * from "./src/storage-paths.js";
diff --git a/extensions/matrix/index.test.ts b/extensions/matrix/index.test.ts
index beaaeaf6ba73..0364701932a8 100644
--- a/extensions/matrix/index.test.ts
+++ b/extensions/matrix/index.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover index plugin behavior.
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { describe, expect, it, vi } from "vitest";
 import { registerMatrixCliMetadata } from "./cli-metadata.js";
diff --git a/extensions/matrix/index.ts b/extensions/matrix/index.ts
index 39d0aee6c24d..060377cdb7dd 100644
--- a/extensions/matrix/index.ts
+++ b/extensions/matrix/index.ts
@@ -1,3 +1,4 @@
+// Matrix plugin entrypoint registers its OpenClaw integration.
 import {
   defineBundledChannelEntry,
   type OpenClawPluginApi,
diff --git a/extensions/matrix/plugin-entry.handlers.runtime.ts b/extensions/matrix/plugin-entry.handlers.runtime.ts
index f9145dad9437..88fc98949d53 100644
--- a/extensions/matrix/plugin-entry.handlers.runtime.ts
+++ b/extensions/matrix/plugin-entry.handlers.runtime.ts
@@ -1 +1,2 @@
+// Matrix plugin module implements plugin entry.handlers behavior.
 export * from "./src/plugin-entry.runtime.ts";
diff --git a/extensions/matrix/runtime-api.ts b/extensions/matrix/runtime-api.ts
index 1ad6c92181ac..d919b8e35dd6 100644
--- a/extensions/matrix/runtime-api.ts
+++ b/extensions/matrix/runtime-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export {
   type MatrixResolvedStringField,
   type MatrixResolvedStringValues,
diff --git a/extensions/matrix/runtime-heavy-api.ts b/extensions/matrix/runtime-heavy-api.ts
index 833dcb1cc5c2..1ff51fef7c36 100644
--- a/extensions/matrix/runtime-heavy-api.ts
+++ b/extensions/matrix/runtime-heavy-api.ts
@@ -1 +1,2 @@
+// Matrix API module exposes the plugin public contract.
 export * from "./src/matrix-migration.runtime.js";
diff --git a/extensions/matrix/secret-contract-api.ts b/extensions/matrix/secret-contract-api.ts
index 9f44ef28569c..be750ae684de 100644
--- a/extensions/matrix/secret-contract-api.ts
+++ b/extensions/matrix/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/matrix/setup-entry.ts b/extensions/matrix/setup-entry.ts
index eeb16770fd6a..803476f8a714 100644
--- a/extensions/matrix/setup-entry.ts
+++ b/extensions/matrix/setup-entry.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/matrix/src/account-selection.test.ts b/extensions/matrix/src/account-selection.test.ts
index 1e3a5a4fe392..58e5d9a00488 100644
--- a/extensions/matrix/src/account-selection.test.ts
+++ b/extensions/matrix/src/account-selection.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover account selection plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/matrix/src/account-selection.ts b/extensions/matrix/src/account-selection.ts
index fe86fbc5ef83..62449d690f75 100644
--- a/extensions/matrix/src/account-selection.ts
+++ b/extensions/matrix/src/account-selection.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements account selection behavior.
 import {
   listCombinedAccountIds,
   listConfiguredAccountIds,
diff --git a/extensions/matrix/src/actions.account-propagation.test.ts b/extensions/matrix/src/actions.account-propagation.test.ts
index fa07baf4b0b8..30518d761732 100644
--- a/extensions/matrix/src/actions.account-propagation.test.ts
+++ b/extensions/matrix/src/actions.account-propagation.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover actions.account propagation plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { ChannelMessageActionContext } from "../runtime-api.js";
 import type { CoreConfig } from "./types.js";
diff --git a/extensions/matrix/src/actions.test.ts b/extensions/matrix/src/actions.test.ts
index 82f09ddc6201..aa85b5e42c74 100644
--- a/extensions/matrix/src/actions.test.ts
+++ b/extensions/matrix/src/actions.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover actions plugin behavior.
 import { beforeEach, describe, expect, it } from "vitest";
 import type { PluginRuntime } from "../runtime-api.js";
 import { matrixMessageActions } from "./actions.js";
diff --git a/extensions/matrix/src/actions.ts b/extensions/matrix/src/actions.ts
index 0bd561e2be27..37227ecf6ef1 100644
--- a/extensions/matrix/src/actions.ts
+++ b/extensions/matrix/src/actions.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements actions behavior.
 import {
   createActionGate,
   readPositiveIntegerParam,
diff --git a/extensions/matrix/src/approval-auth.test.ts b/extensions/matrix/src/approval-auth.test.ts
index 8298f6d9822a..b15440fdd0ad 100644
--- a/extensions/matrix/src/approval-auth.test.ts
+++ b/extensions/matrix/src/approval-auth.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { matrixApprovalAuth } from "./approval-auth.js";
 
diff --git a/extensions/matrix/src/approval-auth.ts b/extensions/matrix/src/approval-auth.ts
index f35494e0149d..6587edf4c09b 100644
--- a/extensions/matrix/src/approval-auth.ts
+++ b/extensions/matrix/src/approval-auth.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,
diff --git a/extensions/matrix/src/approval-handler.runtime.test.ts b/extensions/matrix/src/approval-handler.runtime.test.ts
index ee77202d77b8..56f2ebfa6740 100644
--- a/extensions/matrix/src/approval-handler.runtime.test.ts
+++ b/extensions/matrix/src/approval-handler.runtime.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover approval handler plugin behavior.
 import type {
   ExecApprovalRequest,
   PluginApprovalRequest,
diff --git a/extensions/matrix/src/approval-handler.runtime.ts b/extensions/matrix/src/approval-handler.runtime.ts
index abbae6f78cf3..b360e4c7846d 100644
--- a/extensions/matrix/src/approval-handler.runtime.ts
+++ b/extensions/matrix/src/approval-handler.runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements approval handler behavior.
 import { setTimeout as sleep } from "node:timers/promises";
 import type {
   ChannelApprovalCapabilityHandlerContext,
diff --git a/extensions/matrix/src/approval-ids.ts b/extensions/matrix/src/approval-ids.ts
index 167ef7066d24..f38064a50200 100644
--- a/extensions/matrix/src/approval-ids.ts
+++ b/extensions/matrix/src/approval-ids.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements approval ids behavior.
 import { normalizeMatrixUserId } from "./matrix/monitor/allowlist.js";
 
 export function normalizeMatrixApproverId(value: string | number): string | undefined {
diff --git a/extensions/matrix/src/approval-native.test.ts b/extensions/matrix/src/approval-native.test.ts
index 4f00dcbe79e3..2e022b1ec270 100644
--- a/extensions/matrix/src/approval-native.test.ts
+++ b/extensions/matrix/src/approval-native.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover approval native plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import { matrixApprovalCapability } from "./approval-native.js";
diff --git a/extensions/matrix/src/approval-native.ts b/extensions/matrix/src/approval-native.ts
index 8d7b7e158874..a6b8e430d94b 100644
--- a/extensions/matrix/src/approval-native.ts
+++ b/extensions/matrix/src/approval-native.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements approval native behavior.
 import {
   createChannelApprovalCapability,
   createApproverRestrictedNativeApprovalCapability,
diff --git a/extensions/matrix/src/approval-reaction-auth.ts b/extensions/matrix/src/approval-reaction-auth.ts
index 88850994649f..848080985043 100644
--- a/extensions/matrix/src/approval-reaction-auth.ts
+++ b/extensions/matrix/src/approval-reaction-auth.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements approval reaction auth behavior.
 import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 import { normalizeMatrixApproverId } from "./approval-ids.js";
 import { resolveMatrixAccount } from "./matrix/accounts.js";
diff --git a/extensions/matrix/src/approval-reactions.test.ts b/extensions/matrix/src/approval-reactions.test.ts
index 4e2c657b0f47..11e98d4b4c7c 100644
--- a/extensions/matrix/src/approval-reactions.test.ts
+++ b/extensions/matrix/src/approval-reactions.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover approval reactions plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   buildMatrixApprovalReactionHint,
diff --git a/extensions/matrix/src/approval-reactions.ts b/extensions/matrix/src/approval-reactions.ts
index f4676e2b4d17..4b8c20702736 100644
--- a/extensions/matrix/src/approval-reactions.ts
+++ b/extensions/matrix/src/approval-reactions.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements approval reactions behavior.
 import type { ExecApprovalReplyDecision } from "openclaw/plugin-sdk/approval-runtime";
 import { getOptionalMatrixRuntime } from "./runtime.js";
 
diff --git a/extensions/matrix/src/auth-precedence.ts b/extensions/matrix/src/auth-precedence.ts
index 244a7eb9e902..3ee3b8c93fcb 100644
--- a/extensions/matrix/src/auth-precedence.ts
+++ b/extensions/matrix/src/auth-precedence.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements auth precedence behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 
 export type MatrixResolvedStringField =
diff --git a/extensions/matrix/src/channel-account-paths.ts b/extensions/matrix/src/channel-account-paths.ts
index 0d1cdc9bf9d9..dc086de73e9a 100644
--- a/extensions/matrix/src/channel-account-paths.ts
+++ b/extensions/matrix/src/channel-account-paths.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements channel account paths behavior.
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
 import type { PinnedDispatcherPolicy, SsrFPolicy } from "openclaw/plugin-sdk/ssrf-dispatcher";
diff --git a/extensions/matrix/src/channel.account-paths.test.ts b/extensions/matrix/src/channel.account-paths.test.ts
index 39038e2c3899..7f6e5eb535a7 100644
--- a/extensions/matrix/src/channel.account-paths.test.ts
+++ b/extensions/matrix/src/channel.account-paths.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover channel.account paths plugin behavior.
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createMatrixPairingText, createMatrixProbeAccount } from "./channel-account-paths.js";
diff --git a/extensions/matrix/src/channel.directory.test.ts b/extensions/matrix/src/channel.directory.test.ts
index 596cbdbc918d..6420e8ae7494 100644
--- a/extensions/matrix/src/channel.directory.test.ts
+++ b/extensions/matrix/src/channel.directory.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover channelirectory plugin behavior.
 import { createRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { beforeEach, describe, expect, it } from "vitest";
 import type { RuntimeEnv } from "../runtime-api.js";
diff --git a/extensions/matrix/src/channel.message-adapter.test.ts b/extensions/matrix/src/channel.message-adapter.test.ts
index 7d2e3b27c1e9..83e377a0b001 100644
--- a/extensions/matrix/src/channel.message-adapter.test.ts
+++ b/extensions/matrix/src/channel.message-adapter.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover channel.message adapter plugin behavior.
 import {
   verifyChannelMessageAdapterCapabilityProofs,
   verifyChannelMessageLiveCapabilityAdapterProofs,
diff --git a/extensions/matrix/src/channel.resolve.test.ts b/extensions/matrix/src/channel.resolve.test.ts
index 4bad09d2ce65..eaffa7bddaac 100644
--- a/extensions/matrix/src/channel.resolve.test.ts
+++ b/extensions/matrix/src/channel.resolve.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover channel.resolve plugin behavior.
 import { createNonExitingRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/matrix/src/channel.runtime.ts b/extensions/matrix/src/channel.runtime.ts
index dba1d8c6ef5e..ab3c08100543 100644
--- a/extensions/matrix/src/channel.runtime.ts
+++ b/extensions/matrix/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements channel behavior.
 import { listMatrixDirectoryGroupsLive, listMatrixDirectoryPeersLive } from "./directory-live.js";
 import { resolveMatrixAuth } from "./matrix/client.js";
 import { probeMatrix } from "./matrix/probe.js";
diff --git a/extensions/matrix/src/channel.setup.test.ts b/extensions/matrix/src/channel.setup.test.ts
index a4c8944222e4..ca8942c34d24 100644
--- a/extensions/matrix/src/channel.setup.test.ts
+++ b/extensions/matrix/src/channel.setup.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover channel.setup plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { RuntimeEnv } from "../runtime-api.js";
 
diff --git a/extensions/matrix/src/channel.setup.ts b/extensions/matrix/src/channel.setup.ts
index 29164c96995c..b3ecdba6f1eb 100644
--- a/extensions/matrix/src/channel.setup.ts
+++ b/extensions/matrix/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements channel.setup behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import type { ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { matrixConfigAdapter } from "./config-adapter.js";
diff --git a/extensions/matrix/src/channel.ts b/extensions/matrix/src/channel.ts
index 71e3e1735013..b8667b97b8c3 100644
--- a/extensions/matrix/src/channel.ts
+++ b/extensions/matrix/src/channel.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements channel behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import {
   adaptScopedAccountAccessor,
diff --git a/extensions/matrix/src/cli-metadata.ts b/extensions/matrix/src/cli-metadata.ts
index 3429f3943f88..56d0c475fdcb 100644
--- a/extensions/matrix/src/cli-metadata.ts
+++ b/extensions/matrix/src/cli-metadata.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements cli metadata behavior.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
 
 export function registerMatrixCliMetadata(api: OpenClawPluginApi) {
diff --git a/extensions/matrix/src/cli.test.ts b/extensions/matrix/src/cli.test.ts
index ebe3ae946274..69d89bfab562 100644
--- a/extensions/matrix/src/cli.test.ts
+++ b/extensions/matrix/src/cli.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover cli plugin behavior.
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { registerMatrixCli, resetMatrixCliStateForTests } from "./cli.js";
diff --git a/extensions/matrix/src/cli.ts b/extensions/matrix/src/cli.ts
index f4270e86a5dd..37dfd7ded3d7 100644
--- a/extensions/matrix/src/cli.ts
+++ b/extensions/matrix/src/cli.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements cli behavior.
 import type { Command } from "commander";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { parseStrictInteger, timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/matrix/src/config-adapter.ts b/extensions/matrix/src/config-adapter.ts
index 6d2433682cb9..e371cedce610 100644
--- a/extensions/matrix/src/config-adapter.ts
+++ b/extensions/matrix/src/config-adapter.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports config adapter behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import {
   adaptScopedAccountAccessor,
diff --git a/extensions/matrix/src/config-schema.test.ts b/extensions/matrix/src/config-schema.test.ts
index d7c625cbbe48..e23cae6db35f 100644
--- a/extensions/matrix/src/config-schema.test.ts
+++ b/extensions/matrix/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MatrixConfigSchema } from "./config-schema.js";
 
diff --git a/extensions/matrix/src/config-schema.ts b/extensions/matrix/src/config-schema.ts
index 042072a36c60..95b4b0a4682a 100644
--- a/extensions/matrix/src/config-schema.ts
+++ b/extensions/matrix/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports config schema behavior.
 import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-primitives";
 import {
   AllowFromListSchema,
diff --git a/extensions/matrix/src/config-ui-hints.ts b/extensions/matrix/src/config-ui-hints.ts
index 22325d162e1e..d9b62b209f12 100644
--- a/extensions/matrix/src/config-ui-hints.ts
+++ b/extensions/matrix/src/config-ui-hints.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports config ui hints behavior.
 import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/channel-core";
 
 export const matrixChannelConfigUiHints = {
diff --git a/extensions/matrix/src/directory-live.test.ts b/extensions/matrix/src/directory-live.test.ts
index 9bd939460f22..ef0d875e4272 100644
--- a/extensions/matrix/src/directory-live.test.ts
+++ b/extensions/matrix/src/directory-live.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover directory live plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const { matrixAuthedHttpClientCtorMock, requestJsonMock } = vi.hoisted(() => ({
diff --git a/extensions/matrix/src/directory-live.ts b/extensions/matrix/src/directory-live.ts
index f69019e870a9..22587a87391a 100644
--- a/extensions/matrix/src/directory-live.ts
+++ b/extensions/matrix/src/directory-live.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements directory live behavior.
 import {
   normalizeLowercaseStringOrEmpty,
   normalizeOptionalString,
diff --git a/extensions/matrix/src/doctor-contract.ts b/extensions/matrix/src/doctor-contract.ts
index e4407ec51849..31d470d6757c 100644
--- a/extensions/matrix/src/doctor-contract.ts
+++ b/extensions/matrix/src/doctor-contract.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements doctor contract behavior.
 import type {
   ChannelDoctorConfigMutation,
   ChannelDoctorLegacyConfigRule,
diff --git a/extensions/matrix/src/doctor.test.ts b/extensions/matrix/src/doctor.test.ts
index 86b4aa46bfca..b617062f9d61 100644
--- a/extensions/matrix/src/doctor.test.ts
+++ b/extensions/matrix/src/doctor.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover doctor plugin behavior.
 import fs from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/doctor.ts b/extensions/matrix/src/doctor.ts
index d5d0cc15f8a1..5abd0fb100af 100644
--- a/extensions/matrix/src/doctor.ts
+++ b/extensions/matrix/src/doctor.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements doctor behavior.
 import type { ChannelDoctorAdapter } from "openclaw/plugin-sdk/channel-contract";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/matrix/src/env-vars.ts b/extensions/matrix/src/env-vars.ts
index ac16c416ffc7..0639d9777651 100644
--- a/extensions/matrix/src/env-vars.ts
+++ b/extensions/matrix/src/env-vars.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements env vars behavior.
 import { normalizeAccountId, normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-id";
 
 const MATRIX_SCOPED_ENV_SUFFIXES = [
diff --git a/extensions/matrix/src/exec-approval-resolver.test.ts b/extensions/matrix/src/exec-approval-resolver.test.ts
index 7d5e499c62ff..c160b5d77881 100644
--- a/extensions/matrix/src/exec-approval-resolver.test.ts
+++ b/extensions/matrix/src/exec-approval-resolver.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover exec approval resolver plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const approvalRuntimeHoisted = vi.hoisted(() => ({
diff --git a/extensions/matrix/src/exec-approval-resolver.ts b/extensions/matrix/src/exec-approval-resolver.ts
index cf62aab7bc53..a2af0983c52b 100644
--- a/extensions/matrix/src/exec-approval-resolver.ts
+++ b/extensions/matrix/src/exec-approval-resolver.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements exec approval resolver behavior.
 import { resolveApprovalOverGateway } from "openclaw/plugin-sdk/approval-gateway-runtime";
 import type { ExecApprovalReplyDecision } from "openclaw/plugin-sdk/approval-runtime";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/matrix/src/exec-approvals.test.ts b/extensions/matrix/src/exec-approvals.test.ts
index 37146ad51019..d54d7892ad60 100644
--- a/extensions/matrix/src/exec-approvals.test.ts
+++ b/extensions/matrix/src/exec-approvals.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover exec approvals plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/exec-approvals.ts b/extensions/matrix/src/exec-approvals.ts
index 4db5b143aeb1..3974ef182697 100644
--- a/extensions/matrix/src/exec-approvals.ts
+++ b/extensions/matrix/src/exec-approvals.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements exec approvals behavior.
 import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 import {
   createChannelExecApprovalProfile,
diff --git a/extensions/matrix/src/group-mentions.test.ts b/extensions/matrix/src/group-mentions.test.ts
index e6c6fc0799df..787f4e7708b9 100644
--- a/extensions/matrix/src/group-mentions.test.ts
+++ b/extensions/matrix/src/group-mentions.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover group mentions plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMatrixGroupToolPolicy } from "./group-mentions.js";
 
diff --git a/extensions/matrix/src/group-mentions.ts b/extensions/matrix/src/group-mentions.ts
index 400fc76428a6..f7d37dd33867 100644
--- a/extensions/matrix/src/group-mentions.ts
+++ b/extensions/matrix/src/group-mentions.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements group mentions behavior.
 import { resolveMatrixAccountConfig } from "./matrix/accounts.js";
 import { resolveMatrixRoomConfig } from "./matrix/monitor/rooms.js";
 import { normalizeMatrixResolvableTarget } from "./matrix/target-ids.js";
diff --git a/extensions/matrix/src/legacy-crypto-inspector-availability.test.ts b/extensions/matrix/src/legacy-crypto-inspector-availability.test.ts
index 78e316952ca9..eaf2ec85cd47 100644
--- a/extensions/matrix/src/legacy-crypto-inspector-availability.test.ts
+++ b/extensions/matrix/src/legacy-crypto-inspector-availability.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover legacy crypto inspector availability plugin behavior.
 import path from "node:path";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/matrix/src/legacy-crypto-inspector-availability.ts b/extensions/matrix/src/legacy-crypto-inspector-availability.ts
index bc7f229e58b1..5250d054a1bc 100644
--- a/extensions/matrix/src/legacy-crypto-inspector-availability.ts
+++ b/extensions/matrix/src/legacy-crypto-inspector-availability.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements legacy crypto inspector availability behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
diff --git a/extensions/matrix/src/legacy-crypto.test.ts b/extensions/matrix/src/legacy-crypto.test.ts
index e13aa0d68fba..6ab366031128 100644
--- a/extensions/matrix/src/legacy-crypto.test.ts
+++ b/extensions/matrix/src/legacy-crypto.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover legacy crypto plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/matrix/src/legacy-crypto.ts b/extensions/matrix/src/legacy-crypto.ts
index 4d587b44ac27..a79d93d7ff8a 100644
--- a/extensions/matrix/src/legacy-crypto.ts
+++ b/extensions/matrix/src/legacy-crypto.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements legacy crypto behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/legacy-state.test.ts b/extensions/matrix/src/legacy-state.test.ts
index 1c8a684b0a55..752d28a18c90 100644
--- a/extensions/matrix/src/legacy-state.test.ts
+++ b/extensions/matrix/src/legacy-state.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover legacy state plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/matrix/src/legacy-state.ts b/extensions/matrix/src/legacy-state.ts
index d53225fdf44c..52f00cd32031 100644
--- a/extensions/matrix/src/legacy-state.ts
+++ b/extensions/matrix/src/legacy-state.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements legacy state behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix-migration.runtime.ts b/extensions/matrix/src/matrix-migration.runtime.ts
index b163f2fbb193..61d60fbbfb32 100644
--- a/extensions/matrix/src/matrix-migration.runtime.ts
+++ b/extensions/matrix/src/matrix-migration.runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements matrix migration behavior.
 export { autoMigrateLegacyMatrixState, detectLegacyMatrixState } from "./legacy-state.js";
 export { autoPrepareLegacyMatrixCrypto, detectLegacyMatrixCrypto } from "./legacy-crypto.js";
 export {
diff --git a/extensions/matrix/src/matrix/account-config.ts b/extensions/matrix/src/matrix/account-config.ts
index 80ea4d8158a6..ad501fb82f6b 100644
--- a/extensions/matrix/src/matrix/account-config.ts
+++ b/extensions/matrix/src/matrix/account-config.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports account config behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import {
diff --git a/extensions/matrix/src/matrix/accounts.readiness.test.ts b/extensions/matrix/src/matrix/accounts.readiness.test.ts
index e132fe252909..97588618bddf 100644
--- a/extensions/matrix/src/matrix/accounts.readiness.test.ts
+++ b/extensions/matrix/src/matrix/accounts.readiness.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover accounts.readiness plugin behavior.
 import { describe, expect, it } from "vitest";
 import { installMatrixTestRuntime } from "../test-runtime.js";
 import type { CoreConfig } from "../types.js";
diff --git a/extensions/matrix/src/matrix/accounts.test.ts b/extensions/matrix/src/matrix/accounts.test.ts
index 18d8608922cb..f7196d544513 100644
--- a/extensions/matrix/src/matrix/accounts.test.ts
+++ b/extensions/matrix/src/matrix/accounts.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover accounts plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { getMatrixScopedEnvVarNames } from "../env-vars.js";
 import type { CoreConfig } from "../types.js";
diff --git a/extensions/matrix/src/matrix/accounts.ts b/extensions/matrix/src/matrix/accounts.ts
index 966b11d83740..7f9eee3d9c72 100644
--- a/extensions/matrix/src/matrix/accounts.ts
+++ b/extensions/matrix/src/matrix/accounts.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements accounts behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/matrix/src/matrix/actions.ts b/extensions/matrix/src/matrix/actions.ts
index d0d8b8810b3e..523392ac3996 100644
--- a/extensions/matrix/src/matrix/actions.ts
+++ b/extensions/matrix/src/matrix/actions.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements actions behavior.
 export type {
   MatrixActionClientOpts,
   MatrixMessageSummary,
diff --git a/extensions/matrix/src/matrix/actions/client.test.ts b/extensions/matrix/src/matrix/actions/client.test.ts
index cdcad4a69e80..e47ec718abfc 100644
--- a/extensions/matrix/src/matrix/actions/client.test.ts
+++ b/extensions/matrix/src/matrix/actions/client.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover client plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   createMockMatrixClient,
diff --git a/extensions/matrix/src/matrix/actions/client.ts b/extensions/matrix/src/matrix/actions/client.ts
index f80a74e466da..c0df91dbfeeb 100644
--- a/extensions/matrix/src/matrix/actions/client.ts
+++ b/extensions/matrix/src/matrix/actions/client.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements client behavior.
 import { withResolvedRuntimeMatrixClient } from "../client-bootstrap.js";
 import { resolveMatrixRoomId } from "../send.js";
 import type { MatrixActionClient, MatrixActionClientOpts } from "./types.js";
diff --git a/extensions/matrix/src/matrix/actions/devices.test.ts b/extensions/matrix/src/matrix/actions/devices.test.ts
index 8ea488e4119e..0ae0372b23f2 100644
--- a/extensions/matrix/src/matrix/actions/devices.test.ts
+++ b/extensions/matrix/src/matrix/actions/devices.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover devices plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const withResolvedActionClientMock = vi.fn();
diff --git a/extensions/matrix/src/matrix/actions/devices.ts b/extensions/matrix/src/matrix/actions/devices.ts
index c64a128712bf..9a07cd2ee842 100644
--- a/extensions/matrix/src/matrix/actions/devices.ts
+++ b/extensions/matrix/src/matrix/actions/devices.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements devices behavior.
 import { summarizeMatrixDeviceHealth } from "../device-health.js";
 import { withResolvedActionClient } from "./client.js";
 import type { MatrixActionClientOpts } from "./types.js";
diff --git a/extensions/matrix/src/matrix/actions/limits.test.ts b/extensions/matrix/src/matrix/actions/limits.test.ts
index d6c85ab7faef..fa48235b9508 100644
--- a/extensions/matrix/src/matrix/actions/limits.test.ts
+++ b/extensions/matrix/src/matrix/actions/limits.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover limits plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMatrixActionLimit } from "./limits.js";
 
diff --git a/extensions/matrix/src/matrix/actions/limits.ts b/extensions/matrix/src/matrix/actions/limits.ts
index 7a6512eba39c..41457c84b616 100644
--- a/extensions/matrix/src/matrix/actions/limits.ts
+++ b/extensions/matrix/src/matrix/actions/limits.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements limits behavior.
 import { resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";
 
 export function resolveMatrixActionLimit(raw: unknown, fallback: number): number {
diff --git a/extensions/matrix/src/matrix/actions/messages.test.ts b/extensions/matrix/src/matrix/actions/messages.test.ts
index c6a72572ca72..981282cd7357 100644
--- a/extensions/matrix/src/matrix/actions/messages.test.ts
+++ b/extensions/matrix/src/matrix/actions/messages.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover messages plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { setMatrixRuntime } from "../../runtime.js";
 import type { MatrixClient } from "../sdk.js";
diff --git a/extensions/matrix/src/matrix/actions/messages.ts b/extensions/matrix/src/matrix/actions/messages.ts
index 61333b6945d5..a511f3444112 100644
--- a/extensions/matrix/src/matrix/actions/messages.ts
+++ b/extensions/matrix/src/matrix/actions/messages.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements messages behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { fetchMatrixPollMessageSummary, resolveMatrixPollRootEventId } from "../poll-summary.js";
 import { isPollEventType } from "../poll-types.js";
diff --git a/extensions/matrix/src/matrix/actions/pins.test.ts b/extensions/matrix/src/matrix/actions/pins.test.ts
index e102a9305aad..32dbb9a14af5 100644
--- a/extensions/matrix/src/matrix/actions/pins.test.ts
+++ b/extensions/matrix/src/matrix/actions/pins.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover pins plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { MatrixClient } from "../sdk.js";
 import { listMatrixPins, pinMatrixMessage, unpinMatrixMessage } from "./pins.js";
diff --git a/extensions/matrix/src/matrix/actions/pins.ts b/extensions/matrix/src/matrix/actions/pins.ts
index 6ab1f63e281a..498c77ead429 100644
--- a/extensions/matrix/src/matrix/actions/pins.ts
+++ b/extensions/matrix/src/matrix/actions/pins.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements pins behavior.
 import { withResolvedRoomAction } from "./client.js";
 import { fetchEventSummary, readPinnedEvents } from "./summary.js";
 import {
diff --git a/extensions/matrix/src/matrix/actions/polls.test.ts b/extensions/matrix/src/matrix/actions/polls.test.ts
index f18df0c418a7..080e8db4c050 100644
--- a/extensions/matrix/src/matrix/actions/polls.test.ts
+++ b/extensions/matrix/src/matrix/actions/polls.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover polls plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { MatrixClient } from "../sdk.js";
 import { voteMatrixPoll } from "./polls.js";
diff --git a/extensions/matrix/src/matrix/actions/polls.ts b/extensions/matrix/src/matrix/actions/polls.ts
index 01233d434ee7..d4ebee48d12e 100644
--- a/extensions/matrix/src/matrix/actions/polls.ts
+++ b/extensions/matrix/src/matrix/actions/polls.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements polls behavior.
 import { uniqueStrings, uniqueValues } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
   buildPollResponseContent,
diff --git a/extensions/matrix/src/matrix/actions/profile.test.ts b/extensions/matrix/src/matrix/actions/profile.test.ts
index 49c412869979..97c0f4646be7 100644
--- a/extensions/matrix/src/matrix/actions/profile.test.ts
+++ b/extensions/matrix/src/matrix/actions/profile.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover profile plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const loadWebMediaMock = vi.fn();
diff --git a/extensions/matrix/src/matrix/actions/profile.ts b/extensions/matrix/src/matrix/actions/profile.ts
index d4ff78cc45d5..381b32b0ab24 100644
--- a/extensions/matrix/src/matrix/actions/profile.ts
+++ b/extensions/matrix/src/matrix/actions/profile.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements profile behavior.
 import { getMatrixRuntime } from "../../runtime.js";
 import { syncMatrixOwnProfile, type MatrixProfileSyncResult } from "../profile.js";
 import { withResolvedActionClient } from "./client.js";
diff --git a/extensions/matrix/src/matrix/actions/reactions.test.ts b/extensions/matrix/src/matrix/actions/reactions.test.ts
index dcb648fba3db..d94926ecdede 100644
--- a/extensions/matrix/src/matrix/actions/reactions.test.ts
+++ b/extensions/matrix/src/matrix/actions/reactions.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover reactions plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { MatrixClient } from "../sdk.js";
 import { listMatrixReactions, removeMatrixReactions } from "./reactions.js";
diff --git a/extensions/matrix/src/matrix/actions/reactions.ts b/extensions/matrix/src/matrix/actions/reactions.ts
index 4a7f8d9b352c..3c0187f7557d 100644
--- a/extensions/matrix/src/matrix/actions/reactions.ts
+++ b/extensions/matrix/src/matrix/actions/reactions.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements reactions behavior.
 import {
   buildMatrixReactionRelationsPath,
   selectOwnMatrixReactionEventIds,
diff --git a/extensions/matrix/src/matrix/actions/room.test.ts b/extensions/matrix/src/matrix/actions/room.test.ts
index e87f1fd64413..89c24c19607b 100644
--- a/extensions/matrix/src/matrix/actions/room.test.ts
+++ b/extensions/matrix/src/matrix/actions/room.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover room plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { MatrixClient } from "../sdk.js";
 import { getMatrixMemberInfo, getMatrixRoomInfo } from "./room.js";
diff --git a/extensions/matrix/src/matrix/actions/room.ts b/extensions/matrix/src/matrix/actions/room.ts
index 87684252cbee..c562f1e26e3c 100644
--- a/extensions/matrix/src/matrix/actions/room.ts
+++ b/extensions/matrix/src/matrix/actions/room.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements room behavior.
 import { resolveMatrixRoomId } from "../send.js";
 import { withResolvedActionClient, withResolvedRoomAction } from "./client.js";
 import { EventType, type MatrixActionClientOpts } from "./types.js";
diff --git a/extensions/matrix/src/matrix/actions/summary.test.ts b/extensions/matrix/src/matrix/actions/summary.test.ts
index 3beb16fda1ff..246d890186c3 100644
--- a/extensions/matrix/src/matrix/actions/summary.test.ts
+++ b/extensions/matrix/src/matrix/actions/summary.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover summary plugin behavior.
 import { describe, expect, it } from "vitest";
 import { summarizeMatrixRawEvent } from "./summary.js";
 
diff --git a/extensions/matrix/src/matrix/actions/summary.ts b/extensions/matrix/src/matrix/actions/summary.ts
index 7cce088199db..2b7aeb0388db 100644
--- a/extensions/matrix/src/matrix/actions/summary.ts
+++ b/extensions/matrix/src/matrix/actions/summary.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements summary behavior.
 import { isMatrixNotFoundError } from "../errors.js";
 import { resolveMatrixMessageAttachment, resolveMatrixMessageBody } from "../media-text.js";
 import { fetchMatrixPollMessageSummary } from "../poll-summary.js";
diff --git a/extensions/matrix/src/matrix/actions/types.ts b/extensions/matrix/src/matrix/actions/types.ts
index 23f95ce90b82..714da2b29a9e 100644
--- a/extensions/matrix/src/matrix/actions/types.ts
+++ b/extensions/matrix/src/matrix/actions/types.ts
@@ -1,3 +1,4 @@
+// Matrix type declarations define plugin contracts.
 import type { CoreConfig } from "../../types.js";
 import { MATRIX_REACTION_EVENT_TYPE } from "../reaction-common.js";
 import type { MatrixClient, MessageEventContent } from "../sdk.js";
diff --git a/extensions/matrix/src/matrix/actions/verification.test.ts b/extensions/matrix/src/matrix/actions/verification.test.ts
index d4f76048a342..3ef07f2c15d7 100644
--- a/extensions/matrix/src/matrix/actions/verification.test.ts
+++ b/extensions/matrix/src/matrix/actions/verification.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover verification plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const withResolvedActionClientMock = vi.fn();
diff --git a/extensions/matrix/src/matrix/actions/verification.ts b/extensions/matrix/src/matrix/actions/verification.ts
index 72bbe87050af..f9c7ca56fc22 100644
--- a/extensions/matrix/src/matrix/actions/verification.ts
+++ b/extensions/matrix/src/matrix/actions/verification.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements verification behavior.
 import { setTimeout as sleep } from "node:timers/promises";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/matrix/src/matrix/active-client.ts b/extensions/matrix/src/matrix/active-client.ts
index 990acb6f1165..48eca1934a6d 100644
--- a/extensions/matrix/src/matrix/active-client.ts
+++ b/extensions/matrix/src/matrix/active-client.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements active client behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import type { MatrixClient } from "./sdk.js";
 
diff --git a/extensions/matrix/src/matrix/async-lock.ts b/extensions/matrix/src/matrix/async-lock.ts
index 09f1b994c9d9..bbfe3d02ebf1 100644
--- a/extensions/matrix/src/matrix/async-lock.ts
+++ b/extensions/matrix/src/matrix/async-lock.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements async lock behavior.
 export type AsyncLock = <T>(fn: () => Promise<T>) => Promise<T>;
 
 export function createAsyncLock(): AsyncLock {
diff --git a/extensions/matrix/src/matrix/backup-health.ts b/extensions/matrix/src/matrix/backup-health.ts
index 79d702456b95..22eb1e7ba014 100644
--- a/extensions/matrix/src/matrix/backup-health.ts
+++ b/extensions/matrix/src/matrix/backup-health.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements backup health behavior.
 type MatrixRoomKeyBackupStatusLike = {
   serverVersion: string | null;
   activeVersion: string | null;
diff --git a/extensions/matrix/src/matrix/client-bootstrap.test.ts b/extensions/matrix/src/matrix/client-bootstrap.test.ts
index 9f1bb5aab33d..e7cf7fef42cf 100644
--- a/extensions/matrix/src/matrix/client-bootstrap.test.ts
+++ b/extensions/matrix/src/matrix/client-bootstrap.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover client bootstrap plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   createMockMatrixClient,
diff --git a/extensions/matrix/src/matrix/client-bootstrap.ts b/extensions/matrix/src/matrix/client-bootstrap.ts
index 4ea0dc0f96d1..736d5caaac26 100644
--- a/extensions/matrix/src/matrix/client-bootstrap.ts
+++ b/extensions/matrix/src/matrix/client-bootstrap.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements client bootstrap behavior.
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import type { CoreConfig } from "../types.js";
 import { getActiveMatrixClient } from "./active-client.js";
diff --git a/extensions/matrix/src/matrix/client-resolver.test-helpers.ts b/extensions/matrix/src/matrix/client-resolver.test-helpers.ts
index 29862f337a65..b39b2f007b47 100644
--- a/extensions/matrix/src/matrix/client-resolver.test-helpers.ts
+++ b/extensions/matrix/src/matrix/client-resolver.test-helpers.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports client resolver helpers behavior.
 import { expect, vi, type Mock } from "vitest";
 import type { MatrixClient } from "./sdk.js";
 
diff --git a/extensions/matrix/src/matrix/client.test.ts b/extensions/matrix/src/matrix/client.test.ts
index b962a357a015..b9dc65b15a81 100644
--- a/extensions/matrix/src/matrix/client.test.ts
+++ b/extensions/matrix/src/matrix/client.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover client plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { installMatrixTestRuntime } from "../test-runtime.js";
 import type { CoreConfig } from "../types.js";
diff --git a/extensions/matrix/src/matrix/client.ts b/extensions/matrix/src/matrix/client.ts
index a8375e589a3f..2afe96a2103f 100644
--- a/extensions/matrix/src/matrix/client.ts
+++ b/extensions/matrix/src/matrix/client.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements client behavior.
 export type { MatrixAuth } from "./client/types.js";
 export { isBunRuntime } from "./client/runtime.js";
 export { getMatrixScopedEnvVarNames } from "../env-vars.js";
diff --git a/extensions/matrix/src/matrix/client/config-runtime-api.ts b/extensions/matrix/src/matrix/client/config-runtime-api.ts
index b6bd64c21fbc..2de990c9db6d 100644
--- a/extensions/matrix/src/matrix/client/config-runtime-api.ts
+++ b/extensions/matrix/src/matrix/client/config-runtime-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export {
   DEFAULT_ACCOUNT_ID,
   normalizeAccountId,
diff --git a/extensions/matrix/src/matrix/client/config-secret-input.runtime.ts b/extensions/matrix/src/matrix/client/config-secret-input.runtime.ts
index 326a88eecaf4..8c474f1708ff 100644
--- a/extensions/matrix/src/matrix/client/config-secret-input.runtime.ts
+++ b/extensions/matrix/src/matrix/client/config-secret-input.runtime.ts
@@ -1 +1,2 @@
+// Matrix helper module supports config secret input behavior.
 export { resolveConfiguredSecretInputString } from "openclaw/plugin-sdk/secret-input-runtime";
diff --git a/extensions/matrix/src/matrix/client/config.test.ts b/extensions/matrix/src/matrix/client/config.test.ts
index 37d21ee21f7f..c8f7983289c6 100644
--- a/extensions/matrix/src/matrix/client/config.test.ts
+++ b/extensions/matrix/src/matrix/client/config.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover config plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { LookupFn } from "../../runtime-api.js";
 import { installMatrixTestRuntime } from "../../test-runtime.js";
diff --git a/extensions/matrix/src/matrix/client/config.ts b/extensions/matrix/src/matrix/client/config.ts
index 22da548d8b46..3a6a59c261b3 100644
--- a/extensions/matrix/src/matrix/client/config.ts
+++ b/extensions/matrix/src/matrix/client/config.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports config behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { resolveOptionalIntegerOption } from "openclaw/plugin-sdk/number-runtime";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
diff --git a/extensions/matrix/src/matrix/client/create-client.test.ts b/extensions/matrix/src/matrix/client/create-client.test.ts
index c73864d581ed..25245c4f5efc 100644
--- a/extensions/matrix/src/matrix/client/create-client.test.ts
+++ b/extensions/matrix/src/matrix/client/create-client.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover create client plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const ensureMatrixSdkLoggingConfiguredMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/matrix/src/matrix/client/create-client.ts b/extensions/matrix/src/matrix/client/create-client.ts
index e1a0503d68ae..70da38eedc83 100644
--- a/extensions/matrix/src/matrix/client/create-client.ts
+++ b/extensions/matrix/src/matrix/client/create-client.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements create client behavior.
 import fs from "node:fs";
 import type { PinnedDispatcherPolicy } from "openclaw/plugin-sdk/ssrf-dispatcher";
 import {
diff --git a/extensions/matrix/src/matrix/client/env-auth.ts b/extensions/matrix/src/matrix/client/env-auth.ts
index 862b57a345f2..5b67e37d0e62 100644
--- a/extensions/matrix/src/matrix/client/env-auth.ts
+++ b/extensions/matrix/src/matrix/client/env-auth.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements env auth behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { getMatrixScopedEnvVarNames } from "../../env-vars.js";
 
diff --git a/extensions/matrix/src/matrix/client/file-sync-store.test.ts b/extensions/matrix/src/matrix/client/file-sync-store.test.ts
index 30e7610c4edb..b6553334a46d 100644
--- a/extensions/matrix/src/matrix/client/file-sync-store.test.ts
+++ b/extensions/matrix/src/matrix/client/file-sync-store.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover file sync store plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/client/file-sync-store.ts b/extensions/matrix/src/matrix/client/file-sync-store.ts
index af951fea3e5b..348b64dca369 100644
--- a/extensions/matrix/src/matrix/client/file-sync-store.ts
+++ b/extensions/matrix/src/matrix/client/file-sync-store.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements file sync store behavior.
 import { readFileSync } from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/client/logging.test.ts b/extensions/matrix/src/matrix/client/logging.test.ts
index 6e827c1ed7fe..df29a0683602 100644
--- a/extensions/matrix/src/matrix/client/logging.test.ts
+++ b/extensions/matrix/src/matrix/client/logging.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover logging plugin behavior.
 import { logger as matrixJsSdkRootLogger } from "matrix-js-sdk/lib/logger.js";
 import { describe, expect, it, vi } from "vitest";
 import { ensureMatrixSdkLoggingConfigured, setMatrixSdkLogMode } from "./logging.js";
diff --git a/extensions/matrix/src/matrix/client/logging.ts b/extensions/matrix/src/matrix/client/logging.ts
index 4cd419cbf67d..e2bb5844479a 100644
--- a/extensions/matrix/src/matrix/client/logging.ts
+++ b/extensions/matrix/src/matrix/client/logging.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements logging behavior.
 import { logger as matrixJsSdkRootLogger } from "matrix-js-sdk/lib/logger.js";
 import { ConsoleLogger, LogService, setMatrixConsoleLogging } from "../sdk/logger.js";
 
diff --git a/extensions/matrix/src/matrix/client/migration-snapshot.runtime.ts b/extensions/matrix/src/matrix/client/migration-snapshot.runtime.ts
index 67e43c47aacf..a706d8b4b98d 100644
--- a/extensions/matrix/src/matrix/client/migration-snapshot.runtime.ts
+++ b/extensions/matrix/src/matrix/client/migration-snapshot.runtime.ts
@@ -1 +1,2 @@
+// Matrix plugin module implements migration snapshot behavior.
 export { maybeCreateMatrixMigrationSnapshot } from "../../migration-snapshot-backup.js";
diff --git a/extensions/matrix/src/matrix/client/private-network-host.ts b/extensions/matrix/src/matrix/client/private-network-host.ts
index d180c2acb584..5e0d2cc08162 100644
--- a/extensions/matrix/src/matrix/client/private-network-host.ts
+++ b/extensions/matrix/src/matrix/client/private-network-host.ts
@@ -1 +1,2 @@
+// Matrix plugin module implements private network host behavior.
 export { isPrivateOrLoopbackHost } from "openclaw/plugin-sdk/ssrf-runtime";
diff --git a/extensions/matrix/src/matrix/client/runtime.ts b/extensions/matrix/src/matrix/client/runtime.ts
index 4995eaf8d5cb..396ede2201f0 100644
--- a/extensions/matrix/src/matrix/client/runtime.ts
+++ b/extensions/matrix/src/matrix/client/runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements runtime behavior.
 export function isBunRuntime(): boolean {
   const versions = process.versions as { bun?: string };
   return typeof versions.bun === "string";
diff --git a/extensions/matrix/src/matrix/client/shared.test.ts b/extensions/matrix/src/matrix/client/shared.test.ts
index 198b111c32c5..e5fa1194764f 100644
--- a/extensions/matrix/src/matrix/client/shared.test.ts
+++ b/extensions/matrix/src/matrix/client/shared.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover shared plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { MatrixAuth } from "./types.js";
 
diff --git a/extensions/matrix/src/matrix/client/shared.ts b/extensions/matrix/src/matrix/client/shared.ts
index c622748d6fe6..013164de2908 100644
--- a/extensions/matrix/src/matrix/client/shared.ts
+++ b/extensions/matrix/src/matrix/client/shared.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements shared behavior.
 import { normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-id";
 import type { CoreConfig } from "../../types.js";
 import type { MatrixClient } from "../sdk.js";
diff --git a/extensions/matrix/src/matrix/client/storage.test.ts b/extensions/matrix/src/matrix/client/storage.test.ts
index 9a2c44ff0ab6..127a1d227476 100644
--- a/extensions/matrix/src/matrix/client/storage.test.ts
+++ b/extensions/matrix/src/matrix/client/storage.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover storage plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/client/storage.ts b/extensions/matrix/src/matrix/client/storage.ts
index 957c8b57d015..2716e2d4bb1d 100644
--- a/extensions/matrix/src/matrix/client/storage.ts
+++ b/extensions/matrix/src/matrix/client/storage.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements storage behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/client/types.ts b/extensions/matrix/src/matrix/client/types.ts
index 8bdb234df814..638c5d14d269 100644
--- a/extensions/matrix/src/matrix/client/types.ts
+++ b/extensions/matrix/src/matrix/client/types.ts
@@ -1,3 +1,4 @@
+// Matrix type declarations define plugin contracts.
 import type { PinnedDispatcherPolicy } from "openclaw/plugin-sdk/ssrf-dispatcher";
 import type { SsrFPolicy } from "../../runtime-api.js";
 
diff --git a/extensions/matrix/src/matrix/client/url-validation.ts b/extensions/matrix/src/matrix/client/url-validation.ts
index 975cf415488d..0ae186f3b135 100644
--- a/extensions/matrix/src/matrix/client/url-validation.ts
+++ b/extensions/matrix/src/matrix/client/url-validation.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements url validation behavior.
 import {
   assertHttpUrlTargetsPrivateNetwork,
   type LookupFn,
diff --git a/extensions/matrix/src/matrix/config-paths.ts b/extensions/matrix/src/matrix/config-paths.ts
index 56b34f5a19bb..cee80d30b5b6 100644
--- a/extensions/matrix/src/matrix/config-paths.ts
+++ b/extensions/matrix/src/matrix/config-paths.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports config paths behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import type { CoreConfig } from "../types.js";
 
diff --git a/extensions/matrix/src/matrix/config-update.test.ts b/extensions/matrix/src/matrix/config-update.test.ts
index 735e552a0c28..ca4e4696eaf7 100644
--- a/extensions/matrix/src/matrix/config-update.test.ts
+++ b/extensions/matrix/src/matrix/config-update.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover config update plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { CoreConfig } from "../types.js";
 import { resolveMatrixConfigFieldPath, updateMatrixAccountConfig } from "./config-update.js";
diff --git a/extensions/matrix/src/matrix/config-update.ts b/extensions/matrix/src/matrix/config-update.ts
index f5b92af16521..a74e78e994cd 100644
--- a/extensions/matrix/src/matrix/config-update.ts
+++ b/extensions/matrix/src/matrix/config-update.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports config update behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { resolveOptionalIntegerOption } from "openclaw/plugin-sdk/number-runtime";
 import { coerceSecretRef } from "openclaw/plugin-sdk/secret-ref-runtime";
diff --git a/extensions/matrix/src/matrix/credentials-read.ts b/extensions/matrix/src/matrix/credentials-read.ts
index bb75de011715..dabcdb052ccb 100644
--- a/extensions/matrix/src/matrix/credentials-read.ts
+++ b/extensions/matrix/src/matrix/credentials-read.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements credentials read behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/credentials-write.runtime.ts b/extensions/matrix/src/matrix/credentials-write.runtime.ts
index d482d718f45e..4ed91dc8f694 100644
--- a/extensions/matrix/src/matrix/credentials-write.runtime.ts
+++ b/extensions/matrix/src/matrix/credentials-write.runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements credentials write behavior.
 import type {
   saveBackfilledMatrixDeviceId as saveBackfilledMatrixDeviceIdType,
   saveMatrixCredentials as saveMatrixCredentialsType,
diff --git a/extensions/matrix/src/matrix/credentials.test.ts b/extensions/matrix/src/matrix/credentials.test.ts
index 604988cb4c0e..edaf854b9d31 100644
--- a/extensions/matrix/src/matrix/credentials.test.ts
+++ b/extensions/matrix/src/matrix/credentials.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover credentials plugin behavior.
 import fs from "node:fs";
 import fsPromises from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/matrix/src/matrix/credentials.ts b/extensions/matrix/src/matrix/credentials.ts
index 6b8650d36904..832d0b4c4d44 100644
--- a/extensions/matrix/src/matrix/credentials.ts
+++ b/extensions/matrix/src/matrix/credentials.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements credentials behavior.
 import { writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
 import { createAsyncLock, type AsyncLock } from "./async-lock.js";
 import { loadMatrixCredentials, resolveMatrixCredentialsPath } from "./credentials-read.js";
diff --git a/extensions/matrix/src/matrix/deps.test.ts b/extensions/matrix/src/matrix/deps.test.ts
index db18dc7d889c..ec2de968f798 100644
--- a/extensions/matrix/src/matrix/deps.test.ts
+++ b/extensions/matrix/src/matrix/deps.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover deps plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/deps.ts b/extensions/matrix/src/matrix/deps.ts
index 5eb8441e9ce2..4df8fe656704 100644
--- a/extensions/matrix/src/matrix/deps.ts
+++ b/extensions/matrix/src/matrix/deps.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements deps behavior.
 import { spawn } from "node:child_process";
 import fs from "node:fs";
 import { createRequire } from "node:module";
diff --git a/extensions/matrix/src/matrix/device-health.test.ts b/extensions/matrix/src/matrix/device-health.test.ts
index d56aaa9f81f5..bd92884dd359 100644
--- a/extensions/matrix/src/matrix/device-health.test.ts
+++ b/extensions/matrix/src/matrix/device-health.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover device health plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isOpenClawManagedMatrixDevice, summarizeMatrixDeviceHealth } from "./device-health.js";
 
diff --git a/extensions/matrix/src/matrix/device-health.ts b/extensions/matrix/src/matrix/device-health.ts
index 6f0d4408a550..8b0285bc569d 100644
--- a/extensions/matrix/src/matrix/device-health.ts
+++ b/extensions/matrix/src/matrix/device-health.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements device health behavior.
 export type MatrixManagedDeviceInfo = {
   deviceId: string;
   displayName: string | null;
diff --git a/extensions/matrix/src/matrix/direct-management.test.ts b/extensions/matrix/src/matrix/direct-management.test.ts
index e311d562e0f5..35d054762e80 100644
--- a/extensions/matrix/src/matrix/direct-management.test.ts
+++ b/extensions/matrix/src/matrix/direct-management.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover direct management plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   inspectMatrixDirectRooms,
diff --git a/extensions/matrix/src/matrix/direct-management.ts b/extensions/matrix/src/matrix/direct-management.ts
index d6458d2ad670..dbe11b172ab9 100644
--- a/extensions/matrix/src/matrix/direct-management.ts
+++ b/extensions/matrix/src/matrix/direct-management.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements direct management behavior.
 import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { inspectMatrixDirectRoomEvidence } from "./direct-room.js";
diff --git a/extensions/matrix/src/matrix/direct-room.test.ts b/extensions/matrix/src/matrix/direct-room.test.ts
index 2d4cc677662c..c1e8c6577e77 100644
--- a/extensions/matrix/src/matrix/direct-room.test.ts
+++ b/extensions/matrix/src/matrix/direct-room.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover direct room plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { inspectMatrixDirectRoomEvidence } from "./direct-room.js";
 import type { MatrixClient } from "./sdk.js";
diff --git a/extensions/matrix/src/matrix/direct-room.ts b/extensions/matrix/src/matrix/direct-room.ts
index b3bc71e5872d..645853a23b58 100644
--- a/extensions/matrix/src/matrix/direct-room.ts
+++ b/extensions/matrix/src/matrix/direct-room.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements direct room behavior.
 import type { MatrixClient } from "./sdk.js";
 
 function trimMaybeString(value: unknown): string | null {
diff --git a/extensions/matrix/src/matrix/draft-stream.test.ts b/extensions/matrix/src/matrix/draft-stream.test.ts
index 08c40a1ee538..f7d44c8b0ec4 100644
--- a/extensions/matrix/src/matrix/draft-stream.test.ts
+++ b/extensions/matrix/src/matrix/draft-stream.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover draft stream plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { PluginRuntime } from "../runtime-api.js";
 
diff --git a/extensions/matrix/src/matrix/draft-stream.ts b/extensions/matrix/src/matrix/draft-stream.ts
index 76950fd34874..244a4201eda5 100644
--- a/extensions/matrix/src/matrix/draft-stream.ts
+++ b/extensions/matrix/src/matrix/draft-stream.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements draft stream behavior.
 import { createDraftStreamLoop } from "openclaw/plugin-sdk/channel-outbound";
 import type { CoreConfig } from "../types.js";
 import type { MatrixClient } from "./sdk.js";
diff --git a/extensions/matrix/src/matrix/encryption-guidance.ts b/extensions/matrix/src/matrix/encryption-guidance.ts
index 85298c34546c..75b395544d60 100644
--- a/extensions/matrix/src/matrix/encryption-guidance.ts
+++ b/extensions/matrix/src/matrix/encryption-guidance.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements encryption guidance behavior.
 import { normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-id";
 import { resolveMatrixDefaultOrOnlyAccountId } from "../account-selection.js";
 import type { CoreConfig } from "../types.js";
diff --git a/extensions/matrix/src/matrix/errors.ts b/extensions/matrix/src/matrix/errors.ts
index a102d8320243..87b31854fee2 100644
--- a/extensions/matrix/src/matrix/errors.ts
+++ b/extensions/matrix/src/matrix/errors.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements errors behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/matrix/src/matrix/format.test.ts b/extensions/matrix/src/matrix/format.test.ts
index 2ebc20f4a3e0..5c888be28ad9 100644
--- a/extensions/matrix/src/matrix/format.test.ts
+++ b/extensions/matrix/src/matrix/format.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover format plugin behavior.
 import { describe, expect, it } from "vitest";
 import { markdownToMatrixHtml, renderMarkdownToMatrixHtmlWithMentions } from "./format.js";
 
diff --git a/extensions/matrix/src/matrix/format.ts b/extensions/matrix/src/matrix/format.ts
index 233651bce1eb..21ab0338dee9 100644
--- a/extensions/matrix/src/matrix/format.ts
+++ b/extensions/matrix/src/matrix/format.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports format behavior.
 import MarkdownIt from "markdown-it";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { isAutoLinkedFileRef } from "openclaw/plugin-sdk/text-autolink-runtime";
diff --git a/extensions/matrix/src/matrix/legacy-crypto-inspector.ts b/extensions/matrix/src/matrix/legacy-crypto-inspector.ts
index d628751ff82a..e21505882976 100644
--- a/extensions/matrix/src/matrix/legacy-crypto-inspector.ts
+++ b/extensions/matrix/src/matrix/legacy-crypto-inspector.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements legacy crypto inspector behavior.
 import crypto from "node:crypto";
 import fs from "node:fs";
 import { createRequire } from "node:module";
diff --git a/extensions/matrix/src/matrix/media-errors.ts b/extensions/matrix/src/matrix/media-errors.ts
index 1fdf391794b9..02285d82660f 100644
--- a/extensions/matrix/src/matrix/media-errors.ts
+++ b/extensions/matrix/src/matrix/media-errors.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements media errors behavior.
 const MATRIX_MEDIA_SIZE_LIMIT_ERROR_MESSAGE = "Matrix media exceeds configured size limit";
 
 export class MatrixMediaSizeLimitError extends Error {
diff --git a/extensions/matrix/src/matrix/media-text.ts b/extensions/matrix/src/matrix/media-text.ts
index 98b6c2b7ccef..b6fcd840689e 100644
--- a/extensions/matrix/src/matrix/media-text.ts
+++ b/extensions/matrix/src/matrix/media-text.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements media text behavior.
 import path from "node:path";
 import type {
   MatrixMessageAttachmentKind,
diff --git a/extensions/matrix/src/matrix/monitor/access-state.test.ts b/extensions/matrix/src/matrix/monitor/access-state.test.ts
index 7fa1c1ea626c..fff4babc4ccf 100644
--- a/extensions/matrix/src/matrix/monitor/access-state.test.ts
+++ b/extensions/matrix/src/matrix/monitor/access-state.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover access state plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveMatrixMonitorAccessState,
diff --git a/extensions/matrix/src/matrix/monitor/access-state.ts b/extensions/matrix/src/matrix/monitor/access-state.ts
index 85bd2d364e8f..456931464a0f 100644
--- a/extensions/matrix/src/matrix/monitor/access-state.ts
+++ b/extensions/matrix/src/matrix/monitor/access-state.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements access state behavior.
 import {
   createChannelIngressResolver,
   defineStableChannelIngressIdentity,
diff --git a/extensions/matrix/src/matrix/monitor/ack-config.test.ts b/extensions/matrix/src/matrix/monitor/ack-config.test.ts
index afba5890d335..8ddbca702d83 100644
--- a/extensions/matrix/src/matrix/monitor/ack-config.test.ts
+++ b/extensions/matrix/src/matrix/monitor/ack-config.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover ack config plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMatrixAckReactionConfig } from "./ack-config.js";
 
diff --git a/extensions/matrix/src/matrix/monitor/ack-config.ts b/extensions/matrix/src/matrix/monitor/ack-config.ts
index 1199dce84527..5e958020aa78 100644
--- a/extensions/matrix/src/matrix/monitor/ack-config.ts
+++ b/extensions/matrix/src/matrix/monitor/ack-config.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports ack config behavior.
 import { resolveAckReaction } from "openclaw/plugin-sdk/channel-feedback";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { CoreConfig } from "../../types.js";
diff --git a/extensions/matrix/src/matrix/monitor/allowlist.test.ts b/extensions/matrix/src/matrix/monitor/allowlist.test.ts
index d91ef71ceeb1..de25bac91d27 100644
--- a/extensions/matrix/src/matrix/monitor/allowlist.test.ts
+++ b/extensions/matrix/src/matrix/monitor/allowlist.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover allowlist plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeMatrixAllowList, resolveMatrixAllowListMatch } from "./allowlist.js";
 
diff --git a/extensions/matrix/src/matrix/monitor/allowlist.ts b/extensions/matrix/src/matrix/monitor/allowlist.ts
index 2af8cc2d8a66..52da6bd1dbb4 100644
--- a/extensions/matrix/src/matrix/monitor/allowlist.ts
+++ b/extensions/matrix/src/matrix/monitor/allowlist.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements allowlist behavior.
 import {
   resolveAllowlistMatchByCandidates,
   type AllowlistMatch,
diff --git a/extensions/matrix/src/matrix/monitor/auto-join.test.ts b/extensions/matrix/src/matrix/monitor/auto-join.test.ts
index 2853f896465e..0994dd77e3a5 100644
--- a/extensions/matrix/src/matrix/monitor/auto-join.test.ts
+++ b/extensions/matrix/src/matrix/monitor/auto-join.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover auto join plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { PluginRuntime, RuntimeEnv } from "../../../runtime-api.js";
 import { setMatrixRuntime } from "../../runtime.js";
diff --git a/extensions/matrix/src/matrix/monitor/auto-join.ts b/extensions/matrix/src/matrix/monitor/auto-join.ts
index 863f27b406e4..f2659a333a10 100644
--- a/extensions/matrix/src/matrix/monitor/auto-join.ts
+++ b/extensions/matrix/src/matrix/monitor/auto-join.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements auto join behavior.
 import { normalizeStringifiedEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { getMatrixRuntime } from "../../runtime.js";
 import type { MatrixConfig } from "../../types.js";
diff --git a/extensions/matrix/src/matrix/monitor/config.test.ts b/extensions/matrix/src/matrix/monitor/config.test.ts
index aa68dc1416b1..f3af624d9a5e 100644
--- a/extensions/matrix/src/matrix/monitor/config.test.ts
+++ b/extensions/matrix/src/matrix/monitor/config.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover config plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { RuntimeEnv } from "../../../runtime-api.js";
 import type { CoreConfig, MatrixRoomConfig } from "../../types.js";
diff --git a/extensions/matrix/src/matrix/monitor/config.ts b/extensions/matrix/src/matrix/monitor/config.ts
index 976655281afb..c701de3a6254 100644
--- a/extensions/matrix/src/matrix/monitor/config.ts
+++ b/extensions/matrix/src/matrix/monitor/config.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports config behavior.
 import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
 import { resolveMatrixTargets } from "../../resolve-targets.js";
 import type { CoreConfig, MatrixRoomConfig } from "../../types.js";
diff --git a/extensions/matrix/src/matrix/monitor/context-summary.ts b/extensions/matrix/src/matrix/monitor/context-summary.ts
index 22f98dd010a5..dc5f991f72af 100644
--- a/extensions/matrix/src/matrix/monitor/context-summary.ts
+++ b/extensions/matrix/src/matrix/monitor/context-summary.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements context summary behavior.
 import {
   formatMatrixMessageText,
   resolveMatrixMessageAttachment,
diff --git a/extensions/matrix/src/matrix/monitor/direct.test.ts b/extensions/matrix/src/matrix/monitor/direct.test.ts
index 8d70390da6d4..d2b254be8b8f 100644
--- a/extensions/matrix/src/matrix/monitor/direct.test.ts
+++ b/extensions/matrix/src/matrix/monitor/direct.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover direct plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { MatrixClient } from "../sdk.js";
 import { EventType } from "../send/types.js";
diff --git a/extensions/matrix/src/matrix/monitor/direct.ts b/extensions/matrix/src/matrix/monitor/direct.ts
index 06161afd41e9..dcedaa12e3b0 100644
--- a/extensions/matrix/src/matrix/monitor/direct.ts
+++ b/extensions/matrix/src/matrix/monitor/direct.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements direct behavior.
 import { promoteMatrixDirectRoomCandidate } from "../direct-management.js";
 import {
   hasDirectMatrixMemberFlag,
diff --git a/extensions/matrix/src/matrix/monitor/events.test.ts b/extensions/matrix/src/matrix/monitor/events.test.ts
index 69053f00b73f..5e218d38ef03 100644
--- a/extensions/matrix/src/matrix/monitor/events.test.ts
+++ b/extensions/matrix/src/matrix/monitor/events.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover events plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { CoreConfig } from "../../types.js";
 import type { MatrixAuth } from "../client.js";
diff --git a/extensions/matrix/src/matrix/monitor/events.ts b/extensions/matrix/src/matrix/monitor/events.ts
index e25b95ae3045..daf13a85cb34 100644
--- a/extensions/matrix/src/matrix/monitor/events.ts
+++ b/extensions/matrix/src/matrix/monitor/events.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements events behavior.
 import { normalizeOptionalString, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { PluginRuntime, RuntimeLogger } from "../../runtime-api.js";
 import type { CoreConfig } from "../../types.js";
diff --git a/extensions/matrix/src/matrix/monitor/handler.body-for-agent.test.ts b/extensions/matrix/src/matrix/monitor/handler.body-for-agent.test.ts
index 9a87d68d1d00..51f7069633f5 100644
--- a/extensions/matrix/src/matrix/monitor/handler.body-for-agent.test.ts
+++ b/extensions/matrix/src/matrix/monitor/handler.body-for-agent.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover handler.body for agent plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { installMatrixMonitorTestRuntime } from "../../test-runtime.js";
 import type { MatrixClient } from "../sdk.js";
diff --git a/extensions/matrix/src/matrix/monitor/handler.media-failure.test.ts b/extensions/matrix/src/matrix/monitor/handler.media-failure.test.ts
index 9a0bb90bc39a..9f80c0493b9a 100644
--- a/extensions/matrix/src/matrix/monitor/handler.media-failure.test.ts
+++ b/extensions/matrix/src/matrix/monitor/handler.media-failure.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover handler.media failure plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { installMatrixMonitorTestRuntime } from "../../test-runtime.js";
 import { MatrixMediaSizeLimitError } from "../media-errors.js";
diff --git a/extensions/matrix/src/matrix/monitor/handler.strip-mention.test.ts b/extensions/matrix/src/matrix/monitor/handler.strip-mention.test.ts
index 1d375ec9b982..c57f4d5b6662 100644
--- a/extensions/matrix/src/matrix/monitor/handler.strip-mention.test.ts
+++ b/extensions/matrix/src/matrix/monitor/handler.strip-mention.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover handler.strip mention plugin behavior.
 import { describe, expect, it } from "vitest";
 import { stripMatrixMentionPrefix } from "./mentions.js";
 
diff --git a/extensions/matrix/src/matrix/monitor/handler.test-helpers.ts b/extensions/matrix/src/matrix/monitor/handler.test-helpers.ts
index 09080c1b28f0..6a151c198f7e 100644
--- a/extensions/matrix/src/matrix/monitor/handler.test-helpers.ts
+++ b/extensions/matrix/src/matrix/monitor/handler.test-helpers.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports handler helpers behavior.
 import type { PreparedInboundReply } from "openclaw/plugin-sdk/channel-inbound";
 import { finalizeInboundContext as finalizeCoreInboundContext } from "openclaw/plugin-sdk/reply-runtime";
 import { vi, type Mock } from "vitest";
diff --git a/extensions/matrix/src/matrix/monitor/handler.test.ts b/extensions/matrix/src/matrix/monitor/handler.test.ts
index e79d3abc148d..e5f23c33f2c4 100644
--- a/extensions/matrix/src/matrix/monitor/handler.test.ts
+++ b/extensions/matrix/src/matrix/monitor/handler.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover handler plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/monitor/handler.thread-root-media.test.ts b/extensions/matrix/src/matrix/monitor/handler.thread-root-media.test.ts
index 41fc7960f6cd..0bb893045604 100644
--- a/extensions/matrix/src/matrix/monitor/handler.thread-root-media.test.ts
+++ b/extensions/matrix/src/matrix/monitor/handler.thread-root-media.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover handler.thread root media plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { installMatrixMonitorTestRuntime } from "../../test-runtime.js";
 import {
diff --git a/extensions/matrix/src/matrix/monitor/handler.ts b/extensions/matrix/src/matrix/monitor/handler.ts
index 294be5afb4cc..e14490e29bb6 100644
--- a/extensions/matrix/src/matrix/monitor/handler.ts
+++ b/extensions/matrix/src/matrix/monitor/handler.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements handler behavior.
 import {
   buildChannelInboundEventContext,
   toInboundMediaFacts,
diff --git a/extensions/matrix/src/matrix/monitor/inbound-dedupe.test.ts b/extensions/matrix/src/matrix/monitor/inbound-dedupe.test.ts
index ac8aa57950a8..5fd6dd506e70 100644
--- a/extensions/matrix/src/matrix/monitor/inbound-dedupe.test.ts
+++ b/extensions/matrix/src/matrix/monitor/inbound-dedupe.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover inbound dedupe plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/monitor/inbound-dedupe.ts b/extensions/matrix/src/matrix/monitor/inbound-dedupe.ts
index 97ba947c93c2..ae9e31a759f3 100644
--- a/extensions/matrix/src/matrix/monitor/inbound-dedupe.ts
+++ b/extensions/matrix/src/matrix/monitor/inbound-dedupe.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements inbound dedupe behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/monitor/index.test.ts b/extensions/matrix/src/matrix/monitor/index.test.ts
index 0951eb5ceef9..449faafd8425 100644
--- a/extensions/matrix/src/matrix/monitor/index.test.ts
+++ b/extensions/matrix/src/matrix/monitor/index.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover index plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { z } from "zod";
 import type { MatrixConfig, MatrixStreamingMode } from "../../types.js";
diff --git a/extensions/matrix/src/matrix/monitor/index.ts b/extensions/matrix/src/matrix/monitor/index.ts
index 916c43312353..96a9e0d1f780 100644
--- a/extensions/matrix/src/matrix/monitor/index.ts
+++ b/extensions/matrix/src/matrix/monitor/index.ts
@@ -1,3 +1,4 @@
+// Matrix plugin entrypoint registers its OpenClaw integration.
 import { format } from "node:util";
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 import type { ChannelRuntimeSurface } from "openclaw/plugin-sdk/channel-contract";
diff --git a/extensions/matrix/src/matrix/monitor/legacy-crypto-restore.test.ts b/extensions/matrix/src/matrix/monitor/legacy-crypto-restore.test.ts
index 541acc60d120..bf4534b47dea 100644
--- a/extensions/matrix/src/matrix/monitor/legacy-crypto-restore.test.ts
+++ b/extensions/matrix/src/matrix/monitor/legacy-crypto-restore.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover legacy crypto restore plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { withTempHome } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/matrix/src/matrix/monitor/legacy-crypto-restore.ts b/extensions/matrix/src/matrix/monitor/legacy-crypto-restore.ts
index 93e23ca1e221..6cb890091f84 100644
--- a/extensions/matrix/src/matrix/monitor/legacy-crypto-restore.ts
+++ b/extensions/matrix/src/matrix/monitor/legacy-crypto-restore.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements legacy crypto restore behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/monitor/location.test.ts b/extensions/matrix/src/matrix/monitor/location.test.ts
index 97f036d7281f..77969f0d709d 100644
--- a/extensions/matrix/src/matrix/monitor/location.test.ts
+++ b/extensions/matrix/src/matrix/monitor/location.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover location plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMatrixLocation } from "./location.js";
 import { EventType } from "./types.js";
diff --git a/extensions/matrix/src/matrix/monitor/location.ts b/extensions/matrix/src/matrix/monitor/location.ts
index 3867e5aa086b..09fcc9aa8aa5 100644
--- a/extensions/matrix/src/matrix/monitor/location.ts
+++ b/extensions/matrix/src/matrix/monitor/location.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements location behavior.
 import { parseStrictFiniteNumber } from "openclaw/plugin-sdk/number-runtime";
 import {
   normalizeLowercaseStringOrEmpty,
diff --git a/extensions/matrix/src/matrix/monitor/media.test.ts b/extensions/matrix/src/matrix/monitor/media.test.ts
index 7613b1cd60ef..dcdbbf62f186 100644
--- a/extensions/matrix/src/matrix/monitor/media.test.ts
+++ b/extensions/matrix/src/matrix/monitor/media.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover media plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { PluginRuntime } from "../../../runtime-api.js";
 import { setMatrixRuntime } from "../../runtime.js";
diff --git a/extensions/matrix/src/matrix/monitor/media.ts b/extensions/matrix/src/matrix/monitor/media.ts
index e56a6e405aa1..eb3d1c9b4f10 100644
--- a/extensions/matrix/src/matrix/monitor/media.ts
+++ b/extensions/matrix/src/matrix/monitor/media.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements media behavior.
 import { getMatrixRuntime } from "../../runtime.js";
 import { MatrixMediaSizeLimitError, isMatrixMediaSizeLimitError } from "../media-errors.js";
 import type { MatrixClient } from "../sdk.js";
diff --git a/extensions/matrix/src/matrix/monitor/mentions.test.ts b/extensions/matrix/src/matrix/monitor/mentions.test.ts
index 3c18a6908586..274bac28ae23 100644
--- a/extensions/matrix/src/matrix/monitor/mentions.test.ts
+++ b/extensions/matrix/src/matrix/monitor/mentions.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover mentions plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 
 // Mock the runtime before importing resolveMentions
diff --git a/extensions/matrix/src/matrix/monitor/mentions.ts b/extensions/matrix/src/matrix/monitor/mentions.ts
index 066740070c9c..e2522a7e551a 100644
--- a/extensions/matrix/src/matrix/monitor/mentions.ts
+++ b/extensions/matrix/src/matrix/monitor/mentions.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements mentions behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { escapeRegExp } from "openclaw/plugin-sdk/text-utility-runtime";
 import { getMatrixRuntime } from "../../runtime.js";
diff --git a/extensions/matrix/src/matrix/monitor/reaction-events.test.ts b/extensions/matrix/src/matrix/monitor/reaction-events.test.ts
index f2fe45e6f8c3..b317a364b64d 100644
--- a/extensions/matrix/src/matrix/monitor/reaction-events.test.ts
+++ b/extensions/matrix/src/matrix/monitor/reaction-events.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover reaction events plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   clearMatrixApprovalReactionTargetsForTest,
diff --git a/extensions/matrix/src/matrix/monitor/reaction-events.ts b/extensions/matrix/src/matrix/monitor/reaction-events.ts
index c7a4be2183d2..b5c23536e7e8 100644
--- a/extensions/matrix/src/matrix/monitor/reaction-events.ts
+++ b/extensions/matrix/src/matrix/monitor/reaction-events.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements reaction events behavior.
 import { getSessionBindingService } from "openclaw/plugin-sdk/session-binding-runtime";
 import {
   resolveMatrixApprovalReactionTargetWithPersistence,
diff --git a/extensions/matrix/src/matrix/monitor/recent-invite.test.ts b/extensions/matrix/src/matrix/monitor/recent-invite.test.ts
index 90ce5f2c19df..9053d9ec7e54 100644
--- a/extensions/matrix/src/matrix/monitor/recent-invite.test.ts
+++ b/extensions/matrix/src/matrix/monitor/recent-invite.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover recent invite plugin behavior.
 import { describe, expect, it } from "vitest";
 import { shouldPromoteRecentInviteRoom } from "./recent-invite.js";
 
diff --git a/extensions/matrix/src/matrix/monitor/recent-invite.ts b/extensions/matrix/src/matrix/monitor/recent-invite.ts
index cb40aa4a19bb..04e972277c58 100644
--- a/extensions/matrix/src/matrix/monitor/recent-invite.ts
+++ b/extensions/matrix/src/matrix/monitor/recent-invite.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements recent invite behavior.
 import type { MatrixRoomConfig } from "../../types.js";
 import type { MatrixRoomInfo } from "./room-info.js";
 import { resolveMatrixRoomConfig } from "./rooms.js";
diff --git a/extensions/matrix/src/matrix/monitor/replies.test.ts b/extensions/matrix/src/matrix/monitor/replies.test.ts
index 4808d21bf268..4dcba4be1fc9 100644
--- a/extensions/matrix/src/matrix/monitor/replies.test.ts
+++ b/extensions/matrix/src/matrix/monitor/replies.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover replies plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { PluginRuntime, RuntimeEnv } from "../../../runtime-api.js";
 import type { MatrixClient } from "../sdk.js";
diff --git a/extensions/matrix/src/matrix/monitor/replies.ts b/extensions/matrix/src/matrix/monitor/replies.ts
index b66791e0c8ee..a40e43408ef4 100644
--- a/extensions/matrix/src/matrix/monitor/replies.ts
+++ b/extensions/matrix/src/matrix/monitor/replies.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements replies behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { getMatrixRuntime } from "../../runtime.js";
 import type { MatrixClient } from "../sdk.js";
diff --git a/extensions/matrix/src/matrix/monitor/reply-context.test.ts b/extensions/matrix/src/matrix/monitor/reply-context.test.ts
index 2e9470cd1e72..ac1a8f5d25dd 100644
--- a/extensions/matrix/src/matrix/monitor/reply-context.test.ts
+++ b/extensions/matrix/src/matrix/monitor/reply-context.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover reply context plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createMatrixReplyContextResolver, summarizeMatrixReplyEvent } from "./reply-context.js";
 import { createPollStartEvent } from "./test-events.js";
diff --git a/extensions/matrix/src/matrix/monitor/reply-context.ts b/extensions/matrix/src/matrix/monitor/reply-context.ts
index cee6f2270047..937a660bae9a 100644
--- a/extensions/matrix/src/matrix/monitor/reply-context.ts
+++ b/extensions/matrix/src/matrix/monitor/reply-context.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements reply context behavior.
 import type { MatrixClient } from "../sdk.js";
 import { summarizeMatrixMessageContextEvent, trimMatrixMaybeString } from "./context-summary.js";
 import type { MatrixRawEvent } from "./types.js";
diff --git a/extensions/matrix/src/matrix/monitor/room-info.test.ts b/extensions/matrix/src/matrix/monitor/room-info.test.ts
index ad59f517fdab..3405cdef9020 100644
--- a/extensions/matrix/src/matrix/monitor/room-info.test.ts
+++ b/extensions/matrix/src/matrix/monitor/room-info.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover room info plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { MatrixClient } from "../sdk.js";
 import { createMatrixRoomInfoResolver } from "./room-info.js";
diff --git a/extensions/matrix/src/matrix/monitor/room-info.ts b/extensions/matrix/src/matrix/monitor/room-info.ts
index c9871ed81e50..18448ed15967 100644
--- a/extensions/matrix/src/matrix/monitor/room-info.ts
+++ b/extensions/matrix/src/matrix/monitor/room-info.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements room info behavior.
 import { isMatrixNotFoundError } from "../errors.js";
 import type { MatrixClient } from "../sdk.js";
 
diff --git a/extensions/matrix/src/matrix/monitor/rooms.test.ts b/extensions/matrix/src/matrix/monitor/rooms.test.ts
index 3b25e0d67afc..e663e4a819d9 100644
--- a/extensions/matrix/src/matrix/monitor/rooms.test.ts
+++ b/extensions/matrix/src/matrix/monitor/rooms.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover rooms plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMatrixRoomConfig } from "./rooms.js";
 
diff --git a/extensions/matrix/src/matrix/monitor/rooms.ts b/extensions/matrix/src/matrix/monitor/rooms.ts
index e723426ba280..03e6bcf739e0 100644
--- a/extensions/matrix/src/matrix/monitor/rooms.ts
+++ b/extensions/matrix/src/matrix/monitor/rooms.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements rooms behavior.
 import type { MatrixRoomConfig } from "../../types.js";
 import { buildChannelKeyCandidates, resolveChannelEntryMatch } from "./runtime-api.js";
 
diff --git a/extensions/matrix/src/matrix/monitor/route.test.ts b/extensions/matrix/src/matrix/monitor/route.test.ts
index f9aea302b1bd..cff5e8caf955 100644
--- a/extensions/matrix/src/matrix/monitor/route.test.ts
+++ b/extensions/matrix/src/matrix/monitor/route.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover route plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { matrixPlugin } from "../../channel.js";
 import {
diff --git a/extensions/matrix/src/matrix/monitor/route.ts b/extensions/matrix/src/matrix/monitor/route.ts
index 9889857bc2cf..0c8d9c3d39bb 100644
--- a/extensions/matrix/src/matrix/monitor/route.ts
+++ b/extensions/matrix/src/matrix/monitor/route.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements route behavior.
 import { resolveConfiguredAcpBindingRecord } from "openclaw/plugin-sdk/acp-binding-resolve-runtime";
 import type { PluginRuntime } from "openclaw/plugin-sdk/plugin-runtime";
 import {
diff --git a/extensions/matrix/src/matrix/monitor/startup-verification.test.ts b/extensions/matrix/src/matrix/monitor/startup-verification.test.ts
index 19e926e30262..9f322b13fe06 100644
--- a/extensions/matrix/src/matrix/monitor/startup-verification.test.ts
+++ b/extensions/matrix/src/matrix/monitor/startup-verification.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover startup verification plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/monitor/startup-verification.ts b/extensions/matrix/src/matrix/monitor/startup-verification.ts
index ad3402b47447..85498ca69431 100644
--- a/extensions/matrix/src/matrix/monitor/startup-verification.ts
+++ b/extensions/matrix/src/matrix/monitor/startup-verification.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements startup verification behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/monitor/startup.test.ts b/extensions/matrix/src/matrix/monitor/startup.test.ts
index 9f9aaf180d55..b79701b8b27c 100644
--- a/extensions/matrix/src/matrix/monitor/startup.test.ts
+++ b/extensions/matrix/src/matrix/monitor/startup.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover startup plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { CoreConfig } from "../../types.js";
 import type { MatrixAccountPatch } from "../config-update.js";
diff --git a/extensions/matrix/src/matrix/monitor/startup.ts b/extensions/matrix/src/matrix/monitor/startup.ts
index 5ef6ef757403..d61f438babae 100644
--- a/extensions/matrix/src/matrix/monitor/startup.ts
+++ b/extensions/matrix/src/matrix/monitor/startup.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements startup behavior.
 import type { RuntimeLogger } from "../../runtime-api.js";
 import type { CoreConfig, MatrixConfig } from "../../types.js";
 import type { MatrixAuth } from "../client.js";
diff --git a/extensions/matrix/src/matrix/monitor/status.ts b/extensions/matrix/src/matrix/monitor/status.ts
index ad52cbfa9ff4..70b364113d46 100644
--- a/extensions/matrix/src/matrix/monitor/status.ts
+++ b/extensions/matrix/src/matrix/monitor/status.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements status behavior.
 import type { ChannelAccountSnapshot } from "openclaw/plugin-sdk/channel-contract";
 import {
   createConnectedChannelStatusPatch,
diff --git a/extensions/matrix/src/matrix/monitor/sync-lifecycle.test.ts b/extensions/matrix/src/matrix/monitor/sync-lifecycle.test.ts
index 1ff399054118..651726731fb2 100644
--- a/extensions/matrix/src/matrix/monitor/sync-lifecycle.test.ts
+++ b/extensions/matrix/src/matrix/monitor/sync-lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover sync lifecycle plugin behavior.
 import { EventEmitter } from "node:events";
 import { describe, expect, it, vi } from "vitest";
 import { createMatrixMonitorStatusController } from "./status.js";
diff --git a/extensions/matrix/src/matrix/monitor/sync-lifecycle.ts b/extensions/matrix/src/matrix/monitor/sync-lifecycle.ts
index 67173ab71b04..16d01a853fbc 100644
--- a/extensions/matrix/src/matrix/monitor/sync-lifecycle.ts
+++ b/extensions/matrix/src/matrix/monitor/sync-lifecycle.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements sync lifecycle behavior.
 import type { MatrixClient } from "../sdk.js";
 import { isMatrixTerminalSyncState, type MatrixSyncState } from "../sync-state.js";
 import type { MatrixMonitorStatusController } from "./status.js";
diff --git a/extensions/matrix/src/matrix/monitor/task-runner.ts b/extensions/matrix/src/matrix/monitor/task-runner.ts
index 5d1e9a082bdc..e9eb824a1293 100644
--- a/extensions/matrix/src/matrix/monitor/task-runner.ts
+++ b/extensions/matrix/src/matrix/monitor/task-runner.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements task runner behavior.
 import type { RuntimeLogger } from "../../runtime-api.js";
 
 export function createMatrixMonitorTaskRunner(params: {
diff --git a/extensions/matrix/src/matrix/monitor/test-events.ts b/extensions/matrix/src/matrix/monitor/test-events.ts
index ef78a472584a..8273984df203 100644
--- a/extensions/matrix/src/matrix/monitor/test-events.ts
+++ b/extensions/matrix/src/matrix/monitor/test-events.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements test events behavior.
 import type { MatrixRawEvent } from "./types.js";
 
 export function createPollStartEvent(eventId: string): MatrixRawEvent {
diff --git a/extensions/matrix/src/matrix/monitor/thread-context.test.ts b/extensions/matrix/src/matrix/monitor/thread-context.test.ts
index 6ec33b0046ba..03457fabde94 100644
--- a/extensions/matrix/src/matrix/monitor/thread-context.test.ts
+++ b/extensions/matrix/src/matrix/monitor/thread-context.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover thread context plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createPollStartEvent } from "./test-events.js";
 import {
diff --git a/extensions/matrix/src/matrix/monitor/thread-context.ts b/extensions/matrix/src/matrix/monitor/thread-context.ts
index 24bfe5c74803..2fdfcfa9cc97 100644
--- a/extensions/matrix/src/matrix/monitor/thread-context.ts
+++ b/extensions/matrix/src/matrix/monitor/thread-context.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements thread context behavior.
 import type { MatrixClient } from "../sdk.js";
 import { summarizeMatrixMessageContextEvent, trimMatrixMaybeString } from "./context-summary.js";
 import type { MatrixRawEvent } from "./types.js";
diff --git a/extensions/matrix/src/matrix/monitor/threads.test.ts b/extensions/matrix/src/matrix/monitor/threads.test.ts
index cfeb07ee20eb..16c0d542abe2 100644
--- a/extensions/matrix/src/matrix/monitor/threads.test.ts
+++ b/extensions/matrix/src/matrix/monitor/threads.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover threads plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMatrixThreadRouting } from "./threads.js";
 
diff --git a/extensions/matrix/src/matrix/monitor/threads.ts b/extensions/matrix/src/matrix/monitor/threads.ts
index 8d3d10559418..bcf5797dafa7 100644
--- a/extensions/matrix/src/matrix/monitor/threads.ts
+++ b/extensions/matrix/src/matrix/monitor/threads.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements threads behavior.
 import { resolveThreadSessionKeys } from "openclaw/plugin-sdk/routing";
 import type { MatrixRawEvent, RoomMessageEventContent } from "./types.js";
 import { RelationType } from "./types.js";
diff --git a/extensions/matrix/src/matrix/monitor/types.ts b/extensions/matrix/src/matrix/monitor/types.ts
index 83552931906c..297a3166b735 100644
--- a/extensions/matrix/src/matrix/monitor/types.ts
+++ b/extensions/matrix/src/matrix/monitor/types.ts
@@ -1,3 +1,4 @@
+// Matrix type declarations define plugin contracts.
 import { MATRIX_REACTION_EVENT_TYPE } from "../reaction-common.js";
 import type { EncryptedFile, MessageEventContent } from "../sdk.js";
 export type { MatrixRawEvent } from "../sdk.js";
diff --git a/extensions/matrix/src/matrix/monitor/verification-events.ts b/extensions/matrix/src/matrix/monitor/verification-events.ts
index e02d055d07ae..10dbd18cfba6 100644
--- a/extensions/matrix/src/matrix/monitor/verification-events.ts
+++ b/extensions/matrix/src/matrix/monitor/verification-events.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements verification events behavior.
 import type { MatrixClient } from "../sdk.js";
 import { resolveMatrixMonitorAccessState } from "./access-state.js";
 import type { MatrixRawEvent } from "./types.js";
diff --git a/extensions/matrix/src/matrix/monitor/verification-utils.test.ts b/extensions/matrix/src/matrix/monitor/verification-utils.test.ts
index 5093e73939dc..c7d32752882b 100644
--- a/extensions/matrix/src/matrix/monitor/verification-utils.test.ts
+++ b/extensions/matrix/src/matrix/monitor/verification-utils.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover verification utils plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   isMatrixVerificationEventType,
diff --git a/extensions/matrix/src/matrix/monitor/verification-utils.ts b/extensions/matrix/src/matrix/monitor/verification-utils.ts
index 4291cc6d680b..f07dbe34c077 100644
--- a/extensions/matrix/src/matrix/monitor/verification-utils.ts
+++ b/extensions/matrix/src/matrix/monitor/verification-utils.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports verification utils behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 const VERIFICATION_EVENT_PREFIX = "m.key.verification.";
diff --git a/extensions/matrix/src/matrix/outbound-media-runtime.ts b/extensions/matrix/src/matrix/outbound-media-runtime.ts
index 18cf2066fc88..e4811ec38b98 100644
--- a/extensions/matrix/src/matrix/outbound-media-runtime.ts
+++ b/extensions/matrix/src/matrix/outbound-media-runtime.ts
@@ -1 +1,2 @@
+// Matrix plugin module implements outbound media runtime behavior.
 export { loadOutboundMediaFromUrl } from "openclaw/plugin-sdk/outbound-media";
diff --git a/extensions/matrix/src/matrix/poll-summary.ts b/extensions/matrix/src/matrix/poll-summary.ts
index f98723826ce6..55528c0a7562 100644
--- a/extensions/matrix/src/matrix/poll-summary.ts
+++ b/extensions/matrix/src/matrix/poll-summary.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements poll summary behavior.
 import type { MatrixMessageSummary } from "./actions/types.js";
 import {
   buildPollResultsSummary,
diff --git a/extensions/matrix/src/matrix/poll-types.test.ts b/extensions/matrix/src/matrix/poll-types.test.ts
index 4ce3f425efe9..f145d5414312 100644
--- a/extensions/matrix/src/matrix/poll-types.test.ts
+++ b/extensions/matrix/src/matrix/poll-types.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover poll types plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildPollResultsSummary,
diff --git a/extensions/matrix/src/matrix/probe.runtime.ts b/extensions/matrix/src/matrix/probe.runtime.ts
index d247a59d2a9d..691ba852291d 100644
--- a/extensions/matrix/src/matrix/probe.runtime.ts
+++ b/extensions/matrix/src/matrix/probe.runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements probe behavior.
 import { createMatrixClient } from "./client.js";
 
 // Keep probe's runtime seam narrow so tests can mock it without loading the full client barrel.
diff --git a/extensions/matrix/src/matrix/probe.test.ts b/extensions/matrix/src/matrix/probe.test.ts
index 8ad2f708e93c..dc30d7df889d 100644
--- a/extensions/matrix/src/matrix/probe.test.ts
+++ b/extensions/matrix/src/matrix/probe.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover probe plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const createMatrixClientMock = vi.fn();
diff --git a/extensions/matrix/src/matrix/probe.ts b/extensions/matrix/src/matrix/probe.ts
index b8f2a0640832..4666dea3cc32 100644
--- a/extensions/matrix/src/matrix/probe.ts
+++ b/extensions/matrix/src/matrix/probe.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements probe behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type { PinnedDispatcherPolicy } from "openclaw/plugin-sdk/ssrf-dispatcher";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/matrix/src/matrix/profile.test.ts b/extensions/matrix/src/matrix/profile.test.ts
index 0f5035e89ee3..52f5ef2347dd 100644
--- a/extensions/matrix/src/matrix/profile.test.ts
+++ b/extensions/matrix/src/matrix/profile.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover profile plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   isSupportedMatrixAvatarSource,
diff --git a/extensions/matrix/src/matrix/profile.ts b/extensions/matrix/src/matrix/profile.ts
index 41d41477217b..12cca00e8fb9 100644
--- a/extensions/matrix/src/matrix/profile.ts
+++ b/extensions/matrix/src/matrix/profile.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements profile behavior.
 import {
   normalizeLowercaseStringOrEmpty,
   normalizeOptionalString,
diff --git a/extensions/matrix/src/matrix/reaction-common.test.ts b/extensions/matrix/src/matrix/reaction-common.test.ts
index 299bd20f7cb4..3bdac55789a6 100644
--- a/extensions/matrix/src/matrix/reaction-common.test.ts
+++ b/extensions/matrix/src/matrix/reaction-common.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover reaction common plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildMatrixReactionContent,
diff --git a/extensions/matrix/src/matrix/reaction-common.ts b/extensions/matrix/src/matrix/reaction-common.ts
index c2fa0c429132..5ed6cab720af 100644
--- a/extensions/matrix/src/matrix/reaction-common.ts
+++ b/extensions/matrix/src/matrix/reaction-common.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements reaction common behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 export const MATRIX_ANNOTATION_RELATION_TYPE = "m.annotation";
diff --git a/extensions/matrix/src/matrix/sdk.test.ts b/extensions/matrix/src/matrix/sdk.test.ts
index 2c74dda1ce50..23f65f37db2e 100644
--- a/extensions/matrix/src/matrix/sdk.test.ts
+++ b/extensions/matrix/src/matrix/sdk.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover sdk plugin behavior.
 import "fake-indexeddb/auto";
 import { EventEmitter } from "node:events";
 import fs from "node:fs";
diff --git a/extensions/matrix/src/matrix/sdk.ts b/extensions/matrix/src/matrix/sdk.ts
index e05daed3ddc7..3e948f955938 100644
--- a/extensions/matrix/src/matrix/sdk.ts
+++ b/extensions/matrix/src/matrix/sdk.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements sdk behavior.
 import { EventEmitter } from "node:events";
 import {
   ClientEvent,
diff --git a/extensions/matrix/src/matrix/sdk/crypto-bootstrap.test.ts b/extensions/matrix/src/matrix/sdk/crypto-bootstrap.test.ts
index 2cd5cb355b10..0ad9a9c291db 100644
--- a/extensions/matrix/src/matrix/sdk/crypto-bootstrap.test.ts
+++ b/extensions/matrix/src/matrix/sdk/crypto-bootstrap.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover crypto bootstrap plugin behavior.
 import { beforeEach, describe, expect, it, vi, type Mock } from "vitest";
 import { MatrixCryptoBootstrapper, type MatrixCryptoBootstrapperDeps } from "./crypto-bootstrap.js";
 import type { MatrixCryptoBootstrapApi, MatrixRawEvent } from "./types.js";
diff --git a/extensions/matrix/src/matrix/sdk/crypto-bootstrap.ts b/extensions/matrix/src/matrix/sdk/crypto-bootstrap.ts
index 453a37472840..2bc3c24a3bd5 100644
--- a/extensions/matrix/src/matrix/sdk/crypto-bootstrap.ts
+++ b/extensions/matrix/src/matrix/sdk/crypto-bootstrap.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements crypto bootstrap behavior.
 import { setTimeout as sleep } from "node:timers/promises";
 import { CryptoEvent } from "matrix-js-sdk/lib/crypto-api/CryptoEvent.js";
 import type { MatrixDecryptBridge } from "./decrypt-bridge.js";
diff --git a/extensions/matrix/src/matrix/sdk/crypto-facade.test.ts b/extensions/matrix/src/matrix/sdk/crypto-facade.test.ts
index 7287e76b87df..1fb5c2208775 100644
--- a/extensions/matrix/src/matrix/sdk/crypto-facade.test.ts
+++ b/extensions/matrix/src/matrix/sdk/crypto-facade.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover crypto facade plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createMatrixCryptoFacade } from "./crypto-facade.js";
 import type { MatrixRecoveryKeyStore } from "./recovery-key-store.js";
diff --git a/extensions/matrix/src/matrix/sdk/crypto-facade.ts b/extensions/matrix/src/matrix/sdk/crypto-facade.ts
index cf6579cc9b44..24e99f46cac4 100644
--- a/extensions/matrix/src/matrix/sdk/crypto-facade.ts
+++ b/extensions/matrix/src/matrix/sdk/crypto-facade.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements crypto facade behavior.
 import { ensureMatrixCryptoRuntime } from "../deps.js";
 import type { MatrixRecoveryKeyStore } from "./recovery-key-store.js";
 import type { EncryptedFile } from "./types.js";
diff --git a/extensions/matrix/src/matrix/sdk/crypto-node.runtime.test.ts b/extensions/matrix/src/matrix/sdk/crypto-node.runtime.test.ts
index 9371f2b237c2..d78e2647e9ef 100644
--- a/extensions/matrix/src/matrix/sdk/crypto-node.runtime.test.ts
+++ b/extensions/matrix/src/matrix/sdk/crypto-node.runtime.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover crypto node plugin behavior.
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { build } from "esbuild";
diff --git a/extensions/matrix/src/matrix/sdk/crypto-node.runtime.ts b/extensions/matrix/src/matrix/sdk/crypto-node.runtime.ts
index 3b3703301bbe..94932b25b107 100644
--- a/extensions/matrix/src/matrix/sdk/crypto-node.runtime.ts
+++ b/extensions/matrix/src/matrix/sdk/crypto-node.runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements crypto node behavior.
 import { createRequire } from "node:module";
 
 // Load via createRequire so the CJS package gets __dirname (its index.js
diff --git a/extensions/matrix/src/matrix/sdk/crypto-runtime.ts b/extensions/matrix/src/matrix/sdk/crypto-runtime.ts
index 82b98a9c89f4..0fbefd95cf9b 100644
--- a/extensions/matrix/src/matrix/sdk/crypto-runtime.ts
+++ b/extensions/matrix/src/matrix/sdk/crypto-runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements crypto runtime behavior.
 import "fake-indexeddb/auto";
 
 export { MatrixCryptoBootstrapper } from "./crypto-bootstrap.js";
diff --git a/extensions/matrix/src/matrix/sdk/decrypt-bridge.ts b/extensions/matrix/src/matrix/sdk/decrypt-bridge.ts
index ed17317783f2..d9e5b286ab3a 100644
--- a/extensions/matrix/src/matrix/sdk/decrypt-bridge.ts
+++ b/extensions/matrix/src/matrix/sdk/decrypt-bridge.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements decrypt bridge behavior.
 import { CryptoEvent } from "matrix-js-sdk/lib/crypto-api/CryptoEvent.js";
 import { DecryptionFailureCode } from "matrix-js-sdk/lib/crypto-api/index.js";
 import { MatrixEventEvent, type MatrixEvent } from "matrix-js-sdk/lib/matrix.js";
diff --git a/extensions/matrix/src/matrix/sdk/event-helpers.test.ts b/extensions/matrix/src/matrix/sdk/event-helpers.test.ts
index 85b529674737..58b6c24800bf 100644
--- a/extensions/matrix/src/matrix/sdk/event-helpers.test.ts
+++ b/extensions/matrix/src/matrix/sdk/event-helpers.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover event helpers plugin behavior.
 import type { MatrixEvent } from "matrix-js-sdk/lib/matrix.js";
 import { describe, expect, it } from "vitest";
 import { buildHttpError, matrixEventToRaw, parseMxc } from "./event-helpers.js";
diff --git a/extensions/matrix/src/matrix/sdk/event-helpers.ts b/extensions/matrix/src/matrix/sdk/event-helpers.ts
index 3a47341e2369..58e9b93280fa 100644
--- a/extensions/matrix/src/matrix/sdk/event-helpers.ts
+++ b/extensions/matrix/src/matrix/sdk/event-helpers.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports event helpers behavior.
 import type { MatrixEvent } from "matrix-js-sdk/lib/matrix.js";
 import type { MatrixRawEvent } from "./types.js";
 
diff --git a/extensions/matrix/src/matrix/sdk/http-client.test.ts b/extensions/matrix/src/matrix/sdk/http-client.test.ts
index 5b082ebc8684..ac33a024f2ad 100644
--- a/extensions/matrix/src/matrix/sdk/http-client.test.ts
+++ b/extensions/matrix/src/matrix/sdk/http-client.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover http client plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const { performMatrixRequestMock } = vi.hoisted(() => ({
diff --git a/extensions/matrix/src/matrix/sdk/http-client.ts b/extensions/matrix/src/matrix/sdk/http-client.ts
index a7d7d4a5deac..d08f7fa3ddcb 100644
--- a/extensions/matrix/src/matrix/sdk/http-client.ts
+++ b/extensions/matrix/src/matrix/sdk/http-client.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements http client behavior.
 import type { PinnedDispatcherPolicy } from "openclaw/plugin-sdk/ssrf-dispatcher";
 import type { SsrFPolicy } from "../../runtime-api.js";
 import { buildHttpError } from "./event-helpers.js";
diff --git a/extensions/matrix/src/matrix/sdk/idb-persistence-lock.ts b/extensions/matrix/src/matrix/sdk/idb-persistence-lock.ts
index 84abb9f093d0..f567d8982721 100644
--- a/extensions/matrix/src/matrix/sdk/idb-persistence-lock.ts
+++ b/extensions/matrix/src/matrix/sdk/idb-persistence-lock.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements idb persistence lock behavior.
 import type { FileLockOptions } from "openclaw/plugin-sdk/file-lock";
 
 export const MATRIX_IDB_PERSIST_INTERVAL_MS = 60_000;
diff --git a/extensions/matrix/src/matrix/sdk/idb-persistence.lock-order.test.ts b/extensions/matrix/src/matrix/sdk/idb-persistence.lock-order.test.ts
index 99c0775b2a41..022ee60f3ee7 100644
--- a/extensions/matrix/src/matrix/sdk/idb-persistence.lock-order.test.ts
+++ b/extensions/matrix/src/matrix/sdk/idb-persistence.lock-order.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover idb persistence.lock order plugin behavior.
 import "fake-indexeddb/auto";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/extensions/matrix/src/matrix/sdk/idb-persistence.test-helpers.ts b/extensions/matrix/src/matrix/sdk/idb-persistence.test-helpers.ts
index 6a478ebcbb97..9bd2fb16c37d 100644
--- a/extensions/matrix/src/matrix/sdk/idb-persistence.test-helpers.ts
+++ b/extensions/matrix/src/matrix/sdk/idb-persistence.test-helpers.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports idb persistence helpers behavior.
 export async function clearAllIndexedDbState(params?: { databasePrefix?: string }): Promise<void> {
   const databases = await indexedDB.databases();
   const expectedPrefix = params?.databasePrefix ? `${params.databasePrefix}::` : null;
diff --git a/extensions/matrix/src/matrix/sdk/idb-persistence.test.ts b/extensions/matrix/src/matrix/sdk/idb-persistence.test.ts
index 58d273e837d0..c7baa69174b9 100644
--- a/extensions/matrix/src/matrix/sdk/idb-persistence.test.ts
+++ b/extensions/matrix/src/matrix/sdk/idb-persistence.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover idb persistence plugin behavior.
 import "fake-indexeddb/auto";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/extensions/matrix/src/matrix/sdk/idb-persistence.ts b/extensions/matrix/src/matrix/sdk/idb-persistence.ts
index 2da5fb038596..9a81bb19660b 100644
--- a/extensions/matrix/src/matrix/sdk/idb-persistence.ts
+++ b/extensions/matrix/src/matrix/sdk/idb-persistence.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements idb persistence behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { indexedDB as fakeIndexedDB } from "fake-indexeddb";
diff --git a/extensions/matrix/src/matrix/sdk/logger.test.ts b/extensions/matrix/src/matrix/sdk/logger.test.ts
index 5646f9f39c11..6369e7f76e73 100644
--- a/extensions/matrix/src/matrix/sdk/logger.test.ts
+++ b/extensions/matrix/src/matrix/sdk/logger.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover logger plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { ConsoleLogger, setMatrixConsoleLogging } from "./logger.js";
 
diff --git a/extensions/matrix/src/matrix/sdk/logger.ts b/extensions/matrix/src/matrix/sdk/logger.ts
index fd303393d4da..6a97f54bce5a 100644
--- a/extensions/matrix/src/matrix/sdk/logger.ts
+++ b/extensions/matrix/src/matrix/sdk/logger.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements logger behavior.
 import { format } from "node:util";
 import { redactSensitiveText } from "openclaw/plugin-sdk/logging-core";
 import type { RuntimeLogger } from "openclaw/plugin-sdk/plugin-runtime";
diff --git a/extensions/matrix/src/matrix/sdk/read-response-with-limit.ts b/extensions/matrix/src/matrix/sdk/read-response-with-limit.ts
index 7730d3870705..2716370c1a8b 100644
--- a/extensions/matrix/src/matrix/sdk/read-response-with-limit.ts
+++ b/extensions/matrix/src/matrix/sdk/read-response-with-limit.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements read response with limit behavior.
 import { readResponseWithLimit as readSharedResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
 
 export async function readResponseWithLimit(
diff --git a/extensions/matrix/src/matrix/sdk/recovery-key-store.test.ts b/extensions/matrix/src/matrix/sdk/recovery-key-store.test.ts
index 48142d0126c3..23ea7d519d82 100644
--- a/extensions/matrix/src/matrix/sdk/recovery-key-store.test.ts
+++ b/extensions/matrix/src/matrix/sdk/recovery-key-store.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover recovery key store plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/matrix/sdk/recovery-key-store.ts b/extensions/matrix/src/matrix/sdk/recovery-key-store.ts
index 1b6d42c267ba..6551a3c11e84 100644
--- a/extensions/matrix/src/matrix/sdk/recovery-key-store.ts
+++ b/extensions/matrix/src/matrix/sdk/recovery-key-store.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements recovery key store behavior.
 import { decodeRecoveryKey } from "matrix-js-sdk/lib/crypto-api/recovery-key.js";
 import { loadJsonFile, saveJsonFile } from "openclaw/plugin-sdk/json-store";
 import { formatMatrixErrorMessage, formatMatrixErrorReason } from "../errors.js";
diff --git a/extensions/matrix/src/matrix/sdk/timeout-abort-signal.ts b/extensions/matrix/src/matrix/sdk/timeout-abort-signal.ts
index 1a9f2229c85c..01e6cf9cd714 100644
--- a/extensions/matrix/src/matrix/sdk/timeout-abort-signal.ts
+++ b/extensions/matrix/src/matrix/sdk/timeout-abort-signal.ts
@@ -1 +1,2 @@
+// Matrix plugin module implements timeout abort signal behavior.
 export { buildTimeoutAbortSignal } from "openclaw/plugin-sdk/extension-shared";
diff --git a/extensions/matrix/src/matrix/sdk/transport-runtime-api.ts b/extensions/matrix/src/matrix/sdk/transport-runtime-api.ts
index 3db076d7b48c..ccf7ba3c2a64 100644
--- a/extensions/matrix/src/matrix/sdk/transport-runtime-api.ts
+++ b/extensions/matrix/src/matrix/sdk/transport-runtime-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 import { fetchWithRuntimeDispatcherOrMockedGlobal } from "openclaw/plugin-sdk/runtime-fetch";
 import {
   closeDispatcher,
diff --git a/extensions/matrix/src/matrix/sdk/transport.test.ts b/extensions/matrix/src/matrix/sdk/transport.test.ts
index a0cac9491a33..9cbf44df2d29 100644
--- a/extensions/matrix/src/matrix/sdk/transport.test.ts
+++ b/extensions/matrix/src/matrix/sdk/transport.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover transport plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { MatrixMediaSizeLimitError } from "../media-errors.js";
 import { createMatrixGuardedFetch, performMatrixRequest } from "./transport.js";
diff --git a/extensions/matrix/src/matrix/sdk/transport.ts b/extensions/matrix/src/matrix/sdk/transport.ts
index c056abb3eb5a..d767c28dce11 100644
--- a/extensions/matrix/src/matrix/sdk/transport.ts
+++ b/extensions/matrix/src/matrix/sdk/transport.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements transport behavior.
 import { parseMediaContentLength } from "openclaw/plugin-sdk/media-runtime";
 import { MatrixMediaSizeLimitError } from "../media-errors.js";
 import { readResponseWithLimit } from "./read-response-with-limit.js";
diff --git a/extensions/matrix/src/matrix/sdk/types.ts b/extensions/matrix/src/matrix/sdk/types.ts
index 15b552f99493..a2d098c7e480 100644
--- a/extensions/matrix/src/matrix/sdk/types.ts
+++ b/extensions/matrix/src/matrix/sdk/types.ts
@@ -1,3 +1,4 @@
+// Matrix type declarations define plugin contracts.
 import type { MatrixSyncState } from "../sync-state.js";
 import type {
   MatrixVerificationRequestLike,
diff --git a/extensions/matrix/src/matrix/sdk/verification-manager.test.ts b/extensions/matrix/src/matrix/sdk/verification-manager.test.ts
index 7ae2b4959c77..299244a1b8e1 100644
--- a/extensions/matrix/src/matrix/sdk/verification-manager.test.ts
+++ b/extensions/matrix/src/matrix/sdk/verification-manager.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover verification manager plugin behavior.
 import { EventEmitter } from "node:events";
 import {
   VerificationPhase,
diff --git a/extensions/matrix/src/matrix/sdk/verification-manager.ts b/extensions/matrix/src/matrix/sdk/verification-manager.ts
index 8078fab11982..41d1ce5dc580 100644
--- a/extensions/matrix/src/matrix/sdk/verification-manager.ts
+++ b/extensions/matrix/src/matrix/sdk/verification-manager.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements verification manager behavior.
 import {
   VerificationPhase,
   VerificationRequestEvent,
diff --git a/extensions/matrix/src/matrix/sdk/verification-status.ts b/extensions/matrix/src/matrix/sdk/verification-status.ts
index 41e22526ec23..e840a8b0f334 100644
--- a/extensions/matrix/src/matrix/sdk/verification-status.ts
+++ b/extensions/matrix/src/matrix/sdk/verification-status.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements verification status behavior.
 import type { MatrixDeviceVerificationStatusLike } from "./types.js";
 
 function isMatrixDeviceLocallyVerified(
diff --git a/extensions/matrix/src/matrix/send.test.ts b/extensions/matrix/src/matrix/send.test.ts
index 23d681e895bf..067f350c5346 100644
--- a/extensions/matrix/src/matrix/send.test.ts
+++ b/extensions/matrix/src/matrix/send.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover send plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { PluginRuntime } from "../../runtime-api.js";
 import { setMatrixRuntime } from "../runtime.js";
diff --git a/extensions/matrix/src/matrix/send.ts b/extensions/matrix/src/matrix/send.ts
index f49f548d8a8c..f4ecf69a153b 100644
--- a/extensions/matrix/src/matrix/send.ts
+++ b/extensions/matrix/src/matrix/send.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements send behavior.
 import {
   createMessageReceiptFromOutboundResults,
   type MessageReceiptPartKind,
diff --git a/extensions/matrix/src/matrix/send/client.test.ts b/extensions/matrix/src/matrix/send/client.test.ts
index f72454cf8cb8..3939e5eb1509 100644
--- a/extensions/matrix/src/matrix/send/client.test.ts
+++ b/extensions/matrix/src/matrix/send/client.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover client plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   createMockMatrixClient,
diff --git a/extensions/matrix/src/matrix/send/client.ts b/extensions/matrix/src/matrix/send/client.ts
index cc96f0886807..c6e0df36cbae 100644
--- a/extensions/matrix/src/matrix/send/client.ts
+++ b/extensions/matrix/src/matrix/send/client.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements client behavior.
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import type { CoreConfig } from "../../types.js";
 import { resolveMatrixAccountConfig } from "../account-config.js";
diff --git a/extensions/matrix/src/matrix/send/formatting.ts b/extensions/matrix/src/matrix/send/formatting.ts
index 7fea242cbedf..45de76552126 100644
--- a/extensions/matrix/src/matrix/send/formatting.ts
+++ b/extensions/matrix/src/matrix/send/formatting.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports formatting behavior.
 import { getMatrixRuntime } from "../../runtime.js";
 import {
   markdownToMatrixHtml,
diff --git a/extensions/matrix/src/matrix/send/media.ts b/extensions/matrix/src/matrix/send/media.ts
index 1d4a5a027114..79df215caf74 100644
--- a/extensions/matrix/src/matrix/send/media.ts
+++ b/extensions/matrix/src/matrix/send/media.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements media behavior.
 import { parseBuffer, type IFileInfo } from "music-metadata";
 import { getMatrixRuntime } from "../../runtime.js";
 import type {
diff --git a/extensions/matrix/src/matrix/send/targets.test.ts b/extensions/matrix/src/matrix/send/targets.test.ts
index 32c390d0e996..2911017d35bb 100644
--- a/extensions/matrix/src/matrix/send/targets.test.ts
+++ b/extensions/matrix/src/matrix/send/targets.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover targets plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { MatrixClient } from "../sdk.js";
 import { EventType } from "./types.js";
diff --git a/extensions/matrix/src/matrix/send/targets.ts b/extensions/matrix/src/matrix/send/targets.ts
index 23e50585cde5..dceb0b459e60 100644
--- a/extensions/matrix/src/matrix/send/targets.ts
+++ b/extensions/matrix/src/matrix/send/targets.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements targets behavior.
 import {
   normalizeLowercaseStringOrEmpty,
   normalizeOptionalStringifiedId,
diff --git a/extensions/matrix/src/matrix/send/types.ts b/extensions/matrix/src/matrix/send/types.ts
index 8417b1fe7373..98caa139499c 100644
--- a/extensions/matrix/src/matrix/send/types.ts
+++ b/extensions/matrix/src/matrix/send/types.ts
@@ -1,3 +1,4 @@
+// Matrix type declarations define plugin contracts.
 import type { MessageReceipt } from "openclaw/plugin-sdk/channel-outbound";
 import type { CoreConfig } from "../../types.js";
 import { MATRIX_ANNOTATION_RELATION_TYPE, MATRIX_REACTION_EVENT_TYPE } from "../reaction-common.js";
diff --git a/extensions/matrix/src/matrix/session-store-metadata.ts b/extensions/matrix/src/matrix/session-store-metadata.ts
index d6d926eaf461..61747af5fd2b 100644
--- a/extensions/matrix/src/matrix/session-store-metadata.ts
+++ b/extensions/matrix/src/matrix/session-store-metadata.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements session store metadata behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { resolveMatrixDirectUserId, resolveMatrixTargetIdentity } from "./target-ids.js";
 
diff --git a/extensions/matrix/src/matrix/sqlite-state.ts b/extensions/matrix/src/matrix/sqlite-state.ts
index a633c0220d72..6c883397d158 100644
--- a/extensions/matrix/src/matrix/sqlite-state.ts
+++ b/extensions/matrix/src/matrix/sqlite-state.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements sqlite state behavior.
 import os from "node:os";
 import { getMatrixRuntime } from "../runtime.js";
 
diff --git a/extensions/matrix/src/matrix/startup-abort.ts b/extensions/matrix/src/matrix/startup-abort.ts
index 4936dfab042f..a357d26ad342 100644
--- a/extensions/matrix/src/matrix/startup-abort.ts
+++ b/extensions/matrix/src/matrix/startup-abort.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements startup abort behavior.
 export function createMatrixStartupAbortError(): Error {
   const error = new Error("Matrix startup aborted");
   error.name = "AbortError";
diff --git a/extensions/matrix/src/matrix/subagent-hooks.test.ts b/extensions/matrix/src/matrix/subagent-hooks.test.ts
index 357834dba75c..f8732d3ecad4 100644
--- a/extensions/matrix/src/matrix/subagent-hooks.test.ts
+++ b/extensions/matrix/src/matrix/subagent-hooks.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover subagent hooks plugin behavior.
 import type { OpenClawPluginApi as MatrixEntryPluginApi } from "openclaw/plugin-sdk/channel-entry-contract";
 import {
   getRequiredHookHandler,
diff --git a/extensions/matrix/src/matrix/subagent-hooks.ts b/extensions/matrix/src/matrix/subagent-hooks.ts
index c318793c5e03..37259aec361b 100644
--- a/extensions/matrix/src/matrix/subagent-hooks.ts
+++ b/extensions/matrix/src/matrix/subagent-hooks.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements subagent hooks behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import {
   getSessionBindingService,
diff --git a/extensions/matrix/src/matrix/sync-state.ts b/extensions/matrix/src/matrix/sync-state.ts
index 3edeefe978cd..f3c1df747785 100644
--- a/extensions/matrix/src/matrix/sync-state.ts
+++ b/extensions/matrix/src/matrix/sync-state.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements sync state behavior.
 export type MatrixSyncState =
   | "PREPARED"
   | "SYNCING"
diff --git a/extensions/matrix/src/matrix/target-ids.ts b/extensions/matrix/src/matrix/target-ids.ts
index 131fed3bc445..c9c3e7da96f4 100644
--- a/extensions/matrix/src/matrix/target-ids.ts
+++ b/extensions/matrix/src/matrix/target-ids.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements target ids behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 type MatrixTarget = { kind: "room"; id: string } | { kind: "user"; id: string };
diff --git a/extensions/matrix/src/matrix/thread-bindings-shared.ts b/extensions/matrix/src/matrix/thread-bindings-shared.ts
index 294498ad1d61..c29d1d47ad69 100644
--- a/extensions/matrix/src/matrix/thread-bindings-shared.ts
+++ b/extensions/matrix/src/matrix/thread-bindings-shared.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements thread bindings shared behavior.
 import type {
   BindingTargetKind,
   SessionBindingRecord,
diff --git a/extensions/matrix/src/matrix/thread-bindings.test.ts b/extensions/matrix/src/matrix/thread-bindings.test.ts
index 0c08480968a3..3a2622eea309 100644
--- a/extensions/matrix/src/matrix/thread-bindings.test.ts
+++ b/extensions/matrix/src/matrix/thread-bindings.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover thread bindings plugin behavior.
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/matrix/src/matrix/thread-bindings.ts b/extensions/matrix/src/matrix/thread-bindings.ts
index c51236907987..12b26b4c2a99 100644
--- a/extensions/matrix/src/matrix/thread-bindings.ts
+++ b/extensions/matrix/src/matrix/thread-bindings.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements thread bindings behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/matrix/src/migration-config.test.ts b/extensions/matrix/src/migration-config.test.ts
index 86262eacea56..cbd0a5612e60 100644
--- a/extensions/matrix/src/migration-config.test.ts
+++ b/extensions/matrix/src/migration-config.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover migration config plugin behavior.
 import path from "node:path";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { withTempHome } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/matrix/src/migration-config.ts b/extensions/matrix/src/migration-config.ts
index 2f0b5cae7176..4657688e887d 100644
--- a/extensions/matrix/src/migration-config.ts
+++ b/extensions/matrix/src/migration-config.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports migration config behavior.
 import fs from "node:fs";
 import os from "node:os";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
diff --git a/extensions/matrix/src/migration-snapshot-backup.ts b/extensions/matrix/src/migration-snapshot-backup.ts
index 65af25fb2ce5..8d32467e8d5f 100644
--- a/extensions/matrix/src/migration-snapshot-backup.ts
+++ b/extensions/matrix/src/migration-snapshot-backup.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements migration snapshot backup behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/migration-snapshot.test.ts b/extensions/matrix/src/migration-snapshot.test.ts
index 5b6f1048aef4..c1bf15b8df70 100644
--- a/extensions/matrix/src/migration-snapshot.test.ts
+++ b/extensions/matrix/src/migration-snapshot.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover migration snapshot plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { withTempHome } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/matrix/src/migration-snapshot.ts b/extensions/matrix/src/migration-snapshot.ts
index 7576b7a767de..e35060efd4d6 100644
--- a/extensions/matrix/src/migration-snapshot.ts
+++ b/extensions/matrix/src/migration-snapshot.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements migration snapshot behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { detectLegacyMatrixCrypto } from "./legacy-crypto.js";
 import { detectLegacyMatrixState } from "./legacy-state.js";
diff --git a/extensions/matrix/src/onboarding.resolve.test.ts b/extensions/matrix/src/onboarding.resolve.test.ts
index edd574c39174..486a8d12f766 100644
--- a/extensions/matrix/src/onboarding.resolve.test.ts
+++ b/extensions/matrix/src/onboarding.resolve.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover onboarding.resolve plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { WizardPrompter } from "../runtime-api.js";
 import { installMatrixTestRuntime } from "./test-runtime.js";
diff --git a/extensions/matrix/src/onboarding.test-harness.ts b/extensions/matrix/src/onboarding.test-harness.ts
index 79e9de59fa79..1dddeb0001ab 100644
--- a/extensions/matrix/src/onboarding.test-harness.ts
+++ b/extensions/matrix/src/onboarding.test-harness.ts
@@ -1,3 +1,4 @@
+// Matrix setup module handles plugin onboarding behavior.
 import type { OutputRuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import type { ChannelSetupWizardAdapter } from "openclaw/plugin-sdk/setup";
 import { afterEach, vi } from "vitest";
diff --git a/extensions/matrix/src/onboarding.test.ts b/extensions/matrix/src/onboarding.test.ts
index 71cf961608f3..cff212e01c95 100644
--- a/extensions/matrix/src/onboarding.test.ts
+++ b/extensions/matrix/src/onboarding.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover onboarding plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { matrixOnboardingAdapter } from "./onboarding.js";
 import {
diff --git a/extensions/matrix/src/onboarding.ts b/extensions/matrix/src/onboarding.ts
index 95d7be027e53..bb28d7c6d512 100644
--- a/extensions/matrix/src/onboarding.ts
+++ b/extensions/matrix/src/onboarding.ts
@@ -1,3 +1,4 @@
+// Matrix setup module handles plugin onboarding behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import type { DmPolicy } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/matrix/src/outbound.test.ts b/extensions/matrix/src/outbound.test.ts
index 9cad01a618b9..e77941ddef1e 100644
--- a/extensions/matrix/src/outbound.test.ts
+++ b/extensions/matrix/src/outbound.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover outbound plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
 
diff --git a/extensions/matrix/src/outbound.ts b/extensions/matrix/src/outbound.ts
index 224fe7119567..2a44e234f83b 100644
--- a/extensions/matrix/src/outbound.ts
+++ b/extensions/matrix/src/outbound.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements outbound behavior.
 import { createReplyToFanout } from "openclaw/plugin-sdk/channel-outbound";
 import {
   renderMessagePresentationFallbackText,
diff --git a/extensions/matrix/src/plugin-entry.runtime.test.ts b/extensions/matrix/src/plugin-entry.runtime.test.ts
index 70d47fc3f85e..979a4f29f4f1 100644
--- a/extensions/matrix/src/plugin-entry.runtime.test.ts
+++ b/extensions/matrix/src/plugin-entry.runtime.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover plugin entry plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/plugin-entry.runtime.ts b/extensions/matrix/src/plugin-entry.runtime.ts
index c3632f0cf8e5..d6554971bdc3 100644
--- a/extensions/matrix/src/plugin-entry.runtime.ts
+++ b/extensions/matrix/src/plugin-entry.runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements plugin entry behavior.
 import type { GatewayRequestHandlerOptions } from "openclaw/plugin-sdk/gateway-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { formatMatrixErrorMessage } from "./matrix/errors.js";
diff --git a/extensions/matrix/src/profile-update.ts b/extensions/matrix/src/profile-update.ts
index 8188bf919e89..c0c9cb6d90b2 100644
--- a/extensions/matrix/src/profile-update.ts
+++ b/extensions/matrix/src/profile-update.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements profile update behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { updateMatrixOwnProfile } from "./matrix/actions/profile.js";
 import { updateMatrixAccountConfig, resolveMatrixConfigPath } from "./matrix/config-update.js";
diff --git a/extensions/matrix/src/record-shared.ts b/extensions/matrix/src/record-shared.ts
index 32a775a481fa..5dbea4ab20ea 100644
--- a/extensions/matrix/src/record-shared.ts
+++ b/extensions/matrix/src/record-shared.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements record shared behavior.
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 export { isRecord };
diff --git a/extensions/matrix/src/resolve-targets.test.ts b/extensions/matrix/src/resolve-targets.test.ts
index 6db1ed613c17..ec51fc2f97d0 100644
--- a/extensions/matrix/src/resolve-targets.test.ts
+++ b/extensions/matrix/src/resolve-targets.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover resolve targets plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ChannelDirectoryEntry } from "../runtime-api.js";
 
diff --git a/extensions/matrix/src/resolve-targets.ts b/extensions/matrix/src/resolve-targets.ts
index c734be5eacad..ef2ef3387070 100644
--- a/extensions/matrix/src/resolve-targets.ts
+++ b/extensions/matrix/src/resolve-targets.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements resolve targets behavior.
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { listMatrixDirectoryGroupsLive, listMatrixDirectoryPeersLive } from "./directory-live.js";
 import { isMatrixQualifiedUserId, normalizeMatrixMessagingTarget } from "./matrix/target-ids.js";
diff --git a/extensions/matrix/src/resolver.runtime.ts b/extensions/matrix/src/resolver.runtime.ts
index 209fe4b5425c..f1e562465911 100644
--- a/extensions/matrix/src/resolver.runtime.ts
+++ b/extensions/matrix/src/resolver.runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements resolver behavior.
 import { resolveMatrixTargets } from "./resolve-targets.js";
 
 export const matrixResolverRuntime = {
diff --git a/extensions/matrix/src/resolver.ts b/extensions/matrix/src/resolver.ts
index bb8c8553d348..abf73924c0ff 100644
--- a/extensions/matrix/src/resolver.ts
+++ b/extensions/matrix/src/resolver.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements resolver behavior.
 import type { ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createLazyRuntimeNamedExport } from "openclaw/plugin-sdk/lazy-runtime";
 import type { ResolvedMatrixAccount } from "./matrix/accounts.js";
diff --git a/extensions/matrix/src/runtime-api.ts b/extensions/matrix/src/runtime-api.ts
index 9f8e6b89de7d..3b95138be3af 100644
--- a/extensions/matrix/src/runtime-api.ts
+++ b/extensions/matrix/src/runtime-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export {
   DEFAULT_ACCOUNT_ID,
   normalizeAccountId,
diff --git a/extensions/matrix/src/runtime.ts b/extensions/matrix/src/runtime.ts
index 4003bb916e88..86ddcdffb997 100644
--- a/extensions/matrix/src/runtime.ts
+++ b/extensions/matrix/src/runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements runtime behavior.
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import type { PluginRuntime } from "./runtime-api.js";
 
diff --git a/extensions/matrix/src/secret-contract.ts b/extensions/matrix/src/secret-contract.ts
index b433ad7a4b61..24dbd51f9623 100644
--- a/extensions/matrix/src/secret-contract.ts
+++ b/extensions/matrix/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements secret contract behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import {
   collectSecretInputAssignment,
diff --git a/extensions/matrix/src/session-route.test.ts b/extensions/matrix/src/session-route.test.ts
index a61c7e9d070d..c6b022d2d091 100644
--- a/extensions/matrix/src/session-route.test.ts
+++ b/extensions/matrix/src/session-route.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover session route plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/matrix/src/session-route.ts b/extensions/matrix/src/session-route.ts
index e03785b2197b..c02bc98f804b 100644
--- a/extensions/matrix/src/session-route.ts
+++ b/extensions/matrix/src/session-route.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements session route behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import {
   buildChannelOutboundSessionRoute,
diff --git a/extensions/matrix/src/setup-bootstrap.ts b/extensions/matrix/src/setup-bootstrap.ts
index caf29c9468a1..3996443c5da8 100644
--- a/extensions/matrix/src/setup-bootstrap.ts
+++ b/extensions/matrix/src/setup-bootstrap.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements setup bootstrap behavior.
 import { hasExplicitMatrixAccountConfig } from "./matrix/account-config.js";
 import { resolveMatrixAccountConfig } from "./matrix/accounts.js";
 import { bootstrapMatrixVerification } from "./matrix/actions/verification.js";
diff --git a/extensions/matrix/src/setup-config.ts b/extensions/matrix/src/setup-config.ts
index 6531ac9217e7..5f925c6b53cb 100644
--- a/extensions/matrix/src/setup-config.ts
+++ b/extensions/matrix/src/setup-config.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports setup config behavior.
 import {
   applyAccountNameToChannelSection,
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/matrix/src/setup-contract.ts b/extensions/matrix/src/setup-contract.ts
index ca01d040f3f0..04a8fb1cd730 100644
--- a/extensions/matrix/src/setup-contract.ts
+++ b/extensions/matrix/src/setup-contract.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements setup contract behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/routing";
 
 export const matrixSingleAccountKeysToMove = [
diff --git a/extensions/matrix/src/setup-core.test.ts b/extensions/matrix/src/setup-core.test.ts
index 3da66669f352..29abe1e16234 100644
--- a/extensions/matrix/src/setup-core.test.ts
+++ b/extensions/matrix/src/setup-core.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover setup core plugin behavior.
 import type { ChannelSetupWizardAdapter } from "openclaw/plugin-sdk/setup";
 import { describe, expect, it, vi } from "vitest";
 import { createMatrixSetupWizardProxy, matrixSetupAdapter } from "./setup-core.js";
diff --git a/extensions/matrix/src/setup-core.ts b/extensions/matrix/src/setup-core.ts
index 602d9c406393..f05d7b3ac5f9 100644
--- a/extensions/matrix/src/setup-core.ts
+++ b/extensions/matrix/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements setup core behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/matrix/src/setup-dm-policy.ts b/extensions/matrix/src/setup-dm-policy.ts
index 2a5d05527d8d..10fbabcec859 100644
--- a/extensions/matrix/src/setup-dm-policy.ts
+++ b/extensions/matrix/src/setup-dm-policy.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements setup dm policy behavior.
 import type { DmPolicy } from "openclaw/plugin-sdk/config-contracts";
 import { addWildcardAllowFrom, normalizeAllowFromEntries } from "openclaw/plugin-sdk/setup";
 import type { MatrixConfig } from "./types.js";
diff --git a/extensions/matrix/src/setup-surface.ts b/extensions/matrix/src/setup-surface.ts
index cd4ab580eb35..9ba7ade9bbaf 100644
--- a/extensions/matrix/src/setup-surface.ts
+++ b/extensions/matrix/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements setup surface behavior.
 export {
   matrixOnboardingAdapter,
   matrixOnboardingAdapter as matrixSetupWizard,
diff --git a/extensions/matrix/src/startup-maintenance.test.ts b/extensions/matrix/src/startup-maintenance.test.ts
index 152fdc277e31..1e63ea578218 100644
--- a/extensions/matrix/src/startup-maintenance.test.ts
+++ b/extensions/matrix/src/startup-maintenance.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover startup maintenance plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { withTempHome } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/matrix/src/startup-maintenance.ts b/extensions/matrix/src/startup-maintenance.ts
index 9b99005d5ca1..fadc55170e9e 100644
--- a/extensions/matrix/src/startup-maintenance.ts
+++ b/extensions/matrix/src/startup-maintenance.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements startup maintenance behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   autoMigrateLegacyMatrixState,
diff --git a/extensions/matrix/src/storage-paths.ts b/extensions/matrix/src/storage-paths.ts
index b8da53ea19a4..0b7250bbb93b 100644
--- a/extensions/matrix/src/storage-paths.ts
+++ b/extensions/matrix/src/storage-paths.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements storage paths behavior.
 import crypto from "node:crypto";
 import path from "node:path";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
diff --git a/extensions/matrix/src/test-helpers.ts b/extensions/matrix/src/test-helpers.ts
index 1281c63ddd6f..4c6c13daea4c 100644
--- a/extensions/matrix/src/test-helpers.ts
+++ b/extensions/matrix/src/test-helpers.ts
@@ -1,3 +1,4 @@
+// Matrix helper module supports test helpers behavior.
 import fs from "node:fs";
 import path from "node:path";
 
diff --git a/extensions/matrix/src/test-runtime.ts b/extensions/matrix/src/test-runtime.ts
index 3075ad4361a8..37c9ed79772c 100644
--- a/extensions/matrix/src/test-runtime.ts
+++ b/extensions/matrix/src/test-runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements test runtime behavior.
 import {
   implicitMentionKindWhen,
   resolveInboundMentionDecision,
diff --git a/extensions/matrix/src/test-support/monitor-route-test-support.ts b/extensions/matrix/src/test-support/monitor-route-test-support.ts
index b92c3c7a046b..dca6bde39b0d 100644
--- a/extensions/matrix/src/test-support/monitor-route-test-support.ts
+++ b/extensions/matrix/src/test-support/monitor-route-test-support.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements monitor route test support behavior.
 export {
   registerSessionBindingAdapter,
   testing,
diff --git a/extensions/matrix/src/thread-binding-api.test.ts b/extensions/matrix/src/thread-binding-api.test.ts
index 32353bdd6d9b..e68e79c5a378 100644
--- a/extensions/matrix/src/thread-binding-api.test.ts
+++ b/extensions/matrix/src/thread-binding-api.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover thread binding api plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   defaultTopLevelPlacement,
diff --git a/extensions/matrix/src/thread-binding-api.ts b/extensions/matrix/src/thread-binding-api.ts
index 1c4cda8c62ed..5421d6f48d03 100644
--- a/extensions/matrix/src/thread-binding-api.ts
+++ b/extensions/matrix/src/thread-binding-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveMatrixTargetIdentity } from "./matrix/target-ids.js";
 
diff --git a/extensions/matrix/src/tool-actions.runtime.ts b/extensions/matrix/src/tool-actions.runtime.ts
index d93f397207f4..913a67211af4 100644
--- a/extensions/matrix/src/tool-actions.runtime.ts
+++ b/extensions/matrix/src/tool-actions.runtime.ts
@@ -1 +1,2 @@
+// Matrix plugin module implements tool actions behavior.
 export { handleMatrixAction } from "./tool-actions.js";
diff --git a/extensions/matrix/src/tool-actions.test.ts b/extensions/matrix/src/tool-actions.test.ts
index 510b7d8ec734..0d01efe27f9e 100644
--- a/extensions/matrix/src/tool-actions.test.ts
+++ b/extensions/matrix/src/tool-actions.test.ts
@@ -1,3 +1,4 @@
+// Matrix tests cover tool actions plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { handleMatrixAction } from "./tool-actions.js";
 import type { CoreConfig } from "./types.js";
diff --git a/extensions/matrix/src/tool-actions.ts b/extensions/matrix/src/tool-actions.ts
index fcad31c20879..d97028bc5b36 100644
--- a/extensions/matrix/src/tool-actions.ts
+++ b/extensions/matrix/src/tool-actions.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements tool actions behavior.
 import type { AgentToolResult } from "openclaw/plugin-sdk/agent-core";
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveMatrixAccountConfig } from "./matrix/accounts.js";
diff --git a/extensions/matrix/src/types.ts b/extensions/matrix/src/types.ts
index 65106d776f93..fa5d9221748f 100644
--- a/extensions/matrix/src/types.ts
+++ b/extensions/matrix/src/types.ts
@@ -1,3 +1,4 @@
+// Matrix type declarations define plugin contracts.
 import type {
   ChannelBotLoopProtectionConfig,
   MentionPatternsPolicyConfig,
diff --git a/extensions/matrix/subagent-hooks-api.ts b/extensions/matrix/subagent-hooks-api.ts
index 4254dcef7bc1..ac19539d403d 100644
--- a/extensions/matrix/subagent-hooks-api.ts
+++ b/extensions/matrix/subagent-hooks-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-entry-contract";
 
 type MatrixSubagentHooksModule = typeof import("./src/matrix/subagent-hooks.js");
diff --git a/extensions/matrix/test-api.ts b/extensions/matrix/test-api.ts
index f6d9f6d90b67..b2d266654414 100644
--- a/extensions/matrix/test-api.ts
+++ b/extensions/matrix/test-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export { matrixPlugin } from "./src/channel.js";
 export { MatrixClient } from "./src/matrix/sdk.js";
 export type {
diff --git a/extensions/matrix/thread-binding-api.ts b/extensions/matrix/thread-binding-api.ts
index baff7f8f8dba..56a32b278cd3 100644
--- a/extensions/matrix/thread-binding-api.ts
+++ b/extensions/matrix/thread-binding-api.ts
@@ -1,3 +1,4 @@
+// Matrix API module exposes the plugin public contract.
 export {
   defaultTopLevelPlacement,
   resolveMatrixInboundConversation as resolveInboundConversation,
diff --git a/extensions/matrix/thread-bindings-runtime.ts b/extensions/matrix/thread-bindings-runtime.ts
index b0e8ff496283..57935ae926c8 100644
--- a/extensions/matrix/thread-bindings-runtime.ts
+++ b/extensions/matrix/thread-bindings-runtime.ts
@@ -1,3 +1,4 @@
+// Matrix plugin module implements thread bindings runtime behavior.
 export {
   setMatrixThreadBindingIdleTimeoutBySessionKey,
   setMatrixThreadBindingMaxAgeBySessionKey,
diff --git a/extensions/slack/account-inspect-api.ts b/extensions/slack/account-inspect-api.ts
index 9073e877295f..400c2c21c278 100644
--- a/extensions/slack/account-inspect-api.ts
+++ b/extensions/slack/account-inspect-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { inspectSlackAccount } from "./src/account-inspect.js";
 
diff --git a/extensions/slack/api.ts b/extensions/slack/api.ts
index f7fe86efbb4f..74585e7f10f5 100644
--- a/extensions/slack/api.ts
+++ b/extensions/slack/api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export { slackPlugin } from "./src/channel.js";
 export { slackSetupPlugin } from "./src/channel.setup.js";
 export {
diff --git a/extensions/slack/channel-config-api.ts b/extensions/slack/channel-config-api.ts
index cba61dacd486..477bb0f4ab84 100644
--- a/extensions/slack/channel-config-api.ts
+++ b/extensions/slack/channel-config-api.ts
@@ -1 +1,2 @@
+// Slack API module exposes the plugin public contract.
 export { SlackChannelConfigSchema } from "./src/config-schema.js";
diff --git a/extensions/slack/channel-entry.ts b/extensions/slack/channel-entry.ts
index 6a01736e52d3..9a8e18cb8a74 100644
--- a/extensions/slack/channel-entry.ts
+++ b/extensions/slack/channel-entry.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements channel entry behavior.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/slack/config-api.ts b/extensions/slack/config-api.ts
index 99c4efe904c7..f526b8c8d7e8 100644
--- a/extensions/slack/config-api.ts
+++ b/extensions/slack/config-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export {
   buildChannelConfigSchema,
   SlackConfigSchema,
diff --git a/extensions/slack/configured-state.ts b/extensions/slack/configured-state.ts
index 593c1078fb9e..01c3d989627c 100644
--- a/extensions/slack/configured-state.ts
+++ b/extensions/slack/configured-state.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports configured state behavior.
 const SLACK_CONFIGURED_ENV_KEYS = ["SLACK_APP_TOKEN", "SLACK_BOT_TOKEN", "SLACK_USER_TOKEN"];
 
 export function hasSlackConfiguredState(params: { env?: NodeJS.ProcessEnv }): boolean {
diff --git a/extensions/slack/contract-api.ts b/extensions/slack/contract-api.ts
index 6b5b5c85d237..d2cb73611820 100644
--- a/extensions/slack/contract-api.ts
+++ b/extensions/slack/contract-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
 export {
   listSlackDirectoryGroupsFromConfig,
diff --git a/extensions/slack/directory-contract-api.ts b/extensions/slack/directory-contract-api.ts
index 183f055df409..f9e4b0043d41 100644
--- a/extensions/slack/directory-contract-api.ts
+++ b/extensions/slack/directory-contract-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export {
   listSlackDirectoryGroupsFromConfig,
   listSlackDirectoryPeersFromConfig,
diff --git a/extensions/slack/doctor-contract-api.ts b/extensions/slack/doctor-contract-api.ts
index a7a56f234421..1424fc31317e 100644
--- a/extensions/slack/doctor-contract-api.ts
+++ b/extensions/slack/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Slack API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
diff --git a/extensions/slack/inbound-contract-test-api.ts b/extensions/slack/inbound-contract-test-api.ts
index 18d6d74fd45b..10cc22319a97 100644
--- a/extensions/slack/inbound-contract-test-api.ts
+++ b/extensions/slack/inbound-contract-test-api.ts
@@ -1,2 +1,3 @@
+// Slack API module exposes the plugin public contract.
 export { prepareSlackMessage } from "./src/monitor/message-handler/prepare.js";
 export { createInboundSlackTestContext } from "./src/monitor/message-handler/prepare.test-helpers.js";
diff --git a/extensions/slack/index.test.ts b/extensions/slack/index.test.ts
index 8a4095ded21f..ee7371241dd9 100644
--- a/extensions/slack/index.test.ts
+++ b/extensions/slack/index.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover index plugin behavior.
 import { assertBundledChannelEntries } from "openclaw/plugin-sdk/channel-test-helpers";
 import { describe, expect, it, vi } from "vitest";
 import entry from "./index.js";
diff --git a/extensions/slack/index.ts b/extensions/slack/index.ts
index f6ab3376585f..38406beea4fd 100644
--- a/extensions/slack/index.ts
+++ b/extensions/slack/index.ts
@@ -1,3 +1,4 @@
+// Slack plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 import { registerSlackPluginHttpRoutes } from "./http-routes-api.js";
 
diff --git a/extensions/slack/interactive-replies-api.ts b/extensions/slack/interactive-replies-api.ts
index c15aea993571..3f5630b5f6fb 100644
--- a/extensions/slack/interactive-replies-api.ts
+++ b/extensions/slack/interactive-replies-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export {
   compileSlackInteractiveReplies,
   isSlackInteractiveRepliesEnabled,
diff --git a/extensions/slack/message-tool-api.ts b/extensions/slack/message-tool-api.ts
index 9610b751ec22..0388d71251c8 100644
--- a/extensions/slack/message-tool-api.ts
+++ b/extensions/slack/message-tool-api.ts
@@ -1 +1,2 @@
+// Slack API module exposes the plugin public contract.
 export { describeSlackMessageTool as describeMessageTool } from "./src/message-tool-api.js";
diff --git a/extensions/slack/outbound-payload-test-api.ts b/extensions/slack/outbound-payload-test-api.ts
index ef7148e19976..ed65ed6a78a0 100644
--- a/extensions/slack/outbound-payload-test-api.ts
+++ b/extensions/slack/outbound-payload-test-api.ts
@@ -1 +1,2 @@
+// Slack API module exposes the plugin public contract.
 export { createSlackOutboundPayloadHarness } from "./src/outbound-payload.test-harness.js";
diff --git a/extensions/slack/runtime-api.ts b/extensions/slack/runtime-api.ts
index 3af49fb5fb48..4bf07e691e26 100644
--- a/extensions/slack/runtime-api.ts
+++ b/extensions/slack/runtime-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export {
   handleSlackAction,
   slackActionRuntime,
diff --git a/extensions/slack/secret-contract-api.ts b/extensions/slack/secret-contract-api.ts
index 9f44ef28569c..90acb4221729 100644
--- a/extensions/slack/secret-contract-api.ts
+++ b/extensions/slack/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/slack/security-contract-api.ts b/extensions/slack/security-contract-api.ts
index 40949335a234..4f370c5e401b 100644
--- a/extensions/slack/security-contract-api.ts
+++ b/extensions/slack/security-contract-api.ts
@@ -1 +1,2 @@
+// Slack API module exposes the plugin public contract.
 export { collectSlackSecurityAuditFindings } from "./src/security-audit.js";
diff --git a/extensions/slack/setup-entry.ts b/extensions/slack/setup-entry.ts
index a0ae17a327db..3d748cdcc387 100644
--- a/extensions/slack/setup-entry.ts
+++ b/extensions/slack/setup-entry.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 import { registerSlackPluginHttpRoutes } from "./http-routes-api.js";
 
diff --git a/extensions/slack/src/account-configured.ts b/extensions/slack/src/account-configured.ts
index da7dd0e17c97..90bc96e595f2 100644
--- a/extensions/slack/src/account-configured.ts
+++ b/extensions/slack/src/account-configured.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports account configured behavior.
 import { hasConfiguredAccountValue } from "openclaw/plugin-sdk/account-resolution";
 import type { ResolvedSlackAccount } from "./accounts.js";
 
diff --git a/extensions/slack/src/account-inspect.ts b/extensions/slack/src/account-inspect.ts
index f00babbdbfb1..7f44116dd75e 100644
--- a/extensions/slack/src/account-inspect.ts
+++ b/extensions/slack/src/account-inspect.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements account inspect behavior.
 import {
   DEFAULT_ACCOUNT_ID,
   normalizeAccountId,
diff --git a/extensions/slack/src/account-reply-mode.ts b/extensions/slack/src/account-reply-mode.ts
index 2012c05c0764..dd1803149ee2 100644
--- a/extensions/slack/src/account-reply-mode.ts
+++ b/extensions/slack/src/account-reply-mode.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements account reply mode behavior.
 import type { SlackAccountConfig } from "./runtime-api.js";
 
 type SlackReplyToMode = "off" | "first" | "all" | "batched";
diff --git a/extensions/slack/src/account-surface-fields.ts b/extensions/slack/src/account-surface-fields.ts
index b3d2bcc9cec8..293f4b7694c3 100644
--- a/extensions/slack/src/account-surface-fields.ts
+++ b/extensions/slack/src/account-surface-fields.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements account surface fields behavior.
 import type { SlackAccountConfig } from "openclaw/plugin-sdk/config-contracts";
 
 export type SlackAccountSurfaceFields = {
diff --git a/extensions/slack/src/accounts.runtime.ts b/extensions/slack/src/accounts.runtime.ts
index 6de32da1c3c4..7d9cd829b91e 100644
--- a/extensions/slack/src/accounts.runtime.ts
+++ b/extensions/slack/src/accounts.runtime.ts
@@ -1 +1,2 @@
+// Slack plugin module implements accounts behavior.
 export { resolveSlackAccount } from "./accounts.js";
diff --git a/extensions/slack/src/accounts.test.ts b/extensions/slack/src/accounts.test.ts
index ae6340c02bf7..20336ad39b60 100644
--- a/extensions/slack/src/accounts.test.ts
+++ b/extensions/slack/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover accounts plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/slack/src/accounts.ts b/extensions/slack/src/accounts.ts
index 399de4209a66..2489d6352715 100644
--- a/extensions/slack/src/accounts.ts
+++ b/extensions/slack/src/accounts.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements accounts behavior.
 import {
   createAccountListHelpers,
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/slack/src/action-runtime.runtime.ts b/extensions/slack/src/action-runtime.runtime.ts
index 836c39ac4496..3eeba48afcb1 100644
--- a/extensions/slack/src/action-runtime.runtime.ts
+++ b/extensions/slack/src/action-runtime.runtime.ts
@@ -1 +1,2 @@
+// Slack plugin module implements action runtime behavior.
 export { handleSlackAction } from "./action-runtime.js";
diff --git a/extensions/slack/src/action-runtime.test.ts b/extensions/slack/src/action-runtime.test.ts
index d99971f13eb5..47422127614a 100644
--- a/extensions/slack/src/action-runtime.test.ts
+++ b/extensions/slack/src/action-runtime.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover action runtime plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { handleSlackAction, slackActionRuntime } from "./action-runtime.js";
diff --git a/extensions/slack/src/action-runtime.ts b/extensions/slack/src/action-runtime.ts
index 54acc971ccac..988c32c5d150 100644
--- a/extensions/slack/src/action-runtime.ts
+++ b/extensions/slack/src/action-runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements action runtime behavior.
 import type { AgentToolResult } from "openclaw/plugin-sdk/agent-core";
 import { readBooleanParam } from "openclaw/plugin-sdk/boolean-param";
 import { isSingleUseReplyToMode } from "openclaw/plugin-sdk/reply-reference";
diff --git a/extensions/slack/src/action-threading.test.ts b/extensions/slack/src/action-threading.test.ts
index 000c3fa9361b..c74ff903ad8a 100644
--- a/extensions/slack/src/action-threading.test.ts
+++ b/extensions/slack/src/action-threading.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover action threading plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveSlackAutoThreadId } from "./action-threading.js";
 
diff --git a/extensions/slack/src/action-threading.ts b/extensions/slack/src/action-threading.ts
index 10b824855604..97293823af8f 100644
--- a/extensions/slack/src/action-threading.ts
+++ b/extensions/slack/src/action-threading.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements action threading behavior.
 import { isSingleUseReplyToMode } from "openclaw/plugin-sdk/reply-reference";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { parseSlackTarget } from "./targets.js";
diff --git a/extensions/slack/src/actions.blocks.test.ts b/extensions/slack/src/actions.blocks.test.ts
index 8fe6702ca84a..63d02c4a10e2 100644
--- a/extensions/slack/src/actions.blocks.test.ts
+++ b/extensions/slack/src/actions.blocks.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover actions.blocks plugin behavior.
 import { describe, expect, it } from "vitest";
 import { createSlackEditTestClient, installSlackBlockTestMocks } from "./blocks.test-helpers.js";
 
diff --git a/extensions/slack/src/actions.download-file.test.ts b/extensions/slack/src/actions.download-file.test.ts
index f2b4ad23dcdc..f365bf20384b 100644
--- a/extensions/slack/src/actions.download-file.test.ts
+++ b/extensions/slack/src/actions.download-file.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover actionsownload file plugin behavior.
 import type { WebClient } from "@slack/web-api";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/slack/src/actions.reactions.test.ts b/extensions/slack/src/actions.reactions.test.ts
index 6b4154b45bd7..78fc3e8fad33 100644
--- a/extensions/slack/src/actions.reactions.test.ts
+++ b/extensions/slack/src/actions.reactions.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover actions.reactions plugin behavior.
 import type { WebClient } from "@slack/web-api";
 import { describe, expect, it, vi } from "vitest";
 import { reactSlackMessage, removeOwnSlackReactions, removeSlackReaction } from "./actions.js";
diff --git a/extensions/slack/src/actions.read.test.ts b/extensions/slack/src/actions.read.test.ts
index 53cc631ada48..2c916d79ebe5 100644
--- a/extensions/slack/src/actions.read.test.ts
+++ b/extensions/slack/src/actions.read.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover actions.read plugin behavior.
 import type { WebClient } from "@slack/web-api";
 import { describe, expect, it, vi } from "vitest";
 import { readSlackMessages } from "./actions.js";
diff --git a/extensions/slack/src/actions.runtime.ts b/extensions/slack/src/actions.runtime.ts
index de4f9b66709e..4ecf178e20f4 100644
--- a/extensions/slack/src/actions.runtime.ts
+++ b/extensions/slack/src/actions.runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements actions behavior.
 export {
   deleteSlackMessage,
   downloadSlackFile,
diff --git a/extensions/slack/src/actions.ts b/extensions/slack/src/actions.ts
index b17972f0dfaf..c922d0eb6861 100644
--- a/extensions/slack/src/actions.ts
+++ b/extensions/slack/src/actions.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements actions behavior.
 import type { Block, KnownBlock, WebClient } from "@slack/web-api";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
diff --git a/extensions/slack/src/approval-auth.test.ts b/extensions/slack/src/approval-auth.test.ts
index 4fcb4b67e56a..895bb8ec8fc7 100644
--- a/extensions/slack/src/approval-auth.test.ts
+++ b/extensions/slack/src/approval-auth.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isSlackApprovalAuthorizedSender, slackApprovalAuth } from "./approval-auth.js";
 
diff --git a/extensions/slack/src/approval-auth.ts b/extensions/slack/src/approval-auth.ts
index e171813371d7..bbdef56a252b 100644
--- a/extensions/slack/src/approval-auth.ts
+++ b/extensions/slack/src/approval-auth.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,
diff --git a/extensions/slack/src/approval-handler.runtime.test.ts b/extensions/slack/src/approval-handler.runtime.test.ts
index fe24540b24a2..0cdb9a7be152 100644
--- a/extensions/slack/src/approval-handler.runtime.test.ts
+++ b/extensions/slack/src/approval-handler.runtime.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover approval handler plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { slackApprovalNativeRuntime } from "./approval-handler.runtime.js";
 
diff --git a/extensions/slack/src/approval-handler.runtime.ts b/extensions/slack/src/approval-handler.runtime.ts
index 27e674856e38..95ca12a01cf1 100644
--- a/extensions/slack/src/approval-handler.runtime.ts
+++ b/extensions/slack/src/approval-handler.runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements approval handler behavior.
 import type { App } from "@slack/bolt";
 import type { Block, KnownBlock } from "@slack/web-api";
 import type {
diff --git a/extensions/slack/src/approval-native-gates.ts b/extensions/slack/src/approval-native-gates.ts
index e4c3cb46532c..353ad4ce62e8 100644
--- a/extensions/slack/src/approval-native-gates.ts
+++ b/extensions/slack/src/approval-native-gates.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements approval native gates behavior.
 import {
   isChannelExecApprovalClientEnabledFromConfig,
   matchesApprovalRequestFilters,
diff --git a/extensions/slack/src/approval-native.test.ts b/extensions/slack/src/approval-native.test.ts
index c31066788adb..28d1abb63cb1 100644
--- a/extensions/slack/src/approval-native.test.ts
+++ b/extensions/slack/src/approval-native.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover approval native plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/slack/src/approval-native.ts b/extensions/slack/src/approval-native.ts
index c1a0164bc7e0..170f3713fa0d 100644
--- a/extensions/slack/src/approval-native.ts
+++ b/extensions/slack/src/approval-native.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements approval native behavior.
 import {
   createApproverRestrictedNativeApprovalCapability,
   splitChannelApprovalCapability,
diff --git a/extensions/slack/src/blocks-fallback.ts b/extensions/slack/src/blocks-fallback.ts
index 28151cae3cf0..412b5f1bd382 100644
--- a/extensions/slack/src/blocks-fallback.ts
+++ b/extensions/slack/src/blocks-fallback.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements blocks fallback behavior.
 import type { Block, KnownBlock } from "@slack/web-api";
 
 type PlainTextObject = { text?: string };
diff --git a/extensions/slack/src/blocks-input.ts b/extensions/slack/src/blocks-input.ts
index 02df24645362..d9e1b7987c32 100644
--- a/extensions/slack/src/blocks-input.ts
+++ b/extensions/slack/src/blocks-input.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements blocks input behavior.
 import type { Block, KnownBlock } from "@slack/web-api";
 
 export const SLACK_MAX_BLOCKS = 50;
diff --git a/extensions/slack/src/blocks-render.ts b/extensions/slack/src/blocks-render.ts
index 52cfe28a0a31..82ca396c33ab 100644
--- a/extensions/slack/src/blocks-render.ts
+++ b/extensions/slack/src/blocks-render.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements blocks render behavior.
 import type { Block, KnownBlock } from "@slack/web-api";
 import { parseExecApprovalCommandText } from "openclaw/plugin-sdk/approval-reply-runtime";
 import {
diff --git a/extensions/slack/src/blocks.test-helpers.ts b/extensions/slack/src/blocks.test-helpers.ts
index 61f11f9979b0..1b3de22fca13 100644
--- a/extensions/slack/src/blocks.test-helpers.ts
+++ b/extensions/slack/src/blocks.test-helpers.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports blocks helpers behavior.
 import type { WebClient } from "@slack/web-api";
 import { vi } from "vitest";
 
diff --git a/extensions/slack/src/blocks.test.ts b/extensions/slack/src/blocks.test.ts
index 814d9b3a2fb9..a560d5e498aa 100644
--- a/extensions/slack/src/blocks.test.ts
+++ b/extensions/slack/src/blocks.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover blocks plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildSlackBlocksFallbackText } from "./blocks-fallback.js";
 import { parseSlackBlocksInput } from "./blocks-input.js";
diff --git a/extensions/slack/src/channel-actions-setup-status.contract.test.ts b/extensions/slack/src/channel-actions-setup-status.contract.test.ts
index 97b147890b48..20e7b722a215 100644
--- a/extensions/slack/src/channel-actions-setup-status.contract.test.ts
+++ b/extensions/slack/src/channel-actions-setup-status.contract.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover channel actions setup status.contract plugin behavior.
 import {
   installChannelActionsContractSuite,
   installChannelSetupContractSuite,
diff --git a/extensions/slack/src/channel-actions.ts b/extensions/slack/src/channel-actions.ts
index 82f38eab1664..dfd3c61899f9 100644
--- a/extensions/slack/src/channel-actions.ts
+++ b/extensions/slack/src/channel-actions.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements channel actions behavior.
 import type { AgentToolResult } from "openclaw/plugin-sdk/agent-core";
 import type { ChannelMessageActionAdapter } from "openclaw/plugin-sdk/channel-contract";
 import type { SlackActionContext } from "./action-runtime.js";
diff --git a/extensions/slack/src/channel-api.ts b/extensions/slack/src/channel-api.ts
index 66a5cfe1acd9..eec85af173a3 100644
--- a/extensions/slack/src/channel-api.ts
+++ b/extensions/slack/src/channel-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 export {
   PAIRING_APPROVED_MESSAGE,
diff --git a/extensions/slack/src/channel-migration.test.ts b/extensions/slack/src/channel-migration.test.ts
index 047cc3c6d2c0..a8a81d06aa5b 100644
--- a/extensions/slack/src/channel-migration.test.ts
+++ b/extensions/slack/src/channel-migration.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover channel migration plugin behavior.
 import { describe, expect, it } from "vitest";
 import { migrateSlackChannelConfig, migrateSlackChannelsInPlace } from "./channel-migration.js";
 
diff --git a/extensions/slack/src/channel-migration.ts b/extensions/slack/src/channel-migration.ts
index 350091e9e5e6..65bbce26c7e0 100644
--- a/extensions/slack/src/channel-migration.ts
+++ b/extensions/slack/src/channel-migration.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements channel migration behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { SlackChannelConfig } from "openclaw/plugin-sdk/config-contracts";
 import { normalizeAccountId } from "openclaw/plugin-sdk/routing";
diff --git a/extensions/slack/src/channel-type.test.ts b/extensions/slack/src/channel-type.test.ts
index be1f6f30c206..120afa2dc0f5 100644
--- a/extensions/slack/src/channel-type.test.ts
+++ b/extensions/slack/src/channel-type.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover channel type plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   resetSlackChannelTypeCacheForTest,
diff --git a/extensions/slack/src/channel-type.ts b/extensions/slack/src/channel-type.ts
index 9153c29a8880..b766cb1a78d3 100644
--- a/extensions/slack/src/channel-type.ts
+++ b/extensions/slack/src/channel-type.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements channel type behavior.
 import {
   normalizeLowercaseStringOrEmpty,
   normalizeOptionalString,
diff --git a/extensions/slack/src/channel.message-adapter.test.ts b/extensions/slack/src/channel.message-adapter.test.ts
index 2826377a3c2c..9b1878c54652 100644
--- a/extensions/slack/src/channel.message-adapter.test.ts
+++ b/extensions/slack/src/channel.message-adapter.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover channel.message adapter plugin behavior.
 import {
   verifyChannelMessageAdapterCapabilityProofs,
   verifyChannelMessageLiveCapabilityAdapterProofs,
diff --git a/extensions/slack/src/channel.setup.ts b/extensions/slack/src/channel.setup.ts
index ed5e4ed085bf..85e6753778f1 100644
--- a/extensions/slack/src/channel.setup.ts
+++ b/extensions/slack/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements channel.setup behavior.
 import { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
 import {
   adaptScopedAccountAccessor,
diff --git a/extensions/slack/src/channel.test.ts b/extensions/slack/src/channel.test.ts
index e01776210a3f..54c539fc4181 100644
--- a/extensions/slack/src/channel.test.ts
+++ b/extensions/slack/src/channel.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover channel plugin behavior.
 import { createRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { slackPlugin } from "./channel.js";
diff --git a/extensions/slack/src/channel.ts b/extensions/slack/src/channel.ts
index 994db13f400e..fe2133b3e1ec 100644
--- a/extensions/slack/src/channel.ts
+++ b/extensions/slack/src/channel.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements channel behavior.
 import {
   buildLegacyDmAccountAllowlistAdapter,
   createAccountScopedAllowlistNameResolver,
diff --git a/extensions/slack/src/client-options.ts b/extensions/slack/src/client-options.ts
index 4fa7fea02076..5660fd8305db 100644
--- a/extensions/slack/src/client-options.ts
+++ b/extensions/slack/src/client-options.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements client options behavior.
 import type { Agent } from "node:http";
 import type { RetryOptions, WebClientOptions } from "@slack/web-api";
 import { createNodeProxyAgent } from "openclaw/plugin-sdk/fetch-runtime";
diff --git a/extensions/slack/src/client.test.ts b/extensions/slack/src/client.test.ts
index 22618402eb08..02c7a333c41d 100644
--- a/extensions/slack/src/client.test.ts
+++ b/extensions/slack/src/client.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover client plugin behavior.
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/slack/src/client.ts b/extensions/slack/src/client.ts
index 9b90ea26e15b..16e70e1f922e 100644
--- a/extensions/slack/src/client.ts
+++ b/extensions/slack/src/client.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements client behavior.
 import { createHash } from "node:crypto";
 import { type WebClientOptions, WebClient } from "@slack/web-api";
 import { resolveSlackWebClientOptions, resolveSlackWriteClientOptions } from "./client-options.js";
diff --git a/extensions/slack/src/config-schema.test.ts b/extensions/slack/src/config-schema.test.ts
index 2d3ca03c9970..cd5d3d0480d1 100644
--- a/extensions/slack/src/config-schema.test.ts
+++ b/extensions/slack/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { SlackConfigSchema } from "../config-api.js";
 
diff --git a/extensions/slack/src/config-schema.ts b/extensions/slack/src/config-schema.ts
index d029e7899568..e484c310dc9d 100644
--- a/extensions/slack/src/config-schema.ts
+++ b/extensions/slack/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports config schema behavior.
 import { buildChannelConfigSchema, SlackConfigSchema } from "../config-api.js";
 import { slackChannelConfigUiHints } from "./config-ui-hints.js";
 
diff --git a/extensions/slack/src/config-ui-hints.ts b/extensions/slack/src/config-ui-hints.ts
index eb31506b50fd..58c41505a448 100644
--- a/extensions/slack/src/config-ui-hints.ts
+++ b/extensions/slack/src/config-ui-hints.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports config ui hints behavior.
 import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/channel-core";
 
 export const slackChannelConfigUiHints = {
diff --git a/extensions/slack/src/directory-config.ts b/extensions/slack/src/directory-config.ts
index ad1e2114eb80..66c4d7c7e12d 100644
--- a/extensions/slack/src/directory-config.ts
+++ b/extensions/slack/src/directory-config.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports directory config behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-resolution";
 import {
   createResolvedDirectoryEntriesLister,
diff --git a/extensions/slack/src/directory-contract.test.ts b/extensions/slack/src/directory-contract.test.ts
index cad3dd112e34..30a4c6051180 100644
--- a/extensions/slack/src/directory-contract.test.ts
+++ b/extensions/slack/src/directory-contract.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover directory contract plugin behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import { expectDirectoryIds } from "openclaw/plugin-sdk/channel-test-helpers";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/slack/src/directory-live.ts b/extensions/slack/src/directory-live.ts
index c9415e67df6c..906dc1804f0a 100644
--- a/extensions/slack/src/directory-live.ts
+++ b/extensions/slack/src/directory-live.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements directory live behavior.
 import type {
   ChannelDirectoryEntry,
   DirectoryConfigParams,
diff --git a/extensions/slack/src/doctor-contract.ts b/extensions/slack/src/doctor-contract.ts
index 6d8b9b97543b..bf6398f05a1b 100644
--- a/extensions/slack/src/doctor-contract.ts
+++ b/extensions/slack/src/doctor-contract.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements doctor contract behavior.
 import type {
   ChannelDoctorConfigMutation,
   ChannelDoctorLegacyConfigRule,
diff --git a/extensions/slack/src/doctor.test.ts b/extensions/slack/src/doctor.test.ts
index 599ffa841977..8ddfd947e37b 100644
--- a/extensions/slack/src/doctor.test.ts
+++ b/extensions/slack/src/doctor.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover doctor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { slackDoctor } from "./doctor.js";
 
diff --git a/extensions/slack/src/doctor.ts b/extensions/slack/src/doctor.ts
index 8e294b783c0b..2633fb55cb3e 100644
--- a/extensions/slack/src/doctor.ts
+++ b/extensions/slack/src/doctor.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements doctor behavior.
 import type { ChannelDoctorAdapter } from "openclaw/plugin-sdk/channel-contract";
 import { createDangerousNameMatchingMutableAllowlistWarningCollector } from "openclaw/plugin-sdk/channel-policy";
 import {
diff --git a/extensions/slack/src/draft-stream.test.ts b/extensions/slack/src/draft-stream.test.ts
index be795dbf33c4..adbac993ad55 100644
--- a/extensions/slack/src/draft-stream.test.ts
+++ b/extensions/slack/src/draft-stream.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover draft stream plugin behavior.
 import { createMessageReceiptFromOutboundResults } from "openclaw/plugin-sdk/channel-outbound";
 import { describe, expect, it, vi } from "vitest";
 import { createSlackDraftStream } from "./draft-stream.js";
diff --git a/extensions/slack/src/draft-stream.ts b/extensions/slack/src/draft-stream.ts
index d4f7a2635fb1..be7340c43c10 100644
--- a/extensions/slack/src/draft-stream.ts
+++ b/extensions/slack/src/draft-stream.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements draft stream behavior.
 import type { MessageMetadata } from "@slack/types";
 import type { Block, KnownBlock } from "@slack/web-api";
 import { createDraftStreamLoop } from "openclaw/plugin-sdk/channel-outbound";
diff --git a/extensions/slack/src/edit-text.ts b/extensions/slack/src/edit-text.ts
index f265047413cd..6f122197f66f 100644
--- a/extensions/slack/src/edit-text.ts
+++ b/extensions/slack/src/edit-text.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements edit text behavior.
 import type { Block, KnownBlock } from "@slack/web-api";
 import { buildSlackBlocksFallbackText } from "./blocks-fallback.js";
 import { SLACK_TEXT_LIMIT } from "./limits.js";
diff --git a/extensions/slack/src/errors.test.ts b/extensions/slack/src/errors.test.ts
index c225a43abf61..d4d380817f5d 100644
--- a/extensions/slack/src/errors.test.ts
+++ b/extensions/slack/src/errors.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover errors plugin behavior.
 import { describe, expect, it } from "vitest";
 import { formatSlackError } from "./errors.js";
 
diff --git a/extensions/slack/src/errors.ts b/extensions/slack/src/errors.ts
index d7aa4e82fa7d..4b6bb950f5f9 100644
--- a/extensions/slack/src/errors.ts
+++ b/extensions/slack/src/errors.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements errors behavior.
 import { redactSensitiveText } from "openclaw/plugin-sdk/logging-core";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/slack/src/exec-approvals.test.ts b/extensions/slack/src/exec-approvals.test.ts
index f1056eaa160c..a15bd80acf35 100644
--- a/extensions/slack/src/exec-approvals.test.ts
+++ b/extensions/slack/src/exec-approvals.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover exec approvals plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/slack/src/exec-approvals.ts b/extensions/slack/src/exec-approvals.ts
index 8586290f057a..cf015f2b6fd8 100644
--- a/extensions/slack/src/exec-approvals.ts
+++ b/extensions/slack/src/exec-approvals.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements exec approvals behavior.
 import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 import {
   createChannelExecApprovalProfile,
diff --git a/extensions/slack/src/file-reference.ts b/extensions/slack/src/file-reference.ts
index c8ebb7637ed3..1a568752621e 100644
--- a/extensions/slack/src/file-reference.ts
+++ b/extensions/slack/src/file-reference.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements file reference behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { SlackFile } from "./types.js";
 
diff --git a/extensions/slack/src/format.test.ts b/extensions/slack/src/format.test.ts
index 67721b1c841b..7ee986987d1b 100644
--- a/extensions/slack/src/format.test.ts
+++ b/extensions/slack/src/format.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover format plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   markdownToSlackMrkdwn,
diff --git a/extensions/slack/src/format.ts b/extensions/slack/src/format.ts
index bbb30fab9dbe..9e97b2fc8d95 100644
--- a/extensions/slack/src/format.ts
+++ b/extensions/slack/src/format.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports format behavior.
 import type { MarkdownTableMode } from "openclaw/plugin-sdk/config-contracts";
 import {
   markdownToIR,
diff --git a/extensions/slack/src/group-policy.test.ts b/extensions/slack/src/group-policy.test.ts
index 89dbd0ad7c86..87ed8f00f5e2 100644
--- a/extensions/slack/src/group-policy.test.ts
+++ b/extensions/slack/src/group-policy.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover group policy plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveSlackGroupRequireMention, resolveSlackGroupToolPolicy } from "./group-policy.js";
 
diff --git a/extensions/slack/src/group-policy.ts b/extensions/slack/src/group-policy.ts
index d4ab891c5516..e668de4906db 100644
--- a/extensions/slack/src/group-policy.ts
+++ b/extensions/slack/src/group-policy.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements group policy behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-resolution";
 import type { ChannelGroupContext } from "openclaw/plugin-sdk/channel-contract";
 import {
diff --git a/extensions/slack/src/http/index.ts b/extensions/slack/src/http/index.ts
index 0e8ed1bc93d5..f9290b1946e0 100644
--- a/extensions/slack/src/http/index.ts
+++ b/extensions/slack/src/http/index.ts
@@ -1 +1,2 @@
+// Slack plugin entrypoint registers its OpenClaw integration.
 export * from "./registry.js";
diff --git a/extensions/slack/src/http/paths.ts b/extensions/slack/src/http/paths.ts
index 1d83c132af67..d5f31dc7f789 100644
--- a/extensions/slack/src/http/paths.ts
+++ b/extensions/slack/src/http/paths.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements paths behavior.
 export function normalizeSlackWebhookPath(path?: string | null): string {
   const trimmed = path?.trim();
   if (!trimmed) {
diff --git a/extensions/slack/src/http/plugin-routes.test.ts b/extensions/slack/src/http/plugin-routes.test.ts
index 53e4d86908c4..7880105842cd 100644
--- a/extensions/slack/src/http/plugin-routes.test.ts
+++ b/extensions/slack/src/http/plugin-routes.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover plugin routes plugin behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/slack/src/http/plugin-routes.ts b/extensions/slack/src/http/plugin-routes.ts
index 63ba43f91248..931ef8202b42 100644
--- a/extensions/slack/src/http/plugin-routes.ts
+++ b/extensions/slack/src/http/plugin-routes.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements plugin routes behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
 import { normalizeSlackWebhookPath } from "./paths.js";
diff --git a/extensions/slack/src/http/registry.test.ts b/extensions/slack/src/http/registry.test.ts
index dd117e99908c..ac36e5774ee8 100644
--- a/extensions/slack/src/http/registry.test.ts
+++ b/extensions/slack/src/http/registry.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover registry plugin behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/slack/src/http/registry.ts b/extensions/slack/src/http/registry.ts
index 2a95eda730b1..7cb6550d61a5 100644
--- a/extensions/slack/src/http/registry.ts
+++ b/extensions/slack/src/http/registry.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements registry behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { normalizeSlackWebhookPath } from "./paths.js";
 
diff --git a/extensions/slack/src/inbound-context.contract.test.ts b/extensions/slack/src/inbound-context.contract.test.ts
index ac14555be0b8..20b6877def0d 100644
--- a/extensions/slack/src/inbound-context.contract.test.ts
+++ b/extensions/slack/src/inbound-context.contract.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover inbound context.contract plugin behavior.
 import { expectChannelInboundContextContract } from "openclaw/plugin-sdk/channel-contract-testing";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { createTempHomeEnv } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/slack/src/index.ts b/extensions/slack/src/index.ts
index f7b5f436fc49..410afec99a5b 100644
--- a/extensions/slack/src/index.ts
+++ b/extensions/slack/src/index.ts
@@ -1,3 +1,4 @@
+// Slack plugin entrypoint registers its OpenClaw integration.
 export {
   listEnabledSlackAccounts,
   listSlackAccountIds,
diff --git a/extensions/slack/src/interactive-dispatch.ts b/extensions/slack/src/interactive-dispatch.ts
index 4cca0ed7d4a3..53e427132792 100644
--- a/extensions/slack/src/interactive-dispatch.ts
+++ b/extensions/slack/src/interactive-dispatch.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements interactive dispatch behavior.
 import {
   createInteractiveConversationBindingHelpers,
   dispatchPluginInteractiveHandler,
diff --git a/extensions/slack/src/interactive-replies.test.ts b/extensions/slack/src/interactive-replies.test.ts
index 10b97f6a5607..aac2c460d869 100644
--- a/extensions/slack/src/interactive-replies.test.ts
+++ b/extensions/slack/src/interactive-replies.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover interactive replies plugin behavior.
 import { describe, expect, it } from "vitest";
 import { compileSlackInteractiveReplies } from "./interactive-replies.js";
 
diff --git a/extensions/slack/src/interactive-replies.ts b/extensions/slack/src/interactive-replies.ts
index bf992e8bad0a..06f9ac6c26ac 100644
--- a/extensions/slack/src/interactive-replies.ts
+++ b/extensions/slack/src/interactive-replies.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements interactive replies behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import {
diff --git a/extensions/slack/src/limits.ts b/extensions/slack/src/limits.ts
index 3c37921b65c0..ba093e11f384 100644
--- a/extensions/slack/src/limits.ts
+++ b/extensions/slack/src/limits.ts
@@ -1 +1,2 @@
+// Slack plugin module implements limits behavior.
 export const SLACK_TEXT_LIMIT = 8000;
diff --git a/extensions/slack/src/message-action-dispatch.test.ts b/extensions/slack/src/message-action-dispatch.test.ts
index ad2365f05ed3..11b140a9c070 100644
--- a/extensions/slack/src/message-action-dispatch.test.ts
+++ b/extensions/slack/src/message-action-dispatch.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover message action dispatch plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { handleSlackMessageAction } from "./message-action-dispatch.js";
 
diff --git a/extensions/slack/src/message-action-dispatch.ts b/extensions/slack/src/message-action-dispatch.ts
index 7854ed78815c..dae5e10fa804 100644
--- a/extensions/slack/src/message-action-dispatch.ts
+++ b/extensions/slack/src/message-action-dispatch.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements message action dispatch behavior.
 import type { AgentToolResult } from "openclaw/plugin-sdk/agent-core";
 import { readBooleanParam } from "openclaw/plugin-sdk/boolean-param";
 import type { ChannelMessageActionContext } from "openclaw/plugin-sdk/channel-contract";
diff --git a/extensions/slack/src/message-actions.ts b/extensions/slack/src/message-actions.ts
index 06e88f5c305a..12961eb8bbfa 100644
--- a/extensions/slack/src/message-actions.ts
+++ b/extensions/slack/src/message-actions.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements message actions behavior.
 import { createActionGate } from "openclaw/plugin-sdk/channel-actions";
 import type { ChannelMessageActionName } from "openclaw/plugin-sdk/channel-contract";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/slack/src/message-tool-api.ts b/extensions/slack/src/message-tool-api.ts
index b8453b54bc93..a2145e07adf7 100644
--- a/extensions/slack/src/message-tool-api.ts
+++ b/extensions/slack/src/message-tool-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 import type {
   ChannelMessageActionAdapter,
   ChannelMessageActionName,
diff --git a/extensions/slack/src/message-tools.test.ts b/extensions/slack/src/message-tools.test.ts
index 997cff32ebad..9ddb330e7c67 100644
--- a/extensions/slack/src/message-tools.test.ts
+++ b/extensions/slack/src/message-tools.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover message tools plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import { listSlackMessageActions } from "./message-actions.js";
diff --git a/extensions/slack/src/modal-metadata.ts b/extensions/slack/src/modal-metadata.ts
index f53f70563898..994eb965ebce 100644
--- a/extensions/slack/src/modal-metadata.ts
+++ b/extensions/slack/src/modal-metadata.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements modal metadata behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 type SlackModalPrivateMetadata = {
diff --git a/extensions/slack/src/monitor.test-helpers.ts b/extensions/slack/src/monitor.test-helpers.ts
index 60a7ec3d4ce2..1ffd0bd70b61 100644
--- a/extensions/slack/src/monitor.test-helpers.ts
+++ b/extensions/slack/src/monitor.test-helpers.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports monitor helpers behavior.
 import type { ChannelRuntimeSurface } from "openclaw/plugin-sdk/channel-contract";
 import { vi } from "vitest";
 import type { Mock } from "vitest";
diff --git a/extensions/slack/src/monitor.test.ts b/extensions/slack/src/monitor.test.ts
index eaf5a55ce2b2..c1f1697f1311 100644
--- a/extensions/slack/src/monitor.test.ts
+++ b/extensions/slack/src/monitor.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover monitor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildSlackSlashCommandMatcher } from "./monitor/commands.js";
 import { isSlackChannelAllowedByPolicy } from "./monitor/policy.js";
diff --git a/extensions/slack/src/monitor.threading.missing-thread-ts.test.ts b/extensions/slack/src/monitor.threading.missing-thread-ts.test.ts
index aa17db641c5f..7ba2ec450a25 100644
--- a/extensions/slack/src/monitor.threading.missing-thread-ts.test.ts
+++ b/extensions/slack/src/monitor.threading.missing-thread-ts.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover monitor.threading.missing thread ts plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createSlackThreadTsResolver } from "./monitor/thread-resolution.js";
 import type { SlackMessageEvent } from "./types.js";
diff --git a/extensions/slack/src/monitor.tool-result.test.ts b/extensions/slack/src/monitor.tool-result.test.ts
index 0a32b7357c69..a48fc60713a2 100644
--- a/extensions/slack/src/monitor.tool-result.test.ts
+++ b/extensions/slack/src/monitor.tool-result.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover monitor.tool result plugin behavior.
 import { CURRENT_MESSAGE_MARKER } from "openclaw/plugin-sdk/channel-mention-gating";
 import { expectPairingReplyText } from "openclaw/plugin-sdk/channel-test-helpers";
 import { HISTORY_CONTEXT_MARKER } from "openclaw/plugin-sdk/reply-history";
diff --git a/extensions/slack/src/monitor.ts b/extensions/slack/src/monitor.ts
index 95b584eb3c86..7063d479d77c 100644
--- a/extensions/slack/src/monitor.ts
+++ b/extensions/slack/src/monitor.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements monitor behavior.
 export { buildSlackSlashCommandMatcher } from "./monitor/commands.js";
 export { isSlackChannelAllowedByPolicy } from "./monitor/policy.js";
 export { monitorSlackProvider } from "./monitor/provider.js";
diff --git a/extensions/slack/src/monitor/allow-list.test.ts b/extensions/slack/src/monitor/allow-list.test.ts
index d6fdb7d94524..3761b12342f4 100644
--- a/extensions/slack/src/monitor/allow-list.test.ts
+++ b/extensions/slack/src/monitor/allow-list.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover allow list plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   normalizeAllowList,
diff --git a/extensions/slack/src/monitor/allow-list.ts b/extensions/slack/src/monitor/allow-list.ts
index 717369e39782..354534cf03b5 100644
--- a/extensions/slack/src/monitor/allow-list.ts
+++ b/extensions/slack/src/monitor/allow-list.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements allow list behavior.
 import {
   compileAllowlist,
   resolveCompiledAllowlistMatch,
diff --git a/extensions/slack/src/monitor/auth.test.ts b/extensions/slack/src/monitor/auth.test.ts
index c14c951b4d99..24d1810fc70e 100644
--- a/extensions/slack/src/monitor/auth.test.ts
+++ b/extensions/slack/src/monitor/auth.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover auth plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { SlackMonitorContext } from "./context.js";
 
diff --git a/extensions/slack/src/monitor/auth.ts b/extensions/slack/src/monitor/auth.ts
index cdfe747d894a..ba699e33fb81 100644
--- a/extensions/slack/src/monitor/auth.ts
+++ b/extensions/slack/src/monitor/auth.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements auth behavior.
 import {
   type ChannelIngressEventInput,
   type ChannelIngressIdentifierKind,
diff --git a/extensions/slack/src/monitor/channel-config.ts b/extensions/slack/src/monitor/channel-config.ts
index f54abc09d974..ab7e618b73c9 100644
--- a/extensions/slack/src/monitor/channel-config.ts
+++ b/extensions/slack/src/monitor/channel-config.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports channel config behavior.
 import {
   applyChannelMatchMeta,
   buildChannelKeyCandidates,
diff --git a/extensions/slack/src/monitor/channel-type.ts b/extensions/slack/src/monitor/channel-type.ts
index a21d2b310da5..a5a62e1eac66 100644
--- a/extensions/slack/src/monitor/channel-type.ts
+++ b/extensions/slack/src/monitor/channel-type.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements channel type behavior.
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { SlackMessageEvent } from "../types.js";
 
diff --git a/extensions/slack/src/monitor/commands.ts b/extensions/slack/src/monitor/commands.ts
index 5a3a4376bb56..ec8b557cab57 100644
--- a/extensions/slack/src/monitor/commands.ts
+++ b/extensions/slack/src/monitor/commands.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements commands behavior.
 import type { SlackSlashCommandConfig } from "openclaw/plugin-sdk/config-contracts";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/slack/src/monitor/config.runtime.ts b/extensions/slack/src/monitor/config.runtime.ts
index ac6a07bad80f..f5dfd983c189 100644
--- a/extensions/slack/src/monitor/config.runtime.ts
+++ b/extensions/slack/src/monitor/config.runtime.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports config behavior.
 export { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
 export { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
 export {
diff --git a/extensions/slack/src/monitor/context.test.ts b/extensions/slack/src/monitor/context.test.ts
index 9be088a08517..5fe35a476038 100644
--- a/extensions/slack/src/monitor/context.test.ts
+++ b/extensions/slack/src/monitor/context.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover context plugin behavior.
 import type { App } from "@slack/bolt";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/context.ts b/extensions/slack/src/monitor/context.ts
index cbc078216f31..f2717f542bfe 100644
--- a/extensions/slack/src/monitor/context.ts
+++ b/extensions/slack/src/monitor/context.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements context behavior.
 import type { App } from "@slack/bolt";
 import { resolveDefaultAgentId } from "openclaw/plugin-sdk/agent-runtime";
 import { formatAllowlistMatchMeta } from "openclaw/plugin-sdk/allow-from";
diff --git a/extensions/slack/src/monitor/conversation.runtime.ts b/extensions/slack/src/monitor/conversation.runtime.ts
index 323679a51e88..d1a563519887 100644
--- a/extensions/slack/src/monitor/conversation.runtime.ts
+++ b/extensions/slack/src/monitor/conversation.runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements conversation behavior.
 export {
   buildPluginBindingResolvedText,
   parsePluginBindingApprovalCustomId,
diff --git a/extensions/slack/src/monitor/dm-auth.test.ts b/extensions/slack/src/monitor/dm-auth.test.ts
index 3987b974f048..8b8568b801d3 100644
--- a/extensions/slack/src/monitor/dm-auth.test.ts
+++ b/extensions/slack/src/monitor/dm-auth.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover dm auth plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { SlackMonitorContext } from "./context.js";
 import { authorizeSlackDirectMessage } from "./dm-auth.js";
diff --git a/extensions/slack/src/monitor/dm-auth.ts b/extensions/slack/src/monitor/dm-auth.ts
index 2665b149cb11..c2092ed3d45d 100644
--- a/extensions/slack/src/monitor/dm-auth.ts
+++ b/extensions/slack/src/monitor/dm-auth.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements dm auth behavior.
 import { formatAllowlistMatchMeta } from "openclaw/plugin-sdk/allow-from";
 import { createChannelPairingChallengeIssuer } from "openclaw/plugin-sdk/channel-pairing";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/slack/src/monitor/events.ts b/extensions/slack/src/monitor/events.ts
index 7ef47107824c..0695dda84c56 100644
--- a/extensions/slack/src/monitor/events.ts
+++ b/extensions/slack/src/monitor/events.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements events behavior.
 import type { ResolvedSlackAccount } from "../accounts.js";
 import type { SlackMonitorContext } from "./context.js";
 import { registerSlackAssistantEvents } from "./events/assistant.js";
diff --git a/extensions/slack/src/monitor/events/assistant.test.ts b/extensions/slack/src/monitor/events/assistant.test.ts
index 9d8972d25e4d..a8600e19db2c 100644
--- a/extensions/slack/src/monitor/events/assistant.test.ts
+++ b/extensions/slack/src/monitor/events/assistant.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover assistant plugin behavior.
 import type { App } from "@slack/bolt";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { SlackMonitorContext } from "../context.js";
diff --git a/extensions/slack/src/monitor/events/assistant.ts b/extensions/slack/src/monitor/events/assistant.ts
index e6452716aefe..3755790cbd77 100644
--- a/extensions/slack/src/monitor/events/assistant.ts
+++ b/extensions/slack/src/monitor/events/assistant.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements assistant behavior.
 import type { Block, KnownBlock } from "@slack/web-api";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { danger, logVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/events/channels.test.ts b/extensions/slack/src/monitor/events/channels.test.ts
index 9028120369c7..bba22fe1c9ec 100644
--- a/extensions/slack/src/monitor/events/channels.test.ts
+++ b/extensions/slack/src/monitor/events/channels.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover channels plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const enqueueSystemEventMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/slack/src/monitor/events/channels.ts b/extensions/slack/src/monitor/events/channels.ts
index 7b2165d0db67..aad419a9d932 100644
--- a/extensions/slack/src/monitor/events/channels.ts
+++ b/extensions/slack/src/monitor/events/channels.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements channels behavior.
 import type { SlackEventMiddlewareArgs } from "@slack/bolt";
 import { resolveChannelConfigWrites } from "openclaw/plugin-sdk/channel-config-writes";
 import { mutateConfigFile } from "openclaw/plugin-sdk/config-mutation";
diff --git a/extensions/slack/src/monitor/events/home.test.ts b/extensions/slack/src/monitor/events/home.test.ts
index 6d990ee3763c..2c23ecf928ad 100644
--- a/extensions/slack/src/monitor/events/home.test.ts
+++ b/extensions/slack/src/monitor/events/home.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover home plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 let buildSlackHomeView: typeof import("./home.js").buildSlackHomeView;
diff --git a/extensions/slack/src/monitor/events/home.ts b/extensions/slack/src/monitor/events/home.ts
index b4e911b4ab39..ba7ae6ef2575 100644
--- a/extensions/slack/src/monitor/events/home.ts
+++ b/extensions/slack/src/monitor/events/home.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements home behavior.
 import type { SlackEventMiddlewareArgs } from "@slack/bolt";
 import type { HomeView } from "@slack/types";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/slack/src/monitor/events/interactions.block-actions.ts b/extensions/slack/src/monitor/events/interactions.block-actions.ts
index ea789bf53308..9996def9d8bc 100644
--- a/extensions/slack/src/monitor/events/interactions.block-actions.ts
+++ b/extensions/slack/src/monitor/events/interactions.block-actions.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements interactions.block actions behavior.
 import type { SlackActionMiddlewareArgs } from "@slack/bolt";
 import type { Block, KnownBlock } from "@slack/web-api";
 import { resolveApprovalOverGateway } from "openclaw/plugin-sdk/approval-gateway-runtime";
diff --git a/extensions/slack/src/monitor/events/interactions.modal.ts b/extensions/slack/src/monitor/events/interactions.modal.ts
index c6de6ab71d73..1e718a871d07 100644
--- a/extensions/slack/src/monitor/events/interactions.modal.ts
+++ b/extensions/slack/src/monitor/events/interactions.modal.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements interactions.modal behavior.
 import { enqueueSystemEvent } from "openclaw/plugin-sdk/system-event-runtime";
 import { dispatchSlackPluginInteractiveHandler } from "../../interactive-dispatch.js";
 import { parseSlackModalPrivateMetadata } from "../../modal-metadata.js";
diff --git a/extensions/slack/src/monitor/events/interactions.test.ts b/extensions/slack/src/monitor/events/interactions.test.ts
index 7f8aa14448b6..18ca6f86eab0 100644
--- a/extensions/slack/src/monitor/events/interactions.test.ts
+++ b/extensions/slack/src/monitor/events/interactions.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover interactions plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const enqueueSystemEventMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/slack/src/monitor/events/interactions.ts b/extensions/slack/src/monitor/events/interactions.ts
index e81006e1c43a..85f4f7f87ead 100644
--- a/extensions/slack/src/monitor/events/interactions.ts
+++ b/extensions/slack/src/monitor/events/interactions.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements interactions behavior.
 import { truncateSlackText } from "../../truncate.js";
 import type { SlackMonitorContext } from "../context.js";
 import { registerSlackBlockActionHandler, summarizeAction } from "./interactions.block-actions.js";
diff --git a/extensions/slack/src/monitor/events/members.test.ts b/extensions/slack/src/monitor/events/members.test.ts
index d623b7b1b112..e356b59fd135 100644
--- a/extensions/slack/src/monitor/events/members.test.ts
+++ b/extensions/slack/src/monitor/events/members.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover members plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const memberMocks = vi.hoisted(() => ({
diff --git a/extensions/slack/src/monitor/events/members.ts b/extensions/slack/src/monitor/events/members.ts
index 012e84cec4c1..1152c256b6e6 100644
--- a/extensions/slack/src/monitor/events/members.ts
+++ b/extensions/slack/src/monitor/events/members.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements members behavior.
 import type { SlackEventMiddlewareArgs } from "@slack/bolt";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { danger } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/events/message-subtype-handlers.test.ts b/extensions/slack/src/monitor/events/message-subtype-handlers.test.ts
index 376c3bde6e89..afacf8818f30 100644
--- a/extensions/slack/src/monitor/events/message-subtype-handlers.test.ts
+++ b/extensions/slack/src/monitor/events/message-subtype-handlers.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover message subtype handlers plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { SlackMessageEvent } from "../../types.js";
 import { resolveSlackMessageSubtypeHandler } from "./message-subtype-handlers.js";
diff --git a/extensions/slack/src/monitor/events/message-subtype-handlers.ts b/extensions/slack/src/monitor/events/message-subtype-handlers.ts
index cadf7b84faff..74fcd0af6253 100644
--- a/extensions/slack/src/monitor/events/message-subtype-handlers.ts
+++ b/extensions/slack/src/monitor/events/message-subtype-handlers.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements message subtype handlers behavior.
 import type { SlackMessageEvent } from "../../types.js";
 import type { SlackMessageChangedEvent, SlackMessageDeletedEvent } from "../types.js";
 
diff --git a/extensions/slack/src/monitor/events/messages.test.ts b/extensions/slack/src/monitor/events/messages.test.ts
index 517da6533f7b..3ee99e654bab 100644
--- a/extensions/slack/src/monitor/events/messages.test.ts
+++ b/extensions/slack/src/monitor/events/messages.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover messages plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   createSlackSystemEventTestHarness,
diff --git a/extensions/slack/src/monitor/events/messages.ts b/extensions/slack/src/monitor/events/messages.ts
index 27559610dae0..2e21d1887c00 100644
--- a/extensions/slack/src/monitor/events/messages.ts
+++ b/extensions/slack/src/monitor/events/messages.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements messages behavior.
 import type { SlackEventMiddlewareArgs } from "@slack/bolt";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { danger, logVerbose, shouldLogVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/events/modal-input-summary.ts b/extensions/slack/src/monitor/events/modal-input-summary.ts
index 717d27188014..e8c3f8aba660 100644
--- a/extensions/slack/src/monitor/events/modal-input-summary.ts
+++ b/extensions/slack/src/monitor/events/modal-input-summary.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements modal input summary behavior.
 export type ModalInputSummary = {
   blockId: string;
   actionId: string;
diff --git a/extensions/slack/src/monitor/events/pins.test.ts b/extensions/slack/src/monitor/events/pins.test.ts
index 2fd44558fa2b..72627270120c 100644
--- a/extensions/slack/src/monitor/events/pins.test.ts
+++ b/extensions/slack/src/monitor/events/pins.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover pins plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const pinEnqueueMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/slack/src/monitor/events/pins.ts b/extensions/slack/src/monitor/events/pins.ts
index 65dacdcc24d4..915849c5dbba 100644
--- a/extensions/slack/src/monitor/events/pins.ts
+++ b/extensions/slack/src/monitor/events/pins.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements pins behavior.
 import type { SlackEventMiddlewareArgs } from "@slack/bolt";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { danger } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/events/reactions.test.ts b/extensions/slack/src/monitor/events/reactions.test.ts
index c15296fd4de8..80e40200bc34 100644
--- a/extensions/slack/src/monitor/events/reactions.test.ts
+++ b/extensions/slack/src/monitor/events/reactions.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover reactions plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const reactionQueueMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/slack/src/monitor/events/reactions.ts b/extensions/slack/src/monitor/events/reactions.ts
index 9405f09d58ac..643858eb911a 100644
--- a/extensions/slack/src/monitor/events/reactions.ts
+++ b/extensions/slack/src/monitor/events/reactions.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements reactions behavior.
 import type { SlackEventMiddlewareArgs } from "@slack/bolt";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { danger } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/events/system-event-context.ts b/extensions/slack/src/monitor/events/system-event-context.ts
index a43e104bf7e5..75994a01a09f 100644
--- a/extensions/slack/src/monitor/events/system-event-context.ts
+++ b/extensions/slack/src/monitor/events/system-event-context.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements system event context behavior.
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
 import { authorizeSlackSystemEventSender } from "../auth.js";
 import { resolveSlackChannelLabel } from "../channel-config.js";
diff --git a/extensions/slack/src/monitor/events/system-event-test-harness.ts b/extensions/slack/src/monitor/events/system-event-test-harness.ts
index bff3d0b51350..bd949bf8d98a 100644
--- a/extensions/slack/src/monitor/events/system-event-test-harness.ts
+++ b/extensions/slack/src/monitor/events/system-event-test-harness.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements system event test harness behavior.
 import type { SlackMonitorContext } from "../context.js";
 
 export type SlackSystemEventHandler = (args: {
diff --git a/extensions/slack/src/monitor/external-arg-menu-store.test.ts b/extensions/slack/src/monitor/external-arg-menu-store.test.ts
index 4cc4678679d1..fc73904a57eb 100644
--- a/extensions/slack/src/monitor/external-arg-menu-store.test.ts
+++ b/extensions/slack/src/monitor/external-arg-menu-store.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover external arg menu store plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   createSlackExternalArgMenuStore,
diff --git a/extensions/slack/src/monitor/external-arg-menu-store.ts b/extensions/slack/src/monitor/external-arg-menu-store.ts
index e88e40a9e7fa..040a7669af3e 100644
--- a/extensions/slack/src/monitor/external-arg-menu-store.ts
+++ b/extensions/slack/src/monitor/external-arg-menu-store.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements external arg menu store behavior.
 import {
   asDateTimestampMs,
   resolveExpiresAtMsFromDurationMs,
diff --git a/extensions/slack/src/monitor/inbound-delivery-state.test.ts b/extensions/slack/src/monitor/inbound-delivery-state.test.ts
index 276e1c036350..b27488f8456f 100644
--- a/extensions/slack/src/monitor/inbound-delivery-state.test.ts
+++ b/extensions/slack/src/monitor/inbound-delivery-state.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover inbound delivery state plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { clearSlackRuntime, setSlackRuntime } from "../runtime.js";
 import type { SlackMessageEvent } from "../types.js";
diff --git a/extensions/slack/src/monitor/inbound-delivery-state.ts b/extensions/slack/src/monitor/inbound-delivery-state.ts
index 638d1636f441..c8470cfbe95c 100644
--- a/extensions/slack/src/monitor/inbound-delivery-state.ts
+++ b/extensions/slack/src/monitor/inbound-delivery-state.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements inbound delivery state behavior.
 import { resolveGlobalDedupeCache } from "openclaw/plugin-sdk/dedupe-runtime";
 import { getOptionalSlackRuntime } from "../runtime.js";
 import type { SlackMessageEvent } from "../types.js";
diff --git a/extensions/slack/src/monitor/media-types.ts b/extensions/slack/src/monitor/media-types.ts
index b5bb17ff7b45..1ee8d9e05786 100644
--- a/extensions/slack/src/monitor/media-types.ts
+++ b/extensions/slack/src/monitor/media-types.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements media types behavior.
 export type SlackMediaResult = {
   path: string;
   contentType?: string;
diff --git a/extensions/slack/src/monitor/media.runtime.ts b/extensions/slack/src/monitor/media.runtime.ts
index ca85bd61162a..141d8a1eeb7e 100644
--- a/extensions/slack/src/monitor/media.runtime.ts
+++ b/extensions/slack/src/monitor/media.runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements media behavior.
 export { fetchWithRuntimeDispatcher } from "openclaw/plugin-sdk/runtime-fetch";
 export type { FetchLike, SavedMedia } from "openclaw/plugin-sdk/media-runtime";
 export {
diff --git a/extensions/slack/src/monitor/media.test.ts b/extensions/slack/src/monitor/media.test.ts
index 8b45ff7efea6..b8dcae3c59c3 100644
--- a/extensions/slack/src/monitor/media.test.ts
+++ b/extensions/slack/src/monitor/media.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover media plugin behavior.
 import type { WebClient } from "@slack/web-api";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/slack/src/monitor/media.ts b/extensions/slack/src/monitor/media.ts
index 796c9bfae75b..9cdd0e7435a0 100644
--- a/extensions/slack/src/monitor/media.ts
+++ b/extensions/slack/src/monitor/media.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements media behavior.
 import fs from "node:fs/promises";
 import type { WebClient as SlackWebClient } from "@slack/web-api";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/slack/src/monitor/message-handler.app-mention-race.test.ts b/extensions/slack/src/monitor/message-handler.app-mention-race.test.ts
index a499cda97a24..2cb9c14906d9 100644
--- a/extensions/slack/src/monitor/message-handler.app-mention-race.test.ts
+++ b/extensions/slack/src/monitor/message-handler.app-mention-race.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover message handler.app mention race plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const prepareSlackMessageMock =
diff --git a/extensions/slack/src/monitor/message-handler.debounce-key.test.ts b/extensions/slack/src/monitor/message-handler.debounce-key.test.ts
index db64b5b0d165..b9124164ccf4 100644
--- a/extensions/slack/src/monitor/message-handler.debounce-key.test.ts
+++ b/extensions/slack/src/monitor/message-handler.debounce-key.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover message handlerebounce key plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { SlackMessageEvent } from "../types.js";
 import { buildSlackDebounceKey } from "./message-handler/debounce-key.js";
diff --git a/extensions/slack/src/monitor/message-handler.test.ts b/extensions/slack/src/monitor/message-handler.test.ts
index 253ba2ece956..55d9f450436e 100644
--- a/extensions/slack/src/monitor/message-handler.test.ts
+++ b/extensions/slack/src/monitor/message-handler.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover message handler plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const enqueueMock = vi.fn(async (_entry: unknown) => {});
diff --git a/extensions/slack/src/monitor/message-handler.ts b/extensions/slack/src/monitor/message-handler.ts
index b43413eb3d8b..14aa148f4449 100644
--- a/extensions/slack/src/monitor/message-handler.ts
+++ b/extensions/slack/src/monitor/message-handler.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements message handler behavior.
 import {
   createChannelInboundDebouncer,
   shouldDebounceTextInbound,
diff --git a/extensions/slack/src/monitor/message-handler/debounce-key.ts b/extensions/slack/src/monitor/message-handler/debounce-key.ts
index e7730fecab9a..87eeac06f2a3 100644
--- a/extensions/slack/src/monitor/message-handler/debounce-key.ts
+++ b/extensions/slack/src/monitor/message-handler/debounce-key.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements debounce key behavior.
 import type { SlackMessageEvent } from "../../types.js";
 
 function resolveSlackSenderId(message: SlackMessageEvent): string | null {
diff --git a/extensions/slack/src/monitor/message-handler/dispatch.preview-fallback.test.ts b/extensions/slack/src/monitor/message-handler/dispatch.preview-fallback.test.ts
index 097275d6975e..f16322720dc8 100644
--- a/extensions/slack/src/monitor/message-handler/dispatch.preview-fallback.test.ts
+++ b/extensions/slack/src/monitor/message-handler/dispatch.preview-fallback.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover dispatch.preview fallback plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const FINAL_REPLY_TEXT = "final answer";
diff --git a/extensions/slack/src/monitor/message-handler/dispatch.streaming.test.ts b/extensions/slack/src/monitor/message-handler/dispatch.streaming.test.ts
index c4ca0be6e8b6..dcdae5ce59e1 100644
--- a/extensions/slack/src/monitor/message-handler/dispatch.streaming.test.ts
+++ b/extensions/slack/src/monitor/message-handler/dispatch.streaming.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover dispatch.streaming plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   createSlackEventDeliveryTracker,
diff --git a/extensions/slack/src/monitor/message-handler/dispatch.ts b/extensions/slack/src/monitor/message-handler/dispatch.ts
index 12bf42eaa400..ab0ceb7780cc 100644
--- a/extensions/slack/src/monitor/message-handler/dispatch.ts
+++ b/extensions/slack/src/monitor/message-handler/dispatch.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements dispatch behavior.
 import { resolveHumanDelayConfig } from "openclaw/plugin-sdk/agent-runtime";
 import {
   createStatusReactionController,
diff --git a/extensions/slack/src/monitor/message-handler/pipeline.runtime.ts b/extensions/slack/src/monitor/message-handler/pipeline.runtime.ts
index afc3b70ab1cb..c79eda825906 100644
--- a/extensions/slack/src/monitor/message-handler/pipeline.runtime.ts
+++ b/extensions/slack/src/monitor/message-handler/pipeline.runtime.ts
@@ -1,2 +1,3 @@
+// Slack plugin module implements pipeline behavior.
 export { dispatchPreparedSlackMessage } from "./dispatch.js";
 export { prepareSlackMessage } from "./prepare.js";
diff --git a/extensions/slack/src/monitor/message-handler/prepare-content.ts b/extensions/slack/src/monitor/message-handler/prepare-content.ts
index 0e5c05456917..3ce8e6b7f303 100644
--- a/extensions/slack/src/monitor/message-handler/prepare-content.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare-content.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements prepare content behavior.
 import type { WebClient as SlackWebClient } from "@slack/web-api";
 import { runTasksWithConcurrency } from "openclaw/plugin-sdk/concurrency-runtime";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/message-handler/prepare-dm-history.ts b/extensions/slack/src/monitor/message-handler/prepare-dm-history.ts
index 9603a801fbae..dfd33ace5cbd 100644
--- a/extensions/slack/src/monitor/message-handler/prepare-dm-history.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare-dm-history.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements prepare dm history behavior.
 import { formatInboundEnvelope } from "openclaw/plugin-sdk/channel-inbound";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/message-handler/prepare-routing.ts b/extensions/slack/src/monitor/message-handler/prepare-routing.ts
index 35790b8686c2..e5b573af9ce9 100644
--- a/extensions/slack/src/monitor/message-handler/prepare-routing.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare-routing.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements prepare routing behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   resolveConfiguredBindingRoute,
diff --git a/extensions/slack/src/monitor/message-handler/prepare-thread-context-root.test.ts b/extensions/slack/src/monitor/message-handler/prepare-thread-context-root.test.ts
index 6902b868aad7..d15c298d3c8e 100644
--- a/extensions/slack/src/monitor/message-handler/prepare-thread-context-root.test.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare-thread-context-root.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover prepare thread context root plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   applySlackThreadHistoryFilterPolicy,
diff --git a/extensions/slack/src/monitor/message-handler/prepare-thread-context-root.ts b/extensions/slack/src/monitor/message-handler/prepare-thread-context-root.ts
index 35240fc5e729..81fe38c2188a 100644
--- a/extensions/slack/src/monitor/message-handler/prepare-thread-context-root.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare-thread-context-root.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements prepare thread context root behavior.
 export type SlackBotAuthorIdentity = {
   botUserId?: string;
   botId?: string;
diff --git a/extensions/slack/src/monitor/message-handler/prepare-thread-context.test.ts b/extensions/slack/src/monitor/message-handler/prepare-thread-context.test.ts
index ae3abb16b7f5..bf5190f2050a 100644
--- a/extensions/slack/src/monitor/message-handler/prepare-thread-context.test.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare-thread-context.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover prepare thread context plugin behavior.
 import type { App } from "@slack/bolt";
 import { resolveEnvelopeFormatOptions } from "openclaw/plugin-sdk/channel-inbound";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/slack/src/monitor/message-handler/prepare-thread-context.ts b/extensions/slack/src/monitor/message-handler/prepare-thread-context.ts
index a25941be1996..fe175181216d 100644
--- a/extensions/slack/src/monitor/message-handler/prepare-thread-context.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare-thread-context.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements prepare thread context behavior.
 import { formatInboundEnvelope } from "openclaw/plugin-sdk/channel-inbound";
 import { runTasksWithConcurrency } from "openclaw/plugin-sdk/concurrency-runtime";
 import type { ContextVisibilityMode } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/slack/src/monitor/message-handler/prepare.test-helpers.ts b/extensions/slack/src/monitor/message-handler/prepare.test-helpers.ts
index 8a1e1f2c12ba..5c4cd5fc0f98 100644
--- a/extensions/slack/src/monitor/message-handler/prepare.test-helpers.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare.test-helpers.ts
@@ -1,3 +1,4 @@
+// Slack helper module supports prepare helpers behavior.
 import fs from "node:fs";
 import path from "node:path";
 import type { App } from "@slack/bolt";
diff --git a/extensions/slack/src/monitor/message-handler/prepare.test.ts b/extensions/slack/src/monitor/message-handler/prepare.test.ts
index 734b06f627d3..306271f9267b 100644
--- a/extensions/slack/src/monitor/message-handler/prepare.test.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover prepare plugin behavior.
 import fs from "node:fs";
 import type { App } from "@slack/bolt";
 import { expectChannelInboundContextContract as expectInboundContextContract } from "openclaw/plugin-sdk/channel-contract-testing";
diff --git a/extensions/slack/src/monitor/message-handler/prepare.thread-session-key.test.ts b/extensions/slack/src/monitor/message-handler/prepare.thread-session-key.test.ts
index 063888eff74d..709f7c9d35ae 100644
--- a/extensions/slack/src/monitor/message-handler/prepare.thread-session-key.test.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare.thread-session-key.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover prepare.thread session key plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   registerSessionBindingAdapter,
diff --git a/extensions/slack/src/monitor/message-handler/prepare.ts b/extensions/slack/src/monitor/message-handler/prepare.ts
index 36a085da78cc..2c4edbd256d5 100644
--- a/extensions/slack/src/monitor/message-handler/prepare.ts
+++ b/extensions/slack/src/monitor/message-handler/prepare.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements prepare behavior.
 import {
   resolveAckReaction,
   shouldAckReaction as shouldAckReactionGate,
diff --git a/extensions/slack/src/monitor/message-handler/preview-finalize.test.ts b/extensions/slack/src/monitor/message-handler/preview-finalize.test.ts
index f8b9b2bb5ad0..25d6a306af50 100644
--- a/extensions/slack/src/monitor/message-handler/preview-finalize.test.ts
+++ b/extensions/slack/src/monitor/message-handler/preview-finalize.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover preview finalize plugin behavior.
 import type { WebClient } from "@slack/web-api";
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/slack/src/monitor/message-handler/preview-finalize.ts b/extensions/slack/src/monitor/message-handler/preview-finalize.ts
index df522cde5ade..b4bdd0df61cc 100644
--- a/extensions/slack/src/monitor/message-handler/preview-finalize.ts
+++ b/extensions/slack/src/monitor/message-handler/preview-finalize.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements preview finalize behavior.
 import type { Block, KnownBlock, WebClient } from "@slack/web-api";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
 import { editSlackMessage } from "../../actions.js";
diff --git a/extensions/slack/src/monitor/message-handler/subteam-mentions.test.ts b/extensions/slack/src/monitor/message-handler/subteam-mentions.test.ts
index 68c70f8640ab..a68667c5f3a5 100644
--- a/extensions/slack/src/monitor/message-handler/subteam-mentions.test.ts
+++ b/extensions/slack/src/monitor/message-handler/subteam-mentions.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover subteam mentions plugin behavior.
 import type { WebClient } from "@slack/web-api";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/slack/src/monitor/message-handler/subteam-mentions.ts b/extensions/slack/src/monitor/message-handler/subteam-mentions.ts
index 43c5c7c7b61f..318f312c131a 100644
--- a/extensions/slack/src/monitor/message-handler/subteam-mentions.ts
+++ b/extensions/slack/src/monitor/message-handler/subteam-mentions.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements subteam mentions behavior.
 import type { WebClient } from "@slack/web-api";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import {
diff --git a/extensions/slack/src/monitor/message-handler/timestamp.test.ts b/extensions/slack/src/monitor/message-handler/timestamp.test.ts
index c9acce426215..f06f0749ebe4 100644
--- a/extensions/slack/src/monitor/message-handler/timestamp.test.ts
+++ b/extensions/slack/src/monitor/message-handler/timestamp.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover timestamp plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveSlackTimestampMs } from "./timestamp.js";
 
diff --git a/extensions/slack/src/monitor/message-handler/timestamp.ts b/extensions/slack/src/monitor/message-handler/timestamp.ts
index 01253146e835..4131aa1a8903 100644
--- a/extensions/slack/src/monitor/message-handler/timestamp.ts
+++ b/extensions/slack/src/monitor/message-handler/timestamp.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements timestamp behavior.
 import { asFiniteNumberInRange, parseStrictFiniteNumber } from "openclaw/plugin-sdk/number-runtime";
 
 const SLACK_TIMESTAMP_RE = /^\d+(?:\.\d+)?$/;
diff --git a/extensions/slack/src/monitor/message-handler/types.ts b/extensions/slack/src/monitor/message-handler/types.ts
index 53fcc2a45fdf..b9a397f04e89 100644
--- a/extensions/slack/src/monitor/message-handler/types.ts
+++ b/extensions/slack/src/monitor/message-handler/types.ts
@@ -1,3 +1,4 @@
+// Slack type declarations define plugin contracts.
 import type { MessageMetadata } from "@slack/types";
 import type { HistoryEntry } from "openclaw/plugin-sdk/reply-history";
 import type { FinalizedMsgContext } from "openclaw/plugin-sdk/reply-runtime";
diff --git a/extensions/slack/src/monitor/monitor.media.test.ts b/extensions/slack/src/monitor/monitor.media.test.ts
index 86b6669d3af6..94fab754a786 100644
--- a/extensions/slack/src/monitor/monitor.media.test.ts
+++ b/extensions/slack/src/monitor/monitor.media.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover monitor.media plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { resetSlackThreadStarterCacheForTest, resolveSlackThreadStarter } from "./thread.js";
 
diff --git a/extensions/slack/src/monitor/monitor.test.ts b/extensions/slack/src/monitor/monitor.test.ts
index f84c1a124922..5b4b730da824 100644
--- a/extensions/slack/src/monitor/monitor.test.ts
+++ b/extensions/slack/src/monitor/monitor.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover monitor plugin behavior.
 import type { App } from "@slack/bolt";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/monitor.thread-resolution.test.ts b/extensions/slack/src/monitor/monitor.thread-resolution.test.ts
index 9b407d58a932..1bc1ddbfd688 100644
--- a/extensions/slack/src/monitor/monitor.thread-resolution.test.ts
+++ b/extensions/slack/src/monitor/monitor.thread-resolution.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover monitor.thread resolution plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { SlackMessageEvent } from "../types.js";
 import { createSlackThreadTsResolver } from "./thread-resolution.js";
diff --git a/extensions/slack/src/monitor/mrkdwn.ts b/extensions/slack/src/monitor/mrkdwn.ts
index aea752da7091..ba03b1c20d40 100644
--- a/extensions/slack/src/monitor/mrkdwn.ts
+++ b/extensions/slack/src/monitor/mrkdwn.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements mrkdwn behavior.
 export function escapeSlackMrkdwn(value: string): string {
   return value
     .replaceAll("\\", "\\\\")
diff --git a/extensions/slack/src/monitor/policy.ts b/extensions/slack/src/monitor/policy.ts
index 7db20143682e..2c148ba5fc86 100644
--- a/extensions/slack/src/monitor/policy.ts
+++ b/extensions/slack/src/monitor/policy.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements policy behavior.
 export function isSlackChannelAllowedByPolicy(params: {
   groupPolicy: "open" | "disabled" | "allowlist";
   channelAllowlistConfigured: boolean;
diff --git a/extensions/slack/src/monitor/provider-support.ts b/extensions/slack/src/monitor/provider-support.ts
index 4ba2ce0bc992..8ad6e10f53b7 100644
--- a/extensions/slack/src/monitor/provider-support.ts
+++ b/extensions/slack/src/monitor/provider-support.ts
@@ -1,3 +1,4 @@
+// Slack provider module implements model/runtime integration.
 import { asOptionalRecord as asRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { SlackChannelResolution } from "../resolve-channels.js";
 import type { SlackUserResolution } from "../resolve-users.js";
diff --git a/extensions/slack/src/monitor/provider.allowlist.test.ts b/extensions/slack/src/monitor/provider.allowlist.test.ts
index 837b7bfe9620..be84e42865b6 100644
--- a/extensions/slack/src/monitor/provider.allowlist.test.ts
+++ b/extensions/slack/src/monitor/provider.allowlist.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover provider.allowlist plugin behavior.
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 import type { ChannelRuntimeSurface } from "openclaw/plugin-sdk/channel-contract";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/slack/src/monitor/provider.auth-errors.test.ts b/extensions/slack/src/monitor/provider.auth-errors.test.ts
index 9a89dbb017fc..8a541c3b357e 100644
--- a/extensions/slack/src/monitor/provider.auth-errors.test.ts
+++ b/extensions/slack/src/monitor/provider.auth-errors.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover provider.auth errors plugin behavior.
 import { describe, it, expect } from "vitest";
 import { isNonRecoverableSlackAuthError } from "./reconnect-policy.js";
 
diff --git a/extensions/slack/src/monitor/provider.interop.test.ts b/extensions/slack/src/monitor/provider.interop.test.ts
index e76526ecafa3..64d62ee8c4c0 100644
--- a/extensions/slack/src/monitor/provider.interop.test.ts
+++ b/extensions/slack/src/monitor/provider.interop.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover provider.interop plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   createSlackBoltApp,
diff --git a/extensions/slack/src/monitor/provider.reconnect.test.ts b/extensions/slack/src/monitor/provider.reconnect.test.ts
index 7f2895ade511..3f8c6f84dc48 100644
--- a/extensions/slack/src/monitor/provider.reconnect.test.ts
+++ b/extensions/slack/src/monitor/provider.reconnect.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover provider.reconnect plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   gracefulStopSlackApp,
diff --git a/extensions/slack/src/monitor/provider.ts b/extensions/slack/src/monitor/provider.ts
index 6a45c4fdef6a..be8de17e333d 100644
--- a/extensions/slack/src/monitor/provider.ts
+++ b/extensions/slack/src/monitor/provider.ts
@@ -1,3 +1,4 @@
+// Slack provider module implements model/runtime integration.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import {
   addAllowlistUserEntriesFromConfigEntry,
diff --git a/extensions/slack/src/monitor/reconnect-policy.ts b/extensions/slack/src/monitor/reconnect-policy.ts
index 0a1b603f8c9e..521cf8a189bd 100644
--- a/extensions/slack/src/monitor/reconnect-policy.ts
+++ b/extensions/slack/src/monitor/reconnect-policy.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements reconnect policy behavior.
 import { formatSlackError } from "../errors.js";
 
 const SLACK_AUTH_ERROR_RE =
diff --git a/extensions/slack/src/monitor/replies.test.ts b/extensions/slack/src/monitor/replies.test.ts
index 2f2469ed2c39..37ddeeff3285 100644
--- a/extensions/slack/src/monitor/replies.test.ts
+++ b/extensions/slack/src/monitor/replies.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover replies plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const sendMock = vi.fn();
diff --git a/extensions/slack/src/monitor/replies.ts b/extensions/slack/src/monitor/replies.ts
index f6231ffcb34a..f8c5d1f8e029 100644
--- a/extensions/slack/src/monitor/replies.ts
+++ b/extensions/slack/src/monitor/replies.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements replies behavior.
 import type { MessageMetadata } from "@slack/types";
 import type { MarkdownTableMode, OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/slack/src/monitor/reply.runtime.ts b/extensions/slack/src/monitor/reply.runtime.ts
index 8c124ee1e662..c43e826743a8 100644
--- a/extensions/slack/src/monitor/reply.runtime.ts
+++ b/extensions/slack/src/monitor/reply.runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements reply behavior.
 export {
   createReplyDispatcherWithTyping,
   dispatchReplyWithBufferedBlockDispatcher,
diff --git a/extensions/slack/src/monitor/room-context.test.ts b/extensions/slack/src/monitor/room-context.test.ts
index 61121fdd1635..8d2a0facb6c7 100644
--- a/extensions/slack/src/monitor/room-context.test.ts
+++ b/extensions/slack/src/monitor/room-context.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover room context plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveSlackRoomContextHints } from "./room-context.js";
 
diff --git a/extensions/slack/src/monitor/room-context.ts b/extensions/slack/src/monitor/room-context.ts
index bcae8f4e637f..9b618fd5658c 100644
--- a/extensions/slack/src/monitor/room-context.ts
+++ b/extensions/slack/src/monitor/room-context.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements room context behavior.
 import { buildUntrustedChannelMetadata } from "openclaw/plugin-sdk/security-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/slack/src/monitor/send.runtime.ts b/extensions/slack/src/monitor/send.runtime.ts
index 783d4418c614..a44ed6d2f3e1 100644
--- a/extensions/slack/src/monitor/send.runtime.ts
+++ b/extensions/slack/src/monitor/send.runtime.ts
@@ -1 +1,2 @@
+// Slack plugin module implements send behavior.
 export { sendMessageSlack, type SlackSendIdentity } from "../send.js";
diff --git a/extensions/slack/src/monitor/slash-commands.runtime.ts b/extensions/slack/src/monitor/slash-commands.runtime.ts
index 35dc26e88e4a..760e5838eed7 100644
--- a/extensions/slack/src/monitor/slash-commands.runtime.ts
+++ b/extensions/slack/src/monitor/slash-commands.runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements slash commands behavior.
 import {
   buildCommandTextFromArgs as buildCommandTextFromArgsImpl,
   findCommandByNativeName as findCommandByNativeNameImpl,
diff --git a/extensions/slack/src/monitor/slash-dispatch.runtime.ts b/extensions/slack/src/monitor/slash-dispatch.runtime.ts
index cd55a592d041..aa65b87f0397 100644
--- a/extensions/slack/src/monitor/slash-dispatch.runtime.ts
+++ b/extensions/slack/src/monitor/slash-dispatch.runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements slash dispatch behavior.
 import {
   recordInboundSessionMetaSafe as recordInboundSessionMetaSafeImpl,
   resolveConversationLabel as resolveConversationLabelImpl,
diff --git a/extensions/slack/src/monitor/slash-plugin-commands.runtime.ts b/extensions/slack/src/monitor/slash-plugin-commands.runtime.ts
index a80bfdd1180d..4fb3f4663201 100644
--- a/extensions/slack/src/monitor/slash-plugin-commands.runtime.ts
+++ b/extensions/slack/src/monitor/slash-plugin-commands.runtime.ts
@@ -1 +1,2 @@
+// Slack plugin module implements slash plugin commands behavior.
 export { listProviderPluginCommandSpecs } from "openclaw/plugin-sdk/command-auth-native";
diff --git a/extensions/slack/src/monitor/slash-skill-commands.runtime.ts b/extensions/slack/src/monitor/slash-skill-commands.runtime.ts
index e59eb00f80ca..c1169b5c2eac 100644
--- a/extensions/slack/src/monitor/slash-skill-commands.runtime.ts
+++ b/extensions/slack/src/monitor/slash-skill-commands.runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements slash skill commands behavior.
 import { listSkillCommandsForAgents as listSkillCommandsForAgentsImpl } from "openclaw/plugin-sdk/command-auth-native";
 
 type ListSkillCommandsForAgents =
diff --git a/extensions/slack/src/monitor/slash.test-harness.ts b/extensions/slack/src/monitor/slash.test-harness.ts
index 25560e6939c1..9ca3c4b1ad3a 100644
--- a/extensions/slack/src/monitor/slash.test-harness.ts
+++ b/extensions/slack/src/monitor/slash.test-harness.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements slash harness behavior.
 import { vi } from "vitest";
 
 type AsyncMock = ReturnType<typeof vi.fn<(...args: unknown[]) => Promise<unknown>>>;
diff --git a/extensions/slack/src/monitor/slash.test.ts b/extensions/slack/src/monitor/slash.test.ts
index 7639dad765a6..d73392764c30 100644
--- a/extensions/slack/src/monitor/slash.test.ts
+++ b/extensions/slack/src/monitor/slash.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover slash plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { getSlackSlashMocks, resetSlackSlashMocks } from "./slash.test-harness.js";
 
diff --git a/extensions/slack/src/monitor/slash.ts b/extensions/slack/src/monitor/slash.ts
index 2897db915d79..d69ab1846285 100644
--- a/extensions/slack/src/monitor/slash.ts
+++ b/extensions/slack/src/monitor/slash.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements slash behavior.
 import type { SlackActionMiddlewareArgs, SlackCommandMiddlewareArgs } from "@slack/bolt";
 import { resolveDefaultModelForAgent } from "openclaw/plugin-sdk/agent-runtime";
 import { createChannelMessageReplyPipeline } from "openclaw/plugin-sdk/channel-outbound";
diff --git a/extensions/slack/src/monitor/thread-resolution.ts b/extensions/slack/src/monitor/thread-resolution.ts
index f9ac6c1ede5e..e922c07831f3 100644
--- a/extensions/slack/src/monitor/thread-resolution.ts
+++ b/extensions/slack/src/monitor/thread-resolution.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements thread resolution behavior.
 import type { WebClient as SlackWebClient } from "@slack/web-api";
 import { pruneMapToMaxSize } from "openclaw/plugin-sdk/collection-runtime";
 import {
diff --git a/extensions/slack/src/monitor/thread.runtime.ts b/extensions/slack/src/monitor/thread.runtime.ts
index a557af564d3f..32b1adc3a034 100644
--- a/extensions/slack/src/monitor/thread.runtime.ts
+++ b/extensions/slack/src/monitor/thread.runtime.ts
@@ -1 +1,2 @@
+// Slack plugin module implements thread behavior.
 export { logVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/monitor/thread.ts b/extensions/slack/src/monitor/thread.ts
index 794d41cd3d69..d75f722d46c7 100644
--- a/extensions/slack/src/monitor/thread.ts
+++ b/extensions/slack/src/monitor/thread.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements thread behavior.
 import type { WebClient as SlackWebClient } from "@slack/web-api";
 import { pruneMapToMaxSize } from "openclaw/plugin-sdk/collection-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/slack/src/monitor/types.ts b/extensions/slack/src/monitor/types.ts
index c6d880f73fd2..74dda3f17104 100644
--- a/extensions/slack/src/monitor/types.ts
+++ b/extensions/slack/src/monitor/types.ts
@@ -1,3 +1,4 @@
+// Slack type declarations define plugin contracts.
 import type { ChannelRuntimeSurface } from "openclaw/plugin-sdk/channel-contract";
 import type { OpenClawConfig, SlackSlashCommandConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/slack/src/outbound-adapter.test.ts b/extensions/slack/src/outbound-adapter.test.ts
index fb343ce02717..20bec41a8088 100644
--- a/extensions/slack/src/outbound-adapter.test.ts
+++ b/extensions/slack/src/outbound-adapter.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover outbound adapter plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const sendMessageSlackMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/slack/src/outbound-adapter.ts b/extensions/slack/src/outbound-adapter.ts
index 543769fa23e6..1e3260d901e3 100644
--- a/extensions/slack/src/outbound-adapter.ts
+++ b/extensions/slack/src/outbound-adapter.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements outbound adapter behavior.
 import type { OutboundIdentity } from "openclaw/plugin-sdk/channel-outbound";
 import { resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
 import {
diff --git a/extensions/slack/src/outbound-delivery.test.ts b/extensions/slack/src/outbound-delivery.test.ts
index 1e4dafbac888..bddc3e24cbd1 100644
--- a/extensions/slack/src/outbound-delivery.test.ts
+++ b/extensions/slack/src/outbound-delivery.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover outbound delivery plugin behavior.
 import {
   addTestHook,
   createEmptyPluginRegistry,
diff --git a/extensions/slack/src/outbound-payload.test-harness.ts b/extensions/slack/src/outbound-payload.test-harness.ts
index 8a22a793e698..e46c88d54cea 100644
--- a/extensions/slack/src/outbound-payload.test-harness.ts
+++ b/extensions/slack/src/outbound-payload.test-harness.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements outbound payload harness behavior.
 import { primeChannelOutboundSendMock } from "openclaw/plugin-sdk/channel-contract-testing";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import { vi, type Mock } from "vitest";
diff --git a/extensions/slack/src/outbound-payload.test.ts b/extensions/slack/src/outbound-payload.test.ts
index abe2c1f8152e..792a77971414 100644
--- a/extensions/slack/src/outbound-payload.test.ts
+++ b/extensions/slack/src/outbound-payload.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover outbound payload plugin behavior.
 import { installChannelOutboundPayloadContractSuite } from "openclaw/plugin-sdk/channel-contract-testing";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/slack/src/probe.test.ts b/extensions/slack/src/probe.test.ts
index d632373e9cf8..934e0cf4741d 100644
--- a/extensions/slack/src/probe.test.ts
+++ b/extensions/slack/src/probe.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover probe plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { probeSlack } from "./probe.js";
 
diff --git a/extensions/slack/src/probe.ts b/extensions/slack/src/probe.ts
index 67626853ae76..5ec7b822e283 100644
--- a/extensions/slack/src/probe.ts
+++ b/extensions/slack/src/probe.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements probe behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import { withTimeout } from "openclaw/plugin-sdk/text-utility-runtime";
 import { createSlackWebClient } from "./client.js";
diff --git a/extensions/slack/src/progress-blocks.test.ts b/extensions/slack/src/progress-blocks.test.ts
index c53695a967b6..bcf83246be21 100644
--- a/extensions/slack/src/progress-blocks.test.ts
+++ b/extensions/slack/src/progress-blocks.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover progress blocks plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildSlackProgressDraftBlocks,
diff --git a/extensions/slack/src/progress-blocks.ts b/extensions/slack/src/progress-blocks.ts
index 08df346fb028..6ad35e44f1d8 100644
--- a/extensions/slack/src/progress-blocks.ts
+++ b/extensions/slack/src/progress-blocks.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements progress blocks behavior.
 import { createHash } from "node:crypto";
 import type { AnyChunk } from "@slack/types";
 import type { Block, KnownBlock } from "@slack/web-api";
diff --git a/extensions/slack/src/reply-action-ids.ts b/extensions/slack/src/reply-action-ids.ts
index abd3e572cd8f..75c52ffc322e 100644
--- a/extensions/slack/src/reply-action-ids.ts
+++ b/extensions/slack/src/reply-action-ids.ts
@@ -1,2 +1,3 @@
+// Slack plugin module implements reply action ids behavior.
 export const SLACK_REPLY_BUTTON_ACTION_ID = "openclaw:reply_button";
 export const SLACK_REPLY_SELECT_ACTION_ID = "openclaw:reply_select";
diff --git a/extensions/slack/src/reply-blocks.ts b/extensions/slack/src/reply-blocks.ts
index 6125b13eb9a6..7380bdb464b6 100644
--- a/extensions/slack/src/reply-blocks.ts
+++ b/extensions/slack/src/reply-blocks.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements reply blocks behavior.
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import { parseSlackBlocksInput, SLACK_MAX_BLOCKS } from "./blocks-input.js";
 import {
diff --git a/extensions/slack/src/resolve-allowlist-common.test.ts b/extensions/slack/src/resolve-allowlist-common.test.ts
index b47bcf82d938..7a63af24bda0 100644
--- a/extensions/slack/src/resolve-allowlist-common.test.ts
+++ b/extensions/slack/src/resolve-allowlist-common.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover resolve allowlist common plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   collectSlackCursorItems,
diff --git a/extensions/slack/src/resolve-allowlist-common.ts b/extensions/slack/src/resolve-allowlist-common.ts
index 033087bb0aed..22583fe19461 100644
--- a/extensions/slack/src/resolve-allowlist-common.ts
+++ b/extensions/slack/src/resolve-allowlist-common.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements resolve allowlist common behavior.
 type SlackCursorResponse = {
   response_metadata?: { next_cursor?: string };
 };
diff --git a/extensions/slack/src/resolve-channels.test.ts b/extensions/slack/src/resolve-channels.test.ts
index 17e04d80a7e6..35ef5f937e8c 100644
--- a/extensions/slack/src/resolve-channels.test.ts
+++ b/extensions/slack/src/resolve-channels.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover resolve channels plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { resolveSlackChannelAllowlist } from "./resolve-channels.js";
 
diff --git a/extensions/slack/src/resolve-channels.ts b/extensions/slack/src/resolve-channels.ts
index be0f646de2d7..fb001a85bfbe 100644
--- a/extensions/slack/src/resolve-channels.ts
+++ b/extensions/slack/src/resolve-channels.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements resolve channels behavior.
 import type { WebClient } from "@slack/web-api";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createSlackWebClient } from "./client.js";
diff --git a/extensions/slack/src/resolve-users.test.ts b/extensions/slack/src/resolve-users.test.ts
index d78bc9020082..62d81f7b01fb 100644
--- a/extensions/slack/src/resolve-users.test.ts
+++ b/extensions/slack/src/resolve-users.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover resolve users plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { resolveSlackUserAllowlist } from "./resolve-users.js";
 
diff --git a/extensions/slack/src/resolve-users.ts b/extensions/slack/src/resolve-users.ts
index 218e16a10f3d..6518fba7170f 100644
--- a/extensions/slack/src/resolve-users.ts
+++ b/extensions/slack/src/resolve-users.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements resolve users behavior.
 import type { WebClient } from "@slack/web-api";
 import {
   normalizeLowercaseStringOrEmpty,
diff --git a/extensions/slack/src/runtime-api.ts b/extensions/slack/src/runtime-api.ts
index 5296f1f4e1ba..e522748937fa 100644
--- a/extensions/slack/src/runtime-api.ts
+++ b/extensions/slack/src/runtime-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export {
   buildComputedAccountStatusSnapshot,
   PAIRING_APPROVED_MESSAGE,
diff --git a/extensions/slack/src/runtime.ts b/extensions/slack/src/runtime.ts
index 68b59e6b05c0..1ef412e46877 100644
--- a/extensions/slack/src/runtime.ts
+++ b/extensions/slack/src/runtime.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/channel-core";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/slack/src/scopes.test.ts b/extensions/slack/src/scopes.test.ts
index 788e69f94002..0b388c831039 100644
--- a/extensions/slack/src/scopes.test.ts
+++ b/extensions/slack/src/scopes.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover scopes plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const createSlackWebClientMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/slack/src/scopes.ts b/extensions/slack/src/scopes.ts
index cf82b0e5c406..50c941c478f7 100644
--- a/extensions/slack/src/scopes.ts
+++ b/extensions/slack/src/scopes.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements scopes behavior.
 import type { WebClient } from "@slack/web-api";
 import {
   isRecord,
diff --git a/extensions/slack/src/secret-contract.ts b/extensions/slack/src/secret-contract.ts
index 471a1a582e42..4837d0779b96 100644
--- a/extensions/slack/src/secret-contract.ts
+++ b/extensions/slack/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements secret contract behavior.
 import {
   collectConditionalChannelFieldAssignments,
   collectSimpleChannelFieldAssignments,
diff --git a/extensions/slack/src/security-audit.test.ts b/extensions/slack/src/security-audit.test.ts
index f32ac130cd6d..923f0932ae0a 100644
--- a/extensions/slack/src/security-audit.test.ts
+++ b/extensions/slack/src/security-audit.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover security audit plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { ResolvedSlackAccount } from "./accounts.js";
 import type { OpenClawConfig } from "./runtime-api.js";
diff --git a/extensions/slack/src/security-audit.ts b/extensions/slack/src/security-audit.ts
index a60d2b4a24d1..e779be034b21 100644
--- a/extensions/slack/src/security-audit.ts
+++ b/extensions/slack/src/security-audit.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements security audit behavior.
 import { coerceNativeSetting, normalizeAllowFromList } from "openclaw/plugin-sdk/channel-policy";
 import { readChannelAllowFromStore } from "openclaw/plugin-sdk/conversation-runtime";
 import {
diff --git a/extensions/slack/src/security-doctor.ts b/extensions/slack/src/security-doctor.ts
index a44d0f39552c..03b3956cb99d 100644
--- a/extensions/slack/src/security-doctor.ts
+++ b/extensions/slack/src/security-doctor.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements security doctor behavior.
 export function isSlackMutableAllowEntry(raw: string): boolean {
   const text = raw.trim();
   if (!text || text === "*") {
diff --git a/extensions/slack/src/security.ts b/extensions/slack/src/security.ts
index d3510bfa0ab8..5156344e6546 100644
--- a/extensions/slack/src/security.ts
+++ b/extensions/slack/src/security.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements security behavior.
 import { createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import { createOpenProviderConfiguredRouteWarningCollector } from "openclaw/plugin-sdk/channel-policy";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
diff --git a/extensions/slack/src/send.blocks.test.ts b/extensions/slack/src/send.blocks.test.ts
index 7833e83a7861..913c8fa20daf 100644
--- a/extensions/slack/src/send.blocks.test.ts
+++ b/extensions/slack/src/send.blocks.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover send.blocks plugin behavior.
 import { describe, expect, it } from "vitest";
 import { createSlackSendTestClient, installSlackBlockTestMocks } from "./blocks.test-helpers.js";
 import {
diff --git a/extensions/slack/src/send.identity-fallback.test.ts b/extensions/slack/src/send.identity-fallback.test.ts
index 812aab4886f4..ed88ca6a4cff 100644
--- a/extensions/slack/src/send.identity-fallback.test.ts
+++ b/extensions/slack/src/send.identity-fallback.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover send.identity fallback plugin behavior.
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createSlackSendTestClient, installSlackBlockTestMocks } from "./blocks.test-helpers.js";
diff --git a/extensions/slack/src/send.runtime.ts b/extensions/slack/src/send.runtime.ts
index 16eb437da7cc..95fdc9c311a8 100644
--- a/extensions/slack/src/send.runtime.ts
+++ b/extensions/slack/src/send.runtime.ts
@@ -1 +1,2 @@
+// Slack plugin module implements send behavior.
 export { sendMessageSlack } from "./send.js";
diff --git a/extensions/slack/src/send.ts b/extensions/slack/src/send.ts
index c6a4b5a8d2da..26bef71aac37 100644
--- a/extensions/slack/src/send.ts
+++ b/extensions/slack/src/send.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements send behavior.
 import type { MessageMetadata } from "@slack/types";
 import type { Block, KnownBlock, WebClient } from "@slack/web-api";
 import {
diff --git a/extensions/slack/src/send.unfurl.test.ts b/extensions/slack/src/send.unfurl.test.ts
index 5665dddd8ac3..6614a774417f 100644
--- a/extensions/slack/src/send.unfurl.test.ts
+++ b/extensions/slack/src/send.unfurl.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover send.unfurl plugin behavior.
 import type { WebClient } from "@slack/web-api";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/slack/src/send.upload.test.ts b/extensions/slack/src/send.upload.test.ts
index 13693c113a8a..30d9f98e7563 100644
--- a/extensions/slack/src/send.upload.test.ts
+++ b/extensions/slack/src/send.upload.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover send.upload plugin behavior.
 import type { WebClient } from "@slack/web-api";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { installSlackBlockTestMocks } from "./blocks.test-helpers.js";
diff --git a/extensions/slack/src/sent-thread-cache.test.ts b/extensions/slack/src/sent-thread-cache.test.ts
index 893424788cf0..fbd59a73ff55 100644
--- a/extensions/slack/src/sent-thread-cache.test.ts
+++ b/extensions/slack/src/sent-thread-cache.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover sent thread cache plugin behavior.
 import { importFreshModule } from "openclaw/plugin-sdk/test-fixtures";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { clearSlackRuntime, setSlackRuntime } from "./runtime.js";
diff --git a/extensions/slack/src/sent-thread-cache.ts b/extensions/slack/src/sent-thread-cache.ts
index d7836cf57d98..d19650f585e1 100644
--- a/extensions/slack/src/sent-thread-cache.ts
+++ b/extensions/slack/src/sent-thread-cache.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements sent thread cache behavior.
 import { resolveGlobalDedupeCache } from "openclaw/plugin-sdk/dedupe-runtime";
 import { getOptionalSlackRuntime } from "./runtime.js";
 
diff --git a/extensions/slack/src/setup-core.ts b/extensions/slack/src/setup-core.ts
index f40c38a072e8..4cce2eb886a8 100644
--- a/extensions/slack/src/setup-core.ts
+++ b/extensions/slack/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements setup core behavior.
 import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input";
 import {
   createAccountScopedAllowFromSection,
diff --git a/extensions/slack/src/setup-shared.ts b/extensions/slack/src/setup-shared.ts
index 8ecfabf83d54..77267da8805d 100644
--- a/extensions/slack/src/setup-shared.ts
+++ b/extensions/slack/src/setup-shared.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements setup shared behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input";
 import { patchChannelConfigForAccount } from "openclaw/plugin-sdk/setup-runtime";
diff --git a/extensions/slack/src/setup-surface.test.ts b/extensions/slack/src/setup-surface.test.ts
index 8dd1da7b38fe..cf13920eced0 100644
--- a/extensions/slack/src/setup-surface.test.ts
+++ b/extensions/slack/src/setup-surface.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover setup surface plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   createTestWizardPrompter,
diff --git a/extensions/slack/src/setup-surface.ts b/extensions/slack/src/setup-surface.ts
index f7c9653fefe7..544d89274982 100644
--- a/extensions/slack/src/setup-surface.ts
+++ b/extensions/slack/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements setup surface behavior.
 import { adaptScopedAccountAccessor } from "openclaw/plugin-sdk/channel-config-helpers";
 import {
   noteChannelLookupFailure,
diff --git a/extensions/slack/src/shared-interactive.test.ts b/extensions/slack/src/shared-interactive.test.ts
index 1d991fec637b..f7ad97bc7193 100644
--- a/extensions/slack/src/shared-interactive.test.ts
+++ b/extensions/slack/src/shared-interactive.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover shared interactive plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildSlackInteractiveBlocks, buildSlackPresentationBlocks } from "./blocks-render.js";
 import { resolveSlackReplyBlocks } from "./reply-blocks.js";
diff --git a/extensions/slack/src/shared.test.ts b/extensions/slack/src/shared.test.ts
index d2c981c0ffe3..d5ccac1faf95 100644
--- a/extensions/slack/src/shared.test.ts
+++ b/extensions/slack/src/shared.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover shared plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import { createSlackPluginBase, setSlackChannelAllowlist, slackConfigAdapter } from "./shared.js";
diff --git a/extensions/slack/src/shared.ts b/extensions/slack/src/shared.ts
index 8ca9f42791bc..7d63e1638686 100644
--- a/extensions/slack/src/shared.ts
+++ b/extensions/slack/src/shared.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements shared behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
 import {
diff --git a/extensions/slack/src/stream-mode.test.ts b/extensions/slack/src/stream-mode.test.ts
index d54ffb9f83c1..d1a287813dfd 100644
--- a/extensions/slack/src/stream-mode.test.ts
+++ b/extensions/slack/src/stream-mode.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover stream mode plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   applyAppendOnlyStreamUpdate,
diff --git a/extensions/slack/src/stream-mode.ts b/extensions/slack/src/stream-mode.ts
index 397d551e71a9..7d1866391f32 100644
--- a/extensions/slack/src/stream-mode.ts
+++ b/extensions/slack/src/stream-mode.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements stream mode behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
   mapStreamingModeToSlackLegacyDraftStreamMode,
diff --git a/extensions/slack/src/streaming-compat.ts b/extensions/slack/src/streaming-compat.ts
index 43243a884b19..fecc9ede64b6 100644
--- a/extensions/slack/src/streaming-compat.ts
+++ b/extensions/slack/src/streaming-compat.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements streaming compat behavior.
 import {
   getChannelStreamingConfigObject,
   resolveChannelStreamingNativeTransport,
diff --git a/extensions/slack/src/streaming.test.ts b/extensions/slack/src/streaming.test.ts
index 9872879b88a9..631f7fbc6be4 100644
--- a/extensions/slack/src/streaming.test.ts
+++ b/extensions/slack/src/streaming.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover streaming plugin behavior.
 import type { ChatStreamer } from "@slack/web-api/dist/chat-stream.js";
 import { describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/slack/src/target-parsing.ts b/extensions/slack/src/target-parsing.ts
index 10b934c28744..c4fc5c4226bc 100644
--- a/extensions/slack/src/target-parsing.ts
+++ b/extensions/slack/src/target-parsing.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements target parsing behavior.
 import {
   buildMessagingTarget,
   ensureTargetId,
diff --git a/extensions/slack/src/targets.test.ts b/extensions/slack/src/targets.test.ts
index 61e999cf4c1f..f54868ebc239 100644
--- a/extensions/slack/src/targets.test.ts
+++ b/extensions/slack/src/targets.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover targets plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   normalizeSlackMessagingTarget,
diff --git a/extensions/slack/src/targets.ts b/extensions/slack/src/targets.ts
index 5b22766ce8b3..fcd29e2c094b 100644
--- a/extensions/slack/src/targets.ts
+++ b/extensions/slack/src/targets.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements targets behavior.
 export {
   looksLikeSlackTargetId,
   normalizeSlackMessagingTarget,
diff --git a/extensions/slack/src/thread-ts.test.ts b/extensions/slack/src/thread-ts.test.ts
index 27b32595b86f..5233be8fed6d 100644
--- a/extensions/slack/src/thread-ts.test.ts
+++ b/extensions/slack/src/thread-ts.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover thread ts plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeSlackThreadTsCandidate, resolveSlackThreadTsValue } from "./thread-ts.js";
 
diff --git a/extensions/slack/src/thread-ts.ts b/extensions/slack/src/thread-ts.ts
index da0b2cbe7b4b..8d8677cb3ce0 100644
--- a/extensions/slack/src/thread-ts.ts
+++ b/extensions/slack/src/thread-ts.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements thread ts behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 const SLACK_THREAD_TS_PATTERN = /^\d+\.\d+$/;
diff --git a/extensions/slack/src/threading-tool-context.test.ts b/extensions/slack/src/threading-tool-context.test.ts
index 10cf813af60f..6f220f984e75 100644
--- a/extensions/slack/src/threading-tool-context.test.ts
+++ b/extensions/slack/src/threading-tool-context.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover threading tool context plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import { buildSlackThreadingToolContext } from "./threading-tool-context.js";
diff --git a/extensions/slack/src/threading-tool-context.ts b/extensions/slack/src/threading-tool-context.ts
index 28ba271cbe13..54d175845a1b 100644
--- a/extensions/slack/src/threading-tool-context.ts
+++ b/extensions/slack/src/threading-tool-context.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements threading tool context behavior.
 import type {
   ChannelThreadingContext,
   ChannelThreadingToolContext,
diff --git a/extensions/slack/src/threading.test.ts b/extensions/slack/src/threading.test.ts
index 70875a2df6c3..8e94fa7f3037 100644
--- a/extensions/slack/src/threading.test.ts
+++ b/extensions/slack/src/threading.test.ts
@@ -1,3 +1,4 @@
+// Slack tests cover threading plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveSlackThreadContext, resolveSlackThreadTargets } from "./threading.js";
 
diff --git a/extensions/slack/src/threading.ts b/extensions/slack/src/threading.ts
index d10ef1b5946b..3460e3cb4dfe 100644
--- a/extensions/slack/src/threading.ts
+++ b/extensions/slack/src/threading.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements threading behavior.
 import type { ReplyToMode } from "openclaw/plugin-sdk/config-contracts";
 import type { SlackAppMentionEvent, SlackMessageEvent } from "./types.js";
 
diff --git a/extensions/slack/src/token.ts b/extensions/slack/src/token.ts
index 292d2ec80dd6..8059633527ca 100644
--- a/extensions/slack/src/token.ts
+++ b/extensions/slack/src/token.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements token behavior.
 import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input";
 
 export function resolveSlackBotToken(
diff --git a/extensions/slack/src/truncate.ts b/extensions/slack/src/truncate.ts
index d7c387f63ae0..03998f437cf0 100644
--- a/extensions/slack/src/truncate.ts
+++ b/extensions/slack/src/truncate.ts
@@ -1,3 +1,4 @@
+// Slack plugin module implements truncate behavior.
 export function truncateSlackText(value: string, max: number): string {
   const trimmed = value.trim();
   if (trimmed.length <= max) {
diff --git a/extensions/slack/src/types.ts b/extensions/slack/src/types.ts
index 0bcd02bd438d..7c8ceba624ee 100644
--- a/extensions/slack/src/types.ts
+++ b/extensions/slack/src/types.ts
@@ -1,3 +1,4 @@
+// Slack type declarations define plugin contracts.
 export type SlackFile = {
   id?: string;
   name?: string;
diff --git a/extensions/slack/test-api.ts b/extensions/slack/test-api.ts
index 16046773255f..254721c55658 100644
--- a/extensions/slack/test-api.ts
+++ b/extensions/slack/test-api.ts
@@ -1,3 +1,4 @@
+// Slack API module exposes the plugin public contract.
 export type { ResolvedSlackAccount } from "./src/accounts.js";
 export type { SlackMessageEvent } from "./src/types.js";
 export { slackPlugin } from "./src/channel.js";
diff --git a/extensions/telegram/account-inspect-api.ts b/extensions/telegram/account-inspect-api.ts
index 15fafb2e2d6e..cdc4502fe800 100644
--- a/extensions/telegram/account-inspect-api.ts
+++ b/extensions/telegram/account-inspect-api.ts
@@ -1,3 +1,4 @@
+// Telegram API module exposes the plugin public contract.
 import type { OpenClawConfig } from "./runtime-api.js";
 import { inspectTelegramAccount } from "./src/account-inspect.js";
 
diff --git a/extensions/telegram/allow-from.ts b/extensions/telegram/allow-from.ts
index a55d5a3ffb8e..09a88a1f3e92 100644
--- a/extensions/telegram/allow-from.ts
+++ b/extensions/telegram/allow-from.ts
@@ -1 +1,2 @@
+// Telegram plugin module implements allow from behavior.
 export * from "./src/allow-from.js";
diff --git a/extensions/telegram/api.test.ts b/extensions/telegram/api.test.ts
index 741d38213146..77d3b7bfe1d0 100644
--- a/extensions/telegram/api.test.ts
+++ b/extensions/telegram/api.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover api plugin behavior.
 import { describe, expect, it } from "vitest";
 import { escapeTelegramHtml, markdownToTelegramHtml } from "./api.js";
 
diff --git a/extensions/telegram/api.ts b/extensions/telegram/api.ts
index 9a0c3109dcab..c005eeeab785 100644
--- a/extensions/telegram/api.ts
+++ b/extensions/telegram/api.ts
@@ -1,3 +1,4 @@
+// Telegram API module exposes the plugin public contract.
 export { telegramPlugin } from "./src/channel.js";
 export { telegramSetupPlugin } from "./src/channel.setup.js";
 export {
diff --git a/extensions/telegram/channel-config-api.test.ts b/extensions/telegram/channel-config-api.test.ts
index 92950621d5c0..5c7deee3babf 100644
--- a/extensions/telegram/channel-config-api.test.ts
+++ b/extensions/telegram/channel-config-api.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover channel config api plugin behavior.
 import { describe, expect, it } from "vitest";
 import { TELEGRAM_COMMAND_NAME_PATTERN } from "./channel-config-api.js";
 
diff --git a/extensions/telegram/channel-config-api.ts b/extensions/telegram/channel-config-api.ts
index acafccd81fab..139243991f03 100644
--- a/extensions/telegram/channel-config-api.ts
+++ b/extensions/telegram/channel-config-api.ts
@@ -1,3 +1,4 @@
+// Telegram API module exposes the plugin public contract.
 export {
   TELEGRAM_COMMAND_NAME_PATTERN,
   normalizeTelegramCommandDescription,
diff --git a/extensions/telegram/config-api.ts b/extensions/telegram/config-api.ts
index 8e91a33f495f..435979ff5ab2 100644
--- a/extensions/telegram/config-api.ts
+++ b/extensions/telegram/config-api.ts
@@ -1,3 +1,4 @@
+// Telegram API module exposes the plugin public contract.
 export {
   buildChannelConfigSchema,
   TelegramConfigSchema,
diff --git a/extensions/telegram/configured-state.ts b/extensions/telegram/configured-state.ts
index 54dc8c3bdffa..e519dfed6441 100644
--- a/extensions/telegram/configured-state.ts
+++ b/extensions/telegram/configured-state.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports configured state behavior.
 export function hasTelegramConfiguredState(params: { env?: NodeJS.ProcessEnv }): boolean {
   return (
     typeof params.env?.TELEGRAM_BOT_TOKEN === "string" &&
diff --git a/extensions/telegram/contract-api.ts b/extensions/telegram/contract-api.ts
index d392c27aece1..a9b6dc061db2 100644
--- a/extensions/telegram/contract-api.ts
+++ b/extensions/telegram/contract-api.ts
@@ -1,3 +1,4 @@
+// Telegram API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
 export {
   collectRuntimeConfigAssignments,
diff --git a/extensions/telegram/directory-contract-api.ts b/extensions/telegram/directory-contract-api.ts
index d37033f25029..85b6824b5079 100644
--- a/extensions/telegram/directory-contract-api.ts
+++ b/extensions/telegram/directory-contract-api.ts
@@ -1,3 +1,4 @@
+// Telegram API module exposes the plugin public contract.
 export {
   listTelegramDirectoryGroupsFromConfig,
   listTelegramDirectoryPeersFromConfig,
diff --git a/extensions/telegram/doctor-contract-api.ts b/extensions/telegram/doctor-contract-api.ts
index a7a56f234421..fc0e8579010b 100644
--- a/extensions/telegram/doctor-contract-api.ts
+++ b/extensions/telegram/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Telegram API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
diff --git a/extensions/telegram/index.test.ts b/extensions/telegram/index.test.ts
index adcf2d86d62e..d2014a47905f 100644
--- a/extensions/telegram/index.test.ts
+++ b/extensions/telegram/index.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover index plugin behavior.
 import { assertBundledChannelEntries } from "openclaw/plugin-sdk/channel-test-helpers";
 import { beforeEach, describe, vi } from "vitest";
 import entry from "./index.js";
diff --git a/extensions/telegram/index.ts b/extensions/telegram/index.ts
index dc38368e08a9..ae8be62ecad6 100644
--- a/extensions/telegram/index.ts
+++ b/extensions/telegram/index.ts
@@ -1,3 +1,4 @@
+// Telegram plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/telegram/legacy-state-migrations-api.ts b/extensions/telegram/legacy-state-migrations-api.ts
index 138d753daff3..ef81674b8fb5 100644
--- a/extensions/telegram/legacy-state-migrations-api.ts
+++ b/extensions/telegram/legacy-state-migrations-api.ts
@@ -1 +1,2 @@
+// Telegram API module exposes the plugin public contract.
 export { detectTelegramLegacyStateMigrations } from "./src/state-migrations.js";
diff --git a/extensions/telegram/runtime-api.ts b/extensions/telegram/runtime-api.ts
index a3999fdfe68b..60722c191a0b 100644
--- a/extensions/telegram/runtime-api.ts
+++ b/extensions/telegram/runtime-api.ts
@@ -1,3 +1,4 @@
+// Telegram API module exposes the plugin public contract.
 export type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 export type { ChannelMessageActionAdapter } from "openclaw/plugin-sdk/channel-contract";
 export type { TelegramApiOverride } from "./src/send.js";
diff --git a/extensions/telegram/secret-contract-api.ts b/extensions/telegram/secret-contract-api.ts
index 9f44ef28569c..12e8db6c15ac 100644
--- a/extensions/telegram/secret-contract-api.ts
+++ b/extensions/telegram/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Telegram API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/telegram/security-audit-contract-api.ts b/extensions/telegram/security-audit-contract-api.ts
index e9d793879af1..87cbacb1731a 100644
--- a/extensions/telegram/security-audit-contract-api.ts
+++ b/extensions/telegram/security-audit-contract-api.ts
@@ -1 +1,2 @@
+// Telegram API module exposes the plugin public contract.
 export { collectTelegramSecurityAuditFindings } from "./src/security-audit.js";
diff --git a/extensions/telegram/session-key-api.ts b/extensions/telegram/session-key-api.ts
index b37e63e294e6..82f680988cd1 100644
--- a/extensions/telegram/session-key-api.ts
+++ b/extensions/telegram/session-key-api.ts
@@ -1 +1,2 @@
+// Telegram API module exposes the plugin public contract.
 export { resolveTelegramSessionConversation as resolveSessionConversation } from "./src/session-conversation.js";
diff --git a/extensions/telegram/setup-entry.ts b/extensions/telegram/setup-entry.ts
index a3b942698ce1..f5f86ecc8e2e 100644
--- a/extensions/telegram/setup-entry.ts
+++ b/extensions/telegram/setup-entry.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/telegram/src/access-groups.ts b/extensions/telegram/src/access-groups.ts
index ad91e01f577d..3868d53ba863 100644
--- a/extensions/telegram/src/access-groups.ts
+++ b/extensions/telegram/src/access-groups.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements access groups behavior.
 import type { DmPolicy, OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   expandAllowFromWithAccessGroups,
diff --git a/extensions/telegram/src/account-config.ts b/extensions/telegram/src/account-config.ts
index 52cbe11734ce..d23a5e0087a3 100644
--- a/extensions/telegram/src/account-config.ts
+++ b/extensions/telegram/src/account-config.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports account config behavior.
 import {
   normalizeAccountId,
   resolveNormalizedAccountEntry,
diff --git a/extensions/telegram/src/account-inspect.test.ts b/extensions/telegram/src/account-inspect.test.ts
index 5031c352398a..a76d4eafc41f 100644
--- a/extensions/telegram/src/account-inspect.test.ts
+++ b/extensions/telegram/src/account-inspect.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover account inspect plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/account-inspect.ts b/extensions/telegram/src/account-inspect.ts
index f936cf0c67fb..de8728f57801 100644
--- a/extensions/telegram/src/account-inspect.ts
+++ b/extensions/telegram/src/account-inspect.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements account inspect behavior.
 import { resolveAccountWithDefaultFallback } from "openclaw/plugin-sdk/account-core";
 import { tryReadSecretFileSync } from "openclaw/plugin-sdk/channel-core";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/account-selection.ts b/extensions/telegram/src/account-selection.ts
index 1a9a3775b62c..aa0d7b60a8ae 100644
--- a/extensions/telegram/src/account-selection.ts
+++ b/extensions/telegram/src/account-selection.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements account selection behavior.
 import {
   listCombinedAccountIds,
   resolveListedDefaultAccountId,
diff --git a/extensions/telegram/src/account-throttler.test.ts b/extensions/telegram/src/account-throttler.test.ts
index 58d408330e48..7eb641a537be 100644
--- a/extensions/telegram/src/account-throttler.test.ts
+++ b/extensions/telegram/src/account-throttler.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover account throttler plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   clearAccountThrottlersForTest,
diff --git a/extensions/telegram/src/account-throttler.ts b/extensions/telegram/src/account-throttler.ts
index 1a38b2d74bd8..74f99bb2538b 100644
--- a/extensions/telegram/src/account-throttler.ts
+++ b/extensions/telegram/src/account-throttler.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements account throttler behavior.
 import { parseStrictInteger } from "openclaw/plugin-sdk/number-runtime";
 import { apiThrottler } from "./bot.runtime.js";
 
diff --git a/extensions/telegram/src/accounts.test.ts b/extensions/telegram/src/accounts.test.ts
index c04218054295..3cab223df742 100644
--- a/extensions/telegram/src/accounts.test.ts
+++ b/extensions/telegram/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover accounts plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import * as runtimeEnvModule from "openclaw/plugin-sdk/runtime-env";
 import { withEnv } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/telegram/src/accounts.ts b/extensions/telegram/src/accounts.ts
index cb29962634b8..5d81658d8b6c 100644
--- a/extensions/telegram/src/accounts.ts
+++ b/extensions/telegram/src/accounts.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements accounts behavior.
 import util from "node:util";
 import {
   createAccountActionGate,
diff --git a/extensions/telegram/src/action-runtime.test.ts b/extensions/telegram/src/action-runtime.test.ts
index bfa52f85f143..a6189245f3ee 100644
--- a/extensions/telegram/src/action-runtime.test.ts
+++ b/extensions/telegram/src/action-runtime.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover action runtime plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/action-runtime.ts b/extensions/telegram/src/action-runtime.ts
index d2a1a61b3a23..215908797c23 100644
--- a/extensions/telegram/src/action-runtime.ts
+++ b/extensions/telegram/src/action-runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements action runtime behavior.
 import type { AgentToolResult } from "openclaw/plugin-sdk/agent-core";
 import { readBooleanParam } from "openclaw/plugin-sdk/boolean-param";
 import {
diff --git a/extensions/telegram/src/action-threading.test.ts b/extensions/telegram/src/action-threading.test.ts
index 1e7914eebd3f..071a54d8d59c 100644
--- a/extensions/telegram/src/action-threading.test.ts
+++ b/extensions/telegram/src/action-threading.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover action threading plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveTelegramAutoThreadId } from "./action-threading.js";
 
diff --git a/extensions/telegram/src/action-threading.ts b/extensions/telegram/src/action-threading.ts
index c2d17570d983..1c79bb220431 100644
--- a/extensions/telegram/src/action-threading.ts
+++ b/extensions/telegram/src/action-threading.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements action threading behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { parseTelegramTarget } from "./targets.js";
 
diff --git a/extensions/telegram/src/agent-config.ts b/extensions/telegram/src/agent-config.ts
index 9e5ed80899c8..af08fe03bee9 100644
--- a/extensions/telegram/src/agent-config.ts
+++ b/extensions/telegram/src/agent-config.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports agent config behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 
 type ReasoningDefault = "on" | "stream" | "off";
diff --git a/extensions/telegram/src/allow-from.ts b/extensions/telegram/src/allow-from.ts
index 33cf50e0b14c..d5b70aed8d2c 100644
--- a/extensions/telegram/src/allow-from.ts
+++ b/extensions/telegram/src/allow-from.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements allow from behavior.
 export function normalizeTelegramAllowFromEntry(raw: unknown): string {
   const base = typeof raw === "string" ? raw : typeof raw === "number" ? String(raw) : "";
   return base
diff --git a/extensions/telegram/src/allowed-updates.test.ts b/extensions/telegram/src/allowed-updates.test.ts
index ed40eb27f664..cf5d13b83af8 100644
--- a/extensions/telegram/src/allowed-updates.test.ts
+++ b/extensions/telegram/src/allowed-updates.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover allowed updates plugin behavior.
 import { beforeAll, describe, expect, it } from "vitest";
 let DEFAULT_TELEGRAM_UPDATE_TYPES: typeof import("./allowed-updates.js").DEFAULT_TELEGRAM_UPDATE_TYPES;
 let resolveTelegramAllowedUpdates: typeof import("./allowed-updates.js").resolveTelegramAllowedUpdates;
diff --git a/extensions/telegram/src/allowed-updates.ts b/extensions/telegram/src/allowed-updates.ts
index 67b56fab20cf..ccfb8c311fc1 100644
--- a/extensions/telegram/src/allowed-updates.ts
+++ b/extensions/telegram/src/allowed-updates.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements allowed updates behavior.
 import { API_CONSTANTS } from "grammy";
 
 export type TelegramUpdateType = (typeof API_CONSTANTS.ALL_UPDATE_TYPES)[number];
diff --git a/extensions/telegram/src/api-fetch.test.ts b/extensions/telegram/src/api-fetch.test.ts
index 4631f8bb60e0..4778d05cfe40 100644
--- a/extensions/telegram/src/api-fetch.test.ts
+++ b/extensions/telegram/src/api-fetch.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover api fetch plugin behavior.
 import { createRequire } from "node:module";
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { fetchTelegramChatId } from "./api-fetch.js";
diff --git a/extensions/telegram/src/api-fetch.ts b/extensions/telegram/src/api-fetch.ts
index 423d68ea59b9..f5233aaf48ac 100644
--- a/extensions/telegram/src/api-fetch.ts
+++ b/extensions/telegram/src/api-fetch.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements api fetch behavior.
 import type { TelegramNetworkConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolveTelegramApiBase, resolveTelegramFetch } from "./fetch.js";
 import { makeProxyFetch } from "./proxy.js";
diff --git a/extensions/telegram/src/api-logging.ts b/extensions/telegram/src/api-logging.ts
index 3a524aa48568..b02daa6f9e0c 100644
--- a/extensions/telegram/src/api-logging.ts
+++ b/extensions/telegram/src/api-logging.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements api logging behavior.
 import { createSubsystemLogger } from "openclaw/plugin-sdk/runtime-env";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { formatErrorMessage } from "openclaw/plugin-sdk/ssrf-runtime";
diff --git a/extensions/telegram/src/api-root.test.ts b/extensions/telegram/src/api-root.test.ts
index 9754e484265b..4d13e7d895d9 100644
--- a/extensions/telegram/src/api-root.test.ts
+++ b/extensions/telegram/src/api-root.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover api root plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   DEFAULT_TELEGRAM_API_ROOT,
diff --git a/extensions/telegram/src/api-root.ts b/extensions/telegram/src/api-root.ts
index 3d2ea4c6d9c9..f8ab8da29b3a 100644
--- a/extensions/telegram/src/api-root.ts
+++ b/extensions/telegram/src/api-root.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements api root behavior.
 export const DEFAULT_TELEGRAM_API_ROOT = "https://api.telegram.org";
 
 const TELEGRAM_BOT_ENDPOINT_SEGMENT_RE = /^bot\d+:[^/]+$/u;
diff --git a/extensions/telegram/src/approval-callback-data.test.ts b/extensions/telegram/src/approval-callback-data.test.ts
index 0b56605f45d5..1a53e7c66674 100644
--- a/extensions/telegram/src/approval-callback-data.test.ts
+++ b/extensions/telegram/src/approval-callback-data.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover approval callback data plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   fitsTelegramCallbackData,
diff --git a/extensions/telegram/src/approval-callback-data.ts b/extensions/telegram/src/approval-callback-data.ts
index 71f97a0f4000..06d4cc383965 100644
--- a/extensions/telegram/src/approval-callback-data.ts
+++ b/extensions/telegram/src/approval-callback-data.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements approval callback data behavior.
 const TELEGRAM_CALLBACK_DATA_MAX_BYTES = 64;
 
 const TELEGRAM_APPROVE_ALLOW_ALWAYS_PATTERN =
diff --git a/extensions/telegram/src/approval-handler.runtime.test.ts b/extensions/telegram/src/approval-handler.runtime.test.ts
index ebcff74707f7..5ee003b429ea 100644
--- a/extensions/telegram/src/approval-handler.runtime.test.ts
+++ b/extensions/telegram/src/approval-handler.runtime.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover approval handler plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { telegramApprovalNativeRuntime } from "./approval-handler.runtime.js";
 
diff --git a/extensions/telegram/src/approval-handler.runtime.ts b/extensions/telegram/src/approval-handler.runtime.ts
index e992c3c771d1..34ee9fcfbdcc 100644
--- a/extensions/telegram/src/approval-handler.runtime.ts
+++ b/extensions/telegram/src/approval-handler.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements approval handler behavior.
 import type {
   ChannelApprovalCapabilityHandlerContext,
   PendingApprovalView,
diff --git a/extensions/telegram/src/approval-native.test.ts b/extensions/telegram/src/approval-native.test.ts
index 105c06d9b106..76a536ae32d7 100644
--- a/extensions/telegram/src/approval-native.test.ts
+++ b/extensions/telegram/src/approval-native.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover approval native plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/approval-native.ts b/extensions/telegram/src/approval-native.ts
index 102ef7293498..5e3f38167b5b 100644
--- a/extensions/telegram/src/approval-native.ts
+++ b/extensions/telegram/src/approval-native.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements approval native behavior.
 import {
   createApproverRestrictedNativeApprovalCapability,
   splitChannelApprovalCapability,
diff --git a/extensions/telegram/src/audit-membership-runtime.ts b/extensions/telegram/src/audit-membership-runtime.ts
index c7d939a60dc7..3440ff43f688 100644
--- a/extensions/telegram/src/audit-membership-runtime.ts
+++ b/extensions/telegram/src/audit-membership-runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements audit membership runtime behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { fetchWithTimeout } from "openclaw/plugin-sdk/text-utility-runtime";
diff --git a/extensions/telegram/src/audit.test.ts b/extensions/telegram/src/audit.test.ts
index 4602e6766604..8e07ea40a580 100644
--- a/extensions/telegram/src/audit.test.ts
+++ b/extensions/telegram/src/audit.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover audit plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 let collectTelegramUnmentionedGroupIds: typeof import("./audit.js").collectTelegramUnmentionedGroupIds;
diff --git a/extensions/telegram/src/audit.ts b/extensions/telegram/src/audit.ts
index edf575f145aa..e6b53ad29c06 100644
--- a/extensions/telegram/src/audit.ts
+++ b/extensions/telegram/src/audit.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements audit behavior.
 import type { TelegramGroupConfig } from "openclaw/plugin-sdk/config-contracts";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 export type {
diff --git a/extensions/telegram/src/audit.types.ts b/extensions/telegram/src/audit.types.ts
index e79d19149a83..5f75253ba12e 100644
--- a/extensions/telegram/src/audit.types.ts
+++ b/extensions/telegram/src/audit.types.ts
@@ -1,3 +1,4 @@
+// Telegram type declarations define plugin contracts.
 import type { TelegramNetworkConfig } from "openclaw/plugin-sdk/config-contracts";
 
 export type TelegramGroupMembershipAuditEntry = {
diff --git a/extensions/telegram/src/auto-topic-label-config.ts b/extensions/telegram/src/auto-topic-label-config.ts
index 6b7f32688197..cec920309d30 100644
--- a/extensions/telegram/src/auto-topic-label-config.ts
+++ b/extensions/telegram/src/auto-topic-label-config.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports auto topic label config behavior.
 import type {
   TelegramAccountConfig,
   TelegramDirectConfig,
diff --git a/extensions/telegram/src/auto-topic-label.test.ts b/extensions/telegram/src/auto-topic-label.test.ts
index 77e1f05dad27..7d1bc8d3639c 100644
--- a/extensions/telegram/src/auto-topic-label.test.ts
+++ b/extensions/telegram/src/auto-topic-label.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover auto topic label plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 
 const generateConversationLabel = vi.hoisted(() => vi.fn());
diff --git a/extensions/telegram/src/auto-topic-label.ts b/extensions/telegram/src/auto-topic-label.ts
index a8a32cadf7ba..51c3e9aee3f8 100644
--- a/extensions/telegram/src/auto-topic-label.ts
+++ b/extensions/telegram/src/auto-topic-label.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements auto topic label behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { generateConversationLabel } from "openclaw/plugin-sdk/reply-dispatch-runtime";
 export { resolveAutoTopicLabelConfig } from "./auto-topic-label-config.js";
diff --git a/extensions/telegram/src/bot-access.ts b/extensions/telegram/src/bot-access.ts
index 642fe50836ed..8e3274b41c88 100644
--- a/extensions/telegram/src/bot-access.ts
+++ b/extensions/telegram/src/bot-access.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot access behavior.
 import {
   firstDefined,
   isSenderIdAllowed,
diff --git a/extensions/telegram/src/bot-core.raw-update-log.test.ts b/extensions/telegram/src/bot-core.raw-update-log.test.ts
index e1ea4e25f4f8..a2e536e28338 100644
--- a/extensions/telegram/src/bot-core.raw-update-log.test.ts
+++ b/extensions/telegram/src/bot-core.raw-update-log.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot core.raw update log plugin behavior.
 import { describe, expect, it } from "vitest";
 import { stringifyTelegramRawUpdateForLog } from "./raw-update-log.js";
 
diff --git a/extensions/telegram/src/bot-core.ts b/extensions/telegram/src/bot-core.ts
index 425aa512b120..13a3f9904f55 100644
--- a/extensions/telegram/src/bot-core.ts
+++ b/extensions/telegram/src/bot-core.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot core behavior.
 import {
   resolveChannelGroupPolicy,
   resolveChannelGroupRequireMention,
diff --git a/extensions/telegram/src/bot-deps.ts b/extensions/telegram/src/bot-deps.ts
index 89c2ddb26aa2..33b008090547 100644
--- a/extensions/telegram/src/bot-deps.ts
+++ b/extensions/telegram/src/bot-deps.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot deps behavior.
 import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
 import { buildChannelInboundEventContext } from "openclaw/plugin-sdk/channel-inbound";
 import {
diff --git a/extensions/telegram/src/bot-handlers.agent.runtime.ts b/extensions/telegram/src/bot-handlers.agent.runtime.ts
index afe9ab7eab5d..f1f826ec2da1 100644
--- a/extensions/telegram/src/bot-handlers.agent.runtime.ts
+++ b/extensions/telegram/src/bot-handlers.agent.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot handlers.agent behavior.
 export {
   resolveAgentDir,
   resolveDefaultAgentId,
diff --git a/extensions/telegram/src/bot-handlers.debounce-key.ts b/extensions/telegram/src/bot-handlers.debounce-key.ts
index de1aa55ac5f3..13f31974e1ec 100644
--- a/extensions/telegram/src/bot-handlers.debounce-key.ts
+++ b/extensions/telegram/src/bot-handlers.debounce-key.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot handlersebounce key behavior.
 export function buildTelegramInboundDebounceKey(params: {
   accountId?: string | null;
   conversationKey: string;
diff --git a/extensions/telegram/src/bot-handlers.media.ts b/extensions/telegram/src/bot-handlers.media.ts
index 5392a7ae34d5..1e60418369bb 100644
--- a/extensions/telegram/src/bot-handlers.media.ts
+++ b/extensions/telegram/src/bot-handlers.media.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot handlers.media behavior.
 import type { Message } from "grammy/types";
 import { MediaFetchError } from "openclaw/plugin-sdk/media-runtime";
 
diff --git a/extensions/telegram/src/bot-handlers.runtime.test.ts b/extensions/telegram/src/bot-handlers.runtime.test.ts
index 2a9ea1195a56..ad591dd00652 100644
--- a/extensions/telegram/src/bot-handlers.runtime.test.ts
+++ b/extensions/telegram/src/bot-handlers.runtime.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot handlers plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildTelegramInboundDebounceConversationKey,
diff --git a/extensions/telegram/src/bot-handlers.runtime.ts b/extensions/telegram/src/bot-handlers.runtime.ts
index 3eb4fd4db965..1748725cbdc9 100644
--- a/extensions/telegram/src/bot-handlers.runtime.ts
+++ b/extensions/telegram/src/bot-handlers.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot handlers behavior.
 import type { Message, ReactionTypeEmoji } from "grammy/types";
 import { parseExecApprovalCommandText } from "openclaw/plugin-sdk/approval-reply-runtime";
 import { resolveChannelConfigWrites } from "openclaw/plugin-sdk/channel-config-helpers";
diff --git a/extensions/telegram/src/bot-info-cache.test.ts b/extensions/telegram/src/bot-info-cache.test.ts
index 1f262e08c560..db8da7826739 100644
--- a/extensions/telegram/src/bot-info-cache.test.ts
+++ b/extensions/telegram/src/bot-info-cache.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot info cache plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   deleteCachedTelegramBotInfo,
diff --git a/extensions/telegram/src/bot-info-cache.ts b/extensions/telegram/src/bot-info-cache.ts
index ddecaf2ed800..6475a6957585 100644
--- a/extensions/telegram/src/bot-info-cache.ts
+++ b/extensions/telegram/src/bot-info-cache.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot info cache behavior.
 import os from "node:os";
 import path from "node:path";
 import { readJsonFileWithFallback } from "openclaw/plugin-sdk/json-store";
diff --git a/extensions/telegram/src/bot-info.ts b/extensions/telegram/src/bot-info.ts
index 7e1fb77fe701..df4c19e1bc3c 100644
--- a/extensions/telegram/src/bot-info.ts
+++ b/extensions/telegram/src/bot-info.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot info behavior.
 export type TelegramBotInfo = {
   id: number;
   is_bot: true;
diff --git a/extensions/telegram/src/bot-message-context.acp-bindings.test.ts b/extensions/telegram/src/bot-message-context.acp-bindings.test.ts
index 8243239f3fbf..2133206b32be 100644
--- a/extensions/telegram/src/bot-message-context.acp-bindings.test.ts
+++ b/extensions/telegram/src/bot-message-context.acp-bindings.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message context.acp bindings plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const ensureConfiguredBindingRouteReadyMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/telegram/src/bot-message-context.audio-transcript.test-support.ts b/extensions/telegram/src/bot-message-context.audio-transcript.test-support.ts
index 2f047d1f90bf..91bcc187a3f0 100644
--- a/extensions/telegram/src/bot-message-context.audio-transcript.test-support.ts
+++ b/extensions/telegram/src/bot-message-context.audio-transcript.test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.audio transcript support behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const transcribeFirstAudioMock = vi.fn();
diff --git a/extensions/telegram/src/bot-message-context.body.test.ts b/extensions/telegram/src/bot-message-context.body.test.ts
index 54c6961c63c4..f0a1a67caf00 100644
--- a/extensions/telegram/src/bot-message-context.body.test.ts
+++ b/extensions/telegram/src/bot-message-context.body.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message context.body plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { normalizeAllowFrom } from "./bot-access.js";
 
diff --git a/extensions/telegram/src/bot-message-context.body.ts b/extensions/telegram/src/bot-message-context.body.ts
index 14416ffe19fd..c3b332e306f5 100644
--- a/extensions/telegram/src/bot-message-context.body.ts
+++ b/extensions/telegram/src/bot-message-context.body.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.body behavior.
 import {
   buildMentionRegexes,
   formatLocationText,
diff --git a/extensions/telegram/src/bot-message-context.dm-session.test.ts b/extensions/telegram/src/bot-message-context.dm-session.test.ts
index f109779d20f7..c2ea2d15c1cf 100644
--- a/extensions/telegram/src/bot-message-context.dm-session.test.ts
+++ b/extensions/telegram/src/bot-message-context.dm-session.test.ts
@@ -1,2 +1,3 @@
+// Telegram tests cover bot message contextm session plugin behavior.
 import "./bot-message-context.named-account-dm.test-support.js";
 import "./bot-message-context.session-recreate.test-support.js";
diff --git a/extensions/telegram/src/bot-message-context.dm-threads.test.ts b/extensions/telegram/src/bot-message-context.dm-threads.test.ts
index 09a5ff1d3e03..3bc1cd23f056 100644
--- a/extensions/telegram/src/bot-message-context.dm-threads.test.ts
+++ b/extensions/telegram/src/bot-message-context.dm-threads.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message contextm threads plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/bot-message-context.dm-topic-threadid.test.ts b/extensions/telegram/src/bot-message-context.dm-topic-threadid.test.ts
index 6b6a1361db31..7f7fe8e942f6 100644
--- a/extensions/telegram/src/bot-message-context.dm-topic-threadid.test.ts
+++ b/extensions/telegram/src/bot-message-context.dm-topic-threadid.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message contextm topic threadid plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   getRecordedUpdateLastRoute,
diff --git a/extensions/telegram/src/bot-message-context.group-body.test.ts b/extensions/telegram/src/bot-message-context.group-body.test.ts
index 7badaa64911f..b86b8c0f8dea 100644
--- a/extensions/telegram/src/bot-message-context.group-body.test.ts
+++ b/extensions/telegram/src/bot-message-context.group-body.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message context.group body plugin behavior.
 import "./bot-message-context.audio-transcript.test-support.js";
 import "./bot-message-context.implicit-mention.test-support.js";
 import "./bot-message-context.sender-prefix.test-support.js";
diff --git a/extensions/telegram/src/bot-message-context.implicit-mention.test-support.ts b/extensions/telegram/src/bot-message-context.implicit-mention.test-support.ts
index 4ed40719be55..f323569f0de9 100644
--- a/extensions/telegram/src/bot-message-context.implicit-mention.test-support.ts
+++ b/extensions/telegram/src/bot-message-context.implicit-mention.test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.implicit mention support behavior.
 import { describe, expect, it } from "vitest";
 import { buildTelegramMessageContextForTest } from "./bot-message-context.test-harness.js";
 import { TELEGRAM_FORUM_SERVICE_FIELDS } from "./forum-service-message.js";
diff --git a/extensions/telegram/src/bot-message-context.named-account-dm.test-support.ts b/extensions/telegram/src/bot-message-context.named-account-dm.test-support.ts
index 809c4f65332b..9dab1b89341c 100644
--- a/extensions/telegram/src/bot-message-context.named-account-dm.test-support.ts
+++ b/extensions/telegram/src/bot-message-context.named-account-dm.test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.named account dm support behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import {
   getRecordedUpdateLastRoute,
diff --git a/extensions/telegram/src/bot-message-context.reactions.test.ts b/extensions/telegram/src/bot-message-context.reactions.test.ts
index da33b79f9d48..8b65e2fe492b 100644
--- a/extensions/telegram/src/bot-message-context.reactions.test.ts
+++ b/extensions/telegram/src/bot-message-context.reactions.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message context.reactions plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { BuildTelegramMessageContextParams } from "./bot-message-context.types.js";
 
diff --git a/extensions/telegram/src/bot-message-context.require-mention.test.ts b/extensions/telegram/src/bot-message-context.require-mention.test.ts
index b39a43ed3c2f..9acc3571d321 100644
--- a/extensions/telegram/src/bot-message-context.require-mention.test.ts
+++ b/extensions/telegram/src/bot-message-context.require-mention.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message context.require mention plugin behavior.
 import { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/telegram/src/bot-message-context.route-test-support.ts b/extensions/telegram/src/bot-message-context.route-test-support.ts
index c6d1899efbe1..d440cee4ea98 100644
--- a/extensions/telegram/src/bot-message-context.route-test-support.ts
+++ b/extensions/telegram/src/bot-message-context.route-test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.route test support behavior.
 import { buildChannelInboundEventContext } from "openclaw/plugin-sdk/channel-inbound";
 import {
   clearRuntimeConfigSnapshot,
diff --git a/extensions/telegram/src/bot-message-context.runtime.ts b/extensions/telegram/src/bot-message-context.runtime.ts
index de4b2aeb1f1e..bd734d16ef5d 100644
--- a/extensions/telegram/src/bot-message-context.runtime.ts
+++ b/extensions/telegram/src/bot-message-context.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context behavior.
 export { createStatusReactionController } from "openclaw/plugin-sdk/channel-feedback";
 export { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
 export { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
diff --git a/extensions/telegram/src/bot-message-context.sender-prefix.test-support.ts b/extensions/telegram/src/bot-message-context.sender-prefix.test-support.ts
index 104eb64d5d9a..70b689e7e23e 100644
--- a/extensions/telegram/src/bot-message-context.sender-prefix.test-support.ts
+++ b/extensions/telegram/src/bot-message-context.sender-prefix.test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.sender prefix support behavior.
 import { describe, expect, it } from "vitest";
 import { buildTelegramMessageContextForTest } from "./bot-message-context.test-harness.js";
 import {
diff --git a/extensions/telegram/src/bot-message-context.session-recreate.test-support.ts b/extensions/telegram/src/bot-message-context.session-recreate.test-support.ts
index 54de9284fa57..6c0998f241eb 100644
--- a/extensions/telegram/src/bot-message-context.session-recreate.test-support.ts
+++ b/extensions/telegram/src/bot-message-context.session-recreate.test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.session recreate support behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/telegram/src/bot-message-context.session.runtime.ts b/extensions/telegram/src/bot-message-context.session.runtime.ts
index 77003a237dbf..86d6397be28d 100644
--- a/extensions/telegram/src/bot-message-context.session.runtime.ts
+++ b/extensions/telegram/src/bot-message-context.session.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.session behavior.
 export { buildChannelInboundEventContext } from "openclaw/plugin-sdk/channel-inbound";
 export { readSessionUpdatedAt, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
 export { recordInboundSession } from "openclaw/plugin-sdk/conversation-runtime";
diff --git a/extensions/telegram/src/bot-message-context.session.ts b/extensions/telegram/src/bot-message-context.session.ts
index 895587247bcf..44c4d9155d13 100644
--- a/extensions/telegram/src/bot-message-context.session.ts
+++ b/extensions/telegram/src/bot-message-context.session.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.session behavior.
 import {
   type BuildChannelInboundEventContextAsyncParams,
   type BuiltChannelInboundEventContext,
diff --git a/extensions/telegram/src/bot-message-context.silent-ingest.test-support.ts b/extensions/telegram/src/bot-message-context.silent-ingest.test-support.ts
index f82ceb6d384e..48c1db0a7d81 100644
--- a/extensions/telegram/src/bot-message-context.silent-ingest.test-support.ts
+++ b/extensions/telegram/src/bot-message-context.silent-ingest.test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context.silent ingest support behavior.
 import { describe, expect, it, vi } from "vitest";
 import { buildTelegramMessageContextForTest } from "./bot-message-context.test-harness.js";
 
diff --git a/extensions/telegram/src/bot-message-context.test-harness.ts b/extensions/telegram/src/bot-message-context.test-harness.ts
index 1cffca4557f0..954bbcb5b469 100644
--- a/extensions/telegram/src/bot-message-context.test-harness.ts
+++ b/extensions/telegram/src/bot-message-context.test-harness.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context harness behavior.
 import { createHash } from "node:crypto";
 import { buildChannelInboundEventContext } from "openclaw/plugin-sdk/channel-inbound";
 import type { BuildTelegramMessageContextParams, TelegramMediaRef } from "./bot-message-context.js";
diff --git a/extensions/telegram/src/bot-message-context.thread-binding.test.ts b/extensions/telegram/src/bot-message-context.thread-binding.test.ts
index 4dd1c97a9a6f..cac3ad8d680d 100644
--- a/extensions/telegram/src/bot-message-context.thread-binding.test.ts
+++ b/extensions/telegram/src/bot-message-context.thread-binding.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message context.thread binding plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { telegramRouteTestSessionRuntime } from "./bot-message-context.route-test-support.js";
 import { buildTelegramMessageContextForTest } from "./bot-message-context.test-harness.js";
diff --git a/extensions/telegram/src/bot-message-context.topic-agentid.test.ts b/extensions/telegram/src/bot-message-context.topic-agentid.test.ts
index 3878db7d937b..9cf09d2a840e 100644
--- a/extensions/telegram/src/bot-message-context.topic-agentid.test.ts
+++ b/extensions/telegram/src/bot-message-context.topic-agentid.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message context.topic agentid plugin behavior.
 import { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/telegram/src/bot-message-context.ts b/extensions/telegram/src/bot-message-context.ts
index 871c1f8a25d3..1eeb8ceb390a 100644
--- a/extensions/telegram/src/bot-message-context.ts
+++ b/extensions/telegram/src/bot-message-context.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message context behavior.
 import type { ReactionTypeEmoji } from "grammy/types";
 import {
   resolveAckReaction,
diff --git a/extensions/telegram/src/bot-message-context.types.ts b/extensions/telegram/src/bot-message-context.types.ts
index 9d2ec83ca6e5..8c07cea84760 100644
--- a/extensions/telegram/src/bot-message-context.types.ts
+++ b/extensions/telegram/src/bot-message-context.types.ts
@@ -1,3 +1,4 @@
+// Telegram type declarations define plugin contracts.
 import type { Bot } from "grammy";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type {
diff --git a/extensions/telegram/src/bot-message-context.typing.test.ts b/extensions/telegram/src/bot-message-context.typing.test.ts
index ac83eb6bc81d..829973c27425 100644
--- a/extensions/telegram/src/bot-message-context.typing.test.ts
+++ b/extensions/telegram/src/bot-message-context.typing.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message context.typing plugin behavior.
 import { buildChannelInboundEventContext } from "openclaw/plugin-sdk/channel-inbound";
 import { describe, expect, it, vi } from "vitest";
 import { buildTelegramMessageContextForTest } from "./bot-message-context.test-harness.js";
diff --git a/extensions/telegram/src/bot-message-dispatch.agent.runtime.ts b/extensions/telegram/src/bot-message-dispatch.agent.runtime.ts
index 856bedc994e1..7146b020e9ba 100644
--- a/extensions/telegram/src/bot-message-dispatch.agent.runtime.ts
+++ b/extensions/telegram/src/bot-message-dispatch.agent.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message dispatch.agent behavior.
 export {
   findModelInCatalog,
   loadModelCatalog,
diff --git a/extensions/telegram/src/bot-message-dispatch.media-dedup.test.ts b/extensions/telegram/src/bot-message-dispatch.media-dedup.test.ts
index 6483c658d527..afd6d527cddd 100644
--- a/extensions/telegram/src/bot-message-dispatch.media-dedup.test.ts
+++ b/extensions/telegram/src/bot-message-dispatch.media-dedup.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message dispatch.media dedup plugin behavior.
 import { describe, expect, it } from "vitest";
 import { deduplicateBlockSentMedia } from "./bot-message-dispatch.media-dedup.js";
 
diff --git a/extensions/telegram/src/bot-message-dispatch.media-dedup.ts b/extensions/telegram/src/bot-message-dispatch.media-dedup.ts
index 0f1f8ef08ccc..71bbdbe67a62 100644
--- a/extensions/telegram/src/bot-message-dispatch.media-dedup.ts
+++ b/extensions/telegram/src/bot-message-dispatch.media-dedup.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message dispatch.media dedup behavior.
 export function deduplicateBlockSentMedia<
   T extends { mediaUrl?: string; mediaUrls?: string[]; text?: string },
 >(payload: T, sentBlockMediaUrls: ReadonlySet<string>): T | undefined {
diff --git a/extensions/telegram/src/bot-message-dispatch.media.ts b/extensions/telegram/src/bot-message-dispatch.media.ts
index f8b2acec0d8a..6b6c7a596372 100644
--- a/extensions/telegram/src/bot-message-dispatch.media.ts
+++ b/extensions/telegram/src/bot-message-dispatch.media.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message dispatch.media behavior.
 type TelegramMediaContextPayload = {
   MediaPath?: string;
   MediaUrl?: string;
diff --git a/extensions/telegram/src/bot-message-dispatch.runtime.ts b/extensions/telegram/src/bot-message-dispatch.runtime.ts
index e50ad721b054..4b952d4058bc 100644
--- a/extensions/telegram/src/bot-message-dispatch.runtime.ts
+++ b/extensions/telegram/src/bot-message-dispatch.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message dispatch behavior.
 export {
   loadSessionStore,
   readLatestAssistantTextFromSessionTranscript,
diff --git a/extensions/telegram/src/bot-message-dispatch.sticker-media.test.ts b/extensions/telegram/src/bot-message-dispatch.sticker-media.test.ts
index e4670af398df..6e398ac0ba13 100644
--- a/extensions/telegram/src/bot-message-dispatch.sticker-media.test.ts
+++ b/extensions/telegram/src/bot-message-dispatch.sticker-media.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message dispatch.sticker media plugin behavior.
 import { describe, expect, it } from "vitest";
 import { pruneStickerMediaFromContext } from "./bot-message-dispatch.media.js";
 
diff --git a/extensions/telegram/src/bot-message-dispatch.test.ts b/extensions/telegram/src/bot-message-dispatch.test.ts
index 05bd3ce935a8..5306e7aeea08 100644
--- a/extensions/telegram/src/bot-message-dispatch.test.ts
+++ b/extensions/telegram/src/bot-message-dispatch.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message dispatch plugin behavior.
 import type { Bot } from "grammy";
 import {
   createPluginStateKeyedStoreForTests,
diff --git a/extensions/telegram/src/bot-message-dispatch.ts b/extensions/telegram/src/bot-message-dispatch.ts
index 2007dd9dadf0..9d1bf99da2b4 100644
--- a/extensions/telegram/src/bot-message-dispatch.ts
+++ b/extensions/telegram/src/bot-message-dispatch.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message dispatch behavior.
 import path from "node:path";
 import type { Bot } from "grammy";
 import {
diff --git a/extensions/telegram/src/bot-message.test.ts b/extensions/telegram/src/bot-message.test.ts
index d5380f429392..371731f848ef 100644
--- a/extensions/telegram/src/bot-message.test.ts
+++ b/extensions/telegram/src/bot-message.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot message plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { TelegramBotDeps } from "./bot-deps.js";
 
diff --git a/extensions/telegram/src/bot-message.ts b/extensions/telegram/src/bot-message.ts
index 3150728eab51..749c4bbf623b 100644
--- a/extensions/telegram/src/bot-message.ts
+++ b/extensions/telegram/src/bot-message.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot message behavior.
 import type { ReplyToMode } from "openclaw/plugin-sdk/config-contracts";
 import type { TelegramAccountConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/telegram/src/bot-native-command-deps.runtime.ts b/extensions/telegram/src/bot-native-command-deps.runtime.ts
index 07887ede3600..5345ab1a92fe 100644
--- a/extensions/telegram/src/bot-native-command-deps.runtime.ts
+++ b/extensions/telegram/src/bot-native-command-deps.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot native command deps behavior.
 import { readChannelAllowFromStore } from "openclaw/plugin-sdk/conversation-runtime";
 import { getPluginCommandSpecs } from "openclaw/plugin-sdk/plugin-runtime";
 import { dispatchReplyWithBufferedBlockDispatcher } from "openclaw/plugin-sdk/reply-dispatch-runtime";
diff --git a/extensions/telegram/src/bot-native-command-menu.test.ts b/extensions/telegram/src/bot-native-command-menu.test.ts
index 5b35d2ec61bd..1451073dd16c 100644
--- a/extensions/telegram/src/bot-native-command-menu.test.ts
+++ b/extensions/telegram/src/bot-native-command-menu.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot native command menu plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   buildCappedTelegramMenuCommands,
diff --git a/extensions/telegram/src/bot-native-command-menu.ts b/extensions/telegram/src/bot-native-command-menu.ts
index b40e71ecd0d7..52a8267b2731 100644
--- a/extensions/telegram/src/bot-native-command-menu.ts
+++ b/extensions/telegram/src/bot-native-command-menu.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot native command menu behavior.
 import { createHash } from "node:crypto";
 import type { Bot } from "grammy";
 import type { LanguageCode } from "grammy/types";
diff --git a/extensions/telegram/src/bot-native-commands.delivery.runtime.ts b/extensions/telegram/src/bot-native-commands.delivery.runtime.ts
index 6609f07fdfb9..1e98bc24ec91 100644
--- a/extensions/telegram/src/bot-native-commands.delivery.runtime.ts
+++ b/extensions/telegram/src/bot-native-commands.delivery.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot native commandselivery behavior.
 import { createChannelMessageReplyPipeline } from "openclaw/plugin-sdk/channel-outbound";
 import { deliverReplies, emitTelegramMessageSentHooks } from "./bot/delivery.js";
 
diff --git a/extensions/telegram/src/bot-native-commands.fixture-test-support.ts b/extensions/telegram/src/bot-native-commands.fixture-test-support.ts
index fb10ec7f79d2..84665835477b 100644
--- a/extensions/telegram/src/bot-native-commands.fixture-test-support.ts
+++ b/extensions/telegram/src/bot-native-commands.fixture-test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot native commands.fixture test support behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { vi } from "vitest";
 import type { OpenClawConfig, TelegramAccountConfig } from "../runtime-api.js";
diff --git a/extensions/telegram/src/bot-native-commands.group-auth.test.ts b/extensions/telegram/src/bot-native-commands.group-auth.test.ts
index 934e7ada924b..0e4d7a783f55 100644
--- a/extensions/telegram/src/bot-native-commands.group-auth.test.ts
+++ b/extensions/telegram/src/bot-native-commands.group-auth.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot native commands.group auth plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { ChannelGroupPolicy } from "openclaw/plugin-sdk/config-contracts";
 import type { TelegramAccountConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/bot-native-commands.menu-test-support.ts b/extensions/telegram/src/bot-native-commands.menu-test-support.ts
index 22322f9de5f6..389989966a21 100644
--- a/extensions/telegram/src/bot-native-commands.menu-test-support.ts
+++ b/extensions/telegram/src/bot-native-commands.menu-test-support.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot native commands.menu test support behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { expect, vi, type Mock } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
diff --git a/extensions/telegram/src/bot-native-commands.registry.test.ts b/extensions/telegram/src/bot-native-commands.registry.test.ts
index a355ee089b21..08d0666cdbd0 100644
--- a/extensions/telegram/src/bot-native-commands.registry.test.ts
+++ b/extensions/telegram/src/bot-native-commands.registry.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot native commands.registry plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { clearPluginCommands, registerPluginCommand } from "openclaw/plugin-sdk/plugin-runtime";
 import { afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";
diff --git a/extensions/telegram/src/bot-native-commands.runtime.ts b/extensions/telegram/src/bot-native-commands.runtime.ts
index af90ed4db23e..92a321bb0725 100644
--- a/extensions/telegram/src/bot-native-commands.runtime.ts
+++ b/extensions/telegram/src/bot-native-commands.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot native commands behavior.
 export {
   ensureConfiguredBindingRouteReady,
   recordInboundSessionMetaSafe,
diff --git a/extensions/telegram/src/bot-native-commands.session-meta.test.ts b/extensions/telegram/src/bot-native-commands.session-meta.test.ts
index 229fe1c74cb5..8cb0fddfc761 100644
--- a/extensions/telegram/src/bot-native-commands.session-meta.test.ts
+++ b/extensions/telegram/src/bot-native-commands.session-meta.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot native commands.session meta plugin behavior.
 import path from "node:path";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { ResolvedAgentRoute } from "openclaw/plugin-sdk/routing";
diff --git a/extensions/telegram/src/bot-native-commands.skills-allowlist.test.ts b/extensions/telegram/src/bot-native-commands.skills-allowlist.test.ts
index b4c2c79131ab..9b98df55c59d 100644
--- a/extensions/telegram/src/bot-native-commands.skills-allowlist.test.ts
+++ b/extensions/telegram/src/bot-native-commands.skills-allowlist.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot native commands.skills allowlist plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/bot-native-commands.test-helpers.ts b/extensions/telegram/src/bot-native-commands.test-helpers.ts
index 6bf39d36b6e7..c383b1292f79 100644
--- a/extensions/telegram/src/bot-native-commands.test-helpers.ts
+++ b/extensions/telegram/src/bot-native-commands.test-helpers.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports bot native commands helpers behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { ChannelGroupPolicy } from "openclaw/plugin-sdk/config-contracts";
 import type { TelegramAccountConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/bot-native-commands.test.ts b/extensions/telegram/src/bot-native-commands.test.ts
index f28bd6b8f728..5f4de16bedc1 100644
--- a/extensions/telegram/src/bot-native-commands.test.ts
+++ b/extensions/telegram/src/bot-native-commands.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot native commands plugin behavior.
 import type { OpenClawConfig, TelegramAccountConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/telegram/src/bot-native-commands.ts b/extensions/telegram/src/bot-native-commands.ts
index a98ab4cecdcd..c54b22d31c87 100644
--- a/extensions/telegram/src/bot-native-commands.ts
+++ b/extensions/telegram/src/bot-native-commands.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot native commands behavior.
 import { randomUUID } from "node:crypto";
 import path from "node:path";
 import type { Bot, Context } from "grammy";
diff --git a/extensions/telegram/src/bot-update-tracker.test.ts b/extensions/telegram/src/bot-update-tracker.test.ts
index 342e51ab6858..804fbb64e1be 100644
--- a/extensions/telegram/src/bot-update-tracker.test.ts
+++ b/extensions/telegram/src/bot-update-tracker.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot update tracker plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   createTelegramUpdateTracker,
diff --git a/extensions/telegram/src/bot-update-tracker.ts b/extensions/telegram/src/bot-update-tracker.ts
index 58c04d35d837..ca0e021121a1 100644
--- a/extensions/telegram/src/bot-update-tracker.ts
+++ b/extensions/telegram/src/bot-update-tracker.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot update tracker behavior.
 import {
   createMessageReceiveContext,
   type MessageAckPolicy,
diff --git a/extensions/telegram/src/bot-updates.ts b/extensions/telegram/src/bot-updates.ts
index 92525f38fe43..6c0a686c5d39 100644
--- a/extensions/telegram/src/bot-updates.ts
+++ b/extensions/telegram/src/bot-updates.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot updates behavior.
 import type { Message } from "grammy/types";
 import { createDedupeCache } from "openclaw/plugin-sdk/dedupe-runtime";
 import type { TelegramContext } from "./bot/types.js";
diff --git a/extensions/telegram/src/bot.agent.runtime.ts b/extensions/telegram/src/bot.agent.runtime.ts
index 9ac75c05a975..2ffad5e472cf 100644
--- a/extensions/telegram/src/bot.agent.runtime.ts
+++ b/extensions/telegram/src/bot.agent.runtime.ts
@@ -1 +1,2 @@
+// Telegram plugin module implements bot.agent behavior.
 export { resolveDefaultAgentId } from "openclaw/plugin-sdk/agent-runtime";
diff --git a/extensions/telegram/src/bot.command-menu.test.ts b/extensions/telegram/src/bot.command-menu.test.ts
index a197e84f26d2..2c0943220a8e 100644
--- a/extensions/telegram/src/bot.command-menu.test.ts
+++ b/extensions/telegram/src/bot.command-menu.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot.command menu plugin behavior.
 import {
   listNativeCommandSpecs,
   listNativeCommandSpecsForConfig,
diff --git a/extensions/telegram/src/bot.create-telegram-bot.channel-post-media.test.ts b/extensions/telegram/src/bot.create-telegram-bot.channel-post-media.test.ts
index d2e0d0ad8580..3c70781566cb 100644
--- a/extensions/telegram/src/bot.create-telegram-bot.channel-post-media.test.ts
+++ b/extensions/telegram/src/bot.create-telegram-bot.channel-post-media.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot.create telegram bot.channel post media plugin behavior.
 import { setTimeout as delay } from "node:timers/promises";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/telegram/src/bot.create-telegram-bot.media-group-skip-warning.test.ts b/extensions/telegram/src/bot.create-telegram-bot.media-group-skip-warning.test.ts
index ab9c9ff24b7a..35ab173e7c60 100644
--- a/extensions/telegram/src/bot.create-telegram-bot.media-group-skip-warning.test.ts
+++ b/extensions/telegram/src/bot.create-telegram-bot.media-group-skip-warning.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot.create telegram bot.media group skip warning plugin behavior.
 import { setTimeout as delay } from "node:timers/promises";
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/telegram/src/bot.create-telegram-bot.test-harness.ts b/extensions/telegram/src/bot.create-telegram-bot.test-harness.ts
index 05ea188c7be7..24026f4dfc27 100644
--- a/extensions/telegram/src/bot.create-telegram-bot.test-harness.ts
+++ b/extensions/telegram/src/bot.create-telegram-bot.test-harness.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot.create telegram bot harness behavior.
 import { existsSync, readdirSync, rmSync } from "node:fs";
 import path from "node:path";
 import { buildChannelInboundEventContext } from "openclaw/plugin-sdk/channel-inbound";
diff --git a/extensions/telegram/src/bot.create-telegram-bot.test.ts b/extensions/telegram/src/bot.create-telegram-bot.test.ts
index 742f823af16e..8a7aec3db62e 100644
--- a/extensions/telegram/src/bot.create-telegram-bot.test.ts
+++ b/extensions/telegram/src/bot.create-telegram-bot.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot.create telegram bot plugin behavior.
 import { escapeRegExp, formatEnvelopeTimestamp } from "openclaw/plugin-sdk/channel-test-helpers";
 import type { TelegramGroupConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { GetReplyOptions, MsgContext } from "openclaw/plugin-sdk/reply-runtime";
diff --git a/extensions/telegram/src/bot.fetch-abort.test.ts b/extensions/telegram/src/bot.fetch-abort.test.ts
index eaf19549883b..b59caa835521 100644
--- a/extensions/telegram/src/bot.fetch-abort.test.ts
+++ b/extensions/telegram/src/bot.fetch-abort.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot.fetch abort plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { getTelegramNetworkErrorOrigin } from "./network-errors.js";
 
diff --git a/extensions/telegram/src/bot.helpers.test.ts b/extensions/telegram/src/bot.helpers.test.ts
index 2bddb91ebc31..2873c3e0e818 100644
--- a/extensions/telegram/src/bot.helpers.test.ts
+++ b/extensions/telegram/src/bot.helpers.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot.helpers plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import { resolveTelegramGroupAllowFromContext, resolveTelegramStreamMode } from "./bot/helpers.js";
diff --git a/extensions/telegram/src/bot.media.downloads-media-file-path-no-file-download.e2e.test.ts b/extensions/telegram/src/bot.media.downloads-media-file-path-no-file-download.e2e.test.ts
index 379d553e76c9..3c90df3a9980 100644
--- a/extensions/telegram/src/bot.media.downloads-media-file-path-no-file-download.e2e.test.ts
+++ b/extensions/telegram/src/bot.media.downloads-media-file-path-no-file-download.e2e.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot.mediaownloads media file path no file download plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { telegramBotDepsForTest } from "./bot.media.e2e-harness.js";
 import { setNextSavedMediaPath } from "./bot.media.e2e-harness.js";
diff --git a/extensions/telegram/src/bot.media.e2e-harness.ts b/extensions/telegram/src/bot.media.e2e-harness.ts
index 374f71b939de..f5edc97477bf 100644
--- a/extensions/telegram/src/bot.media.e2e-harness.ts
+++ b/extensions/telegram/src/bot.media.e2e-harness.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot.media harness behavior.
 import { mkdtempSync, rmSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/bot.media.stickers-and-fragments.e2e.test.ts b/extensions/telegram/src/bot.media.stickers-and-fragments.e2e.test.ts
index d5aecc629306..62b5c00e3f1e 100644
--- a/extensions/telegram/src/bot.media.stickers-and-fragments.e2e.test.ts
+++ b/extensions/telegram/src/bot.media.stickers-and-fragments.e2e.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot.media.stickers and fragments plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { telegramBotDepsForTest } from "./bot.media.e2e-harness.js";
 import {
diff --git a/extensions/telegram/src/bot.media.test-utils.ts b/extensions/telegram/src/bot.media.test-utils.ts
index 4058e4c7e012..b60c85943316 100644
--- a/extensions/telegram/src/bot.media.test-utils.ts
+++ b/extensions/telegram/src/bot.media.test-utils.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports bot.media utils behavior.
 import * as ssrf from "openclaw/plugin-sdk/ssrf-runtime";
 import { afterEach, beforeAll, beforeEach, expect, vi, type Mock } from "vitest";
 import * as harness from "./bot.media.e2e-harness.js";
diff --git a/extensions/telegram/src/bot.runtime.ts b/extensions/telegram/src/bot.runtime.ts
index edcb833c3697..fcc456a2903d 100644
--- a/extensions/telegram/src/bot.runtime.ts
+++ b/extensions/telegram/src/bot.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot behavior.
 export { sequentialize } from "@grammyjs/runner";
 export { apiThrottler } from "@grammyjs/transformer-throttler";
 export { Bot } from "grammy";
diff --git a/extensions/telegram/src/bot.test.ts b/extensions/telegram/src/bot.test.ts
index 06b76cd55b8e..d04403934043 100644
--- a/extensions/telegram/src/bot.test.ts
+++ b/extensions/telegram/src/bot.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover bot plugin behavior.
 import { rm } from "node:fs/promises";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/telegram/src/bot.ts b/extensions/telegram/src/bot.ts
index 0dc84ac84d24..db50e00848b7 100644
--- a/extensions/telegram/src/bot.ts
+++ b/extensions/telegram/src/bot.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements bot behavior.
 import {
   createTelegramBotCore,
   getTelegramSequentialKey,
diff --git a/extensions/telegram/src/bot.types.ts b/extensions/telegram/src/bot.types.ts
index 98d41ae6dd5f..355fea6fccf0 100644
--- a/extensions/telegram/src/bot.types.ts
+++ b/extensions/telegram/src/bot.types.ts
@@ -1,3 +1,4 @@
+// Telegram type declarations define plugin contracts.
 import type { OpenClawConfig, ReplyToMode } from "openclaw/plugin-sdk/config-contracts";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import type { TelegramBotDeps } from "./bot-deps.js";
diff --git a/extensions/telegram/src/bot/body-helpers.ts b/extensions/telegram/src/bot/body-helpers.ts
index 041998c5ad06..142c74b7f536 100644
--- a/extensions/telegram/src/bot/body-helpers.ts
+++ b/extensions/telegram/src/bot/body-helpers.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports body helpers behavior.
 import type { Chat, Message, MessageOrigin, User } from "grammy/types";
 import type { NormalizedLocation } from "openclaw/plugin-sdk/channel-inbound";
 import {
diff --git a/extensions/telegram/src/bot/delivery.replies.ts b/extensions/telegram/src/bot/delivery.replies.ts
index 864a9b486b4e..8e2743763c92 100644
--- a/extensions/telegram/src/bot/delivery.replies.ts
+++ b/extensions/telegram/src/bot/delivery.replies.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements delivery.replies behavior.
 import { type Bot, GrammyError, InputFile } from "grammy";
 import {
   createOutboundPayloadPlan,
diff --git a/extensions/telegram/src/bot/delivery.resolve-media-retry.test.ts b/extensions/telegram/src/bot/delivery.resolve-media-retry.test.ts
index b4c0ade34d5a..2b8d66279828 100644
--- a/extensions/telegram/src/bot/delivery.resolve-media-retry.test.ts
+++ b/extensions/telegram/src/bot/delivery.resolve-media-retry.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover delivery.resolve media retry plugin behavior.
 import type { Message } from "grammy/types";
 import { retryAsync } from "openclaw/plugin-sdk/retry-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/telegram/src/bot/delivery.resolve-media.runtime.ts b/extensions/telegram/src/bot/delivery.resolve-media.runtime.ts
index d45a8eae7f4b..cf7c47476342 100644
--- a/extensions/telegram/src/bot/delivery.resolve-media.runtime.ts
+++ b/extensions/telegram/src/bot/delivery.resolve-media.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements delivery.resolve media behavior.
 import { logVerbose, retryAsync, warn } from "openclaw/plugin-sdk/runtime-env";
 import { formatErrorMessage } from "openclaw/plugin-sdk/ssrf-runtime";
 import { resolveTelegramApiBase, shouldRetryTelegramTransportFallback } from "../fetch.js";
diff --git a/extensions/telegram/src/bot/delivery.resolve-media.ts b/extensions/telegram/src/bot/delivery.resolve-media.ts
index b1e4c2bca3fb..eb05c6ff7f67 100644
--- a/extensions/telegram/src/bot/delivery.resolve-media.ts
+++ b/extensions/telegram/src/bot/delivery.resolve-media.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements delivery.resolve media behavior.
 import path from "node:path";
 import { GrammyError } from "grammy";
 import { root as fsRoot } from "openclaw/plugin-sdk/file-access-runtime";
diff --git a/extensions/telegram/src/bot/delivery.send.ts b/extensions/telegram/src/bot/delivery.send.ts
index daf7926c63b3..d508c5052480 100644
--- a/extensions/telegram/src/bot/delivery.send.ts
+++ b/extensions/telegram/src/bot/delivery.send.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements delivery.send behavior.
 import { type Bot, GrammyError } from "grammy";
 import { createTelegramRetryRunner } from "openclaw/plugin-sdk/retry-runtime";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/telegram/src/bot/delivery.test.ts b/extensions/telegram/src/bot/delivery.test.ts
index 2f79ad2df771..1939b658c7db 100644
--- a/extensions/telegram/src/bot/delivery.test.ts
+++ b/extensions/telegram/src/bot/delivery.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover delivery plugin behavior.
 import type { Bot } from "grammy";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/telegram/src/bot/delivery.ts b/extensions/telegram/src/bot/delivery.ts
index e16460d79486..edec1ccd0294 100644
--- a/extensions/telegram/src/bot/delivery.ts
+++ b/extensions/telegram/src/bot/delivery.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements delivery behavior.
 export {
   deliverReplies,
   emitInternalMessageSentHook,
diff --git a/extensions/telegram/src/bot/helpers.test.ts b/extensions/telegram/src/bot/helpers.test.ts
index 037d3fc55af9..89aaef8ae516 100644
--- a/extensions/telegram/src/bot/helpers.test.ts
+++ b/extensions/telegram/src/bot/helpers.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover helpers plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   buildTelegramInboundOriginTarget,
diff --git a/extensions/telegram/src/bot/helpers.ts b/extensions/telegram/src/bot/helpers.ts
index beb448f5e489..4f26114d5ed8 100644
--- a/extensions/telegram/src/bot/helpers.ts
+++ b/extensions/telegram/src/bot/helpers.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports helpers behavior.
 import type { Chat, Message } from "grammy/types";
 import { formatLocationText } from "openclaw/plugin-sdk/channel-inbound";
 import {
diff --git a/extensions/telegram/src/bot/native-quote.test.ts b/extensions/telegram/src/bot/native-quote.test.ts
index ad53992fa59f..fa16088030ad 100644
--- a/extensions/telegram/src/bot/native-quote.test.ts
+++ b/extensions/telegram/src/bot/native-quote.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover native quote plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildTelegramNativeQuoteCandidate } from "./native-quote.js";
 
diff --git a/extensions/telegram/src/bot/native-quote.ts b/extensions/telegram/src/bot/native-quote.ts
index 1e7a58a27783..b3cf4e101f28 100644
--- a/extensions/telegram/src/bot/native-quote.ts
+++ b/extensions/telegram/src/bot/native-quote.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements native quote behavior.
 import type { TelegramTextEntity } from "./body-helpers.js";
 
 const TELEGRAM_NATIVE_QUOTE_MAX_LENGTH = 1024;
diff --git a/extensions/telegram/src/bot/reply-threading.ts b/extensions/telegram/src/bot/reply-threading.ts
index a9b5370ae847..58bcde31f104 100644
--- a/extensions/telegram/src/bot/reply-threading.ts
+++ b/extensions/telegram/src/bot/reply-threading.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements reply threading behavior.
 import type { ReplyToMode } from "openclaw/plugin-sdk/config-contracts";
 
 export type DeliveryProgress = {
diff --git a/extensions/telegram/src/bot/types.ts b/extensions/telegram/src/bot/types.ts
index 1cea24e99bbe..acf7043a92ff 100644
--- a/extensions/telegram/src/bot/types.ts
+++ b/extensions/telegram/src/bot/types.ts
@@ -1,3 +1,4 @@
+// Telegram type declarations define plugin contracts.
 import type { ChatFullInfo, Message, UserFromGetMe } from "grammy/types";
 
 /** App-specific stream mode for Telegram stream previews. */
diff --git a/extensions/telegram/src/button-types.test-helpers.ts b/extensions/telegram/src/button-types.test-helpers.ts
index d80f4dbcc528..025bc18e190a 100644
--- a/extensions/telegram/src/button-types.test-helpers.ts
+++ b/extensions/telegram/src/button-types.test-helpers.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports button types helpers behavior.
 import { describe, expect, it } from "vitest";
 import { buildTelegramInteractiveButtons, resolveTelegramInlineButtons } from "./button-types.js";
 
diff --git a/extensions/telegram/src/button-types.test.ts b/extensions/telegram/src/button-types.test.ts
index 1872881b367d..61281c35347e 100644
--- a/extensions/telegram/src/button-types.test.ts
+++ b/extensions/telegram/src/button-types.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover button types plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildTelegramInteractiveButtons,
diff --git a/extensions/telegram/src/button-types.ts b/extensions/telegram/src/button-types.ts
index 9cbad71081d4..d093c67d3835 100644
--- a/extensions/telegram/src/button-types.ts
+++ b/extensions/telegram/src/button-types.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements button types behavior.
 import { parseExecApprovalCommandText } from "openclaw/plugin-sdk/approval-reply-runtime";
 import { reduceInteractiveReply } from "openclaw/plugin-sdk/interactive-runtime";
 import {
diff --git a/extensions/telegram/src/caption.ts b/extensions/telegram/src/caption.ts
index e9981c8c4256..b24fc9edd9ec 100644
--- a/extensions/telegram/src/caption.ts
+++ b/extensions/telegram/src/caption.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements caption behavior.
 export const TELEGRAM_MAX_CAPTION_LENGTH = 1024;
 
 export function splitTelegramCaption(text?: string): {
diff --git a/extensions/telegram/src/channel-actions.contract.test.ts b/extensions/telegram/src/channel-actions.contract.test.ts
index 8fa02f9df573..0eedb773db09 100644
--- a/extensions/telegram/src/channel-actions.contract.test.ts
+++ b/extensions/telegram/src/channel-actions.contract.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover channel actions.contract plugin behavior.
 import { installChannelActionsContractSuite } from "openclaw/plugin-sdk/channel-test-helpers";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe } from "vitest";
diff --git a/extensions/telegram/src/channel-actions.test.ts b/extensions/telegram/src/channel-actions.test.ts
index fbcde4bc9031..be3a7977ec41 100644
--- a/extensions/telegram/src/channel-actions.test.ts
+++ b/extensions/telegram/src/channel-actions.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover channel actions plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { telegramMessageActions, telegramMessageActionRuntime } from "./channel-actions.js";
diff --git a/extensions/telegram/src/channel-actions.ts b/extensions/telegram/src/channel-actions.ts
index cdb9e219a5ef..6053fbdf685c 100644
--- a/extensions/telegram/src/channel-actions.ts
+++ b/extensions/telegram/src/channel-actions.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements channel actions behavior.
 import {
   createUnionActionGate,
   listTokenSourcedAccounts,
diff --git a/extensions/telegram/src/channel.gateway.test.ts b/extensions/telegram/src/channel.gateway.test.ts
index bedc567c6884..3a5fbddba74d 100644
--- a/extensions/telegram/src/channel.gateway.test.ts
+++ b/extensions/telegram/src/channel.gateway.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover channel.gateway plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/channel.message-adapter.test.ts b/extensions/telegram/src/channel.message-adapter.test.ts
index 111da055437b..60c2292eecb2 100644
--- a/extensions/telegram/src/channel.message-adapter.test.ts
+++ b/extensions/telegram/src/channel.message-adapter.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover channel.message adapter plugin behavior.
 import {
   verifyChannelMessageAdapterCapabilityProofs,
   verifyChannelMessageLiveCapabilityAdapterProofs,
diff --git a/extensions/telegram/src/channel.setup.ts b/extensions/telegram/src/channel.setup.ts
index 1b3808433e2e..e3a1b537483e 100644
--- a/extensions/telegram/src/channel.setup.ts
+++ b/extensions/telegram/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements channel.setup behavior.
 import type { ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import type { ResolvedTelegramAccount } from "./accounts.js";
 import type { TelegramProbe } from "./probe.js";
diff --git a/extensions/telegram/src/channel.ts b/extensions/telegram/src/channel.ts
index 2d633c7c4783..baace59d485d 100644
--- a/extensions/telegram/src/channel.ts
+++ b/extensions/telegram/src/channel.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements channel behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import {
   buildDmGroupAccountAllowlistAdapter,
diff --git a/extensions/telegram/src/client-fetch.ts b/extensions/telegram/src/client-fetch.ts
index aee6d8cde593..4dfd3b9b7dda 100644
--- a/extensions/telegram/src/client-fetch.ts
+++ b/extensions/telegram/src/client-fetch.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements client fetch behavior.
 import type { ApiClientOptions } from "grammy";
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { TelegramTransport } from "./fetch.js";
diff --git a/extensions/telegram/src/command-config.ts b/extensions/telegram/src/command-config.ts
index 6491980d478e..492a0b207201 100644
--- a/extensions/telegram/src/command-config.ts
+++ b/extensions/telegram/src/command-config.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports command config behavior.
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 export const TELEGRAM_COMMAND_NAME_PATTERN = /^[a-z0-9_]{1,32}$/;
diff --git a/extensions/telegram/src/command-ui.test.ts b/extensions/telegram/src/command-ui.test.ts
index a53d247f983f..3663ddbfb8ef 100644
--- a/extensions/telegram/src/command-ui.test.ts
+++ b/extensions/telegram/src/command-ui.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover command ui plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildCommandsPaginationKeyboard } from "./command-ui.js";
 
diff --git a/extensions/telegram/src/command-ui.ts b/extensions/telegram/src/command-ui.ts
index ce5afd8f698f..fa26c3215d4c 100644
--- a/extensions/telegram/src/command-ui.ts
+++ b/extensions/telegram/src/command-ui.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements command ui behavior.
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import {
   buildBrowseProvidersButton,
diff --git a/extensions/telegram/src/config-schema.test.ts b/extensions/telegram/src/config-schema.test.ts
index 8530dbbf5718..a483bdec7f79 100644
--- a/extensions/telegram/src/config-schema.test.ts
+++ b/extensions/telegram/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { TelegramConfigSchema } from "../config-api.js";
 
diff --git a/extensions/telegram/src/config-schema.ts b/extensions/telegram/src/config-schema.ts
index a4f3b2ad043d..ec435dbc031b 100644
--- a/extensions/telegram/src/config-schema.ts
+++ b/extensions/telegram/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports config schema behavior.
 import { buildChannelConfigSchema, TelegramConfigSchema } from "../config-api.js";
 import { telegramChannelConfigUiHints } from "./config-ui-hints.js";
 
diff --git a/extensions/telegram/src/config-ui-hints.ts b/extensions/telegram/src/config-ui-hints.ts
index 8d14b1fe826d..7e97265e75c1 100644
--- a/extensions/telegram/src/config-ui-hints.ts
+++ b/extensions/telegram/src/config-ui-hints.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports config ui hints behavior.
 import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/channel-core";
 
 export const telegramChannelConfigUiHints = {
diff --git a/extensions/telegram/src/conversation-route.base-session-key.test.ts b/extensions/telegram/src/conversation-route.base-session-key.test.ts
index 37bc4b4e779e..6e79f9725adc 100644
--- a/extensions/telegram/src/conversation-route.base-session-key.test.ts
+++ b/extensions/telegram/src/conversation-route.base-session-key.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover conversation route.base session key plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   testing as conversationBindingTesting,
diff --git a/extensions/telegram/src/conversation-route.ts b/extensions/telegram/src/conversation-route.ts
index d190c0b6593f..ab778c5e74bc 100644
--- a/extensions/telegram/src/conversation-route.ts
+++ b/extensions/telegram/src/conversation-route.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements conversation route behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   resolveConfiguredBindingRoute,
diff --git a/extensions/telegram/src/directory-config.ts b/extensions/telegram/src/directory-config.ts
index 9e18ad06141f..8a6e859eba0e 100644
--- a/extensions/telegram/src/directory-config.ts
+++ b/extensions/telegram/src/directory-config.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports directory config behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-core";
 import { mapAllowFromEntries } from "openclaw/plugin-sdk/channel-config-helpers";
 import type { OpenClawConfig, TelegramAccountConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/directory-contract.test.ts b/extensions/telegram/src/directory-contract.test.ts
index 8c027e838b33..861614ae150b 100644
--- a/extensions/telegram/src/directory-contract.test.ts
+++ b/extensions/telegram/src/directory-contract.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover directory contract plugin behavior.
 import type { BaseProbeResult, BaseTokenResolution } from "openclaw/plugin-sdk/channel-contract";
 import { expectDirectoryIds } from "openclaw/plugin-sdk/channel-test-helpers";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/dm-access.test.ts b/extensions/telegram/src/dm-access.test.ts
index ed60304f630c..d913a8324038 100644
--- a/extensions/telegram/src/dm-access.test.ts
+++ b/extensions/telegram/src/dm-access.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover dm access plugin behavior.
 import type { createChannelPairingChallengeIssuer } from "openclaw/plugin-sdk/channel-pairing";
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/telegram/src/dm-access.ts b/extensions/telegram/src/dm-access.ts
index a1bd7a95890b..2b50ddec49c1 100644
--- a/extensions/telegram/src/dm-access.ts
+++ b/extensions/telegram/src/dm-access.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements dm access behavior.
 import type { Bot } from "grammy";
 import type { Message } from "grammy/types";
 import { createChannelPairingChallengeIssuer } from "openclaw/plugin-sdk/channel-pairing";
diff --git a/extensions/telegram/src/doctor-contract.ts b/extensions/telegram/src/doctor-contract.ts
index a8f0c9c4c2c8..ffb910f114bb 100644
--- a/extensions/telegram/src/doctor-contract.ts
+++ b/extensions/telegram/src/doctor-contract.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements doctor contract behavior.
 import type {
   ChannelDoctorConfigMutation,
   ChannelDoctorLegacyConfigRule,
diff --git a/extensions/telegram/src/doctor.test.ts b/extensions/telegram/src/doctor.test.ts
index 429bbc6d31ae..50cd93bbc6bf 100644
--- a/extensions/telegram/src/doctor.test.ts
+++ b/extensions/telegram/src/doctor.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover doctor plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/telegram/src/doctor.ts b/extensions/telegram/src/doctor.ts
index 5c5cbe2bb951..e64252e59fa9 100644
--- a/extensions/telegram/src/doctor.ts
+++ b/extensions/telegram/src/doctor.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements doctor behavior.
 import type {
   ChannelDoctorAdapter,
   ChannelDoctorEmptyAllowlistAccountContext,
diff --git a/extensions/telegram/src/draft-chunking.ts b/extensions/telegram/src/draft-chunking.ts
index 763c9289b32d..47d7f678b689 100644
--- a/extensions/telegram/src/draft-chunking.ts
+++ b/extensions/telegram/src/draft-chunking.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements draft chunking behavior.
 import { resolveChannelStreamingPreviewChunk } from "openclaw/plugin-sdk/channel-outbound";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolveTextChunkLimit } from "openclaw/plugin-sdk/reply-chunking";
diff --git a/extensions/telegram/src/draft-stream.test-helpers.ts b/extensions/telegram/src/draft-stream.test-helpers.ts
index 94dd471c4467..fc8cec31c257 100644
--- a/extensions/telegram/src/draft-stream.test-helpers.ts
+++ b/extensions/telegram/src/draft-stream.test-helpers.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports draft stream helpers behavior.
 import { vi } from "vitest";
 
 type TestDraftStream = {
diff --git a/extensions/telegram/src/draft-stream.test.ts b/extensions/telegram/src/draft-stream.test.ts
index 2a1e769b6284..7e922c4d4e03 100644
--- a/extensions/telegram/src/draft-stream.test.ts
+++ b/extensions/telegram/src/draft-stream.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover draft stream plugin behavior.
 import type { Bot } from "grammy";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { createTelegramDraftStream } from "./draft-stream.js";
diff --git a/extensions/telegram/src/draft-stream.ts b/extensions/telegram/src/draft-stream.ts
index abc5630086f7..dd0effe3e59e 100644
--- a/extensions/telegram/src/draft-stream.ts
+++ b/extensions/telegram/src/draft-stream.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements draft stream behavior.
 import type { Bot } from "grammy";
 import {
   createFinalizableDraftStreamControlsForState,
diff --git a/extensions/telegram/src/error-policy.test.ts b/extensions/telegram/src/error-policy.test.ts
index 69c58e2f9194..21a72924118c 100644
--- a/extensions/telegram/src/error-policy.test.ts
+++ b/extensions/telegram/src/error-policy.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover error policy plugin behavior.
 import { MAX_DATE_TIMESTAMP_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/telegram/src/error-policy.ts b/extensions/telegram/src/error-policy.ts
index b7a01547945b..a962faec8298 100644
--- a/extensions/telegram/src/error-policy.ts
+++ b/extensions/telegram/src/error-policy.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements error policy behavior.
 import type {
   TelegramAccountConfig,
   TelegramDirectConfig,
diff --git a/extensions/telegram/src/exec-approval-forwarding.ts b/extensions/telegram/src/exec-approval-forwarding.ts
index 8de4d1127d70..8919c7cb0980 100644
--- a/extensions/telegram/src/exec-approval-forwarding.ts
+++ b/extensions/telegram/src/exec-approval-forwarding.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements exec approval forwarding behavior.
 import {
   buildExecApprovalPendingReplyPayload,
   resolveExecApprovalRequestAllowedDecisions,
diff --git a/extensions/telegram/src/exec-approval-resolver.test.ts b/extensions/telegram/src/exec-approval-resolver.test.ts
index fe847e48121a..1f6adad25283 100644
--- a/extensions/telegram/src/exec-approval-resolver.test.ts
+++ b/extensions/telegram/src/exec-approval-resolver.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover exec approval resolver plugin behavior.
 import type { ExecApprovalReplyDecision } from "openclaw/plugin-sdk/approval-reply-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/telegram/src/exec-approval-resolver.ts b/extensions/telegram/src/exec-approval-resolver.ts
index 7481253c1d23..ae88313dd122 100644
--- a/extensions/telegram/src/exec-approval-resolver.ts
+++ b/extensions/telegram/src/exec-approval-resolver.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements exec approval resolver behavior.
 import { resolveApprovalOverGateway } from "openclaw/plugin-sdk/approval-gateway-runtime";
 import type { ExecApprovalReplyDecision } from "openclaw/plugin-sdk/approval-reply-runtime";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/exec-approvals.test.ts b/extensions/telegram/src/exec-approvals.test.ts
index c378b265995a..5ecc5b35fb09 100644
--- a/extensions/telegram/src/exec-approvals.test.ts
+++ b/extensions/telegram/src/exec-approvals.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover exec approvals plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/exec-approvals.ts b/extensions/telegram/src/exec-approvals.ts
index 0bf7bb405f48..8f0eb5d5305d 100644
--- a/extensions/telegram/src/exec-approvals.ts
+++ b/extensions/telegram/src/exec-approvals.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements exec approvals behavior.
 import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 import {
   createChannelExecApprovalProfile,
diff --git a/extensions/telegram/src/fetch.test.ts b/extensions/telegram/src/fetch.test.ts
index 91c5177569f6..b662526ff397 100644
--- a/extensions/telegram/src/fetch.test.ts
+++ b/extensions/telegram/src/fetch.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover fetch plugin behavior.
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/fetch.ts b/extensions/telegram/src/fetch.ts
index c98f69bdc61f..042ebef31d20 100644
--- a/extensions/telegram/src/fetch.ts
+++ b/extensions/telegram/src/fetch.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements fetch behavior.
 import { randomUUID } from "node:crypto";
 import * as dns from "node:dns";
 import type { TelegramNetworkConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/format.test.ts b/extensions/telegram/src/format.test.ts
index 3f688acd180f..61c884c26bd6 100644
--- a/extensions/telegram/src/format.test.ts
+++ b/extensions/telegram/src/format.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover format plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   markdownToTelegramChunks,
diff --git a/extensions/telegram/src/format.ts b/extensions/telegram/src/format.ts
index f5b9803060dd..f121244c0d5a 100644
--- a/extensions/telegram/src/format.ts
+++ b/extensions/telegram/src/format.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports format behavior.
 import type { MarkdownTableMode } from "openclaw/plugin-sdk/config-contracts";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
diff --git a/extensions/telegram/src/format.wrap-md.test.ts b/extensions/telegram/src/format.wrap-md.test.ts
index 3808d8edd7cf..ab7e8c74a9ac 100644
--- a/extensions/telegram/src/format.wrap-md.test.ts
+++ b/extensions/telegram/src/format.wrap-md.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover format.wrap md plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   markdownToTelegramChunks,
diff --git a/extensions/telegram/src/group-access.base-access.test.ts b/extensions/telegram/src/group-access.base-access.test.ts
index 89f20fe67ab7..e689fed24efd 100644
--- a/extensions/telegram/src/group-access.base-access.test.ts
+++ b/extensions/telegram/src/group-access.base-access.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover group access.base access plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { TelegramAccountConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/telegram/src/group-access.ts b/extensions/telegram/src/group-access.ts
index 49affac158cb..0e15c0a27c43 100644
--- a/extensions/telegram/src/group-access.ts
+++ b/extensions/telegram/src/group-access.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements group access behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { ChannelGroupPolicy } from "openclaw/plugin-sdk/config-contracts";
 import type {
diff --git a/extensions/telegram/src/group-config-helpers.ts b/extensions/telegram/src/group-config-helpers.ts
index 69f371e8e94e..a1843a2ce58e 100644
--- a/extensions/telegram/src/group-config-helpers.ts
+++ b/extensions/telegram/src/group-config-helpers.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports group config helpers behavior.
 import type {
   TelegramDirectConfig,
   TelegramGroupConfig,
diff --git a/extensions/telegram/src/group-migration.test.ts b/extensions/telegram/src/group-migration.test.ts
index 12375f7cfabd..40a4f06a3976 100644
--- a/extensions/telegram/src/group-migration.test.ts
+++ b/extensions/telegram/src/group-migration.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover group migration plugin behavior.
 import { describe, expect, it } from "vitest";
 import { migrateTelegramGroupConfig, migrateTelegramGroupsInPlace } from "./group-migration.js";
 
diff --git a/extensions/telegram/src/group-migration.ts b/extensions/telegram/src/group-migration.ts
index b54060e4aa93..f5fde07728e9 100644
--- a/extensions/telegram/src/group-migration.ts
+++ b/extensions/telegram/src/group-migration.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements group migration behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { TelegramGroupConfig } from "openclaw/plugin-sdk/config-contracts";
 import { normalizeAccountId } from "openclaw/plugin-sdk/routing";
diff --git a/extensions/telegram/src/group-policy.test.ts b/extensions/telegram/src/group-policy.test.ts
index a270c44d845a..04f0062bdf7c 100644
--- a/extensions/telegram/src/group-policy.test.ts
+++ b/extensions/telegram/src/group-policy.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover group policy plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/telegram/src/group-policy.ts b/extensions/telegram/src/group-policy.ts
index 033619ebcda0..0847034078ac 100644
--- a/extensions/telegram/src/group-policy.ts
+++ b/extensions/telegram/src/group-policy.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements group policy behavior.
 import type { ChannelGroupContext } from "openclaw/plugin-sdk/channel-contract";
 import {
   resolveChannelGroupRequireMention,
diff --git a/extensions/telegram/src/inbound-context.contract.test.ts b/extensions/telegram/src/inbound-context.contract.test.ts
index 38d6434a43d3..c6f0b4fb64c6 100644
--- a/extensions/telegram/src/inbound-context.contract.test.ts
+++ b/extensions/telegram/src/inbound-context.contract.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover inbound context.contract plugin behavior.
 import { expectChannelInboundContextContract } from "openclaw/plugin-sdk/channel-contract-testing";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, it } from "vitest";
diff --git a/extensions/telegram/src/inbound-event-delivery.test.ts b/extensions/telegram/src/inbound-event-delivery.test.ts
index 4590d015adcd..4ebabe4230fa 100644
--- a/extensions/telegram/src/inbound-event-delivery.test.ts
+++ b/extensions/telegram/src/inbound-event-delivery.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover inbound event delivery plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   beginTelegramInboundEventDeliveryCorrelation,
diff --git a/extensions/telegram/src/inbound-event-delivery.ts b/extensions/telegram/src/inbound-event-delivery.ts
index 07742f3c5456..75df639e24b3 100644
--- a/extensions/telegram/src/inbound-event-delivery.ts
+++ b/extensions/telegram/src/inbound-event-delivery.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements inbound event delivery behavior.
 import { stripTelegramInternalPrefixes } from "./targets.js";
 
 export type TelegramInboundEventDeliveryEnd = () => void;
diff --git a/extensions/telegram/src/ingress.ts b/extensions/telegram/src/ingress.ts
index bfbb637f2b9d..18a6092b18f5 100644
--- a/extensions/telegram/src/ingress.ts
+++ b/extensions/telegram/src/ingress.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements ingress behavior.
 import {
   createChannelIngressResolver,
   defineStableChannelIngressIdentity,
diff --git a/extensions/telegram/src/inline-buttons.test.ts b/extensions/telegram/src/inline-buttons.test.ts
index 4ef8a6e99d33..74c6122e66de 100644
--- a/extensions/telegram/src/inline-buttons.test.ts
+++ b/extensions/telegram/src/inline-buttons.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover inline buttons plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
 import { describe, expect, it } from "vitest";
 import { buildTelegramInteractiveButtons } from "./button-types.js";
diff --git a/extensions/telegram/src/inline-buttons.ts b/extensions/telegram/src/inline-buttons.ts
index 4d2743f28ffc..df74cef0d0c6 100644
--- a/extensions/telegram/src/inline-buttons.ts
+++ b/extensions/telegram/src/inline-buttons.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements inline buttons behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { TelegramInlineButtonsScope } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/telegram/src/inline-keyboard.ts b/extensions/telegram/src/inline-keyboard.ts
index 5b4f2b3ed77e..2dc2b697fcfc 100644
--- a/extensions/telegram/src/inline-keyboard.ts
+++ b/extensions/telegram/src/inline-keyboard.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements inline keyboard behavior.
 import type { InlineKeyboardButton, InlineKeyboardMarkup } from "grammy/types";
 import type { TelegramInlineButtons } from "./button-types.js";
 
diff --git a/extensions/telegram/src/interactive-dispatch.ts b/extensions/telegram/src/interactive-dispatch.ts
index 9749bd16eb68..21f38f90f298 100644
--- a/extensions/telegram/src/interactive-dispatch.ts
+++ b/extensions/telegram/src/interactive-dispatch.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements interactive dispatch behavior.
 import {
   createInteractiveConversationBindingHelpers,
   dispatchPluginInteractiveHandler,
diff --git a/extensions/telegram/src/interactive-fallback.ts b/extensions/telegram/src/interactive-fallback.ts
index fb8dbd5ac64f..743bbf0fc6dc 100644
--- a/extensions/telegram/src/interactive-fallback.ts
+++ b/extensions/telegram/src/interactive-fallback.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements interactive fallback behavior.
 import {
   interactiveReplyToPresentation,
   normalizeMessagePresentation,
diff --git a/extensions/telegram/src/lane-delivery-state.ts b/extensions/telegram/src/lane-delivery-state.ts
index 3801cf5da6ed..5226ce731375 100644
--- a/extensions/telegram/src/lane-delivery-state.ts
+++ b/extensions/telegram/src/lane-delivery-state.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements lane delivery state behavior.
 type LaneDeliverySnapshot = {
   delivered: boolean;
   skippedNonSilent: number;
diff --git a/extensions/telegram/src/lane-delivery-text-deliverer.ts b/extensions/telegram/src/lane-delivery-text-deliverer.ts
index a4fd2e0d0485..3113afbd3a23 100644
--- a/extensions/telegram/src/lane-delivery-text-deliverer.ts
+++ b/extensions/telegram/src/lane-delivery-text-deliverer.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements lane delivery text deliverer behavior.
 import {
   createPreviewMessageReceipt,
   type MessageReceipt,
diff --git a/extensions/telegram/src/lane-delivery.test.ts b/extensions/telegram/src/lane-delivery.test.ts
index 6813d0ae614d..fa00a011cc62 100644
--- a/extensions/telegram/src/lane-delivery.test.ts
+++ b/extensions/telegram/src/lane-delivery.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover lane delivery plugin behavior.
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import { describe, expect, it, vi } from "vitest";
 import { createTestDraftStream } from "./draft-stream.test-helpers.js";
diff --git a/extensions/telegram/src/lane-delivery.ts b/extensions/telegram/src/lane-delivery.ts
index ea412750aa65..a0adda36e447 100644
--- a/extensions/telegram/src/lane-delivery.ts
+++ b/extensions/telegram/src/lane-delivery.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements lane delivery behavior.
 export {
   isPotentialTruncatedFinal,
   selectLongerFinalText,
diff --git a/extensions/telegram/src/media-understanding.runtime.ts b/extensions/telegram/src/media-understanding.runtime.ts
index 3048178f06d1..91a1f143a1b8 100644
--- a/extensions/telegram/src/media-understanding.runtime.ts
+++ b/extensions/telegram/src/media-understanding.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements media understanding behavior.
 import {
   describeImageWithModel as describeImageWithModelImpl,
   transcribeFirstAudio as transcribeFirstAudioImpl,
diff --git a/extensions/telegram/src/message-cache.test.ts b/extensions/telegram/src/message-cache.test.ts
index 3ba0199c65f7..81ace8effc04 100644
--- a/extensions/telegram/src/message-cache.test.ts
+++ b/extensions/telegram/src/message-cache.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover message cache plugin behavior.
 import { rm, writeFile } from "node:fs/promises";
 import type { Message } from "grammy/types";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/telegram/src/message-cache.ts b/extensions/telegram/src/message-cache.ts
index 774bfdbd283c..256a466c56f7 100644
--- a/extensions/telegram/src/message-cache.ts
+++ b/extensions/telegram/src/message-cache.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements message cache behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs";
 import type { Message } from "grammy/types";
diff --git a/extensions/telegram/src/message-dispatch-dedupe.test.ts b/extensions/telegram/src/message-dispatch-dedupe.test.ts
index 8f5335b99f4d..77b279f1629f 100644
--- a/extensions/telegram/src/message-dispatch-dedupe.test.ts
+++ b/extensions/telegram/src/message-dispatch-dedupe.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover message dispatch dedupe plugin behavior.
 import { mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/message-dispatch-dedupe.ts b/extensions/telegram/src/message-dispatch-dedupe.ts
index 87a35528ca01..dfa3879f0519 100644
--- a/extensions/telegram/src/message-dispatch-dedupe.ts
+++ b/extensions/telegram/src/message-dispatch-dedupe.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements message dispatch dedupe behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
diff --git a/extensions/telegram/src/message-tool-schema.ts b/extensions/telegram/src/message-tool-schema.ts
index 94f27216a1f9..767e45a493c9 100644
--- a/extensions/telegram/src/message-tool-schema.ts
+++ b/extensions/telegram/src/message-tool-schema.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports message tool schema behavior.
 import { optionalPositiveIntegerSchema } from "openclaw/plugin-sdk/channel-actions";
 import { Type } from "typebox";
 
diff --git a/extensions/telegram/src/model-buttons.test.ts b/extensions/telegram/src/model-buttons.test.ts
index 51860e3266cb..b795a5219845 100644
--- a/extensions/telegram/src/model-buttons.test.ts
+++ b/extensions/telegram/src/model-buttons.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover model buttons plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildModelSelectionCallbackData,
diff --git a/extensions/telegram/src/monitor-polling.runtime.ts b/extensions/telegram/src/monitor-polling.runtime.ts
index 749f0263023a..9ab92b6fe978 100644
--- a/extensions/telegram/src/monitor-polling.runtime.ts
+++ b/extensions/telegram/src/monitor-polling.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements monitor polling behavior.
 export { TelegramPollingSession } from "./polling-session.js";
 export {
   deleteTelegramUpdateOffset,
diff --git a/extensions/telegram/src/monitor-webhook.runtime.ts b/extensions/telegram/src/monitor-webhook.runtime.ts
index 6abb9dee112b..05641d670544 100644
--- a/extensions/telegram/src/monitor-webhook.runtime.ts
+++ b/extensions/telegram/src/monitor-webhook.runtime.ts
@@ -1 +1,2 @@
+// Telegram plugin module implements monitor webhook behavior.
 export { startTelegramWebhook } from "./webhook.js";
diff --git a/extensions/telegram/src/monitor.test.ts b/extensions/telegram/src/monitor.test.ts
index adb5cd24ebab..1214013de317 100644
--- a/extensions/telegram/src/monitor.test.ts
+++ b/extensions/telegram/src/monitor.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover monitor plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 type MonitorTelegramOpts = import("./monitor.js").MonitorTelegramOpts;
diff --git a/extensions/telegram/src/monitor.ts b/extensions/telegram/src/monitor.ts
index 292d586bd2f2..3a8234d8c7b0 100644
--- a/extensions/telegram/src/monitor.ts
+++ b/extensions/telegram/src/monitor.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements monitor behavior.
 import type { RunOptions } from "@grammyjs/runner";
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 import { registerChannelRuntimeContext } from "openclaw/plugin-sdk/channel-runtime-context";
diff --git a/extensions/telegram/src/monitor.types.ts b/extensions/telegram/src/monitor.types.ts
index ab3f277824f4..6f6a67bb2376 100644
--- a/extensions/telegram/src/monitor.types.ts
+++ b/extensions/telegram/src/monitor.types.ts
@@ -1,3 +1,4 @@
+// Telegram type declarations define plugin contracts.
 import type {
   ChannelAccountSnapshot,
   ChannelRuntimeSurface,
diff --git a/extensions/telegram/src/native-command-callback-data.ts b/extensions/telegram/src/native-command-callback-data.ts
index 9e0297d1583f..6aa3a869a6ef 100644
--- a/extensions/telegram/src/native-command-callback-data.ts
+++ b/extensions/telegram/src/native-command-callback-data.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements native command callback data behavior.
 const TELEGRAM_NATIVE_COMMAND_CALLBACK_PREFIX = "tgcmd:";
 const TELEGRAM_OPAQUE_CALLBACK_PREFIX = "tgcb1:";
 
diff --git a/extensions/telegram/src/native-tool-progress-draft.test.ts b/extensions/telegram/src/native-tool-progress-draft.test.ts
index 4cf54d472af5..9b18e386ff84 100644
--- a/extensions/telegram/src/native-tool-progress-draft.test.ts
+++ b/extensions/telegram/src/native-tool-progress-draft.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover native tool progress draft plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createNativeTelegramToolProgressDraft } from "./native-tool-progress-draft.js";
 
diff --git a/extensions/telegram/src/native-tool-progress-draft.ts b/extensions/telegram/src/native-tool-progress-draft.ts
index 967fef662e89..9e731264639b 100644
--- a/extensions/telegram/src/native-tool-progress-draft.ts
+++ b/extensions/telegram/src/native-tool-progress-draft.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements native tool progress draft behavior.
 import type { Bot } from "grammy";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { buildTelegramThreadParams, type TelegramThreadSpec } from "./bot/helpers.js";
diff --git a/extensions/telegram/src/network-config.test.ts b/extensions/telegram/src/network-config.test.ts
index 5b635d413148..c34cfacfcce5 100644
--- a/extensions/telegram/src/network-config.test.ts
+++ b/extensions/telegram/src/network-config.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover network config plugin behavior.
 import type { TelegramNetworkConfig } from "openclaw/plugin-sdk/config-contracts";
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/telegram/src/network-config.ts b/extensions/telegram/src/network-config.ts
index 6d90b269f0c4..22dce41e8ef1 100644
--- a/extensions/telegram/src/network-config.ts
+++ b/extensions/telegram/src/network-config.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports network config behavior.
 import * as dns from "node:dns";
 import process from "node:process";
 import type { TelegramNetworkConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/network-errors.test.ts b/extensions/telegram/src/network-errors.test.ts
index 31dd0febb2a8..d57380524dad 100644
--- a/extensions/telegram/src/network-errors.test.ts
+++ b/extensions/telegram/src/network-errors.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover network errors plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   getTelegramNetworkErrorOrigin,
diff --git a/extensions/telegram/src/network-errors.ts b/extensions/telegram/src/network-errors.ts
index 48cc821c9bc1..ca359904dc71 100644
--- a/extensions/telegram/src/network-errors.ts
+++ b/extensions/telegram/src/network-errors.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements network errors behavior.
 import {
   collectErrorGraphCandidates,
   extractErrorCode,
diff --git a/extensions/telegram/src/normalize.ts b/extensions/telegram/src/normalize.ts
index bdb60250598d..3ac299a1ae8d 100644
--- a/extensions/telegram/src/normalize.ts
+++ b/extensions/telegram/src/normalize.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports normalize behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeTelegramLookupTarget, parseTelegramTarget } from "./targets.js";
 
diff --git a/extensions/telegram/src/outbound-adapter.test.ts b/extensions/telegram/src/outbound-adapter.test.ts
index b75cfb01f764..15090c3aaacd 100644
--- a/extensions/telegram/src/outbound-adapter.test.ts
+++ b/extensions/telegram/src/outbound-adapter.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover outbound adapter plugin behavior.
 import { verifyDurableFinalCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound";
 import { adaptMessagePresentationForChannel } from "openclaw/plugin-sdk/interactive-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/telegram/src/outbound-adapter.ts b/extensions/telegram/src/outbound-adapter.ts
index 854f4db09058..93bbded48b01 100644
--- a/extensions/telegram/src/outbound-adapter.ts
+++ b/extensions/telegram/src/outbound-adapter.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements outbound adapter behavior.
 import type { OutboundDeliveryFormattingOptions } from "openclaw/plugin-sdk/channel-outbound";
 import {
   resolveOutboundSendDep,
diff --git a/extensions/telegram/src/outbound-message-context.ts b/extensions/telegram/src/outbound-message-context.ts
index 61cbae5f9fe1..508f051e897b 100644
--- a/extensions/telegram/src/outbound-message-context.ts
+++ b/extensions/telegram/src/outbound-message-context.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements outbound message context behavior.
 import type { Message } from "grammy/types";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/telegram/src/outbound-params.test.ts b/extensions/telegram/src/outbound-params.test.ts
index 50ccbcec74c3..dfbcc7a0ec64 100644
--- a/extensions/telegram/src/outbound-params.test.ts
+++ b/extensions/telegram/src/outbound-params.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover outbound params plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   parseTelegramMessageThreadId,
diff --git a/extensions/telegram/src/outbound-params.ts b/extensions/telegram/src/outbound-params.ts
index aa5354419403..3c786f64e629 100644
--- a/extensions/telegram/src/outbound-params.ts
+++ b/extensions/telegram/src/outbound-params.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements outbound params behavior.
 import {
   parseStrictInteger,
   parseStrictNonNegativeInteger,
diff --git a/extensions/telegram/src/poll-visibility.test.ts b/extensions/telegram/src/poll-visibility.test.ts
index 3c62c8255f0c..87deb0a9a69c 100644
--- a/extensions/telegram/src/poll-visibility.test.ts
+++ b/extensions/telegram/src/poll-visibility.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover poll visibility plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveTelegramPollVisibility } from "./poll-visibility.js";
 
diff --git a/extensions/telegram/src/poll-visibility.ts b/extensions/telegram/src/poll-visibility.ts
index 398572266aa9..039165344518 100644
--- a/extensions/telegram/src/poll-visibility.ts
+++ b/extensions/telegram/src/poll-visibility.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements poll visibility behavior.
 export function resolveTelegramPollVisibility(params: {
   pollAnonymous?: boolean;
   pollPublic?: boolean;
diff --git a/extensions/telegram/src/polling-lease.test.ts b/extensions/telegram/src/polling-lease.test.ts
index fc95743c3cf5..0cce65743c52 100644
--- a/extensions/telegram/src/polling-lease.test.ts
+++ b/extensions/telegram/src/polling-lease.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover polling lease plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/telegram/src/polling-lease.ts b/extensions/telegram/src/polling-lease.ts
index 4669cea0bc3b..60d0589c30df 100644
--- a/extensions/telegram/src/polling-lease.ts
+++ b/extensions/telegram/src/polling-lease.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements polling lease behavior.
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import { fingerprintTelegramBotToken } from "./token-fingerprint.js";
 
diff --git a/extensions/telegram/src/polling-liveness.test.ts b/extensions/telegram/src/polling-liveness.test.ts
index f4d83a68ec5f..3b56b7ed1e87 100644
--- a/extensions/telegram/src/polling-liveness.test.ts
+++ b/extensions/telegram/src/polling-liveness.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover polling liveness plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { TelegramPollingLivenessTracker } from "./polling-liveness.js";
 
diff --git a/extensions/telegram/src/polling-liveness.ts b/extensions/telegram/src/polling-liveness.ts
index b7e0c72073cb..1298e18f3340 100644
--- a/extensions/telegram/src/polling-liveness.ts
+++ b/extensions/telegram/src/polling-liveness.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements polling liveness behavior.
 import { formatDurationPrecise } from "openclaw/plugin-sdk/runtime-env";
 import { formatErrorMessage } from "openclaw/plugin-sdk/ssrf-runtime";
 
diff --git a/extensions/telegram/src/polling-session.test.ts b/extensions/telegram/src/polling-session.test.ts
index 1fe5716f7edc..73830535ba46 100644
--- a/extensions/telegram/src/polling-session.test.ts
+++ b/extensions/telegram/src/polling-session.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover polling session plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/polling-session.ts b/extensions/telegram/src/polling-session.ts
index afd284c44640..ce9419c5f250 100644
--- a/extensions/telegram/src/polling-session.ts
+++ b/extensions/telegram/src/polling-session.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements polling session behavior.
 import { type RunOptions, run } from "@grammyjs/runner";
 import type { ChannelAccountSnapshot } from "openclaw/plugin-sdk/channel-contract";
 import type { TelegramNetworkConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/polling-status.test.ts b/extensions/telegram/src/polling-status.test.ts
index 90444d49bb60..6999458ffe27 100644
--- a/extensions/telegram/src/polling-status.test.ts
+++ b/extensions/telegram/src/polling-status.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover polling status plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createTelegramPollingStatusPublisher } from "./polling-status.js";
 
diff --git a/extensions/telegram/src/polling-status.ts b/extensions/telegram/src/polling-status.ts
index 6d43b510c843..d6e4298c4e6e 100644
--- a/extensions/telegram/src/polling-status.ts
+++ b/extensions/telegram/src/polling-status.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements polling status behavior.
 import type { ChannelAccountSnapshot } from "openclaw/plugin-sdk/channel-contract";
 import {
   createConnectedChannelStatusPatch,
diff --git a/extensions/telegram/src/polling-transport-state.test.ts b/extensions/telegram/src/polling-transport-state.test.ts
index df53b5ce60cb..3783bf813e32 100644
--- a/extensions/telegram/src/polling-transport-state.test.ts
+++ b/extensions/telegram/src/polling-transport-state.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover polling transport state plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { TelegramTransport } from "./fetch.js";
 import { TelegramPollingTransportState } from "./polling-transport-state.js";
diff --git a/extensions/telegram/src/polling-transport-state.ts b/extensions/telegram/src/polling-transport-state.ts
index 87aa2360d8d5..f97b76739e27 100644
--- a/extensions/telegram/src/polling-transport-state.ts
+++ b/extensions/telegram/src/polling-transport-state.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements polling transport state behavior.
 import type { TelegramTransport } from "./fetch.js";
 
 type TelegramPollingTransportStateOpts = {
diff --git a/extensions/telegram/src/preview-streaming.ts b/extensions/telegram/src/preview-streaming.ts
index 9cce1460024d..58670073852a 100644
--- a/extensions/telegram/src/preview-streaming.ts
+++ b/extensions/telegram/src/preview-streaming.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements preview streaming behavior.
 import {
   resolveChannelPreviewStreamMode,
   type StreamingMode,
diff --git a/extensions/telegram/src/probe.test.ts b/extensions/telegram/src/probe.test.ts
index 50e9735465df..6914b8e90fb7 100644
--- a/extensions/telegram/src/probe.test.ts
+++ b/extensions/telegram/src/probe.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover probe plugin behavior.
 import { withFetchPreconnect } from "openclaw/plugin-sdk/test-env";
 import { afterEach, describe, expect, it, vi, type Mock } from "vitest";
 import { probeTelegram, resetTelegramProbeFetcherCacheForTests } from "./probe.js";
diff --git a/extensions/telegram/src/probe.ts b/extensions/telegram/src/probe.ts
index ad67e88e9766..46d88cf2bc46 100644
--- a/extensions/telegram/src/probe.ts
+++ b/extensions/telegram/src/probe.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements probe behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import type { TelegramNetworkConfig } from "openclaw/plugin-sdk/config-contracts";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/telegram/src/proxy.ts b/extensions/telegram/src/proxy.ts
index 0de45b4df462..a7b563feaa27 100644
--- a/extensions/telegram/src/proxy.ts
+++ b/extensions/telegram/src/proxy.ts
@@ -1 +1,2 @@
+// Telegram plugin module implements proxy behavior.
 export { getProxyUrlFromFetch, makeProxyFetch } from "openclaw/plugin-sdk/fetch-runtime";
diff --git a/extensions/telegram/src/raw-update-log.ts b/extensions/telegram/src/raw-update-log.ts
index 8c294bb8d67c..bdb023d9e2d8 100644
--- a/extensions/telegram/src/raw-update-log.ts
+++ b/extensions/telegram/src/raw-update-log.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements raw update log behavior.
 const MAX_RAW_UPDATE_STRING = 500;
 const MAX_RAW_UPDATE_ARRAY = 20;
 const REDACTED_TELEGRAM_FIELD = "[redacted]";
diff --git a/extensions/telegram/src/reaction-level.test.ts b/extensions/telegram/src/reaction-level.test.ts
index 575e27a9a4d2..a4a11f182387 100644
--- a/extensions/telegram/src/reaction-level.test.ts
+++ b/extensions/telegram/src/reaction-level.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover reaction level plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
 import { resolveTelegramReactionLevel } from "./reaction-level.js";
diff --git a/extensions/telegram/src/reaction-level.ts b/extensions/telegram/src/reaction-level.ts
index 9f69faec4f2c..e7f0415f21f8 100644
--- a/extensions/telegram/src/reaction-level.ts
+++ b/extensions/telegram/src/reaction-level.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements reaction level behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   resolveReactionLevel,
diff --git a/extensions/telegram/src/reasoning-lane-coordinator.test.ts b/extensions/telegram/src/reasoning-lane-coordinator.test.ts
index afb58385b621..fb194b45c80e 100644
--- a/extensions/telegram/src/reasoning-lane-coordinator.test.ts
+++ b/extensions/telegram/src/reasoning-lane-coordinator.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover reasoning lane coordinator plugin behavior.
 import { describe, expect, it } from "vitest";
 import { splitTelegramReasoningText } from "./reasoning-lane-coordinator.js";
 
diff --git a/extensions/telegram/src/reasoning-lane-coordinator.ts b/extensions/telegram/src/reasoning-lane-coordinator.ts
index 14d42413207a..778aa9ac4bf6 100644
--- a/extensions/telegram/src/reasoning-lane-coordinator.ts
+++ b/extensions/telegram/src/reasoning-lane-coordinator.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements reasoning lane coordinator behavior.
 import { formatReasoningMessage } from "openclaw/plugin-sdk/agent-runtime";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/telegram/src/reply-parameters.test.ts b/extensions/telegram/src/reply-parameters.test.ts
index eb337feb6069..fe2c8cb2f4b8 100644
--- a/extensions/telegram/src/reply-parameters.test.ts
+++ b/extensions/telegram/src/reply-parameters.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover reply parameters plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildTelegramSendParams,
diff --git a/extensions/telegram/src/reply-parameters.ts b/extensions/telegram/src/reply-parameters.ts
index 1aa003340ec5..e3095559b5a5 100644
--- a/extensions/telegram/src/reply-parameters.ts
+++ b/extensions/telegram/src/reply-parameters.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements reply parameters behavior.
 import type { MessageEntity } from "grammy/types";
 import { buildTelegramThreadParams, type TelegramThreadSpec } from "./bot/helpers.js";
 import { normalizeTelegramReplyToMessageId } from "./outbound-params.js";
diff --git a/extensions/telegram/src/request-timeouts.test.ts b/extensions/telegram/src/request-timeouts.test.ts
index 391672ad7a63..8e9ab76a97a8 100644
--- a/extensions/telegram/src/request-timeouts.test.ts
+++ b/extensions/telegram/src/request-timeouts.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover request timeouts plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/telegram/src/request-timeouts.ts b/extensions/telegram/src/request-timeouts.ts
index a4a13dd12d62..46f2f00a1edc 100644
--- a/extensions/telegram/src/request-timeouts.ts
+++ b/extensions/telegram/src/request-timeouts.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements request timeouts behavior.
 import {
   finiteSecondsToTimerSafeMilliseconds,
   MAX_TIMER_TIMEOUT_MS,
diff --git a/extensions/telegram/src/runtime.ts b/extensions/telegram/src/runtime.ts
index 11dffb918eed..2cd52e7c34d6 100644
--- a/extensions/telegram/src/runtime.ts
+++ b/extensions/telegram/src/runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements runtime behavior.
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import type { TelegramRuntime } from "./runtime.types.js";
 
diff --git a/extensions/telegram/src/runtime.types.ts b/extensions/telegram/src/runtime.types.ts
index f0cfbb1ff6df..e33b2c968671 100644
--- a/extensions/telegram/src/runtime.types.ts
+++ b/extensions/telegram/src/runtime.types.ts
@@ -1,3 +1,4 @@
+// Telegram type declarations define plugin contracts.
 import type { ChannelMessageActionAdapter } from "openclaw/plugin-sdk/channel-contract";
 import type { PluginRuntime } from "openclaw/plugin-sdk/channel-core";
 import type { TelegramMonitorFn } from "./monitor.types.js";
diff --git a/extensions/telegram/src/secret-contract.ts b/extensions/telegram/src/secret-contract.ts
index 14466203ddc8..f7c572a798d1 100644
--- a/extensions/telegram/src/secret-contract.ts
+++ b/extensions/telegram/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements secret contract behavior.
 import {
   collectConditionalChannelFieldAssignments,
   getChannelSurface,
diff --git a/extensions/telegram/src/security-audit.test.ts b/extensions/telegram/src/security-audit.test.ts
index 2b0cbe167bd7..827aa7b6d85b 100644
--- a/extensions/telegram/src/security-audit.test.ts
+++ b/extensions/telegram/src/security-audit.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover security audit plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
 import type { ResolvedTelegramAccount } from "./accounts.js";
diff --git a/extensions/telegram/src/security-audit.ts b/extensions/telegram/src/security-audit.ts
index 9c480ce9b925..4a79e241badf 100644
--- a/extensions/telegram/src/security-audit.ts
+++ b/extensions/telegram/src/security-audit.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements security audit behavior.
 import { readChannelAllowFromStore } from "openclaw/plugin-sdk/conversation-runtime";
 import { resolveNativeSkillsEnabled } from "openclaw/plugin-sdk/native-command-config-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/telegram/src/security.ts b/extensions/telegram/src/security.ts
index 15aac107e59a..cb3884590b50 100644
--- a/extensions/telegram/src/security.ts
+++ b/extensions/telegram/src/security.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements security behavior.
 import { createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import type { ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createAllowlistProviderRouteAllowlistWarningCollector } from "openclaw/plugin-sdk/channel-policy";
diff --git a/extensions/telegram/src/send.proxy.test.ts b/extensions/telegram/src/send.proxy.test.ts
index 6c8d1197b3c6..a02d47ef8dc3 100644
--- a/extensions/telegram/src/send.proxy.test.ts
+++ b/extensions/telegram/src/send.proxy.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover send.proxy plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const { botApi, botCtorSpy } = vi.hoisted(() => ({
diff --git a/extensions/telegram/src/send.runtime.ts b/extensions/telegram/src/send.runtime.ts
index d586197af95f..0c09411b1c28 100644
--- a/extensions/telegram/src/send.runtime.ts
+++ b/extensions/telegram/src/send.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements send behavior.
 export { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 export { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
 export type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/send.test-harness.ts b/extensions/telegram/src/send.test-harness.ts
index ac13bf7861c5..6dfe119ba883 100644
--- a/extensions/telegram/src/send.test-harness.ts
+++ b/extensions/telegram/src/send.test-harness.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements send harness behavior.
 import { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
 import {
   buildOutboundMediaLoadOptions,
diff --git a/extensions/telegram/src/send.test.ts b/extensions/telegram/src/send.test.ts
index a753ed6e0a9b..58d054b4c8df 100644
--- a/extensions/telegram/src/send.test.ts
+++ b/extensions/telegram/src/send.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover send plugin behavior.
 import fs from "node:fs";
 import type { Bot } from "grammy";
 import {
diff --git a/extensions/telegram/src/send.ts b/extensions/telegram/src/send.ts
index 734f54851a8e..f14cca92dfb4 100644
--- a/extensions/telegram/src/send.ts
+++ b/extensions/telegram/src/send.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements send behavior.
 import * as grammy from "grammy";
 import { type ApiClientOptions, Bot, HttpError } from "grammy";
 import type { ReactionType, ReactionTypeEmoji } from "grammy/types";
diff --git a/extensions/telegram/src/sendchataction-401-backoff.test.ts b/extensions/telegram/src/sendchataction-401-backoff.test.ts
index 7a2100dd2a30..820ffcc3c412 100644
--- a/extensions/telegram/src/sendchataction-401-backoff.test.ts
+++ b/extensions/telegram/src/sendchataction-401-backoff.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover sendchataction 401 backoff plugin behavior.
 import { beforeAll, describe, expect, it, vi } from "vitest";
 
 const mocks = vi.hoisted(() => ({
diff --git a/extensions/telegram/src/sendchataction-401-backoff.ts b/extensions/telegram/src/sendchataction-401-backoff.ts
index e2ca6cfad9b9..9ae68ddd5f37 100644
--- a/extensions/telegram/src/sendchataction-401-backoff.ts
+++ b/extensions/telegram/src/sendchataction-401-backoff.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements sendchataction 401 backoff behavior.
 import type { Bot } from "grammy";
 import {
   computeBackoff,
diff --git a/extensions/telegram/src/sent-message-cache.ts b/extensions/telegram/src/sent-message-cache.ts
index af4f3529e537..2a4db1ccb9d9 100644
--- a/extensions/telegram/src/sent-message-cache.ts
+++ b/extensions/telegram/src/sent-message-cache.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements sent message cache behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/telegram/src/sequential-key.test.ts b/extensions/telegram/src/sequential-key.test.ts
index b09efa095e13..4bb1ba07eb7e 100644
--- a/extensions/telegram/src/sequential-key.test.ts
+++ b/extensions/telegram/src/sequential-key.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover sequential key plugin behavior.
 import type { Chat, Message } from "grammy/types";
 import { describe, expect, it } from "vitest";
 import { getTelegramSequentialKey } from "./sequential-key.js";
diff --git a/extensions/telegram/src/sequential-key.ts b/extensions/telegram/src/sequential-key.ts
index ce65edbef974..6fd5c7e9ae00 100644
--- a/extensions/telegram/src/sequential-key.ts
+++ b/extensions/telegram/src/sequential-key.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements sequential key behavior.
 import type { Message, UserFromGetMe } from "grammy/types";
 import { parseExecApprovalCommandText } from "openclaw/plugin-sdk/approval-reply-runtime";
 import {
diff --git a/extensions/telegram/src/session-conversation.test.ts b/extensions/telegram/src/session-conversation.test.ts
index 46bea23802e4..6f1d6d9cfead 100644
--- a/extensions/telegram/src/session-conversation.test.ts
+++ b/extensions/telegram/src/session-conversation.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover session conversation plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveTelegramSessionConversation,
diff --git a/extensions/telegram/src/session-conversation.ts b/extensions/telegram/src/session-conversation.ts
index 7622d09c20b8..42a7b64114ef 100644
--- a/extensions/telegram/src/session-conversation.ts
+++ b/extensions/telegram/src/session-conversation.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements session conversation behavior.
 import { normalizeTelegramChatId, normalizeTelegramLookupTarget } from "./targets.js";
 import { parseTelegramTopicConversation } from "./topic-conversation.js";
 
diff --git a/extensions/telegram/src/session-route.test.ts b/extensions/telegram/src/session-route.test.ts
index 302ca70d4103..eeb39b6613bf 100644
--- a/extensions/telegram/src/session-route.test.ts
+++ b/extensions/telegram/src/session-route.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover session route plugin behavior.
 import { describe, expect, it } from "vitest";
 import { telegramPlugin } from "./channel.js";
 
diff --git a/extensions/telegram/src/setup-contract.ts b/extensions/telegram/src/setup-contract.ts
index 8cf41c9177ef..963a4bfd4fd1 100644
--- a/extensions/telegram/src/setup-contract.ts
+++ b/extensions/telegram/src/setup-contract.ts
@@ -1,2 +1,3 @@
+// Telegram plugin module implements setup contract behavior.
 export const singleAccountKeysToMove = ["streaming"];
 export const namedAccountPromotionKeys = ["botToken", "tokenFile"] as const;
diff --git a/extensions/telegram/src/setup-core.ts b/extensions/telegram/src/setup-core.ts
index eea93340e9af..49299303d797 100644
--- a/extensions/telegram/src/setup-core.ts
+++ b/extensions/telegram/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements setup core behavior.
 import type { ChannelSetupAdapter } from "openclaw/plugin-sdk/setup-runtime";
 import {
   createEnvPatchedAccountSetupAdapter,
diff --git a/extensions/telegram/src/setup-surface.helpers.ts b/extensions/telegram/src/setup-surface.helpers.ts
index 163266f4e267..cede352a10bb 100644
--- a/extensions/telegram/src/setup-surface.helpers.ts
+++ b/extensions/telegram/src/setup-surface.helpers.ts
@@ -1,3 +1,4 @@
+// Telegram helper module supports setup surface.helpers behavior.
 import {
   addWildcardAllowFrom,
   applySetupAccountConfigPatch,
diff --git a/extensions/telegram/src/setup-surface.test.ts b/extensions/telegram/src/setup-surface.test.ts
index 0975e9ace4f3..4ad533e75b52 100644
--- a/extensions/telegram/src/setup-surface.test.ts
+++ b/extensions/telegram/src/setup-surface.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover setup surface plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/setup";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/telegram/src/setup-surface.ts b/extensions/telegram/src/setup-surface.ts
index 6e413539eb79..44b2fbde45ec 100644
--- a/extensions/telegram/src/setup-surface.ts
+++ b/extensions/telegram/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements setup surface behavior.
 import {
   createAllowFromSection,
   createStandardChannelSetupStatus,
diff --git a/extensions/telegram/src/shared.test.ts b/extensions/telegram/src/shared.test.ts
index ed1836e029ca..338c740092de 100644
--- a/extensions/telegram/src/shared.test.ts
+++ b/extensions/telegram/src/shared.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover shared plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import type { ResolvedTelegramAccount } from "./accounts.js";
diff --git a/extensions/telegram/src/shared.ts b/extensions/telegram/src/shared.ts
index d447154832c1..4b514fc697ad 100644
--- a/extensions/telegram/src/shared.ts
+++ b/extensions/telegram/src/shared.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements shared behavior.
 import { resolveNormalizedAccountEntry } from "openclaw/plugin-sdk/account-core";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
diff --git a/extensions/telegram/src/startup-probe-limiter.ts b/extensions/telegram/src/startup-probe-limiter.ts
index 84c35c948052..2963f74c43ad 100644
--- a/extensions/telegram/src/startup-probe-limiter.ts
+++ b/extensions/telegram/src/startup-probe-limiter.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements startup probe limiter behavior.
 const TELEGRAM_STARTUP_PROBE_CONCURRENCY = 2;
 
 type StartupProbeSlot = () => void;
diff --git a/extensions/telegram/src/state-migrations.test.ts b/extensions/telegram/src/state-migrations.test.ts
index be31b368c276..4e0d94153800 100644
--- a/extensions/telegram/src/state-migrations.test.ts
+++ b/extensions/telegram/src/state-migrations.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover state migrations plugin behavior.
 import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/state-migrations.ts b/extensions/telegram/src/state-migrations.ts
index 3d725e6c9213..7c641f1e60b9 100644
--- a/extensions/telegram/src/state-migrations.ts
+++ b/extensions/telegram/src/state-migrations.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements state migrations behavior.
 import fs from "node:fs";
 import path from "node:path";
 import type { ChannelLegacyStateMigrationPlan } from "openclaw/plugin-sdk/channel-contract";
diff --git a/extensions/telegram/src/status-issues.ts b/extensions/telegram/src/status-issues.ts
index 5489e4f933cb..2c0cbbe14601 100644
--- a/extensions/telegram/src/status-issues.ts
+++ b/extensions/telegram/src/status-issues.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements status issues behavior.
 import type {
   ChannelAccountSnapshot,
   ChannelStatusIssue,
diff --git a/extensions/telegram/src/status-reaction-variants.ts b/extensions/telegram/src/status-reaction-variants.ts
index d44f6d59c007..6e7dd1d1d41a 100644
--- a/extensions/telegram/src/status-reaction-variants.ts
+++ b/extensions/telegram/src/status-reaction-variants.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements status reaction variants behavior.
 import type { ReactionTypeEmoji } from "grammy/types";
 import { DEFAULT_EMOJIS, type StatusReactionEmojis } from "openclaw/plugin-sdk/channel-feedback";
 import {
diff --git a/extensions/telegram/src/status.test.ts b/extensions/telegram/src/status.test.ts
index c047fc6d068e..13f00d0d73cf 100644
--- a/extensions/telegram/src/status.test.ts
+++ b/extensions/telegram/src/status.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover status plugin behavior.
 import type { ChannelAccountSnapshot } from "openclaw/plugin-sdk/channel-contract";
 import { DEFAULT_EMOJIS } from "openclaw/plugin-sdk/channel-feedback";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/telegram/src/sticker-cache-store.ts b/extensions/telegram/src/sticker-cache-store.ts
index fa230df31a09..21403a304690 100644
--- a/extensions/telegram/src/sticker-cache-store.ts
+++ b/extensions/telegram/src/sticker-cache-store.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements sticker cache store behavior.
 import path from "node:path";
 import { loadJsonFile } from "openclaw/plugin-sdk/json-store";
 import type { PluginStateSyncKeyedStore } from "openclaw/plugin-sdk/plugin-state-runtime";
diff --git a/extensions/telegram/src/sticker-cache.describe.test.ts b/extensions/telegram/src/sticker-cache.describe.test.ts
index 803750a2e710..b51968be64bc 100644
--- a/extensions/telegram/src/sticker-cache.describe.test.ts
+++ b/extensions/telegram/src/sticker-cache.describe.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover sticker cacheescribe plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { describeStickerImage } from "./sticker-cache.js";
 
diff --git a/extensions/telegram/src/sticker-cache.test.ts b/extensions/telegram/src/sticker-cache.test.ts
index 82868dbb68bf..6ca3f26172b9 100644
--- a/extensions/telegram/src/sticker-cache.test.ts
+++ b/extensions/telegram/src/sticker-cache.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover sticker cache plugin behavior.
 import {
   createPluginStateSyncKeyedStoreForTests,
   resetPluginStateStoreForTests,
diff --git a/extensions/telegram/src/sticker-cache.ts b/extensions/telegram/src/sticker-cache.ts
index a9dd3d30f78a..d8401966fa38 100644
--- a/extensions/telegram/src/sticker-cache.ts
+++ b/extensions/telegram/src/sticker-cache.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements sticker cache behavior.
 import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/agent-runtime";
 import type { ModelCatalogEntry } from "openclaw/plugin-sdk/agent-runtime";
 import {
diff --git a/extensions/telegram/src/sticker-vision.runtime.ts b/extensions/telegram/src/sticker-vision.runtime.ts
index 8d6896c33188..f2c4d576bfea 100644
--- a/extensions/telegram/src/sticker-vision.runtime.ts
+++ b/extensions/telegram/src/sticker-vision.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements sticker vision behavior.
 import {
   findModelInCatalog,
   loadModelCatalog,
diff --git a/extensions/telegram/src/target-writeback.test-shared.ts b/extensions/telegram/src/target-writeback.test-shared.ts
index 6fb24a46883f..dc586dcb912b 100644
--- a/extensions/telegram/src/target-writeback.test-shared.ts
+++ b/extensions/telegram/src/target-writeback.test-shared.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements target writeback shared behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeAll, beforeEach, describe, expect, it, vi, type Mock } from "vitest";
 
diff --git a/extensions/telegram/src/target-writeback.ts b/extensions/telegram/src/target-writeback.ts
index 754955d242c7..2667d9172e0f 100644
--- a/extensions/telegram/src/target-writeback.ts
+++ b/extensions/telegram/src/target-writeback.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements target writeback behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   readConfigFileSnapshotForWrite,
diff --git a/extensions/telegram/src/targets.test.ts b/extensions/telegram/src/targets.test.ts
index 5839913b6382..2667b8c4bb30 100644
--- a/extensions/telegram/src/targets.test.ts
+++ b/extensions/telegram/src/targets.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover targets plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   isNumericTelegramSenderUserId,
diff --git a/extensions/telegram/src/targets.ts b/extensions/telegram/src/targets.ts
index 89417dcb15ca..a59fbc61562e 100644
--- a/extensions/telegram/src/targets.ts
+++ b/extensions/telegram/src/targets.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements targets behavior.
 import { parseStrictNonNegativeInteger } from "openclaw/plugin-sdk/number-runtime";
 
 export type TelegramTarget = {
diff --git a/extensions/telegram/src/telegram-ingress-spool.test.ts b/extensions/telegram/src/telegram-ingress-spool.test.ts
index 5524eca39f3b..58f82de8ccf6 100644
--- a/extensions/telegram/src/telegram-ingress-spool.test.ts
+++ b/extensions/telegram/src/telegram-ingress-spool.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover telegram ingress spool plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/telegram-ingress-spool.ts b/extensions/telegram/src/telegram-ingress-spool.ts
index 4c49b30b2a55..6eb0a8621b0d 100644
--- a/extensions/telegram/src/telegram-ingress-spool.ts
+++ b/extensions/telegram/src/telegram-ingress-spool.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements telegram ingress spool behavior.
 import { randomUUID } from "node:crypto";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/telegram-ingress-worker.runtime.ts b/extensions/telegram/src/telegram-ingress-worker.runtime.ts
index d7cdd7173dc4..61018b8c3d2f 100644
--- a/extensions/telegram/src/telegram-ingress-worker.runtime.ts
+++ b/extensions/telegram/src/telegram-ingress-worker.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements telegram ingress worker behavior.
 import { parentPort, workerData } from "node:worker_threads";
 import { resolveTelegramAllowedUpdates } from "./allowed-updates.js";
 import { normalizeTelegramApiRoot } from "./api-root.js";
diff --git a/extensions/telegram/src/telegram-ingress-worker.ts b/extensions/telegram/src/telegram-ingress-worker.ts
index f37d00c20420..f4f24fb919e9 100644
--- a/extensions/telegram/src/telegram-ingress-worker.ts
+++ b/extensions/telegram/src/telegram-ingress-worker.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements telegram ingress worker behavior.
 import { Worker } from "node:worker_threads";
 import type { TelegramNetworkConfig } from "openclaw/plugin-sdk/config-contracts";
 
diff --git a/extensions/telegram/src/telegram-media.runtime.ts b/extensions/telegram/src/telegram-media.runtime.ts
index 1541e598579e..6ae1ba7ad6cd 100644
--- a/extensions/telegram/src/telegram-media.runtime.ts
+++ b/extensions/telegram/src/telegram-media.runtime.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements telegram media behavior.
 export {
   readRemoteMediaBuffer,
   MediaFetchError,
diff --git a/extensions/telegram/src/telegram-outbound.test.ts b/extensions/telegram/src/telegram-outbound.test.ts
index 7a8615f3e6f7..ad1b1733d95c 100644
--- a/extensions/telegram/src/telegram-outbound.test.ts
+++ b/extensions/telegram/src/telegram-outbound.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover telegram outbound plugin behavior.
 import { describe, expect, it } from "vitest";
 import { markdownToTelegramHtmlChunks, splitTelegramHtmlChunks } from "./format.js";
 import { telegramOutbound } from "./outbound-adapter.js";
diff --git a/extensions/telegram/src/telegram-reply-fence.test.ts b/extensions/telegram/src/telegram-reply-fence.test.ts
index a8b32838df97..1c702829f1a9 100644
--- a/extensions/telegram/src/telegram-reply-fence.test.ts
+++ b/extensions/telegram/src/telegram-reply-fence.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover telegram reply fence plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   beginTelegramReplyFence,
diff --git a/extensions/telegram/src/telegram-reply-fence.ts b/extensions/telegram/src/telegram-reply-fence.ts
index 424a5809b71b..b6bffe6d2025 100644
--- a/extensions/telegram/src/telegram-reply-fence.ts
+++ b/extensions/telegram/src/telegram-reply-fence.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements telegram reply fence behavior.
 import {
   isExplicitCommandTurn,
   type CommandTurnContext,
diff --git a/extensions/telegram/src/test-support/inbound-context-contract.ts b/extensions/telegram/src/test-support/inbound-context-contract.ts
index 2b43b722b431..d1005d90a062 100644
--- a/extensions/telegram/src/test-support/inbound-context-contract.ts
+++ b/extensions/telegram/src/test-support/inbound-context-contract.ts
@@ -1 +1,2 @@
+// Telegram plugin module implements inbound context contract behavior.
 export { expectChannelInboundContextContract } from "openclaw/plugin-sdk/channel-contract-testing";
diff --git a/extensions/telegram/src/test-support/plugin-command.ts b/extensions/telegram/src/test-support/plugin-command.ts
index dec0046de1f6..8c33a8b19a02 100644
--- a/extensions/telegram/src/test-support/plugin-command.ts
+++ b/extensions/telegram/src/test-support/plugin-command.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements plugin command behavior.
 import { vi } from "vitest";
 
 export const pluginCommandMocks = {
diff --git a/extensions/telegram/src/test-support/write-skill.ts b/extensions/telegram/src/test-support/write-skill.ts
index 1375b8b73a1d..153284ea8bec 100644
--- a/extensions/telegram/src/test-support/write-skill.ts
+++ b/extensions/telegram/src/test-support/write-skill.ts
@@ -1 +1,2 @@
+// Telegram plugin module implements write skill behavior.
 export { writeSkill } from "openclaw/plugin-sdk/test-fixtures";
diff --git a/extensions/telegram/src/thread-bindings.test.ts b/extensions/telegram/src/thread-bindings.test.ts
index d5ee7ee7d736..b52d0db90d37 100644
--- a/extensions/telegram/src/thread-bindings.test.ts
+++ b/extensions/telegram/src/thread-bindings.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover thread bindings plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/thread-bindings.ts b/extensions/telegram/src/thread-bindings.ts
index c690fc821c8e..00cf8d5c446c 100644
--- a/extensions/telegram/src/thread-bindings.ts
+++ b/extensions/telegram/src/thread-bindings.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements thread bindings behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/extensions/telegram/src/threading-tool-context.test.ts b/extensions/telegram/src/threading-tool-context.test.ts
index f85d7cb65217..f3169347c698 100644
--- a/extensions/telegram/src/threading-tool-context.test.ts
+++ b/extensions/telegram/src/threading-tool-context.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover threading tool context plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import { buildTelegramThreadingToolContext } from "./threading-tool-context.js";
diff --git a/extensions/telegram/src/threading-tool-context.ts b/extensions/telegram/src/threading-tool-context.ts
index 18eba946f7a5..79742dd1113b 100644
--- a/extensions/telegram/src/threading-tool-context.ts
+++ b/extensions/telegram/src/threading-tool-context.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements threading tool context behavior.
 import type {
   ChannelThreadingContext,
   ChannelThreadingToolContext,
diff --git a/extensions/telegram/src/token-fingerprint.ts b/extensions/telegram/src/token-fingerprint.ts
index 59abdf50b46b..f6ed5fb2bba7 100644
--- a/extensions/telegram/src/token-fingerprint.ts
+++ b/extensions/telegram/src/token-fingerprint.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements token fingerprint behavior.
 import { createHash } from "node:crypto";
 
 /**
diff --git a/extensions/telegram/src/token.test.ts b/extensions/telegram/src/token.test.ts
index cf407d50946a..a5f5ac05b5ca 100644
--- a/extensions/telegram/src/token.test.ts
+++ b/extensions/telegram/src/token.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover token plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/telegram/src/token.ts b/extensions/telegram/src/token.ts
index 33d9467e23a1..3bddf7738465 100644
--- a/extensions/telegram/src/token.ts
+++ b/extensions/telegram/src/token.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements token behavior.
 import { resolveNormalizedAccountEntry } from "openclaw/plugin-sdk/account-core";
 import type { BaseTokenResolution } from "openclaw/plugin-sdk/channel-contract";
 import { tryReadSecretFileSync } from "openclaw/plugin-sdk/channel-core";
diff --git a/extensions/telegram/src/topic-conversation.test.ts b/extensions/telegram/src/topic-conversation.test.ts
index 3c27d86babfe..77bac4e20796 100644
--- a/extensions/telegram/src/topic-conversation.test.ts
+++ b/extensions/telegram/src/topic-conversation.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover topic conversation plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseTelegramTopicConversation } from "./topic-conversation.js";
 
diff --git a/extensions/telegram/src/topic-conversation.ts b/extensions/telegram/src/topic-conversation.ts
index 71d17837ddf2..48ae14a26066 100644
--- a/extensions/telegram/src/topic-conversation.ts
+++ b/extensions/telegram/src/topic-conversation.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements topic conversation behavior.
 export type ParsedTelegramTopicConversation = {
   chatId: string;
   topicId: string;
diff --git a/extensions/telegram/src/topic-name-cache.test.ts b/extensions/telegram/src/topic-name-cache.test.ts
index eb6f18f6ea30..9d9dd7ed9b7f 100644
--- a/extensions/telegram/src/topic-name-cache.test.ts
+++ b/extensions/telegram/src/topic-name-cache.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover topic name cache plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   clearTopicNameCache,
diff --git a/extensions/telegram/src/topic-name-cache.ts b/extensions/telegram/src/topic-name-cache.ts
index 2bb64947f764..51d941168cac 100644
--- a/extensions/telegram/src/topic-name-cache.ts
+++ b/extensions/telegram/src/topic-name-cache.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements topic name cache behavior.
 import { createHash } from "node:crypto";
 import { readJsonFileWithFallback } from "openclaw/plugin-sdk/json-store";
 import { getTelegramRuntime } from "./runtime.js";
diff --git a/extensions/telegram/src/update-offset-store.runtime.ts b/extensions/telegram/src/update-offset-store.runtime.ts
index 4fb6ac413777..cf9a061a84f6 100644
--- a/extensions/telegram/src/update-offset-store.runtime.ts
+++ b/extensions/telegram/src/update-offset-store.runtime.ts
@@ -1 +1,2 @@
+// Telegram plugin module implements update offset store behavior.
 export { deleteTelegramUpdateOffset } from "./update-offset-store.js";
diff --git a/extensions/telegram/src/update-offset-store.test.ts b/extensions/telegram/src/update-offset-store.test.ts
index 93186aa79170..3e3ea48c7591 100644
--- a/extensions/telegram/src/update-offset-store.test.ts
+++ b/extensions/telegram/src/update-offset-store.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover update offset store plugin behavior.
 import type { PluginStateKeyedStore } from "openclaw/plugin-sdk/plugin-state-runtime";
 import {
   createPluginStateKeyedStoreForTests,
diff --git a/extensions/telegram/src/update-offset-store.ts b/extensions/telegram/src/update-offset-store.ts
index 9e483d348e86..ccf1dcb5187b 100644
--- a/extensions/telegram/src/update-offset-store.ts
+++ b/extensions/telegram/src/update-offset-store.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements update offset store behavior.
 import { readJsonFileWithFallback } from "openclaw/plugin-sdk/json-store";
 import type { PluginStateKeyedStore } from "openclaw/plugin-sdk/plugin-state-runtime";
 import { getTelegramRuntime } from "./runtime.js";
diff --git a/extensions/telegram/src/voice.test.ts b/extensions/telegram/src/voice.test.ts
index e39f1e7fa647..ccda577a3c3d 100644
--- a/extensions/telegram/src/voice.test.ts
+++ b/extensions/telegram/src/voice.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover voice plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { splitTelegramCaption, TELEGRAM_MAX_CAPTION_LENGTH } from "./caption.js";
 import { resolveTelegramVoiceSend } from "./voice.js";
diff --git a/extensions/telegram/src/voice.ts b/extensions/telegram/src/voice.ts
index 7e9ce035b1ff..fae38b3973f9 100644
--- a/extensions/telegram/src/voice.ts
+++ b/extensions/telegram/src/voice.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements voice behavior.
 import { isVoiceCompatibleAudio } from "openclaw/plugin-sdk/media-runtime";
 
 function resolveTelegramVoiceDecision(opts: {
diff --git a/extensions/telegram/src/webhook-status.test.ts b/extensions/telegram/src/webhook-status.test.ts
index 2444c31896d0..26f1f322860f 100644
--- a/extensions/telegram/src/webhook-status.test.ts
+++ b/extensions/telegram/src/webhook-status.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover webhook status plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createTelegramWebhookStatusPublisher } from "./webhook-status.js";
 
diff --git a/extensions/telegram/src/webhook-status.ts b/extensions/telegram/src/webhook-status.ts
index cee2a58b603f..500f2b271b4d 100644
--- a/extensions/telegram/src/webhook-status.ts
+++ b/extensions/telegram/src/webhook-status.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements webhook status behavior.
 import type { ChannelAccountSnapshot } from "openclaw/plugin-sdk/channel-contract";
 import { createConnectedChannelStatusPatch } from "openclaw/plugin-sdk/gateway-runtime";
 
diff --git a/extensions/telegram/src/webhook.test.ts b/extensions/telegram/src/webhook.test.ts
index ac9b65d55bfd..0629c0ed860e 100644
--- a/extensions/telegram/src/webhook.test.ts
+++ b/extensions/telegram/src/webhook.test.ts
@@ -1,3 +1,4 @@
+// Telegram tests cover webhook plugin behavior.
 import { createHash } from "node:crypto";
 import { once } from "node:events";
 import { request, type IncomingMessage } from "node:http";
diff --git a/extensions/telegram/src/webhook.ts b/extensions/telegram/src/webhook.ts
index 22b94632668e..9d7b131d8bc1 100644
--- a/extensions/telegram/src/webhook.ts
+++ b/extensions/telegram/src/webhook.ts
@@ -1,3 +1,4 @@
+// Telegram plugin module implements webhook behavior.
 import { createServer } from "node:http";
 import type { IncomingMessage } from "node:http";
 import net from "node:net";
diff --git a/extensions/telegram/test-api.ts b/extensions/telegram/test-api.ts
index ab21feaa1378..6af11e21e832 100644
--- a/extensions/telegram/test-api.ts
+++ b/extensions/telegram/test-api.ts
@@ -1,2 +1,3 @@
+// Telegram API module exposes the plugin public contract.
 export { sendMessageTelegram, sendPollTelegram, type TelegramApiOverride } from "./src/send.js";
 export { resetTelegramThreadBindingsForTests } from "./src/thread-bindings.js";
diff --git a/extensions/telegram/update-offset-runtime-api.ts b/extensions/telegram/update-offset-runtime-api.ts
index cddaeb2f39c2..835bd3cede10 100644
--- a/extensions/telegram/update-offset-runtime-api.ts
+++ b/extensions/telegram/update-offset-runtime-api.ts
@@ -1 +1,2 @@
+// Telegram API module exposes the plugin public contract.
 export { deleteTelegramUpdateOffset } from "./src/update-offset-store.runtime.js";