diff --git a/test/fixtures/ts-topology/basic/extensions/alpha/src/use.ts b/test/fixtures/ts-topology/basic/extensions/alpha/src/use.ts
index 4c8a000e4acb..ecae77c893b6 100644
--- a/test/fixtures/ts-topology/basic/extensions/alpha/src/use.ts
+++ b/test/fixtures/ts-topology/basic/extensions/alpha/src/use.ts
@@ -1,3 +1,4 @@
+// TS topology alpha extension fixture imports SDK members with aliases.
 import { aliasedThing as renamedThing, sharedThing, singleOwnerHelper } from "fixture-sdk";
 import type { SharedType } from "fixture-sdk";
 import * as extra from "fixture-sdk/extra";
diff --git a/test/fixtures/ts-topology/basic/extensions/beta/src/use.ts b/test/fixtures/ts-topology/basic/extensions/beta/src/use.ts
index d0b934743c04..fea84ee1d2dc 100644
--- a/test/fixtures/ts-topology/basic/extensions/beta/src/use.ts
+++ b/test/fixtures/ts-topology/basic/extensions/beta/src/use.ts
@@ -1,3 +1,4 @@
+// TS topology beta extension fixture imports shared SDK members.
 import { sharedThing } from "fixture-sdk";
 import type { SharedType } from "fixture-sdk";
 
diff --git a/test/fixtures/ts-topology/basic/src/internal/use.ts b/test/fixtures/ts-topology/basic/src/internal/use.ts
index 6e7d46e44c39..b9dc6cd05f2a 100644
--- a/test/fixtures/ts-topology/basic/src/internal/use.ts
+++ b/test/fixtures/ts-topology/basic/src/internal/use.ts
@@ -1,3 +1,4 @@
+// TS topology internal fixture imports shared SDK members from internal code.
 import { sharedThing } from "fixture-sdk";
 
 export function internalUse() {
diff --git a/test/fixtures/ts-topology/basic/src/lib/shared.ts b/test/fixtures/ts-topology/basic/src/lib/shared.ts
index 8da2d1aac51c..7284ad71b098 100644
--- a/test/fixtures/ts-topology/basic/src/lib/shared.ts
+++ b/test/fixtures/ts-topology/basic/src/lib/shared.ts
@@ -1,3 +1,4 @@
+// TS topology shared fixture helper models a shared library export.
 export function sharedThing() {
   return "shared";
 }
diff --git a/test/fixtures/ts-topology/basic/src/public/extra.ts b/test/fixtures/ts-topology/basic/src/public/extra.ts
index efa91b011621..2db94bc504d4 100644
--- a/test/fixtures/ts-topology/basic/src/public/extra.ts
+++ b/test/fixtures/ts-topology/basic/src/public/extra.ts
@@ -1 +1,2 @@
+// TS topology public extra fixture re-exports shared SDK helpers.
 export { sharedThing } from "../lib/shared.js";
diff --git a/test/fixtures/ts-topology/basic/src/public/index.ts b/test/fixtures/ts-topology/basic/src/public/index.ts
index 36d69a031d42..cf1b0a820490 100644
--- a/test/fixtures/ts-topology/basic/src/public/index.ts
+++ b/test/fixtures/ts-topology/basic/src/public/index.ts
@@ -1,3 +1,4 @@
+// TS topology public fixture barrel re-exports public SDK members.
 export {
   aliasedThing,
   sharedThing,
diff --git a/test/fixtures/ts-topology/basic/tests/public.test.ts b/test/fixtures/ts-topology/basic/tests/public.test.ts
index 7779736b4e74..eecfd57c2db9 100644
--- a/test/fixtures/ts-topology/basic/tests/public.test.ts
+++ b/test/fixtures/ts-topology/basic/tests/public.test.ts
@@ -1,3 +1,4 @@
+// TS topology public fixture test exercises public fixture SDK exports.
 import { testOnlyThing } from "fixture-sdk";
 
 export function testUse() {
diff --git a/test/helpers/acp-manager-task-state.ts b/test/helpers/acp-manager-task-state.ts
index a09bd24f67f6..1c58ed45ad96 100644
--- a/test/helpers/acp-manager-task-state.ts
+++ b/test/helpers/acp-manager-task-state.ts
@@ -1,3 +1,4 @@
+// ACP manager task state helper resets task flow state for ACP tests.
 import { resetTaskFlowRegistryForTests } from "../../src/tasks/task-flow-registry.js";
 import { configureTaskFlowRegistryRuntime } from "../../src/tasks/task-flow-registry.store.js";
 import { findTaskByRunId, resetTaskRegistryForTests } from "../../src/tasks/task-registry.js";
diff --git a/test/helpers/agents/happy-path-prompt-snapshots.ts b/test/helpers/agents/happy-path-prompt-snapshots.ts
index 7bcb7dd6f539..07210caa4be7 100644
--- a/test/helpers/agents/happy-path-prompt-snapshots.ts
+++ b/test/helpers/agents/happy-path-prompt-snapshots.ts
@@ -1,3 +1,4 @@
+// Happy path prompt snapshot helper reads expected prompt snapshot files.
 import fs from "node:fs";
 import path from "node:path";
 import type { Model } from "openclaw/plugin-sdk/llm";
diff --git a/test/helpers/agents/llm-stream-simple-mock.ts b/test/helpers/agents/llm-stream-simple-mock.ts
index 554e48a8bfd5..34887778702a 100644
--- a/test/helpers/agents/llm-stream-simple-mock.ts
+++ b/test/helpers/agents/llm-stream-simple-mock.ts
@@ -1,3 +1,4 @@
+// Simple LLM stream mock helper builds deterministic streamed responses.
 import { vi } from "vitest";
 
 type LlmMockModule = Record<string, unknown>;
diff --git a/test/helpers/agents/prompt-composition-scenarios.ts b/test/helpers/agents/prompt-composition-scenarios.ts
index 12a22618999f..50d1dbae50f7 100644
--- a/test/helpers/agents/prompt-composition-scenarios.ts
+++ b/test/helpers/agents/prompt-composition-scenarios.ts
@@ -1,3 +1,4 @@
+// Prompt composition scenarios build reusable agent prompt fixtures.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/test/helpers/auth-wizard.ts b/test/helpers/auth-wizard.ts
index 2bd47ab72d6d..0e34f666959f 100644
--- a/test/helpers/auth-wizard.ts
+++ b/test/helpers/auth-wizard.ts
@@ -1,3 +1,4 @@
+// Auth wizard helpers drive authentication wizard flows in tests.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { vi } from "vitest";
diff --git a/test/helpers/auto-reply/trigger-handling-test-harness.ts b/test/helpers/auto-reply/trigger-handling-test-harness.ts
index ed7858ed2cf0..972692b7a493 100644
--- a/test/helpers/auto-reply/trigger-handling-test-harness.ts
+++ b/test/helpers/auto-reply/trigger-handling-test-harness.ts
@@ -1,3 +1,4 @@
+// Auto-reply trigger harness builds trigger handling scenarios for tests.
 import { rmSync } from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/test/helpers/browser-bundled-plugin-fixture.ts b/test/helpers/browser-bundled-plugin-fixture.ts
index f7cda4c25644..a340268696ee 100644
--- a/test/helpers/browser-bundled-plugin-fixture.ts
+++ b/test/helpers/browser-bundled-plugin-fixture.ts
@@ -1,3 +1,4 @@
+// Browser bundled plugin fixtures build browser extension plugin layouts for tests.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/test/helpers/config/bundled-channel-config-runtime.ts b/test/helpers/config/bundled-channel-config-runtime.ts
index f3cf42a0bf7c..39eea3c31573 100644
--- a/test/helpers/config/bundled-channel-config-runtime.ts
+++ b/test/helpers/config/bundled-channel-config-runtime.ts
@@ -1,3 +1,4 @@
+// Bundled channel config runtime helper loads public bundled channel config surfaces.
 import * as bundledChannelModule from "../../../src/channels/plugins/bundled.js";
 import type {
   ChannelConfigRuntimeSchema,
diff --git a/test/helpers/config/config-honor-audit.ts b/test/helpers/config/config-honor-audit.ts
index ffd4cab66e46..a101c019900c 100644
--- a/test/helpers/config/config-honor-audit.ts
+++ b/test/helpers/config/config-honor-audit.ts
@@ -1,3 +1,4 @@
+// Config honor audit helper checks config fields against expected consumers.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
diff --git a/test/helpers/config/heartbeat-config-honor.inventory.ts b/test/helpers/config/heartbeat-config-honor.inventory.ts
index 869338b364b5..10e0f77eb9fe 100644
--- a/test/helpers/config/heartbeat-config-honor.inventory.ts
+++ b/test/helpers/config/heartbeat-config-honor.inventory.ts
@@ -1,3 +1,4 @@
+// Heartbeat config honor inventory lists heartbeat config ownership rows.
 import type { ConfigHonorInventoryRow } from "./config-honor-audit.js";
 
 // Inventory of heartbeat config keys and the proof paths that should honor them.
diff --git a/test/helpers/config/redact-snapshot-test-hints.ts b/test/helpers/config/redact-snapshot-test-hints.ts
index 9f09a614dbd1..efee566a6c25 100644
--- a/test/helpers/config/redact-snapshot-test-hints.ts
+++ b/test/helpers/config/redact-snapshot-test-hints.ts
@@ -1,3 +1,4 @@
+// Redaction snapshot hints list config UI hints used by redaction tests.
 import type { ConfigUiHints } from "../../../src/config/schema.js";
 
 // Keep this fixture minimal so redaction tests exercise the hint-matching
diff --git a/test/helpers/cron/service-regression-fixtures.ts b/test/helpers/cron/service-regression-fixtures.ts
index 02817ebfbc9c..ef7f43009a29 100644
--- a/test/helpers/cron/service-regression-fixtures.ts
+++ b/test/helpers/cron/service-regression-fixtures.ts
@@ -1,3 +1,4 @@
+// Cron service regression fixtures build reusable scheduled job states.
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/test/helpers/gateway-e2e-harness.test.ts b/test/helpers/gateway-e2e-harness.test.ts
index d7c47a1b5c91..9fe4732267fc 100644
--- a/test/helpers/gateway-e2e-harness.test.ts
+++ b/test/helpers/gateway-e2e-harness.test.ts
@@ -1,3 +1,4 @@
+// Gateway E2E harness tests cover helper server and probe behavior.
 import { createServer, type Server } from "node:http";
 import { afterEach, describe, expect, it } from "vitest";
 import { postJson } from "./gateway-e2e-harness.js";
diff --git a/test/helpers/gateway-e2e-harness.ts b/test/helpers/gateway-e2e-harness.ts
index 17241494d17f..637ce4a34025 100644
--- a/test/helpers/gateway-e2e-harness.ts
+++ b/test/helpers/gateway-e2e-harness.ts
@@ -1,3 +1,4 @@
+// Gateway E2E harness starts test gateway processes and HTTP probes.
 import { request as httpRequest } from "node:http";
 import path from "node:path";
 import { GatewayClient } from "../../src/gateway/client.js";
diff --git a/test/helpers/gateway/android-node-capabilities-policy-config.ts b/test/helpers/gateway/android-node-capabilities-policy-config.ts
index f9dcfe2bce3f..be7e4f59a3c7 100644
--- a/test/helpers/gateway/android-node-capabilities-policy-config.ts
+++ b/test/helpers/gateway/android-node-capabilities-policy-config.ts
@@ -1,3 +1,4 @@
+// Android node capability policy config fixture describes gateway policy config.
 import type { OpenClawConfig } from "../../../src/config/config.js";
 
 // Test helper for unwrapping gateway config.get response shapes.
diff --git a/test/helpers/gateway/android-node-capabilities-policy-source.ts b/test/helpers/gateway/android-node-capabilities-policy-source.ts
index 997484e77f96..ca8578267f03 100644
--- a/test/helpers/gateway/android-node-capabilities-policy-source.ts
+++ b/test/helpers/gateway/android-node-capabilities-policy-source.ts
@@ -1,3 +1,4 @@
+// Android node capability policy source fixture describes gateway connection inputs.
 import type { GatewayConnectionDetails } from "../../../src/gateway/call.js";
 
 // Test helper for deciding when Android node policy config should be fetched remotely.
diff --git a/test/helpers/image-fixtures.ts b/test/helpers/image-fixtures.ts
index 5375f792aae9..716badbd4016 100644
--- a/test/helpers/image-fixtures.ts
+++ b/test/helpers/image-fixtures.ts
@@ -1,3 +1,4 @@
+// Image fixture helper re-exports shared media fixture paths.
 export {
   createGrayscaleAlphaPngBuffer,
   createNoisyPngBuffer,
diff --git a/test/helpers/infra/heartbeat-runner-channel-plugins.ts b/test/helpers/infra/heartbeat-runner-channel-plugins.ts
index 5ecfb30daade..920ad50adc26 100644
--- a/test/helpers/infra/heartbeat-runner-channel-plugins.ts
+++ b/test/helpers/infra/heartbeat-runner-channel-plugins.ts
@@ -1,3 +1,4 @@
+// Heartbeat runner channel plugin fixtures build channel plugin contracts for tests.
 import type {
   ChannelId,
   ChannelMessagingAdapter,
diff --git a/test/helpers/live-image-probe.test.ts b/test/helpers/live-image-probe.test.ts
index 1e47ef1a6917..80bb27b8963a 100644
--- a/test/helpers/live-image-probe.test.ts
+++ b/test/helpers/live-image-probe.test.ts
@@ -1,3 +1,4 @@
+// Live image probe tests cover generated probe image payloads.
 import { describe, expect, it } from "vitest";
 import { renderCatFacePngBase64, renderSolidColorPngBase64 } from "./live-image-probe.js";
 
diff --git a/test/helpers/live-image-probe.ts b/test/helpers/live-image-probe.ts
index defe6acd2d98..455590f1749d 100644
--- a/test/helpers/live-image-probe.ts
+++ b/test/helpers/live-image-probe.ts
@@ -1,3 +1,4 @@
+// Live image probe helpers build tiny image fixtures for live provider tests.
 import { encodePngRgba, fillPixel } from "../../src/media/png-encode.js";
 
 const GLYPH_ROWS_5X7: Record<string, number[]> = {
diff --git a/test/helpers/media-generation/bundled-provider-builders.ts b/test/helpers/media-generation/bundled-provider-builders.ts
index 3d77af7175cf..f351c521f1f1 100644
--- a/test/helpers/media-generation/bundled-provider-builders.ts
+++ b/test/helpers/media-generation/bundled-provider-builders.ts
@@ -1,3 +1,4 @@
+// Media generation provider builders create bundled provider fixtures for tests.
 import type { OpenClawPluginApi } from "../../../src/plugins/types.js";
 import { loadBundledPluginPublicSurfaceSync } from "../../../src/test-utils/bundled-plugin-public-surface.js";
 
diff --git a/test/helpers/media-generation/runtime-module-mocks.ts b/test/helpers/media-generation/runtime-module-mocks.ts
index 62e91bf2d270..d00ddda9a73f 100644
--- a/test/helpers/media-generation/runtime-module-mocks.ts
+++ b/test/helpers/media-generation/runtime-module-mocks.ts
@@ -1,3 +1,4 @@
+// Media generation runtime mocks install mocked runtime modules for tests.
 import { vi } from "vitest";
 import type { OpenClawConfig } from "../../../src/config/config.js";
 import type { ImageGenerationProvider } from "../../../src/image-generation/types.js";
diff --git a/test/helpers/normalize-text.ts b/test/helpers/normalize-text.ts
index b667290c4454..3be42d71199c 100644
--- a/test/helpers/normalize-text.ts
+++ b/test/helpers/normalize-text.ts
@@ -1,3 +1,4 @@
+// Text normalization helper strips terminal control sequences from test output.
 import { stripAnsi } from "../../packages/terminal-core/src/ansi.js";
 
 // Snapshot text normalization for terminal output tests.
diff --git a/test/helpers/openclaw-test-instance.test.ts b/test/helpers/openclaw-test-instance.test.ts
index 177e37da53f2..6dded68a2696 100644
--- a/test/helpers/openclaw-test-instance.test.ts
+++ b/test/helpers/openclaw-test-instance.test.ts
@@ -1,3 +1,4 @@
+// OpenClaw test instance tests cover spawned test instance lifecycle.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/test/helpers/openclaw-test-instance.ts b/test/helpers/openclaw-test-instance.ts
index 16d0a893295d..e4b8d4556dcb 100644
--- a/test/helpers/openclaw-test-instance.ts
+++ b/test/helpers/openclaw-test-instance.ts
@@ -1,3 +1,4 @@
+// OpenClaw test instance helper spawns isolated OpenClaw processes.
 import { type ChildProcessWithoutNullStreams, spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
diff --git a/test/helpers/paths.ts b/test/helpers/paths.ts
index cec77118d376..fadd301ef9b2 100644
--- a/test/helpers/paths.ts
+++ b/test/helpers/paths.ts
@@ -1,3 +1,4 @@
+// Test path helpers resolve repository-relative fixture paths.
 import path from "node:path";
 
 // Cross-platform path containment helper for tests.
diff --git a/test/helpers/pattern-file.ts b/test/helpers/pattern-file.ts
index b96885093596..7bb9fb155320 100644
--- a/test/helpers/pattern-file.ts
+++ b/test/helpers/pattern-file.ts
@@ -1,3 +1,4 @@
+// Pattern file helpers read file pattern lists for test configuration tests.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/test/helpers/poll.ts b/test/helpers/poll.ts
index 82817cd9ff81..59b1c00488e2 100644
--- a/test/helpers/poll.ts
+++ b/test/helpers/poll.ts
@@ -1,3 +1,4 @@
+// Poll test helper retries assertions until a timeout.
 import { sleep } from "../../src/utils.js";
 
 // Polling helper for tests that wait on async state.
diff --git a/test/helpers/stt-live-audio.test.ts b/test/helpers/stt-live-audio.test.ts
index a30de379eb20..62196fc62e9f 100644
--- a/test/helpers/stt-live-audio.test.ts
+++ b/test/helpers/stt-live-audio.test.ts
@@ -1,3 +1,4 @@
+// STT live audio tests validate live speech-to-text audio fixtures.
 import {
   expectOpenClawLiveTranscriptMarker,
   normalizeTranscriptForMatch,
diff --git a/test/helpers/temp-dir.ts b/test/helpers/temp-dir.ts
index 6b84c27c5974..67577fbedfba 100644
--- a/test/helpers/temp-dir.ts
+++ b/test/helpers/temp-dir.ts
@@ -1,3 +1,4 @@
+// Test temp directory helper creates and cleans up temporary directories.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/test/helpers/temp-repo.ts b/test/helpers/temp-repo.ts
index 9956f68be311..9e1d26b210c4 100644
--- a/test/helpers/temp-repo.ts
+++ b/test/helpers/temp-repo.ts
@@ -1,3 +1,4 @@
+// Temporary repo helper creates Git repositories for integration tests.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/test/helpers/ui-style-fixtures.ts b/test/helpers/ui-style-fixtures.ts
index d72fb70b8bc9..94ce2ae705fb 100644
--- a/test/helpers/ui-style-fixtures.ts
+++ b/test/helpers/ui-style-fixtures.ts
@@ -1,3 +1,4 @@
+// UI style fixtures load expected UI style files for tests.
 import { existsSync, readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
diff --git a/test/helpers/vitest-config-paths.ts b/test/helpers/vitest-config-paths.ts
index ba33730eae3c..a815152df164 100644
--- a/test/helpers/vitest-config-paths.ts
+++ b/test/helpers/vitest-config-paths.ts
@@ -1,3 +1,4 @@
+// Vitest config path helpers resolve test config fixture paths.
 import path from "node:path";
 
 // Path normalization helpers for Vitest config snapshot assertions.
diff --git a/test/helpers/wizard-prompter.ts b/test/helpers/wizard-prompter.ts
index 0b1865039827..de0c953e9e36 100644
--- a/test/helpers/wizard-prompter.ts
+++ b/test/helpers/wizard-prompter.ts
@@ -1,3 +1,4 @@
+// Wizard prompter test helper provides mocked wizard prompt responses.
 import { vi } from "vitest";
 import type { WizardPrompter } from "../../src/wizard/prompts.js";
 
diff --git a/test/mocks/baileys.ts b/test/mocks/baileys.ts
index d448bc77c83a..9cf4f1ff2ce6 100644
--- a/test/mocks/baileys.ts
+++ b/test/mocks/baileys.ts
@@ -1,3 +1,4 @@
+// Baileys mock provides a lightweight WhatsApp socket facade for tests.
 import { EventEmitter } from "node:events";
 import { vi } from "vitest";
 
diff --git a/test/vitest/discord-api-types-gateway-v10-runtime.ts b/test/vitest/discord-api-types-gateway-v10-runtime.ts
index 0bb9e7f32e1c..52b51498b083 100644
--- a/test/vitest/discord-api-types-gateway-v10-runtime.ts
+++ b/test/vitest/discord-api-types-gateway-v10-runtime.ts
@@ -1,3 +1,4 @@
+// Discord gateway types runtime helper loads discord-api-types gateway v10 at runtime.
 import { createRequire } from "node:module";
 import type * as DiscordGatewayApiTypes from "discord-api-types/gateway/v10";
 
diff --git a/test/vitest/discord-api-types-payloads-v10-runtime.ts b/test/vitest/discord-api-types-payloads-v10-runtime.ts
index 607196aa1c8a..b537c022aef7 100644
--- a/test/vitest/discord-api-types-payloads-v10-runtime.ts
+++ b/test/vitest/discord-api-types-payloads-v10-runtime.ts
@@ -1,3 +1,4 @@
+// Discord payload types runtime helper loads discord-api-types payloads at runtime.
 import { createRequire } from "node:module";
 import type * as DiscordPayloadApiTypes from "discord-api-types/payloads/v10";
 
diff --git a/test/vitest/discord-api-types-v10-runtime.ts b/test/vitest/discord-api-types-v10-runtime.ts
index fa635a40ed7d..4efc6bdf1f69 100644
--- a/test/vitest/discord-api-types-v10-runtime.ts
+++ b/test/vitest/discord-api-types-v10-runtime.ts
@@ -1,3 +1,4 @@
+// Discord API types runtime helper loads discord-api-types v10 at runtime.
 import { createRequire } from "node:module";
 import type * as DiscordApiTypes from "discord-api-types/v10";