diff --git a/src/channels/plugins/account-action-gate.test.ts b/src/channels/plugins/account-action-gate.test.ts
index ac292993d7c6..2cac964863ac 100644
--- a/src/channels/plugins/account-action-gate.test.ts
+++ b/src/channels/plugins/account-action-gate.test.ts
@@ -1,3 +1,4 @@
+// Account action gate tests cover channel account action visibility and enablement checks.
 import { describe, expect, it } from "vitest";
 import { createAccountActionGate } from "./account-action-gate.js";
 
diff --git a/src/channels/plugins/account-helpers.test.ts b/src/channels/plugins/account-helpers.test.ts
index a4807a6080c2..9bb51e901e04 100644
--- a/src/channels/plugins/account-helpers.test.ts
+++ b/src/channels/plugins/account-helpers.test.ts
@@ -1,3 +1,4 @@
+// Account helper tests cover channel account normalization and lookup helpers.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { normalizeAccountId } from "../../routing/session-key.js";
diff --git a/src/channels/plugins/acp-bindings.test.ts b/src/channels/plugins/acp-bindings.test.ts
index 05524436f5ee..d006d1a12868 100644
--- a/src/channels/plugins/acp-bindings.test.ts
+++ b/src/channels/plugins/acp-bindings.test.ts
@@ -1,3 +1,4 @@
+// ACP binding tests cover channel plugin ACP target binding and stateful driver behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { buildConfiguredAcpSessionKey } from "../../acp/persistent-bindings.types.js";
 import { ensureConfiguredBindingBuiltinsRegistered } from "./configured-binding-builtins.js";
diff --git a/src/channels/plugins/acp-stateful-target-driver.test.ts b/src/channels/plugins/acp-stateful-target-driver.test.ts
index 0a341e47ae64..eb380d9f5dd6 100644
--- a/src/channels/plugins/acp-stateful-target-driver.test.ts
+++ b/src/channels/plugins/acp-stateful-target-driver.test.ts
@@ -1,3 +1,4 @@
+// ACP stateful target driver tests cover ACP target state persistence and routing.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const resetMocks = vi.hoisted(() => ({
diff --git a/src/channels/plugins/approvals.test.ts b/src/channels/plugins/approvals.test.ts
index 69c3e6fb4319..f88f059e8513 100644
--- a/src/channels/plugins/approvals.test.ts
+++ b/src/channels/plugins/approvals.test.ts
@@ -1,3 +1,4 @@
+// Approval tests cover channel plugin approval request formatting and dispatch.
 import { describe, expect, it, vi } from "vitest";
 import { resolveChannelApprovalAdapter, resolveChannelApprovalCapability } from "./approvals.js";
 
diff --git a/src/channels/plugins/binding-routing.test.ts b/src/channels/plugins/binding-routing.test.ts
index 00b45f422a9c..939a3b4fc2a7 100644
--- a/src/channels/plugins/binding-routing.test.ts
+++ b/src/channels/plugins/binding-routing.test.ts
@@ -1,3 +1,4 @@
+// Binding routing tests cover channel binding selection and message routing behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   testing,
diff --git a/src/channels/plugins/binding-targets.test.ts b/src/channels/plugins/binding-targets.test.ts
index 88c4e18d406f..1095f8d52d93 100644
--- a/src/channels/plugins/binding-targets.test.ts
+++ b/src/channels/plugins/binding-targets.test.ts
@@ -1,3 +1,4 @@
+// Binding target tests cover channel binding target extraction and validation.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   ensureConfiguredBindingTargetReady,
diff --git a/src/channels/plugins/bundled-load-error.test.ts b/src/channels/plugins/bundled-load-error.test.ts
index 4c468686dead..f5480eed7aeb 100644
--- a/src/channels/plugins/bundled-load-error.test.ts
+++ b/src/channels/plugins/bundled-load-error.test.ts
@@ -1,3 +1,4 @@
+// Bundled load error tests cover diagnostics when bundled channel plugins fail to load.
 import { describe, it, expect } from "vitest";
 import { describeBundledChannelLoadError } from "./bundled.js";
 
diff --git a/src/channels/plugins/bundled-root-caches.test.ts b/src/channels/plugins/bundled-root-caches.test.ts
index c4c7afed7915..de2ea3cd00b3 100644
--- a/src/channels/plugins/bundled-root-caches.test.ts
+++ b/src/channels/plugins/bundled-root-caches.test.ts
@@ -1,3 +1,4 @@
+// Bundled root cache tests cover cached bundled channel root resolution.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/channels/plugins/bundled.shape-guard.test.ts b/src/channels/plugins/bundled.shape-guard.test.ts
index b43b8755cb16..e208b3a90e76 100644
--- a/src/channels/plugins/bundled.shape-guard.test.ts
+++ b/src/channels/plugins/bundled.shape-guard.test.ts
@@ -1,3 +1,4 @@
+// Bundled shape guard tests cover bundled channel package metadata and export shape.
 import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/src/channels/plugins/catalog.test.ts b/src/channels/plugins/catalog.test.ts
index fe71d1189be0..a75740d18141 100644
--- a/src/channels/plugins/catalog.test.ts
+++ b/src/channels/plugins/catalog.test.ts
@@ -1,3 +1,4 @@
+// Channel plugin catalog tests cover plugin catalog entries and metadata normalization.
 import { describe, expect, it } from "vitest";
 import { getChannelPluginCatalogEntry } from "./catalog.js";
 
diff --git a/src/channels/plugins/chat-target-prefixes.test.ts b/src/channels/plugins/chat-target-prefixes.test.ts
index 1d28232b77e2..3cdbcc2d189b 100644
--- a/src/channels/plugins/chat-target-prefixes.test.ts
+++ b/src/channels/plugins/chat-target-prefixes.test.ts
@@ -1,3 +1,4 @@
+// Chat target prefix tests cover channel target prefix parsing and display behavior.
 import { describe, expect, it } from "vitest";
 import {
   createAllowedChatSenderMatcher,
diff --git a/src/channels/plugins/config-helpers.test.ts b/src/channels/plugins/config-helpers.test.ts
index 2f29b3f8ef93..729f9d825f80 100644
--- a/src/channels/plugins/config-helpers.test.ts
+++ b/src/channels/plugins/config-helpers.test.ts
@@ -1,3 +1,4 @@
+// Config helper tests cover channel plugin config merge and selection helpers.
 import { describe, expect, it } from "vitest";
 import { clearAccountEntryFields } from "./config-helpers.js";
 
diff --git a/src/channels/plugins/config-schema.test.ts b/src/channels/plugins/config-schema.test.ts
index 3aaae4f29634..df78a5621600 100644
--- a/src/channels/plugins/config-schema.test.ts
+++ b/src/channels/plugins/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Config schema tests cover channel plugin config schema validation and defaults.
 import { describe, expect, it, vi } from "vitest";
 import { z } from "zod";
 import {
diff --git a/src/channels/plugins/configured-state.test.ts b/src/channels/plugins/configured-state.test.ts
index 76f2a9d623b6..88d09bc10e76 100644
--- a/src/channels/plugins/configured-state.test.ts
+++ b/src/channels/plugins/configured-state.test.ts
@@ -1,3 +1,4 @@
+// Configured state tests cover channel plugin configured-state detection and summaries.
 import { createRequire } from "node:module";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/src/channels/plugins/directory-adapters.test.ts b/src/channels/plugins/directory-adapters.test.ts
index 8923b7ff1512..c346f3ee4610 100644
--- a/src/channels/plugins/directory-adapters.test.ts
+++ b/src/channels/plugins/directory-adapters.test.ts
@@ -1,3 +1,4 @@
+// Directory adapter tests cover channel directory adapter contracts and result normalization.
 import { describe, expect, it } from "vitest";
 import {
   createChannelDirectoryAdapter,
diff --git a/src/channels/plugins/directory-config-helpers.test.ts b/src/channels/plugins/directory-config-helpers.test.ts
index de0aed604f4b..d9903bfb580e 100644
--- a/src/channels/plugins/directory-config-helpers.test.ts
+++ b/src/channels/plugins/directory-config-helpers.test.ts
@@ -1,3 +1,4 @@
+// Directory config helper tests cover config helpers for channel directory integrations.
 import { describe, expect, it } from "vitest";
 import {
   createInspectedDirectoryEntriesLister,
diff --git a/src/channels/plugins/doctor-contract-api.fast-path.test.ts b/src/channels/plugins/doctor-contract-api.fast-path.test.ts
index 0b3b338ba84a..558c7cc72e93 100644
--- a/src/channels/plugins/doctor-contract-api.fast-path.test.ts
+++ b/src/channels/plugins/doctor-contract-api.fast-path.test.ts
@@ -1,3 +1,4 @@
+// Doctor contract API fast-path tests cover lightweight channel doctor contract loading.
 import { describe, expect, it, vi } from "vitest";
 
 const { loadBundledPluginPublicArtifactModuleSyncMock } = vi.hoisted(() => ({
diff --git a/src/channels/plugins/gateway-auth-bypass.test.ts b/src/channels/plugins/gateway-auth-bypass.test.ts
index 200bbbe4d869..1558c33cebef 100644
--- a/src/channels/plugins/gateway-auth-bypass.test.ts
+++ b/src/channels/plugins/gateway-auth-bypass.test.ts
@@ -1,3 +1,4 @@
+// Gateway auth bypass tests cover channel plugin paths allowed to skip gateway auth.
 import { describe, expect, it, vi } from "vitest";
 
 const { loadBundledPluginPublicArtifactModuleSyncMock } = vi.hoisted(() => ({
diff --git a/src/channels/plugins/group-policy-warnings.test.ts b/src/channels/plugins/group-policy-warnings.test.ts
index 2d03ab183618..c71438d84c1d 100644
--- a/src/channels/plugins/group-policy-warnings.test.ts
+++ b/src/channels/plugins/group-policy-warnings.test.ts
@@ -1,3 +1,4 @@
+// Group policy warning tests cover user-facing warnings for channel group access policy.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import {
diff --git a/src/channels/plugins/helpers.test.ts b/src/channels/plugins/helpers.test.ts
index 96d7cd8d3d3d..289cae17d8c3 100644
--- a/src/channels/plugins/helpers.test.ts
+++ b/src/channels/plugins/helpers.test.ts
@@ -1,3 +1,4 @@
+// Channel plugin helper tests cover shared plugin helper behavior and edge cases.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import {
diff --git a/src/channels/plugins/legacy-config.test.ts b/src/channels/plugins/legacy-config.test.ts
index 2ca4ab26d6d7..490a5d23f85b 100644
--- a/src/channels/plugins/legacy-config.test.ts
+++ b/src/channels/plugins/legacy-config.test.ts
@@ -1,3 +1,4 @@
+// Legacy config tests cover channel plugin config compatibility and migration helpers.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { LegacyConfigRule } from "../../config/legacy.shared.js";
 
diff --git a/src/channels/plugins/message-actions.security.test.ts b/src/channels/plugins/message-actions.security.test.ts
index e025f6014047..007521f14d8f 100644
--- a/src/channels/plugins/message-actions.security.test.ts
+++ b/src/channels/plugins/message-actions.security.test.ts
@@ -1,3 +1,4 @@
+// Message action security tests cover channel message action authorization and validation.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { jsonResult } from "../../agents/tools/common.js";
 import type { OpenClawConfig } from "../../config/config.js";
diff --git a/src/channels/plugins/message-actions.test.ts b/src/channels/plugins/message-actions.test.ts
index e747607444b0..be572af9c6e2 100644
--- a/src/channels/plugins/message-actions.test.ts
+++ b/src/channels/plugins/message-actions.test.ts
@@ -1,3 +1,4 @@
+// Message action tests cover channel message action schema and invocation behavior.
 import { Type } from "typebox";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
diff --git a/src/channels/plugins/message-capability-matrix.test.ts b/src/channels/plugins/message-capability-matrix.test.ts
index 43aa3b3d294d..749ea24e46ba 100644
--- a/src/channels/plugins/message-capability-matrix.test.ts
+++ b/src/channels/plugins/message-capability-matrix.test.ts
@@ -1,3 +1,4 @@
+// Message capability matrix tests cover channel message feature support across plugin surfaces.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import type { ChannelMessageActionAdapter, ChannelPlugin } from "./types.js";
diff --git a/src/channels/plugins/message-tool-api.test.ts b/src/channels/plugins/message-tool-api.test.ts
index 449571192e79..e0351b1a6baf 100644
--- a/src/channels/plugins/message-tool-api.test.ts
+++ b/src/channels/plugins/message-tool-api.test.ts
@@ -1,3 +1,4 @@
+// Message tool API tests cover channel message tool descriptors and runtime calls.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { loadBundledPluginPublicArtifactModuleSyncMock } = vi.hoisted(() => ({
diff --git a/src/channels/plugins/module-loader.test.ts b/src/channels/plugins/module-loader.test.ts
index d4654693c906..b1cbb66dfab6 100644
--- a/src/channels/plugins/module-loader.test.ts
+++ b/src/channels/plugins/module-loader.test.ts
@@ -1,3 +1,4 @@
+// Module loader tests cover channel plugin module resolution and import failure handling.
 import fs from "node:fs";
 import { createRequire } from "node:module";
 import os from "node:os";
diff --git a/src/channels/plugins/package-state-probes.test.ts b/src/channels/plugins/package-state-probes.test.ts
index 85c14983b4d5..e9faf530c06c 100644
--- a/src/channels/plugins/package-state-probes.test.ts
+++ b/src/channels/plugins/package-state-probes.test.ts
@@ -1,3 +1,4 @@
+// Package state probe tests cover channel plugin package install and runtime status probes.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/channels/plugins/pairing-adapters.test.ts b/src/channels/plugins/pairing-adapters.test.ts
index 30c52a4cd323..364ec27c0ec0 100644
--- a/src/channels/plugins/pairing-adapters.test.ts
+++ b/src/channels/plugins/pairing-adapters.test.ts
@@ -1,3 +1,4 @@
+// Pairing adapter tests cover channel plugin device/account pairing adapter behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   createLoggedPairingApprovalNotifier,
diff --git a/src/channels/plugins/persisted-auth-state.test.ts b/src/channels/plugins/persisted-auth-state.test.ts
index 412e15d26a73..0ae298ee23ec 100644
--- a/src/channels/plugins/persisted-auth-state.test.ts
+++ b/src/channels/plugins/persisted-auth-state.test.ts
@@ -1,3 +1,4 @@
+// Persisted auth state tests cover channel plugin auth state serialization and recovery.
 import { describe, expect, it } from "vitest";
 import {
   hasBundledChannelPersistedAuthState,
diff --git a/src/channels/plugins/read-only-command-defaults.test.ts b/src/channels/plugins/read-only-command-defaults.test.ts
index e83301b6a4a2..e4297c2c881b 100644
--- a/src/channels/plugins/read-only-command-defaults.test.ts
+++ b/src/channels/plugins/read-only-command-defaults.test.ts
@@ -1,3 +1,4 @@
+// Read-only command default tests cover command defaulting for read-only channel plugins.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const loadPluginMetadataSnapshot = vi.hoisted(() => vi.fn());
diff --git a/src/channels/plugins/read-only.test.ts b/src/channels/plugins/read-only.test.ts
index 3ee11d243bc8..4fb0f1ca2c5b 100644
--- a/src/channels/plugins/read-only.test.ts
+++ b/src/channels/plugins/read-only.test.ts
@@ -1,3 +1,4 @@
+// Read-only channel tests cover read-only plugin registration and runtime behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
diff --git a/src/channels/plugins/registry.test.ts b/src/channels/plugins/registry.test.ts
index 8b04f4906807..ba8d28e2d060 100644
--- a/src/channels/plugins/registry.test.ts
+++ b/src/channels/plugins/registry.test.ts
@@ -1,3 +1,4 @@
+// Registry tests cover channel plugin registry installation, lookup, and reset behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createEmptyPluginRegistry } from "../../plugins/registry-empty.js";
 import type { PluginRegistry } from "../../plugins/registry.js";
diff --git a/src/channels/plugins/runtime-forwarders.test.ts b/src/channels/plugins/runtime-forwarders.test.ts
index 319740721def..f88effe1d4d7 100644
--- a/src/channels/plugins/runtime-forwarders.test.ts
+++ b/src/channels/plugins/runtime-forwarders.test.ts
@@ -1,3 +1,4 @@
+// Runtime forwarder tests cover channel plugin runtime method delegation and fallback handling.
 import { describe, expect, it, vi } from "vitest";
 import {
   createRuntimeDirectoryLiveAdapter,
diff --git a/src/channels/plugins/session-conversation.bundled-fallback.test.ts b/src/channels/plugins/session-conversation.bundled-fallback.test.ts
index b79f467547ce..41430ef86a0e 100644
--- a/src/channels/plugins/session-conversation.bundled-fallback.test.ts
+++ b/src/channels/plugins/session-conversation.bundled-fallback.test.ts
@@ -1,3 +1,4 @@
+// Session conversation fallback tests cover bundled plugin fallback for conversation sessions.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { clearRuntimeConfigSnapshot, setRuntimeConfigSnapshot } from "../../config/io.js";
 import { resetPluginRuntimeStateForTest } from "../../plugins/runtime.js";
diff --git a/src/channels/plugins/session-conversation.test.ts b/src/channels/plugins/session-conversation.test.ts
index 3b0d5705abec..f1261f765423 100644
--- a/src/channels/plugins/session-conversation.test.ts
+++ b/src/channels/plugins/session-conversation.test.ts
@@ -1,3 +1,4 @@
+// Session conversation tests cover channel plugin conversation binding and session lookup.
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 import { clearRuntimeConfigSnapshot, setRuntimeConfigSnapshot } from "../../config/io.js";
 import { resetPluginRuntimeStateForTest, setActivePluginRegistry } from "../../plugins/runtime.js";
diff --git a/src/channels/plugins/setup-group-access-configure.test.ts b/src/channels/plugins/setup-group-access-configure.test.ts
index c9ddad8542cb..15654c022e64 100644
--- a/src/channels/plugins/setup-group-access-configure.test.ts
+++ b/src/channels/plugins/setup-group-access-configure.test.ts
@@ -1,3 +1,4 @@
+// Setup group access configure tests cover channel setup writes for group access config.
 import { describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { configureChannelAccessWithAllowlist } from "./setup-group-access-configure.js";
diff --git a/src/channels/plugins/setup-group-access.test.ts b/src/channels/plugins/setup-group-access.test.ts
index c3f947837e57..15b8e65c2d9a 100644
--- a/src/channels/plugins/setup-group-access.test.ts
+++ b/src/channels/plugins/setup-group-access.test.ts
@@ -1,3 +1,4 @@
+// Setup group access tests cover group access setup flow decisions and outputs.
 import { describe, expect, it, vi } from "vitest";
 import {
   formatAllowlistEntries,
diff --git a/src/channels/plugins/setup-helpers.import-safety.test.ts b/src/channels/plugins/setup-helpers.import-safety.test.ts
index e84fdd01e363..ba754a02ad99 100644
--- a/src/channels/plugins/setup-helpers.import-safety.test.ts
+++ b/src/channels/plugins/setup-helpers.import-safety.test.ts
@@ -1,3 +1,4 @@
+// Setup helper import-safety tests cover lazy boundaries for channel plugin setup helpers.
 import { importFreshModule } from "openclaw/plugin-sdk/test-fixtures";
 import { afterEach, describe, expect, it, vi } from "vitest";
 
diff --git a/src/channels/plugins/setup-helpers.test.ts b/src/channels/plugins/setup-helpers.test.ts
index b63fc044c397..3da249121185 100644
--- a/src/channels/plugins/setup-helpers.test.ts
+++ b/src/channels/plugins/setup-helpers.test.ts
@@ -1,3 +1,4 @@
+// Setup helper tests cover channel setup helper outputs and lifecycle cleanup.
 import { afterAll, beforeEach, describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { resetPluginRuntimeStateForTest, setActivePluginRegistry } from "../../plugins/runtime.js";
diff --git a/src/channels/plugins/setup-promotion-helpers.test.ts b/src/channels/plugins/setup-promotion-helpers.test.ts
index 626ea6124ece..a6e007b0d990 100644
--- a/src/channels/plugins/setup-promotion-helpers.test.ts
+++ b/src/channels/plugins/setup-promotion-helpers.test.ts
@@ -1,3 +1,4 @@
+// Setup promotion helper tests cover setup-result promotion into configured channel state.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const getBundledChannelPluginMock = vi.hoisted(() => vi.fn());
diff --git a/src/channels/plugins/setup-wizard-binary.test.ts b/src/channels/plugins/setup-wizard-binary.test.ts
index 201f147ffea2..73a0d1ffbc4c 100644
--- a/src/channels/plugins/setup-wizard-binary.test.ts
+++ b/src/channels/plugins/setup-wizard-binary.test.ts
@@ -1,3 +1,4 @@
+// Setup wizard binary tests cover channel setup wizard binary selection and invocation.
 import { describe, expect, it, vi } from "vitest";
 import {
   createCliPathTextInput,
diff --git a/src/channels/plugins/setup-wizard-helpers.test.ts b/src/channels/plugins/setup-wizard-helpers.test.ts
index f353154dc7a1..2c6a7155dc32 100644
--- a/src/channels/plugins/setup-wizard-helpers.test.ts
+++ b/src/channels/plugins/setup-wizard-helpers.test.ts
@@ -1,3 +1,4 @@
+// Setup wizard helper tests cover channel setup step formatting and config writes.
 import {
   resolveSetupWizardAllowFromEntries,
   resolveSetupWizardGroupAllowlist,
diff --git a/src/channels/plugins/setup-wizard-proxy.test.ts b/src/channels/plugins/setup-wizard-proxy.test.ts
index b6a43f706aa1..63272790d848 100644
--- a/src/channels/plugins/setup-wizard-proxy.test.ts
+++ b/src/channels/plugins/setup-wizard-proxy.test.ts
@@ -1,3 +1,4 @@
+// Setup wizard proxy tests cover proxying setup wizard calls through channel plugin facades.
 import {
   promptSetupWizardAllowFrom,
   resolveSetupWizardAllowFromEntries,
diff --git a/src/channels/plugins/target-parsing.test.ts b/src/channels/plugins/target-parsing.test.ts
index 52ec57633785..1ea0308d2c90 100644
--- a/src/channels/plugins/target-parsing.test.ts
+++ b/src/channels/plugins/target-parsing.test.ts
@@ -1,3 +1,4 @@
+// Target parsing tests cover channel target syntax parsing and validation.
 import { beforeEach, describe, expect, it } from "vitest";
 import {
   channelRouteTargetsMatchExact,
diff --git a/src/channels/plugins/target-resolvers.test.ts b/src/channels/plugins/target-resolvers.test.ts
index 161b94a8fb2e..f7ec599afbda 100644
--- a/src/channels/plugins/target-resolvers.test.ts
+++ b/src/channels/plugins/target-resolvers.test.ts
@@ -1,3 +1,4 @@
+// Target resolver tests cover channel plugin target resolution from user input and bindings.
 import { describe, expect, it } from "vitest";
 import {
   buildUnresolvedTargetResults,
diff --git a/src/channels/plugins/thread-binding-api.test.ts b/src/channels/plugins/thread-binding-api.test.ts
index b1a96900ecb0..42091003856f 100644
--- a/src/channels/plugins/thread-binding-api.test.ts
+++ b/src/channels/plugins/thread-binding-api.test.ts
@@ -1,3 +1,4 @@
+// Thread binding API tests cover channel plugin thread binding contracts and helpers.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { loadBundledPluginPublicArtifactModuleSyncMock } = vi.hoisted(() => ({
diff --git a/src/channels/plugins/threading-helpers.test.ts b/src/channels/plugins/threading-helpers.test.ts
index 05f80351dd75..a310cb0daca0 100644
--- a/src/channels/plugins/threading-helpers.test.ts
+++ b/src/channels/plugins/threading-helpers.test.ts
@@ -1,3 +1,4 @@
+// Threading helper tests cover channel thread metadata and reply-thread helper behavior.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import {
diff --git a/src/channels/plugins/tts-capabilities.test.ts b/src/channels/plugins/tts-capabilities.test.ts
index 4aba7b7f4ce3..eb256585053e 100644
--- a/src/channels/plugins/tts-capabilities.test.ts
+++ b/src/channels/plugins/tts-capabilities.test.ts
@@ -1,3 +1,4 @@
+// TTS capability tests cover channel plugin text-to-speech capability detection.
 import { afterEach, describe, expect, it } from "vitest";
 import { createEmptyPluginRegistry } from "../../plugins/registry-empty.js";
 import { setActivePluginRegistry } from "../../plugins/runtime.js";