diff --git a/extensions/browser/index.test.ts b/extensions/browser/index.test.ts
index c64b7e128ce8..93ff1759e703 100644
--- a/extensions/browser/index.test.ts
+++ b/extensions/browser/index.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover index plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
diff --git a/extensions/browser/src/browser-tool.schema.test.ts b/extensions/browser/src/browser-tool.schema.test.ts
index 4b1c76354884..51e72754c679 100644
--- a/extensions/browser/src/browser-tool.schema.test.ts
+++ b/extensions/browser/src/browser-tool.schema.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser tool.schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { BrowserToolSchema } from "./browser-tool.schema.js";
 import { ACT_MAX_VIEWPORT_DIMENSION } from "./browser/act-policy.js";
diff --git a/extensions/browser/src/browser-tool.test.ts b/extensions/browser/src/browser-tool.test.ts
index 8508bc396143..599ef00dcb2b 100644
--- a/extensions/browser/src/browser-tool.test.ts
+++ b/extensions/browser/src/browser-tool.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser tool plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
 const browserClientMocks = vi.hoisted(() => ({
diff --git a/extensions/browser/src/browser/bridge-server.auth.test.ts b/extensions/browser/src/browser/bridge-server.auth.test.ts
index 743fe7693bd8..59b2552304ab 100644
--- a/extensions/browser/src/browser/bridge-server.auth.test.ts
+++ b/extensions/browser/src/browser/bridge-server.auth.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover bridge server.auth plugin behavior.
 import { afterEach, describe, expect, it } from "vitest";
 import { startBrowserBridgeServer, stopBrowserBridgeServer } from "./bridge-server.js";
 import type { ResolvedBrowserConfig } from "./config.js";
diff --git a/extensions/browser/src/browser/browser-proxy-mode.test.ts b/extensions/browser/src/browser/browser-proxy-mode.test.ts
index f7fc0f93b24b..33c408bd67d4 100644
--- a/extensions/browser/src/browser/browser-proxy-mode.test.ts
+++ b/extensions/browser/src/browser/browser-proxy-mode.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser proxy mode plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   hasChromeProxyControlArg,
diff --git a/extensions/browser/src/browser/browser-utils.test.ts b/extensions/browser/src/browser/browser-utils.test.ts
index beaa77268f0c..99c1601f1224 100644
--- a/extensions/browser/src/browser/browser-utils.test.ts
+++ b/extensions/browser/src/browser/browser-utils.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser utils plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   appendCdpPath,
diff --git a/extensions/browser/src/browser/cdp-proxy-bypass.test.ts b/extensions/browser/src/browser/cdp-proxy-bypass.test.ts
index f25884695a92..c41ba18db550 100644
--- a/extensions/browser/src/browser/cdp-proxy-bypass.test.ts
+++ b/extensions/browser/src/browser/cdp-proxy-bypass.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover cdp proxy bypass plugin behavior.
 import http from "node:http";
 import https from "node:https";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/browser/src/browser/cdp.helpers.fuzz.test.ts b/extensions/browser/src/browser/cdp.helpers.fuzz.test.ts
index 3a22addc98fe..d60b4ed8eb55 100644
--- a/extensions/browser/src/browser/cdp.helpers.fuzz.test.ts
+++ b/extensions/browser/src/browser/cdp.helpers.fuzz.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover cdp.helpers.fuzz plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   appendCdpPath,
diff --git a/extensions/browser/src/browser/cdp.helpers.internal.test.ts b/extensions/browser/src/browser/cdp.helpers.internal.test.ts
index 53e4d6dbb0ab..527819f108c8 100644
--- a/extensions/browser/src/browser/cdp.helpers.internal.test.ts
+++ b/extensions/browser/src/browser/cdp.helpers.internal.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover cdp.helpers.internal plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { WebSocketServer } from "ws";
 import { rawDataToString } from "../infra/ws.js";
diff --git a/extensions/browser/src/browser/cdp.helpers.test.ts b/extensions/browser/src/browser/cdp.helpers.test.ts
index 7d12e4a37136..a365bf5dc7bf 100644
--- a/extensions/browser/src/browser/cdp.helpers.test.ts
+++ b/extensions/browser/src/browser/cdp.helpers.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover cdp.helpers plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { resolveCdpReachabilityPolicy } from "./cdp-reachability-policy.js";
diff --git a/extensions/browser/src/browser/cdp.internal.test.ts b/extensions/browser/src/browser/cdp.internal.test.ts
index 1e68e7c6378f..1a6d0725c679 100644
--- a/extensions/browser/src/browser/cdp.internal.test.ts
+++ b/extensions/browser/src/browser/cdp.internal.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover cdp.internal plugin behavior.
 import { afterEach, describe, expect, it } from "vitest";
 import { type WebSocket, WebSocketServer } from "ws";
 import { rawDataToString } from "../infra/ws.js";
diff --git a/extensions/browser/src/browser/cdp.screenshot-params.test.ts b/extensions/browser/src/browser/cdp.screenshot-params.test.ts
index 7f75e5057b1b..58e3f15b68b7 100644
--- a/extensions/browser/src/browser/cdp.screenshot-params.test.ts
+++ b/extensions/browser/src/browser/cdp.screenshot-params.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover cdp.screenshot params plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { withCdpSocket } from "./cdp.helpers.js";
 import { captureScreenshot } from "./cdp.js";
diff --git a/extensions/browser/src/browser/cdp.test.ts b/extensions/browser/src/browser/cdp.test.ts
index 03ff63e3a5bd..378ccfb4b4e2 100644
--- a/extensions/browser/src/browser/cdp.test.ts
+++ b/extensions/browser/src/browser/cdp.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover cdp plugin behavior.
 import { createServer } from "node:http";
 import type { AddressInfo } from "node:net";
 import type { Duplex } from "node:stream";
diff --git a/extensions/browser/src/browser/chrome-mcp.snapshot.test.ts b/extensions/browser/src/browser/chrome-mcp.snapshot.test.ts
index 3fe3288848f7..33fce72479f5 100644
--- a/extensions/browser/src/browser/chrome-mcp.snapshot.test.ts
+++ b/extensions/browser/src/browser/chrome-mcp.snapshot.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover chrome mcp.snapshot plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildAiSnapshotFromChromeMcpSnapshot,
diff --git a/extensions/browser/src/browser/chrome-mcp.test.ts b/extensions/browser/src/browser/chrome-mcp.test.ts
index aa9a566c9f86..256c82039190 100644
--- a/extensions/browser/src/browser/chrome-mcp.test.ts
+++ b/extensions/browser/src/browser/chrome-mcp.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover chrome mcp plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/chrome.default-browser.test.ts b/extensions/browser/src/browser/chrome.default-browser.test.ts
index 42df80dd0e5a..18800fae00df 100644
--- a/extensions/browser/src/browser/chrome.default-browser.test.ts
+++ b/extensions/browser/src/browser/chrome.default-browser.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover chromeefault browser plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 vi.mock("node:child_process", async () => {
diff --git a/extensions/browser/src/browser/chrome.internal.test.ts b/extensions/browser/src/browser/chrome.internal.test.ts
index 37b546a6df28..449909f5f142 100644
--- a/extensions/browser/src/browser/chrome.internal.test.ts
+++ b/extensions/browser/src/browser/chrome.internal.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover chrome.internal plugin behavior.
 import { EventEmitter } from "node:events";
 import fs from "node:fs";
 import fsp from "node:fs/promises";
diff --git a/extensions/browser/src/browser/chrome.loopback-ssrf.integration.test.ts b/extensions/browser/src/browser/chrome.loopback-ssrf.integration.test.ts
index 4f72fa4ff516..3ace79918e7e 100644
--- a/extensions/browser/src/browser/chrome.loopback-ssrf.integration.test.ts
+++ b/extensions/browser/src/browser/chrome.loopback-ssrf.integration.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover chrome.loopback ssrf.integration plugin behavior.
 import { createServer, type Server } from "node:http";
 import type { AddressInfo } from "node:net";
 import { afterEach, describe, expect, it } from "vitest";
diff --git a/extensions/browser/src/browser/chrome.test.ts b/extensions/browser/src/browser/chrome.test.ts
index 15a4ce522f89..9d52300e0b35 100644
--- a/extensions/browser/src/browser/chrome.test.ts
+++ b/extensions/browser/src/browser/chrome.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover chrome plugin behavior.
 import fs from "node:fs";
 import fsp from "node:fs/promises";
 import { createServer } from "node:http";
diff --git a/extensions/browser/src/browser/chrome.version.test.ts b/extensions/browser/src/browser/chrome.version.test.ts
index ba748c9c1fb1..4dac9e0a5ff0 100644
--- a/extensions/browser/src/browser/chrome.version.test.ts
+++ b/extensions/browser/src/browser/chrome.version.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover chrome.version plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const execFileSyncMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/browser/src/browser/client-fetch.attach-only.e2e.test.ts b/extensions/browser/src/browser/client-fetch.attach-only.e2e.test.ts
index bf6ed48411d0..37360e0e3bf0 100644
--- a/extensions/browser/src/browser/client-fetch.attach-only.e2e.test.ts
+++ b/extensions/browser/src/browser/client-fetch.attach-only.e2e.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover client fetch.attach only plugin behavior.
 import fs from "node:fs/promises";
 import net from "node:net";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/client-fetch.loopback-auth.test.ts b/extensions/browser/src/browser/client-fetch.loopback-auth.test.ts
index 0a8d8cb56988..6ba0cd652710 100644
--- a/extensions/browser/src/browser/client-fetch.loopback-auth.test.ts
+++ b/extensions/browser/src/browser/client-fetch.loopback-auth.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover client fetch.loopback auth plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import "../test-support/browser-security.mock.js";
diff --git a/extensions/browser/src/browser/client.test.ts b/extensions/browser/src/browser/client.test.ts
index 7b8fe73106ae..ee928cb3b3f1 100644
--- a/extensions/browser/src/browser/client.test.ts
+++ b/extensions/browser/src/browser/client.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover client plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/browser/src/browser/config.test.ts b/extensions/browser/src/browser/config.test.ts
index e0f5d0cfd629..9bc4b9f59664 100644
--- a/extensions/browser/src/browser/config.test.ts
+++ b/extensions/browser/src/browser/config.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover config plugin behavior.
 import os from "node:os";
 import path from "node:path";
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/browser/src/browser/control-auth.auto-token.test.ts b/extensions/browser/src/browser/control-auth.auto-token.test.ts
index 0dfd1344d13b..211c3a0753e0 100644
--- a/extensions/browser/src/browser/control-auth.auto-token.test.ts
+++ b/extensions/browser/src/browser/control-auth.auto-token.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover control auth.auto token plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { expectGeneratedTokenPersistedToGatewayAuth } from "../../test-support.js";
 import type { OpenClawConfig } from "../config/config.js";
diff --git a/extensions/browser/src/browser/control-auth.test.ts b/extensions/browser/src/browser/control-auth.test.ts
index af162b9f05c3..189485d0fcdc 100644
--- a/extensions/browser/src/browser/control-auth.test.ts
+++ b/extensions/browser/src/browser/control-auth.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover control auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../test-support.js";
 import { ensureBrowserControlAuth } from "./control-auth.js";
diff --git a/extensions/browser/src/browser/control-service.plugin-disabled.test.ts b/extensions/browser/src/browser/control-service.plugin-disabled.test.ts
index c1b3092f1ce0..76d1e2c4c57b 100644
--- a/extensions/browser/src/browser/control-service.plugin-disabled.test.ts
+++ b/extensions/browser/src/browser/control-service.plugin-disabled.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover control service.plugin disabled plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const mocks = vi.hoisted(() => ({
diff --git a/extensions/browser/src/browser/doctor.test.ts b/extensions/browser/src/browser/doctor.test.ts
index 9cc7f02e8fb6..476a985a8745 100644
--- a/extensions/browser/src/browser/doctor.test.ts
+++ b/extensions/browser/src/browser/doctor.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover doctor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildBrowserDoctorReport } from "./doctor.js";
 
diff --git a/extensions/browser/src/browser/errors.test.ts b/extensions/browser/src/browser/errors.test.ts
index b4e4b9af899b..0832578e66ab 100644
--- a/extensions/browser/src/browser/errors.test.ts
+++ b/extensions/browser/src/browser/errors.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover errors plugin behavior.
 import { describe, expect, it } from "vitest";
 import { BrowserTabNotFoundError } from "./errors.js";
 
diff --git a/extensions/browser/src/browser/navigation-guard.test.ts b/extensions/browser/src/browser/navigation-guard.test.ts
index c815648fce5d..7edc29701c8f 100644
--- a/extensions/browser/src/browser/navigation-guard.test.ts
+++ b/extensions/browser/src/browser/navigation-guard.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover navigation guard plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { SsrFBlockedError, type LookupFn } from "../infra/net/ssrf.js";
 import {
diff --git a/extensions/browser/src/browser/output-directories.test.ts b/extensions/browser/src/browser/output-directories.test.ts
index 3bff524355c8..6b3ac905fc1b 100644
--- a/extensions/browser/src/browser/output-directories.test.ts
+++ b/extensions/browser/src/browser/output-directories.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover output directories plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/paths.test.ts b/extensions/browser/src/browser/paths.test.ts
index 9489d681c85b..ba5b0380be4d 100644
--- a/extensions/browser/src/browser/paths.test.ts
+++ b/extensions/browser/src/browser/paths.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover paths plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/profiles-service.test.ts b/extensions/browser/src/browser/profiles-service.test.ts
index 9210bc8dda11..d1ad4b36d5ae 100644
--- a/extensions/browser/src/browser/profiles-service.test.ts
+++ b/extensions/browser/src/browser/profiles-service.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover profiles service plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/browser/src/browser/profiles.test.ts b/extensions/browser/src/browser/profiles.test.ts
index 5b54516c2128..412a6cec2478 100644
--- a/extensions/browser/src/browser/profiles.test.ts
+++ b/extensions/browser/src/browser/profiles.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover profiles plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveBrowserConfig } from "./config.js";
 import {
diff --git a/extensions/browser/src/browser/proxy-files.test.ts b/extensions/browser/src/browser/proxy-files.test.ts
index 09d566580a18..19d7be52c147 100644
--- a/extensions/browser/src/browser/proxy-files.test.ts
+++ b/extensions/browser/src/browser/proxy-files.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover proxy files plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { MEDIA_MAX_BYTES } from "openclaw/plugin-sdk/media-runtime";
diff --git a/extensions/browser/src/browser/pw-ai.e2e.test.ts b/extensions/browser/src/browser/pw-ai.e2e.test.ts
index b671048591b6..1cfcd32dd199 100644
--- a/extensions/browser/src/browser/pw-ai.e2e.test.ts
+++ b/extensions/browser/src/browser/pw-ai.e2e.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw ai plugin behavior.
 import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
 import { connectOverCdpMock, getChromeWebSocketUrlMock } from "./pw-session.mock-setup.js";
 
diff --git a/extensions/browser/src/browser/pw-role-snapshot.test.ts b/extensions/browser/src/browser/pw-role-snapshot.test.ts
index 3c1a13ef7c2e..ed4957f053f5 100644
--- a/extensions/browser/src/browser/pw-role-snapshot.test.ts
+++ b/extensions/browser/src/browser/pw-role-snapshot.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw role snapshot plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildRoleSnapshotFromAiSnapshot,
diff --git a/extensions/browser/src/browser/pw-session.assert-navigation-safety.test.ts b/extensions/browser/src/browser/pw-session.assert-navigation-safety.test.ts
index dfcb5462b87e..c90666e21b1b 100644
--- a/extensions/browser/src/browser/pw-session.assert-navigation-safety.test.ts
+++ b/extensions/browser/src/browser/pw-session.assert-navigation-safety.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw session.assert navigation safety plugin behavior.
 import type { Page } from "playwright-core";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { SsrFBlockedError } from "../infra/net/ssrf.js";
diff --git a/extensions/browser/src/browser/pw-session.browserless.live.test.ts b/extensions/browser/src/browser/pw-session.browserless.live.test.ts
index 19030387c1f5..5ad0e12b3ed2 100644
--- a/extensions/browser/src/browser/pw-session.browserless.live.test.ts
+++ b/extensions/browser/src/browser/pw-session.browserless.live.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw sessionless plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isLiveTestEnabled } from "../../test-support.js";
 
diff --git a/extensions/browser/src/browser/pw-session.connections.test.ts b/extensions/browser/src/browser/pw-session.connections.test.ts
index 666e6aaec20d..49f322ec20a2 100644
--- a/extensions/browser/src/browser/pw-session.connections.test.ts
+++ b/extensions/browser/src/browser/pw-session.connections.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw session.connections plugin behavior.
 import { chromium } from "playwright-core";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import * as chromeModule from "./chrome.js";
diff --git a/extensions/browser/src/browser/pw-session.create-page.navigation-guard.test.ts b/extensions/browser/src/browser/pw-session.create-page.navigation-guard.test.ts
index 19e9f0621ad6..3947f7d4fece 100644
--- a/extensions/browser/src/browser/pw-session.create-page.navigation-guard.test.ts
+++ b/extensions/browser/src/browser/pw-session.create-page.navigation-guard.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw session.create page.navigation guard plugin behavior.
 import { chromium } from "playwright-core";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { SsrFBlockedError } from "../infra/net/ssrf.js";
diff --git a/extensions/browser/src/browser/pw-session.dialogs.test.ts b/extensions/browser/src/browser/pw-session.dialogs.test.ts
index 5042a1ee0435..ca9a7700e823 100644
--- a/extensions/browser/src/browser/pw-session.dialogs.test.ts
+++ b/extensions/browser/src/browser/pw-session.dialogs.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw sessionialogs plugin behavior.
 import { MAX_DATE_TIMESTAMP_MS } from "openclaw/plugin-sdk/number-runtime";
 import type { Dialog, Page } from "playwright-core";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/browser/src/browser/pw-session.get-page-for-targetid.extension-fallback.test.ts b/extensions/browser/src/browser/pw-session.get-page-for-targetid.extension-fallback.test.ts
index 8dd667834347..eee37e9d26d0 100644
--- a/extensions/browser/src/browser/pw-session.get-page-for-targetid.extension-fallback.test.ts
+++ b/extensions/browser/src/browser/pw-session.get-page-for-targetid.extension-fallback.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw session.get page for targetid.extension fallback plugin behavior.
 import { chromium } from "playwright-core";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import * as chromeModule from "./chrome.js";
diff --git a/extensions/browser/src/browser/pw-session.page-cdp.test.ts b/extensions/browser/src/browser/pw-session.page-cdp.test.ts
index 217de9865f48..f20d8bf50ef0 100644
--- a/extensions/browser/src/browser/pw-session.page-cdp.test.ts
+++ b/extensions/browser/src/browser/pw-session.page-cdp.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw session.page cdp plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   BROWSER_REF_MARKER_ATTRIBUTE,
diff --git a/extensions/browser/src/browser/pw-session.test.ts b/extensions/browser/src/browser/pw-session.test.ts
index ccf276db5774..75f0207ac6d7 100644
--- a/extensions/browser/src/browser/pw-session.test.ts
+++ b/extensions/browser/src/browser/pw-session.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw session plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import type { Page } from "playwright-core";
diff --git a/extensions/browser/src/browser/pw-tools-core.browser-ssrf-guard.test.ts b/extensions/browser/src/browser/pw-tools-core.browser-ssrf-guard.test.ts
index d1acd86c3a6e..4b1c3b2f2877 100644
--- a/extensions/browser/src/browser/pw-tools-core.browser-ssrf-guard.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.browser-ssrf-guard.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core ssrf guard plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const pageState = vi.hoisted(() => ({
diff --git a/extensions/browser/src/browser/pw-tools-core.clamps-timeoutms-scrollintoview.test.ts b/extensions/browser/src/browser/pw-tools-core.clamps-timeoutms-scrollintoview.test.ts
index 82ad1bb762cd..cbab8a85bfb3 100644
--- a/extensions/browser/src/browser/pw-tools-core.clamps-timeoutms-scrollintoview.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.clamps-timeoutms-scrollintoview.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.clamps timeoutms scrollintoview plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   installPwToolsCoreTestHooks,
diff --git a/extensions/browser/src/browser/pw-tools-core.interactions.batch.test.ts b/extensions/browser/src/browser/pw-tools-core.interactions.batch.test.ts
index 679273c9d5d5..6c5ed85ffe30 100644
--- a/extensions/browser/src/browser/pw-tools-core.interactions.batch.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.interactions.batch.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.interactions.batch plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 let page: {
diff --git a/extensions/browser/src/browser/pw-tools-core.interactions.evaluate.abort.test.ts b/extensions/browser/src/browser/pw-tools-core.interactions.evaluate.abort.test.ts
index c3b9628407a1..ddd40a203a9a 100644
--- a/extensions/browser/src/browser/pw-tools-core.interactions.evaluate.abort.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.interactions.evaluate.abort.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.interactions.evaluate.abort plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 let page: { evaluate: ReturnType<typeof vi.fn>; url: ReturnType<typeof vi.fn> } | null = null;
diff --git a/extensions/browser/src/browser/pw-tools-core.interactions.navigation-guard.test.ts b/extensions/browser/src/browser/pw-tools-core.interactions.navigation-guard.test.ts
index 4a32090b215d..495a7c632ece 100644
--- a/extensions/browser/src/browser/pw-tools-core.interactions.navigation-guard.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.interactions.navigation-guard.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.interactions.navigation guard plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   getPwToolsCoreNavigationGuardMocks,
diff --git a/extensions/browser/src/browser/pw-tools-core.interactions.set-input-files.test.ts b/extensions/browser/src/browser/pw-tools-core.interactions.set-input-files.test.ts
index 65a339af2c18..742624f378f0 100644
--- a/extensions/browser/src/browser/pw-tools-core.interactions.set-input-files.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.interactions.set-input-files.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.interactions.set input files plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 let page: Record<string, unknown> | null = null;
diff --git a/extensions/browser/src/browser/pw-tools-core.last-file-chooser-arm-wins.test.ts b/extensions/browser/src/browser/pw-tools-core.last-file-chooser-arm-wins.test.ts
index 9128fbf4df6b..85f4a0c98dbb 100644
--- a/extensions/browser/src/browser/pw-tools-core.last-file-chooser-arm-wins.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.last-file-chooser-arm-wins.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.last file chooser arm wins plugin behavior.
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/pw-tools-core.screenshots-element-selector.test.ts b/extensions/browser/src/browser/pw-tools-core.screenshots-element-selector.test.ts
index c9c73531bc5c..cabcc267a6bb 100644
--- a/extensions/browser/src/browser/pw-tools-core.screenshots-element-selector.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.screenshots-element-selector.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.screenshots element selector plugin behavior.
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/pw-tools-core.shared.test.ts b/extensions/browser/src/browser/pw-tools-core.shared.test.ts
index b792b01febe6..95bed5001bc4 100644
--- a/extensions/browser/src/browser/pw-tools-core.shared.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.shared.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeTimeoutMs } from "./pw-tools-core.shared.js";
 
diff --git a/extensions/browser/src/browser/pw-tools-core.snapshot.navigate-guard.test.ts b/extensions/browser/src/browser/pw-tools-core.snapshot.navigate-guard.test.ts
index fd5e5a3203f6..5b19c7d16550 100644
--- a/extensions/browser/src/browser/pw-tools-core.snapshot.navigate-guard.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.snapshot.navigate-guard.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.snapshot.navigate guard plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { SsrFBlockedError } from "../infra/net/ssrf.js";
 import "../test-support/browser-security.mock.js";
diff --git a/extensions/browser/src/browser/pw-tools-core.snapshot.test.ts b/extensions/browser/src/browser/pw-tools-core.snapshot.test.ts
index 1e50c26fe511..e5682530ff95 100644
--- a/extensions/browser/src/browser/pw-tools-core.snapshot.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.snapshot.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.snapshot plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const getPageForTargetId = vi.fn();
diff --git a/extensions/browser/src/browser/pw-tools-core.upload-paths.test.ts b/extensions/browser/src/browser/pw-tools-core.upload-paths.test.ts
index 856573ac6e60..3e6a58fb03b7 100644
--- a/extensions/browser/src/browser/pw-tools-core.upload-paths.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.upload-paths.test.ts
@@ -1,12 +1,17 @@
+// Browser tests cover pw tools core.upload paths plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
-import { installPwToolsCoreTestHooks, setPwToolsCoreCurrentPage } from "./pw-tools-core.test-harness.js";
+import {
+  installPwToolsCoreTestHooks,
+  setPwToolsCoreCurrentPage,
+} from "./pw-tools-core.test-harness.js";
 
 const pathMocks = vi.hoisted(() => ({
-  resolveStrictExistingUploadPaths: vi.fn<
-    (args: { requestedPaths: string[] }) => Promise<
-      { ok: true; paths: string[] } | { ok: false; error: string }
-    >
-  >(),
+  resolveStrictExistingUploadPaths:
+    vi.fn<
+      (args: {
+        requestedPaths: string[];
+      }) => Promise<{ ok: true; paths: string[] } | { ok: false; error: string }>
+    >(),
 }));
 
 vi.mock("./paths.js", async (importOriginal) => {
diff --git a/extensions/browser/src/browser/pw-tools-core.waits-next-download-saves-it.test.ts b/extensions/browser/src/browser/pw-tools-core.waits-next-download-saves-it.test.ts
index 34ec9cfc8845..75cbeb7e09b2 100644
--- a/extensions/browser/src/browser/pw-tools-core.waits-next-download-saves-it.test.ts
+++ b/extensions/browser/src/browser/pw-tools-core.waits-next-download-saves-it.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.waits next download saves it plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/request-policy.test.ts b/extensions/browser/src/browser/request-policy.test.ts
index f5d032a4c611..2ab4a26329bd 100644
--- a/extensions/browser/src/browser/request-policy.test.ts
+++ b/extensions/browser/src/browser/request-policy.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover request policy plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isPersistentBrowserProfileMutation } from "./request-policy.js";
 import { matchBrowserUrlPattern } from "./url-pattern.js";
diff --git a/extensions/browser/src/browser/routes/agent.act.existing-session-navigation-guard.test.ts b/extensions/browser/src/browser/routes/agent.act.existing-session-navigation-guard.test.ts
index 3c9356d0fc6d..147e5a61d10d 100644
--- a/extensions/browser/src/browser/routes/agent.act.existing-session-navigation-guard.test.ts
+++ b/extensions/browser/src/browser/routes/agent.act.existing-session-navigation-guard.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.act.existing session navigation guard plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   createExistingSessionAgentSharedModule,
diff --git a/extensions/browser/src/browser/routes/agent.act.normalize.test.ts b/extensions/browser/src/browser/routes/agent.act.normalize.test.ts
index aef6876182b6..20e5ba9d4c9f 100644
--- a/extensions/browser/src/browser/routes/agent.act.normalize.test.ts
+++ b/extensions/browser/src/browser/routes/agent.act.normalize.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.act.normalize plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MAX_SAFE_TIMEOUT_DELAY_MS } from "../timer-delay.js";
 import { normalizeActRequest } from "./agent.act.normalize.js";
diff --git a/extensions/browser/src/browser/routes/agent.existing-session.test.ts b/extensions/browser/src/browser/routes/agent.existing-session.test.ts
index 5441d22598ad..bcfd4d1dfe13 100644
--- a/extensions/browser/src/browser/routes/agent.existing-session.test.ts
+++ b/extensions/browser/src/browser/routes/agent.existing-session.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.existing session plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { EXISTING_SESSION_LIMITS } from "./existing-session-limits.js";
 import {
diff --git a/extensions/browser/src/browser/routes/agent.shared.test.ts b/extensions/browser/src/browser/routes/agent.shared.test.ts
index a101aaf30e55..a47451874c9d 100644
--- a/extensions/browser/src/browser/routes/agent.shared.test.ts
+++ b/extensions/browser/src/browser/routes/agent.shared.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.shared plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { BrowserRouteContext, ProfileContext } from "../server-context.js";
 import "../../test-support/browser-security.mock.js";
diff --git a/extensions/browser/src/browser/routes/agent.snapshot.local-managed.test.ts b/extensions/browser/src/browser/routes/agent.snapshot.local-managed.test.ts
index 12f99e208414..03c27628cb2b 100644
--- a/extensions/browser/src/browser/routes/agent.snapshot.local-managed.test.ts
+++ b/extensions/browser/src/browser/routes/agent.snapshot.local-managed.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.snapshot.local managed plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
 import type { BrowserRequest } from "./types.js";
diff --git a/extensions/browser/src/browser/routes/agent.snapshot.plan.test.ts b/extensions/browser/src/browser/routes/agent.snapshot.plan.test.ts
index 7d421d88bf59..814d222e248b 100644
--- a/extensions/browser/src/browser/routes/agent.snapshot.plan.test.ts
+++ b/extensions/browser/src/browser/routes/agent.snapshot.plan.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.snapshot.plan plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { ResolvedBrowserProfile } from "../config.js";
 import { DEFAULT_AI_SNAPSHOT_MAX_CHARS } from "../constants.js";
diff --git a/extensions/browser/src/browser/routes/agent.snapshot.test.ts b/extensions/browser/src/browser/routes/agent.snapshot.test.ts
index ebd1828ade5e..1b672bffeebd 100644
--- a/extensions/browser/src/browser/routes/agent.snapshot.test.ts
+++ b/extensions/browser/src/browser/routes/agent.snapshot.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.snapshot plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveTargetIdAfterNavigate } from "./agent.snapshot-target.js";
 
diff --git a/extensions/browser/src/browser/routes/agent.snapshot.timeout.test.ts b/extensions/browser/src/browser/routes/agent.snapshot.timeout.test.ts
index 3c3afbebcf41..fdd323a27a4b 100644
--- a/extensions/browser/src/browser/routes/agent.snapshot.timeout.test.ts
+++ b/extensions/browser/src/browser/routes/agent.snapshot.timeout.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.snapshot.timeout plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
 
diff --git a/extensions/browser/src/browser/routes/agent.storage.test.ts b/extensions/browser/src/browser/routes/agent.storage.test.ts
index 12e386475308..f0885c1aa553 100644
--- a/extensions/browser/src/browser/routes/agent.storage.test.ts
+++ b/extensions/browser/src/browser/routes/agent.storage.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover agent.storage plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   parseCookieSetOptions,
diff --git a/extensions/browser/src/browser/routes/basic.existing-session.test.ts b/extensions/browser/src/browser/routes/basic.existing-session.test.ts
index fdb2b79f0e9d..1b468220efe9 100644
--- a/extensions/browser/src/browser/routes/basic.existing-session.test.ts
+++ b/extensions/browser/src/browser/routes/basic.existing-session.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover basic.existing session plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
 
diff --git a/extensions/browser/src/browser/routes/dispatcher.abort.test.ts b/extensions/browser/src/browser/routes/dispatcher.abort.test.ts
index b2cdc7caf4f7..83eb72469829 100644
--- a/extensions/browser/src/browser/routes/dispatcher.abort.test.ts
+++ b/extensions/browser/src/browser/routes/dispatcher.abort.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover dispatcher.abort plugin behavior.
 import { beforeAll, describe, expect, it, vi } from "vitest";
 import type { BrowserRouteContext } from "../server-context.js";
 
diff --git a/extensions/browser/src/browser/routes/permissions.test.ts b/extensions/browser/src/browser/routes/permissions.test.ts
index a9f3e90a8887..297428b58c14 100644
--- a/extensions/browser/src/browser/routes/permissions.test.ts
+++ b/extensions/browser/src/browser/routes/permissions.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover permissions plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
 
diff --git a/extensions/browser/src/browser/routes/route-numeric.test.ts b/extensions/browser/src/browser/routes/route-numeric.test.ts
index 81fb80303b45..65213ed0cab8 100644
--- a/extensions/browser/src/browser/routes/route-numeric.test.ts
+++ b/extensions/browser/src/browser/routes/route-numeric.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover route numeric plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MAX_SAFE_TIMEOUT_DELAY_MS } from "../timer-delay.js";
 import { readRouteTimerTimeoutMs } from "./route-numeric.js";
diff --git a/extensions/browser/src/browser/routes/tabs.attach-only.test.ts b/extensions/browser/src/browser/routes/tabs.attach-only.test.ts
index e0c3ffca3575..2ecd3b6870d0 100644
--- a/extensions/browser/src/browser/routes/tabs.attach-only.test.ts
+++ b/extensions/browser/src/browser/routes/tabs.attach-only.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover tabs.attach only plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import "../../../test-support.js";
 import "../server-context.chrome-test-harness.js";
diff --git a/extensions/browser/src/browser/routes/tabs.test.ts b/extensions/browser/src/browser/routes/tabs.test.ts
index 65d03324d263..3c3960615c94 100644
--- a/extensions/browser/src/browser/routes/tabs.test.ts
+++ b/extensions/browser/src/browser/routes/tabs.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover tabs plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
diff --git a/extensions/browser/src/browser/runtime-lifecycle.unhandled-rejections.test.ts b/extensions/browser/src/browser/runtime-lifecycle.unhandled-rejections.test.ts
index 35f6c663db19..542ac95c0884 100644
--- a/extensions/browser/src/browser/runtime-lifecycle.unhandled-rejections.test.ts
+++ b/extensions/browser/src/browser/runtime-lifecycle.unhandled-rejections.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover runtime lifecycle.unhandled rejections plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { getUnhandledRejectionHandlers, registerUnhandledRejectionHandlerMock, resetHandlers } =
diff --git a/extensions/browser/src/browser/screenshot.test.ts b/extensions/browser/src/browser/screenshot.test.ts
index c7d8c11c5550..f5cee273b969 100644
--- a/extensions/browser/src/browser/screenshot.test.ts
+++ b/extensions/browser/src/browser/screenshot.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover screenshot plugin behavior.
 import fs from "node:fs/promises";
 import { getImageMetadata } from "openclaw/plugin-sdk/media-runtime";
 import { createSolidPngBuffer } from "openclaw/plugin-sdk/test-fixtures";
diff --git a/extensions/browser/src/browser/server-context.ensure-browser-available.waits-for-cdp-ready.test.ts b/extensions/browser/src/browser/server-context.ensure-browser-available.waits-for-cdp-ready.test.ts
index ce882523cc17..568a7e6afa96 100644
--- a/extensions/browser/src/browser/server-context.ensure-browser-available.waits-for-cdp-ready.test.ts
+++ b/extensions/browser/src/browser/server-context.ensure-browser-available.waits-for-cdp-ready.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.ensure browser available.waits for cdp ready plugin behavior.
 import type { ChildProcessWithoutNullStreams } from "node:child_process";
 import { EventEmitter } from "node:events";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/browser/src/browser/server-context.existing-session.test.ts b/extensions/browser/src/browser/server-context.existing-session.test.ts
index 249f6516a0d7..597c31ed5c53 100644
--- a/extensions/browser/src/browser/server-context.existing-session.test.ts
+++ b/extensions/browser/src/browser/server-context.existing-session.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.existing session plugin behavior.
 import fs from "node:fs";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import "../test-support/browser-security.mock.js";
diff --git a/extensions/browser/src/browser/server-context.hot-reload-profiles.test.ts b/extensions/browser/src/browser/server-context.hot-reload-profiles.test.ts
index fa492bbf58ca..fd6fb5f10fef 100644
--- a/extensions/browser/src/browser/server-context.hot-reload-profiles.test.ts
+++ b/extensions/browser/src/browser/server-context.hot-reload-profiles.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.hot reload profiles plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { BrowserServerState } from "./server-context.types.js";
 
diff --git a/extensions/browser/src/browser/server-context.lifecycle.test.ts b/extensions/browser/src/browser/server-context.lifecycle.test.ts
index 179bdb58704c..c0a2ddb87ac0 100644
--- a/extensions/browser/src/browser/server-context.lifecycle.test.ts
+++ b/extensions/browser/src/browser/server-context.lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.lifecycle plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveIdleProfileStopOutcome } from "./server-context.lifecycle.js";
 import { makeBrowserProfile } from "./server-context.test-harness.js";
diff --git a/extensions/browser/src/browser/server-context.list-profiles.test.ts b/extensions/browser/src/browser/server-context.list-profiles.test.ts
index e0ac776eee13..fae61ecebcaf 100644
--- a/extensions/browser/src/browser/server-context.list-profiles.test.ts
+++ b/extensions/browser/src/browser/server-context.list-profiles.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.list profiles plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import "./server-context.chrome-test-harness.js";
 import * as chromeModule from "./chrome.js";
diff --git a/extensions/browser/src/browser/server-context.loopback-direct-ws.test.ts b/extensions/browser/src/browser/server-context.loopback-direct-ws.test.ts
index 9bbc318875be..bebd01970a79 100644
--- a/extensions/browser/src/browser/server-context.loopback-direct-ws.test.ts
+++ b/extensions/browser/src/browser/server-context.loopback-direct-ws.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.loopback direct ws plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { withBrowserFetchPreconnect } from "../../test-fetch.js";
 import * as cdpModule from "./cdp.js";
diff --git a/extensions/browser/src/browser/server-context.remote-profile-tab-ops.fallback.test.ts b/extensions/browser/src/browser/server-context.remote-profile-tab-ops.fallback.test.ts
index 80b3872ef0b7..eb880b51edb1 100644
--- a/extensions/browser/src/browser/server-context.remote-profile-tab-ops.fallback.test.ts
+++ b/extensions/browser/src/browser/server-context.remote-profile-tab-ops.fallback.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.remote profile tab ops.fallback plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { withBrowserFetchPreconnect } from "../../test-fetch.js";
 import {
diff --git a/extensions/browser/src/browser/server-context.remote-profile-tab-ops.playwright.test.ts b/extensions/browser/src/browser/server-context.remote-profile-tab-ops.playwright.test.ts
index 7d27f9619ca9..af5836da87b2 100644
--- a/extensions/browser/src/browser/server-context.remote-profile-tab-ops.playwright.test.ts
+++ b/extensions/browser/src/browser/server-context.remote-profile-tab-ops.playwright.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.remote profile tab ops.playwright plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   installRemoteProfileTestLifecycle,
diff --git a/extensions/browser/src/browser/server-context.reset.test.ts b/extensions/browser/src/browser/server-context.reset.test.ts
index b427de09ea0d..b477aff847b9 100644
--- a/extensions/browser/src/browser/server-context.reset.test.ts
+++ b/extensions/browser/src/browser/server-context.reset.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.reset plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/server-context.stop-running-browser.test.ts b/extensions/browser/src/browser/server-context.stop-running-browser.test.ts
index cf313dc65f9c..2aab68abafbb 100644
--- a/extensions/browser/src/browser/server-context.stop-running-browser.test.ts
+++ b/extensions/browser/src/browser/server-context.stop-running-browser.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.stop running browser plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteContext } from "./server-context.js";
 import { makeBrowserProfile, makeBrowserServerState } from "./server-context.test-harness.js";
diff --git a/extensions/browser/src/browser/server-context.tab-selection-state.test.ts b/extensions/browser/src/browser/server-context.tab-selection-state.test.ts
index ce427443e63f..958493edb953 100644
--- a/extensions/browser/src/browser/server-context.tab-selection-state.test.ts
+++ b/extensions/browser/src/browser/server-context.tab-selection-state.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server context.tab selection state plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { withBrowserFetchPreconnect } from "../../test-fetch.js";
 import "../test-support/browser-security.mock.js";
diff --git a/extensions/browser/src/browser/server-lifecycle.test.ts b/extensions/browser/src/browser/server-lifecycle.test.ts
index 85b0500108f2..89668afa4305 100644
--- a/extensions/browser/src/browser/server-lifecycle.test.ts
+++ b/extensions/browser/src/browser/server-lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server lifecycle plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { stopOpenClawChromeMock } = vi.hoisted(() => ({
diff --git a/extensions/browser/src/browser/server.agent-contract-core.test.ts b/extensions/browser/src/browser/server.agent-contract-core.test.ts
index 68941c9d1888..ec7e1aa42c73 100644
--- a/extensions/browser/src/browser/server.agent-contract-core.test.ts
+++ b/extensions/browser/src/browser/server.agent-contract-core.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server.agent contract core plugin behavior.
 import fs from "node:fs";
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { DEFAULT_AI_SNAPSHOT_MAX_CHARS } from "./constants.js";
diff --git a/extensions/browser/src/browser/server.agent-contract-form-layout-act-commands.test.ts b/extensions/browser/src/browser/server.agent-contract-form-layout-act-commands.test.ts
index 653165d39deb..d23335ed508c 100644
--- a/extensions/browser/src/browser/server.agent-contract-form-layout-act-commands.test.ts
+++ b/extensions/browser/src/browser/server.agent-contract-form-layout-act-commands.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server.agent contract form layout act commands plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/server.auth-fail-closed.test.ts b/extensions/browser/src/browser/server.auth-fail-closed.test.ts
index 5eee9ec12c6c..cc2ac4bc5ab0 100644
--- a/extensions/browser/src/browser/server.auth-fail-closed.test.ts
+++ b/extensions/browser/src/browser/server.auth-fail-closed.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server.auth fail closed plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { startBrowserControlServerFromConfig, stopBrowserControlServer } from "../server.js";
 import { getFreePort } from "./test-port.js";
diff --git a/extensions/browser/src/browser/server.auth-token-gates-http.test.ts b/extensions/browser/src/browser/server.auth-token-gates-http.test.ts
index a3656d538070..5f2102e99de4 100644
--- a/extensions/browser/src/browser/server.auth-token-gates-http.test.ts
+++ b/extensions/browser/src/browser/server.auth-token-gates-http.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server.auth token gates http plugin behavior.
 import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
 import { afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import { isAuthorizedBrowserRequest } from "./http-auth.js";
diff --git a/extensions/browser/src/browser/server.evaluate-disabled-does-not-block-storage.test.ts b/extensions/browser/src/browser/server.evaluate-disabled-does-not-block-storage.test.ts
index 56ffb6fb4400..3216ed9aaba4 100644
--- a/extensions/browser/src/browser/server.evaluate-disabled-does-not-block-storage.test.ts
+++ b/extensions/browser/src/browser/server.evaluate-disabled-does-not-block-storage.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover server.evaluate disabled does not block storage plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { getFreePort } from "./test-port.js";
 import { getBrowserTestFetch } from "./test-support/fetch.js";
diff --git a/extensions/browser/src/browser/session-tab-cleanup.test.ts b/extensions/browser/src/browser/session-tab-cleanup.test.ts
index fe3a24ceca56..22072e43c1c6 100644
--- a/extensions/browser/src/browser/session-tab-cleanup.test.ts
+++ b/extensions/browser/src/browser/session-tab-cleanup.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover session tab cleanup plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   isPrimaryTrackedBrowserSessionKey,
diff --git a/extensions/browser/src/browser/session-tab-registry.test.ts b/extensions/browser/src/browser/session-tab-registry.test.ts
index 8b78de990d55..ed762571073d 100644
--- a/extensions/browser/src/browser/session-tab-registry.test.ts
+++ b/extensions/browser/src/browser/session-tab-registry.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover session tab registry plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   countTrackedSessionBrowserTabsForTests,
diff --git a/extensions/browser/src/browser/target-id.test.ts b/extensions/browser/src/browser/target-id.test.ts
index 5a655f9d52c4..0fb97f77b0ff 100644
--- a/extensions/browser/src/browser/target-id.test.ts
+++ b/extensions/browser/src/browser/target-id.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover target id plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveTargetIdFromTabs } from "./target-id.js";
 
diff --git a/extensions/browser/src/browser/timer-delay.test.ts b/extensions/browser/src/browser/timer-delay.test.ts
index d0b18e4d824b..a5f3d58464dc 100644
--- a/extensions/browser/src/browser/timer-delay.test.ts
+++ b/extensions/browser/src/browser/timer-delay.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover timer delay plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MAX_SAFE_TIMEOUT_DELAY_MS, normalizeBrowserTimerDelayMs } from "./timer-delay.js";
 
diff --git a/extensions/browser/src/browser/trash.test.ts b/extensions/browser/src/browser/trash.test.ts
index 560c9709464b..0258dbc31ae3 100644
--- a/extensions/browser/src/browser/trash.test.ts
+++ b/extensions/browser/src/browser/trash.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover trash plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/browser/src/browser/vision.test.ts b/extensions/browser/src/browser/vision.test.ts
index 79865c3ed4ef..cfb24039ec37 100644
--- a/extensions/browser/src/browser/vision.test.ts
+++ b/extensions/browser/src/browser/vision.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover vision plugin behavior.
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/browser/src/cli/browser-cli-actions-input/register.element.test.ts b/extensions/browser/src/cli/browser-cli-actions-input/register.element.test.ts
index 04c95ae87a51..11416204517b 100644
--- a/extensions/browser/src/cli/browser-cli-actions-input/register.element.test.ts
+++ b/extensions/browser/src/cli/browser-cli-actions-input/register.element.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover register.element plugin behavior.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as browserCliSharedModule from "../browser-cli-shared.js";
diff --git a/extensions/browser/src/cli/browser-cli-actions-input/register.files-downloads.test.ts b/extensions/browser/src/cli/browser-cli-actions-input/register.files-downloads.test.ts
index 9f1b24af7269..a8dfc28cbf87 100644
--- a/extensions/browser/src/cli/browser-cli-actions-input/register.files-downloads.test.ts
+++ b/extensions/browser/src/cli/browser-cli-actions-input/register.files-downloads.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover register.files downloads plugin behavior.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as browserCliSharedModule from "../browser-cli-shared.js";
diff --git a/extensions/browser/src/cli/browser-cli-actions-input/register.form-wait-eval.test.ts b/extensions/browser/src/cli/browser-cli-actions-input/register.form-wait-eval.test.ts
index 6120a9cd20e1..1e8ce6fafa22 100644
--- a/extensions/browser/src/cli/browser-cli-actions-input/register.form-wait-eval.test.ts
+++ b/extensions/browser/src/cli/browser-cli-actions-input/register.form-wait-eval.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover register.form wait eval plugin behavior.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as browserCliSharedModule from "../browser-cli-shared.js";
diff --git a/extensions/browser/src/cli/browser-cli-actions-input/register.navigation.test.ts b/extensions/browser/src/cli/browser-cli-actions-input/register.navigation.test.ts
index fb01dedc03e5..8fe0e5bcc217 100644
--- a/extensions/browser/src/cli/browser-cli-actions-input/register.navigation.test.ts
+++ b/extensions/browser/src/cli/browser-cli-actions-input/register.navigation.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover register.navigation plugin behavior.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as browserCliResizeModule from "../browser-cli-resize.js";
diff --git a/extensions/browser/src/cli/browser-cli-actions-input/shared.test.ts b/extensions/browser/src/cli/browser-cli-actions-input/shared.test.ts
index f3b4e73b0d30..066759369c21 100644
--- a/extensions/browser/src/cli/browser-cli-actions-input/shared.test.ts
+++ b/extensions/browser/src/cli/browser-cli-actions-input/shared.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import { readFields } from "./shared.js";
 
diff --git a/extensions/browser/src/cli/browser-cli-actions-observe.test.ts b/extensions/browser/src/cli/browser-cli-actions-observe.test.ts
index 82c62e9e45c3..acad0b50242b 100644
--- a/extensions/browser/src/cli/browser-cli-actions-observe.test.ts
+++ b/extensions/browser/src/cli/browser-cli-actions-observe.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser cli actions observe plugin behavior.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as browserCliSharedModule from "./browser-cli-shared.js";
diff --git a/extensions/browser/src/cli/browser-cli-inspect.test.ts b/extensions/browser/src/cli/browser-cli-inspect.test.ts
index def62510ba46..93cda4bd6188 100644
--- a/extensions/browser/src/cli/browser-cli-inspect.test.ts
+++ b/extensions/browser/src/cli/browser-cli-inspect.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser cli inspect plugin behavior.
 import { Command } from "commander";
 import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
 import { createCliRuntimeCapture } from "../../test-support.js";
diff --git a/extensions/browser/src/cli/browser-cli-manage.test.ts b/extensions/browser/src/cli/browser-cli-manage.test.ts
index 80dfbaac2d9f..ae008f25afb5 100644
--- a/extensions/browser/src/cli/browser-cli-manage.test.ts
+++ b/extensions/browser/src/cli/browser-cli-manage.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser cli manage plugin behavior.
 import { beforeEach, describe, expect, it } from "vitest";
 import {
   createBrowserManageProgram,
diff --git a/extensions/browser/src/cli/browser-cli-manage.timeout-option.test.ts b/extensions/browser/src/cli/browser-cli-manage.timeout-option.test.ts
index 68d73fcaf71e..f6d137b9bf0b 100644
--- a/extensions/browser/src/cli/browser-cli-manage.timeout-option.test.ts
+++ b/extensions/browser/src/cli/browser-cli-manage.timeout-option.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser cli manage.timeout option plugin behavior.
 import { beforeEach, describe, expect, it } from "vitest";
 import {
   createBrowserManageProgram,
diff --git a/extensions/browser/src/cli/browser-cli-shared.test.ts b/extensions/browser/src/cli/browser-cli-shared.test.ts
index 649f187eb16e..8cd6e7e7ee46 100644
--- a/extensions/browser/src/cli/browser-cli-shared.test.ts
+++ b/extensions/browser/src/cli/browser-cli-shared.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser cli shared plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { callGatewayFromCli } from "./core-api.js";
 
diff --git a/extensions/browser/src/cli/browser-cli-state.option-collisions.test.ts b/extensions/browser/src/cli/browser-cli-state.option-collisions.test.ts
index 2b8b96683e49..3b34124b3256 100644
--- a/extensions/browser/src/cli/browser-cli-state.option-collisions.test.ts
+++ b/extensions/browser/src/cli/browser-cli-state.option-collisions.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser cli state.option collisions plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as parentCoreApiModule from "../core-api.js";
 import * as browserCliResizeModule from "./browser-cli-resize.js";
diff --git a/extensions/browser/src/cli/browser-cli.lazy.test.ts b/extensions/browser/src/cli/browser-cli.lazy.test.ts
index 3331ed55cf6d..3d1ec4acd992 100644
--- a/extensions/browser/src/cli/browser-cli.lazy.test.ts
+++ b/extensions/browser/src/cli/browser-cli.lazy.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser cli.lazy plugin behavior.
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/browser/src/cli/browser-cli.test.ts b/extensions/browser/src/cli/browser-cli.test.ts
index 56bcbce2bdc1..5b5ea89cea66 100644
--- a/extensions/browser/src/cli/browser-cli.test.ts
+++ b/extensions/browser/src/cli/browser-cli.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser cli plugin behavior.
 import { Command } from "commander";
 import { describe, expect, it } from "vitest";
 
diff --git a/extensions/browser/src/doctor-browser.test.ts b/extensions/browser/src/doctor-browser.test.ts
index 5c74decb2631..76e3037b23f9 100644
--- a/extensions/browser/src/doctor-browser.test.ts
+++ b/extensions/browser/src/doctor-browser.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover doctor browser plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   maybeArchiveLegacyClawdBrowserProfileResidue,
diff --git a/extensions/browser/src/gateway/browser-request.profile-from-body.test.ts b/extensions/browser/src/gateway/browser-request.profile-from-body.test.ts
index 0051029047dc..0d69fbd9a427 100644
--- a/extensions/browser/src/gateway/browser-request.profile-from-body.test.ts
+++ b/extensions/browser/src/gateway/browser-request.profile-from-body.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser request.profile from body plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { loadConfigMock, isNodeCommandAllowedMock, resolveNodeCommandAllowlistMock } = vi.hoisted(
diff --git a/extensions/browser/src/gateway/browser-request.shared-control-state.test.ts b/extensions/browser/src/gateway/browser-request.shared-control-state.test.ts
index eac0117ea37e..b1b882693462 100644
--- a/extensions/browser/src/gateway/browser-request.shared-control-state.test.ts
+++ b/extensions/browser/src/gateway/browser-request.shared-control-state.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser request.shared control state plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { getFreePort } from "../browser/test-port.js";
 import type { OpenClawConfig } from "../config/config.js";
diff --git a/extensions/browser/src/gateway/browser-request.timeout.test.ts b/extensions/browser/src/gateway/browser-request.timeout.test.ts
index 9feedf88d1ea..7cab3ad2a993 100644
--- a/extensions/browser/src/gateway/browser-request.timeout.test.ts
+++ b/extensions/browser/src/gateway/browser-request.timeout.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover browser request.timeout plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/browser/src/node-host/invoke-browser.test.ts b/extensions/browser/src/node-host/invoke-browser.test.ts
index b924ceaf0e1b..9d13d9c7b265 100644
--- a/extensions/browser/src/node-host/invoke-browser.test.ts
+++ b/extensions/browser/src/node-host/invoke-browser.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover invoke browser plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/browser/src/plugin-service.test.ts b/extensions/browser/src/plugin-service.test.ts
index f0486ba6381a..c237d9c9cf54 100644
--- a/extensions/browser/src/plugin-service.test.ts
+++ b/extensions/browser/src/plugin-service.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover plugin service plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "./config/config.js";
 import { isDefaultBrowserPluginEnabled } from "./plugin-enabled.js";
diff --git a/extensions/browser/src/sdk-node-runtime.test.ts b/extensions/browser/src/sdk-node-runtime.test.ts
index 8d19200c0727..100c181a63fb 100644
--- a/extensions/browser/src/sdk-node-runtime.test.ts
+++ b/extensions/browser/src/sdk-node-runtime.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover sdk node runtime plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it, vi } from "vitest";
 import { withTimeout } from "./sdk-node-runtime.js";
diff --git a/extensions/browser/src/security-audit.test.ts b/extensions/browser/src/security-audit.test.ts
index 7de156391835..0b0581e68f85 100644
--- a/extensions/browser/src/security-audit.test.ts
+++ b/extensions/browser/src/security-audit.test.ts
@@ -1,3 +1,4 @@
+// Browser tests cover security audit plugin behavior.
 import { describe, expect, it } from "vitest";
 import { collectBrowserSecurityAuditFindings } from "./security-audit.js";
 
diff --git a/extensions/codex/doctor-contract-api.test.ts b/extensions/codex/doctor-contract-api.test.ts
index ab47e18d400c..3d2fec66d7b1 100644
--- a/extensions/codex/doctor-contract-api.test.ts
+++ b/extensions/codex/doctor-contract-api.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover doctor contract api plugin behavior.
 import { describe, expect, it } from "vitest";
 import { legacyConfigRules, normalizeCompatibilityConfig } from "./doctor-contract-api.js";
 
diff --git a/extensions/codex/harness.test.ts b/extensions/codex/harness.test.ts
index 82ed99cfc9c7..03e4e8cde0e0 100644
--- a/extensions/codex/harness.test.ts
+++ b/extensions/codex/harness.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover harness plugin behavior.
 import { describe, expect, it } from "vitest";
 import { createCodexAppServerAgentHarness } from "./harness.js";
 
diff --git a/extensions/codex/index.test.ts b/extensions/codex/index.test.ts
index 27cb7517b130..5015aefc2438 100644
--- a/extensions/codex/index.test.ts
+++ b/extensions/codex/index.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover index plugin behavior.
 import fs from "node:fs";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/codex/media-understanding-provider.test.ts b/extensions/codex/media-understanding-provider.test.ts
index bc7f5855c5eb..6479c11bca7e 100644
--- a/extensions/codex/media-understanding-provider.test.ts
+++ b/extensions/codex/media-understanding-provider.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover media understanding provider plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { buildCodexMediaUnderstandingProvider } from "./media-understanding-provider.js";
diff --git a/extensions/codex/prompt-overlay-runtime-contract.test.ts b/extensions/codex/prompt-overlay-runtime-contract.test.ts
index d9c18179c6b7..760ea11fd8a9 100644
--- a/extensions/codex/prompt-overlay-runtime-contract.test.ts
+++ b/extensions/codex/prompt-overlay-runtime-contract.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover prompt overlay runtime contract plugin behavior.
 import {
   codexPromptOverlayContext,
   GPT5_CONTRACT_MODEL_ID,
diff --git a/extensions/codex/provider.test.ts b/extensions/codex/provider.test.ts
index 3e9e98cd2f95..6e1b00e2c994 100644
--- a/extensions/codex/provider.test.ts
+++ b/extensions/codex/provider.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover provider plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { CODEX_GPT5_BEHAVIOR_CONTRACT } from "./prompt-overlay.js";
 import { codexProviderDiscovery } from "./provider-discovery.js";
diff --git a/extensions/codex/src/app-server/app-inventory-cache.test.ts b/extensions/codex/src/app-server/app-inventory-cache.test.ts
index 5be3c3e5a6ff..1883b8378efa 100644
--- a/extensions/codex/src/app-server/app-inventory-cache.test.ts
+++ b/extensions/codex/src/app-server/app-inventory-cache.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover app inventory cache plugin behavior.
 import { MAX_DATE_TIMESTAMP_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/codex/src/app-server/app-server-policy.test.ts b/extensions/codex/src/app-server/app-server-policy.test.ts
index 6a5a8e7d3150..99ef2e911933 100644
--- a/extensions/codex/src/app-server/app-server-policy.test.ts
+++ b/extensions/codex/src/app-server/app-server-policy.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover app server policy plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveCodexAppServerForOpenClawToolPolicy } from "./app-server-policy.js";
 import { readCodexPluginConfig, resolveCodexAppServerRuntimeOptions } from "./config.js";
diff --git a/extensions/codex/src/app-server/approval-bridge.test.ts b/extensions/codex/src/app-server/approval-bridge.test.ts
index 3114aff57dd2..ce95bf4b103b 100644
--- a/extensions/codex/src/app-server/approval-bridge.test.ts
+++ b/extensions/codex/src/app-server/approval-bridge.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover approval bridge plugin behavior.
 import {
   callGatewayTool,
   hasNativeHookRelayInvocation,
diff --git a/extensions/codex/src/app-server/attempt-client-cleanup.test.ts b/extensions/codex/src/app-server/attempt-client-cleanup.test.ts
index e1288813e341..7717583806c2 100644
--- a/extensions/codex/src/app-server/attempt-client-cleanup.test.ts
+++ b/extensions/codex/src/app-server/attempt-client-cleanup.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover attempt client cleanup plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   interruptCodexTurnBestEffort,
diff --git a/extensions/codex/src/app-server/attempt-context.test.ts b/extensions/codex/src/app-server/attempt-context.test.ts
index eb8aceb75111..a9bac1be40cf 100644
--- a/extensions/codex/src/app-server/attempt-context.test.ts
+++ b/extensions/codex/src/app-server/attempt-context.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover attempt context plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/attempt-diagnostics.test.ts b/extensions/codex/src/app-server/attempt-diagnostics.test.ts
index 5d7f2945c522..88012aa6293e 100644
--- a/extensions/codex/src/app-server/attempt-diagnostics.test.ts
+++ b/extensions/codex/src/app-server/attempt-diagnostics.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover attempt diagnostics plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildCodexPluginThreadConfigEligibilityLogData } from "./attempt-diagnostics.js";
 import { resolveCodexPluginsPolicy } from "./config.js";
diff --git a/extensions/codex/src/app-server/attempt-results.test.ts b/extensions/codex/src/app-server/attempt-results.test.ts
index c1ed5cc6bf35..66d1d79cd070 100644
--- a/extensions/codex/src/app-server/attempt-results.test.ts
+++ b/extensions/codex/src/app-server/attempt-results.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover attempt results plugin behavior.
 import type { EmbeddedRunAttemptResult } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/codex/src/app-server/attempt-startup.test.ts b/extensions/codex/src/app-server/attempt-startup.test.ts
index 5d277b7a9c54..7e8ac05f3b26 100644
--- a/extensions/codex/src/app-server/attempt-startup.test.ts
+++ b/extensions/codex/src/app-server/attempt-startup.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover attempt startup plugin behavior.
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/codex/src/app-server/attempt-steering.test.ts b/extensions/codex/src/app-server/attempt-steering.test.ts
index f698119f8ff1..6a7ffb3ac96f 100644
--- a/extensions/codex/src/app-server/attempt-steering.test.ts
+++ b/extensions/codex/src/app-server/attempt-steering.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover attempt steering plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { createCodexSteeringQueue } from "./attempt-steering.js";
 
diff --git a/extensions/codex/src/app-server/attempt-timeouts.test.ts b/extensions/codex/src/app-server/attempt-timeouts.test.ts
index c8f07496b4d7..225483fb546c 100644
--- a/extensions/codex/src/app-server/attempt-timeouts.test.ts
+++ b/extensions/codex/src/app-server/attempt-timeouts.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover attempt timeouts plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/codex/src/app-server/attempt-turn-watches.test.ts b/extensions/codex/src/app-server/attempt-turn-watches.test.ts
index d7617b024314..e985e0e9de51 100644
--- a/extensions/codex/src/app-server/attempt-turn-watches.test.ts
+++ b/extensions/codex/src/app-server/attempt-turn-watches.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover attempt turn watches plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { createCodexAttemptTurnWatchController } from "./attempt-turn-watches.js";
diff --git a/extensions/codex/src/app-server/auth-bridge.test.ts b/extensions/codex/src/app-server/auth-bridge.test.ts
index 041f713187e0..702a5512dfdb 100644
--- a/extensions/codex/src/app-server/auth-bridge.test.ts
+++ b/extensions/codex/src/app-server/auth-bridge.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover auth bridge plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/auth-profile-runtime-contract.test.ts b/extensions/codex/src/app-server/auth-profile-runtime-contract.test.ts
index 39dd518537c3..46eee5112923 100644
--- a/extensions/codex/src/app-server/auth-profile-runtime-contract.test.ts
+++ b/extensions/codex/src/app-server/auth-profile-runtime-contract.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover auth profile runtime contract plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/client.test.ts b/extensions/codex/src/app-server/client.test.ts
index 0c3f55c6716f..94d6c0a8377c 100644
--- a/extensions/codex/src/app-server/client.test.ts
+++ b/extensions/codex/src/app-server/client.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover client plugin behavior.
 import { EventEmitter } from "node:events";
 import { PassThrough } from "node:stream";
 import { embeddedAgentLog, OPENCLAW_VERSION } from "openclaw/plugin-sdk/agent-harness-runtime";
diff --git a/extensions/codex/src/app-server/compact.test.ts b/extensions/codex/src/app-server/compact.test.ts
index 7cbf985522b5..abb9427b1907 100644
--- a/extensions/codex/src/app-server/compact.test.ts
+++ b/extensions/codex/src/app-server/compact.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover compact plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/computer-use.test.ts b/extensions/codex/src/app-server/computer-use.test.ts
index 52f0d33213f6..361fd007d1b8 100644
--- a/extensions/codex/src/app-server/computer-use.test.ts
+++ b/extensions/codex/src/app-server/computer-use.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover computer use plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/config.test.ts b/extensions/codex/src/app-server/config.test.ts
index ff6fceee3212..2d2ed8539938 100644
--- a/extensions/codex/src/app-server/config.test.ts
+++ b/extensions/codex/src/app-server/config.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover config plugin behavior.
 import fs from "node:fs/promises";
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/codex/src/app-server/config.ts b/extensions/codex/src/app-server/config.ts
index 06ea943c33c6..d52366bd1e0a 100644
--- a/extensions/codex/src/app-server/config.ts
+++ b/extensions/codex/src/app-server/config.ts
@@ -1,3 +1,4 @@
+// Codex helper module supports config behavior.
 import { createHmac, randomBytes } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { hostname as readHostName } from "node:os";
diff --git a/extensions/codex/src/app-server/context-engine-projection.test.ts b/extensions/codex/src/app-server/context-engine-projection.test.ts
index b2ef6952269b..91d7d817cc4e 100644
--- a/extensions/codex/src/app-server/context-engine-projection.test.ts
+++ b/extensions/codex/src/app-server/context-engine-projection.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover context engine projection plugin behavior.
 import type { AgentMessage } from "openclaw/plugin-sdk/agent-core";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/codex/src/app-server/delivery-no-reply-runtime-contract.test.ts b/extensions/codex/src/app-server/delivery-no-reply-runtime-contract.test.ts
index aa9f6d37994e..cfdf693e1e32 100644
--- a/extensions/codex/src/app-server/delivery-no-reply-runtime-contract.test.ts
+++ b/extensions/codex/src/app-server/delivery-no-reply-runtime-contract.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover delivery no reply runtime contract plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/dynamic-tool-build.test.ts b/extensions/codex/src/app-server/dynamic-tool-build.test.ts
index 24c1c07a4a40..61294690ef76 100644
--- a/extensions/codex/src/app-server/dynamic-tool-build.test.ts
+++ b/extensions/codex/src/app-server/dynamic-tool-build.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover dynamic tool build plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/dynamic-tool-execution.test.ts b/extensions/codex/src/app-server/dynamic-tool-execution.test.ts
index c6a714d72dd4..d4efd5780597 100644
--- a/extensions/codex/src/app-server/dynamic-tool-execution.test.ts
+++ b/extensions/codex/src/app-server/dynamic-tool-execution.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover dynamic tool execution plugin behavior.
 import { embeddedAgentLog } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/codex/src/app-server/dynamic-tools.test.ts b/extensions/codex/src/app-server/dynamic-tools.test.ts
index 7084ee9df590..df7e5ab37f34 100644
--- a/extensions/codex/src/app-server/dynamic-tools.test.ts
+++ b/extensions/codex/src/app-server/dynamic-tools.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover dynamic tools plugin behavior.
 import type { AgentToolResult } from "openclaw/plugin-sdk/agent-core";
 import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness";
 import {
diff --git a/extensions/codex/src/app-server/elicitation-bridge.test.ts b/extensions/codex/src/app-server/elicitation-bridge.test.ts
index 1760c311b2e6..b69d4ce0d4cf 100644
--- a/extensions/codex/src/app-server/elicitation-bridge.test.ts
+++ b/extensions/codex/src/app-server/elicitation-bridge.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover elicitation bridge plugin behavior.
 import {
   callGatewayTool,
   embeddedAgentLog,
diff --git a/extensions/codex/src/app-server/elicitation-bridge.ts b/extensions/codex/src/app-server/elicitation-bridge.ts
index c1bd1e0ddc49..549fc8cf9680 100644
--- a/extensions/codex/src/app-server/elicitation-bridge.ts
+++ b/extensions/codex/src/app-server/elicitation-bridge.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements elicitation bridge behavior.
 import {
   embeddedAgentLog,
   type EmbeddedRunAttemptParams,
diff --git a/extensions/codex/src/app-server/event-projector.test.ts b/extensions/codex/src/app-server/event-projector.test.ts
index 53f8a1c7dcc1..c29fbd7ecc24 100644
--- a/extensions/codex/src/app-server/event-projector.test.ts
+++ b/extensions/codex/src/app-server/event-projector.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover event projector plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/event-projector.ts b/extensions/codex/src/app-server/event-projector.ts
index ae377c89f8ac..c03e1d47f3fe 100644
--- a/extensions/codex/src/app-server/event-projector.ts
+++ b/extensions/codex/src/app-server/event-projector.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements event projector behavior.
 import {
   classifyAgentHarnessTerminalOutcome,
   embeddedAgentLog,
diff --git a/extensions/codex/src/app-server/image-payload-sanitizer.test.ts b/extensions/codex/src/app-server/image-payload-sanitizer.test.ts
index cb4db2ce6995..950d96a4b0c1 100644
--- a/extensions/codex/src/app-server/image-payload-sanitizer.test.ts
+++ b/extensions/codex/src/app-server/image-payload-sanitizer.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover image payload sanitizer plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   invalidInlineImageText,
diff --git a/extensions/codex/src/app-server/managed-binary.test.ts b/extensions/codex/src/app-server/managed-binary.test.ts
index 525c2dda3745..08f0dec69780 100644
--- a/extensions/codex/src/app-server/managed-binary.test.ts
+++ b/extensions/codex/src/app-server/managed-binary.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover managed binary plugin behavior.
 import { mkdir, mkdtemp, realpath, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/models.test.ts b/extensions/codex/src/app-server/models.test.ts
index b5ea043c690b..7a29b2cfb940 100644
--- a/extensions/codex/src/app-server/models.test.ts
+++ b/extensions/codex/src/app-server/models.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover models plugin behavior.
 import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
 import { CodexAppServerClient } from "./client.js";
 import { createClientHarness } from "./test-support.js";
diff --git a/extensions/codex/src/app-server/native-execution-policy.test.ts b/extensions/codex/src/app-server/native-execution-policy.test.ts
index 7a4b122971c7..423c88b983e6 100644
--- a/extensions/codex/src/app-server/native-execution-policy.test.ts
+++ b/extensions/codex/src/app-server/native-execution-policy.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover native execution policy plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveCodexNativeExecutionPolicy } from "./native-execution-policy.js";
 
diff --git a/extensions/codex/src/app-server/native-hook-relay.test.ts b/extensions/codex/src/app-server/native-hook-relay.test.ts
index 4df7c269492c..b75191d663f9 100644
--- a/extensions/codex/src/app-server/native-hook-relay.test.ts
+++ b/extensions/codex/src/app-server/native-hook-relay.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover native hook relay plugin behavior.
 import type { NativeHookRelayRegistrationHandle } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/codex/src/app-server/native-subagent-monitor.test.ts b/extensions/codex/src/app-server/native-subagent-monitor.test.ts
index cefcbcb53f94..e9d74c70ee5b 100644
--- a/extensions/codex/src/app-server/native-subagent-monitor.test.ts
+++ b/extensions/codex/src/app-server/native-subagent-monitor.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover native subagent monitor plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/native-subagent-notification.test.ts b/extensions/codex/src/app-server/native-subagent-notification.test.ts
index be7b2007d37a..1b5779db629c 100644
--- a/extensions/codex/src/app-server/native-subagent-notification.test.ts
+++ b/extensions/codex/src/app-server/native-subagent-notification.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover native subagent notification plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   extractCodexNativeSubagentCompletions,
diff --git a/extensions/codex/src/app-server/native-subagent-task-mirror.test.ts b/extensions/codex/src/app-server/native-subagent-task-mirror.test.ts
index 7d9f423ff298..a0723544d8ad 100644
--- a/extensions/codex/src/app-server/native-subagent-task-mirror.test.ts
+++ b/extensions/codex/src/app-server/native-subagent-task-mirror.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover native subagent task mirror plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   codexNativeSubagentRunId,
diff --git a/extensions/codex/src/app-server/openclaw-owned-tool-runtime-contract.test.ts b/extensions/codex/src/app-server/openclaw-owned-tool-runtime-contract.test.ts
index d5f1c64162fd..cf9bdc9f6855 100644
--- a/extensions/codex/src/app-server/openclaw-owned-tool-runtime-contract.test.ts
+++ b/extensions/codex/src/app-server/openclaw-owned-tool-runtime-contract.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover openclaw owned tool runtime contract plugin behavior.
 import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness";
 import { wrapToolWithBeforeToolCallHook } from "openclaw/plugin-sdk/agent-harness-runtime";
 import {
diff --git a/extensions/codex/src/app-server/outcome-fallback-runtime-contract.test.ts b/extensions/codex/src/app-server/outcome-fallback-runtime-contract.test.ts
index a3cce135a028..19660c729ae0 100644
--- a/extensions/codex/src/app-server/outcome-fallback-runtime-contract.test.ts
+++ b/extensions/codex/src/app-server/outcome-fallback-runtime-contract.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover outcome fallback runtime contract plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/plugin-activation.test.ts b/extensions/codex/src/app-server/plugin-activation.test.ts
index 14a2ed8d1c67..800349a51414 100644
--- a/extensions/codex/src/app-server/plugin-activation.test.ts
+++ b/extensions/codex/src/app-server/plugin-activation.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover plugin activation plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { CodexAppInventoryCache } from "./app-inventory-cache.js";
 import { CODEX_PLUGINS_MARKETPLACE_NAME, type ResolvedCodexPluginPolicy } from "./config.js";
diff --git a/extensions/codex/src/app-server/plugin-app-cache-key.test.ts b/extensions/codex/src/app-server/plugin-app-cache-key.test.ts
index 146feca8b4ed..bb08674c3b93 100644
--- a/extensions/codex/src/app-server/plugin-app-cache-key.test.ts
+++ b/extensions/codex/src/app-server/plugin-app-cache-key.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover plugin app cache key plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveCodexPluginAppCacheEndpoint } from "./plugin-app-cache-key.js";
 
diff --git a/extensions/codex/src/app-server/plugin-inventory.test.ts b/extensions/codex/src/app-server/plugin-inventory.test.ts
index 0aa0e2fcbde5..2fa9a2966957 100644
--- a/extensions/codex/src/app-server/plugin-inventory.test.ts
+++ b/extensions/codex/src/app-server/plugin-inventory.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover plugin inventory plugin behavior.
 import { describe, expect, it } from "vitest";
 import { CodexAppInventoryCache } from "./app-inventory-cache.js";
 import { CODEX_PLUGINS_MARKETPLACE_NAME } from "./config.js";
diff --git a/extensions/codex/src/app-server/plugin-thread-config.test.ts b/extensions/codex/src/app-server/plugin-thread-config.test.ts
index ce74a10e53b3..eb9ddd8fb75a 100644
--- a/extensions/codex/src/app-server/plugin-thread-config.test.ts
+++ b/extensions/codex/src/app-server/plugin-thread-config.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover plugin thread config plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { CodexAppInventoryCache } from "./app-inventory-cache.js";
 import { CODEX_PLUGINS_MARKETPLACE_NAME } from "./config.js";
diff --git a/extensions/codex/src/app-server/profiler-flag.test.ts b/extensions/codex/src/app-server/profiler-flag.test.ts
index a0f40e74b1c7..a9e22d1601b5 100644
--- a/extensions/codex/src/app-server/profiler-flag.test.ts
+++ b/extensions/codex/src/app-server/profiler-flag.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover profiler flag plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isCodexAppServerProfilerEnabled } from "./profiler-flag.js";
 
diff --git a/extensions/codex/src/app-server/protocol-validators.test.ts b/extensions/codex/src/app-server/protocol-validators.test.ts
index 28985296e419..a9d55839fd17 100644
--- a/extensions/codex/src/app-server/protocol-validators.test.ts
+++ b/extensions/codex/src/app-server/protocol-validators.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover protocol validators plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   readCodexModelListResponse,
diff --git a/extensions/codex/src/app-server/protocol.ts b/extensions/codex/src/app-server/protocol.ts
index d89e12d5da30..ec77df1d673f 100644
--- a/extensions/codex/src/app-server/protocol.ts
+++ b/extensions/codex/src/app-server/protocol.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements protocol behavior.
 export type JsonValue = null | boolean | number | string | JsonValue[] | JsonObject;
 export type JsonObject = { [key: string]: JsonValue };
 export type CodexServiceTier = string;
diff --git a/extensions/codex/src/app-server/rate-limits.test.ts b/extensions/codex/src/app-server/rate-limits.test.ts
index 6f81051c9941..8688b4991010 100644
--- a/extensions/codex/src/app-server/rate-limits.test.ts
+++ b/extensions/codex/src/app-server/rate-limits.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover rate limits plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   formatCodexUsageLimitErrorMessage,
diff --git a/extensions/codex/src/app-server/request.test.ts b/extensions/codex/src/app-server/request.test.ts
index 35678e275a2c..ed8181547e18 100644
--- a/extensions/codex/src/app-server/request.test.ts
+++ b/extensions/codex/src/app-server/request.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover request plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const sharedClientMocks = vi.hoisted(() => ({
diff --git a/extensions/codex/src/app-server/run-attempt-test-harness.ts b/extensions/codex/src/app-server/run-attempt-test-harness.ts
index 966582760f59..e4b36a4109f7 100644
--- a/extensions/codex/src/app-server/run-attempt-test-harness.ts
+++ b/extensions/codex/src/app-server/run-attempt-test-harness.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements run attempt test harness behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/codex/src/app-server/run-attempt-thread-cleanup.test.ts b/extensions/codex/src/app-server/run-attempt-thread-cleanup.test.ts
index 0c97a2011dff..79c5926263e2 100644
--- a/extensions/codex/src/app-server/run-attempt-thread-cleanup.test.ts
+++ b/extensions/codex/src/app-server/run-attempt-thread-cleanup.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt thread cleanup plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/run-attempt.context-engine.test.ts b/extensions/codex/src/app-server/run-attempt.context-engine.test.ts
index 82360d426b11..2714917d6e72 100644
--- a/extensions/codex/src/app-server/run-attempt.context-engine.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.context-engine.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt.context engine plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/run-attempt.dynamic-tools.test.ts b/extensions/codex/src/app-server/run-attempt.dynamic-tools.test.ts
index ab4edb812960..23ff89fc19d7 100644
--- a/extensions/codex/src/app-server/run-attempt.dynamic-tools.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.dynamic-tools.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attemptynamic tools plugin behavior.
 import path from "node:path";
 import { onAgentEvent, type AgentEventPayload } from "openclaw/plugin-sdk/agent-harness-runtime";
 import {
diff --git a/extensions/codex/src/app-server/run-attempt.hooks.test.ts b/extensions/codex/src/app-server/run-attempt.hooks.test.ts
index bfb6f2e9b583..437bf382364c 100644
--- a/extensions/codex/src/app-server/run-attempt.hooks.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.hooks.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt.hooks plugin behavior.
 import path from "node:path";
 import {
   abortAgentHarnessRun,
diff --git a/extensions/codex/src/app-server/run-attempt.native-hook-relay.test.ts b/extensions/codex/src/app-server/run-attempt.native-hook-relay.test.ts
index 42df40b94b36..2397d6b53689 100644
--- a/extensions/codex/src/app-server/run-attempt.native-hook-relay.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.native-hook-relay.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt.native hook relay plugin behavior.
 import path from "node:path";
 import {
   abortAgentHarnessRun,
diff --git a/extensions/codex/src/app-server/run-attempt.steering.test.ts b/extensions/codex/src/app-server/run-attempt.steering.test.ts
index f2d8dfd9b37b..a8739dd057f0 100644
--- a/extensions/codex/src/app-server/run-attempt.steering.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.steering.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt.steering plugin behavior.
 import path from "node:path";
 import { describe, expect, it, vi } from "vitest";
 import { CODEX_GPT5_BEHAVIOR_CONTRACT } from "../../prompt-overlay.js";
diff --git a/extensions/codex/src/app-server/run-attempt.test.ts b/extensions/codex/src/app-server/run-attempt.test.ts
index 9c23d8dda232..15633665e5b2 100644
--- a/extensions/codex/src/app-server/run-attempt.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/codex/src/app-server/run-attempt.ts b/extensions/codex/src/app-server/run-attempt.ts
index b98dd96078bd..07e9f944964f 100644
--- a/extensions/codex/src/app-server/run-attempt.ts
+++ b/extensions/codex/src/app-server/run-attempt.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements run attempt behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/codex/src/app-server/run-attempt.turn-watches.test.ts b/extensions/codex/src/app-server/run-attempt.turn-watches.test.ts
index 3c2e0a94a678..7e4a17ddc1d8 100644
--- a/extensions/codex/src/app-server/run-attempt.turn-watches.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.turn-watches.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt.turn watches plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/codex/src/app-server/run-attempt.usage-limits.test.ts b/extensions/codex/src/app-server/run-attempt.usage-limits.test.ts
index 908502f21de1..cd286f325b55 100644
--- a/extensions/codex/src/app-server/run-attempt.usage-limits.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.usage-limits.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt.usage limits plugin behavior.
 import path from "node:path";
 import { describe, expect, it } from "vitest";
 import { rememberCodexRateLimits } from "./rate-limit-cache.js";
diff --git a/extensions/codex/src/app-server/run-attempt.vision-tools.test.ts b/extensions/codex/src/app-server/run-attempt.vision-tools.test.ts
index 0b3a9791bee3..3e73950900a5 100644
--- a/extensions/codex/src/app-server/run-attempt.vision-tools.test.ts
+++ b/extensions/codex/src/app-server/run-attempt.vision-tools.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover run attempt.vision tools plugin behavior.
 import { describe, expect, it } from "vitest";
 import { filterToolsForVisionInputs } from "./vision-tools.js";
 
diff --git a/extensions/codex/src/app-server/sandbox-exec-server.fs.test.ts b/extensions/codex/src/app-server/sandbox-exec-server.fs.test.ts
index 6e0de5093c4d..b3aee12bf34d 100644
--- a/extensions/codex/src/app-server/sandbox-exec-server.fs.test.ts
+++ b/extensions/codex/src/app-server/sandbox-exec-server.fs.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover sandbox exec server.fs plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   closeCodexSandboxExecServersForTests,
diff --git a/extensions/codex/src/app-server/sandbox-exec-server.http.test.ts b/extensions/codex/src/app-server/sandbox-exec-server.http.test.ts
index 890d87c95460..e7967b0ee316 100644
--- a/extensions/codex/src/app-server/sandbox-exec-server.http.test.ts
+++ b/extensions/codex/src/app-server/sandbox-exec-server.http.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover sandbox exec server.http plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   closeCodexSandboxExecServersForTests,
diff --git a/extensions/codex/src/app-server/sandbox-exec-server.json-rpc.test.ts b/extensions/codex/src/app-server/sandbox-exec-server.json-rpc.test.ts
index d19da520c70e..6f4f0fa3dd07 100644
--- a/extensions/codex/src/app-server/sandbox-exec-server.json-rpc.test.ts
+++ b/extensions/codex/src/app-server/sandbox-exec-server.json-rpc.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover sandbox exec server.json rpc plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { WebSocket } from "ws";
 import { sendResult } from "./sandbox-exec-server/json-rpc.js";
diff --git a/extensions/codex/src/app-server/sandbox-exec-server.test.ts b/extensions/codex/src/app-server/sandbox-exec-server.test.ts
index 48f0d7dcb0af..8e2b4e3dfe99 100644
--- a/extensions/codex/src/app-server/sandbox-exec-server.test.ts
+++ b/extensions/codex/src/app-server/sandbox-exec-server.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover sandbox exec server plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   closeCodexSandboxExecServersForTests,
diff --git a/extensions/codex/src/app-server/schema-normalization-runtime-contract.test.ts b/extensions/codex/src/app-server/schema-normalization-runtime-contract.test.ts
index a10816f60a05..36da7053772a 100644
--- a/extensions/codex/src/app-server/schema-normalization-runtime-contract.test.ts
+++ b/extensions/codex/src/app-server/schema-normalization-runtime-contract.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover schema normalization runtime contract plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/session-binding.test.ts b/extensions/codex/src/app-server/session-binding.test.ts
index 0e427972c558..703f4ce2a8ec 100644
--- a/extensions/codex/src/app-server/session-binding.test.ts
+++ b/extensions/codex/src/app-server/session-binding.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover session binding plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/shared-client.test.ts b/extensions/codex/src/app-server/shared-client.test.ts
index e68b3d454e1d..3a0c6963ab77 100644
--- a/extensions/codex/src/app-server/shared-client.test.ts
+++ b/extensions/codex/src/app-server/shared-client.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover shared client plugin behavior.
 import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
 import { WebSocketServer, type RawData } from "ws";
 import { CodexAppServerClient, MIN_CODEX_APP_SERVER_VERSION } from "./client.js";
diff --git a/extensions/codex/src/app-server/side-question.test.ts b/extensions/codex/src/app-server/side-question.test.ts
index f0fe5958308c..f907d1dd4d98 100644
--- a/extensions/codex/src/app-server/side-question.test.ts
+++ b/extensions/codex/src/app-server/side-question.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover side question plugin behavior.
 import { nativeHookRelayTesting } from "openclaw/plugin-sdk/agent-harness-runtime";
 import {
   onInternalDiagnosticEvent,
diff --git a/extensions/codex/src/app-server/side-question.ts b/extensions/codex/src/app-server/side-question.ts
index acafbe2aa0e7..6270e816615b 100644
--- a/extensions/codex/src/app-server/side-question.ts
+++ b/extensions/codex/src/app-server/side-question.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements side question behavior.
 import {
   buildAgentHookContextChannelFields,
   embeddedAgentLog,
diff --git a/extensions/codex/src/app-server/startup-binding.test.ts b/extensions/codex/src/app-server/startup-binding.test.ts
index dcc4cb59c049..14ed43cb3477 100644
--- a/extensions/codex/src/app-server/startup-binding.test.ts
+++ b/extensions/codex/src/app-server/startup-binding.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover startup binding plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/thread-lifecycle.binding.test.ts b/extensions/codex/src/app-server/thread-lifecycle.binding.test.ts
index 1feb44eb5cba..bfdd0628282e 100644
--- a/extensions/codex/src/app-server/thread-lifecycle.binding.test.ts
+++ b/extensions/codex/src/app-server/thread-lifecycle.binding.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover thread lifecycle.binding plugin behavior.
 import path from "node:path";
 import { describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/codex/src/app-server/thread-lifecycle.test.ts b/extensions/codex/src/app-server/thread-lifecycle.test.ts
index 25bc5a7d9e3d..62dc6bf55d8d 100644
--- a/extensions/codex/src/app-server/thread-lifecycle.test.ts
+++ b/extensions/codex/src/app-server/thread-lifecycle.test.ts
@@ -1,9 +1,11 @@
+// Codex tests cover thread lifecycle plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import type { EmbeddedRunAttemptParams } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { CODEX_GPT5_BEHAVIOR_CONTRACT } from "../../prompt-overlay.js";
+import { createCodexTestModel } from "./test-support.js";
 import {
   buildDeveloperInstructions,
   buildTurnCollaborationMode,
@@ -17,7 +19,6 @@ import {
   startOrResumeThread,
   type CodexThreadLifecycleTimingLogger,
 } from "./thread-lifecycle.js";
-import { createCodexTestModel } from "./test-support.js";
 
 let tempDir: string;
 
diff --git a/extensions/codex/src/app-server/thread-lifecycle.ts b/extensions/codex/src/app-server/thread-lifecycle.ts
index dd53e7a4b583..0c61485aace0 100644
--- a/extensions/codex/src/app-server/thread-lifecycle.ts
+++ b/extensions/codex/src/app-server/thread-lifecycle.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements thread lifecycle behavior.
 import {
   buildSkillWorkshopPromptSection,
   embeddedAgentLog,
@@ -153,10 +154,8 @@ export function shouldWarnCodexThreadLifecycleTimingSummary(
   summary: CodexThreadLifecycleTimingSummary,
   options: CodexThreadLifecycleTimingOptions = {},
 ): boolean {
-  const totalThresholdMs =
-    options.totalThresholdMs ?? CODEX_THREAD_LIFECYCLE_TIMING_WARN_TOTAL_MS;
-  const stageThresholdMs =
-    options.stageThresholdMs ?? CODEX_THREAD_LIFECYCLE_TIMING_WARN_STAGE_MS;
+  const totalThresholdMs = options.totalThresholdMs ?? CODEX_THREAD_LIFECYCLE_TIMING_WARN_TOTAL_MS;
+  const stageThresholdMs = options.stageThresholdMs ?? CODEX_THREAD_LIFECYCLE_TIMING_WARN_STAGE_MS;
   return (
     summary.totalMs >= totalThresholdMs ||
     summary.spans.some((span) => span.durationMs >= stageThresholdMs)
@@ -310,8 +309,7 @@ export async function startOrResumeThread(params: {
   // turns should not pay Date.now/span-array overhead while resuming threads.
   const lifecycleTiming = createCodexThreadLifecycleTimingTracker({
     ...params.timing,
-    enabled:
-      params.timing?.enabled ?? isCodexAppServerProfilerEnabled(params.params.config),
+    enabled: params.timing?.enabled ?? isCodexAppServerProfilerEnabled(params.params.config),
   });
   const dynamicToolsFingerprint = lifecycleTiming.measureSync("dynamic-tools-fingerprint", () =>
     fingerprintDynamicTools(params.dynamicTools),
diff --git a/extensions/codex/src/app-server/thread-lifecycle.user-mcp-servers.test.ts b/extensions/codex/src/app-server/thread-lifecycle.user-mcp-servers.test.ts
index dfcbeff224f9..ca2412567002 100644
--- a/extensions/codex/src/app-server/thread-lifecycle.user-mcp-servers.test.ts
+++ b/extensions/codex/src/app-server/thread-lifecycle.user-mcp-servers.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover thread lifecycle.user mcp servers plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/trajectory.test.ts b/extensions/codex/src/app-server/trajectory.test.ts
index d98b632e741f..b9aeff692562 100644
--- a/extensions/codex/src/app-server/trajectory.test.ts
+++ b/extensions/codex/src/app-server/trajectory.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover trajectory plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/app-server/transcript-mirror.test.ts b/extensions/codex/src/app-server/transcript-mirror.test.ts
index f298ae0907de..dce6d49f26d1 100644
--- a/extensions/codex/src/app-server/transcript-mirror.test.ts
+++ b/extensions/codex/src/app-server/transcript-mirror.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover transcript mirror plugin behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/codex/src/app-server/transcript-mirror.ts b/extensions/codex/src/app-server/transcript-mirror.ts
index e18f0e27d22c..b25fd7381b90 100644
--- a/extensions/codex/src/app-server/transcript-mirror.ts
+++ b/extensions/codex/src/app-server/transcript-mirror.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements transcript mirror behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import {
diff --git a/extensions/codex/src/app-server/transcript-repair-runtime-contract.test.ts b/extensions/codex/src/app-server/transcript-repair-runtime-contract.test.ts
index d09f65351c8d..c9ddd2979905 100644
--- a/extensions/codex/src/app-server/transcript-repair-runtime-contract.test.ts
+++ b/extensions/codex/src/app-server/transcript-repair-runtime-contract.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover transcript repair runtime contract plugin behavior.
 import {
   assistantHistoryMessage,
   currentPromptHistoryMessage,
diff --git a/extensions/codex/src/app-server/transport-stdio.test.ts b/extensions/codex/src/app-server/transport-stdio.test.ts
index fd7edc2e88c8..0a523de09ca1 100644
--- a/extensions/codex/src/app-server/transport-stdio.test.ts
+++ b/extensions/codex/src/app-server/transport-stdio.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover transport stdio plugin behavior.
 import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
@@ -92,7 +93,9 @@ describe("resolveCodexAppServerSpawnInvocation", () => {
   it("rejects Windows Codex app-server commands that include inline script arguments", () => {
     expect(() =>
       resolveCodexAppServerSpawnInvocation(
-        startOptions("node C:\\Users\\me\\.openclaw\\npm\\node_modules\\@openai\\codex\\bin\\codex.js"),
+        startOptions(
+          "node C:\\Users\\me\\.openclaw\\npm\\node_modules\\@openai\\codex\\bin\\codex.js",
+        ),
         {
           platform: "win32",
           env: {},
diff --git a/extensions/codex/src/app-server/transport-websocket.test.ts b/extensions/codex/src/app-server/transport-websocket.test.ts
index aac0483fb26b..c3fb9b405b3c 100644
--- a/extensions/codex/src/app-server/transport-websocket.test.ts
+++ b/extensions/codex/src/app-server/transport-websocket.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover transport websocket plugin behavior.
 import { afterEach, describe, expect, it } from "vitest";
 import { WebSocketServer, type RawData } from "ws";
 import { CodexAppServerClient } from "./client.js";
diff --git a/extensions/codex/src/app-server/user-input-bridge.test.ts b/extensions/codex/src/app-server/user-input-bridge.test.ts
index 13718e3ffeaa..2abeef8b22bc 100644
--- a/extensions/codex/src/app-server/user-input-bridge.test.ts
+++ b/extensions/codex/src/app-server/user-input-bridge.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover user input bridge plugin behavior.
 import type { EmbeddedRunAttemptParams } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { describe, expect, it, vi } from "vitest";
 import { createCodexUserInputBridge } from "./user-input-bridge.js";
diff --git a/extensions/codex/src/command-account.ts b/extensions/codex/src/command-account.ts
index b80c0abd6f13..6c34824aa90a 100644
--- a/extensions/codex/src/command-account.ts
+++ b/extensions/codex/src/command-account.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements command account behavior.
 import {
   ensureAuthProfileStore,
   findNormalizedProviderValue,
diff --git a/extensions/codex/src/command-handlers.ts b/extensions/codex/src/command-handlers.ts
index 97cddb2cee40..adc5fb58d96e 100644
--- a/extensions/codex/src/command-handlers.ts
+++ b/extensions/codex/src/command-handlers.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements command handlers behavior.
 import crypto from "node:crypto";
 import { resolveAgentDir, resolveSessionAgentIds } from "openclaw/plugin-sdk/agent-runtime";
 import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/codex/src/command-plugins-management.test.ts b/extensions/codex/src/command-plugins-management.test.ts
index df27983bab4b..a9c0973edeed 100644
--- a/extensions/codex/src/command-plugins-management.test.ts
+++ b/extensions/codex/src/command-plugins-management.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover command plugins management plugin behavior.
 import type { PluginCommandContext, PluginCommandResult } from "openclaw/plugin-sdk/plugin-entry";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/codex/src/command-plugins-management.ts b/extensions/codex/src/command-plugins-management.ts
index 4158c7548c87..faa954b18305 100644
--- a/extensions/codex/src/command-plugins-management.ts
+++ b/extensions/codex/src/command-plugins-management.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements command plugins management behavior.
 import type { PluginCommandContext, PluginCommandResult } from "openclaw/plugin-sdk/plugin-entry";
 import { formatCodexDisplayText } from "./command-formatters.js";
 import {
diff --git a/extensions/codex/src/command-presentation.ts b/extensions/codex/src/command-presentation.ts
index a4cad5feccc1..3d06193e7702 100644
--- a/extensions/codex/src/command-presentation.ts
+++ b/extensions/codex/src/command-presentation.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements command presentation behavior.
 import type { MessagePresentation } from "openclaw/plugin-sdk/interactive-runtime";
 
 export type CodexCommandPickerButton = { label: string; command: string };
diff --git a/extensions/codex/src/command-rpc.test.ts b/extensions/codex/src/command-rpc.test.ts
index dc1a406d5443..e4eb3c6bd5e5 100644
--- a/extensions/codex/src/command-rpc.test.ts
+++ b/extensions/codex/src/command-rpc.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover command rpc plugin behavior.
 import { describe, expect, it } from "vitest";
 import { CodexAppServerRpcError } from "./app-server/client.js";
 import { safeValue } from "./command-rpc.js";
diff --git a/extensions/codex/src/command-rpc.ts b/extensions/codex/src/command-rpc.ts
index 49dfc0e1565e..aa46a9cbdbb3 100644
--- a/extensions/codex/src/command-rpc.ts
+++ b/extensions/codex/src/command-rpc.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements command rpc behavior.
 import type { resolveCodexAppServerAuthProfileIdForAgent } from "./app-server/auth-bridge.js";
 import {
   CODEX_CONTROL_METHODS,
diff --git a/extensions/codex/src/commands.test.ts b/extensions/codex/src/commands.test.ts
index e013a3d7b2f1..2ea89219a358 100644
--- a/extensions/codex/src/commands.test.ts
+++ b/extensions/codex/src/commands.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover commands plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/conversation-binding-data.ts b/extensions/codex/src/conversation-binding-data.ts
index 202dc554c5ea..cc67316653d7 100644
--- a/extensions/codex/src/conversation-binding-data.ts
+++ b/extensions/codex/src/conversation-binding-data.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements conversation binding data behavior.
 import process from "node:process";
 import type { PluginConversationBinding } from "openclaw/plugin-sdk/plugin-entry";
 import { asOptionalRecord as readRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/codex/src/conversation-binding.test.ts b/extensions/codex/src/conversation-binding.test.ts
index 0b8e3138caa7..e84bda21c73f 100644
--- a/extensions/codex/src/conversation-binding.test.ts
+++ b/extensions/codex/src/conversation-binding.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover conversation binding plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/conversation-binding.ts b/extensions/codex/src/conversation-binding.ts
index 32180895db8c..ec39d4740b81 100644
--- a/extensions/codex/src/conversation-binding.ts
+++ b/extensions/codex/src/conversation-binding.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements conversation binding behavior.
 import {
   formatErrorMessage,
   resolveSandboxContext,
diff --git a/extensions/codex/src/conversation-control.test.ts b/extensions/codex/src/conversation-control.test.ts
index 2531fdc49f25..4e9f388eb6b9 100644
--- a/extensions/codex/src/conversation-control.test.ts
+++ b/extensions/codex/src/conversation-control.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover conversation control plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/conversation-control.ts b/extensions/codex/src/conversation-control.ts
index 126a0beae5ab..e72170d07c27 100644
--- a/extensions/codex/src/conversation-control.ts
+++ b/extensions/codex/src/conversation-control.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements conversation control behavior.
 import { CODEX_CONTROL_METHODS } from "./app-server/capabilities.js";
 import {
   isCodexFastServiceTier,
diff --git a/extensions/codex/src/conversation-turn-collector.test.ts b/extensions/codex/src/conversation-turn-collector.test.ts
index 68989ce20fe6..7314b4d3e023 100644
--- a/extensions/codex/src/conversation-turn-collector.test.ts
+++ b/extensions/codex/src/conversation-turn-collector.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover conversation turn collector plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createCodexConversationTurnCollector } from "./conversation-turn-collector.js";
diff --git a/extensions/codex/src/conversation-turn-collector.ts b/extensions/codex/src/conversation-turn-collector.ts
index 859745ea39f8..4179e7400f20 100644
--- a/extensions/codex/src/conversation-turn-collector.ts
+++ b/extensions/codex/src/conversation-turn-collector.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements conversation turn collector behavior.
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import { asOptionalRecord as readRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
diff --git a/extensions/codex/src/conversation-turn-input.test.ts b/extensions/codex/src/conversation-turn-input.test.ts
index 917a4ca84349..52e40999db17 100644
--- a/extensions/codex/src/conversation-turn-input.test.ts
+++ b/extensions/codex/src/conversation-turn-input.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover conversation turn input plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildCodexConversationTurnInput } from "./conversation-turn-input.js";
 
diff --git a/extensions/codex/src/conversation-turn-input.ts b/extensions/codex/src/conversation-turn-input.ts
index a5622a72917e..603176fe6ec0 100644
--- a/extensions/codex/src/conversation-turn-input.ts
+++ b/extensions/codex/src/conversation-turn-input.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements conversation turn input behavior.
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import type { PluginHookInboundClaimEvent } from "openclaw/plugin-sdk/plugin-entry";
diff --git a/extensions/codex/src/manifest.test.ts b/extensions/codex/src/manifest.test.ts
index f6e59dd3dcae..5a16810513f1 100644
--- a/extensions/codex/src/manifest.test.ts
+++ b/extensions/codex/src/manifest.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover manifest plugin behavior.
 import fs from "node:fs";
 import { describe, expect, it } from "vitest";
 import { MANAGED_CODEX_APP_SERVER_PACKAGE_VERSION } from "./app-server/version.js";
diff --git a/extensions/codex/src/migration/apply.ts b/extensions/codex/src/migration/apply.ts
index 550414a919f5..65a73f960a72 100644
--- a/extensions/codex/src/migration/apply.ts
+++ b/extensions/codex/src/migration/apply.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements apply behavior.
 import path from "node:path";
 import {
   applyMigrationManualItem,
diff --git a/extensions/codex/src/migration/auth.ts b/extensions/codex/src/migration/auth.ts
index 2bd7c4138f69..5adda52f7064 100644
--- a/extensions/codex/src/migration/auth.ts
+++ b/extensions/codex/src/migration/auth.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements auth behavior.
 import { loadAuthProfileStoreWithoutExternalProfiles } from "openclaw/plugin-sdk/agent-runtime";
 import {
   createMigrationItem,
diff --git a/extensions/codex/src/migration/helpers.ts b/extensions/codex/src/migration/helpers.ts
index 459040f78437..cd652f5aaba1 100644
--- a/extensions/codex/src/migration/helpers.ts
+++ b/extensions/codex/src/migration/helpers.ts
@@ -1,3 +1,4 @@
+// Codex helper module supports helpers behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/migration/plan.ts b/extensions/codex/src/migration/plan.ts
index aa788e4c4598..66b0835565ec 100644
--- a/extensions/codex/src/migration/plan.ts
+++ b/extensions/codex/src/migration/plan.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements plan behavior.
 import path from "node:path";
 import {
   createMigrationItem,
diff --git a/extensions/codex/src/migration/provider.test.ts b/extensions/codex/src/migration/provider.test.ts
index f7f68ad1a8df..4497ef57df7d 100644
--- a/extensions/codex/src/migration/provider.test.ts
+++ b/extensions/codex/src/migration/provider.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover provider plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/migration/provider.ts b/extensions/codex/src/migration/provider.ts
index d5c9ae103ecb..5cecdd1dfb8a 100644
--- a/extensions/codex/src/migration/provider.ts
+++ b/extensions/codex/src/migration/provider.ts
@@ -1,3 +1,4 @@
+// Codex provider module implements model/runtime integration.
 import type {
   MigrationPlan,
   MigrationProviderContext,
diff --git a/extensions/codex/src/migration/source.ts b/extensions/codex/src/migration/source.ts
index 37ea7951fae7..78b46401652d 100644
--- a/extensions/codex/src/migration/source.ts
+++ b/extensions/codex/src/migration/source.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements source behavior.
 import type { Dirent } from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/codex/src/migration/targets.ts b/extensions/codex/src/migration/targets.ts
index e9d0643134e9..78d6acbc0233 100644
--- a/extensions/codex/src/migration/targets.ts
+++ b/extensions/codex/src/migration/targets.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements targets behavior.
 import path from "node:path";
 import {
   resolveAgentConfig,
diff --git a/extensions/codex/src/node-cli-sessions.test.ts b/extensions/codex/src/node-cli-sessions.test.ts
index d7139b6354f1..d98d82f99c70 100644
--- a/extensions/codex/src/node-cli-sessions.test.ts
+++ b/extensions/codex/src/node-cli-sessions.test.ts
@@ -1,3 +1,4 @@
+// Codex tests cover node cli sessions plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/codex/src/node-cli-sessions.ts b/extensions/codex/src/node-cli-sessions.ts
index 3d2ecb3cc3b0..245ad30c59b9 100644
--- a/extensions/codex/src/node-cli-sessions.ts
+++ b/extensions/codex/src/node-cli-sessions.ts
@@ -1,3 +1,4 @@
+// Codex plugin module implements node cli sessions behavior.
 import { spawn } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/imessage/api.ts b/extensions/imessage/api.ts
index d0676a925485..35454579f6b1 100644
--- a/extensions/imessage/api.ts
+++ b/extensions/imessage/api.ts
@@ -1,3 +1,4 @@
+// Imessage API module exposes the plugin public contract.
 export { imessagePlugin } from "./src/channel.js";
 export { imessageSetupPlugin } from "./src/channel.setup.js";
 export {
diff --git a/extensions/imessage/channel-config-api.ts b/extensions/imessage/channel-config-api.ts
index af880cb7b8c8..9c041796e7d5 100644
--- a/extensions/imessage/channel-config-api.ts
+++ b/extensions/imessage/channel-config-api.ts
@@ -1 +1,2 @@
+// Imessage API module exposes the plugin public contract.
 export { IMessageChannelConfigSchema } from "./src/config-schema.js";
diff --git a/extensions/imessage/channel-plugin-api.ts b/extensions/imessage/channel-plugin-api.ts
index 2b6d13a43696..020fc78a1c2d 100644
--- a/extensions/imessage/channel-plugin-api.ts
+++ b/extensions/imessage/channel-plugin-api.ts
@@ -1 +1,2 @@
+// Imessage API module exposes the plugin public contract.
 export { imessagePlugin } from "./src/channel.js";
diff --git a/extensions/imessage/config-api.ts b/extensions/imessage/config-api.ts
index 0ba74cc2592e..f8117de5dc90 100644
--- a/extensions/imessage/config-api.ts
+++ b/extensions/imessage/config-api.ts
@@ -1,3 +1,4 @@
+// Imessage API module exposes the plugin public contract.
 export {
   buildChannelConfigSchema,
   IMessageConfigSchema,
diff --git a/extensions/imessage/contract-api.ts b/extensions/imessage/contract-api.ts
index 5dccc3fe5120..b59f0de7384b 100644
--- a/extensions/imessage/contract-api.ts
+++ b/extensions/imessage/contract-api.ts
@@ -1,3 +1,4 @@
+// Imessage API module exposes the plugin public contract.
 export {
   DEFAULT_IMESSAGE_ATTACHMENT_ROOTS,
   resolveIMessageAttachmentRoots as resolveInboundAttachmentRoots,
diff --git a/extensions/imessage/doctor-contract-api.ts b/extensions/imessage/doctor-contract-api.ts
index c308f031192c..deb90949bda0 100644
--- a/extensions/imessage/doctor-contract-api.ts
+++ b/extensions/imessage/doctor-contract-api.ts
@@ -1,3 +1,4 @@
+// Imessage API module exposes the plugin public contract.
 import type { ChannelDoctorLegacyConfigRule } from "openclaw/plugin-sdk/channel-contract";
 
 // iMessage does not expose doctor legacy rules today. Keep that empty answer on
diff --git a/extensions/imessage/index.ts b/extensions/imessage/index.ts
index 55694355debc..b3c8c6b4e0f6 100644
--- a/extensions/imessage/index.ts
+++ b/extensions/imessage/index.ts
@@ -1,3 +1,4 @@
+// Imessage plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/imessage/legacy-state-migrations-api.ts b/extensions/imessage/legacy-state-migrations-api.ts
index 8836acf99949..5c8e6f0868d3 100644
--- a/extensions/imessage/legacy-state-migrations-api.ts
+++ b/extensions/imessage/legacy-state-migrations-api.ts
@@ -1 +1,2 @@
+// Imessage API module exposes the plugin public contract.
 export { detectIMessageLegacyStateMigrations } from "./src/state-migrations.js";
diff --git a/extensions/imessage/media-contract-api.ts b/extensions/imessage/media-contract-api.ts
index f6ae1fd7279f..c8e3c6a62e34 100644
--- a/extensions/imessage/media-contract-api.ts
+++ b/extensions/imessage/media-contract-api.ts
@@ -1,3 +1,4 @@
+// Imessage API module exposes the plugin public contract.
 export {
   DEFAULT_IMESSAGE_ATTACHMENT_ROOTS,
   resolveIMessageAttachmentRoots,
diff --git a/extensions/imessage/message-tool-api.ts b/extensions/imessage/message-tool-api.ts
index a58e9efd6e37..812fdb94249f 100644
--- a/extensions/imessage/message-tool-api.ts
+++ b/extensions/imessage/message-tool-api.ts
@@ -1 +1,2 @@
+// Imessage API module exposes the plugin public contract.
 export { describeIMessageMessageTool as describeMessageTool } from "./src/message-tool-api.js";
diff --git a/extensions/imessage/runtime-api.ts b/extensions/imessage/runtime-api.ts
index 834b938faff1..fa52148ffc2b 100644
--- a/extensions/imessage/runtime-api.ts
+++ b/extensions/imessage/runtime-api.ts
@@ -1,3 +1,4 @@
+// Imessage API module exposes the plugin public contract.
 import type { OpenClawConfig as RuntimeApiOpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 
 export {
diff --git a/extensions/imessage/setup-entry.ts b/extensions/imessage/setup-entry.ts
index 9c0bd7825c6d..edc0f58ed80c 100644
--- a/extensions/imessage/setup-entry.ts
+++ b/extensions/imessage/setup-entry.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/imessage/src/account-types.ts b/extensions/imessage/src/account-types.ts
index 42daf815bc0e..fa9038d48866 100644
--- a/extensions/imessage/src/account-types.ts
+++ b/extensions/imessage/src/account-types.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements account types behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 
 export type IMessageAccountConfig = Omit<
diff --git a/extensions/imessage/src/accounts.test.ts b/extensions/imessage/src/accounts.test.ts
index 5ac39d5aeede..7e0d38d8ffc7 100644
--- a/extensions/imessage/src/accounts.test.ts
+++ b/extensions/imessage/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover accounts plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   collectIMessageDuplicateAccountSourceWarnings,
diff --git a/extensions/imessage/src/accounts.ts b/extensions/imessage/src/accounts.ts
index ad8203a516c1..6e2454f7ec5e 100644
--- a/extensions/imessage/src/accounts.ts
+++ b/extensions/imessage/src/accounts.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements accounts behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import {
   createAccountListHelpers,
diff --git a/extensions/imessage/src/actions-contract.ts b/extensions/imessage/src/actions-contract.ts
index 39012b4bfc23..5dd14b2a97bb 100644
--- a/extensions/imessage/src/actions-contract.ts
+++ b/extensions/imessage/src/actions-contract.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements actions contract behavior.
 export const IMESSAGE_ACTIONS = {
   react: { gate: "reactions" },
   edit: { gate: "edit" },
diff --git a/extensions/imessage/src/actions.runtime.test.ts b/extensions/imessage/src/actions.runtime.test.ts
index 68690bb6882a..40116f1c7050 100644
--- a/extensions/imessage/src/actions.runtime.test.ts
+++ b/extensions/imessage/src/actions.runtime.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover actions plugin behavior.
 import { EventEmitter } from "node:events";
 import { afterEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/imessage/src/actions.runtime.ts b/extensions/imessage/src/actions.runtime.ts
index 5d415df6d4a6..02d9ae798333 100644
--- a/extensions/imessage/src/actions.runtime.ts
+++ b/extensions/imessage/src/actions.runtime.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements actions behavior.
 import { spawn } from "node:child_process";
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import { extname, join } from "node:path";
diff --git a/extensions/imessage/src/actions.test.ts b/extensions/imessage/src/actions.test.ts
index b521b737853c..401f6822c18e 100644
--- a/extensions/imessage/src/actions.test.ts
+++ b/extensions/imessage/src/actions.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover actions plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/imessage/src/actions.ts b/extensions/imessage/src/actions.ts
index b293423182f1..4372ca1b68b4 100644
--- a/extensions/imessage/src/actions.ts
+++ b/extensions/imessage/src/actions.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements actions behavior.
 import { readBooleanParam } from "openclaw/plugin-sdk/boolean-param";
 import {
   createActionGate,
diff --git a/extensions/imessage/src/approval-auth.test.ts b/extensions/imessage/src/approval-auth.test.ts
index 626d7b2a19e5..b16ebb61e0eb 100644
--- a/extensions/imessage/src/approval-auth.test.ts
+++ b/extensions/imessage/src/approval-auth.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { getIMessageApprovalApprovers, imessageApprovalAuth } from "./approval-auth.js";
 
diff --git a/extensions/imessage/src/approval-auth.ts b/extensions/imessage/src/approval-auth.ts
index 2ec7a7bd925e..5e177052d5ac 100644
--- a/extensions/imessage/src/approval-auth.ts
+++ b/extensions/imessage/src/approval-auth.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,
diff --git a/extensions/imessage/src/approval-handler.runtime.test.ts b/extensions/imessage/src/approval-handler.runtime.test.ts
index 52092c53f7a7..507a63286c87 100644
--- a/extensions/imessage/src/approval-handler.runtime.test.ts
+++ b/extensions/imessage/src/approval-handler.runtime.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover approval handler plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { imessageApprovalNativeRuntime } from "./approval-handler.runtime.js";
 
diff --git a/extensions/imessage/src/approval-handler.runtime.ts b/extensions/imessage/src/approval-handler.runtime.ts
index 41c78754ec22..1739aea36d52 100644
--- a/extensions/imessage/src/approval-handler.runtime.ts
+++ b/extensions/imessage/src/approval-handler.runtime.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements approval handler behavior.
 import {
   buildChannelApprovalExpiredText,
   buildChannelApprovalResolvedText,
diff --git a/extensions/imessage/src/approval-native.test.ts b/extensions/imessage/src/approval-native.test.ts
index 3372e675ad4a..5711ac717593 100644
--- a/extensions/imessage/src/approval-native.test.ts
+++ b/extensions/imessage/src/approval-native.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover approval native plugin behavior.
 import type {
   ExecApprovalRequest,
   PluginApprovalRequest,
diff --git a/extensions/imessage/src/approval-native.ts b/extensions/imessage/src/approval-native.ts
index 431388775cce..2eaa967866f0 100644
--- a/extensions/imessage/src/approval-native.ts
+++ b/extensions/imessage/src/approval-native.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements approval native behavior.
 import {
   createChannelApprovalCapability,
   splitChannelApprovalCapability,
diff --git a/extensions/imessage/src/approval-reaction-poller.test.ts b/extensions/imessage/src/approval-reaction-poller.test.ts
index 635419f54127..8d2755fb6aad 100644
--- a/extensions/imessage/src/approval-reaction-poller.test.ts
+++ b/extensions/imessage/src/approval-reaction-poller.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover approval reaction poller plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { pollPendingIMessageApprovalReactions } from "./approval-reaction-poller.js";
 import {
diff --git a/extensions/imessage/src/approval-reaction-poller.ts b/extensions/imessage/src/approval-reaction-poller.ts
index 22e31cad2761..897fe8c06fd7 100644
--- a/extensions/imessage/src/approval-reaction-poller.ts
+++ b/extensions/imessage/src/approval-reaction-poller.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements approval reaction poller behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   asDateTimestampMs,
diff --git a/extensions/imessage/src/approval-reactions.test.ts b/extensions/imessage/src/approval-reactions.test.ts
index bbf55d601ae2..d549ce8958d9 100644
--- a/extensions/imessage/src/approval-reactions.test.ts
+++ b/extensions/imessage/src/approval-reactions.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover approval reactions plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   appendIMessageApprovalReactionHintForOutboundMessage,
diff --git a/extensions/imessage/src/approval-reactions.ts b/extensions/imessage/src/approval-reactions.ts
index a3ffb14e8cd4..0f01349d1384 100644
--- a/extensions/imessage/src/approval-reactions.ts
+++ b/extensions/imessage/src/approval-reactions.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements approval reactions behavior.
 import {
   buildApprovalReactionHint,
   createApprovalReactionTargetStore,
diff --git a/extensions/imessage/src/approval-resolver.ts b/extensions/imessage/src/approval-resolver.ts
index 857c284247e6..ed0cb803e115 100644
--- a/extensions/imessage/src/approval-resolver.ts
+++ b/extensions/imessage/src/approval-resolver.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements 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/imessage/src/channel-api.ts b/extensions/imessage/src/channel-api.ts
index 3640e26bb0e7..1b39f5c5fd32 100644
--- a/extensions/imessage/src/channel-api.ts
+++ b/extensions/imessage/src/channel-api.ts
@@ -1,3 +1,4 @@
+// Imessage API module exposes the plugin public contract.
 import { formatTrimmedAllowFromEntries } from "openclaw/plugin-sdk/channel-config-helpers";
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
 import {
diff --git a/extensions/imessage/src/channel-inbound-roots.contract.test.ts b/extensions/imessage/src/channel-inbound-roots.contract.test.ts
index 4fa28d6dc3b0..53f9b505fd55 100644
--- a/extensions/imessage/src/channel-inbound-roots.contract.test.ts
+++ b/extensions/imessage/src/channel-inbound-roots.contract.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover channel inbound roots.contract plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/imessage/src/channel.runtime.test.ts b/extensions/imessage/src/channel.runtime.test.ts
index e9f879aeaec7..7c632937edd6 100644
--- a/extensions/imessage/src/channel.runtime.test.ts
+++ b/extensions/imessage/src/channel.runtime.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover channel plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 
 const monitorMock = vi.hoisted(() => vi.fn(async () => undefined));
diff --git a/extensions/imessage/src/channel.runtime.ts b/extensions/imessage/src/channel.runtime.ts
index c1ff155364ab..d70f68c8651d 100644
--- a/extensions/imessage/src/channel.runtime.ts
+++ b/extensions/imessage/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements channel behavior.
 import { resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
 import { resolveIMessageDuplicateSourceOwner, type ResolvedIMessageAccount } from "./accounts.js";
 import { PAIRING_APPROVED_MESSAGE, resolveChannelMediaMaxBytes } from "./channel-api.js";
diff --git a/extensions/imessage/src/channel.setup.ts b/extensions/imessage/src/channel.setup.ts
index 37b84d3a1246..46767bc90cdb 100644
--- a/extensions/imessage/src/channel.setup.ts
+++ b/extensions/imessage/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements channel.setup behavior.
 import type { ResolvedIMessageAccount } from "./accounts.js";
 import type { ChannelPlugin } from "./channel-api.js";
 import { imessageSetupAdapter } from "./setup-core.js";
diff --git a/extensions/imessage/src/channel.ts b/extensions/imessage/src/channel.ts
index 7190c302f35c..2f3eb48372a3 100644
--- a/extensions/imessage/src/channel.ts
+++ b/extensions/imessage/src/channel.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements channel behavior.
 import { buildDmGroupAccountAllowlistAdapter } from "openclaw/plugin-sdk/allowlist-config-edit";
 import { createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import {
diff --git a/extensions/imessage/src/chat.ts b/extensions/imessage/src/chat.ts
index ae51deb012a0..b35824449a99 100644
--- a/extensions/imessage/src/chat.ts
+++ b/extensions/imessage/src/chat.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements chat behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { resolveIMessageAccount, type ResolvedIMessageAccount } from "./accounts.js";
diff --git a/extensions/imessage/src/cli-output.test.ts b/extensions/imessage/src/cli-output.test.ts
index 222b2ec5dde5..eacffe8c4776 100644
--- a/extensions/imessage/src/cli-output.test.ts
+++ b/extensions/imessage/src/cli-output.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover cli output plugin behavior.
 import { describe, expect, it } from "vitest";
 import { appendIMessageCliStderrTail, appendIMessageCliStdout } from "./cli-output.js";
 
diff --git a/extensions/imessage/src/cli-output.ts b/extensions/imessage/src/cli-output.ts
index cf7f89499865..d22617187dd1 100644
--- a/extensions/imessage/src/cli-output.ts
+++ b/extensions/imessage/src/cli-output.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements cli output behavior.
 export const IMESSAGE_CLI_STDOUT_MAX_CHARS = 8 * 1024 * 1024;
 export const IMESSAGE_CLI_STDERR_TAIL_CHARS = 64 * 1024;
 
diff --git a/extensions/imessage/src/client.ts b/extensions/imessage/src/client.ts
index 463a043151e3..7d13b25d8698 100644
--- a/extensions/imessage/src/client.ts
+++ b/extensions/imessage/src/client.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements client behavior.
 import { type ChildProcessWithoutNullStreams, spawn } from "node:child_process";
 import { createInterface, type Interface } from "node:readline";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/imessage/src/config-accessors.test.ts b/extensions/imessage/src/config-accessors.test.ts
index b84dd343fc66..beb49c49f4f7 100644
--- a/extensions/imessage/src/config-accessors.test.ts
+++ b/extensions/imessage/src/config-accessors.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover config accessors plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveIMessageConfigAllowFrom,
diff --git a/extensions/imessage/src/config-accessors.ts b/extensions/imessage/src/config-accessors.ts
index d46fefb89f9e..6dd04de59469 100644
--- a/extensions/imessage/src/config-accessors.ts
+++ b/extensions/imessage/src/config-accessors.ts
@@ -1,3 +1,4 @@
+// Imessage helper module supports config accessors behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolveIMessageAccount } from "./accounts.js";
 
diff --git a/extensions/imessage/src/config-schema.test.ts b/extensions/imessage/src/config-schema.test.ts
index 0eff98b315a3..81c266f92bc8 100644
--- a/extensions/imessage/src/config-schema.test.ts
+++ b/extensions/imessage/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { IMessageConfigSchema } from "../config-api.js";
 
diff --git a/extensions/imessage/src/config-schema.ts b/extensions/imessage/src/config-schema.ts
index cf6a0da2fb31..071ee59e3f9e 100644
--- a/extensions/imessage/src/config-schema.ts
+++ b/extensions/imessage/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Imessage helper module supports config schema behavior.
 import { buildChannelConfigSchema, IMessageConfigSchema } from "../config-api.js";
 import { iMessageChannelConfigUiHints } from "./config-ui-hints.js";
 
diff --git a/extensions/imessage/src/config-ui-hints.ts b/extensions/imessage/src/config-ui-hints.ts
index ccf8eb5ae3d7..8666d09721bb 100644
--- a/extensions/imessage/src/config-ui-hints.ts
+++ b/extensions/imessage/src/config-ui-hints.ts
@@ -1,3 +1,4 @@
+// Imessage helper module supports config ui hints behavior.
 import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/core";
 
 export const iMessageChannelConfigUiHints = {
diff --git a/extensions/imessage/src/conversation-bindings.ts b/extensions/imessage/src/conversation-bindings.ts
index 96b09c9e8eaa..85b00f85e349 100644
--- a/extensions/imessage/src/conversation-bindings.ts
+++ b/extensions/imessage/src/conversation-bindings.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements conversation bindings behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   createAccountScopedConversationBindingManager,
diff --git a/extensions/imessage/src/conversation-id-core.ts b/extensions/imessage/src/conversation-id-core.ts
index 03b408d01b19..634d188540ca 100644
--- a/extensions/imessage/src/conversation-id-core.ts
+++ b/extensions/imessage/src/conversation-id-core.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements conversation id core behavior.
 import { normalizeIMessageHandle, parseIMessageTarget } from "./targets.js";
 
 export function normalizeIMessageAcpConversationId(
diff --git a/extensions/imessage/src/conversation-id.ts b/extensions/imessage/src/conversation-id.ts
index ccf620eb6f7b..8a082a1b9069 100644
--- a/extensions/imessage/src/conversation-id.ts
+++ b/extensions/imessage/src/conversation-id.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements conversation id behavior.
 import {
   matchIMessageAcpConversation,
   normalizeIMessageAcpConversationId,
diff --git a/extensions/imessage/src/conversation-route.test.ts b/extensions/imessage/src/conversation-route.test.ts
index 4d1bc0633cb5..55c549fe2edd 100644
--- a/extensions/imessage/src/conversation-route.test.ts
+++ b/extensions/imessage/src/conversation-route.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover conversation route plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   testing as sessionBindingTesting,
diff --git a/extensions/imessage/src/conversation-route.ts b/extensions/imessage/src/conversation-route.ts
index a3fd49012d0d..85333a226d55 100644
--- a/extensions/imessage/src/conversation-route.ts
+++ b/extensions/imessage/src/conversation-route.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements conversation route behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   resolveConfiguredBindingRoute,
diff --git a/extensions/imessage/src/doctor.test.ts b/extensions/imessage/src/doctor.test.ts
index 57325a2ae575..a4187ec2e686 100644
--- a/extensions/imessage/src/doctor.test.ts
+++ b/extensions/imessage/src/doctor.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover doctor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { imessageDoctor } from "./doctor.js";
 
diff --git a/extensions/imessage/src/doctor.ts b/extensions/imessage/src/doctor.ts
index 4d84f81e1f63..57417a3a7cb1 100644
--- a/extensions/imessage/src/doctor.ts
+++ b/extensions/imessage/src/doctor.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements doctor behavior.
 import type { ChannelDoctorAdapter } from "openclaw/plugin-sdk/channel-contract";
 import { collectIMessageDuplicateAccountSourceWarnings } from "./accounts.js";
 
diff --git a/extensions/imessage/src/group-policy.ts b/extensions/imessage/src/group-policy.ts
index 71efac603ed2..f8058d50a1e9 100644
--- a/extensions/imessage/src/group-policy.ts
+++ b/extensions/imessage/src/group-policy.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements group policy behavior.
 import {
   resolveChannelGroupRequireMention,
   resolveChannelGroupToolsPolicy,
diff --git a/extensions/imessage/src/imessage.test-plugin.ts b/extensions/imessage/src/imessage.test-plugin.ts
index 07b2de498085..b023dcf83d90 100644
--- a/extensions/imessage/src/imessage.test-plugin.ts
+++ b/extensions/imessage/src/imessage.test-plugin.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements imessage plugin behavior.
 import type {
   ChannelMessageActionAdapter,
   ChannelMessageActionName,
diff --git a/extensions/imessage/src/markdown-format.test.ts b/extensions/imessage/src/markdown-format.test.ts
index 0da088d1c8da..ea5fba37e73e 100644
--- a/extensions/imessage/src/markdown-format.test.ts
+++ b/extensions/imessage/src/markdown-format.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover markdown format plugin behavior.
 import { describe, expect, it } from "vitest";
 import { extractMarkdownFormatRuns } from "./markdown-format.js";
 
diff --git a/extensions/imessage/src/media-contract.ts b/extensions/imessage/src/media-contract.ts
index 35e808c9005f..79b447a20bd2 100644
--- a/extensions/imessage/src/media-contract.ts
+++ b/extensions/imessage/src/media-contract.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements media contract behavior.
 import { mergeInboundPathRoots } from "openclaw/plugin-sdk/channel-inbound";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolveIMessageAccount } from "./accounts.js";
diff --git a/extensions/imessage/src/message-tool-api.test.ts b/extensions/imessage/src/message-tool-api.test.ts
index 2c65aef5d85f..b45e9d2a4375 100644
--- a/extensions/imessage/src/message-tool-api.test.ts
+++ b/extensions/imessage/src/message-tool-api.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover message tool api plugin behavior.
 import { beforeEach, describe, expect, it } from "vitest";
 import { describeMessageTool } from "../message-tool-api.js";
 import {
diff --git a/extensions/imessage/src/message-tool-api.ts b/extensions/imessage/src/message-tool-api.ts
index 244763d391ee..9fee17a801ee 100644
--- a/extensions/imessage/src/message-tool-api.ts
+++ b/extensions/imessage/src/message-tool-api.ts
@@ -1,3 +1,4 @@
+// Imessage API module exposes the plugin public contract.
 import { createActionGate } from "openclaw/plugin-sdk/channel-actions";
 import type {
   ChannelMessageActionAdapter,
diff --git a/extensions/imessage/src/monitor-reply-cache.test.ts b/extensions/imessage/src/monitor-reply-cache.test.ts
index bba49d10ff4c..8fa29c954ba5 100644
--- a/extensions/imessage/src/monitor-reply-cache.test.ts
+++ b/extensions/imessage/src/monitor-reply-cache.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover monitor reply cache plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   resetIMessageShortIdState,
diff --git a/extensions/imessage/src/monitor-reply-cache.ts b/extensions/imessage/src/monitor-reply-cache.ts
index 724fb3d90fc8..4fee594126ed 100644
--- a/extensions/imessage/src/monitor-reply-cache.ts
+++ b/extensions/imessage/src/monitor-reply-cache.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements monitor reply cache behavior.
 import { createHash } from "node:crypto";
 import type { PluginStateSyncKeyedStore } from "openclaw/plugin-sdk/plugin-state-runtime";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/imessage/src/monitor.gating.test.ts b/extensions/imessage/src/monitor.gating.test.ts
index 5927e34a7632..b44a4206a227 100644
--- a/extensions/imessage/src/monitor.gating.test.ts
+++ b/extensions/imessage/src/monitor.gating.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover monitor.gating plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it } from "vitest";
 import { resetIMessageShortIdState } from "./monitor-reply-cache.js";
diff --git a/extensions/imessage/src/monitor.last-route.test.ts b/extensions/imessage/src/monitor.last-route.test.ts
index 04c5c3541b32..e2c1799551e0 100644
--- a/extensions/imessage/src/monitor.last-route.test.ts
+++ b/extensions/imessage/src/monitor.last-route.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover monitor.last route plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/imessage/src/monitor.media-policy.test.ts b/extensions/imessage/src/monitor.media-policy.test.ts
index d4cf870b5acb..a22ee2a75965 100644
--- a/extensions/imessage/src/monitor.media-policy.test.ts
+++ b/extensions/imessage/src/monitor.media-policy.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover monitor.media policy plugin behavior.
 import type { waitForTransportReady } from "openclaw/plugin-sdk/transport-ready-runtime";
 import { describe, expect, it, vi } from "vitest";
 import type { createIMessageRpcClient } from "./client.js";
diff --git a/extensions/imessage/src/monitor.plugin-payload.test.ts b/extensions/imessage/src/monitor.plugin-payload.test.ts
index bb48b485358f..d782da428a99 100644
--- a/extensions/imessage/src/monitor.plugin-payload.test.ts
+++ b/extensions/imessage/src/monitor.plugin-payload.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover monitor.plugin payload plugin behavior.
 import type { waitForTransportReady } from "openclaw/plugin-sdk/transport-ready-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { createIMessageRpcClient } from "./client.js";
diff --git a/extensions/imessage/src/monitor.shutdown.unhandled-rejection.test.ts b/extensions/imessage/src/monitor.shutdown.unhandled-rejection.test.ts
index 5816118a3635..d0b925e96073 100644
--- a/extensions/imessage/src/monitor.shutdown.unhandled-rejection.test.ts
+++ b/extensions/imessage/src/monitor.shutdown.unhandled-rejection.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover monitor.shutdown.unhandled rejection plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { attachIMessageMonitorAbortHandler } from "./monitor/abort-handler.js";
 
diff --git a/extensions/imessage/src/monitor.ts b/extensions/imessage/src/monitor.ts
index 487e99e5911c..5d517fb10dcd 100644
--- a/extensions/imessage/src/monitor.ts
+++ b/extensions/imessage/src/monitor.ts
@@ -1,2 +1,3 @@
+// Imessage plugin module implements monitor behavior.
 export { monitorIMessageProvider } from "./monitor/monitor-provider.js";
 export type { MonitorIMessageOpts } from "./monitor/types.js";
diff --git a/extensions/imessage/src/monitor.watch-subscribe-retry.test.ts b/extensions/imessage/src/monitor.watch-subscribe-retry.test.ts
index b1931b19910e..edafc28360e6 100644
--- a/extensions/imessage/src/monitor.watch-subscribe-retry.test.ts
+++ b/extensions/imessage/src/monitor.watch-subscribe-retry.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover monitor.watch subscribe retry plugin behavior.
 import type { waitForTransportReady } from "openclaw/plugin-sdk/transport-ready-runtime";
 import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { createIMessageRpcClient, IMessageRpcClient } from "./client.js";
diff --git a/extensions/imessage/src/monitor/abort-handler.ts b/extensions/imessage/src/monitor/abort-handler.ts
index dff9f7716cdf..fe0b8033b16d 100644
--- a/extensions/imessage/src/monitor/abort-handler.ts
+++ b/extensions/imessage/src/monitor/abort-handler.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements abort handler behavior.
 type IMessageMonitorClient = {
   request: (method: string, params?: Record<string, unknown>) => Promise<unknown>;
   stop: () => Promise<void>;
diff --git a/extensions/imessage/src/monitor/catchup-bridge.test.ts b/extensions/imessage/src/monitor/catchup-bridge.test.ts
index 02a28773e8cb..b3d105202852 100644
--- a/extensions/imessage/src/monitor/catchup-bridge.test.ts
+++ b/extensions/imessage/src/monitor/catchup-bridge.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover catchup bridge plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { installIMessageStateRuntimeForTest } from "../test-support/runtime.js";
 import { runIMessageCatchup } from "./catchup-bridge.js";
diff --git a/extensions/imessage/src/monitor/catchup-bridge.ts b/extensions/imessage/src/monitor/catchup-bridge.ts
index df695906b773..da449e28e140 100644
--- a/extensions/imessage/src/monitor/catchup-bridge.ts
+++ b/extensions/imessage/src/monitor/catchup-bridge.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements catchup bridge behavior.
 import { timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
 import { warn } from "openclaw/plugin-sdk/runtime-env";
 import type { IMessageRpcClient } from "../client.js";
diff --git a/extensions/imessage/src/monitor/catchup.test.ts b/extensions/imessage/src/monitor/catchup.test.ts
index 68690e8cd797..b605bf237670 100644
--- a/extensions/imessage/src/monitor/catchup.test.ts
+++ b/extensions/imessage/src/monitor/catchup.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover catchup plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { installIMessageStateRuntimeForTest } from "../test-support/runtime.js";
 import {
diff --git a/extensions/imessage/src/monitor/catchup.ts b/extensions/imessage/src/monitor/catchup.ts
index a67c2da90ad1..d719cdab484c 100644
--- a/extensions/imessage/src/monitor/catchup.ts
+++ b/extensions/imessage/src/monitor/catchup.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements catchup behavior.
 import { createHash } from "node:crypto";
 import type { PluginStateSyncKeyedStore } from "openclaw/plugin-sdk/plugin-state-runtime";
 import { getIMessageRuntime } from "../runtime.js";
diff --git a/extensions/imessage/src/monitor/coalesce.test.ts b/extensions/imessage/src/monitor/coalesce.test.ts
index d0447b149a89..0e4e23248ce9 100644
--- a/extensions/imessage/src/monitor/coalesce.test.ts
+++ b/extensions/imessage/src/monitor/coalesce.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover coalesce plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   combineIMessagePayloads,
diff --git a/extensions/imessage/src/monitor/coalesce.ts b/extensions/imessage/src/monitor/coalesce.ts
index 034d9022f252..c763aacd739a 100644
--- a/extensions/imessage/src/monitor/coalesce.ts
+++ b/extensions/imessage/src/monitor/coalesce.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements coalesce behavior.
 import type { IMessagePayload } from "./types.js";
 
 // Keep the coalescing contract narrow (caps, ID tracking, reply-context
diff --git a/extensions/imessage/src/monitor/conversation-repair.test.ts b/extensions/imessage/src/monitor/conversation-repair.test.ts
index 350a32eead38..13e704aecfe1 100644
--- a/extensions/imessage/src/monitor/conversation-repair.test.ts
+++ b/extensions/imessage/src/monitor/conversation-repair.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover conversation repair plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { isIMessageAnchorless, repairIMessageConversationAnchor } from "./conversation-repair.js";
 import type { IMessagePayload } from "./types.js";
diff --git a/extensions/imessage/src/monitor/conversation-repair.ts b/extensions/imessage/src/monitor/conversation-repair.ts
index f45a576a1014..680367fb98d6 100644
--- a/extensions/imessage/src/monitor/conversation-repair.ts
+++ b/extensions/imessage/src/monitor/conversation-repair.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements conversation repair behavior.
 import type { IMessageRpcClient } from "../client.js";
 import type { IMessagePayload } from "./types.js";
 
diff --git a/extensions/imessage/src/monitor/deliver.runtime.ts b/extensions/imessage/src/monitor/deliver.runtime.ts
index 8a134f4d1650..b615ac5dfef6 100644
--- a/extensions/imessage/src/monitor/deliver.runtime.ts
+++ b/extensions/imessage/src/monitor/deliver.runtime.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements deliver behavior.
 export { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
 export { chunkTextWithMode, resolveChunkMode } from "openclaw/plugin-sdk/reply-runtime";
 export { convertMarkdownTables } from "openclaw/plugin-sdk/text-chunking";
diff --git a/extensions/imessage/src/monitor/deliver.test.ts b/extensions/imessage/src/monitor/deliver.test.ts
index eb654dda7f70..ab9c5d4a0548 100644
--- a/extensions/imessage/src/monitor/deliver.test.ts
+++ b/extensions/imessage/src/monitor/deliver.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover deliver plugin behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/imessage/src/monitor/deliver.ts b/extensions/imessage/src/monitor/deliver.ts
index de5629a984fb..3a41e443bad9 100644
--- a/extensions/imessage/src/monitor/deliver.ts
+++ b/extensions/imessage/src/monitor/deliver.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements deliver behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   deliverTextOrMediaReply,
diff --git a/extensions/imessage/src/monitor/dm-history.test.ts b/extensions/imessage/src/monitor/dm-history.test.ts
index 56f0a2e7ad32..4408cb288c5d 100644
--- a/extensions/imessage/src/monitor/dm-history.test.ts
+++ b/extensions/imessage/src/monitor/dm-history.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover dm history plugin behavior.
 import { resolveEnvelopeFormatOptions } from "openclaw/plugin-sdk/channel-inbound";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/imessage/src/monitor/dm-history.ts b/extensions/imessage/src/monitor/dm-history.ts
index bcd044589c92..98f247ed1b6f 100644
--- a/extensions/imessage/src/monitor/dm-history.ts
+++ b/extensions/imessage/src/monitor/dm-history.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements dm history behavior.
 import {
   formatInboundEnvelope,
   type resolveEnvelopeFormatOptions,
diff --git a/extensions/imessage/src/monitor/echo-cache.ts b/extensions/imessage/src/monitor/echo-cache.ts
index a4a079f28807..f0d74bc96c92 100644
--- a/extensions/imessage/src/monitor/echo-cache.ts
+++ b/extensions/imessage/src/monitor/echo-cache.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements echo cache behavior.
 import { hasPersistedIMessageEcho } from "./persisted-echo-cache.js";
 
 type SentMessageLookup = {
diff --git a/extensions/imessage/src/monitor/group-allowlist-warnings.test.ts b/extensions/imessage/src/monitor/group-allowlist-warnings.test.ts
index 0a74cf4a2820..1e99d049eda2 100644
--- a/extensions/imessage/src/monitor/group-allowlist-warnings.test.ts
+++ b/extensions/imessage/src/monitor/group-allowlist-warnings.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover group allowlist warnings plugin behavior.
 import { beforeEach, describe, expect, it } from "vitest";
 import {
   resetGroupAllowlistWarningsForTesting,
diff --git a/extensions/imessage/src/monitor/inbound-processing.systemPrompt.test.ts b/extensions/imessage/src/monitor/inbound-processing.systemPrompt.test.ts
index bf7a86b490ba..b9d58e9520c0 100644
--- a/extensions/imessage/src/monitor/inbound-processing.systemPrompt.test.ts
+++ b/extensions/imessage/src/monitor/inbound-processing.systemPrompt.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover inbound processing.systemPrompt plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/imessage/src/monitor/inbound-processing.test.ts b/extensions/imessage/src/monitor/inbound-processing.test.ts
index 8a0408042183..752bfd80218a 100644
--- a/extensions/imessage/src/monitor/inbound-processing.test.ts
+++ b/extensions/imessage/src/monitor/inbound-processing.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover inbound processing plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { sanitizeTerminalText } from "openclaw/plugin-sdk/test-fixtures";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/imessage/src/monitor/inbound-processing.ts b/extensions/imessage/src/monitor/inbound-processing.ts
index 80344cf2fef5..e7a72f74fcec 100644
--- a/extensions/imessage/src/monitor/inbound-processing.ts
+++ b/extensions/imessage/src/monitor/inbound-processing.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements inbound processing behavior.
 import {
   buildMentionRegexes,
   buildChannelInboundEventContext,
diff --git a/extensions/imessage/src/monitor/loop-rate-limiter.test.ts b/extensions/imessage/src/monitor/loop-rate-limiter.test.ts
index d156ffc2c367..bc321e6e3ff3 100644
--- a/extensions/imessage/src/monitor/loop-rate-limiter.test.ts
+++ b/extensions/imessage/src/monitor/loop-rate-limiter.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover loop rate limiter plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { createLoopRateLimiter } from "./loop-rate-limiter.js";
 
diff --git a/extensions/imessage/src/monitor/media-staging.test.ts b/extensions/imessage/src/monitor/media-staging.test.ts
index 8d93e1961fd1..f24bd7c7afd6 100644
--- a/extensions/imessage/src/monitor/media-staging.test.ts
+++ b/extensions/imessage/src/monitor/media-staging.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover media staging plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/imessage/src/monitor/media-staging.ts b/extensions/imessage/src/monitor/media-staging.ts
index 6e7bfcaccee5..f33a579ee430 100644
--- a/extensions/imessage/src/monitor/media-staging.ts
+++ b/extensions/imessage/src/monitor/media-staging.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements media staging behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { isInboundPathAllowed } from "openclaw/plugin-sdk/media-runtime";
diff --git a/extensions/imessage/src/monitor/monitor-provider.echo-cache.test.ts b/extensions/imessage/src/monitor/monitor-provider.echo-cache.test.ts
index 3f3ee36a9eea..f803c8102b23 100644
--- a/extensions/imessage/src/monitor/monitor-provider.echo-cache.test.ts
+++ b/extensions/imessage/src/monitor/monitor-provider.echo-cache.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover monitor provider.echo cache plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   createIMessagePluginStateSyncStoreForTest,
diff --git a/extensions/imessage/src/monitor/monitor-provider.ts b/extensions/imessage/src/monitor/monitor-provider.ts
index 345470d6701e..a67aae3cdafa 100644
--- a/extensions/imessage/src/monitor/monitor-provider.ts
+++ b/extensions/imessage/src/monitor/monitor-provider.ts
@@ -1,3 +1,4 @@
+// Imessage provider module implements model/runtime integration.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/imessage/src/monitor/parse-notification.test.ts b/extensions/imessage/src/monitor/parse-notification.test.ts
index 0d17f76f61dd..801e676d6df4 100644
--- a/extensions/imessage/src/monitor/parse-notification.test.ts
+++ b/extensions/imessage/src/monitor/parse-notification.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover parse notification plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseIMessageNotification } from "./parse-notification.js";
 
diff --git a/extensions/imessage/src/monitor/parse-notification.ts b/extensions/imessage/src/monitor/parse-notification.ts
index 8e5c1cc6556f..dcea0dd3d248 100644
--- a/extensions/imessage/src/monitor/parse-notification.ts
+++ b/extensions/imessage/src/monitor/parse-notification.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements parse notification behavior.
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { stripImessageLengthPrefixedUtf8Text } from "./strip-imsg-length-prefixed-text.js";
 import type { IMessagePayload } from "./types.js";
diff --git a/extensions/imessage/src/monitor/persisted-echo-cache.ts b/extensions/imessage/src/monitor/persisted-echo-cache.ts
index 9d97d13e79de..66818655db24 100644
--- a/extensions/imessage/src/monitor/persisted-echo-cache.ts
+++ b/extensions/imessage/src/monitor/persisted-echo-cache.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements persisted echo cache behavior.
 import { createHash } from "node:crypto";
 import type { PluginStateSyncKeyedStore } from "openclaw/plugin-sdk/plugin-state-runtime";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/imessage/src/monitor/reaction-context.ts b/extensions/imessage/src/monitor/reaction-context.ts
index 87d425b73970..650e018e1eab 100644
--- a/extensions/imessage/src/monitor/reaction-context.ts
+++ b/extensions/imessage/src/monitor/reaction-context.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements reaction context behavior.
 import type { IMessagePayload } from "./types.js";
 
 export type IMessageReactionContext = {
diff --git a/extensions/imessage/src/monitor/reaction-system-event.test.ts b/extensions/imessage/src/monitor/reaction-system-event.test.ts
index b0a407c16dfd..939324943454 100644
--- a/extensions/imessage/src/monitor/reaction-system-event.test.ts
+++ b/extensions/imessage/src/monitor/reaction-system-event.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover reaction system event plugin behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { enqueueSystemEvent } from "openclaw/plugin-sdk/system-event-runtime";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/imessage/src/monitor/reaction-system-event.ts b/extensions/imessage/src/monitor/reaction-system-event.ts
index 4fa204416cae..414f59722cb0 100644
--- a/extensions/imessage/src/monitor/reaction-system-event.ts
+++ b/extensions/imessage/src/monitor/reaction-system-event.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements reaction system event behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { enqueueSystemEvent } from "openclaw/plugin-sdk/system-event-runtime";
 
diff --git a/extensions/imessage/src/monitor/reflection-guard.test.ts b/extensions/imessage/src/monitor/reflection-guard.test.ts
index 3c556b1b8037..49b7b9099213 100644
--- a/extensions/imessage/src/monitor/reflection-guard.test.ts
+++ b/extensions/imessage/src/monitor/reflection-guard.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover reflection guard plugin behavior.
 import { describe, expect, it } from "vitest";
 import { detectReflectedContent } from "./reflection-guard.js";
 
diff --git a/extensions/imessage/src/monitor/reflection-guard.ts b/extensions/imessage/src/monitor/reflection-guard.ts
index de5b50d5413f..be727b8b55d7 100644
--- a/extensions/imessage/src/monitor/reflection-guard.ts
+++ b/extensions/imessage/src/monitor/reflection-guard.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements reflection guard behavior.
 import { findCodeRegions, isInsideCode } from "openclaw/plugin-sdk/text-chunking";
 
 const INTERNAL_SEPARATOR_RE = /(?:#\+){2,}#?/;
diff --git a/extensions/imessage/src/monitor/runtime.ts b/extensions/imessage/src/monitor/runtime.ts
index 61dda91b05ef..b53d131577f4 100644
--- a/extensions/imessage/src/monitor/runtime.ts
+++ b/extensions/imessage/src/monitor/runtime.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements runtime behavior.
 import { createNonExitingRuntime, type RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { MonitorIMessageOpts } from "./types.js";
diff --git a/extensions/imessage/src/monitor/sanitize-outbound.test.ts b/extensions/imessage/src/monitor/sanitize-outbound.test.ts
index ad70b558731a..ab49a0770374 100644
--- a/extensions/imessage/src/monitor/sanitize-outbound.test.ts
+++ b/extensions/imessage/src/monitor/sanitize-outbound.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover sanitize outbound plugin behavior.
 import { describe, expect, it } from "vitest";
 import { sanitizeOutboundText } from "./sanitize-outbound.js";
 
diff --git a/extensions/imessage/src/monitor/sanitize-outbound.ts b/extensions/imessage/src/monitor/sanitize-outbound.ts
index b8499065f7c7..f861f700de25 100644
--- a/extensions/imessage/src/monitor/sanitize-outbound.ts
+++ b/extensions/imessage/src/monitor/sanitize-outbound.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements sanitize outbound behavior.
 import { stripAssistantInternalScaffolding } from "openclaw/plugin-sdk/text-chunking";
 
 /**
diff --git a/extensions/imessage/src/monitor/self-chat-cache.test.ts b/extensions/imessage/src/monitor/self-chat-cache.test.ts
index bd5a4be1fb53..3a3be0041848 100644
--- a/extensions/imessage/src/monitor/self-chat-cache.test.ts
+++ b/extensions/imessage/src/monitor/self-chat-cache.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover self chat cache plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createSelfChatCache } from "./self-chat-cache.js";
 
diff --git a/extensions/imessage/src/monitor/self-chat-cache.ts b/extensions/imessage/src/monitor/self-chat-cache.ts
index 000e706eddf3..5aaf284b58dd 100644
--- a/extensions/imessage/src/monitor/self-chat-cache.ts
+++ b/extensions/imessage/src/monitor/self-chat-cache.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements self chat cache behavior.
 import { createHash } from "node:crypto";
 import { formatIMessageChatTarget } from "../targets.js";
 
diff --git a/extensions/imessage/src/monitor/self-chat-dedupe.test.ts b/extensions/imessage/src/monitor/self-chat-dedupe.test.ts
index f94c130972a5..4d68ff2168bf 100644
--- a/extensions/imessage/src/monitor/self-chat-dedupe.test.ts
+++ b/extensions/imessage/src/monitor/self-chat-dedupe.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover self chat dedupe plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { installIMessageStateRuntimeForTest } from "../test-support/runtime.js";
diff --git a/extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.test.ts b/extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.test.ts
index 964f3434b7a5..0e98d17cf0f5 100644
--- a/extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.test.ts
+++ b/extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover strip imsg length prefixed text plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   stripImessageLengthPrefixedUtf8Text,
diff --git a/extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.ts b/extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.ts
index adefada20627..179327b62cd8 100644
--- a/extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.ts
+++ b/extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements strip imsg length prefixed text behavior.
 type Varint = {
   nextOffset: number;
   value: number;
diff --git a/extensions/imessage/src/monitor/types.ts b/extensions/imessage/src/monitor/types.ts
index a9ec0a4533d7..0b36048ce289 100644
--- a/extensions/imessage/src/monitor/types.ts
+++ b/extensions/imessage/src/monitor/types.ts
@@ -1,3 +1,4 @@
+// Imessage type declarations define plugin contracts.
 import type { ChannelRuntimeSurface } from "openclaw/plugin-sdk/channel-contract";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/imessage/src/monitor/watch-error-log.test.ts b/extensions/imessage/src/monitor/watch-error-log.test.ts
index 20f328f88f2e..d10e7a039acb 100644
--- a/extensions/imessage/src/monitor/watch-error-log.test.ts
+++ b/extensions/imessage/src/monitor/watch-error-log.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover watch error log plugin behavior.
 import { describe, expect, it } from "vitest";
 import { sanitizeIMessageWatchErrorPayload } from "./watch-error-log.js";
 
diff --git a/extensions/imessage/src/monitor/watch-error-log.ts b/extensions/imessage/src/monitor/watch-error-log.ts
index 7b238337d561..ad505fc317b1 100644
--- a/extensions/imessage/src/monitor/watch-error-log.ts
+++ b/extensions/imessage/src/monitor/watch-error-log.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements watch error log behavior.
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { sanitizeTerminalText } from "openclaw/plugin-sdk/text-chunking";
 import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
diff --git a/extensions/imessage/src/normalize.test.ts b/extensions/imessage/src/normalize.test.ts
index 8b8b6125705a..e40e73e33977 100644
--- a/extensions/imessage/src/normalize.test.ts
+++ b/extensions/imessage/src/normalize.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover normalize plugin behavior.
 import { describe, expect, it } from "vitest";
 import { looksLikeIMessageTargetId, normalizeIMessageMessagingTarget } from "./normalize.js";
 
diff --git a/extensions/imessage/src/normalize.ts b/extensions/imessage/src/normalize.ts
index 48e6b27bcf7a..257064408973 100644
--- a/extensions/imessage/src/normalize.ts
+++ b/extensions/imessage/src/normalize.ts
@@ -1,3 +1,4 @@
+// Imessage helper module supports normalize behavior.
 import { normalizeE164 } from "openclaw/plugin-sdk/account-resolution";
 import {
   normalizeLowercaseStringOrEmpty,
diff --git a/extensions/imessage/src/outbound-send-deps.ts b/extensions/imessage/src/outbound-send-deps.ts
index 19c814e7373c..8e7ffb5d44dd 100644
--- a/extensions/imessage/src/outbound-send-deps.ts
+++ b/extensions/imessage/src/outbound-send-deps.ts
@@ -1 +1,2 @@
+// Imessage plugin module implements outbound send deps behavior.
 export const IMESSAGE_LEGACY_OUTBOUND_SEND_DEP_KEYS = ["sendIMessage"] as const;
diff --git a/extensions/imessage/src/private-api-status.ts b/extensions/imessage/src/private-api-status.ts
index e13ca84b7442..8c404715a187 100644
--- a/extensions/imessage/src/private-api-status.ts
+++ b/extensions/imessage/src/private-api-status.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements private api status behavior.
 import { asDateTimestampMs } from "openclaw/plugin-sdk/number-runtime";
 
 export type IMessagePrivateApiStatus = {
diff --git a/extensions/imessage/src/probe.contract.test.ts b/extensions/imessage/src/probe.contract.test.ts
index c943406fb2f8..cc7f759e9cc1 100644
--- a/extensions/imessage/src/probe.contract.test.ts
+++ b/extensions/imessage/src/probe.contract.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover probe.contract plugin behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import { describe, expectTypeOf, it } from "vitest";
 import type { IMessageProbe } from "./probe.js";
diff --git a/extensions/imessage/src/probe.test.ts b/extensions/imessage/src/probe.test.ts
index af290ec8ba42..a1c4ff499c66 100644
--- a/extensions/imessage/src/probe.test.ts
+++ b/extensions/imessage/src/probe.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover probe plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   clearCachedIMessagePrivateApiStatus,
diff --git a/extensions/imessage/src/probe.ts b/extensions/imessage/src/probe.ts
index 7736fb74ca4a..2b094160c848 100644
--- a/extensions/imessage/src/probe.ts
+++ b/extensions/imessage/src/probe.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements probe behavior.
 import path from "node:path";
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import {
diff --git a/extensions/imessage/src/runtime.ts b/extensions/imessage/src/runtime.ts
index 074831f287a6..c9b2470705c7 100644
--- a/extensions/imessage/src/runtime.ts
+++ b/extensions/imessage/src/runtime.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/imessage/src/send.test.ts b/extensions/imessage/src/send.test.ts
index c02b080bf1f9..50194e316861 100644
--- a/extensions/imessage/src/send.test.ts
+++ b/extensions/imessage/src/send.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover send plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/imessage/src/send.ts b/extensions/imessage/src/send.ts
index 2aa66f7df078..5ca888a2d4a9 100644
--- a/extensions/imessage/src/send.ts
+++ b/extensions/imessage/src/send.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements send behavior.
 import { spawn } from "node:child_process";
 import { constants, accessSync, readFileSync } from "node:fs";
 import { createRequire } from "node:module";
diff --git a/extensions/imessage/src/setup-core.ts b/extensions/imessage/src/setup-core.ts
index 30cf5afe16f3..fba973e42eef 100644
--- a/extensions/imessage/src/setup-core.ts
+++ b/extensions/imessage/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements setup core behavior.
 import type {
   ChannelSetupAdapter,
   ChannelSetupWizard,
diff --git a/extensions/imessage/src/setup-surface.ts b/extensions/imessage/src/setup-surface.ts
index af31a0105449..358fa001ca35 100644
--- a/extensions/imessage/src/setup-surface.ts
+++ b/extensions/imessage/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements setup surface behavior.
 import {
   createDetectedBinaryStatus,
   setSetupChannelEnabled,
diff --git a/extensions/imessage/src/shared.ts b/extensions/imessage/src/shared.ts
index 239ade5fa15a..1a4e7186a167 100644
--- a/extensions/imessage/src/shared.ts
+++ b/extensions/imessage/src/shared.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements shared behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import {
   adaptScopedAccountAccessor,
diff --git a/extensions/imessage/src/state-migrations.test.ts b/extensions/imessage/src/state-migrations.test.ts
index 36a0ad5d7dda..2c5115fd2525 100644
--- a/extensions/imessage/src/state-migrations.test.ts
+++ b/extensions/imessage/src/state-migrations.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover state migrations plugin behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/extensions/imessage/src/state-migrations.ts b/extensions/imessage/src/state-migrations.ts
index 54cf09b492d2..4bdc9b34f5bc 100644
--- a/extensions/imessage/src/state-migrations.ts
+++ b/extensions/imessage/src/state-migrations.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements state migrations behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
diff --git a/extensions/imessage/src/status-core.ts b/extensions/imessage/src/status-core.ts
index e9c5f244dcc4..8bcf27887d32 100644
--- a/extensions/imessage/src/status-core.ts
+++ b/extensions/imessage/src/status-core.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements status core behavior.
 import type { ResolvedIMessageAccount } from "./accounts.js";
 import type { IMessageProbe } from "./probe.js";
 
diff --git a/extensions/imessage/src/status.test.ts b/extensions/imessage/src/status.test.ts
index 4b021405e875..013cbb5e917d 100644
--- a/extensions/imessage/src/status.test.ts
+++ b/extensions/imessage/src/status.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover status plugin behavior.
 import { createPluginSetupWizardStatus } from "openclaw/plugin-sdk/plugin-test-runtime";
 import * as processRuntime from "openclaw/plugin-sdk/process-runtime";
 import * as setupRuntime from "openclaw/plugin-sdk/setup";
diff --git a/extensions/imessage/src/target-parsing-helpers.ts b/extensions/imessage/src/target-parsing-helpers.ts
index 8d56e2f0bf4f..7095b74a42c5 100644
--- a/extensions/imessage/src/target-parsing-helpers.ts
+++ b/extensions/imessage/src/target-parsing-helpers.ts
@@ -1,3 +1,4 @@
+// Imessage helper module supports target parsing helpers behavior.
 export {
   createAllowedChatSenderMatcher,
   parseChatAllowTargetPrefixes,
diff --git a/extensions/imessage/src/targets.test.ts b/extensions/imessage/src/targets.test.ts
index 0568834df745..67eb6beba07d 100644
--- a/extensions/imessage/src/targets.test.ts
+++ b/extensions/imessage/src/targets.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover targets plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveIMessageGroupRequireMention,
diff --git a/extensions/imessage/src/targets.ts b/extensions/imessage/src/targets.ts
index 35822a69cbf7..2a63fcf96341 100644
--- a/extensions/imessage/src/targets.ts
+++ b/extensions/imessage/src/targets.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements targets behavior.
 import { normalizeE164 } from "openclaw/plugin-sdk/account-resolution";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
diff --git a/extensions/imessage/src/test-plugin.test.ts b/extensions/imessage/src/test-plugin.test.ts
index 09d7b425628f..133d1abe0d07 100644
--- a/extensions/imessage/src/test-plugin.test.ts
+++ b/extensions/imessage/src/test-plugin.test.ts
@@ -1,3 +1,4 @@
+// Imessage tests cover test plugin plugin behavior.
 import {
   createMessageReceiptFromOutboundResults,
   verifyChannelMessageAdapterCapabilityProofs,
diff --git a/extensions/imessage/src/test-support/runtime.ts b/extensions/imessage/src/test-support/runtime.ts
index 3b0cf1f29f03..e5af35b703ca 100644
--- a/extensions/imessage/src/test-support/runtime.ts
+++ b/extensions/imessage/src/test-support/runtime.ts
@@ -1,3 +1,4 @@
+// Imessage plugin module implements runtime behavior.
 import fs from "node:fs";
 import path from "node:path";
 import type {
diff --git a/extensions/imessage/test-api.ts b/extensions/imessage/test-api.ts
index c0939502702b..0335891bc32b 100644
--- a/extensions/imessage/test-api.ts
+++ b/extensions/imessage/test-api.ts
@@ -1 +1,2 @@
+// Imessage API module exposes the plugin public contract.
 export { createIMessageTestPlugin } from "./src/imessage.test-plugin.js";
diff --git a/extensions/line/api.ts b/extensions/line/api.ts
index 583dec0d4b2b..f0490613a277 100644
--- a/extensions/line/api.ts
+++ b/extensions/line/api.ts
@@ -1,3 +1,4 @@
+// Line API module exposes the plugin public contract.
 export type {
   ChannelAccountSnapshot,
   ChannelPlugin,
diff --git a/extensions/line/channel-plugin-api.ts b/extensions/line/channel-plugin-api.ts
index bfb3db010aa3..702bad817440 100644
--- a/extensions/line/channel-plugin-api.ts
+++ b/extensions/line/channel-plugin-api.ts
@@ -1 +1,2 @@
+// Line API module exposes the plugin public contract.
 export { linePlugin } from "./src/channel.js";
diff --git a/extensions/line/contract-api.ts b/extensions/line/contract-api.ts
index c0d572e3b340..3cf11f76fc09 100644
--- a/extensions/line/contract-api.ts
+++ b/extensions/line/contract-api.ts
@@ -1,3 +1,4 @@
+// Line API module exposes the plugin public contract.
 export {
   listLineAccountIds,
   resolveDefaultLineAccountId,
diff --git a/extensions/line/index.ts b/extensions/line/index.ts
index e730a4fb6f74..2ff34d938e7b 100644
--- a/extensions/line/index.ts
+++ b/extensions/line/index.ts
@@ -1,3 +1,4 @@
+// Line plugin entrypoint registers its OpenClaw integration.
 import {
   defineBundledChannelEntry,
   type OpenClawPluginCommandDefinition,
diff --git a/extensions/line/setup-api.ts b/extensions/line/setup-api.ts
index fb50302ead17..b272e2d9a087 100644
--- a/extensions/line/setup-api.ts
+++ b/extensions/line/setup-api.ts
@@ -1,2 +1,3 @@
+// Line API module exposes the plugin public contract.
 export { lineSetupAdapter } from "./src/setup-core.js";
 export { lineSetupWizard } from "./src/setup-surface.js";
diff --git a/extensions/line/setup-entry.ts b/extensions/line/setup-entry.ts
index e4333c56d1af..e950f405cbb4 100644
--- a/extensions/line/setup-entry.ts
+++ b/extensions/line/setup-entry.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/line/src/account-helpers.ts b/extensions/line/src/account-helpers.ts
index 1f4fd66c79de..1c671ef8ecaa 100644
--- a/extensions/line/src/account-helpers.ts
+++ b/extensions/line/src/account-helpers.ts
@@ -1,3 +1,4 @@
+// Line helper module supports account helpers behavior.
 type LineCredentialAccount = {
   channelAccessToken?: string;
   channelSecret?: string;
diff --git a/extensions/line/src/accounts.test.ts b/extensions/line/src/accounts.test.ts
index d182d0c2f661..8d18e3b92aac 100644
--- a/extensions/line/src/accounts.test.ts
+++ b/extensions/line/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover accounts plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/line/src/accounts.ts b/extensions/line/src/accounts.ts
index f9f93c81e971..cc5775c5b836 100644
--- a/extensions/line/src/accounts.ts
+++ b/extensions/line/src/accounts.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements accounts behavior.
 import {
   DEFAULT_ACCOUNT_ID,
   normalizeAccountId as normalizeSharedAccountId,
diff --git a/extensions/line/src/actions.ts b/extensions/line/src/actions.ts
index 198645110da7..1dfaa7cfbc2a 100644
--- a/extensions/line/src/actions.ts
+++ b/extensions/line/src/actions.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements actions behavior.
 import type { messagingApi } from "@line/bot-sdk";
 
 export type Action = messagingApi.Action;
diff --git a/extensions/line/src/auto-reply-delivery.test.ts b/extensions/line/src/auto-reply-delivery.test.ts
index 1790295928ac..6a4d71d5e8e1 100644
--- a/extensions/line/src/auto-reply-delivery.test.ts
+++ b/extensions/line/src/auto-reply-delivery.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover auto reply delivery plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { LineAutoReplyDeps } from "./auto-reply-delivery.js";
 import { deliverLineAutoReply } from "./auto-reply-delivery.js";
diff --git a/extensions/line/src/auto-reply-delivery.ts b/extensions/line/src/auto-reply-delivery.ts
index a33d7b16a312..9226a7cd9b43 100644
--- a/extensions/line/src/auto-reply-delivery.ts
+++ b/extensions/line/src/auto-reply-delivery.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements auto reply delivery behavior.
 import type { messagingApi } from "@line/bot-sdk";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
diff --git a/extensions/line/src/bindings.ts b/extensions/line/src/bindings.ts
index f13e16574f42..bbc777155595 100644
--- a/extensions/line/src/bindings.ts
+++ b/extensions/line/src/bindings.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements bindings behavior.
 function normalizeLineConversationId(raw?: string | null): string | null {
   const trimmed = raw?.trim() ?? "";
   if (!trimmed) {
diff --git a/extensions/line/src/bot-access.ts b/extensions/line/src/bot-access.ts
index 3e78f92a60b9..0d8e3817a641 100644
--- a/extensions/line/src/bot-access.ts
+++ b/extensions/line/src/bot-access.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements bot access behavior.
 import { firstDefined } from "openclaw/plugin-sdk/allow-from";
 
 export type NormalizedAllowFrom = {
diff --git a/extensions/line/src/bot-handlers.test.ts b/extensions/line/src/bot-handlers.test.ts
index 529ba27941f1..77f4fcf9a156 100644
--- a/extensions/line/src/bot-handlers.test.ts
+++ b/extensions/line/src/bot-handlers.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover bot handlers plugin behavior.
 import type { webhook } from "@line/bot-sdk";
 import type { HistoryEntry } from "openclaw/plugin-sdk/reply-history";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/line/src/bot-handlers.ts b/extensions/line/src/bot-handlers.ts
index ef05617a5bb4..56d445861e35 100644
--- a/extensions/line/src/bot-handlers.ts
+++ b/extensions/line/src/bot-handlers.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements bot handlers behavior.
 import type { webhook } from "@line/bot-sdk";
 import { buildMentionRegexes, matchesMentionPatterns } from "openclaw/plugin-sdk/channel-inbound";
 import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
diff --git a/extensions/line/src/bot-message-context.test.ts b/extensions/line/src/bot-message-context.test.ts
index bf511776d9f1..f5cc35fd47bc 100644
--- a/extensions/line/src/bot-message-context.test.ts
+++ b/extensions/line/src/bot-message-context.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover bot message context plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/line/src/bot-message-context.ts b/extensions/line/src/bot-message-context.ts
index aecbf92c2493..354c71c0d412 100644
--- a/extensions/line/src/bot-message-context.ts
+++ b/extensions/line/src/bot-message-context.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements bot message context behavior.
 import type { webhook } from "@line/bot-sdk";
 import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
 import {
diff --git a/extensions/line/src/bot.ts b/extensions/line/src/bot.ts
index 0eaf37d9c18a..18d2e2c4178d 100644
--- a/extensions/line/src/bot.ts
+++ b/extensions/line/src/bot.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements bot behavior.
 import type { webhook } from "@line/bot-sdk";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { DEFAULT_GROUP_HISTORY_LIMIT, type HistoryEntry } from "openclaw/plugin-sdk/reply-history";
diff --git a/extensions/line/src/card-command.ts b/extensions/line/src/card-command.ts
index 86d5aff7c77e..27e0eaa09ca3 100644
--- a/extensions/line/src/card-command.ts
+++ b/extensions/line/src/card-command.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements card command behavior.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/line/src/channel-access-token.ts b/extensions/line/src/channel-access-token.ts
index 4729af469420..12a7dd8c5285 100644
--- a/extensions/line/src/channel-access-token.ts
+++ b/extensions/line/src/channel-access-token.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements channel access token behavior.
 export function resolveLineChannelAccessToken(
   explicit: string | undefined,
   params: { accountId: string; channelAccessToken: string },
diff --git a/extensions/line/src/channel-api.ts b/extensions/line/src/channel-api.ts
index eecbca9c642e..e4ad65b39685 100644
--- a/extensions/line/src/channel-api.ts
+++ b/extensions/line/src/channel-api.ts
@@ -1,3 +1,4 @@
+// Line API module exposes the plugin public contract.
 export { clearAccountEntryFields } from "openclaw/plugin-sdk/core";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/account-resolution";
diff --git a/extensions/line/src/channel-setup-status.contract.test.ts b/extensions/line/src/channel-setup-status.contract.test.ts
index 5307e1b108a8..a78ed9986e52 100644
--- a/extensions/line/src/channel-setup-status.contract.test.ts
+++ b/extensions/line/src/channel-setup-status.contract.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover channel setup status.contract plugin behavior.
 import {
   installChannelSetupContractSuite,
   installChannelStatusContractSuite,
diff --git a/extensions/line/src/channel-shared.ts b/extensions/line/src/channel-shared.ts
index 7e6099ef0fe4..428c61b0d22c 100644
--- a/extensions/line/src/channel-shared.ts
+++ b/extensions/line/src/channel-shared.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements channel shared behavior.
 import { describeWebhookAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { hasLineCredentials } from "./account-helpers.js";
 import type { ChannelPlugin, ResolvedLineAccount } from "./channel-api.js";
diff --git a/extensions/line/src/channel.logout.test.ts b/extensions/line/src/channel.logout.test.ts
index faf395ad71a9..e9cd89b805a1 100644
--- a/extensions/line/src/channel.logout.test.ts
+++ b/extensions/line/src/channel.logout.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover channel.logout plugin behavior.
 import { createRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig, PluginRuntime, ResolvedLineAccount } from "../api.js";
diff --git a/extensions/line/src/channel.runtime.ts b/extensions/line/src/channel.runtime.ts
index 8efa4677d594..4ccb52c38bca 100644
--- a/extensions/line/src/channel.runtime.ts
+++ b/extensions/line/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements channel behavior.
 export { monitorLineProvider } from "./monitor.js";
 export { probeLineBot } from "./probe.js";
 export { pushMessageLine } from "./send.js";
diff --git a/extensions/line/src/channel.sendPayload.test.ts b/extensions/line/src/channel.sendPayload.test.ts
index 5dcefbf29a7e..a72f08d3b52d 100644
--- a/extensions/line/src/channel.sendPayload.test.ts
+++ b/extensions/line/src/channel.sendPayload.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover channel.sendPayload plugin behavior.
 import {
   verifyChannelMessageAdapterCapabilityProofs,
   verifyChannelMessageReceiveAckPolicyAdapterProofs,
diff --git a/extensions/line/src/channel.setup.ts b/extensions/line/src/channel.setup.ts
index c8548316fc73..6c6e971ee820 100644
--- a/extensions/line/src/channel.setup.ts
+++ b/extensions/line/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements channel.setup behavior.
 import type { ChannelPlugin, ResolvedLineAccount } from "./channel-api.js";
 import { lineChannelPluginCommon } from "./channel-shared.js";
 import { lineSetupAdapter } from "./setup-core.js";
diff --git a/extensions/line/src/channel.status.test.ts b/extensions/line/src/channel.status.test.ts
index 68ac34223d35..fd8024642601 100644
--- a/extensions/line/src/channel.status.test.ts
+++ b/extensions/line/src/channel.status.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover channel.status plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { ChannelAccountSnapshot } from "../api.js";
 import { lineStatusAdapter } from "./status.js";
diff --git a/extensions/line/src/channel.ts b/extensions/line/src/channel.ts
index 33b7c7788fee..9b0dd3c12de1 100644
--- a/extensions/line/src/channel.ts
+++ b/extensions/line/src/channel.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements channel behavior.
 import { createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
 import { createRestrictSendersChannelSecurity } from "openclaw/plugin-sdk/channel-policy";
diff --git a/extensions/line/src/config-adapter.ts b/extensions/line/src/config-adapter.ts
index 70f32c0e013b..eb31c18dda5a 100644
--- a/extensions/line/src/config-adapter.ts
+++ b/extensions/line/src/config-adapter.ts
@@ -1,3 +1,4 @@
+// Line helper module supports config adapter behavior.
 import { createScopedChannelConfigAdapter } from "openclaw/plugin-sdk/channel-config-helpers";
 import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
diff --git a/extensions/line/src/config-schema.test.ts b/extensions/line/src/config-schema.test.ts
index dbf25eb95ce5..0ee316ca6536 100644
--- a/extensions/line/src/config-schema.test.ts
+++ b/extensions/line/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { LineConfigSchema } from "./config-schema.js";
 
diff --git a/extensions/line/src/config-schema.ts b/extensions/line/src/config-schema.ts
index 2ea8eaaaf99f..fa6d5907bea5 100644
--- a/extensions/line/src/config-schema.ts
+++ b/extensions/line/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Line helper module supports config schema behavior.
 import {
   buildChannelConfigSchema,
   requireOpenAllowFrom,
diff --git a/extensions/line/src/download.test.ts b/extensions/line/src/download.test.ts
index 82f9a5526684..e28164ee0aad 100644
--- a/extensions/line/src/download.test.ts
+++ b/extensions/line/src/download.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover download plugin behavior.
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const getMessageContentMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/line/src/download.ts b/extensions/line/src/download.ts
index cc476e6102e2..9695e73d3013 100644
--- a/extensions/line/src/download.ts
+++ b/extensions/line/src/download.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements download behavior.
 import { messagingApi } from "@line/bot-sdk";
 import { saveMediaStream } from "openclaw/plugin-sdk/media-store";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/line/src/flex-templates.ts b/extensions/line/src/flex-templates.ts
index 916dad61388f..8ce6ab830434 100644
--- a/extensions/line/src/flex-templates.ts
+++ b/extensions/line/src/flex-templates.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements flex templates behavior.
 export {
   createActionCard,
   createCarousel,
diff --git a/extensions/line/src/flex-templates/basic-cards.ts b/extensions/line/src/flex-templates/basic-cards.ts
index bec66158c3a2..8b29d71f89d9 100644
--- a/extensions/line/src/flex-templates/basic-cards.ts
+++ b/extensions/line/src/flex-templates/basic-cards.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements basic cards behavior.
 import { attachFooterText } from "./common.js";
 import type {
   Action,
diff --git a/extensions/line/src/flex-templates/common.ts b/extensions/line/src/flex-templates/common.ts
index be39463eeab3..d6847bc86e50 100644
--- a/extensions/line/src/flex-templates/common.ts
+++ b/extensions/line/src/flex-templates/common.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements common behavior.
 import type { FlexBox, FlexBubble, FlexText } from "./types.js";
 
 export function attachFooterText(bubble: FlexBubble, footer: string) {
diff --git a/extensions/line/src/flex-templates/media-control-cards.ts b/extensions/line/src/flex-templates/media-control-cards.ts
index 76fd48a18112..2679bbf97568 100644
--- a/extensions/line/src/flex-templates/media-control-cards.ts
+++ b/extensions/line/src/flex-templates/media-control-cards.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements media control cards behavior.
 import type {
   FlexBox,
   FlexBubble,
diff --git a/extensions/line/src/flex-templates/message.ts b/extensions/line/src/flex-templates/message.ts
index f33d8c994834..039a07f325f6 100644
--- a/extensions/line/src/flex-templates/message.ts
+++ b/extensions/line/src/flex-templates/message.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements message behavior.
 import type { messagingApi } from "@line/bot-sdk";
 import type { FlexContainer } from "./types.js";
 
diff --git a/extensions/line/src/flex-templates/schedule-cards.ts b/extensions/line/src/flex-templates/schedule-cards.ts
index ecea638b1fd9..1480f3d8bc9e 100644
--- a/extensions/line/src/flex-templates/schedule-cards.ts
+++ b/extensions/line/src/flex-templates/schedule-cards.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements schedule cards behavior.
 import { attachFooterText } from "./common.js";
 import type { Action, FlexBox, FlexBubble, FlexComponent, FlexText } from "./types.js";
 
diff --git a/extensions/line/src/flex-templates/types.ts b/extensions/line/src/flex-templates/types.ts
index 5b5e25b406ee..23702f244df1 100644
--- a/extensions/line/src/flex-templates/types.ts
+++ b/extensions/line/src/flex-templates/types.ts
@@ -1,3 +1,4 @@
+// Line type declarations define plugin contracts.
 import type { messagingApi } from "@line/bot-sdk";
 
 export type FlexContainer = messagingApi.FlexContainer;
diff --git a/extensions/line/src/gateway.ts b/extensions/line/src/gateway.ts
index 91b6e1c1fd75..956604b27b65 100644
--- a/extensions/line/src/gateway.ts
+++ b/extensions/line/src/gateway.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements gateway behavior.
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { resolveLineAccount } from "./accounts.js";
 import {
diff --git a/extensions/line/src/group-keys.test.ts b/extensions/line/src/group-keys.test.ts
index c079bc77455a..8bb9eb359e4c 100644
--- a/extensions/line/src/group-keys.test.ts
+++ b/extensions/line/src/group-keys.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover group keys plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveExactLineGroupConfigKey,
diff --git a/extensions/line/src/group-keys.ts b/extensions/line/src/group-keys.ts
index 46aeb7fec920..5ef352879dc1 100644
--- a/extensions/line/src/group-keys.ts
+++ b/extensions/line/src/group-keys.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements group keys behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/account-resolution";
 import { resolveAccountEntry } from "openclaw/plugin-sdk/account-resolution";
diff --git a/extensions/line/src/group-policy.ts b/extensions/line/src/group-policy.ts
index 80855a5bf947..cad5aa48afe1 100644
--- a/extensions/line/src/group-policy.ts
+++ b/extensions/line/src/group-policy.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements group policy behavior.
 import { resolveChannelGroupRequireMention } from "openclaw/plugin-sdk/channel-policy";
 import { resolveExactLineGroupConfigKey, type OpenClawConfig } from "./channel-api.js";
 
diff --git a/extensions/line/src/markdown-to-line.test.ts b/extensions/line/src/markdown-to-line.test.ts
index 181bf48f0df1..635432f5c539 100644
--- a/extensions/line/src/markdown-to-line.test.ts
+++ b/extensions/line/src/markdown-to-line.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover markdown to line plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   extractMarkdownTables,
diff --git a/extensions/line/src/markdown-to-line.ts b/extensions/line/src/markdown-to-line.ts
index 61aa639ca6ad..7f43e1f17fe2 100644
--- a/extensions/line/src/markdown-to-line.ts
+++ b/extensions/line/src/markdown-to-line.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements markdown to line behavior.
 import type { messagingApi } from "@line/bot-sdk";
 import { stripMarkdown } from "openclaw/plugin-sdk/text-chunking";
 import { createReceiptCard, toFlexMessage, type FlexBubble } from "./flex-templates.js";
diff --git a/extensions/line/src/message-cards.test.ts b/extensions/line/src/message-cards.test.ts
index 23a150e4e089..db9b216e2d1a 100644
--- a/extensions/line/src/message-cards.test.ts
+++ b/extensions/line/src/message-cards.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover message cards plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   createActionCard,
diff --git a/extensions/line/src/monitor-durable.test.ts b/extensions/line/src/monitor-durable.test.ts
index ecb411b3d8b7..866ff62a7bda 100644
--- a/extensions/line/src/monitor-durable.test.ts
+++ b/extensions/line/src/monitor-durable.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover monitor durable plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveLineDurableReplyOptions } from "./monitor-durable.js";
 
diff --git a/extensions/line/src/monitor-durable.ts b/extensions/line/src/monitor-durable.ts
index 420364600646..dc124ce7e6c0 100644
--- a/extensions/line/src/monitor-durable.ts
+++ b/extensions/line/src/monitor-durable.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements monitor durable behavior.
 import { resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import type { LineChannelData } from "./types.js";
diff --git a/extensions/line/src/monitor.lifecycle.test.ts b/extensions/line/src/monitor.lifecycle.test.ts
index f30469acb17d..0030caed23c5 100644
--- a/extensions/line/src/monitor.lifecycle.test.ts
+++ b/extensions/line/src/monitor.lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover monitor.lifecycle plugin behavior.
 import crypto from "node:crypto";
 import { EventEmitter } from "node:events";
 import type { IncomingMessage, ServerResponse } from "node:http";
diff --git a/extensions/line/src/monitor.runtime.ts b/extensions/line/src/monitor.runtime.ts
index 4f04a8314b13..e87de171c2ec 100644
--- a/extensions/line/src/monitor.runtime.ts
+++ b/extensions/line/src/monitor.runtime.ts
@@ -1 +1,2 @@
+// Line plugin module implements monitor behavior.
 export { monitorLineProvider } from "./monitor.js";
diff --git a/extensions/line/src/monitor.ts b/extensions/line/src/monitor.ts
index e585c3d22b0d..536c4192bb4f 100644
--- a/extensions/line/src/monitor.ts
+++ b/extensions/line/src/monitor.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements monitor behavior.
 import type { webhook } from "@line/bot-sdk";
 import { hasFinalInboundReplyDispatch } from "openclaw/plugin-sdk/channel-inbound";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/line/src/outbound-media.test.ts b/extensions/line/src/outbound-media.test.ts
index f79c62c08be0..d7d170fe3053 100644
--- a/extensions/line/src/outbound-media.test.ts
+++ b/extensions/line/src/outbound-media.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover outbound media plugin behavior.
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const ssrfMocks = vi.hoisted(() => ({
diff --git a/extensions/line/src/outbound-media.ts b/extensions/line/src/outbound-media.ts
index 0a158a29330a..0bf5323b72c4 100644
--- a/extensions/line/src/outbound-media.ts
+++ b/extensions/line/src/outbound-media.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements outbound media behavior.
 import { resolvePinnedHostnameWithPolicy, type SsrFPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/line/src/outbound.runtime.ts b/extensions/line/src/outbound.runtime.ts
index 8ec0b639929b..e9ea9d5b2a96 100644
--- a/extensions/line/src/outbound.runtime.ts
+++ b/extensions/line/src/outbound.runtime.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements outbound behavior.
 export { processLineMessage } from "./markdown-to-line.js";
 export {
   createQuickReplyItems,
diff --git a/extensions/line/src/outbound.ts b/extensions/line/src/outbound.ts
index f686e2021fe4..1bf7d69ee25a 100644
--- a/extensions/line/src/outbound.ts
+++ b/extensions/line/src/outbound.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements outbound behavior.
 import {
   defineChannelMessageAdapter,
   type ChannelMessageSendResult,
diff --git a/extensions/line/src/probe.contract.test.ts b/extensions/line/src/probe.contract.test.ts
index d78a137ff43d..a8f1ed5eb259 100644
--- a/extensions/line/src/probe.contract.test.ts
+++ b/extensions/line/src/probe.contract.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover probe.contract plugin behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import { describe, expectTypeOf, it } from "vitest";
 import type { LineProbeResult } from "./types.js";
diff --git a/extensions/line/src/probe.runtime.ts b/extensions/line/src/probe.runtime.ts
index 5512ee4feec4..4c2262f9ce58 100644
--- a/extensions/line/src/probe.runtime.ts
+++ b/extensions/line/src/probe.runtime.ts
@@ -1 +1,2 @@
+// Line plugin module implements probe behavior.
 export { probeLineBot } from "./probe.js";
diff --git a/extensions/line/src/probe.ts b/extensions/line/src/probe.ts
index 70d0e878c102..ddfc5550ec5a 100644
--- a/extensions/line/src/probe.ts
+++ b/extensions/line/src/probe.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements probe behavior.
 import { messagingApi } from "@line/bot-sdk";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { withTimeout } from "openclaw/plugin-sdk/text-utility-runtime";
diff --git a/extensions/line/src/quick-reply-fallback.ts b/extensions/line/src/quick-reply-fallback.ts
index 4c418ed3859e..370aab90e239 100644
--- a/extensions/line/src/quick-reply-fallback.ts
+++ b/extensions/line/src/quick-reply-fallback.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements quick reply fallback behavior.
 import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 export function buildLineQuickReplyFallbackText(labels: readonly string[] | undefined): string {
diff --git a/extensions/line/src/reply-chunks.test.ts b/extensions/line/src/reply-chunks.test.ts
index 2be3f2073eb9..4ad7e0be2b84 100644
--- a/extensions/line/src/reply-chunks.test.ts
+++ b/extensions/line/src/reply-chunks.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover reply chunks plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { sendLineReplyChunks } from "./reply-chunks.js";
 
diff --git a/extensions/line/src/reply-chunks.ts b/extensions/line/src/reply-chunks.ts
index 4f237462a9d8..3648909bfebb 100644
--- a/extensions/line/src/reply-chunks.ts
+++ b/extensions/line/src/reply-chunks.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements reply chunks behavior.
 import type { messagingApi } from "@line/bot-sdk";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 
diff --git a/extensions/line/src/reply-payload-transform.test.ts b/extensions/line/src/reply-payload-transform.test.ts
index cea461a88fe9..244657a0999d 100644
--- a/extensions/line/src/reply-payload-transform.test.ts
+++ b/extensions/line/src/reply-payload-transform.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover reply payload transform plugin behavior.
 import { describe, expect, it } from "vitest";
 import { hasLineDirectives, parseLineDirectives } from "./reply-payload-transform.js";
 
diff --git a/extensions/line/src/reply-payload-transform.ts b/extensions/line/src/reply-payload-transform.ts
index 0b1a05fcbd6b..6895582fdf2d 100644
--- a/extensions/line/src/reply-payload-transform.ts
+++ b/extensions/line/src/reply-payload-transform.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements reply payload transform behavior.
 import { parseStrictFiniteNumber } from "openclaw/plugin-sdk/number-runtime";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import {
diff --git a/extensions/line/src/rich-menu.test.ts b/extensions/line/src/rich-menu.test.ts
index 2f18889f2dc6..344e2c5bb628 100644
--- a/extensions/line/src/rich-menu.test.ts
+++ b/extensions/line/src/rich-menu.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover rich menu plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/line/src/rich-menu.ts b/extensions/line/src/rich-menu.ts
index b02625c2d576..810ef80ceba7 100644
--- a/extensions/line/src/rich-menu.ts
+++ b/extensions/line/src/rich-menu.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements rich menu behavior.
 import { messagingApi } from "@line/bot-sdk";
 import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/agent-media-payload";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/line/src/runtime.ts b/extensions/line/src/runtime.ts
index 9ab7e119c901..48cfaacda137 100644
--- a/extensions/line/src/runtime.ts
+++ b/extensions/line/src/runtime.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/line/src/send-receipt.ts b/extensions/line/src/send-receipt.ts
index cf3408137cfe..923c02782b97 100644
--- a/extensions/line/src/send-receipt.ts
+++ b/extensions/line/src/send-receipt.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements send receipt behavior.
 import {
   createMessageReceiptFromOutboundResults,
   type MessageReceipt,
diff --git a/extensions/line/src/send.test.ts b/extensions/line/src/send.test.ts
index 230c902560da..7f5302814d75 100644
--- a/extensions/line/src/send.test.ts
+++ b/extensions/line/src/send.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover send plugin behavior.
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const {
diff --git a/extensions/line/src/send.ts b/extensions/line/src/send.ts
index 2342b79ea8f0..109031ae32a4 100644
--- a/extensions/line/src/send.ts
+++ b/extensions/line/src/send.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements send behavior.
 import { messagingApi } from "@line/bot-sdk";
 import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/line/src/setup-core.ts b/extensions/line/src/setup-core.ts
index 84fb1dc5a078..77514892e2f2 100644
--- a/extensions/line/src/setup-core.ts
+++ b/extensions/line/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements setup core behavior.
 import type { ChannelSetupAdapter, OpenClawConfig } from "openclaw/plugin-sdk/setup";
 import { createSetupInputPresenceValidator } from "openclaw/plugin-sdk/setup";
 import { hasLineCredentials, parseLineAllowFromId } from "./account-helpers.js";
diff --git a/extensions/line/src/setup-runtime-api.ts b/extensions/line/src/setup-runtime-api.ts
index 1ee56411c9e6..63d7a6a27a38 100644
--- a/extensions/line/src/setup-runtime-api.ts
+++ b/extensions/line/src/setup-runtime-api.ts
@@ -1,3 +1,4 @@
+// Line API module exposes the plugin public contract.
 export {
   DEFAULT_ACCOUNT_ID,
   formatDocsLink,
diff --git a/extensions/line/src/setup-surface.test.ts b/extensions/line/src/setup-surface.test.ts
index edd0e083803d..d5593a460247 100644
--- a/extensions/line/src/setup-surface.test.ts
+++ b/extensions/line/src/setup-surface.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover setup surface plugin behavior.
 import { readFileSync } from "node:fs";
 import path from "node:path";
 import { createStartAccountContext } from "openclaw/plugin-sdk/channel-test-helpers";
diff --git a/extensions/line/src/setup-surface.ts b/extensions/line/src/setup-surface.ts
index 1d0305b44d27..ea8dc2c42a22 100644
--- a/extensions/line/src/setup-surface.ts
+++ b/extensions/line/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements setup surface behavior.
 import {
   createAllowFromSection,
   createStandardChannelSetupStatus,
diff --git a/extensions/line/src/signature.test.ts b/extensions/line/src/signature.test.ts
index 7fefeaae9f12..f6a8348bd303 100644
--- a/extensions/line/src/signature.test.ts
+++ b/extensions/line/src/signature.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover signature plugin behavior.
 import crypto from "node:crypto";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { validateLineSignature } from "./signature.js";
diff --git a/extensions/line/src/signature.ts b/extensions/line/src/signature.ts
index 9a73cd56feed..13b74ce1622e 100644
--- a/extensions/line/src/signature.ts
+++ b/extensions/line/src/signature.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements signature behavior.
 import crypto from "node:crypto";
 
 export function validateLineSignature(
diff --git a/extensions/line/src/status.ts b/extensions/line/src/status.ts
index af6f42e69982..1d79f5665069 100644
--- a/extensions/line/src/status.ts
+++ b/extensions/line/src/status.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements status behavior.
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import {
   buildTokenChannelStatusSummary,
diff --git a/extensions/line/src/template-messages.ts b/extensions/line/src/template-messages.ts
index e26b3ddf6b87..357bf3bed281 100644
--- a/extensions/line/src/template-messages.ts
+++ b/extensions/line/src/template-messages.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements template messages behavior.
 import type { messagingApi } from "@line/bot-sdk";
 import { messageAction, postbackAction, uriAction, type Action } from "./actions.js";
 import type { LineTemplateMessagePayload } from "./types.js";
diff --git a/extensions/line/src/types.ts b/extensions/line/src/types.ts
index c3b12cd67046..04d0e01b11ab 100644
--- a/extensions/line/src/types.ts
+++ b/extensions/line/src/types.ts
@@ -1,3 +1,4 @@
+// Line type declarations define plugin contracts.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import type { MessageReceipt } from "openclaw/plugin-sdk/channel-outbound";
 
diff --git a/extensions/line/src/webhook-node.test.ts b/extensions/line/src/webhook-node.test.ts
index 13c1698f0f26..2935f54d4449 100644
--- a/extensions/line/src/webhook-node.test.ts
+++ b/extensions/line/src/webhook-node.test.ts
@@ -1,3 +1,4 @@
+// Line tests cover webhook node plugin behavior.
 import crypto from "node:crypto";
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/line/src/webhook-node.ts b/extensions/line/src/webhook-node.ts
index 151a2cc5e2a5..366734f3e2c5 100644
--- a/extensions/line/src/webhook-node.ts
+++ b/extensions/line/src/webhook-node.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements webhook node behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { webhook } from "@line/bot-sdk";
 import {
diff --git a/extensions/line/src/webhook-utils.ts b/extensions/line/src/webhook-utils.ts
index ee58b2db74dd..255b244a2d49 100644
--- a/extensions/line/src/webhook-utils.ts
+++ b/extensions/line/src/webhook-utils.ts
@@ -1,3 +1,4 @@
+// Line helper module supports webhook utils behavior.
 import type { webhook } from "@line/bot-sdk";
 export { validateLineSignature } from "./signature.js";
 
diff --git a/extensions/line/src/webhook.ts b/extensions/line/src/webhook.ts
index 75748137111f..eeacc50c397e 100644
--- a/extensions/line/src/webhook.ts
+++ b/extensions/line/src/webhook.ts
@@ -1,3 +1,4 @@
+// Line plugin module implements webhook behavior.
 import type { webhook } from "@line/bot-sdk";
 import type { NextFunction, Request, Response } from "express";
 import {
diff --git a/extensions/mattermost/contract-api.ts b/extensions/mattermost/contract-api.ts
index 274710269c39..3f80beb08aa5 100644
--- a/extensions/mattermost/contract-api.ts
+++ b/extensions/mattermost/contract-api.ts
@@ -1,3 +1,4 @@
+// Mattermost API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
 export {
   collectRuntimeConfigAssignments,
diff --git a/extensions/mattermost/doctor-contract-api.ts b/extensions/mattermost/doctor-contract-api.ts
index a7a56f234421..98de85e52331 100644
--- a/extensions/mattermost/doctor-contract-api.ts
+++ b/extensions/mattermost/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Mattermost API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
diff --git a/extensions/mattermost/gateway-auth-api.ts b/extensions/mattermost/gateway-auth-api.ts
index 870a923528a6..348cfd847328 100644
--- a/extensions/mattermost/gateway-auth-api.ts
+++ b/extensions/mattermost/gateway-auth-api.ts
@@ -1 +1,2 @@
+// Mattermost API module exposes the plugin public contract.
 export { resolveMattermostGatewayAuthBypassPaths as resolveGatewayAuthBypassPaths } from "./src/gateway-auth-bypass.js";
diff --git a/extensions/mattermost/index.ts b/extensions/mattermost/index.ts
index 63c6a11c2b37..407d633d7b8a 100644
--- a/extensions/mattermost/index.ts
+++ b/extensions/mattermost/index.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin entrypoint registers its OpenClaw integration.
 import {
   defineBundledChannelEntry,
   loadBundledEntryExportSync,
diff --git a/extensions/mattermost/policy-api.ts b/extensions/mattermost/policy-api.ts
index 5d53d67fc5fc..9bcb79a5c665 100644
--- a/extensions/mattermost/policy-api.ts
+++ b/extensions/mattermost/policy-api.ts
@@ -1 +1,2 @@
+// Mattermost API module exposes the plugin public contract.
 export { isMattermostSenderAllowed } from "./src/mattermost/monitor-auth.js";
diff --git a/extensions/mattermost/secret-contract-api.ts b/extensions/mattermost/secret-contract-api.ts
index 9f44ef28569c..540a2127b1ac 100644
--- a/extensions/mattermost/secret-contract-api.ts
+++ b/extensions/mattermost/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Mattermost API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/mattermost/setup-entry.ts b/extensions/mattermost/setup-entry.ts
index 57d905c653f2..917b30f55f3a 100644
--- a/extensions/mattermost/setup-entry.ts
+++ b/extensions/mattermost/setup-entry.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/mattermost/slash-route-api.ts b/extensions/mattermost/slash-route-api.ts
index 1eb801d16caa..495bdddb7cd0 100644
--- a/extensions/mattermost/slash-route-api.ts
+++ b/extensions/mattermost/slash-route-api.ts
@@ -1 +1,2 @@
+// Mattermost API module exposes the plugin public contract.
 export { registerSlashCommandRoute } from "./src/mattermost/slash-state.js";
diff --git a/extensions/mattermost/src/approval-auth.test.ts b/extensions/mattermost/src/approval-auth.test.ts
index ec3ba05ee325..35e165cb523b 100644
--- a/extensions/mattermost/src/approval-auth.test.ts
+++ b/extensions/mattermost/src/approval-auth.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { mattermostApprovalAuth } from "./approval-auth.js";
 
diff --git a/extensions/mattermost/src/approval-auth.ts b/extensions/mattermost/src/approval-auth.ts
index 158d8da7b33d..f88f31de0daf 100644
--- a/extensions/mattermost/src/approval-auth.ts
+++ b/extensions/mattermost/src/approval-auth.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,
diff --git a/extensions/mattermost/src/channel-actions-setup-status.contract.test.ts b/extensions/mattermost/src/channel-actions-setup-status.contract.test.ts
index 86f3c1ada543..66b09757cf31 100644
--- a/extensions/mattermost/src/channel-actions-setup-status.contract.test.ts
+++ b/extensions/mattermost/src/channel-actions-setup-status.contract.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover channel actions setup status.contract plugin behavior.
 import {
   installChannelActionsContractSuite,
   installChannelSetupContractSuite,
diff --git a/extensions/mattermost/src/channel-api.ts b/extensions/mattermost/src/channel-api.ts
index b537ff322d02..4f69339c8fd1 100644
--- a/extensions/mattermost/src/channel-api.ts
+++ b/extensions/mattermost/src/channel-api.ts
@@ -1,3 +1,4 @@
+// Mattermost API module exposes the plugin public contract.
 export { createAccountStatusSink } from "openclaw/plugin-sdk/channel-outbound";
 export type { ChannelPlugin } from "openclaw/plugin-sdk/core";
 export { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/core";
diff --git a/extensions/mattermost/src/channel-config-shared.ts b/extensions/mattermost/src/channel-config-shared.ts
index 11ec974ad954..66c4c9ddf70d 100644
--- a/extensions/mattermost/src/channel-config-shared.ts
+++ b/extensions/mattermost/src/channel-config-shared.ts
@@ -1,3 +1,4 @@
+// Mattermost helper module supports channel config shared behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { formatNormalizedAllowFromEntries } from "openclaw/plugin-sdk/allow-from";
 import {
diff --git a/extensions/mattermost/src/channel.message-adapter.test.ts b/extensions/mattermost/src/channel.message-adapter.test.ts
index c709ee271b30..33c7de2d5072 100644
--- a/extensions/mattermost/src/channel.message-adapter.test.ts
+++ b/extensions/mattermost/src/channel.message-adapter.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover channel.message adapter plugin behavior.
 import {
   verifyChannelMessageAdapterCapabilityProofs,
   verifyChannelMessageLiveCapabilityAdapterProofs,
diff --git a/extensions/mattermost/src/channel.runtime.ts b/extensions/mattermost/src/channel.runtime.ts
index 766657330800..a52789110638 100644
--- a/extensions/mattermost/src/channel.runtime.ts
+++ b/extensions/mattermost/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements channel behavior.
 export {
   listMattermostDirectoryGroups,
   listMattermostDirectoryPeers,
diff --git a/extensions/mattermost/src/channel.setup.ts b/extensions/mattermost/src/channel.setup.ts
index e299b758b876..299bbf0b02d3 100644
--- a/extensions/mattermost/src/channel.setup.ts
+++ b/extensions/mattermost/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements channel.setup behavior.
 import type { ChannelPlugin } from "./channel-api.js";
 import {
   describeMattermostAccount,
diff --git a/extensions/mattermost/src/channel.test.ts b/extensions/mattermost/src/channel.test.ts
index baa3f7098227..a00caec86f55 100644
--- a/extensions/mattermost/src/channel.test.ts
+++ b/extensions/mattermost/src/channel.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover channel plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
 import { createChannelMessageReplyPipeline } from "../runtime-api.js";
diff --git a/extensions/mattermost/src/channel.ts b/extensions/mattermost/src/channel.ts
index e03527389b36..33563a5e73d3 100644
--- a/extensions/mattermost/src/channel.ts
+++ b/extensions/mattermost/src/channel.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements channel behavior.
 import type {
   ChannelMessageActionAdapter,
   ChannelMessageActionName,
diff --git a/extensions/mattermost/src/config-schema-core.ts b/extensions/mattermost/src/config-schema-core.ts
index 309fb9b45494..996498f5a9a8 100644
--- a/extensions/mattermost/src/config-schema-core.ts
+++ b/extensions/mattermost/src/config-schema-core.ts
@@ -1,3 +1,4 @@
+// Mattermost helper module supports config schema core behavior.
 import {
   BlockStreamingCoalesceSchema,
   DmPolicySchema,
diff --git a/extensions/mattermost/src/config-schema.test.ts b/extensions/mattermost/src/config-schema.test.ts
index a2f9c1aba55c..fc4f4a648c36 100644
--- a/extensions/mattermost/src/config-schema.test.ts
+++ b/extensions/mattermost/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MattermostConfigSchema } from "./config-schema-core.js";
 
diff --git a/extensions/mattermost/src/config-surface.ts b/extensions/mattermost/src/config-surface.ts
index 21d18e1a480b..808ada063f7b 100644
--- a/extensions/mattermost/src/config-surface.ts
+++ b/extensions/mattermost/src/config-surface.ts
@@ -1,3 +1,4 @@
+// Mattermost helper module supports config surface behavior.
 import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-primitives";
 import { MattermostConfigSchema } from "./config-schema-core.js";
 import { mattermostChannelConfigUiHints } from "./config-ui-hints.js";
diff --git a/extensions/mattermost/src/config-ui-hints.ts b/extensions/mattermost/src/config-ui-hints.ts
index 517e0732c16c..05132da7ce2d 100644
--- a/extensions/mattermost/src/config-ui-hints.ts
+++ b/extensions/mattermost/src/config-ui-hints.ts
@@ -1,3 +1,4 @@
+// Mattermost helper module supports config ui hints behavior.
 import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/channel-core";
 
 export const mattermostChannelConfigUiHints = {
diff --git a/extensions/mattermost/src/doctor-contract.ts b/extensions/mattermost/src/doctor-contract.ts
index 8f3893168873..f9c0f8e515c1 100644
--- a/extensions/mattermost/src/doctor-contract.ts
+++ b/extensions/mattermost/src/doctor-contract.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements doctor contract behavior.
 import { createLegacyPrivateNetworkDoctorContract } from "openclaw/plugin-sdk/ssrf-runtime";
 
 const contract = createLegacyPrivateNetworkDoctorContract({
diff --git a/extensions/mattermost/src/doctor.test.ts b/extensions/mattermost/src/doctor.test.ts
index cc16ff3b2f74..195814f7656d 100644
--- a/extensions/mattermost/src/doctor.test.ts
+++ b/extensions/mattermost/src/doctor.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover doctor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { mattermostDoctor } from "./doctor.js";
 
diff --git a/extensions/mattermost/src/doctor.ts b/extensions/mattermost/src/doctor.ts
index f043b8e608f9..fa32d1ad9e84 100644
--- a/extensions/mattermost/src/doctor.ts
+++ b/extensions/mattermost/src/doctor.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements doctor behavior.
 import type { ChannelDoctorAdapter } from "openclaw/plugin-sdk/channel-contract";
 import { createDangerousNameMatchingMutableAllowlistWarningCollector } from "openclaw/plugin-sdk/channel-policy";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/mattermost/src/gateway-auth-bypass.test.ts b/extensions/mattermost/src/gateway-auth-bypass.test.ts
index a1b31a4761b4..76df881e0239 100644
--- a/extensions/mattermost/src/gateway-auth-bypass.test.ts
+++ b/extensions/mattermost/src/gateway-auth-bypass.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover gateway auth bypass plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   collectMattermostSlashCallbackPaths,
diff --git a/extensions/mattermost/src/gateway-auth-bypass.ts b/extensions/mattermost/src/gateway-auth-bypass.ts
index 9dda0ba0b486..abc7a0d5adaf 100644
--- a/extensions/mattermost/src/gateway-auth-bypass.ts
+++ b/extensions/mattermost/src/gateway-auth-bypass.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements gateway auth bypass behavior.
 const DEFAULT_SLASH_CALLBACK_PATH = "/api/channels/mattermost/command";
 
 type MattermostSlashCommandConfigInput = {
diff --git a/extensions/mattermost/src/group-mentions.test.ts b/extensions/mattermost/src/group-mentions.test.ts
index 8a4d14927998..3df17ca4fc01 100644
--- a/extensions/mattermost/src/group-mentions.test.ts
+++ b/extensions/mattermost/src/group-mentions.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover group mentions plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
 import { resolveMattermostGroupRequireMention } from "./group-mentions.js";
diff --git a/extensions/mattermost/src/group-mentions.ts b/extensions/mattermost/src/group-mentions.ts
index 4d8d484d89c6..0d8a19784b14 100644
--- a/extensions/mattermost/src/group-mentions.ts
+++ b/extensions/mattermost/src/group-mentions.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements group mentions behavior.
 import { resolveChannelGroupRequireMention } from "openclaw/plugin-sdk/channel-policy";
 import { resolveMattermostAccount } from "./mattermost/accounts.js";
 import type { ChannelGroupContext } from "./runtime-api.js";
diff --git a/extensions/mattermost/src/mattermost/accounts.test.ts b/extensions/mattermost/src/mattermost/accounts.test.ts
index 88f071bb7631..423c9dc8fde4 100644
--- a/extensions/mattermost/src/mattermost/accounts.test.ts
+++ b/extensions/mattermost/src/mattermost/accounts.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover accounts plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../runtime-api.js";
 import {
diff --git a/extensions/mattermost/src/mattermost/accounts.ts b/extensions/mattermost/src/mattermost/accounts.ts
index 74131bdffb74..c932cae86ef4 100644
--- a/extensions/mattermost/src/mattermost/accounts.ts
+++ b/extensions/mattermost/src/mattermost/accounts.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements accounts behavior.
 import {
   createAccountListHelpers,
   hasConfiguredAccountValue,
diff --git a/extensions/mattermost/src/mattermost/client.retry.test.ts b/extensions/mattermost/src/mattermost/client.retry.test.ts
index 7ea3a5995b11..6a21ec3dddb4 100644
--- a/extensions/mattermost/src/mattermost/client.retry.test.ts
+++ b/extensions/mattermost/src/mattermost/client.retry.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover client.retry plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { createMattermostClient, createMattermostDirectChannelWithRetry } from "./client.js";
diff --git a/extensions/mattermost/src/mattermost/client.test.ts b/extensions/mattermost/src/mattermost/client.test.ts
index 22a250b9efeb..72b59448a8f5 100644
--- a/extensions/mattermost/src/mattermost/client.test.ts
+++ b/extensions/mattermost/src/mattermost/client.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover client plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   createMattermostClient,
diff --git a/extensions/mattermost/src/mattermost/client.ts b/extensions/mattermost/src/mattermost/client.ts
index 72a69a5bd491..50d60d666404 100644
--- a/extensions/mattermost/src/mattermost/client.ts
+++ b/extensions/mattermost/src/mattermost/client.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements client behavior.
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import { sleep } from "openclaw/plugin-sdk/runtime-env";
 import {
diff --git a/extensions/mattermost/src/mattermost/directory.test.ts b/extensions/mattermost/src/mattermost/directory.test.ts
index 75d74f1ab966..bf9d2b3b6b3a 100644
--- a/extensions/mattermost/src/mattermost/directory.test.ts
+++ b/extensions/mattermost/src/mattermost/directory.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover directory plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const {
diff --git a/extensions/mattermost/src/mattermost/directory.ts b/extensions/mattermost/src/mattermost/directory.ts
index d0112bfda294..6b4891bb78b1 100644
--- a/extensions/mattermost/src/mattermost/directory.ts
+++ b/extensions/mattermost/src/mattermost/directory.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements directory behavior.
 import { isPrivateNetworkOptInEnabled } from "openclaw/plugin-sdk/ssrf-runtime";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { listMattermostAccountIds, resolveMattermostAccount } from "./accounts.js";
diff --git a/extensions/mattermost/src/mattermost/draft-stream.test.ts b/extensions/mattermost/src/mattermost/draft-stream.test.ts
index c07219508df4..9df1d1b318c1 100644
--- a/extensions/mattermost/src/mattermost/draft-stream.test.ts
+++ b/extensions/mattermost/src/mattermost/draft-stream.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover draft stream plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { MattermostClient } from "./client.js";
 import { buildMattermostToolStatusText, createMattermostDraftStream } from "./draft-stream.js";
diff --git a/extensions/mattermost/src/mattermost/draft-stream.ts b/extensions/mattermost/src/mattermost/draft-stream.ts
index 65d582766943..67ec36ceed83 100644
--- a/extensions/mattermost/src/mattermost/draft-stream.ts
+++ b/extensions/mattermost/src/mattermost/draft-stream.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements draft stream behavior.
 import { createFinalizableDraftLifecycle } from "openclaw/plugin-sdk/channel-outbound";
 import { formatChannelProgressDraftLineForEntry } from "openclaw/plugin-sdk/channel-outbound";
 import {
diff --git a/extensions/mattermost/src/mattermost/interactions.test.ts b/extensions/mattermost/src/mattermost/interactions.test.ts
index b4b87424e0ca..e3a2cba00839 100644
--- a/extensions/mattermost/src/mattermost/interactions.test.ts
+++ b/extensions/mattermost/src/mattermost/interactions.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover interactions plugin behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { describe, expect, it, beforeEach, afterEach, vi } from "vitest";
 import type { PluginRuntime } from "../../runtime-api.js";
diff --git a/extensions/mattermost/src/mattermost/interactions.ts b/extensions/mattermost/src/mattermost/interactions.ts
index 2f7ebc13191e..2052268786a0 100644
--- a/extensions/mattermost/src/mattermost/interactions.ts
+++ b/extensions/mattermost/src/mattermost/interactions.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements interactions behavior.
 import { createHmac } from "node:crypto";
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { safeEqualSecret } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/mattermost/src/mattermost/model-picker.test.ts b/extensions/mattermost/src/mattermost/model-picker.test.ts
index a39391deeebf..6f50e97faee8 100644
--- a/extensions/mattermost/src/mattermost/model-picker.test.ts
+++ b/extensions/mattermost/src/mattermost/model-picker.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover model picker plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/mattermost/src/mattermost/model-picker.ts b/extensions/mattermost/src/mattermost/model-picker.ts
index ae87f5dab150..f678559f8ab2 100644
--- a/extensions/mattermost/src/mattermost/model-picker.ts
+++ b/extensions/mattermost/src/mattermost/model-picker.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements model picker behavior.
 import { createHash } from "node:crypto";
 import {
   resolveStoredModelOverride,
diff --git a/extensions/mattermost/src/mattermost/monitor-auth.test.ts b/extensions/mattermost/src/mattermost/monitor-auth.test.ts
index bba6ebb452ab..3f685ffc936a 100644
--- a/extensions/mattermost/src/mattermost/monitor-auth.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor-auth.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor auth plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const isDangerousNameMatchingEnabled = vi.hoisted(() => vi.fn());
diff --git a/extensions/mattermost/src/mattermost/monitor-auth.ts b/extensions/mattermost/src/mattermost/monitor-auth.ts
index 71d058deec6e..f642b91190ce 100644
--- a/extensions/mattermost/src/mattermost/monitor-auth.ts
+++ b/extensions/mattermost/src/mattermost/monitor-auth.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements monitor auth behavior.
 import { parseAccessGroupAllowFromEntry } from "openclaw/plugin-sdk/access-groups";
 import {
   type ChannelIngressDecision,
diff --git a/extensions/mattermost/src/mattermost/monitor-gating.test.ts b/extensions/mattermost/src/mattermost/monitor-gating.test.ts
index 412fdb51cf76..01f59d259488 100644
--- a/extensions/mattermost/src/mattermost/monitor-gating.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor-gating.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor gating plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   evaluateMattermostMentionGate,
diff --git a/extensions/mattermost/src/mattermost/monitor-gating.ts b/extensions/mattermost/src/mattermost/monitor-gating.ts
index 42b5efd76685..1ece39e84b53 100644
--- a/extensions/mattermost/src/mattermost/monitor-gating.ts
+++ b/extensions/mattermost/src/mattermost/monitor-gating.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements monitor gating behavior.
 import type { ChatType, OpenClawConfig } from "./runtime-api.js";
 
 export function mapMattermostChannelTypeToChatType(channelType?: string | null): ChatType {
diff --git a/extensions/mattermost/src/mattermost/monitor-helpers.test.ts b/extensions/mattermost/src/mattermost/monitor-helpers.test.ts
index 191d0a6c2380..e064d78aa3aa 100644
--- a/extensions/mattermost/src/mattermost/monitor-helpers.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor-helpers.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor helpers plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeMention } from "./monitor-helpers.js";
 
diff --git a/extensions/mattermost/src/mattermost/monitor-helpers.ts b/extensions/mattermost/src/mattermost/monitor-helpers.ts
index 92cc750ec7a1..443973c22fd9 100644
--- a/extensions/mattermost/src/mattermost/monitor-helpers.ts
+++ b/extensions/mattermost/src/mattermost/monitor-helpers.ts
@@ -1,3 +1,4 @@
+// Mattermost helper module supports monitor helpers behavior.
 import { formatInboundFromLabel as formatInboundFromLabelShared } from "openclaw/plugin-sdk/channel-inbound";
 import { resolveThreadSessionKeys as resolveThreadSessionKeysShared } from "openclaw/plugin-sdk/routing";
 import { rawDataToString } from "openclaw/plugin-sdk/webhook-ingress";
diff --git a/extensions/mattermost/src/mattermost/monitor-onchar.test.ts b/extensions/mattermost/src/mattermost/monitor-onchar.test.ts
index 2520cbd24cd6..97fe5418f989 100644
--- a/extensions/mattermost/src/mattermost/monitor-onchar.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor-onchar.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor onchar plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveOncharPrefixes, stripOncharPrefix } from "./monitor-onchar.js";
 
diff --git a/extensions/mattermost/src/mattermost/monitor-onchar.ts b/extensions/mattermost/src/mattermost/monitor-onchar.ts
index 22e2469fa387..e4cb4af1d968 100644
--- a/extensions/mattermost/src/mattermost/monitor-onchar.ts
+++ b/extensions/mattermost/src/mattermost/monitor-onchar.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements monitor onchar behavior.
 import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 const DEFAULT_ONCHAR_PREFIXES = [">", "!"];
diff --git a/extensions/mattermost/src/mattermost/monitor-resources.test.ts b/extensions/mattermost/src/mattermost/monitor-resources.test.ts
index 6bc269fae938..51d3ab4db539 100644
--- a/extensions/mattermost/src/mattermost/monitor-resources.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor-resources.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor resources plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const fetchMattermostChannel = vi.hoisted(() => vi.fn());
diff --git a/extensions/mattermost/src/mattermost/monitor-resources.ts b/extensions/mattermost/src/mattermost/monitor-resources.ts
index df71fcdcbc56..a65979512bb2 100644
--- a/extensions/mattermost/src/mattermost/monitor-resources.ts
+++ b/extensions/mattermost/src/mattermost/monitor-resources.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements monitor resources behavior.
 import {
   asDateTimestampMs,
   resolveExpiresAtMsFromDurationMs,
diff --git a/extensions/mattermost/src/mattermost/monitor-slash.test.ts b/extensions/mattermost/src/mattermost/monitor-slash.test.ts
index 78028a0ac6f0..a054290b45f1 100644
--- a/extensions/mattermost/src/mattermost/monitor-slash.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor-slash.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor slash plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const listSkillCommandsForAgents = vi.hoisted(() => vi.fn());
diff --git a/extensions/mattermost/src/mattermost/monitor-slash.ts b/extensions/mattermost/src/mattermost/monitor-slash.ts
index d70641d4aff1..ddce3ac511fe 100644
--- a/extensions/mattermost/src/mattermost/monitor-slash.ts
+++ b/extensions/mattermost/src/mattermost/monitor-slash.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements monitor slash behavior.
 import { isLoopbackHost } from "openclaw/plugin-sdk/gateway-runtime";
 import type { ResolvedMattermostAccount } from "./accounts.js";
 import {
diff --git a/extensions/mattermost/src/mattermost/monitor-websocket.test.ts b/extensions/mattermost/src/mattermost/monitor-websocket.test.ts
index 53e0558d472f..e00f6b046833 100644
--- a/extensions/mattermost/src/mattermost/monitor-websocket.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor-websocket.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor websocket plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { RuntimeEnv } from "../../runtime-api.js";
 import {
diff --git a/extensions/mattermost/src/mattermost/monitor-websocket.ts b/extensions/mattermost/src/mattermost/monitor-websocket.ts
index 88bedf4b6fa5..23107f24f596 100644
--- a/extensions/mattermost/src/mattermost/monitor-websocket.ts
+++ b/extensions/mattermost/src/mattermost/monitor-websocket.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements monitor websocket behavior.
 import { randomUUID } from "node:crypto";
 import { safeParseJsonWithSchema, safeParseWithSchema } from "openclaw/plugin-sdk/extension-shared";
 import {
diff --git a/extensions/mattermost/src/mattermost/monitor.authz.test.ts b/extensions/mattermost/src/mattermost/monitor.authz.test.ts
index 939242622f48..62261556c322 100644
--- a/extensions/mattermost/src/mattermost/monitor.authz.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor.authz.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor.authz plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { ResolvedMattermostAccount } from "./accounts.js";
 import {
diff --git a/extensions/mattermost/src/mattermost/monitor.channel-kind.test.ts b/extensions/mattermost/src/mattermost/monitor.channel-kind.test.ts
index ada85a65ae53..9416aec3efd0 100644
--- a/extensions/mattermost/src/mattermost/monitor.channel-kind.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor.channel-kind.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor.channel kind plugin behavior.
 import { describe, expect, it } from "vitest";
 import { mapMattermostChannelTypeToChatType } from "./monitor.js";
 
diff --git a/extensions/mattermost/src/mattermost/monitor.inbound-system-event.test.ts b/extensions/mattermost/src/mattermost/monitor.inbound-system-event.test.ts
index 510718cb5e0c..a2a5466fc880 100644
--- a/extensions/mattermost/src/mattermost/monitor.inbound-system-event.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor.inbound-system-event.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor.inbound system event plugin behavior.
 import { createInboundDebouncer } from "openclaw/plugin-sdk/channel-inbound-debounce";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { monitorMattermostProvider } from "./monitor.js";
diff --git a/extensions/mattermost/src/mattermost/monitor.test.ts b/extensions/mattermost/src/mattermost/monitor.test.ts
index bee23ca372f1..d1f1139dc3a1 100644
--- a/extensions/mattermost/src/mattermost/monitor.test.ts
+++ b/extensions/mattermost/src/mattermost/monitor.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover monitor plugin behavior.
 import { createClaimableDedupe } from "openclaw/plugin-sdk/persistent-dedupe";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../runtime-api.js";
diff --git a/extensions/mattermost/src/mattermost/monitor.ts b/extensions/mattermost/src/mattermost/monitor.ts
index 001da06b7391..628485c11a4e 100644
--- a/extensions/mattermost/src/mattermost/monitor.ts
+++ b/extensions/mattermost/src/mattermost/monitor.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements monitor behavior.
 import {
   defineFinalizableLivePreviewAdapter,
   deliverWithFinalizableLivePreviewAdapter,
diff --git a/extensions/mattermost/src/mattermost/no-visible-reply-diagnostic.test.ts b/extensions/mattermost/src/mattermost/no-visible-reply-diagnostic.test.ts
index 0b51b6eecf39..95407d3ffae7 100644
--- a/extensions/mattermost/src/mattermost/no-visible-reply-diagnostic.test.ts
+++ b/extensions/mattermost/src/mattermost/no-visible-reply-diagnostic.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover no visible reply diagnostic plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   evaluateMattermostNoVisibleReply,
diff --git a/extensions/mattermost/src/mattermost/no-visible-reply-diagnostic.ts b/extensions/mattermost/src/mattermost/no-visible-reply-diagnostic.ts
index 847ffac45913..f82e1341b012 100644
--- a/extensions/mattermost/src/mattermost/no-visible-reply-diagnostic.ts
+++ b/extensions/mattermost/src/mattermost/no-visible-reply-diagnostic.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements no visible reply diagnostic behavior.
 import { countOutboundMedia } from "openclaw/plugin-sdk/reply-payload";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import type { MattermostReplyDeliveryOutcome } from "./reply-delivery.js";
diff --git a/extensions/mattermost/src/mattermost/probe.test.ts b/extensions/mattermost/src/mattermost/probe.test.ts
index 74ba7cb3ea88..331d5c313fb0 100644
--- a/extensions/mattermost/src/mattermost/probe.test.ts
+++ b/extensions/mattermost/src/mattermost/probe.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover probe plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { probeMattermost } from "./probe.js";
diff --git a/extensions/mattermost/src/mattermost/probe.ts b/extensions/mattermost/src/mattermost/probe.ts
index 72763e55fd40..2434d8d48c2b 100644
--- a/extensions/mattermost/src/mattermost/probe.ts
+++ b/extensions/mattermost/src/mattermost/probe.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements probe behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import {
diff --git a/extensions/mattermost/src/mattermost/reactions.test-helpers.ts b/extensions/mattermost/src/mattermost/reactions.test-helpers.ts
index ba7b47e018d0..cf5598285311 100644
--- a/extensions/mattermost/src/mattermost/reactions.test-helpers.ts
+++ b/extensions/mattermost/src/mattermost/reactions.test-helpers.ts
@@ -1,3 +1,4 @@
+// Mattermost helper module supports reactions helpers behavior.
 import { expect, vi } from "vitest";
 import type { OpenClawConfig } from "../../runtime-api.js";
 import type { MattermostFetch } from "./client.js";
diff --git a/extensions/mattermost/src/mattermost/reactions.test.ts b/extensions/mattermost/src/mattermost/reactions.test.ts
index a206cfffdb0b..f102f1f9a04a 100644
--- a/extensions/mattermost/src/mattermost/reactions.test.ts
+++ b/extensions/mattermost/src/mattermost/reactions.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover reactions plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   addMattermostReaction,
diff --git a/extensions/mattermost/src/mattermost/reactions.ts b/extensions/mattermost/src/mattermost/reactions.ts
index 5d520f3ced35..63326c42262f 100644
--- a/extensions/mattermost/src/mattermost/reactions.ts
+++ b/extensions/mattermost/src/mattermost/reactions.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements reactions behavior.
 import {
   asDateTimestampMs,
   resolveExpiresAtMsFromDurationMs,
diff --git a/extensions/mattermost/src/mattermost/reconnect.test.ts b/extensions/mattermost/src/mattermost/reconnect.test.ts
index c65f3500fe74..d86eb49dca37 100644
--- a/extensions/mattermost/src/mattermost/reconnect.test.ts
+++ b/extensions/mattermost/src/mattermost/reconnect.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover reconnect plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { runWithReconnect } from "./reconnect.js";
 
diff --git a/extensions/mattermost/src/mattermost/reconnect.ts b/extensions/mattermost/src/mattermost/reconnect.ts
index 57f9634d8134..f6a154d89e2b 100644
--- a/extensions/mattermost/src/mattermost/reconnect.ts
+++ b/extensions/mattermost/src/mattermost/reconnect.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements reconnect behavior.
 type ReconnectOutcome = "resolved" | "rejected";
 
 type ShouldReconnectParams = {
diff --git a/extensions/mattermost/src/mattermost/reply-delivery.test.ts b/extensions/mattermost/src/mattermost/reply-delivery.test.ts
index 7a09c178f258..7a490eb76260 100644
--- a/extensions/mattermost/src/mattermost/reply-delivery.test.ts
+++ b/extensions/mattermost/src/mattermost/reply-delivery.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover reply delivery plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/mattermost/src/mattermost/reply-delivery.ts b/extensions/mattermost/src/mattermost/reply-delivery.ts
index a7c12a73e22e..1c994ac839cc 100644
--- a/extensions/mattermost/src/mattermost/reply-delivery.ts
+++ b/extensions/mattermost/src/mattermost/reply-delivery.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements reply delivery behavior.
 import type { OpenClawConfig, PluginRuntime } from "openclaw/plugin-sdk/core";
 import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/media-runtime";
 import {
diff --git a/extensions/mattermost/src/mattermost/runtime-api.ts b/extensions/mattermost/src/mattermost/runtime-api.ts
index b3344ee599bd..9ab938ca1729 100644
--- a/extensions/mattermost/src/mattermost/runtime-api.ts
+++ b/extensions/mattermost/src/mattermost/runtime-api.ts
@@ -1,3 +1,4 @@
+// Mattermost API module exposes the plugin public contract.
 export type {
   BaseProbeResult,
   ChannelAccountSnapshot,
diff --git a/extensions/mattermost/src/mattermost/send.test.ts b/extensions/mattermost/src/mattermost/send.test.ts
index 07dfc79108a7..04f2c4ac4f45 100644
--- a/extensions/mattermost/src/mattermost/send.test.ts
+++ b/extensions/mattermost/src/mattermost/send.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover send plugin behavior.
 import { expectProvidedCfgSkipsRuntimeLoad } from "openclaw/plugin-sdk/channel-test-helpers";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/mattermost/src/mattermost/send.ts b/extensions/mattermost/src/mattermost/send.ts
index 579952d10f88..5f6ed5351437 100644
--- a/extensions/mattermost/src/mattermost/send.ts
+++ b/extensions/mattermost/src/mattermost/send.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements send behavior.
 import {
   createMessageReceiptFromOutboundResults,
   type MessageReceipt,
diff --git a/extensions/mattermost/src/mattermost/slash-commands.test.ts b/extensions/mattermost/src/mattermost/slash-commands.test.ts
index e462808e8f5c..123d79846a5e 100644
--- a/extensions/mattermost/src/mattermost/slash-commands.test.ts
+++ b/extensions/mattermost/src/mattermost/slash-commands.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover slash commands plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { MattermostClient } from "./client.js";
 import {
diff --git a/extensions/mattermost/src/mattermost/slash-commands.ts b/extensions/mattermost/src/mattermost/slash-commands.ts
index ec3c5778bb91..89a10d51f920 100644
--- a/extensions/mattermost/src/mattermost/slash-commands.ts
+++ b/extensions/mattermost/src/mattermost/slash-commands.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements slash commands behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { MattermostClient } from "./client.js";
 
diff --git a/extensions/mattermost/src/mattermost/slash-http.send-config.test.ts b/extensions/mattermost/src/mattermost/slash-http.send-config.test.ts
index 8a207a665c11..952cd1e726e2 100644
--- a/extensions/mattermost/src/mattermost/slash-http.send-config.test.ts
+++ b/extensions/mattermost/src/mattermost/slash-http.send-config.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover slash http.send config plugin behavior.
 import { ServerResponse, type IncomingMessage } from "node:http";
 import { PassThrough } from "node:stream";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
diff --git a/extensions/mattermost/src/mattermost/slash-http.test.ts b/extensions/mattermost/src/mattermost/slash-http.test.ts
index 358142908ca2..5b45325572bc 100644
--- a/extensions/mattermost/src/mattermost/slash-http.test.ts
+++ b/extensions/mattermost/src/mattermost/slash-http.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover slash http plugin behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { PassThrough } from "node:stream";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/mattermost/src/mattermost/slash-state.test.ts b/extensions/mattermost/src/mattermost/slash-state.test.ts
index 1fba9d70abfb..77d1d7c974d6 100644
--- a/extensions/mattermost/src/mattermost/slash-state.test.ts
+++ b/extensions/mattermost/src/mattermost/slash-state.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover slash state plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig, RuntimeEnv } from "../runtime-api.js";
 import type { ResolvedMattermostAccount } from "./accounts.js";
diff --git a/extensions/mattermost/src/mattermost/target-resolution.test.ts b/extensions/mattermost/src/mattermost/target-resolution.test.ts
index 76ce9406d765..6d0548898d1e 100644
--- a/extensions/mattermost/src/mattermost/target-resolution.test.ts
+++ b/extensions/mattermost/src/mattermost/target-resolution.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover target resolution plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const resolveMattermostAccount = vi.fn();
diff --git a/extensions/mattermost/src/mattermost/target-resolution.ts b/extensions/mattermost/src/mattermost/target-resolution.ts
index 9c14e0bb37c8..e6105349f556 100644
--- a/extensions/mattermost/src/mattermost/target-resolution.ts
+++ b/extensions/mattermost/src/mattermost/target-resolution.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements target resolution behavior.
 import { isPrivateNetworkOptInEnabled } from "openclaw/plugin-sdk/ssrf-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveMattermostAccount } from "./accounts.js";
diff --git a/extensions/mattermost/src/normalize.test.ts b/extensions/mattermost/src/normalize.test.ts
index fb7866b34be3..e4a019b9894f 100644
--- a/extensions/mattermost/src/normalize.test.ts
+++ b/extensions/mattermost/src/normalize.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover normalize plugin behavior.
 import { describe, expect, it } from "vitest";
 import { looksLikeMattermostTargetId, normalizeMattermostMessagingTarget } from "./normalize.js";
 
diff --git a/extensions/mattermost/src/normalize.ts b/extensions/mattermost/src/normalize.ts
index 5f3f542a026f..70d374114971 100644
--- a/extensions/mattermost/src/normalize.ts
+++ b/extensions/mattermost/src/normalize.ts
@@ -1,3 +1,4 @@
+// Mattermost helper module supports normalize behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 export function normalizeMattermostMessagingTarget(raw: string): string | undefined {
diff --git a/extensions/mattermost/src/runtime.ts b/extensions/mattermost/src/runtime.ts
index 8a58131be403..f8758b785abb 100644
--- a/extensions/mattermost/src/runtime.ts
+++ b/extensions/mattermost/src/runtime.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements runtime behavior.
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import type { PluginRuntime } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/mattermost/src/secret-contract.ts b/extensions/mattermost/src/secret-contract.ts
index bbc2855300b7..30345e6e85a5 100644
--- a/extensions/mattermost/src/secret-contract.ts
+++ b/extensions/mattermost/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements secret contract behavior.
 import {
   collectSimpleChannelFieldAssignments,
   getChannelSurface,
diff --git a/extensions/mattermost/src/secret-input.ts b/extensions/mattermost/src/secret-input.ts
index d8d7aaf31d29..11ca969cb8d4 100644
--- a/extensions/mattermost/src/secret-input.ts
+++ b/extensions/mattermost/src/secret-input.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements secret input behavior.
 export type { SecretInput } from "openclaw/plugin-sdk/secret-input";
 export {
   buildSecretInputSchema,
diff --git a/extensions/mattermost/src/session-route.test.ts b/extensions/mattermost/src/session-route.test.ts
index 51b0d937b75c..66124043795c 100644
--- a/extensions/mattermost/src/session-route.test.ts
+++ b/extensions/mattermost/src/session-route.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover session route plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMattermostOutboundSessionRoute } from "./session-route.js";
 
diff --git a/extensions/mattermost/src/session-route.ts b/extensions/mattermost/src/session-route.ts
index d87697e7c808..b1b431cab5be 100644
--- a/extensions/mattermost/src/session-route.ts
+++ b/extensions/mattermost/src/session-route.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements session route behavior.
 import {
   buildChannelOutboundSessionRoute,
   buildThreadAwareOutboundSessionRoute,
diff --git a/extensions/mattermost/src/setup-core.ts b/extensions/mattermost/src/setup-core.ts
index 5e4fa216aa1a..b4d08cb2f54c 100644
--- a/extensions/mattermost/src/setup-core.ts
+++ b/extensions/mattermost/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements setup core behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import type { ChannelSetupAdapter } from "openclaw/plugin-sdk/channel-setup";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/mattermost/src/setup-surface.ts b/extensions/mattermost/src/setup-surface.ts
index 12c8716a78c9..f7f289ba592f 100644
--- a/extensions/mattermost/src/setup-surface.ts
+++ b/extensions/mattermost/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Mattermost plugin module implements setup surface behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/mattermost/src/setup.accounts.runtime.ts b/extensions/mattermost/src/setup.accounts.runtime.ts
index 982c75a6ab98..d1a45872ac35 100644
--- a/extensions/mattermost/src/setup.accounts.runtime.ts
+++ b/extensions/mattermost/src/setup.accounts.runtime.ts
@@ -1 +1,2 @@
+// Mattermost plugin module implements setup.accounts behavior.
 export { resolveMattermostAccount, type ResolvedMattermostAccount } from "./mattermost/accounts.js";
diff --git a/extensions/mattermost/src/setup.client.runtime.ts b/extensions/mattermost/src/setup.client.runtime.ts
index 5d437609da4d..448f5ad331f1 100644
--- a/extensions/mattermost/src/setup.client.runtime.ts
+++ b/extensions/mattermost/src/setup.client.runtime.ts
@@ -1 +1,2 @@
+// Mattermost plugin module implements setup.client behavior.
 export { normalizeMattermostBaseUrl } from "./mattermost/client.js";
diff --git a/extensions/mattermost/src/setup.secret-input.runtime.ts b/extensions/mattermost/src/setup.secret-input.runtime.ts
index f37a3043a0cb..59165efdf7d5 100644
--- a/extensions/mattermost/src/setup.secret-input.runtime.ts
+++ b/extensions/mattermost/src/setup.secret-input.runtime.ts
@@ -1 +1,2 @@
+// Mattermost plugin module implements setup.secret input behavior.
 export { hasConfiguredSecretInput } from "./secret-input.js";
diff --git a/extensions/mattermost/src/setup.test.ts b/extensions/mattermost/src/setup.test.ts
index cb7e179a4590..38a007e00218 100644
--- a/extensions/mattermost/src/setup.test.ts
+++ b/extensions/mattermost/src/setup.test.ts
@@ -1,3 +1,4 @@
+// Mattermost tests cover setup plugin behavior.
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import {
   createSetupWizardAdapter,
diff --git a/extensions/mattermost/src/types.ts b/extensions/mattermost/src/types.ts
index 6399943cf366..d688b4d2e846 100644
--- a/extensions/mattermost/src/types.ts
+++ b/extensions/mattermost/src/types.ts
@@ -1,3 +1,4 @@
+// Mattermost type declarations define plugin contracts.
 import type {
   ChannelPreviewStreamingConfig,
   StreamingMode,
diff --git a/extensions/memory-core/api.ts b/extensions/memory-core/api.ts
index 102c7f5e3d08..3b55c8797359 100644
--- a/extensions/memory-core/api.ts
+++ b/extensions/memory-core/api.ts
@@ -1,3 +1,4 @@
+// Memory Core API module exposes the plugin public contract.
 export type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 export type {
   MemoryEmbeddingProbeResult,
diff --git a/extensions/memory-core/cli-metadata.ts b/extensions/memory-core/cli-metadata.ts
index f8ed103be373..6ea28710ab0e 100644
--- a/extensions/memory-core/cli-metadata.ts
+++ b/extensions/memory-core/cli-metadata.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements cli metadata behavior.
 import { definePluginEntry } from "openclaw/plugin-sdk/core";
 
 export default definePluginEntry({
diff --git a/extensions/memory-core/cli.ts b/extensions/memory-core/cli.ts
index f9d71d00b198..d03b5f8a1d41 100644
--- a/extensions/memory-core/cli.ts
+++ b/extensions/memory-core/cli.ts
@@ -1 +1,2 @@
+// Memory Core plugin module implements cli behavior.
 export { registerMemoryCli } from "./src/cli.js";
diff --git a/extensions/memory-core/index.test.ts b/extensions/memory-core/index.test.ts
index a2c5abac4bac..5e7893b41b5a 100644
--- a/extensions/memory-core/index.test.ts
+++ b/extensions/memory-core/index.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover index plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { MemoryPluginRuntime } from "openclaw/plugin-sdk/memory-core-host-runtime-core";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
diff --git a/extensions/memory-core/index.ts b/extensions/memory-core/index.ts
index c33ba5a1a5db..13e3ab65c7b8 100644
--- a/extensions/memory-core/index.ts
+++ b/extensions/memory-core/index.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin entrypoint registers its OpenClaw integration.
 import {
   jsonResult,
   resolveMemorySearchConfig,
diff --git a/extensions/memory-core/manager-runtime.ts b/extensions/memory-core/manager-runtime.ts
index 738bbb4e1dc7..e7473ae37a61 100644
--- a/extensions/memory-core/manager-runtime.ts
+++ b/extensions/memory-core/manager-runtime.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager runtime behavior.
 export {
   closeAllMemoryIndexManagers,
   closeMemoryIndexManagersForAgent,
diff --git a/extensions/memory-core/runtime-api.ts b/extensions/memory-core/runtime-api.ts
index 4d5e4d8b74ab..3d43d8e7cdbe 100644
--- a/extensions/memory-core/runtime-api.ts
+++ b/extensions/memory-core/runtime-api.ts
@@ -1,3 +1,4 @@
+// Memory Core API module exposes the plugin public contract.
 export { getMemorySearchManager, MemoryIndexManager } from "./src/memory/index.js";
 export { memoryRuntime } from "./src/runtime-provider.js";
 export {
diff --git a/extensions/memory-core/src/cli.host.runtime.ts b/extensions/memory-core/src/cli.host.runtime.ts
index f4b0a4ca2172..975427b10e45 100644
--- a/extensions/memory-core/src/cli.host.runtime.ts
+++ b/extensions/memory-core/src/cli.host.runtime.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements cli.host behavior.
 export {
   colorize,
   defaultRuntime,
diff --git a/extensions/memory-core/src/cli.runtime.ts b/extensions/memory-core/src/cli.runtime.ts
index 43f5acf62ac7..3dbcb3104947 100644
--- a/extensions/memory-core/src/cli.runtime.ts
+++ b/extensions/memory-core/src/cli.runtime.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements cli behavior.
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/memory-core/src/cli.test.ts b/extensions/memory-core/src/cli.test.ts
index b65ca5f20a07..7088c0d23a63 100644
--- a/extensions/memory-core/src/cli.test.ts
+++ b/extensions/memory-core/src/cli.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover cli plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/cli.ts b/extensions/memory-core/src/cli.ts
index dac461cf5772..a98be07c5360 100644
--- a/extensions/memory-core/src/cli.ts
+++ b/extensions/memory-core/src/cli.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements cli behavior.
 import type { Command } from "commander";
 import {
   formatDocsLink,
diff --git a/extensions/memory-core/src/cli.types.ts b/extensions/memory-core/src/cli.types.ts
index 315644a1b488..a3f9fa260765 100644
--- a/extensions/memory-core/src/cli.types.ts
+++ b/extensions/memory-core/src/cli.types.ts
@@ -1,3 +1,4 @@
+// Memory Core type declarations define plugin contracts.
 export type MemoryCommandOptions = {
   agent?: string;
   json?: boolean;
diff --git a/extensions/memory-core/src/concept-vocabulary.test.ts b/extensions/memory-core/src/concept-vocabulary.test.ts
index 13b6b9fe1177..952051270881 100644
--- a/extensions/memory-core/src/concept-vocabulary.test.ts
+++ b/extensions/memory-core/src/concept-vocabulary.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover concept vocabulary plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   classifyConceptTagScript,
diff --git a/extensions/memory-core/src/concept-vocabulary.ts b/extensions/memory-core/src/concept-vocabulary.ts
index f80c0d957049..4414b2ac07f1 100644
--- a/extensions/memory-core/src/concept-vocabulary.ts
+++ b/extensions/memory-core/src/concept-vocabulary.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements concept vocabulary behavior.
 import path from "node:path";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/memory-core/src/config.test.ts b/extensions/memory-core/src/config.test.ts
index d48d76ecaef2..20d2a7728353 100644
--- a/extensions/memory-core/src/config.test.ts
+++ b/extensions/memory-core/src/config.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover config plugin behavior.
 import fs from "node:fs";
 import {
   type JsonSchemaObject,
diff --git a/extensions/memory-core/src/dreaming-command.test.ts b/extensions/memory-core/src/dreaming-command.test.ts
index 566ac5ecf745..9194d63a119a 100644
--- a/extensions/memory-core/src/dreaming-command.test.ts
+++ b/extensions/memory-core/src/dreaming-command.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover dreaming command plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type {
   OpenClawPluginCommandDefinition,
diff --git a/extensions/memory-core/src/dreaming-command.ts b/extensions/memory-core/src/dreaming-command.ts
index 193c356b0f81..0189a5a8a9b6 100644
--- a/extensions/memory-core/src/dreaming-command.ts
+++ b/extensions/memory-core/src/dreaming-command.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements dreaming command behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolveMemoryDreamingConfig } from "openclaw/plugin-sdk/memory-core-host-status";
 import type { OpenClawPluginApi, PluginCommandContext } from "openclaw/plugin-sdk/plugin-entry";
diff --git a/extensions/memory-core/src/dreaming-markdown.test.ts b/extensions/memory-core/src/dreaming-markdown.test.ts
index 98e89c3d9d56..fbf8255f4cbe 100644
--- a/extensions/memory-core/src/dreaming-markdown.test.ts
+++ b/extensions/memory-core/src/dreaming-markdown.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover dreaming markdown plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/memory-core/src/dreaming-markdown.ts b/extensions/memory-core/src/dreaming-markdown.ts
index febe3af62e1f..dd4de4e3f9ee 100644
--- a/extensions/memory-core/src/dreaming-markdown.ts
+++ b/extensions/memory-core/src/dreaming-markdown.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements dreaming markdown behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/memory-core/src/dreaming-narrative.test.ts b/extensions/memory-core/src/dreaming-narrative.test.ts
index 468c40a2866f..07a4fff5b94b 100644
--- a/extensions/memory-core/src/dreaming-narrative.test.ts
+++ b/extensions/memory-core/src/dreaming-narrative.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover dreaming narrative plugin behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/memory-core/src/dreaming-narrative.ts b/extensions/memory-core/src/dreaming-narrative.ts
index 25d9eba0d7fc..e24452274394 100644
--- a/extensions/memory-core/src/dreaming-narrative.ts
+++ b/extensions/memory-core/src/dreaming-narrative.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements dreaming narrative behavior.
 import { createHash } from "node:crypto";
 import type { Dirent } from "node:fs";
 import fs from "node:fs/promises";
diff --git a/extensions/memory-core/src/dreaming-phases.test.ts b/extensions/memory-core/src/dreaming-phases.test.ts
index 3f93ff033593..97f3a12a78d7 100644
--- a/extensions/memory-core/src/dreaming-phases.test.ts
+++ b/extensions/memory-core/src/dreaming-phases.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover dreaming phases plugin behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/memory-core/src/dreaming-phases.ts b/extensions/memory-core/src/dreaming-phases.ts
index c54dd29eedfe..0b860c9ae3f4 100644
--- a/extensions/memory-core/src/dreaming-phases.ts
+++ b/extensions/memory-core/src/dreaming-phases.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements dreaming phases behavior.
 import { createHash } from "node:crypto";
 import type { Dirent } from "node:fs";
 import fs from "node:fs/promises";
diff --git a/extensions/memory-core/src/dreaming-repair.test.ts b/extensions/memory-core/src/dreaming-repair.test.ts
index 79ef4ab45e1e..294dab643cdc 100644
--- a/extensions/memory-core/src/dreaming-repair.test.ts
+++ b/extensions/memory-core/src/dreaming-repair.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover dreaming repair plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/dreaming-repair.ts b/extensions/memory-core/src/dreaming-repair.ts
index 21169f55d274..a2b221b94675 100644
--- a/extensions/memory-core/src/dreaming-repair.ts
+++ b/extensions/memory-core/src/dreaming-repair.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements dreaming repair behavior.
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/memory-core/src/dreaming-shadow-trial.test.ts b/extensions/memory-core/src/dreaming-shadow-trial.test.ts
index 496659c8e0d1..4c524e4faf54 100644
--- a/extensions/memory-core/src/dreaming-shadow-trial.test.ts
+++ b/extensions/memory-core/src/dreaming-shadow-trial.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover dreaming shadow trial plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-core/src/dreaming-shadow-trial.ts b/extensions/memory-core/src/dreaming-shadow-trial.ts
index 526bb1b7f853..a9f0127cc42c 100644
--- a/extensions/memory-core/src/dreaming-shadow-trial.ts
+++ b/extensions/memory-core/src/dreaming-shadow-trial.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements dreaming shadow trial behavior.
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/memory-core/src/dreaming-shared.test.ts b/extensions/memory-core/src/dreaming-shared.test.ts
index c3df7f55225d..e5715a97fc7b 100644
--- a/extensions/memory-core/src/dreaming-shared.test.ts
+++ b/extensions/memory-core/src/dreaming-shared.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover dreaming shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import { includesSystemEventToken } from "./dreaming-shared.js";
 
diff --git a/extensions/memory-core/src/dreaming-shared.ts b/extensions/memory-core/src/dreaming-shared.ts
index bb01ccd46d0f..564268e9dca6 100644
--- a/extensions/memory-core/src/dreaming-shared.ts
+++ b/extensions/memory-core/src/dreaming-shared.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements dreaming shared behavior.
 export { asNullableRecord as asRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 export { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 
diff --git a/extensions/memory-core/src/dreaming.test.ts b/extensions/memory-core/src/dreaming.test.ts
index 703161f16947..da20d0084882 100644
--- a/extensions/memory-core/src/dreaming.test.ts
+++ b/extensions/memory-core/src/dreaming.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover dreaming plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/memory-core/src/dreaming.ts b/extensions/memory-core/src/dreaming.ts
index fb53c1f2fb76..8d32c7a37352 100644
--- a/extensions/memory-core/src/dreaming.ts
+++ b/extensions/memory-core/src/dreaming.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements dreaming behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   DEFAULT_MEMORY_DREAMING_FREQUENCY as DEFAULT_MEMORY_DREAMING_CRON_EXPR,
diff --git a/extensions/memory-core/src/flush-plan.test.ts b/extensions/memory-core/src/flush-plan.test.ts
index 76514a582826..e6693b6db565 100644
--- a/extensions/memory-core/src/flush-plan.test.ts
+++ b/extensions/memory-core/src/flush-plan.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover flush plan plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { buildMemoryFlushPlan } from "./flush-plan.js";
 
diff --git a/extensions/memory-core/src/flush-plan.ts b/extensions/memory-core/src/flush-plan.ts
index 537d1cbd0ab7..5a20ba25fae3 100644
--- a/extensions/memory-core/src/flush-plan.ts
+++ b/extensions/memory-core/src/flush-plan.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements flush plan behavior.
 import {
   DEFAULT_AGENT_COMPACTION_RESERVE_TOKENS_FLOOR,
   parseNonNegativeByteSize,
diff --git a/extensions/memory-core/src/memory-budget.test.ts b/extensions/memory-core/src/memory-budget.test.ts
index c408027636e1..dab355a9746d 100644
--- a/extensions/memory-core/src/memory-budget.test.ts
+++ b/extensions/memory-core/src/memory-budget.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover memory budget plugin behavior.
 import { describe, expect, it } from "vitest";
 import { compactMemoryForBudget, DEFAULT_MEMORY_FILE_MAX_CHARS } from "./memory-budget.js";
 
diff --git a/extensions/memory-core/src/memory-events.test.ts b/extensions/memory-core/src/memory-events.test.ts
index fe6f68761274..4bbc03d3df12 100644
--- a/extensions/memory-core/src/memory-events.test.ts
+++ b/extensions/memory-core/src/memory-events.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover memory events plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { readMemoryHostEvents } from "openclaw/plugin-sdk/memory-host-events";
diff --git a/extensions/memory-core/src/memory-tool-manager-mock.ts b/extensions/memory-core/src/memory-tool-manager-mock.ts
index 6d5d63661db5..0b906d1bf544 100644
--- a/extensions/memory-core/src/memory-tool-manager-mock.ts
+++ b/extensions/memory-core/src/memory-tool-manager-mock.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements memory tool manager mock behavior.
 import type { MemorySearchRuntimeDebug } from "openclaw/plugin-sdk/memory-core-host-runtime-files";
 import { vi } from "vitest";
 
diff --git a/extensions/memory-core/src/memory/embedding.test-mocks.ts b/extensions/memory-core/src/memory/embedding.test-mocks.ts
index 3fbc88e85a74..c00d7b3ccefb 100644
--- a/extensions/memory-core/src/memory/embedding.test-mocks.ts
+++ b/extensions/memory-core/src/memory/embedding.test-mocks.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements embedding mocks behavior.
 import { vi, type Mock } from "vitest";
 import "./test-runtime-mocks.js";
 
diff --git a/extensions/memory-core/src/memory/embeddings.test.ts b/extensions/memory-core/src/memory/embeddings.test.ts
index 1c7ee4b3c199..532c055de6ad 100644
--- a/extensions/memory-core/src/memory/embeddings.test.ts
+++ b/extensions/memory-core/src/memory/embeddings.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover embeddings plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { EmbeddingProviderAdapter } from "openclaw/plugin-sdk/embedding-providers";
 import type { MemoryEmbeddingProviderAdapter } from "openclaw/plugin-sdk/memory-core-host-engine-embeddings";
diff --git a/extensions/memory-core/src/memory/embeddings.ts b/extensions/memory-core/src/memory/embeddings.ts
index 4f2d40627591..6740057dde8e 100644
--- a/extensions/memory-core/src/memory/embeddings.ts
+++ b/extensions/memory-core/src/memory/embeddings.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements embeddings behavior.
 import {
   getEmbeddingProvider,
   type EmbeddingProviderAdapter,
diff --git a/extensions/memory-core/src/memory/generic-embedding-provider.bridge.test.ts b/extensions/memory-core/src/memory/generic-embedding-provider.bridge.test.ts
index 0bf8c8c791d8..6728f4ffbb57 100644
--- a/extensions/memory-core/src/memory/generic-embedding-provider.bridge.test.ts
+++ b/extensions/memory-core/src/memory/generic-embedding-provider.bridge.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover generic embedding provider.bridge plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type {
   EmbeddingInput,
diff --git a/extensions/memory-core/src/memory/generic-embedding-provider.integration.test.ts b/extensions/memory-core/src/memory/generic-embedding-provider.integration.test.ts
index e23c56de786f..70cebbb20f8b 100644
--- a/extensions/memory-core/src/memory/generic-embedding-provider.integration.test.ts
+++ b/extensions/memory-core/src/memory/generic-embedding-provider.integration.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover generic embedding provider.integration plugin behavior.
 import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
 import type { AddressInfo } from "node:net";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/memory-core/src/memory/hybrid.test.ts b/extensions/memory-core/src/memory/hybrid.test.ts
index 505db1072bf6..afbca7ee46df 100644
--- a/extensions/memory-core/src/memory/hybrid.test.ts
+++ b/extensions/memory-core/src/memory/hybrid.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover hybrid plugin behavior.
 import { describe, expect, it } from "vitest";
 import { bm25RankToScore, buildFtsQuery, mergeHybridResults } from "./hybrid.js";
 
diff --git a/extensions/memory-core/src/memory/hybrid.ts b/extensions/memory-core/src/memory/hybrid.ts
index b21d24132a16..3dc29dfc5e00 100644
--- a/extensions/memory-core/src/memory/hybrid.ts
+++ b/extensions/memory-core/src/memory/hybrid.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements hybrid behavior.
 import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { applyMMRToHybridResults, type MMRConfig, DEFAULT_MMR_CONFIG } from "./mmr.js";
 import {
diff --git a/extensions/memory-core/src/memory/index.test.ts b/extensions/memory-core/src/memory/index.test.ts
index 488531393adf..66513b2cc4f1 100644
--- a/extensions/memory-core/src/memory/index.test.ts
+++ b/extensions/memory-core/src/memory/index.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover index plugin behavior.
 import { mkdirSync, rmSync } from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/memory-core/src/memory/index.ts b/extensions/memory-core/src/memory/index.ts
index e4ad63af9394..b29c936c53c9 100644
--- a/extensions/memory-core/src/memory/index.ts
+++ b/extensions/memory-core/src/memory/index.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin entrypoint registers its OpenClaw integration.
 export { MemoryIndexManager } from "./manager.js";
 export type {
   MemoryEmbeddingProbeResult,
diff --git a/extensions/memory-core/src/memory/manager-async-state.ts b/extensions/memory-core/src/memory/manager-async-state.ts
index d1556eb2022f..b34140027a82 100644
--- a/extensions/memory-core/src/memory/manager-async-state.ts
+++ b/extensions/memory-core/src/memory/manager-async-state.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager async state behavior.
 export function startAsyncSearchSync(params: {
   enabled: boolean;
   dirty: boolean;
diff --git a/extensions/memory-core/src/memory/manager-atomic-reindex.ts b/extensions/memory-core/src/memory/manager-atomic-reindex.ts
index c056aee1510f..7a729d979ab3 100644
--- a/extensions/memory-core/src/memory/manager-atomic-reindex.ts
+++ b/extensions/memory-core/src/memory/manager-atomic-reindex.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager atomic reindex behavior.
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import { setTimeout as sleep } from "node:timers/promises";
diff --git a/extensions/memory-core/src/memory/manager-batch-state.test.ts b/extensions/memory-core/src/memory/manager-batch-state.test.ts
index 4f35a6852bff..48c555c7b8a8 100644
--- a/extensions/memory-core/src/memory/manager-batch-state.test.ts
+++ b/extensions/memory-core/src/memory/manager-batch-state.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager batch state plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   MEMORY_BATCH_FAILURE_LIMIT,
diff --git a/extensions/memory-core/src/memory/manager-batch-state.ts b/extensions/memory-core/src/memory/manager-batch-state.ts
index 2719b2f32527..6ccbc1b53451 100644
--- a/extensions/memory-core/src/memory/manager-batch-state.ts
+++ b/extensions/memory-core/src/memory/manager-batch-state.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager batch state behavior.
 export const MEMORY_BATCH_FAILURE_LIMIT = 2;
 
 type MemoryBatchFailureState = {
diff --git a/extensions/memory-core/src/memory/manager-cache.test.ts b/extensions/memory-core/src/memory/manager-cache.test.ts
index 6263c3b32c07..93b4b55e2b9e 100644
--- a/extensions/memory-core/src/memory/manager-cache.test.ts
+++ b/extensions/memory-core/src/memory/manager-cache.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager cache plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   closeManagedCacheEntries,
diff --git a/extensions/memory-core/src/memory/manager-cache.ts b/extensions/memory-core/src/memory/manager-cache.ts
index 07f76531f2db..df915e429a9f 100644
--- a/extensions/memory-core/src/memory/manager-cache.ts
+++ b/extensions/memory-core/src/memory/manager-cache.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager cache behavior.
 import { resolveGlobalSingleton } from "openclaw/plugin-sdk/memory-core-host-engine-foundation";
 
 type Closable = {
diff --git a/extensions/memory-core/src/memory/manager-db.ts b/extensions/memory-core/src/memory/manager-db.ts
index 234c9005b5e8..e4ea0856364a 100644
--- a/extensions/memory-core/src/memory/manager-db.ts
+++ b/extensions/memory-core/src/memory/manager-db.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager db behavior.
 import path from "node:path";
 import type { DatabaseSync } from "node:sqlite";
 import {
diff --git a/extensions/memory-core/src/memory/manager-embedding-cache.test.ts b/extensions/memory-core/src/memory/manager-embedding-cache.test.ts
index 04bbd0a32f5a..77d170791ff0 100644
--- a/extensions/memory-core/src/memory/manager-embedding-cache.test.ts
+++ b/extensions/memory-core/src/memory/manager-embedding-cache.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager embedding cache plugin behavior.
 import {
   ensureMemoryIndexSchema,
   requireNodeSqlite,
diff --git a/extensions/memory-core/src/memory/manager-embedding-cache.ts b/extensions/memory-core/src/memory/manager-embedding-cache.ts
index ba797492c1c4..0eb4d06cb27f 100644
--- a/extensions/memory-core/src/memory/manager-embedding-cache.ts
+++ b/extensions/memory-core/src/memory/manager-embedding-cache.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager embedding cache behavior.
 import type { DatabaseSync, SQLInputValue } from "node:sqlite";
 import {
   parseEmbedding,
diff --git a/extensions/memory-core/src/memory/manager-embedding-errors.ts b/extensions/memory-core/src/memory/manager-embedding-errors.ts
index df586304e233..6bd37ab609b5 100644
--- a/extensions/memory-core/src/memory/manager-embedding-errors.ts
+++ b/extensions/memory-core/src/memory/manager-embedding-errors.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager embedding errors behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 
 export const MEMORY_EMBEDDING_OPERATION_ERROR_CODE = "MEMORY_EMBEDDING_OPERATION_FAILED";
diff --git a/extensions/memory-core/src/memory/manager-embedding-ops.ts b/extensions/memory-core/src/memory/manager-embedding-ops.ts
index f63631e131ef..46f1b92f312a 100644
--- a/extensions/memory-core/src/memory/manager-embedding-ops.ts
+++ b/extensions/memory-core/src/memory/manager-embedding-ops.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager embedding ops behavior.
 import fs from "node:fs/promises";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import {
diff --git a/extensions/memory-core/src/memory/manager-embedding-policy.test.ts b/extensions/memory-core/src/memory/manager-embedding-policy.test.ts
index ecb4c464e7e5..a2eec83b33c9 100644
--- a/extensions/memory-core/src/memory/manager-embedding-policy.test.ts
+++ b/extensions/memory-core/src/memory/manager-embedding-policy.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager embedding policy plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   buildMemoryEmbeddingBatches,
diff --git a/extensions/memory-core/src/memory/manager-embedding-policy.ts b/extensions/memory-core/src/memory/manager-embedding-policy.ts
index 30d016135187..25c0326232b5 100644
--- a/extensions/memory-core/src/memory/manager-embedding-policy.ts
+++ b/extensions/memory-core/src/memory/manager-embedding-policy.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager embedding policy behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 
 type MemoryEmbeddingTextPart = {
diff --git a/extensions/memory-core/src/memory/manager-embedding-timeout.test.ts b/extensions/memory-core/src/memory/manager-embedding-timeout.test.ts
index 3fd40cb789c0..61a013114323 100644
--- a/extensions/memory-core/src/memory/manager-embedding-timeout.test.ts
+++ b/extensions/memory-core/src/memory/manager-embedding-timeout.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager embedding timeout plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/memory-core/src/memory/manager-fts-state.test.ts b/extensions/memory-core/src/memory/manager-fts-state.test.ts
index 21ddf57401c0..c20caf62483e 100644
--- a/extensions/memory-core/src/memory/manager-fts-state.test.ts
+++ b/extensions/memory-core/src/memory/manager-fts-state.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager fts state plugin behavior.
 import { DatabaseSync } from "node:sqlite";
 import { afterEach, describe, expect, it } from "vitest";
 import { deleteMemoryFtsRows } from "./manager-fts-state.js";
diff --git a/extensions/memory-core/src/memory/manager-fts-state.ts b/extensions/memory-core/src/memory/manager-fts-state.ts
index f28314d5fa4b..139fbfe44c6a 100644
--- a/extensions/memory-core/src/memory/manager-fts-state.ts
+++ b/extensions/memory-core/src/memory/manager-fts-state.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager fts state behavior.
 import type { DatabaseSync } from "node:sqlite";
 import type { MemorySource } from "openclaw/plugin-sdk/memory-core-host-engine-storage";
 
diff --git a/extensions/memory-core/src/memory/manager-local-worker-errors.ts b/extensions/memory-core/src/memory/manager-local-worker-errors.ts
index d7b4f32ffdcc..41f8ce0010de 100644
--- a/extensions/memory-core/src/memory/manager-local-worker-errors.ts
+++ b/extensions/memory-core/src/memory/manager-local-worker-errors.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager local worker errors behavior.
 export const LOCAL_EMBEDDING_WORKER_ERROR_CODES = {
   exited: "LOCAL_EMBEDDING_WORKER_EXITED",
   processError: "LOCAL_EMBEDDING_WORKER_PROCESS_ERROR",
diff --git a/extensions/memory-core/src/memory/manager-provider-state.ts b/extensions/memory-core/src/memory/manager-provider-state.ts
index fd2668353932..c98774d879fd 100644
--- a/extensions/memory-core/src/memory/manager-provider-state.ts
+++ b/extensions/memory-core/src/memory/manager-provider-state.ts
@@ -1,3 +1,4 @@
+// Memory Core provider module implements model/runtime integration.
 import type {
   OpenClawConfig,
   ResolvedMemorySearchConfig,
diff --git a/extensions/memory-core/src/memory/manager-reindex-state.test.ts b/extensions/memory-core/src/memory/manager-reindex-state.test.ts
index 8ec142c5e4f7..e7ca7e84ec45 100644
--- a/extensions/memory-core/src/memory/manager-reindex-state.test.ts
+++ b/extensions/memory-core/src/memory/manager-reindex-state.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager reindex state plugin behavior.
 import type { MemorySource } from "openclaw/plugin-sdk/memory-core-host-engine-storage";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/memory-core/src/memory/manager-reindex-state.ts b/extensions/memory-core/src/memory/manager-reindex-state.ts
index 5da56f5c8a69..f798db663377 100644
--- a/extensions/memory-core/src/memory/manager-reindex-state.ts
+++ b/extensions/memory-core/src/memory/manager-reindex-state.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager reindex state behavior.
 import {
   hashText,
   normalizeExtraMemoryPaths,
diff --git a/extensions/memory-core/src/memory/manager-runtime.ts b/extensions/memory-core/src/memory/manager-runtime.ts
index 3493238b80ff..d454092f61e8 100644
--- a/extensions/memory-core/src/memory/manager-runtime.ts
+++ b/extensions/memory-core/src/memory/manager-runtime.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager runtime behavior.
 export {
   closeAllMemoryIndexManagers,
   closeMemoryIndexManagersForAgent,
diff --git a/extensions/memory-core/src/memory/manager-search-preflight.test.ts b/extensions/memory-core/src/memory/manager-search-preflight.test.ts
index 760575c3c0e2..6869957dbf78 100644
--- a/extensions/memory-core/src/memory/manager-search-preflight.test.ts
+++ b/extensions/memory-core/src/memory/manager-search-preflight.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager search preflight plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMemorySearchPreflight } from "./manager-search-preflight.js";
 
diff --git a/extensions/memory-core/src/memory/manager-search-preflight.ts b/extensions/memory-core/src/memory/manager-search-preflight.ts
index cdbf612c03e5..84c93812f813 100644
--- a/extensions/memory-core/src/memory/manager-search-preflight.ts
+++ b/extensions/memory-core/src/memory/manager-search-preflight.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager search preflight behavior.
 export function resolveMemorySearchPreflight(params: {
   query: string;
   hasIndexedContent: boolean;
diff --git a/extensions/memory-core/src/memory/manager-search.test.ts b/extensions/memory-core/src/memory/manager-search.test.ts
index be4cdedbf3ab..edfe5fdbed23 100644
--- a/extensions/memory-core/src/memory/manager-search.test.ts
+++ b/extensions/memory-core/src/memory/manager-search.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager search plugin behavior.
 import {
   ensureMemoryIndexSchema,
   loadSqliteVecExtension,
diff --git a/extensions/memory-core/src/memory/manager-search.ts b/extensions/memory-core/src/memory/manager-search.ts
index 21fa99b36f59..ff907b196001 100644
--- a/extensions/memory-core/src/memory/manager-search.ts
+++ b/extensions/memory-core/src/memory/manager-search.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager search behavior.
 import type { DatabaseSync } from "node:sqlite";
 import { truncateUtf16Safe } from "openclaw/plugin-sdk/memory-core-host-engine-foundation";
 import {
diff --git a/extensions/memory-core/src/memory/manager-session-reindex.ts b/extensions/memory-core/src/memory/manager-session-reindex.ts
index 1b3a7094047a..598cf572046a 100644
--- a/extensions/memory-core/src/memory/manager-session-reindex.ts
+++ b/extensions/memory-core/src/memory/manager-session-reindex.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager session reindex behavior.
 export function shouldSyncSessionsForReindex(params: {
   hasSessionSource: boolean;
   sessionsDirty: boolean;
diff --git a/extensions/memory-core/src/memory/manager-session-sync-state.test.ts b/extensions/memory-core/src/memory/manager-session-sync-state.test.ts
index 9fa4ee282c01..677440c73548 100644
--- a/extensions/memory-core/src/memory/manager-session-sync-state.test.ts
+++ b/extensions/memory-core/src/memory/manager-session-sync-state.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager session sync state plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveMemorySessionStartupDirtyFiles,
diff --git a/extensions/memory-core/src/memory/manager-session-sync-state.ts b/extensions/memory-core/src/memory/manager-session-sync-state.ts
index 4463c394d136..37a1ff064a87 100644
--- a/extensions/memory-core/src/memory/manager-session-sync-state.ts
+++ b/extensions/memory-core/src/memory/manager-session-sync-state.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager session sync state behavior.
 import type { MemorySourceFileStateRow } from "./manager-source-state.js";
 
 export type MemorySessionStartupFileState = {
diff --git a/extensions/memory-core/src/memory/manager-source-state.test.ts b/extensions/memory-core/src/memory/manager-source-state.test.ts
index fb3879d4c5ee..dd866e85fbee 100644
--- a/extensions/memory-core/src/memory/manager-source-state.test.ts
+++ b/extensions/memory-core/src/memory/manager-source-state.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager source state plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   loadMemorySourceFileState,
diff --git a/extensions/memory-core/src/memory/manager-source-state.ts b/extensions/memory-core/src/memory/manager-source-state.ts
index 78e8941ee26f..a918f6b9203f 100644
--- a/extensions/memory-core/src/memory/manager-source-state.ts
+++ b/extensions/memory-core/src/memory/manager-source-state.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager source state behavior.
 import type { SQLInputValue } from "node:sqlite";
 import type { MemorySource } from "openclaw/plugin-sdk/memory-core-host-engine-storage";
 
diff --git a/extensions/memory-core/src/memory/manager-status-state.test.ts b/extensions/memory-core/src/memory/manager-status-state.test.ts
index 1f5a8b3339b9..d6ef28995360 100644
--- a/extensions/memory-core/src/memory/manager-status-state.test.ts
+++ b/extensions/memory-core/src/memory/manager-status-state.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager status state plugin behavior.
 import type { SQLInputValue } from "node:sqlite";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/memory-core/src/memory/manager-status-state.ts b/extensions/memory-core/src/memory/manager-status-state.ts
index 9f2fd0241390..9f36b42364ac 100644
--- a/extensions/memory-core/src/memory/manager-status-state.ts
+++ b/extensions/memory-core/src/memory/manager-status-state.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager status state behavior.
 import type { SQLInputValue } from "node:sqlite";
 import type { MemorySource } from "openclaw/plugin-sdk/memory-core-host-engine-storage";
 
diff --git a/extensions/memory-core/src/memory/manager-sync-control.ts b/extensions/memory-core/src/memory/manager-sync-control.ts
index 5bab24c552e5..6190216400f0 100644
--- a/extensions/memory-core/src/memory/manager-sync-control.ts
+++ b/extensions/memory-core/src/memory/manager-sync-control.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager sync control behavior.
 import type { DatabaseSync } from "node:sqlite";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import {
diff --git a/extensions/memory-core/src/memory/manager-sync-ops.archive-delta-bypass.test.ts b/extensions/memory-core/src/memory/manager-sync-ops.archive-delta-bypass.test.ts
index 235e82143b24..c2eb930a5af1 100644
--- a/extensions/memory-core/src/memory/manager-sync-ops.archive-delta-bypass.test.ts
+++ b/extensions/memory-core/src/memory/manager-sync-ops.archive-delta-bypass.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager sync ops.archive delta bypass plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/memory/manager-sync-ops.interval.test.ts b/extensions/memory-core/src/memory/manager-sync-ops.interval.test.ts
index ddd7bfe9f448..71620d25643e 100644
--- a/extensions/memory-core/src/memory/manager-sync-ops.interval.test.ts
+++ b/extensions/memory-core/src/memory/manager-sync-ops.interval.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager sync ops.interval plugin behavior.
 import type { DatabaseSync } from "node:sqlite";
 import type {
   OpenClawConfig,
diff --git a/extensions/memory-core/src/memory/manager-sync-ops.startup-catchup.test.ts b/extensions/memory-core/src/memory/manager-sync-ops.startup-catchup.test.ts
index d7150b136a1d..55819808866b 100644
--- a/extensions/memory-core/src/memory/manager-sync-ops.startup-catchup.test.ts
+++ b/extensions/memory-core/src/memory/manager-sync-ops.startup-catchup.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager sync ops.startup catchup plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/memory/manager-sync-ops.ts b/extensions/memory-core/src/memory/manager-sync-ops.ts
index 4a317c53e153..ae42b3c4d33a 100644
--- a/extensions/memory-core/src/memory/manager-sync-ops.ts
+++ b/extensions/memory-core/src/memory/manager-sync-ops.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager sync ops behavior.
 import { randomUUID } from "node:crypto";
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
diff --git a/extensions/memory-core/src/memory/manager-sync-yield.test.ts b/extensions/memory-core/src/memory/manager-sync-yield.test.ts
index 8df997bd44b9..d6cd96d62bd1 100644
--- a/extensions/memory-core/src/memory/manager-sync-yield.test.ts
+++ b/extensions/memory-core/src/memory/manager-sync-yield.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager sync yield plugin behavior.
 import os from "node:os";
 import path from "node:path";
 import type { DatabaseSync } from "node:sqlite";
diff --git a/extensions/memory-core/src/memory/manager-targeted-sync.test.ts b/extensions/memory-core/src/memory/manager-targeted-sync.test.ts
index 2f1b3bbfcb4e..92288dc1fd0d 100644
--- a/extensions/memory-core/src/memory/manager-targeted-sync.test.ts
+++ b/extensions/memory-core/src/memory/manager-targeted-sync.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager targeted sync plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   clearMemorySyncedSessionFiles,
diff --git a/extensions/memory-core/src/memory/manager-targeted-sync.ts b/extensions/memory-core/src/memory/manager-targeted-sync.ts
index a4e4bb1c1e6b..f55eceb4ef39 100644
--- a/extensions/memory-core/src/memory/manager-targeted-sync.ts
+++ b/extensions/memory-core/src/memory/manager-targeted-sync.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager targeted sync behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type { MemorySyncProgressUpdate } from "openclaw/plugin-sdk/memory-core-host-engine-storage";
 
diff --git a/extensions/memory-core/src/memory/manager-vector-warning.test.ts b/extensions/memory-core/src/memory/manager-vector-warning.test.ts
index 29b570fcad8b..25e26954bd6f 100644
--- a/extensions/memory-core/src/memory/manager-vector-warning.test.ts
+++ b/extensions/memory-core/src/memory/manager-vector-warning.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager vector warning plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { logMemoryVectorDegradedWrite } from "./manager-vector-warning.js";
 
diff --git a/extensions/memory-core/src/memory/manager-vector-warning.ts b/extensions/memory-core/src/memory/manager-vector-warning.ts
index 875c3fd45db2..e514a13b136d 100644
--- a/extensions/memory-core/src/memory/manager-vector-warning.ts
+++ b/extensions/memory-core/src/memory/manager-vector-warning.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager vector warning behavior.
 export function formatMemoryVectorDegradedWriteReason(loadError?: string): string {
   return loadError
     ? `sqlite-vec unavailable: ${loadError}`
diff --git a/extensions/memory-core/src/memory/manager-vector-write.ts b/extensions/memory-core/src/memory/manager-vector-write.ts
index 40edb0b783b2..c68c13bb68d2 100644
--- a/extensions/memory-core/src/memory/manager-vector-write.ts
+++ b/extensions/memory-core/src/memory/manager-vector-write.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager vector write behavior.
 import type { SQLInputValue } from "node:sqlite";
 
 type VectorWriteDb = {
diff --git a/extensions/memory-core/src/memory/manager.async-search.test.ts b/extensions/memory-core/src/memory/manager.async-search.test.ts
index 97a736e98478..5b6b95e4f62d 100644
--- a/extensions/memory-core/src/memory/manager.async-search.test.ts
+++ b/extensions/memory-core/src/memory/manager.async-search.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.async search plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { awaitPendingManagerWork, startAsyncSearchSync } from "./manager-async-state.js";
 
diff --git a/extensions/memory-core/src/memory/manager.atomic-reindex.test.ts b/extensions/memory-core/src/memory/manager.atomic-reindex.test.ts
index 9e907b0470ef..d45a3ed0d555 100644
--- a/extensions/memory-core/src/memory/manager.atomic-reindex.test.ts
+++ b/extensions/memory-core/src/memory/manager.atomic-reindex.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.atomic reindex plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/memory/manager.fts-only-reindex.test.ts b/extensions/memory-core/src/memory/manager.fts-only-reindex.test.ts
index 843812869f6a..550e93884c8b 100644
--- a/extensions/memory-core/src/memory/manager.fts-only-reindex.test.ts
+++ b/extensions/memory-core/src/memory/manager.fts-only-reindex.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.fts only reindex plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/memory/manager.mistral-provider.test.ts b/extensions/memory-core/src/memory/manager.mistral-provider.test.ts
index f8c1bb727b44..61b8d70d7f33 100644
--- a/extensions/memory-core/src/memory/manager.mistral-provider.test.ts
+++ b/extensions/memory-core/src/memory/manager.mistral-provider.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.mistral provider plugin behavior.
 import type {
   OpenClawConfig,
   ResolvedMemorySearchConfig,
diff --git a/extensions/memory-core/src/memory/manager.read-file.test.ts b/extensions/memory-core/src/memory/manager.read-file.test.ts
index 917cb7ffc11c..0d882dadf384 100644
--- a/extensions/memory-core/src/memory/manager.read-file.test.ts
+++ b/extensions/memory-core/src/memory/manager.read-file.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.read file plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/memory/manager.readonly-recovery.test.ts b/extensions/memory-core/src/memory/manager.readonly-recovery.test.ts
index d2881acaf97a..c415797fe9b4 100644
--- a/extensions/memory-core/src/memory/manager.readonly-recovery.test.ts
+++ b/extensions/memory-core/src/memory/manager.readonly-recovery.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.readonly recovery plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/memory/manager.session-reindex.test.ts b/extensions/memory-core/src/memory/manager.session-reindex.test.ts
index ae0253a1fdd2..081c9fccab2d 100644
--- a/extensions/memory-core/src/memory/manager.session-reindex.test.ts
+++ b/extensions/memory-core/src/memory/manager.session-reindex.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.session reindex plugin behavior.
 import { describe, expect, it } from "vitest";
 import { shouldSyncSessionsForReindex } from "./manager-session-reindex.js";
 
diff --git a/extensions/memory-core/src/memory/manager.sync-errors-do-not-crash.test.ts b/extensions/memory-core/src/memory/manager.sync-errors-do-not-crash.test.ts
index f649eab5afde..b29aae3fb7ea 100644
--- a/extensions/memory-core/src/memory/manager.sync-errors-do-not-crash.test.ts
+++ b/extensions/memory-core/src/memory/manager.sync-errors-do-not-crash.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.sync errors do not crash plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { runDetachedMemorySync } from "./manager-sync-ops.js";
 
diff --git a/extensions/memory-core/src/memory/manager.ts b/extensions/memory-core/src/memory/manager.ts
index 1a27bf162023..8dcefdc343d8 100644
--- a/extensions/memory-core/src/memory/manager.ts
+++ b/extensions/memory-core/src/memory/manager.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements manager behavior.
 import type { DatabaseSync } from "node:sqlite";
 import type { FSWatcher } from "chokidar";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/memory-core/src/memory/manager.vector-dedupe.test.ts b/extensions/memory-core/src/memory/manager.vector-dedupe.test.ts
index 9120c649f3d6..f50b1b5849f3 100644
--- a/extensions/memory-core/src/memory/manager.vector-dedupe.test.ts
+++ b/extensions/memory-core/src/memory/manager.vector-dedupe.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.vector dedupe plugin behavior.
 import { DatabaseSync } from "node:sqlite";
 import { afterEach, describe, expect, it } from "vitest";
 import { replaceMemoryVectorRow } from "./manager-vector-write.js";
diff --git a/extensions/memory-core/src/memory/manager.watcher-config.test.ts b/extensions/memory-core/src/memory/manager.watcher-config.test.ts
index 96ac2bcd0b96..3a0e15fdf64d 100644
--- a/extensions/memory-core/src/memory/manager.watcher-config.test.ts
+++ b/extensions/memory-core/src/memory/manager.watcher-config.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover manager.watcher config plugin behavior.
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/memory-core/src/memory/mmr.test.ts b/extensions/memory-core/src/memory/mmr.test.ts
index 41c6ea182dd3..7e6801d58ca9 100644
--- a/extensions/memory-core/src/memory/mmr.test.ts
+++ b/extensions/memory-core/src/memory/mmr.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover mmr plugin behavior.
 import { describe, it, expect } from "vitest";
 import {
   tokenize,
diff --git a/extensions/memory-core/src/memory/mmr.ts b/extensions/memory-core/src/memory/mmr.ts
index e146326483c4..37aa39830ea9 100644
--- a/extensions/memory-core/src/memory/mmr.ts
+++ b/extensions/memory-core/src/memory/mmr.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements mmr behavior.
 import { jaccardSimilarity, textSimilarity, tokenize } from "./tokenize.js";
 
 /**
diff --git a/extensions/memory-core/src/memory/provider-adapter-registration.test.ts b/extensions/memory-core/src/memory/provider-adapter-registration.test.ts
index 1903422e88ac..f3d7a25ebd74 100644
--- a/extensions/memory-core/src/memory/provider-adapter-registration.test.ts
+++ b/extensions/memory-core/src/memory/provider-adapter-registration.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover provider adapter registration plugin behavior.
 import { describe, expect, it } from "vitest";
 import { filterUnregisteredMemoryEmbeddingProviderAdapters } from "./provider-adapter-registration.js";
 
diff --git a/extensions/memory-core/src/memory/provider-adapter-registration.ts b/extensions/memory-core/src/memory/provider-adapter-registration.ts
index b62a4661c98b..aa8f80b5d6f3 100644
--- a/extensions/memory-core/src/memory/provider-adapter-registration.ts
+++ b/extensions/memory-core/src/memory/provider-adapter-registration.ts
@@ -1,3 +1,4 @@
+// Memory Core provider module implements model/runtime integration.
 type AdapterLike = {
   id: string;
 };
diff --git a/extensions/memory-core/src/memory/provider-adapters.ts b/extensions/memory-core/src/memory/provider-adapters.ts
index 1f07e4c2341d..3ba8a2f21f24 100644
--- a/extensions/memory-core/src/memory/provider-adapters.ts
+++ b/extensions/memory-core/src/memory/provider-adapters.ts
@@ -1,3 +1,4 @@
+// Memory Core provider module implements model/runtime integration.
 import {
   DEFAULT_LOCAL_MODEL,
   listMemoryEmbeddingProviders,
diff --git a/extensions/memory-core/src/memory/qmd-compat.test.ts b/extensions/memory-core/src/memory/qmd-compat.test.ts
index 9e926ebd7308..9d10b4918f16 100644
--- a/extensions/memory-core/src/memory/qmd-compat.test.ts
+++ b/extensions/memory-core/src/memory/qmd-compat.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover qmd compat plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveQmdCollectionPatternFlags } from "./qmd-compat.js";
 
diff --git a/extensions/memory-core/src/memory/qmd-compat.ts b/extensions/memory-core/src/memory/qmd-compat.ts
index 30090cc384b6..a7fc2ca1860d 100644
--- a/extensions/memory-core/src/memory/qmd-compat.ts
+++ b/extensions/memory-core/src/memory/qmd-compat.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements qmd compat behavior.
 export type QmdCollectionPatternFlag = "--glob" | "--mask";
 
 export function resolveQmdCollectionPatternFlags(
diff --git a/extensions/memory-core/src/memory/qmd-manager.slugified-paths.test.ts b/extensions/memory-core/src/memory/qmd-manager.slugified-paths.test.ts
index 1a0f6ee3a0b7..449a61ea47d8 100644
--- a/extensions/memory-core/src/memory/qmd-manager.slugified-paths.test.ts
+++ b/extensions/memory-core/src/memory/qmd-manager.slugified-paths.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover qmd manager.slugified paths plugin behavior.
 import { EventEmitter } from "node:events";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/memory-core/src/memory/qmd-manager.test.ts b/extensions/memory-core/src/memory/qmd-manager.test.ts
index 84acacd2c849..7b3b0ab978f4 100644
--- a/extensions/memory-core/src/memory/qmd-manager.test.ts
+++ b/extensions/memory-core/src/memory/qmd-manager.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover qmd manager plugin behavior.
 import { EventEmitter } from "node:events";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/memory-core/src/memory/qmd-manager.ts b/extensions/memory-core/src/memory/qmd-manager.ts
index 01153d2d3b27..5045ad0f4271 100644
--- a/extensions/memory-core/src/memory/qmd-manager.ts
+++ b/extensions/memory-core/src/memory/qmd-manager.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements qmd manager behavior.
 import crypto from "node:crypto";
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
diff --git a/extensions/memory-core/src/memory/search-manager.test.ts b/extensions/memory-core/src/memory/search-manager.test.ts
index 8571f9b284de..e114fc60c99b 100644
--- a/extensions/memory-core/src/memory/search-manager.test.ts
+++ b/extensions/memory-core/src/memory/search-manager.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover search manager plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/memory/search-manager.ts b/extensions/memory-core/src/memory/search-manager.ts
index 048444da16e5..7054e14fbb28 100644
--- a/extensions/memory-core/src/memory/search-manager.ts
+++ b/extensions/memory-core/src/memory/search-manager.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements search manager behavior.
 import fs from "node:fs/promises";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import {
diff --git a/extensions/memory-core/src/memory/temporal-decay.test.ts b/extensions/memory-core/src/memory/temporal-decay.test.ts
index d1661ce482d5..eae09f494760 100644
--- a/extensions/memory-core/src/memory/temporal-decay.test.ts
+++ b/extensions/memory-core/src/memory/temporal-decay.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover temporal decay plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-core/src/memory/temporal-decay.ts b/extensions/memory-core/src/memory/temporal-decay.ts
index 9004f4d7e814..59567a81cb4c 100644
--- a/extensions/memory-core/src/memory/temporal-decay.ts
+++ b/extensions/memory-core/src/memory/temporal-decay.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements temporal decay behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 
diff --git a/extensions/memory-core/src/memory/test-manager-helpers.ts b/extensions/memory-core/src/memory/test-manager-helpers.ts
index 62f718c3a9f6..cd5729fdd000 100644
--- a/extensions/memory-core/src/memory/test-manager-helpers.ts
+++ b/extensions/memory-core/src/memory/test-manager-helpers.ts
@@ -1,3 +1,4 @@
+// Memory Core helper module supports test manager helpers behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/memory-core-host-engine-foundation";
 import type { MemoryIndexManager } from "./index.js";
 
diff --git a/extensions/memory-core/src/memory/test-runtime-mocks.ts b/extensions/memory-core/src/memory/test-runtime-mocks.ts
index 044ad26998b3..3be68b81f439 100644
--- a/extensions/memory-core/src/memory/test-runtime-mocks.ts
+++ b/extensions/memory-core/src/memory/test-runtime-mocks.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements test runtime mocks behavior.
 import { vi } from "vitest";
 
 // Unit tests: avoid importing the real chokidar implementation (native fsevents, etc.).
diff --git a/extensions/memory-core/src/memory/tokenize.ts b/extensions/memory-core/src/memory/tokenize.ts
index e7fad6b75c16..15253966b89c 100644
--- a/extensions/memory-core/src/memory/tokenize.ts
+++ b/extensions/memory-core/src/memory/tokenize.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements tokenize behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 /**
@@ -92,8 +93,7 @@ export function textSimilarity(contentA: string, contentB: string): number {
   const tokensA = tokenize(contentA);
   const tokensB = tokenize(contentB);
   if (tokensA.size === 0 && tokensB.size === 0) {
-    return normalizeLowercaseStringOrEmpty(contentA) ===
-      normalizeLowercaseStringOrEmpty(contentB)
+    return normalizeLowercaseStringOrEmpty(contentA) === normalizeLowercaseStringOrEmpty(contentB)
       ? 1
       : 0;
   }
diff --git a/extensions/memory-core/src/memory/watch-pressure.ts b/extensions/memory-core/src/memory/watch-pressure.ts
index c7936ea4eb7b..94e4148aa942 100644
--- a/extensions/memory-core/src/memory/watch-pressure.ts
+++ b/extensions/memory-core/src/memory/watch-pressure.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements watch pressure behavior.
 import type { FSWatcher } from "chokidar";
 
 export const MEMORY_WATCH_PRESSURE_WARNING_THRESHOLD = 2_000;
diff --git a/extensions/memory-core/src/memory/watch-settle.ts b/extensions/memory-core/src/memory/watch-settle.ts
index effb802e2286..4403480690d7 100644
--- a/extensions/memory-core/src/memory/watch-settle.ts
+++ b/extensions/memory-core/src/memory/watch-settle.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements watch settle behavior.
 import fsSync from "node:fs";
 import path from "node:path";
 
diff --git a/extensions/memory-core/src/prompt-section.ts b/extensions/memory-core/src/prompt-section.ts
index adad1fcd82b3..3e8ee5dd1c12 100644
--- a/extensions/memory-core/src/prompt-section.ts
+++ b/extensions/memory-core/src/prompt-section.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements prompt section behavior.
 import type { MemoryPromptSectionBuilder } from "openclaw/plugin-sdk/memory-core-host-runtime-core";
 
 export const buildPromptSection: MemoryPromptSectionBuilder = ({
diff --git a/extensions/memory-core/src/public-artifacts.test.ts b/extensions/memory-core/src/public-artifacts.test.ts
index 08e96826355e..01715810c24e 100644
--- a/extensions/memory-core/src/public-artifacts.test.ts
+++ b/extensions/memory-core/src/public-artifacts.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover public artifacts plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/public-artifacts.ts b/extensions/memory-core/src/public-artifacts.ts
index ba4defabc281..6d6e7cf9618d 100644
--- a/extensions/memory-core/src/public-artifacts.ts
+++ b/extensions/memory-core/src/public-artifacts.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements public artifacts behavior.
 import {
   listMemoryHostPublicArtifacts,
   type MemoryPluginPublicArtifact,
diff --git a/extensions/memory-core/src/rem-evidence.ts b/extensions/memory-core/src/rem-evidence.ts
index b39de11d40c6..6e4926ef9ec1 100644
--- a/extensions/memory-core/src/rem-evidence.ts
+++ b/extensions/memory-core/src/rem-evidence.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements rem evidence behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/memory-core/src/rem-harness.ts b/extensions/memory-core/src/rem-harness.ts
index ad7e6fe3bce9..02d6e4a4f813 100644
--- a/extensions/memory-core/src/rem-harness.ts
+++ b/extensions/memory-core/src/rem-harness.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements rem harness behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/memory-core/src/runtime-provider.ts b/extensions/memory-core/src/runtime-provider.ts
index 1eedc5987e3a..cde3337f2077 100644
--- a/extensions/memory-core/src/runtime-provider.ts
+++ b/extensions/memory-core/src/runtime-provider.ts
@@ -1,3 +1,4 @@
+// Memory Core provider module implements model/runtime integration.
 import type { MemoryPluginRuntime } from "openclaw/plugin-sdk/memory-core-host-runtime-core";
 import { resolveMemoryBackendConfig } from "openclaw/plugin-sdk/memory-core-host-runtime-files";
 import {
diff --git a/extensions/memory-core/src/session-search-visibility.test.ts b/extensions/memory-core/src/session-search-visibility.test.ts
index 0c777c0bc340..cc029c572c88 100644
--- a/extensions/memory-core/src/session-search-visibility.test.ts
+++ b/extensions/memory-core/src/session-search-visibility.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover session search visibility plugin behavior.
 import type { MemorySearchResult } from "openclaw/plugin-sdk/memory-core-host-runtime-files";
 import * as sessionTranscriptHit from "openclaw/plugin-sdk/session-transcript-hit";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/memory-core/src/session-search-visibility.ts b/extensions/memory-core/src/session-search-visibility.ts
index 2d7c830cb9c9..0f8a4f3a77b0 100644
--- a/extensions/memory-core/src/session-search-visibility.ts
+++ b/extensions/memory-core/src/session-search-visibility.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements session search visibility behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/memory-core-host-runtime-core";
 import type { MemorySearchResult } from "openclaw/plugin-sdk/memory-core-host-runtime-files";
 import { resolveSessionAgentId } from "openclaw/plugin-sdk/memory-host-core";
diff --git a/extensions/memory-core/src/short-term-promotion.test.ts b/extensions/memory-core/src/short-term-promotion.test.ts
index cea2f03c4524..724b0834401f 100644
--- a/extensions/memory-core/src/short-term-promotion.test.ts
+++ b/extensions/memory-core/src/short-term-promotion.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover short term promotion plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-core/src/short-term-promotion.ts b/extensions/memory-core/src/short-term-promotion.ts
index 45b5cfdb765e..f4e0091d2e68 100644
--- a/extensions/memory-core/src/short-term-promotion.ts
+++ b/extensions/memory-core/src/short-term-promotion.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements short term promotion behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/memory-core/src/test-helpers.ts b/extensions/memory-core/src/test-helpers.ts
index 6ca1ea5e8cf5..168c99670f73 100644
--- a/extensions/memory-core/src/test-helpers.ts
+++ b/extensions/memory-core/src/test-helpers.ts
@@ -1,3 +1,4 @@
+// Memory Core helper module supports test helpers behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { resolvePreferredOpenClawTmpDir } from "openclaw/plugin-sdk/temp-path";
diff --git a/extensions/memory-core/src/time.ts b/extensions/memory-core/src/time.ts
index 615f03c00028..c1310c691ee7 100644
--- a/extensions/memory-core/src/time.ts
+++ b/extensions/memory-core/src/time.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements time behavior.
 import { timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
 
 export function resolveMemoryCoreNowMs(nowMs: unknown): number {
diff --git a/extensions/memory-core/src/tools.citations.test.ts b/extensions/memory-core/src/tools.citations.test.ts
index 26e3bd6fbf31..99cd89bd2a0f 100644
--- a/extensions/memory-core/src/tools.citations.test.ts
+++ b/extensions/memory-core/src/tools.citations.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover tools.citations plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/memory-core/src/tools.citations.ts b/extensions/memory-core/src/tools.citations.ts
index a1df76e5d492..109096dd9fb8 100644
--- a/extensions/memory-core/src/tools.citations.ts
+++ b/extensions/memory-core/src/tools.citations.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements tools.citations behavior.
 import {
   parseAgentSessionKey,
   type MemoryCitationsMode,
diff --git a/extensions/memory-core/src/tools.recall-tracking.test.ts b/extensions/memory-core/src/tools.recall-tracking.test.ts
index c88671147b59..bd3d34a0a21b 100644
--- a/extensions/memory-core/src/tools.recall-tracking.test.ts
+++ b/extensions/memory-core/src/tools.recall-tracking.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover tools.recall tracking plugin behavior.
 import type { MemorySearchResult } from "openclaw/plugin-sdk/memory-core-host-runtime-files";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../api.js";
diff --git a/extensions/memory-core/src/tools.runtime.ts b/extensions/memory-core/src/tools.runtime.ts
index 9c626b4d0adc..db33f55fa137 100644
--- a/extensions/memory-core/src/tools.runtime.ts
+++ b/extensions/memory-core/src/tools.runtime.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements tools behavior.
 export {
   readAgentMemoryFile,
   resolveMemoryBackendConfig,
diff --git a/extensions/memory-core/src/tools.shared.ts b/extensions/memory-core/src/tools.shared.ts
index 3362ec999112..1d33588bb2ae 100644
--- a/extensions/memory-core/src/tools.shared.ts
+++ b/extensions/memory-core/src/tools.shared.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements tools.shared behavior.
 import { optionalFiniteNumberSchema, stringEnum } from "openclaw/plugin-sdk/channel-actions";
 import {
   listMemoryCorpusSupplements,
diff --git a/extensions/memory-core/src/tools.test-helpers.ts b/extensions/memory-core/src/tools.test-helpers.ts
index 60aa54d934c7..fe8c120864c4 100644
--- a/extensions/memory-core/src/tools.test-helpers.ts
+++ b/extensions/memory-core/src/tools.test-helpers.ts
@@ -1,3 +1,4 @@
+// Memory Core helper module supports tools helpers behavior.
 import { expect } from "vitest";
 import type { OpenClawConfig } from "../api.js";
 import { createMemoryGetTool, createMemorySearchTool } from "./tools.js";
diff --git a/extensions/memory-core/src/tools.test.ts b/extensions/memory-core/src/tools.test.ts
index 1a3345d9c73c..453400d6d27b 100644
--- a/extensions/memory-core/src/tools.test.ts
+++ b/extensions/memory-core/src/tools.test.ts
@@ -1,3 +1,4 @@
+// Memory Core tests cover tools plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   getMemorySearchManagerMockCalls,
diff --git a/extensions/memory-core/src/tools.ts b/extensions/memory-core/src/tools.ts
index f199e7bc5b5e..8c6b8252a936 100644
--- a/extensions/memory-core/src/tools.ts
+++ b/extensions/memory-core/src/tools.ts
@@ -1,3 +1,4 @@
+// Memory Core plugin module implements tools behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type { MemorySource } from "openclaw/plugin-sdk/memory-core-host-engine-storage";
 import {
diff --git a/extensions/qqbot/api.ts b/extensions/qqbot/api.ts
index 0e9e23ae7806..554c82748e4c 100644
--- a/extensions/qqbot/api.ts
+++ b/extensions/qqbot/api.ts
@@ -1,3 +1,4 @@
+// Qqbot API module exposes the plugin public contract.
 export { qqbotPlugin } from "./src/channel.js";
 export { qqbotSetupPlugin } from "./src/channel.setup.js";
 export { getFrameworkCommands } from "./src/engine/commands/slash-commands-impl.js";
diff --git a/extensions/qqbot/channel-plugin-api.ts b/extensions/qqbot/channel-plugin-api.ts
index b8381f8e4c30..547071257dc9 100644
--- a/extensions/qqbot/channel-plugin-api.ts
+++ b/extensions/qqbot/channel-plugin-api.ts
@@ -1 +1,2 @@
+// Qqbot API module exposes the plugin public contract.
 export { qqbotPlugin } from "./src/channel.js";
diff --git a/extensions/qqbot/index.ts b/extensions/qqbot/index.ts
index c9720ba50da6..c642149da3d1 100644
--- a/extensions/qqbot/index.ts
+++ b/extensions/qqbot/index.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin entrypoint registers its OpenClaw integration.
 import {
   defineBundledChannelEntry,
   loadBundledEntryExportSync,
diff --git a/extensions/qqbot/runtime-api.ts b/extensions/qqbot/runtime-api.ts
index db4873803c42..d5bc07091b6d 100644
--- a/extensions/qqbot/runtime-api.ts
+++ b/extensions/qqbot/runtime-api.ts
@@ -1,3 +1,4 @@
+// Qqbot API module exposes the plugin public contract.
 export type { ChannelPlugin, OpenClawPluginApi, PluginRuntime } from "openclaw/plugin-sdk/core";
 export type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 export type {
diff --git a/extensions/qqbot/secret-contract-api.ts b/extensions/qqbot/secret-contract-api.ts
index 9f44ef28569c..0151079c1154 100644
--- a/extensions/qqbot/secret-contract-api.ts
+++ b/extensions/qqbot/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Qqbot API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/qqbot/setup-entry.ts b/extensions/qqbot/setup-entry.ts
index c230e007087f..158c398737c6 100644
--- a/extensions/qqbot/setup-entry.ts
+++ b/extensions/qqbot/setup-entry.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/qqbot/src/bridge/commands/framework-context-adapter.test.ts b/extensions/qqbot/src/bridge/commands/framework-context-adapter.test.ts
index 032785575fe6..fc0a5e99a12e 100644
--- a/extensions/qqbot/src/bridge/commands/framework-context-adapter.test.ts
+++ b/extensions/qqbot/src/bridge/commands/framework-context-adapter.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover framework context adapter plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { PluginCommandContext } from "openclaw/plugin-sdk/plugin-entry";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/qqbot/src/bridge/commands/framework-registration.test.ts b/extensions/qqbot/src/bridge/commands/framework-registration.test.ts
index a8754d68c457..17cac60dba6b 100644
--- a/extensions/qqbot/src/bridge/commands/framework-registration.test.ts
+++ b/extensions/qqbot/src/bridge/commands/framework-registration.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover framework registration plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type {
   OpenClawPluginApi,
diff --git a/extensions/qqbot/src/bridge/commands/from-parser.test.ts b/extensions/qqbot/src/bridge/commands/from-parser.test.ts
index 0e9e5f0f4d5b..65cb4d1b0f53 100644
--- a/extensions/qqbot/src/bridge/commands/from-parser.test.ts
+++ b/extensions/qqbot/src/bridge/commands/from-parser.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover from parser plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseQQBotFrom } from "./from-parser.js";
 
diff --git a/extensions/qqbot/src/bridge/config-shared.ts b/extensions/qqbot/src/bridge/config-shared.ts
index 9634947f7b7d..f4a9d86c5146 100644
--- a/extensions/qqbot/src/bridge/config-shared.ts
+++ b/extensions/qqbot/src/bridge/config-shared.ts
@@ -1,3 +1,4 @@
+// Qqbot helper module supports config shared behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   applyAccountNameToChannelSection,
diff --git a/extensions/qqbot/src/bridge/config.ts b/extensions/qqbot/src/bridge/config.ts
index 2250f08d360c..231624bd4327 100644
--- a/extensions/qqbot/src/bridge/config.ts
+++ b/extensions/qqbot/src/bridge/config.ts
@@ -1,3 +1,4 @@
+// Qqbot helper module supports config behavior.
 import fs from "node:fs";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolveDefaultSecretProviderAlias } from "openclaw/plugin-sdk/provider-auth";
diff --git a/extensions/qqbot/src/bridge/narrowing.ts b/extensions/qqbot/src/bridge/narrowing.ts
index 4f5a690ddc09..e9eadf4adcf4 100644
--- a/extensions/qqbot/src/bridge/narrowing.ts
+++ b/extensions/qqbot/src/bridge/narrowing.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements narrowing behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 import type { GatewayAccount } from "../engine/types.js";
diff --git a/extensions/qqbot/src/bridge/runtime.ts b/extensions/qqbot/src/bridge/runtime.ts
index 8b976a7ba033..1c8f50b6c8df 100644
--- a/extensions/qqbot/src/bridge/runtime.ts
+++ b/extensions/qqbot/src/bridge/runtime.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import type { GatewayPluginRuntime } from "../engine/gateway/types.js";
diff --git a/extensions/qqbot/src/bridge/sdk-adapter.ts b/extensions/qqbot/src/bridge/sdk-adapter.ts
index ee29f11b091b..2e3582767b0e 100644
--- a/extensions/qqbot/src/bridge/sdk-adapter.ts
+++ b/extensions/qqbot/src/bridge/sdk-adapter.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements sdk adapter behavior.
 import { parseAccessGroupAllowFromEntry } from "openclaw/plugin-sdk/access-groups";
 import {
   createChannelIngressResolver,
diff --git a/extensions/qqbot/src/bridge/setup/finalize.ts b/extensions/qqbot/src/bridge/setup/finalize.ts
index 08e46ade7962..8caf6e43de7a 100644
--- a/extensions/qqbot/src/bridge/setup/finalize.ts
+++ b/extensions/qqbot/src/bridge/setup/finalize.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements finalize behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { ChannelSetupWizard } from "openclaw/plugin-sdk/setup";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/setup";
diff --git a/extensions/qqbot/src/bridge/setup/surface.ts b/extensions/qqbot/src/bridge/setup/surface.ts
index aafdbf12ae37..82bbc2740a68 100644
--- a/extensions/qqbot/src/bridge/setup/surface.ts
+++ b/extensions/qqbot/src/bridge/setup/surface.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements surface behavior.
 import {
   createStandardChannelSetupStatus,
   setSetupChannelEnabled,
diff --git a/extensions/qqbot/src/bridge/tools/channel.ts b/extensions/qqbot/src/bridge/tools/channel.ts
index 039bd123be1e..a3630acc9686 100644
--- a/extensions/qqbot/src/bridge/tools/channel.ts
+++ b/extensions/qqbot/src/bridge/tools/channel.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements channel behavior.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import { getAccessToken } from "../../engine/messaging/sender.js";
 import { ChannelApiSchema, executeChannelApi } from "../../engine/tools/channel-api.js";
diff --git a/extensions/qqbot/src/bridge/tools/remind.test.ts b/extensions/qqbot/src/bridge/tools/remind.test.ts
index 289ca103a88e..c3083dca1c65 100644
--- a/extensions/qqbot/src/bridge/tools/remind.test.ts
+++ b/extensions/qqbot/src/bridge/tools/remind.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover remind plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { RemindCronAction } from "../../engine/tools/remind-logic.js";
 
diff --git a/extensions/qqbot/src/bridge/tools/remind.ts b/extensions/qqbot/src/bridge/tools/remind.ts
index ef203a7d817c..3579647efda5 100644
--- a/extensions/qqbot/src/bridge/tools/remind.ts
+++ b/extensions/qqbot/src/bridge/tools/remind.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements remind behavior.
 import { callGatewayTool } from "openclaw/plugin-sdk/agent-harness-runtime";
 import type {
   AnyAgentTool,
diff --git a/extensions/qqbot/src/channel.message-adapter.test.ts b/extensions/qqbot/src/channel.message-adapter.test.ts
index d781c6430ded..27509445e579 100644
--- a/extensions/qqbot/src/channel.message-adapter.test.ts
+++ b/extensions/qqbot/src/channel.message-adapter.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover channel.message adapter plugin behavior.
 import { verifyChannelMessageAdapterCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/qqbot/src/channel.setup.ts b/extensions/qqbot/src/channel.setup.ts
index 01871afbb39e..f33d80ec18d9 100644
--- a/extensions/qqbot/src/channel.setup.ts
+++ b/extensions/qqbot/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements channel.setup behavior.
 import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
 import "./bridge/bootstrap.js";
 import { qqbotConfigAdapter, qqbotMeta, qqbotSetupAdapterShared } from "./bridge/config-shared.js";
diff --git a/extensions/qqbot/src/channel.ts b/extensions/qqbot/src/channel.ts
index 28d447bc8a1a..3df1652f6bae 100644
--- a/extensions/qqbot/src/channel.ts
+++ b/extensions/qqbot/src/channel.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements channel behavior.
 import { getExecApprovalReplyMetadata } from "openclaw/plugin-sdk/approval-runtime";
 import {
   createMessageReceiptFromOutboundResults,
diff --git a/extensions/qqbot/src/config-schema.ts b/extensions/qqbot/src/config-schema.ts
index 28f7553b6b7a..a5e15e04aa0e 100644
--- a/extensions/qqbot/src/config-schema.ts
+++ b/extensions/qqbot/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Qqbot helper module supports config schema behavior.
 import {
   AllowFromListSchema,
   buildChannelConfigSchema,
diff --git a/extensions/qqbot/src/config.test.ts b/extensions/qqbot/src/config.test.ts
index 37a3f355f335..4681cf87075b 100644
--- a/extensions/qqbot/src/config.test.ts
+++ b/extensions/qqbot/src/config.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover config plugin behavior.
 import fs from "node:fs";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/qqbot/src/engine/access/index.ts b/extensions/qqbot/src/engine/access/index.ts
index 5733988c2ae7..c391db87f327 100644
--- a/extensions/qqbot/src/engine/access/index.ts
+++ b/extensions/qqbot/src/engine/access/index.ts
@@ -1,2 +1,3 @@
+// Qqbot plugin entrypoint registers its OpenClaw integration.
 export { createQQBotSenderMatcher, normalizeQQBotAllowFrom } from "./sender-match.js";
 export { type QQBotDmPolicy, type QQBotGroupPolicy } from "./types.js";
diff --git a/extensions/qqbot/src/engine/access/resolve-policy.test.ts b/extensions/qqbot/src/engine/access/resolve-policy.test.ts
index 644d2c999292..4b313b835da4 100644
--- a/extensions/qqbot/src/engine/access/resolve-policy.test.ts
+++ b/extensions/qqbot/src/engine/access/resolve-policy.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover resolve policy plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveQQBotEffectivePolicies } from "./resolve-policy.js";
 
diff --git a/extensions/qqbot/src/engine/access/resolve-policy.ts b/extensions/qqbot/src/engine/access/resolve-policy.ts
index 761f5281f37e..bbdcefaa9049 100644
--- a/extensions/qqbot/src/engine/access/resolve-policy.ts
+++ b/extensions/qqbot/src/engine/access/resolve-policy.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements resolve policy behavior.
 import type { QQBotDmPolicy, QQBotGroupPolicy } from "./types.js";
 
 export interface EffectivePolicyInput {
diff --git a/extensions/qqbot/src/engine/access/sender-match.test.ts b/extensions/qqbot/src/engine/access/sender-match.test.ts
index 4cfa05592c73..b12943cc2689 100644
--- a/extensions/qqbot/src/engine/access/sender-match.test.ts
+++ b/extensions/qqbot/src/engine/access/sender-match.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover sender match plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   createQQBotSenderMatcher,
diff --git a/extensions/qqbot/src/engine/access/types.ts b/extensions/qqbot/src/engine/access/types.ts
index fdc5da4d83a6..d2a61b0910a3 100644
--- a/extensions/qqbot/src/engine/access/types.ts
+++ b/extensions/qqbot/src/engine/access/types.ts
@@ -1,2 +1,3 @@
+// Qqbot type declarations define plugin contracts.
 export type QQBotDmPolicy = "open" | "allowlist" | "disabled";
 export type QQBotGroupPolicy = "open" | "allowlist" | "disabled";
diff --git a/extensions/qqbot/src/engine/adapter/index.ts b/extensions/qqbot/src/engine/adapter/index.ts
index 45014ac3b9ad..fc5ab04e4203 100644
--- a/extensions/qqbot/src/engine/adapter/index.ts
+++ b/extensions/qqbot/src/engine/adapter/index.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin entrypoint registers its OpenClaw integration.
 import type { ResolvedChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
 import type { EffectivePolicyInput } from "../access/resolve-policy.js";
 import type { FetchMediaOptions, FetchMediaResult, SecretInputRef } from "./types.js";
diff --git a/extensions/qqbot/src/engine/api/media-chunked.test.ts b/extensions/qqbot/src/engine/api/media-chunked.test.ts
index e356c12d8878..3d7f7d8a3b4c 100644
--- a/extensions/qqbot/src/engine/api/media-chunked.test.ts
+++ b/extensions/qqbot/src/engine/api/media-chunked.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover media chunked plugin behavior.
 import * as crypto from "node:crypto";
 import * as fs from "node:fs";
 import * as os from "node:os";
diff --git a/extensions/qqbot/src/engine/api/media.test.ts b/extensions/qqbot/src/engine/api/media.test.ts
index c7bb5703ca67..12928c478f72 100644
--- a/extensions/qqbot/src/engine/api/media.test.ts
+++ b/extensions/qqbot/src/engine/api/media.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover media plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { MediaFileType, type UploadMediaResponse } from "../types.js";
 import { MAX_UPLOAD_SIZE } from "../utils/file-utils.js";
diff --git a/extensions/qqbot/src/engine/api/token.test.ts b/extensions/qqbot/src/engine/api/token.test.ts
index 7389fa4c7602..19abf6418ad6 100644
--- a/extensions/qqbot/src/engine/api/token.test.ts
+++ b/extensions/qqbot/src/engine/api/token.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover token plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { TokenManager } from "./token.js";
 
diff --git a/extensions/qqbot/src/engine/approval/index.test.ts b/extensions/qqbot/src/engine/approval/index.test.ts
index 9b6ab01c8b4d..ba773f0598d6 100644
--- a/extensions/qqbot/src/engine/approval/index.test.ts
+++ b/extensions/qqbot/src/engine/approval/index.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover index plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildApprovalKeyboard } from "./index.js";
 
diff --git a/extensions/qqbot/src/engine/commands/builtin/log-helpers.test.ts b/extensions/qqbot/src/engine/commands/builtin/log-helpers.test.ts
index 11fc8bc0f6f9..20a04624d71b 100644
--- a/extensions/qqbot/src/engine/commands/builtin/log-helpers.test.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/log-helpers.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover log helpers plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qqbot/src/engine/commands/builtin/log-helpers.ts b/extensions/qqbot/src/engine/commands/builtin/log-helpers.ts
index 7681c1a76f4c..c59f2159d731 100644
--- a/extensions/qqbot/src/engine/commands/builtin/log-helpers.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/log-helpers.ts
@@ -1,3 +1,4 @@
+// Qqbot helper module supports log helpers behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { loadJsonFile } from "openclaw/plugin-sdk/json-store";
diff --git a/extensions/qqbot/src/engine/commands/builtin/register-all.ts b/extensions/qqbot/src/engine/commands/builtin/register-all.ts
index f3a94b3b5862..d5249733173b 100644
--- a/extensions/qqbot/src/engine/commands/builtin/register-all.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/register-all.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements register all behavior.
 import type { SlashCommandRegistry } from "../slash-commands.js";
 import { registerApproveCommands } from "./register-approve.js";
 import { registerBasicBotCommands } from "./register-basic.js";
diff --git a/extensions/qqbot/src/engine/commands/builtin/register-approve.ts b/extensions/qqbot/src/engine/commands/builtin/register-approve.ts
index 02d874aa95f7..911901d98cf6 100644
--- a/extensions/qqbot/src/engine/commands/builtin/register-approve.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/register-approve.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements register approve behavior.
 import type { ApproveRuntimeGetter } from "../../adapter/commands.port.js";
 import type { SlashCommandRegistry } from "../slash-commands.js";
 import { getApproveRuntimeGetter } from "./state.js";
diff --git a/extensions/qqbot/src/engine/commands/builtin/register-basic.ts b/extensions/qqbot/src/engine/commands/builtin/register-basic.ts
index 6824568d34ee..41342fe8e488 100644
--- a/extensions/qqbot/src/engine/commands/builtin/register-basic.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/register-basic.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements register basic behavior.
 import type { SlashCommandRegistry } from "../slash-commands.js";
 import { getPluginVersionString, resolveRuntimeServiceVersion } from "./state.js";
 
diff --git a/extensions/qqbot/src/engine/commands/builtin/register-clear-storage.ts b/extensions/qqbot/src/engine/commands/builtin/register-clear-storage.ts
index 2bdbdc4aa562..3c545f97b909 100644
--- a/extensions/qqbot/src/engine/commands/builtin/register-clear-storage.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/register-clear-storage.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements register clear storage behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { getQQBotMediaPath } from "../../utils/platform.js";
diff --git a/extensions/qqbot/src/engine/commands/builtin/register-logs.ts b/extensions/qqbot/src/engine/commands/builtin/register-logs.ts
index de1406d8a484..fbca0cd84671 100644
--- a/extensions/qqbot/src/engine/commands/builtin/register-logs.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/register-logs.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements register logs behavior.
 import type { SlashCommandRegistry } from "../slash-commands.js";
 import { buildBotLogsResult } from "./log-helpers.js";
 
diff --git a/extensions/qqbot/src/engine/commands/builtin/register-streaming.ts b/extensions/qqbot/src/engine/commands/builtin/register-streaming.ts
index 21ba895604f9..eba7923183fa 100644
--- a/extensions/qqbot/src/engine/commands/builtin/register-streaming.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/register-streaming.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements register streaming behavior.
 import type { ApproveRuntimeGetter } from "../../adapter/commands.port.js";
 import type { SlashCommandRegistry } from "../slash-commands.js";
 import {
diff --git a/extensions/qqbot/src/engine/commands/builtin/state.ts b/extensions/qqbot/src/engine/commands/builtin/state.ts
index 43bc87de7331..65c5d66cdbf6 100644
--- a/extensions/qqbot/src/engine/commands/builtin/state.ts
+++ b/extensions/qqbot/src/engine/commands/builtin/state.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements state behavior.
 import type { ApproveRuntimeGetter, CommandsPort } from "../../adapter/commands.port.js";
 
 let resolveVersionGetter: () => string = () => "unknown";
diff --git a/extensions/qqbot/src/engine/commands/slash-command-handler.test.ts b/extensions/qqbot/src/engine/commands/slash-command-handler.test.ts
index ba0fdafee2e9..c4a3e4080ab7 100644
--- a/extensions/qqbot/src/engine/commands/slash-command-handler.test.ts
+++ b/extensions/qqbot/src/engine/commands/slash-command-handler.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover slash command handler plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { QueuedMessage } from "../gateway/message-queue.js";
diff --git a/extensions/qqbot/src/engine/commands/slash-command-test-support.ts b/extensions/qqbot/src/engine/commands/slash-command-test-support.ts
index 0073ef7f8347..75b85b9eb3c6 100644
--- a/extensions/qqbot/src/engine/commands/slash-command-test-support.ts
+++ b/extensions/qqbot/src/engine/commands/slash-command-test-support.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements slash command test support behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { CommandsPort } from "../adapter/commands.port.js";
 import { initCommands } from "./slash-commands-impl.js";
diff --git a/extensions/qqbot/src/engine/commands/slash-commands-impl.test.ts b/extensions/qqbot/src/engine/commands/slash-commands-impl.test.ts
index eb285fa10cf5..a2d200adc7ce 100644
--- a/extensions/qqbot/src/engine/commands/slash-commands-impl.test.ts
+++ b/extensions/qqbot/src/engine/commands/slash-commands-impl.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover slash commands impl plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import { resolveQQBotCommandsAllowFrom, resolveSlashCommandAuth } from "./slash-command-auth.js";
diff --git a/extensions/qqbot/src/engine/config/credential-backup.test.ts b/extensions/qqbot/src/engine/config/credential-backup.test.ts
index 5aee71953571..3fc396e26428 100644
--- a/extensions/qqbot/src/engine/config/credential-backup.test.ts
+++ b/extensions/qqbot/src/engine/config/credential-backup.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover credential backup plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qqbot/src/engine/config/group.test.ts b/extensions/qqbot/src/engine/config/group.test.ts
index f4f0b0190c0e..ebd308f366c4 100644
--- a/extensions/qqbot/src/engine/config/group.test.ts
+++ b/extensions/qqbot/src/engine/config/group.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover group plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   DEFAULT_GROUP_HISTORY_LIMIT,
diff --git a/extensions/qqbot/src/engine/config/group.ts b/extensions/qqbot/src/engine/config/group.ts
index c40630a3b947..121429bf5f7e 100644
--- a/extensions/qqbot/src/engine/config/group.ts
+++ b/extensions/qqbot/src/engine/config/group.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements group behavior.
 import { asBoolean } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { asOptionalObjectRecord as asRecord } from "../utils/string-normalize.js";
 import { resolveAccountBase } from "./resolve.js";
diff --git a/extensions/qqbot/src/engine/config/resolve.test.ts b/extensions/qqbot/src/engine/config/resolve.test.ts
index 8c083242c440..8db9402b2a2c 100644
--- a/extensions/qqbot/src/engine/config/resolve.test.ts
+++ b/extensions/qqbot/src/engine/config/resolve.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover resolve plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/qqbot/src/engine/gateway/active-cfg.test.ts b/extensions/qqbot/src/engine/gateway/active-cfg.test.ts
index eadd591f2b32..6412fc312124 100644
--- a/extensions/qqbot/src/engine/gateway/active-cfg.test.ts
+++ b/extensions/qqbot/src/engine/gateway/active-cfg.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover active cfg plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it, vi } from "vitest";
 import { createActiveCfgProvider, resolveActiveCfg, type GatewayCfgLoader } from "./active-cfg.js";
diff --git a/extensions/qqbot/src/engine/gateway/gateway-connection.ts b/extensions/qqbot/src/engine/gateway/gateway-connection.ts
index afa01693db5c..8e607541f1f6 100644
--- a/extensions/qqbot/src/engine/gateway/gateway-connection.ts
+++ b/extensions/qqbot/src/engine/gateway/gateway-connection.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements gateway connection behavior.
 import WebSocket from "ws";
 import type { EngineAdapters } from "../adapter/index.js";
 import {
diff --git a/extensions/qqbot/src/engine/gateway/gateway.ts b/extensions/qqbot/src/engine/gateway/gateway.ts
index 486ee9d7a41a..732d24eeab8a 100644
--- a/extensions/qqbot/src/engine/gateway/gateway.ts
+++ b/extensions/qqbot/src/engine/gateway/gateway.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements gateway behavior.
 import path from "node:path";
 import { initCommands } from "../commands/slash-commands-impl.js";
 import { createNodeSessionStoreReader } from "../group/activation.js";
diff --git a/extensions/qqbot/src/engine/gateway/inbound-attachments.test.ts b/extensions/qqbot/src/engine/gateway/inbound-attachments.test.ts
index 0bb42a603319..970ea535886c 100644
--- a/extensions/qqbot/src/engine/gateway/inbound-attachments.test.ts
+++ b/extensions/qqbot/src/engine/gateway/inbound-attachments.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover inbound attachments plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { processAttachments, type AudioConvertPort } from "./inbound-attachments.js";
 
diff --git a/extensions/qqbot/src/engine/gateway/inbound-attachments.ts b/extensions/qqbot/src/engine/gateway/inbound-attachments.ts
index 1b6734de365f..f52ca842439e 100644
--- a/extensions/qqbot/src/engine/gateway/inbound-attachments.ts
+++ b/extensions/qqbot/src/engine/gateway/inbound-attachments.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements inbound attachments behavior.
 import type { AudioConvertPort } from "../adapter/audio.port.js";
 import { downloadFile } from "../utils/file-utils.js";
 import { getQQBotMediaDir } from "../utils/platform.js";
diff --git a/extensions/qqbot/src/engine/gateway/inbound-context.ts b/extensions/qqbot/src/engine/gateway/inbound-context.ts
index 8c3d86861a61..036616f93373 100644
--- a/extensions/qqbot/src/engine/gateway/inbound-context.ts
+++ b/extensions/qqbot/src/engine/gateway/inbound-context.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements inbound context behavior.
 import type { ChannelIngressDecision } from "openclaw/plugin-sdk/channel-ingress-runtime";
 import type { EngineAdapters } from "../adapter/index.js";
 import type { GroupActivationMode, SessionStoreReader } from "../group/activation.js";
diff --git a/extensions/qqbot/src/engine/gateway/inbound-pipeline.self-echo.test.ts b/extensions/qqbot/src/engine/gateway/inbound-pipeline.self-echo.test.ts
index 2e9d9ea25279..ac6e8969f49f 100644
--- a/extensions/qqbot/src/engine/gateway/inbound-pipeline.self-echo.test.ts
+++ b/extensions/qqbot/src/engine/gateway/inbound-pipeline.self-echo.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover inbound pipeline.self echo plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { QQBotInboundAccess } from "../adapter/index.js";
 import type { RefIndexEntry } from "../ref/types.js";
diff --git a/extensions/qqbot/src/engine/gateway/inbound-pipeline.ts b/extensions/qqbot/src/engine/gateway/inbound-pipeline.ts
index cb57b6f9d573..9965a990e950 100644
--- a/extensions/qqbot/src/engine/gateway/inbound-pipeline.ts
+++ b/extensions/qqbot/src/engine/gateway/inbound-pipeline.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements inbound pipeline behavior.
 import type { HistoryPort } from "../adapter/history.port.js";
 import type { HistoryEntry } from "../group/history.js";
 import { processAttachments } from "./inbound-attachments.js";
diff --git a/extensions/qqbot/src/engine/gateway/interaction-handler.test.ts b/extensions/qqbot/src/engine/gateway/interaction-handler.test.ts
index b31bcbbe93bb..4e125dd57917 100644
--- a/extensions/qqbot/src/engine/gateway/interaction-handler.test.ts
+++ b/extensions/qqbot/src/engine/gateway/interaction-handler.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover interaction handler plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createSdkAccessAdapter } from "../../bridge/sdk-adapter.js";
diff --git a/extensions/qqbot/src/engine/gateway/message-queue.test.ts b/extensions/qqbot/src/engine/gateway/message-queue.test.ts
index 66a513cd4acd..c411d7f5d30f 100644
--- a/extensions/qqbot/src/engine/gateway/message-queue.test.ts
+++ b/extensions/qqbot/src/engine/gateway/message-queue.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover message queue plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createMessageQueue, mergeGroupMessages, type QueuedMessage } from "./message-queue.js";
 
diff --git a/extensions/qqbot/src/engine/gateway/message-queue.ts b/extensions/qqbot/src/engine/gateway/message-queue.ts
index 447bcb78451d..f9989d4f4765 100644
--- a/extensions/qqbot/src/engine/gateway/message-queue.ts
+++ b/extensions/qqbot/src/engine/gateway/message-queue.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements message queue behavior.
 import { formatErrorMessage } from "../utils/format.js";
 
 const DEFAULT_GLOBAL_QUEUE_SIZE = 1000;
diff --git a/extensions/qqbot/src/engine/gateway/outbound-dispatch.test.ts b/extensions/qqbot/src/engine/gateway/outbound-dispatch.test.ts
index 3d26d6263613..84e9c53a2aec 100644
--- a/extensions/qqbot/src/engine/gateway/outbound-dispatch.test.ts
+++ b/extensions/qqbot/src/engine/gateway/outbound-dispatch.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover outbound dispatch plugin behavior.
 import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
 import type { InboundContext } from "./inbound-context.js";
 import { dispatchOutbound } from "./outbound-dispatch.js";
diff --git a/extensions/qqbot/src/engine/gateway/response-timeout.test.ts b/extensions/qqbot/src/engine/gateway/response-timeout.test.ts
index 391018a43fd2..5cfd73917285 100644
--- a/extensions/qqbot/src/engine/gateway/response-timeout.test.ts
+++ b/extensions/qqbot/src/engine/gateway/response-timeout.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover response timeout plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it } from "vitest";
 import { DEFAULT_RESPONSE_TIMEOUT_MS, resolveResponseTimeoutMs } from "./response-timeout.js";
diff --git a/extensions/qqbot/src/engine/gateway/response-timeout.ts b/extensions/qqbot/src/engine/gateway/response-timeout.ts
index a37fa3f699fe..5e3fcb25c46a 100644
--- a/extensions/qqbot/src/engine/gateway/response-timeout.ts
+++ b/extensions/qqbot/src/engine/gateway/response-timeout.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements response timeout behavior.
 import {
   finiteSecondsToTimerSafeMilliseconds,
   MAX_TIMER_TIMEOUT_MS,
diff --git a/extensions/qqbot/src/engine/gateway/stages/access-stage.ts b/extensions/qqbot/src/engine/gateway/stages/access-stage.ts
index fa6f6fcf95b4..88f1762da817 100644
--- a/extensions/qqbot/src/engine/gateway/stages/access-stage.ts
+++ b/extensions/qqbot/src/engine/gateway/stages/access-stage.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements access stage behavior.
 import type { QQBotInboundAccess } from "../../adapter/index.js";
 import type { InboundContext, InboundPipelineDeps } from "../inbound-context.js";
 import type { QueuedMessage } from "../message-queue.js";
diff --git a/extensions/qqbot/src/engine/gateway/stages/content-stage.test.ts b/extensions/qqbot/src/engine/gateway/stages/content-stage.test.ts
index ddb68ed35e85..6ffbf74a7447 100644
--- a/extensions/qqbot/src/engine/gateway/stages/content-stage.test.ts
+++ b/extensions/qqbot/src/engine/gateway/stages/content-stage.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover content stage plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { QueuedMessage } from "../message-queue.js";
 import { buildUserContent } from "./content-stage.js";
diff --git a/extensions/qqbot/src/engine/gateway/stages/envelope-stage.test.ts b/extensions/qqbot/src/engine/gateway/stages/envelope-stage.test.ts
index f1d437876c20..28a32a6fe56c 100644
--- a/extensions/qqbot/src/engine/gateway/stages/envelope-stage.test.ts
+++ b/extensions/qqbot/src/engine/gateway/stages/envelope-stage.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover envelope stage plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { GroupMessageGateResult } from "../../group/message-gating.js";
 import type { ProcessedAttachments } from "../inbound-attachments.js";
diff --git a/extensions/qqbot/src/engine/gateway/stages/group-gate-stage.ts b/extensions/qqbot/src/engine/gateway/stages/group-gate-stage.ts
index 18eacd7fe135..cd3ba00b663f 100644
--- a/extensions/qqbot/src/engine/gateway/stages/group-gate-stage.ts
+++ b/extensions/qqbot/src/engine/gateway/stages/group-gate-stage.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements group gate stage behavior.
 import type { HistoryPort } from "../../adapter/history.port.js";
 import type { QQBotInboundAccess } from "../../adapter/index.js";
 import type { MentionGatePort } from "../../adapter/mention-gate.port.js";
diff --git a/extensions/qqbot/src/engine/gateway/stages/stub-contexts.ts b/extensions/qqbot/src/engine/gateway/stages/stub-contexts.ts
index 8ceade2ad211..f095b2ba9ce5 100644
--- a/extensions/qqbot/src/engine/gateway/stages/stub-contexts.ts
+++ b/extensions/qqbot/src/engine/gateway/stages/stub-contexts.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements stub contexts behavior.
 import type { QQBotInboundAccess } from "../../adapter/index.js";
 import type { InboundContext, InboundGroupInfo } from "../inbound-context.js";
 import type { QueuedMessage } from "../message-queue.js";
diff --git a/extensions/qqbot/src/engine/gateway/types.ts b/extensions/qqbot/src/engine/gateway/types.ts
index f56321e6a9e7..74faba9a1bcf 100644
--- a/extensions/qqbot/src/engine/gateway/types.ts
+++ b/extensions/qqbot/src/engine/gateway/types.ts
@@ -1,3 +1,4 @@
+// Qqbot type declarations define plugin contracts.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
 import type { EngineLogger } from "../types.js";
 export type { EngineLogger };
diff --git a/extensions/qqbot/src/engine/gateway/typing-keepalive.test.ts b/extensions/qqbot/src/engine/gateway/typing-keepalive.test.ts
index 577f30562867..65adae4fe029 100644
--- a/extensions/qqbot/src/engine/gateway/typing-keepalive.test.ts
+++ b/extensions/qqbot/src/engine/gateway/typing-keepalive.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover typing keepalive plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { TypingKeepAlive, TYPING_INPUT_SECOND, TYPING_RENEWAL_LIMIT } from "./typing-keepalive.js";
 
diff --git a/extensions/qqbot/src/engine/gateway/ws-client.test.ts b/extensions/qqbot/src/engine/gateway/ws-client.test.ts
index a9399df0d519..54e8c0b4bbb1 100644
--- a/extensions/qqbot/src/engine/gateway/ws-client.test.ts
+++ b/extensions/qqbot/src/engine/gateway/ws-client.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover ws client plugin behavior.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 const webSocketCtorMock = vi.hoisted(() =>
   vi.fn(function webSocketCtorMockImpl(_url: string, _options?: Record<string, unknown>) {
diff --git a/extensions/qqbot/src/engine/gateway/ws-client.ts b/extensions/qqbot/src/engine/gateway/ws-client.ts
index 6acac162daa8..81b2e510b222 100644
--- a/extensions/qqbot/src/engine/gateway/ws-client.ts
+++ b/extensions/qqbot/src/engine/gateway/ws-client.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements ws client behavior.
 import type { Agent } from "node:http";
 import { resolveAmbientNodeProxyAgent } from "openclaw/plugin-sdk/extension-shared";
 import WebSocket from "ws";
diff --git a/extensions/qqbot/src/engine/group/activation.test.ts b/extensions/qqbot/src/engine/group/activation.test.ts
index 21a37d271bda..b2d6098bcd61 100644
--- a/extensions/qqbot/src/engine/group/activation.test.ts
+++ b/extensions/qqbot/src/engine/group/activation.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover activation plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveGroupActivation, type SessionStoreReader } from "./activation.js";
 
diff --git a/extensions/qqbot/src/engine/group/activation.ts b/extensions/qqbot/src/engine/group/activation.ts
index 9ae946226142..7ddc9477b32a 100644
--- a/extensions/qqbot/src/engine/group/activation.ts
+++ b/extensions/qqbot/src/engine/group/activation.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements activation behavior.
 import fs from "node:fs";
 import path from "node:path";
 
diff --git a/extensions/qqbot/src/engine/group/history.test.ts b/extensions/qqbot/src/engine/group/history.test.ts
index aac4380844fd..2f9fc079a60c 100644
--- a/extensions/qqbot/src/engine/group/history.test.ts
+++ b/extensions/qqbot/src/engine/group/history.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover history plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildMergedMessageContext,
diff --git a/extensions/qqbot/src/engine/group/mention.test.ts b/extensions/qqbot/src/engine/group/mention.test.ts
index c60a1d9a7f66..664ff5d21ea6 100644
--- a/extensions/qqbot/src/engine/group/mention.test.ts
+++ b/extensions/qqbot/src/engine/group/mention.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover mention plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   detectWasMentioned,
diff --git a/extensions/qqbot/src/engine/group/mention.ts b/extensions/qqbot/src/engine/group/mention.ts
index 5bd56fc94cf3..83bd26ffa383 100644
--- a/extensions/qqbot/src/engine/group/mention.ts
+++ b/extensions/qqbot/src/engine/group/mention.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements mention behavior.
 export interface RawMention {
   is_you?: boolean;
   bot?: boolean;
diff --git a/extensions/qqbot/src/engine/group/message-gating.test.ts b/extensions/qqbot/src/engine/group/message-gating.test.ts
index 258a91e17112..20d70ec3a118 100644
--- a/extensions/qqbot/src/engine/group/message-gating.test.ts
+++ b/extensions/qqbot/src/engine/group/message-gating.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover message gating plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveGroupMessageGate,
diff --git a/extensions/qqbot/src/engine/group/message-gating.ts b/extensions/qqbot/src/engine/group/message-gating.ts
index c6eb99ca117c..4d9e2a9ead42 100644
--- a/extensions/qqbot/src/engine/group/message-gating.ts
+++ b/extensions/qqbot/src/engine/group/message-gating.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements message gating behavior.
 type GroupMessageGateAction =
   | "drop_other_mention"
   | "block_unauthorized_command"
diff --git a/extensions/qqbot/src/engine/messaging/decode-media-path.test.ts b/extensions/qqbot/src/engine/messaging/decode-media-path.test.ts
index ff220b5a6e6b..bb81a38dc076 100644
--- a/extensions/qqbot/src/engine/messaging/decode-media-path.test.ts
+++ b/extensions/qqbot/src/engine/messaging/decode-media-path.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover decode media path plugin behavior.
 import { afterEach, describe, expect, it } from "vitest";
 import { decodeMediaPath } from "./decode-media-path.js";
 
diff --git a/extensions/qqbot/src/engine/messaging/outbound-audio-port.ts b/extensions/qqbot/src/engine/messaging/outbound-audio-port.ts
index f25381c88497..0fa9ab930f5a 100644
--- a/extensions/qqbot/src/engine/messaging/outbound-audio-port.ts
+++ b/extensions/qqbot/src/engine/messaging/outbound-audio-port.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements outbound audio port behavior.
 import type { OutboundAudioPort } from "../adapter/audio.port.js";
 
 let outboundAudioPort: OutboundAudioPort | null = null;
diff --git a/extensions/qqbot/src/engine/messaging/outbound-reply.ts b/extensions/qqbot/src/engine/messaging/outbound-reply.ts
index 632846648bfb..61ad03e8fdd2 100644
--- a/extensions/qqbot/src/engine/messaging/outbound-reply.ts
+++ b/extensions/qqbot/src/engine/messaging/outbound-reply.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements outbound reply behavior.
 import { debugLog } from "../utils/log.js";
 import { ReplyLimiter, type ReplyLimitResult } from "./reply-limiter.js";
 
diff --git a/extensions/qqbot/src/engine/messaging/outbound-result-helpers.ts b/extensions/qqbot/src/engine/messaging/outbound-result-helpers.ts
index 442f5bc26a80..4c1ff1b48bd0 100644
--- a/extensions/qqbot/src/engine/messaging/outbound-result-helpers.ts
+++ b/extensions/qqbot/src/engine/messaging/outbound-result-helpers.ts
@@ -1,3 +1,4 @@
+// Qqbot helper module supports outbound result helpers behavior.
 import path from "node:path";
 import { UPLOAD_PREPARE_FALLBACK_CODE } from "../api/retry.js";
 import { MediaFileType } from "../types.js";
diff --git a/extensions/qqbot/src/engine/messaging/outbound-types.ts b/extensions/qqbot/src/engine/messaging/outbound-types.ts
index d577529819d0..f714c9115d48 100644
--- a/extensions/qqbot/src/engine/messaging/outbound-types.ts
+++ b/extensions/qqbot/src/engine/messaging/outbound-types.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements outbound types behavior.
 import type { MessageReceipt } from "openclaw/plugin-sdk/channel-outbound";
 import type { GatewayAccount } from "../types.js";
 
diff --git a/extensions/qqbot/src/engine/ref/format-ref-entry.test.ts b/extensions/qqbot/src/engine/ref/format-ref-entry.test.ts
index 28deb2c3f3cd..4c44cbc8ac88 100644
--- a/extensions/qqbot/src/engine/ref/format-ref-entry.test.ts
+++ b/extensions/qqbot/src/engine/ref/format-ref-entry.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover format ref entry plugin behavior.
 import { describe, expect, it } from "vitest";
 import { formatRefEntryForAgent } from "./format-ref-entry.js";
 import type { RefIndexEntry } from "./types.js";
diff --git a/extensions/qqbot/src/engine/ref/store.test.ts b/extensions/qqbot/src/engine/ref/store.test.ts
index 890ea3bf63af..c70355b1b7b8 100644
--- a/extensions/qqbot/src/engine/ref/store.test.ts
+++ b/extensions/qqbot/src/engine/ref/store.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover store plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qqbot/src/engine/session/known-users.test.ts b/extensions/qqbot/src/engine/session/known-users.test.ts
index a15dc4cbcfa2..7f971590143f 100644
--- a/extensions/qqbot/src/engine/session/known-users.test.ts
+++ b/extensions/qqbot/src/engine/session/known-users.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover known users plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qqbot/src/engine/session/session-store.test.ts b/extensions/qqbot/src/engine/session/session-store.test.ts
index 19626e913892..899b9d5f57b6 100644
--- a/extensions/qqbot/src/engine/session/session-store.test.ts
+++ b/extensions/qqbot/src/engine/session/session-store.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover session store plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qqbot/src/engine/tools/remind-logic.test.ts b/extensions/qqbot/src/engine/tools/remind-logic.test.ts
index a870f7405696..b95fa7629d9d 100644
--- a/extensions/qqbot/src/engine/tools/remind-logic.test.ts
+++ b/extensions/qqbot/src/engine/tools/remind-logic.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover remind logic plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   parseRelativeTime,
diff --git a/extensions/qqbot/src/engine/tools/remind-logic.ts b/extensions/qqbot/src/engine/tools/remind-logic.ts
index bdc79f688126..9e5abb0ad6e7 100644
--- a/extensions/qqbot/src/engine/tools/remind-logic.ts
+++ b/extensions/qqbot/src/engine/tools/remind-logic.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements remind logic behavior.
 import { resolveExpiresAtMsFromDurationMs } from "openclaw/plugin-sdk/number-runtime";
 
 /**
diff --git a/extensions/qqbot/src/engine/utils/attachment-tags.test.ts b/extensions/qqbot/src/engine/utils/attachment-tags.test.ts
index ebe777b1b2e7..fa8129f9454b 100644
--- a/extensions/qqbot/src/engine/utils/attachment-tags.test.ts
+++ b/extensions/qqbot/src/engine/utils/attachment-tags.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover attachment tags plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   formatAttachmentTags,
diff --git a/extensions/qqbot/src/engine/utils/audio.test.ts b/extensions/qqbot/src/engine/utils/audio.test.ts
index 6b25ddd7a22c..a3010f67fb0f 100644
--- a/extensions/qqbot/src/engine/utils/audio.test.ts
+++ b/extensions/qqbot/src/engine/utils/audio.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover audio plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   pcmToWav,
diff --git a/extensions/qqbot/src/engine/utils/data-paths.test.ts b/extensions/qqbot/src/engine/utils/data-paths.test.ts
index a8af948645a6..d5de16f9c010 100644
--- a/extensions/qqbot/src/engine/utils/data-paths.test.ts
+++ b/extensions/qqbot/src/engine/utils/data-paths.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover data paths plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qqbot/src/engine/utils/file-utils.test.ts b/extensions/qqbot/src/engine/utils/file-utils.test.ts
index a7cd900cd247..1cf76cb1a9a3 100644
--- a/extensions/qqbot/src/engine/utils/file-utils.test.ts
+++ b/extensions/qqbot/src/engine/utils/file-utils.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover file utils plugin behavior.
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
diff --git a/extensions/qqbot/src/engine/utils/file-utils.ts b/extensions/qqbot/src/engine/utils/file-utils.ts
index 287d68016c9b..92664d718fdc 100644
--- a/extensions/qqbot/src/engine/utils/file-utils.ts
+++ b/extensions/qqbot/src/engine/utils/file-utils.ts
@@ -1,3 +1,4 @@
+// Qqbot helper module supports file utils behavior.
 import crypto from "node:crypto";
 import * as fs from "node:fs";
 import * as path from "node:path";
diff --git a/extensions/qqbot/src/engine/utils/format.test.ts b/extensions/qqbot/src/engine/utils/format.test.ts
index 452ebc9577c1..df221ce2a270 100644
--- a/extensions/qqbot/src/engine/utils/format.test.ts
+++ b/extensions/qqbot/src/engine/utils/format.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover format plugin behavior.
 import { describe, expect, it } from "vitest";
 import { formatErrorMessage, formatDuration } from "./format.js";
 
diff --git a/extensions/qqbot/src/engine/utils/image-size.test.ts b/extensions/qqbot/src/engine/utils/image-size.test.ts
index 82dd6724ad3a..072cc7e584a0 100644
--- a/extensions/qqbot/src/engine/utils/image-size.test.ts
+++ b/extensions/qqbot/src/engine/utils/image-size.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover image size plugin behavior.
 import { Buffer } from "node:buffer";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/qqbot/src/engine/utils/log.test.ts b/extensions/qqbot/src/engine/utils/log.test.ts
index 09444fb8cc16..adec4d412e2e 100644
--- a/extensions/qqbot/src/engine/utils/log.test.ts
+++ b/extensions/qqbot/src/engine/utils/log.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover log plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { debugLog, sanitizeDebugLogValue } from "./log.js";
 
diff --git a/extensions/qqbot/src/engine/utils/media-tags.test.ts b/extensions/qqbot/src/engine/utils/media-tags.test.ts
index ae76e5013745..48bb148618bc 100644
--- a/extensions/qqbot/src/engine/utils/media-tags.test.ts
+++ b/extensions/qqbot/src/engine/utils/media-tags.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover media tags plugin behavior.
 import { describe, it, expect } from "vitest";
 import { FUZZY_MEDIA_TAG_REGEX, SELF_CLOSING_TAG_REGEX } from "./media-tags.js";
 
diff --git a/extensions/qqbot/src/engine/utils/payload.test.ts b/extensions/qqbot/src/engine/utils/payload.test.ts
index f6096989e8ec..e450269b20c6 100644
--- a/extensions/qqbot/src/engine/utils/payload.test.ts
+++ b/extensions/qqbot/src/engine/utils/payload.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover payload plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   decodeCronPayload,
diff --git a/extensions/qqbot/src/engine/utils/platform-storage-laziness.test.ts b/extensions/qqbot/src/engine/utils/platform-storage-laziness.test.ts
index 60ed8a5ea9fb..7d0e268f647d 100644
--- a/extensions/qqbot/src/engine/utils/platform-storage-laziness.test.ts
+++ b/extensions/qqbot/src/engine/utils/platform-storage-laziness.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover platform storage laziness plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qqbot/src/engine/utils/platform.test.ts b/extensions/qqbot/src/engine/utils/platform.test.ts
index cf59b179665f..81034f6905c3 100644
--- a/extensions/qqbot/src/engine/utils/platform.test.ts
+++ b/extensions/qqbot/src/engine/utils/platform.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover platform plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qqbot/src/engine/utils/sqlite-state.ts b/extensions/qqbot/src/engine/utils/sqlite-state.ts
index 1a1a4e16e8ed..d781aac0082c 100644
--- a/extensions/qqbot/src/engine/utils/sqlite-state.ts
+++ b/extensions/qqbot/src/engine/utils/sqlite-state.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements sqlite state behavior.
 import crypto from "node:crypto";
 import type {
   OpenKeyedStoreOptions,
diff --git a/extensions/qqbot/src/engine/utils/stt.test.ts b/extensions/qqbot/src/engine/utils/stt.test.ts
index 90da09f74032..1452e351b8e4 100644
--- a/extensions/qqbot/src/engine/utils/stt.test.ts
+++ b/extensions/qqbot/src/engine/utils/stt.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover stt plugin behavior.
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
diff --git a/extensions/qqbot/src/engine/utils/text-parsing.test.ts b/extensions/qqbot/src/engine/utils/text-parsing.test.ts
index a48a540c99d9..9168b6a3779b 100644
--- a/extensions/qqbot/src/engine/utils/text-parsing.test.ts
+++ b/extensions/qqbot/src/engine/utils/text-parsing.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover text parsing plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { parseFaceTags } from "./text-parsing.js";
 
diff --git a/extensions/qqbot/src/engine/utils/upload-cache.test.ts b/extensions/qqbot/src/engine/utils/upload-cache.test.ts
index 04ddcc85d58f..7dc951942e73 100644
--- a/extensions/qqbot/src/engine/utils/upload-cache.test.ts
+++ b/extensions/qqbot/src/engine/utils/upload-cache.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover upload cache plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { computeFileHash, getCachedFileInfo, setCachedFileInfo } from "./upload-cache.js";
 
diff --git a/extensions/qqbot/src/exec-approvals.test.ts b/extensions/qqbot/src/exec-approvals.test.ts
index 009ebafd3975..98e1b3e906ea 100644
--- a/extensions/qqbot/src/exec-approvals.test.ts
+++ b/extensions/qqbot/src/exec-approvals.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover exec approvals plugin behavior.
 import { isImplicitSameChatApprovalAuthorization } from "openclaw/plugin-sdk/approval-auth-runtime";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/qqbot/src/exec-approvals.ts b/extensions/qqbot/src/exec-approvals.ts
index d03a06b98a0a..05112f861467 100644
--- a/extensions/qqbot/src/exec-approvals.ts
+++ b/extensions/qqbot/src/exec-approvals.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements exec approvals behavior.
 import {
   markImplicitSameChatApprovalAuthorization,
   resolveApprovalApprovers,
diff --git a/extensions/qqbot/src/manifest-schema.test.ts b/extensions/qqbot/src/manifest-schema.test.ts
index 658383f6af1e..ba6ecde6f608 100644
--- a/extensions/qqbot/src/manifest-schema.test.ts
+++ b/extensions/qqbot/src/manifest-schema.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover manifest schema plugin behavior.
 import fs from "node:fs";
 import { validateJsonSchemaValue } from "openclaw/plugin-sdk/json-schema-runtime";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/qqbot/src/qqbot-test-support.ts b/extensions/qqbot/src/qqbot-test-support.ts
index 9b5b43929438..263d75565e13 100644
--- a/extensions/qqbot/src/qqbot-test-support.ts
+++ b/extensions/qqbot/src/qqbot-test-support.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements qqbot test support behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 
 export function makeQqbotSecretRefConfig(): OpenClawConfig {
diff --git a/extensions/qqbot/src/secret-contract.test.ts b/extensions/qqbot/src/secret-contract.test.ts
index e2a72b00bca6..1728f4e1a1b7 100644
--- a/extensions/qqbot/src/secret-contract.test.ts
+++ b/extensions/qqbot/src/secret-contract.test.ts
@@ -1,3 +1,4 @@
+// Qqbot tests cover secret contract plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   applyResolvedAssignments,
diff --git a/extensions/qqbot/src/secret-contract.ts b/extensions/qqbot/src/secret-contract.ts
index 7d3ae6006c7a..136e30c7036b 100644
--- a/extensions/qqbot/src/secret-contract.ts
+++ b/extensions/qqbot/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements secret contract behavior.
 import {
   collectConditionalChannelFieldAssignments,
   getChannelSurface,
diff --git a/extensions/qqbot/src/test-support/runtime.ts b/extensions/qqbot/src/test-support/runtime.ts
index 26ebaecc4efa..a88bc6f5334b 100644
--- a/extensions/qqbot/src/test-support/runtime.ts
+++ b/extensions/qqbot/src/test-support/runtime.ts
@@ -1,3 +1,4 @@
+// Qqbot plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 import type { OpenKeyedStoreOptions } from "openclaw/plugin-sdk/plugin-state-runtime";
 import {
diff --git a/extensions/qqbot/src/types.ts b/extensions/qqbot/src/types.ts
index 75e0f1b7367c..f68f2ce51d36 100644
--- a/extensions/qqbot/src/types.ts
+++ b/extensions/qqbot/src/types.ts
@@ -1,3 +1,4 @@
+// Qqbot type declarations define plugin contracts.
 import type { SecretInput } from "openclaw/plugin-sdk/secret-input";
 import type { QQBotDmPolicy, QQBotGroupPolicy } from "./engine/access/index.js";
 
diff --git a/extensions/voice-call/cli-metadata.ts b/extensions/voice-call/cli-metadata.ts
index 37a9039e0f85..14b4606c3d80 100644
--- a/extensions/voice-call/cli-metadata.ts
+++ b/extensions/voice-call/cli-metadata.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements cli metadata behavior.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 
 // Lightweight CLI metadata entry for exposing the voicecall command.
diff --git a/extensions/voice-call/doctor-contract-api.test.ts b/extensions/voice-call/doctor-contract-api.test.ts
index 81c4d9f94eb4..497d143cae6c 100644
--- a/extensions/voice-call/doctor-contract-api.test.ts
+++ b/extensions/voice-call/doctor-contract-api.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover doctor contract api plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/voice-call/doctor-contract-api.ts b/extensions/voice-call/doctor-contract-api.ts
index 07d72ba6f9f5..61632d39dc5d 100644
--- a/extensions/voice-call/doctor-contract-api.ts
+++ b/extensions/voice-call/doctor-contract-api.ts
@@ -1,3 +1,4 @@
+// Voice Call API module exposes the plugin public contract.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/voice-call/index.test.ts b/extensions/voice-call/index.test.ts
index 87bd51c04ca3..054d5aa0b514 100644
--- a/extensions/voice-call/index.test.ts
+++ b/extensions/voice-call/index.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover index plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/voice-call/index.ts b/extensions/voice-call/index.ts
index a63eb18d35f7..a675fff1b7f0 100644
--- a/extensions/voice-call/index.ts
+++ b/extensions/voice-call/index.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin entrypoint registers its OpenClaw integration.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { ErrorCodes, errorShape } from "openclaw/plugin-sdk/gateway-runtime";
 import { timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/voice-call/setup-api.ts b/extensions/voice-call/setup-api.ts
index 629e2cdd2391..24a4293505da 100644
--- a/extensions/voice-call/setup-api.ts
+++ b/extensions/voice-call/setup-api.ts
@@ -1,3 +1,4 @@
+// Voice Call API module exposes the plugin public contract.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/voice-call/src/allowlist.test.ts b/extensions/voice-call/src/allowlist.test.ts
index 4b8739812041..981875b24ea2 100644
--- a/extensions/voice-call/src/allowlist.test.ts
+++ b/extensions/voice-call/src/allowlist.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover allowlist plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isAllowlistedCaller, normalizePhoneNumber } from "./allowlist.js";
 
diff --git a/extensions/voice-call/src/bounded-child-output.test.ts b/extensions/voice-call/src/bounded-child-output.test.ts
index 234502e67ac8..8b3d45155f21 100644
--- a/extensions/voice-call/src/bounded-child-output.test.ts
+++ b/extensions/voice-call/src/bounded-child-output.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover bounded child output plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   appendBoundedChildOutput,
diff --git a/extensions/voice-call/src/cli.test.ts b/extensions/voice-call/src/cli.test.ts
index 76d91a77cc68..3215f60f7927 100644
--- a/extensions/voice-call/src/cli.test.ts
+++ b/extensions/voice-call/src/cli.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover cli plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it } from "vitest";
 import { testing } from "./cli.js";
diff --git a/extensions/voice-call/src/cli.ts b/extensions/voice-call/src/cli.ts
index 92fc670c9e43..dfabad569cf1 100644
--- a/extensions/voice-call/src/cli.ts
+++ b/extensions/voice-call/src/cli.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements cli behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/voice-call/src/config-compat.test.ts b/extensions/voice-call/src/config-compat.test.ts
index d5afdc5c2494..fc652fb804c5 100644
--- a/extensions/voice-call/src/config-compat.test.ts
+++ b/extensions/voice-call/src/config-compat.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover config compat plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   VOICE_CALL_LEGACY_CONFIG_REMOVAL_VERSION,
diff --git a/extensions/voice-call/src/config-compat.ts b/extensions/voice-call/src/config-compat.ts
index 090b0be53e3b..3755ab86736c 100644
--- a/extensions/voice-call/src/config-compat.ts
+++ b/extensions/voice-call/src/config-compat.ts
@@ -1,3 +1,4 @@
+// Voice Call helper module supports config compat behavior.
 import { asOptionalRecord, readStringField } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { VoiceCallConfig } from "./config.js";
 import { VoiceCallConfigSchema } from "./config.js";
diff --git a/extensions/voice-call/src/config.test.ts b/extensions/voice-call/src/config.test.ts
index 0f9b271345f3..409a10fc79c6 100644
--- a/extensions/voice-call/src/config.test.ts
+++ b/extensions/voice-call/src/config.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover config plugin behavior.
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 import {
   VoiceCallConfigSchema,
diff --git a/extensions/voice-call/src/config.ts b/extensions/voice-call/src/config.ts
index e4a655ab894a..78f89519e230 100644
--- a/extensions/voice-call/src/config.ts
+++ b/extensions/voice-call/src/config.ts
@@ -1,3 +1,4 @@
+// Voice Call helper module supports config behavior.
 import { REALTIME_VOICE_AGENT_CONSULT_TOOL_POLICIES } from "openclaw/plugin-sdk/realtime-voice";
 import {
   buildSecretInputSchema,
diff --git a/extensions/voice-call/src/core-bridge.ts b/extensions/voice-call/src/core-bridge.ts
index c1c0bc244c48..bcc1d32b40bd 100644
--- a/extensions/voice-call/src/core-bridge.ts
+++ b/extensions/voice-call/src/core-bridge.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements core bridge behavior.
 import type { OpenClawPluginApi } from "../api.js";
 import type { VoiceCallTtsConfig } from "./config.js";
 
diff --git a/extensions/voice-call/src/deep-merge.test.ts b/extensions/voice-call/src/deep-merge.test.ts
index f22656c311e6..d2673ff90969 100644
--- a/extensions/voice-call/src/deep-merge.test.ts
+++ b/extensions/voice-call/src/deep-merge.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover deep merge plugin behavior.
 import { describe, expect, it } from "vitest";
 import { deepMergeDefined } from "./deep-merge.js";
 
diff --git a/extensions/voice-call/src/deep-merge.ts b/extensions/voice-call/src/deep-merge.ts
index f6a76bb301d7..24aa658e8aea 100644
--- a/extensions/voice-call/src/deep-merge.ts
+++ b/extensions/voice-call/src/deep-merge.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements deep merge behavior.
 import { isRecord as isPlainObject } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 // Prototype-safe deep merge for config overrides that ignores undefined values.
diff --git a/extensions/voice-call/src/gateway-continue-operation.test.ts b/extensions/voice-call/src/gateway-continue-operation.test.ts
index bf05da8b39e2..cc17c145dabe 100644
--- a/extensions/voice-call/src/gateway-continue-operation.test.ts
+++ b/extensions/voice-call/src/gateway-continue-operation.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover gateway continue operation plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it } from "vitest";
 import { createVoiceCallContinueOperationStore } from "./gateway-continue-operation.js";
diff --git a/extensions/voice-call/src/gateway-continue-operation.ts b/extensions/voice-call/src/gateway-continue-operation.ts
index 8301c73644a4..626b80e2518e 100644
--- a/extensions/voice-call/src/gateway-continue-operation.ts
+++ b/extensions/voice-call/src/gateway-continue-operation.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements gateway continue operation behavior.
 import { randomUUID } from "node:crypto";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/voice-call/src/http-headers.test.ts b/extensions/voice-call/src/http-headers.test.ts
index 5141d1d27596..7184abcdff15 100644
--- a/extensions/voice-call/src/http-headers.test.ts
+++ b/extensions/voice-call/src/http-headers.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover http headers plugin behavior.
 import { describe, expect, it } from "vitest";
 import { getHeader } from "./http-headers.js";
 
diff --git a/extensions/voice-call/src/http-headers.ts b/extensions/voice-call/src/http-headers.ts
index d3fdafbc229e..ce6ddffe52c5 100644
--- a/extensions/voice-call/src/http-headers.ts
+++ b/extensions/voice-call/src/http-headers.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements http headers behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 // Case-insensitive HTTP header lookup for provider webhook handlers.
diff --git a/extensions/voice-call/src/manager.closed-loop.test.ts b/extensions/voice-call/src/manager.closed-loop.test.ts
index 1aaf2cf09cdf..517da6d4293c 100644
--- a/extensions/voice-call/src/manager.closed-loop.test.ts
+++ b/extensions/voice-call/src/manager.closed-loop.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover manager.closed loop plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createManagerHarness, FakeProvider, markCallAnswered } from "./manager.test-harness.js";
 
diff --git a/extensions/voice-call/src/manager.inbound-allowlist.test.ts b/extensions/voice-call/src/manager.inbound-allowlist.test.ts
index b6c46fba1921..fcf0cd978e9a 100644
--- a/extensions/voice-call/src/manager.inbound-allowlist.test.ts
+++ b/extensions/voice-call/src/manager.inbound-allowlist.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover manager.inbound allowlist plugin behavior.
 import { describe, expect, it } from "vitest";
 import { FakeProvider, createManagerHarness } from "./manager.test-harness.js";
 
diff --git a/extensions/voice-call/src/manager.notify.test.ts b/extensions/voice-call/src/manager.notify.test.ts
index 57d594faeb8d..5b9a419fa198 100644
--- a/extensions/voice-call/src/manager.notify.test.ts
+++ b/extensions/voice-call/src/manager.notify.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover manager.notify plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createManagerHarness, FakeProvider } from "./manager.test-harness.js";
 
diff --git a/extensions/voice-call/src/manager.restore.test.ts b/extensions/voice-call/src/manager.restore.test.ts
index 5b849c724c88..55ac14ab33b9 100644
--- a/extensions/voice-call/src/manager.restore.test.ts
+++ b/extensions/voice-call/src/manager.restore.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover manager.restore plugin behavior.
 import type { OpenKeyedStoreOptions } from "openclaw/plugin-sdk/plugin-state-runtime";
 import {
   createPluginStateSyncKeyedStoreForTests,
diff --git a/extensions/voice-call/src/manager.test-harness.ts b/extensions/voice-call/src/manager.test-harness.ts
index 2248b33f9b27..fe608f7cb0fd 100644
--- a/extensions/voice-call/src/manager.test-harness.ts
+++ b/extensions/voice-call/src/manager.test-harness.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements manager harness behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/voice-call/src/manager.ts b/extensions/voice-call/src/manager.ts
index d332aee401b2..7e296e1bf4af 100644
--- a/extensions/voice-call/src/manager.ts
+++ b/extensions/voice-call/src/manager.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements manager behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/voice-call/src/manager/context.ts b/extensions/voice-call/src/manager/context.ts
index 757531761d2f..46a5aaf575df 100644
--- a/extensions/voice-call/src/manager/context.ts
+++ b/extensions/voice-call/src/manager/context.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements context behavior.
 import type { VoiceCallConfig } from "../config.js";
 import type { VoiceCallProvider } from "../providers/base.js";
 import type { CallId, CallRecord } from "../types.js";
diff --git a/extensions/voice-call/src/manager/events.test.ts b/extensions/voice-call/src/manager/events.test.ts
index 801327287768..6eacdba6f84a 100644
--- a/extensions/voice-call/src/manager/events.test.ts
+++ b/extensions/voice-call/src/manager/events.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover events plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/voice-call/src/manager/events.ts b/extensions/voice-call/src/manager/events.ts
index 30661ec65898..2706b2adc0d2 100644
--- a/extensions/voice-call/src/manager/events.ts
+++ b/extensions/voice-call/src/manager/events.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements events behavior.
 import crypto from "node:crypto";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { isAllowlistedCaller, normalizePhoneNumber } from "../allowlist.js";
diff --git a/extensions/voice-call/src/manager/lifecycle.ts b/extensions/voice-call/src/manager/lifecycle.ts
index 952c0ccb54ad..662d25100ac8 100644
--- a/extensions/voice-call/src/manager/lifecycle.ts
+++ b/extensions/voice-call/src/manager/lifecycle.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements lifecycle behavior.
 import type { CallRecord, EndReason } from "../types.js";
 import type { CallManagerContext } from "./context.js";
 import { transitionState } from "./state.js";
diff --git a/extensions/voice-call/src/manager/lookup.test.ts b/extensions/voice-call/src/manager/lookup.test.ts
index f3591ba0a002..f34c4345e084 100644
--- a/extensions/voice-call/src/manager/lookup.test.ts
+++ b/extensions/voice-call/src/manager/lookup.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover lookup plugin behavior.
 import { describe, expect, it } from "vitest";
 import { findCall, getCallByProviderCallId } from "./lookup.js";
 
diff --git a/extensions/voice-call/src/manager/lookup.ts b/extensions/voice-call/src/manager/lookup.ts
index deefac593ba8..eba6db751c87 100644
--- a/extensions/voice-call/src/manager/lookup.ts
+++ b/extensions/voice-call/src/manager/lookup.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements lookup behavior.
 import type { CallId, CallRecord } from "../types.js";
 
 // Lookup helpers for active calls by internal or provider call ids.
diff --git a/extensions/voice-call/src/manager/outbound.test.ts b/extensions/voice-call/src/manager/outbound.test.ts
index 231486feba60..490699537b25 100644
--- a/extensions/voice-call/src/manager/outbound.test.ts
+++ b/extensions/voice-call/src/manager/outbound.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover outbound plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/voice-call/src/manager/outbound.ts b/extensions/voice-call/src/manager/outbound.ts
index 6d53290f973e..68d3ae50e25a 100644
--- a/extensions/voice-call/src/manager/outbound.ts
+++ b/extensions/voice-call/src/manager/outbound.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements outbound behavior.
 import crypto from "node:crypto";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import {
diff --git a/extensions/voice-call/src/manager/state.ts b/extensions/voice-call/src/manager/state.ts
index f95c0468c411..2691709eae0d 100644
--- a/extensions/voice-call/src/manager/state.ts
+++ b/extensions/voice-call/src/manager/state.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements state behavior.
 import { TerminalStates, type CallRecord, type CallState, type TranscriptEntry } from "../types.js";
 
 const ConversationStates = new Set<CallState>(["speaking", "listening"]);
diff --git a/extensions/voice-call/src/manager/store.test.ts b/extensions/voice-call/src/manager/store.test.ts
index c7a308b60943..ba24f00fff85 100644
--- a/extensions/voice-call/src/manager/store.test.ts
+++ b/extensions/voice-call/src/manager/store.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover store plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import type { OpenKeyedStoreOptions } from "openclaw/plugin-sdk/plugin-state-runtime";
diff --git a/extensions/voice-call/src/manager/store.ts b/extensions/voice-call/src/manager/store.ts
index 695260a4601c..abe5fd3e2e00 100644
--- a/extensions/voice-call/src/manager/store.ts
+++ b/extensions/voice-call/src/manager/store.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements store behavior.
 import { createHash, randomUUID } from "node:crypto";
 import path from "node:path";
 import type { PluginStateSyncKeyedStore } from "openclaw/plugin-sdk/plugin-state-runtime";
diff --git a/extensions/voice-call/src/manager/timer-delays.test.ts b/extensions/voice-call/src/manager/timer-delays.test.ts
index 3b6de3268e69..4c257c309d0e 100644
--- a/extensions/voice-call/src/manager/timer-delays.test.ts
+++ b/extensions/voice-call/src/manager/timer-delays.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover timer delays plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/voice-call/src/manager/timer-delays.ts b/extensions/voice-call/src/manager/timer-delays.ts
index fe0b536e75a2..cd947afa23eb 100644
--- a/extensions/voice-call/src/manager/timer-delays.ts
+++ b/extensions/voice-call/src/manager/timer-delays.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements timer delays behavior.
 import { MAX_TIMER_TIMEOUT_MS, resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 
 // Timer delay normalization helpers for voice-call lifecycle timers.
diff --git a/extensions/voice-call/src/manager/timers.test.ts b/extensions/voice-call/src/manager/timers.test.ts
index 5a7d250a0996..a9222e46d8e2 100644
--- a/extensions/voice-call/src/manager/timers.test.ts
+++ b/extensions/voice-call/src/manager/timers.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover timers plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/voice-call/src/manager/timers.ts b/extensions/voice-call/src/manager/timers.ts
index 3c02516de7e0..acc9ba79a9ed 100644
--- a/extensions/voice-call/src/manager/timers.ts
+++ b/extensions/voice-call/src/manager/timers.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements timers behavior.
 import { TerminalStates, type CallId } from "../types.js";
 import type { CallManagerContext } from "./context.js";
 import { persistCallRecord } from "./store.js";
diff --git a/extensions/voice-call/src/manager/twiml.test.ts b/extensions/voice-call/src/manager/twiml.test.ts
index a70ce1e657b2..b960bb736218 100644
--- a/extensions/voice-call/src/manager/twiml.test.ts
+++ b/extensions/voice-call/src/manager/twiml.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover twiml plugin behavior.
 import { describe, expect, it } from "vitest";
 import { generateNotifyTwiml } from "./twiml.js";
 
diff --git a/extensions/voice-call/src/manager/twiml.ts b/extensions/voice-call/src/manager/twiml.ts
index 9365ae202589..f7f671aaecc4 100644
--- a/extensions/voice-call/src/manager/twiml.ts
+++ b/extensions/voice-call/src/manager/twiml.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements twiml behavior.
 import { escapeXml } from "../voice-mapping.js";
 
 // TwiML builders for manager-initiated notify and DTMF redirect flows.
diff --git a/extensions/voice-call/src/media-stream.test.ts b/extensions/voice-call/src/media-stream.test.ts
index ff59c8ba92d2..395140b9e83f 100644
--- a/extensions/voice-call/src/media-stream.test.ts
+++ b/extensions/voice-call/src/media-stream.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover media stream plugin behavior.
 import type { IncomingMessage } from "node:http";
 import net from "node:net";
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/voice-call/src/providers/base.ts b/extensions/voice-call/src/providers/base.ts
index 066b3abfcd33..8c7a6bd5366e 100644
--- a/extensions/voice-call/src/providers/base.ts
+++ b/extensions/voice-call/src/providers/base.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements base behavior.
 import type {
   AnswerCallInput,
   GetCallStatusInput,
diff --git a/extensions/voice-call/src/providers/mock.test.ts b/extensions/voice-call/src/providers/mock.test.ts
index e4aca76c6fb3..d83ff74c9212 100644
--- a/extensions/voice-call/src/providers/mock.test.ts
+++ b/extensions/voice-call/src/providers/mock.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover mock plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { WebhookContext } from "../types.js";
 import { MockProvider } from "./mock.js";
diff --git a/extensions/voice-call/src/providers/mock.ts b/extensions/voice-call/src/providers/mock.ts
index 8b0d8870ccb3..3b9c3ef03908 100644
--- a/extensions/voice-call/src/providers/mock.ts
+++ b/extensions/voice-call/src/providers/mock.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements mock behavior.
 import crypto from "node:crypto";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type {
diff --git a/extensions/voice-call/src/providers/plivo.test.ts b/extensions/voice-call/src/providers/plivo.test.ts
index a378f4b8f283..3b7b4748b66e 100644
--- a/extensions/voice-call/src/providers/plivo.test.ts
+++ b/extensions/voice-call/src/providers/plivo.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover plivo plugin behavior.
 import { describe, expect, it } from "vitest";
 import { PlivoProvider } from "./plivo.js";
 
diff --git a/extensions/voice-call/src/providers/plivo.ts b/extensions/voice-call/src/providers/plivo.ts
index 0e38caf2d7f5..e307869aa271 100644
--- a/extensions/voice-call/src/providers/plivo.ts
+++ b/extensions/voice-call/src/providers/plivo.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements plivo behavior.
 import crypto from "node:crypto";
 import {
   normalizeLowercaseStringOrEmpty,
diff --git a/extensions/voice-call/src/providers/shared/call-status.test.ts b/extensions/voice-call/src/providers/shared/call-status.test.ts
index 8bce2b2b3602..ca4e6d293d49 100644
--- a/extensions/voice-call/src/providers/shared/call-status.test.ts
+++ b/extensions/voice-call/src/providers/shared/call-status.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover call status plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   isProviderStatusTerminal,
diff --git a/extensions/voice-call/src/providers/shared/call-status.ts b/extensions/voice-call/src/providers/shared/call-status.ts
index 4d386aec9da0..40a23331e993 100644
--- a/extensions/voice-call/src/providers/shared/call-status.ts
+++ b/extensions/voice-call/src/providers/shared/call-status.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements call status behavior.
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { EndReason } from "../../types.js";
 
diff --git a/extensions/voice-call/src/providers/shared/guarded-json-api.test.ts b/extensions/voice-call/src/providers/shared/guarded-json-api.test.ts
index cb638389d27d..e94b876f2e9f 100644
--- a/extensions/voice-call/src/providers/shared/guarded-json-api.test.ts
+++ b/extensions/voice-call/src/providers/shared/guarded-json-api.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover guarded json api plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { fetchWithSsrFGuardMock } = vi.hoisted(() => ({
diff --git a/extensions/voice-call/src/providers/shared/guarded-json-api.ts b/extensions/voice-call/src/providers/shared/guarded-json-api.ts
index fd29aefe320b..12d7f4e0477c 100644
--- a/extensions/voice-call/src/providers/shared/guarded-json-api.ts
+++ b/extensions/voice-call/src/providers/shared/guarded-json-api.ts
@@ -1,3 +1,4 @@
+// Voice Call API module exposes the plugin public contract.
 import { fetchWithSsrFGuard } from "../../../api.js";
 
 // Shared guarded JSON API client for voice-call providers.
diff --git a/extensions/voice-call/src/providers/telnyx.test.ts b/extensions/voice-call/src/providers/telnyx.test.ts
index 52085f610681..a302f1953a47 100644
--- a/extensions/voice-call/src/providers/telnyx.test.ts
+++ b/extensions/voice-call/src/providers/telnyx.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover telnyx plugin behavior.
 import crypto from "node:crypto";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { WebhookContext } from "../types.js";
diff --git a/extensions/voice-call/src/providers/telnyx.ts b/extensions/voice-call/src/providers/telnyx.ts
index 6d9db2e28662..f7c140d2fb0f 100644
--- a/extensions/voice-call/src/providers/telnyx.ts
+++ b/extensions/voice-call/src/providers/telnyx.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements telnyx behavior.
 import crypto from "node:crypto";
 import type { TelnyxConfig } from "../config.js";
 import type {
diff --git a/extensions/voice-call/src/providers/twilio.test.ts b/extensions/voice-call/src/providers/twilio.test.ts
index 5ff42f51aed5..188a5feeabd3 100644
--- a/extensions/voice-call/src/providers/twilio.test.ts
+++ b/extensions/voice-call/src/providers/twilio.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover twilio plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { WebhookContext } from "../types.js";
 import { TwilioProvider } from "./twilio.js";
diff --git a/extensions/voice-call/src/providers/twilio.ts b/extensions/voice-call/src/providers/twilio.ts
index 45990c9c1b98..c91381f60be4 100644
--- a/extensions/voice-call/src/providers/twilio.ts
+++ b/extensions/voice-call/src/providers/twilio.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements twilio behavior.
 import crypto from "node:crypto";
 import { setTimeout as sleep } from "node:timers/promises";
 import { safeEqualSecret } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/voice-call/src/providers/twilio.types.ts b/extensions/voice-call/src/providers/twilio.types.ts
index 73a9570c5cbb..9b35893d3fd7 100644
--- a/extensions/voice-call/src/providers/twilio.types.ts
+++ b/extensions/voice-call/src/providers/twilio.types.ts
@@ -1,3 +1,4 @@
+// Voice Call type declarations define plugin contracts.
 import type { WebhookSecurityConfig } from "../config.js";
 
 /**
diff --git a/extensions/voice-call/src/providers/twilio/api.test.ts b/extensions/voice-call/src/providers/twilio/api.test.ts
index d3251daa71a8..506d085cbe4d 100644
--- a/extensions/voice-call/src/providers/twilio/api.test.ts
+++ b/extensions/voice-call/src/providers/twilio/api.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover api plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const { fetchWithSsrFGuardMock } = vi.hoisted(() => ({
diff --git a/extensions/voice-call/src/providers/twilio/api.ts b/extensions/voice-call/src/providers/twilio/api.ts
index b2a2155c2ea3..407cd8cefdac 100644
--- a/extensions/voice-call/src/providers/twilio/api.ts
+++ b/extensions/voice-call/src/providers/twilio/api.ts
@@ -1,3 +1,4 @@
+// Voice Call API module exposes the plugin public contract.
 import { fetchWithSsrFGuard } from "../../../api.js";
 
 // Guarded Twilio REST API client helpers.
diff --git a/extensions/voice-call/src/providers/twilio/twiml-policy.test.ts b/extensions/voice-call/src/providers/twilio/twiml-policy.test.ts
index eb8d69b4cb18..5b3f05db07e4 100644
--- a/extensions/voice-call/src/providers/twilio/twiml-policy.test.ts
+++ b/extensions/voice-call/src/providers/twilio/twiml-policy.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover twiml policy plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { WebhookContext } from "../../types.js";
 import { decideTwimlResponse, readTwimlRequestView } from "./twiml-policy.js";
diff --git a/extensions/voice-call/src/providers/twilio/twiml-policy.ts b/extensions/voice-call/src/providers/twilio/twiml-policy.ts
index ca9d1002989b..46d797dde1a7 100644
--- a/extensions/voice-call/src/providers/twilio/twiml-policy.ts
+++ b/extensions/voice-call/src/providers/twilio/twiml-policy.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements twiml policy behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { WebhookContext } from "../../types.js";
 
diff --git a/extensions/voice-call/src/providers/twilio/webhook.ts b/extensions/voice-call/src/providers/twilio/webhook.ts
index 487f2cbe27ef..8306d85f83f0 100644
--- a/extensions/voice-call/src/providers/twilio/webhook.ts
+++ b/extensions/voice-call/src/providers/twilio/webhook.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements webhook behavior.
 import type { WebhookContext, WebhookVerificationResult } from "../../types.js";
 import { verifyTwilioWebhook } from "../../webhook-security.js";
 import type { TwilioProviderOptions } from "../twilio.types.js";
diff --git a/extensions/voice-call/src/realtime-agent-context.test.ts b/extensions/voice-call/src/realtime-agent-context.test.ts
index 85878473aad4..94a42ef31e00 100644
--- a/extensions/voice-call/src/realtime-agent-context.test.ts
+++ b/extensions/voice-call/src/realtime-agent-context.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover realtime agent context plugin behavior.
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/voice-call/src/realtime-agent-context.ts b/extensions/voice-call/src/realtime-agent-context.ts
index 692e9abdeb91..2558a922ea14 100644
--- a/extensions/voice-call/src/realtime-agent-context.ts
+++ b/extensions/voice-call/src/realtime-agent-context.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements realtime agent context behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { buildRealtimeVoiceAgentConsultPolicyInstructions } from "openclaw/plugin-sdk/realtime-voice";
 import { root } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/voice-call/src/realtime-defaults.ts b/extensions/voice-call/src/realtime-defaults.ts
index 01a5bda15020..0f784c48543e 100644
--- a/extensions/voice-call/src/realtime-defaults.ts
+++ b/extensions/voice-call/src/realtime-defaults.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements realtime defaults behavior.
 import { REALTIME_VOICE_AGENT_CONSULT_TOOL_NAME } from "openclaw/plugin-sdk/realtime-voice";
 
 // Default realtime instructions for the voice-call plugin's phone interface.
diff --git a/extensions/voice-call/src/realtime-fast-context.test.ts b/extensions/voice-call/src/realtime-fast-context.test.ts
index e1ae2390a884..fb5a72d2dd1d 100644
--- a/extensions/voice-call/src/realtime-fast-context.test.ts
+++ b/extensions/voice-call/src/realtime-fast-context.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover realtime fast context plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { VoiceCallRealtimeFastContextConfig } from "./config.js";
diff --git a/extensions/voice-call/src/realtime-fast-context.ts b/extensions/voice-call/src/realtime-fast-context.ts
index 14bc0bc33d31..87d22cb21226 100644
--- a/extensions/voice-call/src/realtime-fast-context.ts
+++ b/extensions/voice-call/src/realtime-fast-context.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements realtime fast context behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   resolveRealtimeVoiceFastContextConsult,
diff --git a/extensions/voice-call/src/response-generator.test.ts b/extensions/voice-call/src/response-generator.test.ts
index 226fab769d9c..56d79503f262 100644
--- a/extensions/voice-call/src/response-generator.test.ts
+++ b/extensions/voice-call/src/response-generator.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover response generator plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { VoiceCallConfigSchema } from "./config.js";
 import type { CoreAgentDeps, CoreConfig } from "./core-bridge.js";
diff --git a/extensions/voice-call/src/response-model.test.ts b/extensions/voice-call/src/response-model.test.ts
index e614bb5d07aa..c6f4400d7975 100644
--- a/extensions/voice-call/src/response-model.test.ts
+++ b/extensions/voice-call/src/response-model.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover response model plugin behavior.
 import { describe, expect, it } from "vitest";
 import { VoiceCallConfigSchema } from "./config.js";
 import type { CoreAgentDeps } from "./core-bridge.js";
diff --git a/extensions/voice-call/src/response-model.ts b/extensions/voice-call/src/response-model.ts
index 28fdd5d39729..90b6172c8597 100644
--- a/extensions/voice-call/src/response-model.ts
+++ b/extensions/voice-call/src/response-model.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements response model behavior.
 import type { VoiceCallConfig } from "./config.js";
 import type { CoreAgentDeps } from "./core-bridge.js";
 
diff --git a/extensions/voice-call/src/runtime-state.ts b/extensions/voice-call/src/runtime-state.ts
index 7e2748e66b09..ceed1a6e65c8 100644
--- a/extensions/voice-call/src/runtime-state.ts
+++ b/extensions/voice-call/src/runtime-state.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements runtime state behavior.
 import { createPluginRuntimeStore, type PluginRuntime } from "openclaw/plugin-sdk/runtime-store";
 
 // Process-local runtime store used by voice-call persistence helpers.
diff --git a/extensions/voice-call/src/runtime.test.ts b/extensions/voice-call/src/runtime.test.ts
index 91b463bce3bc..0bdb2874ff06 100644
--- a/extensions/voice-call/src/runtime.test.ts
+++ b/extensions/voice-call/src/runtime.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover runtime plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { VoiceCallConfig } from "./config.js";
diff --git a/extensions/voice-call/src/runtime.ts b/extensions/voice-call/src/runtime.ts
index 8ae8b32c82e3..8117b739c098 100644
--- a/extensions/voice-call/src/runtime.ts
+++ b/extensions/voice-call/src/runtime.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements runtime behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { isLoopbackHost } from "openclaw/plugin-sdk/gateway-runtime";
diff --git a/extensions/voice-call/src/telephony-audio.test.ts b/extensions/voice-call/src/telephony-audio.test.ts
index f9ec5448661f..8bd7208427d5 100644
--- a/extensions/voice-call/src/telephony-audio.test.ts
+++ b/extensions/voice-call/src/telephony-audio.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover telephony audio plugin behavior.
 import { describe, expect, it } from "vitest";
 import { convertPcmToMulaw8k, resamplePcmTo8k } from "./telephony-audio.js";
 
diff --git a/extensions/voice-call/src/telephony-audio.ts b/extensions/voice-call/src/telephony-audio.ts
index c6820854b85f..d6101cedf3e8 100644
--- a/extensions/voice-call/src/telephony-audio.ts
+++ b/extensions/voice-call/src/telephony-audio.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements telephony audio behavior.
 export { convertPcmToMulaw8k, resamplePcmTo8k } from "openclaw/plugin-sdk/realtime-voice";
 
 /**
diff --git a/extensions/voice-call/src/telephony-tts.test.ts b/extensions/voice-call/src/telephony-tts.test.ts
index 75313b6ff4dd..02d85c93920a 100644
--- a/extensions/voice-call/src/telephony-tts.test.ts
+++ b/extensions/voice-call/src/telephony-tts.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover telephony tts plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { VoiceCallTtsConfig } from "./config.js";
diff --git a/extensions/voice-call/src/telephony-tts.ts b/extensions/voice-call/src/telephony-tts.ts
index 7ec2d00f976f..7f296e535c8d 100644
--- a/extensions/voice-call/src/telephony-tts.ts
+++ b/extensions/voice-call/src/telephony-tts.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements telephony tts behavior.
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import {
   parseTtsDirectives,
diff --git a/extensions/voice-call/src/test-fixtures.ts b/extensions/voice-call/src/test-fixtures.ts
index 0fa7f95f7ca7..265499aeb66b 100644
--- a/extensions/voice-call/src/test-fixtures.ts
+++ b/extensions/voice-call/src/test-fixtures.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements test fixtures behavior.
 import type { VoiceCallConfig } from "./config.js";
 import { DEFAULT_VOICE_CALL_REALTIME_INSTRUCTIONS } from "./realtime-defaults.js";
 
diff --git a/extensions/voice-call/src/tts-provider-voice.test.ts b/extensions/voice-call/src/tts-provider-voice.test.ts
index ea709c9e63d4..8a20b50e8ced 100644
--- a/extensions/voice-call/src/tts-provider-voice.test.ts
+++ b/extensions/voice-call/src/tts-provider-voice.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover tts provider voice plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolvePreferredTtsVoice } from "./tts-provider-voice.js";
 
diff --git a/extensions/voice-call/src/tts-provider-voice.ts b/extensions/voice-call/src/tts-provider-voice.ts
index 45a7e0f44af8..2017cc7b26d0 100644
--- a/extensions/voice-call/src/tts-provider-voice.ts
+++ b/extensions/voice-call/src/tts-provider-voice.ts
@@ -1,3 +1,4 @@
+// Voice Call provider module implements model/runtime integration.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { VoiceCallTtsConfig } from "./config.js";
 
diff --git a/extensions/voice-call/src/tunnel.test.ts b/extensions/voice-call/src/tunnel.test.ts
index f2d2d1c14fd9..4ca89083475b 100644
--- a/extensions/voice-call/src/tunnel.test.ts
+++ b/extensions/voice-call/src/tunnel.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover tunnel plugin behavior.
 import { EventEmitter } from "node:events";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/voice-call/src/tunnel.ts b/extensions/voice-call/src/tunnel.ts
index 4e875fc468b0..68a20005747e 100644
--- a/extensions/voice-call/src/tunnel.ts
+++ b/extensions/voice-call/src/tunnel.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements tunnel behavior.
 import { spawn } from "node:child_process";
 import {
   appendBoundedChildOutput,
diff --git a/extensions/voice-call/src/types.ts b/extensions/voice-call/src/types.ts
index 89d89cff7c93..5e4e167d1c38 100644
--- a/extensions/voice-call/src/types.ts
+++ b/extensions/voice-call/src/types.ts
@@ -1,3 +1,4 @@
+// Voice Call type declarations define plugin contracts.
 import { z } from "zod";
 import type { CallMode } from "./config.js";
 
diff --git a/extensions/voice-call/src/utils.test.ts b/extensions/voice-call/src/utils.test.ts
index e926066b85d8..2182598c8ff0 100644
--- a/extensions/voice-call/src/utils.test.ts
+++ b/extensions/voice-call/src/utils.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover utils plugin behavior.
 import os from "node:os";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/voice-call/src/utils.ts b/extensions/voice-call/src/utils.ts
index a694a43bc74b..62c479d0526a 100644
--- a/extensions/voice-call/src/utils.ts
+++ b/extensions/voice-call/src/utils.ts
@@ -1,3 +1,4 @@
+// Voice Call helper module supports utils behavior.
 import os from "node:os";
 import path from "node:path";
 
diff --git a/extensions/voice-call/src/voice-mapping.test.ts b/extensions/voice-call/src/voice-mapping.test.ts
index ef4b24d6a6d8..26fc14461f4a 100644
--- a/extensions/voice-call/src/voice-mapping.test.ts
+++ b/extensions/voice-call/src/voice-mapping.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover voice mapping plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   DEFAULT_POLLY_VOICE,
diff --git a/extensions/voice-call/src/voice-mapping.ts b/extensions/voice-call/src/voice-mapping.ts
index d0db8a2962ae..7712a9a91a6c 100644
--- a/extensions/voice-call/src/voice-mapping.ts
+++ b/extensions/voice-call/src/voice-mapping.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements voice mapping behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 /**
diff --git a/extensions/voice-call/src/webhook-exposure.test.ts b/extensions/voice-call/src/webhook-exposure.test.ts
index f96c76d4466f..2ede2df3822c 100644
--- a/extensions/voice-call/src/webhook-exposure.test.ts
+++ b/extensions/voice-call/src/webhook-exposure.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover webhook exposure plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isLocalOnlyWebhookHost, isProviderUnreachableWebhookUrl } from "./webhook-exposure.js";
 
diff --git a/extensions/voice-call/src/webhook-exposure.ts b/extensions/voice-call/src/webhook-exposure.ts
index 3dc9d7e10465..e60003f9b273 100644
--- a/extensions/voice-call/src/webhook-exposure.ts
+++ b/extensions/voice-call/src/webhook-exposure.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements webhook exposure behavior.
 import { isBlockedHostnameOrIp } from "../api.js";
 
 // Webhook exposure checks for providers that must reach local voice-call webhooks.
diff --git a/extensions/voice-call/src/webhook-security.test.ts b/extensions/voice-call/src/webhook-security.test.ts
index fc62439353c3..85f4091ece78 100644
--- a/extensions/voice-call/src/webhook-security.test.ts
+++ b/extensions/voice-call/src/webhook-security.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover webhook security plugin behavior.
 import crypto from "node:crypto";
 import { MAX_DATE_TIMESTAMP_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/voice-call/src/webhook-security.ts b/extensions/voice-call/src/webhook-security.ts
index f8c8d7d1a761..07ff69d15edc 100644
--- a/extensions/voice-call/src/webhook-security.ts
+++ b/extensions/voice-call/src/webhook-security.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements webhook security behavior.
 import crypto from "node:crypto";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { isLoopbackHost } from "openclaw/plugin-sdk/gateway-runtime";
diff --git a/extensions/voice-call/src/webhook.hangup-once.lifecycle.test.ts b/extensions/voice-call/src/webhook.hangup-once.lifecycle.test.ts
index 5c809694dd5a..8af1c66484e8 100644
--- a/extensions/voice-call/src/webhook.hangup-once.lifecycle.test.ts
+++ b/extensions/voice-call/src/webhook.hangup-once.lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover webhook.hangup once.lifecycle plugin behavior.
 import type { OpenKeyedStoreOptions } from "openclaw/plugin-sdk/plugin-state-runtime";
 import {
   createPluginStateSyncKeyedStoreForTests,
diff --git a/extensions/voice-call/src/webhook.test.ts b/extensions/voice-call/src/webhook.test.ts
index af6d6e583137..a20315d6aa9e 100644
--- a/extensions/voice-call/src/webhook.test.ts
+++ b/extensions/voice-call/src/webhook.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover webhook plugin behavior.
 import { request, type IncomingMessage } from "node:http";
 import type { RealtimeTranscriptionProviderPlugin } from "openclaw/plugin-sdk/realtime-transcription";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/voice-call/src/webhook.ts b/extensions/voice-call/src/webhook.ts
index 2f165fa09b91..71192068a85c 100644
--- a/extensions/voice-call/src/webhook.ts
+++ b/extensions/voice-call/src/webhook.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements webhook behavior.
 import http from "node:http";
 import { URL } from "node:url";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/voice-call/src/webhook/realtime-audio-pacer.test.ts b/extensions/voice-call/src/webhook/realtime-audio-pacer.test.ts
index 08bf80f1e45a..95bad8a14038 100644
--- a/extensions/voice-call/src/webhook/realtime-audio-pacer.test.ts
+++ b/extensions/voice-call/src/webhook/realtime-audio-pacer.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover realtime audio pacer plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   RealtimeAudioPacer,
diff --git a/extensions/voice-call/src/webhook/realtime-handler.test.ts b/extensions/voice-call/src/webhook/realtime-handler.test.ts
index 8af36018ce23..3ff9f6d78b80 100644
--- a/extensions/voice-call/src/webhook/realtime-handler.test.ts
+++ b/extensions/voice-call/src/webhook/realtime-handler.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover realtime handler plugin behavior.
 import http from "node:http";
 import type {
   RealtimeVoiceBridge,
diff --git a/extensions/voice-call/src/webhook/realtime-handler.ts b/extensions/voice-call/src/webhook/realtime-handler.ts
index 5bc24ed5e189..47b378d6ed23 100644
--- a/extensions/voice-call/src/webhook/realtime-handler.ts
+++ b/extensions/voice-call/src/webhook/realtime-handler.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements realtime handler behavior.
 import { randomUUID } from "node:crypto";
 import http from "node:http";
 import type { Duplex } from "node:stream";
diff --git a/extensions/voice-call/src/webhook/stale-call-reaper.test.ts b/extensions/voice-call/src/webhook/stale-call-reaper.test.ts
index 8c697c966a76..1b2456fbedf3 100644
--- a/extensions/voice-call/src/webhook/stale-call-reaper.test.ts
+++ b/extensions/voice-call/src/webhook/stale-call-reaper.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover stale call reaper plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { startStaleCallReaper } from "./stale-call-reaper.js";
 
diff --git a/extensions/voice-call/src/webhook/stale-call-reaper.ts b/extensions/voice-call/src/webhook/stale-call-reaper.ts
index b67582f89e1b..0cc09e863898 100644
--- a/extensions/voice-call/src/webhook/stale-call-reaper.ts
+++ b/extensions/voice-call/src/webhook/stale-call-reaper.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements stale call reaper behavior.
 import type { CallManager } from "../manager.js";
 import { TerminalStates } from "../types.js";
 
diff --git a/extensions/voice-call/src/webhook/stream-frame-adapter.test.ts b/extensions/voice-call/src/webhook/stream-frame-adapter.test.ts
index 4c636817902d..6da5aee5f421 100644
--- a/extensions/voice-call/src/webhook/stream-frame-adapter.test.ts
+++ b/extensions/voice-call/src/webhook/stream-frame-adapter.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover stream frame adapter plugin behavior.
 import { describe, expect, it } from "vitest";
 import { TelnyxStreamFrameAdapter, TwilioStreamFrameAdapter } from "./stream-frame-adapter.js";
 
diff --git a/extensions/voice-call/src/webhook/tailscale.test.ts b/extensions/voice-call/src/webhook/tailscale.test.ts
index 00cb325a23a7..6b481a4592d1 100644
--- a/extensions/voice-call/src/webhook/tailscale.test.ts
+++ b/extensions/voice-call/src/webhook/tailscale.test.ts
@@ -1,3 +1,4 @@
+// Voice Call tests cover tailscale plugin behavior.
 import { EventEmitter } from "node:events";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/voice-call/src/webhook/tailscale.ts b/extensions/voice-call/src/webhook/tailscale.ts
index cbff1e7b57dd..26b5f0529ff5 100644
--- a/extensions/voice-call/src/webhook/tailscale.ts
+++ b/extensions/voice-call/src/webhook/tailscale.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements tailscale behavior.
 import { spawn } from "node:child_process";
 import type { VoiceCallConfig } from "../config.js";
 
diff --git a/extensions/voice-call/src/websocket-test-support.ts b/extensions/voice-call/src/websocket-test-support.ts
index dd28d13a74a0..86099857ca5e 100644
--- a/extensions/voice-call/src/websocket-test-support.ts
+++ b/extensions/voice-call/src/websocket-test-support.ts
@@ -1,3 +1,4 @@
+// Voice Call plugin module implements websocket test support behavior.
 import { once } from "node:events";
 import http from "node:http";
 import { WebSocket } from "ws";