diff --git a/src/cli/program/action-reparse.test.ts b/src/cli/program/action-reparse.test.ts
index 9fcfe0f5ac50..80018e8e68e0 100644
--- a/src/cli/program/action-reparse.test.ts
+++ b/src/cli/program/action-reparse.test.ts
@@ -1,3 +1,4 @@
+// Action reparse tests cover Commander action reparsing for nested CLI commands.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { reparseProgramFromActionArgs } from "./action-reparse.js";
diff --git a/src/cli/program/build-program.test.ts b/src/cli/program/build-program.test.ts
index bc2887d6d441..6b1528adaa1e 100644
--- a/src/cli/program/build-program.test.ts
+++ b/src/cli/program/build-program.test.ts
@@ -1,3 +1,4 @@
+// Build program tests cover root CLI program construction and command wiring.
 import process from "node:process";
 import { Command, CommanderError } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/src/cli/program/build-program.version-alias.test.ts b/src/cli/program/build-program.version-alias.test.ts
index 957962701ee5..403c08f14c61 100644
--- a/src/cli/program/build-program.version-alias.test.ts
+++ b/src/cli/program/build-program.version-alias.test.ts
@@ -1,3 +1,4 @@
+// Build program version alias tests cover version flag aliases on the root program.
 import process from "node:process";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { buildProgram } from "./build-program.js";
diff --git a/src/cli/program/command-descriptor-utils.test.ts b/src/cli/program/command-descriptor-utils.test.ts
index 864601a9bd63..2b0483e2dcf4 100644
--- a/src/cli/program/command-descriptor-utils.test.ts
+++ b/src/cli/program/command-descriptor-utils.test.ts
@@ -1,3 +1,4 @@
+// Command descriptor utility tests cover CLI descriptor helpers and Commander integration.
 import { Command } from "commander";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/src/cli/program/command-group-descriptors.test.ts b/src/cli/program/command-group-descriptors.test.ts
index b95c3c6e6401..ae31e585bb47 100644
--- a/src/cli/program/command-group-descriptors.test.ts
+++ b/src/cli/program/command-group-descriptors.test.ts
@@ -1,3 +1,4 @@
+// Command group descriptor tests cover grouped CLI command metadata and help organization.
 import { describe, expect, it, vi } from "vitest";
 import {
   buildCommandGroupEntries,
diff --git a/src/cli/program/command-registry.test.ts b/src/cli/program/command-registry.test.ts
index 311dcd376853..a248a48f5f6c 100644
--- a/src/cli/program/command-registry.test.ts
+++ b/src/cli/program/command-registry.test.ts
@@ -1,3 +1,4 @@
+// Command registry tests cover CLI command descriptor registry behavior.
 import { Command } from "commander";
 import { describe, expect, it, vi } from "vitest";
 import type { ProgramContext } from "./context.js";
diff --git a/src/cli/program/command-tree.test.ts b/src/cli/program/command-tree.test.ts
index b77010a17d39..94b947cde42f 100644
--- a/src/cli/program/command-tree.test.ts
+++ b/src/cli/program/command-tree.test.ts
@@ -1,3 +1,4 @@
+// Command tree tests cover CLI command hierarchy construction and lookup.
 import { Command } from "commander";
 import { describe, expect, it } from "vitest";
 import { removeCommand, removeCommandByName } from "./command-tree.js";
diff --git a/src/cli/program/config-guard.test.ts b/src/cli/program/config-guard.test.ts
index 4310bb204121..2cbd667753b0 100644
--- a/src/cli/program/config-guard.test.ts
+++ b/src/cli/program/config-guard.test.ts
@@ -1,3 +1,4 @@
+// Config guard tests cover program-level config checks before command execution.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/program/context.test.ts b/src/cli/program/context.test.ts
index 2e839b082461..aa33c8d54db0 100644
--- a/src/cli/program/context.test.ts
+++ b/src/cli/program/context.test.ts
@@ -1,3 +1,4 @@
+// Program context tests cover shared CLI context helpers and runtime injections.
 import { describe, expect, it, vi } from "vitest";
 import { createProgramContext } from "./context.js";
 
diff --git a/src/cli/program/error-output.test.ts b/src/cli/program/error-output.test.ts
index 3c63d1c1b969..987809a80121 100644
--- a/src/cli/program/error-output.test.ts
+++ b/src/cli/program/error-output.test.ts
@@ -1,3 +1,4 @@
+// Error output tests cover program-level error display and exit messaging.
 import { describe, expect, it } from "vitest";
 import { formatCliParseErrorOutput } from "./error-output.js";
 
diff --git a/src/cli/program/help.test.ts b/src/cli/program/help.test.ts
index 8f701bebe414..0ca25097f673 100644
--- a/src/cli/program/help.test.ts
+++ b/src/cli/program/help.test.ts
@@ -1,3 +1,4 @@
+// Help tests cover command help generation and inherited help options.
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ProgramContext } from "./context.js";
diff --git a/src/cli/program/helpers.test.ts b/src/cli/program/helpers.test.ts
index f7892a71fa32..5b2876d956c2 100644
--- a/src/cli/program/helpers.test.ts
+++ b/src/cli/program/helpers.test.ts
@@ -1,3 +1,4 @@
+// Program helper tests cover shared command registration and help helpers.
 import { Command } from "commander";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/src/cli/program/message/helpers.test.ts b/src/cli/program/message/helpers.test.ts
index 46084e2344d9..169a2020cecd 100644
--- a/src/cli/program/message/helpers.test.ts
+++ b/src/cli/program/message/helpers.test.ts
@@ -1,3 +1,4 @@
+// Message program helper tests cover message command helper behavior and mocks.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const messageCommandMock = vi.fn(async () => {});
diff --git a/src/cli/program/message/register.thread.test.ts b/src/cli/program/message/register.thread.test.ts
index 2164cba70892..982099de0775 100644
--- a/src/cli/program/message/register.thread.test.ts
+++ b/src/cli/program/message/register.thread.test.ts
@@ -1,3 +1,4 @@
+// Register thread tests cover message thread command registration and option wiring.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { setActivePluginRegistry } from "../../../plugins/runtime.js";
diff --git a/src/cli/program/parent-default-help.test.ts b/src/cli/program/parent-default-help.test.ts
index dde514ab6dd9..af8ccdfd5171 100644
--- a/src/cli/program/parent-default-help.test.ts
+++ b/src/cli/program/parent-default-help.test.ts
@@ -1,3 +1,4 @@
+// Parent default help tests cover parent command help fallback behavior.
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { applyParentDefaultHelpAction, isParentDefaultHelpAction } from "./parent-default-help.js";
diff --git a/src/cli/program/preaction.test.ts b/src/cli/program/preaction.test.ts
index 967c12532c7a..93d778ff9e86 100644
--- a/src/cli/program/preaction.test.ts
+++ b/src/cli/program/preaction.test.ts
@@ -1,3 +1,4 @@
+// Preaction tests cover CLI preaction hooks and command context setup.
 import { Command } from "commander";
 import { repoInstallSpec } from "openclaw/plugin-sdk/test-fixtures";
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/src/cli/program/private-qa-cli.test.ts b/src/cli/program/private-qa-cli.test.ts
index 4fe03c1cdef2..d2e06b7c0fcc 100644
--- a/src/cli/program/private-qa-cli.test.ts
+++ b/src/cli/program/private-qa-cli.test.ts
@@ -1,3 +1,4 @@
+// Private QA CLI tests cover private QA command registration and filesystem behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/program/program-context.test.ts b/src/cli/program/program-context.test.ts
index 72128be90bd8..0d1b045402e9 100644
--- a/src/cli/program/program-context.test.ts
+++ b/src/cli/program/program-context.test.ts
@@ -1,3 +1,4 @@
+// Program context tests cover command context creation and propagation.
 import { Command } from "commander";
 import { describe, expect, it } from "vitest";
 import type { ProgramContext } from "./context.js";
diff --git a/src/cli/program/register.agent.test.ts b/src/cli/program/register.agent.test.ts
index 9929d3acf95f..b29226405c97 100644
--- a/src/cli/program/register.agent.test.ts
+++ b/src/cli/program/register.agent.test.ts
@@ -1,3 +1,4 @@
+// Register agent tests cover agent command registration and option wiring.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { registerAgentCommands } from "./register.agent.js";
diff --git a/src/cli/program/register.backup.test.ts b/src/cli/program/register.backup.test.ts
index d04eaeb21709..ddf5bae6f405 100644
--- a/src/cli/program/register.backup.test.ts
+++ b/src/cli/program/register.backup.test.ts
@@ -1,3 +1,4 @@
+// Register backup tests cover backup command registration and option wiring.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { registerBackupCommand } from "./register.backup.js";
diff --git a/src/cli/program/register.configure.test.ts b/src/cli/program/register.configure.test.ts
index 8c81ca42a3dc..d29a36af9db1 100644
--- a/src/cli/program/register.configure.test.ts
+++ b/src/cli/program/register.configure.test.ts
@@ -1,3 +1,4 @@
+// Register configure tests cover configure command registration and option wiring.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { registerConfigureCommand } from "./register.configure.js";
diff --git a/src/cli/program/register.maintenance.test.ts b/src/cli/program/register.maintenance.test.ts
index d91db9434f11..9e5aa71f314b 100644
--- a/src/cli/program/register.maintenance.test.ts
+++ b/src/cli/program/register.maintenance.test.ts
@@ -1,3 +1,4 @@
+// Register maintenance tests cover maintenance command registration in the CLI program.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { registerMaintenanceCommands } from "./register.maintenance.js";
diff --git a/src/cli/program/register.message.test.ts b/src/cli/program/register.message.test.ts
index 083f5df22541..68766be742c0 100644
--- a/src/cli/program/register.message.test.ts
+++ b/src/cli/program/register.message.test.ts
@@ -1,3 +1,4 @@
+// Register message tests cover message command registration in the CLI program.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { ProgramContext } from "./context.js";
diff --git a/src/cli/program/register.onboard.test.ts b/src/cli/program/register.onboard.test.ts
index a5387193f4da..469c0a7b49e5 100644
--- a/src/cli/program/register.onboard.test.ts
+++ b/src/cli/program/register.onboard.test.ts
@@ -1,3 +1,4 @@
+// Register onboard tests cover onboarding command registration and option wiring.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { registerOnboardCommand } from "./register.onboard.js";
diff --git a/src/cli/program/register.setup.test.ts b/src/cli/program/register.setup.test.ts
index 1049361b73c4..32f4a2a4aaea 100644
--- a/src/cli/program/register.setup.test.ts
+++ b/src/cli/program/register.setup.test.ts
@@ -1,3 +1,4 @@
+// Register setup tests cover setup command registration and option wiring.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { registerSetupCommand } from "./register.setup.js";
diff --git a/src/cli/program/register.status-health-sessions.test.ts b/src/cli/program/register.status-health-sessions.test.ts
index 0ac7970b3060..d3f14a22f1f8 100644
--- a/src/cli/program/register.status-health-sessions.test.ts
+++ b/src/cli/program/register.status-health-sessions.test.ts
@@ -1,3 +1,4 @@
+// Register status/health/session tests cover status-related command registration.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { registerStatusHealthSessionsCommands } from "./register.status-health-sessions.js";
diff --git a/src/cli/program/register.subclis.test.ts b/src/cli/program/register.subclis.test.ts
index d3f59f5b1bea..5b179afec89b 100644
--- a/src/cli/program/register.subclis.test.ts
+++ b/src/cli/program/register.subclis.test.ts
@@ -1,3 +1,4 @@
+// Register subCLI tests cover nested CLI command registration boundaries.
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { registerSubCliByName, registerSubCliCommands } from "./register.subclis.js";
diff --git a/src/cli/program/register.transcripts.test.ts b/src/cli/program/register.transcripts.test.ts
index 08c7c03c9893..6dbfec6dabd8 100644
--- a/src/cli/program/register.transcripts.test.ts
+++ b/src/cli/program/register.transcripts.test.ts
@@ -1,3 +1,4 @@
+// Register transcripts tests cover transcript command registration and file handling.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/program/root-help.test.ts b/src/cli/program/root-help.test.ts
index 9ee56d9837d1..9973bb14df1f 100644
--- a/src/cli/program/root-help.test.ts
+++ b/src/cli/program/root-help.test.ts
@@ -1,3 +1,4 @@
+// Root help tests cover top-level help rendering and command visibility.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { renderRootHelpText } from "./root-help.js";
 
diff --git a/src/cli/program/route-args.test.ts b/src/cli/program/route-args.test.ts
index ab2bb6ab2487..1a9e00fb6701 100644
--- a/src/cli/program/route-args.test.ts
+++ b/src/cli/program/route-args.test.ts
@@ -1,3 +1,4 @@
+// Route argument tests cover program route argument parsing and validation.
 import { describe, expect, it } from "vitest";
 import {
   parseAgentsListRouteArgs,
diff --git a/src/cli/program/routes.test.ts b/src/cli/program/routes.test.ts
index daef522a02a2..7c35591ca788 100644
--- a/src/cli/program/routes.test.ts
+++ b/src/cli/program/routes.test.ts
@@ -1,3 +1,4 @@
+// Program route tests cover CLI route table registration and dispatch.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { defaultRuntime } from "../../runtime.js";
 import { findRoutedCommand } from "./routes.js";
diff --git a/src/cli/program/subcli-descriptors.test.ts b/src/cli/program/subcli-descriptors.test.ts
index 5c562051af06..d82db228ceaa 100644
--- a/src/cli/program/subcli-descriptors.test.ts
+++ b/src/cli/program/subcli-descriptors.test.ts
@@ -1,3 +1,4 @@
+// SubCLI descriptor tests cover metadata for registered nested command groups.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 async function importSubCliDescriptors() {
diff --git a/src/cli/update-cli/plugin-payload-validation.test.ts b/src/cli/update-cli/plugin-payload-validation.test.ts
index 07bac283c142..717483770061 100644
--- a/src/cli/update-cli/plugin-payload-validation.test.ts
+++ b/src/cli/update-cli/plugin-payload-validation.test.ts
@@ -1,3 +1,4 @@
+// Plugin payload validation tests cover update payload checks for plugin updates.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/update-cli/post-core-plugin-convergence.test.ts b/src/cli/update-cli/post-core-plugin-convergence.test.ts
index 80c694486ed3..ee18733e5668 100644
--- a/src/cli/update-cli/post-core-plugin-convergence.test.ts
+++ b/src/cli/update-cli/post-core-plugin-convergence.test.ts
@@ -1,3 +1,4 @@
+// Post-core plugin convergence tests cover update convergence checks after core updates.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/update-cli/progress.test.ts b/src/cli/update-cli/progress.test.ts
index a9eea2e4ed14..bcb1a36f43fe 100644
--- a/src/cli/update-cli/progress.test.ts
+++ b/src/cli/update-cli/progress.test.ts
@@ -1,3 +1,4 @@
+// Update progress tests cover progress event formatting for update operations.
 import { describe, expect, it } from "vitest";
 import type { UpdateRunResult } from "../../infra/update-runner.js";
 import { inferUpdateFailureHints } from "./progress.js";
diff --git a/src/cli/update-cli/restart-helper.test.ts b/src/cli/update-cli/restart-helper.test.ts
index dd16bc0d5ae0..571739c9ecaa 100644
--- a/src/cli/update-cli/restart-helper.test.ts
+++ b/src/cli/update-cli/restart-helper.test.ts
@@ -1,3 +1,4 @@
+// Restart helper tests cover update restart helper process selection and error handling.
 import { execFile, spawn, type ChildProcess } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/src/cli/update-cli/shared.command-runner.test.ts b/src/cli/update-cli/shared.command-runner.test.ts
index 9f17d1fadcc4..0a332d3e8e78 100644
--- a/src/cli/update-cli/shared.command-runner.test.ts
+++ b/src/cli/update-cli/shared.command-runner.test.ts
@@ -1,3 +1,4 @@
+// Shared command runner tests cover update helper command execution and error capture.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { defaultRuntime } from "../../runtime.js";
 import { createGlobalCommandRunner, parseTimeoutMsOrExit } from "./shared.js";
diff --git a/src/cli/update-cli/update-command.test.ts b/src/cli/update-cli/update-command.test.ts
index 21746b2d9960..97369c5e04d5 100644
--- a/src/cli/update-cli/update-command.test.ts
+++ b/src/cli/update-cli/update-command.test.ts
@@ -1,3 +1,4 @@
+// Update command tests cover update command orchestration and filesystem effects.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";