From 408ba4c8a082166f3cab1c7dad1d139970ff0cb8 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 4 Jun 2026 19:37:38 -0400
Subject: [PATCH] docs: document remaining cli tests

---
 src/cli/acp-cli.option-collisions.test.ts   | 1 +
 src/cli/channel-options.test.ts             | 1 +
 src/cli/command-config-resolution.test.ts   | 1 +
 src/cli/command-options.test.ts             | 1 +
 src/cli/completion-fish.test.ts             | 1 +
 src/cli/config-cli.integration.test.ts      | 1 +
 src/cli/config-set-input.test.ts            | 1 +
 src/cli/config-set-mode.test.ts             | 1 +
 src/cli/container-target.test.ts            | 1 +
 src/cli/cron-cli.test.ts                    | 1 +
 src/cli/daemon-cli-compat.test.ts           | 1 +
 src/cli/deps.test.ts                        | 1 +
 src/cli/devices-cli.test.ts                 | 1 +
 src/cli/exec-policy-cli.test.ts             | 1 +
 src/cli/failure-output.test.ts              | 1 +
 src/cli/help-cold-imports.test.ts           | 1 +
 src/cli/log-level-option.test.ts            | 1 +
 src/cli/model-auth-runtime-boundary.test.ts | 1 +
 src/cli/nodes-camera.test.ts                | 1 +
 src/cli/nodes-cli.coverage.test.ts          | 1 +
 src/cli/pairing-cli.test.ts                 | 1 +
 src/cli/plugin-install-plan.test.ts         | 1 +
 src/cli/plugins-authoring-command.test.ts   | 1 +
 src/cli/plugins-cli.install.test.ts         | 1 +
 src/cli/plugins-cli.lazy.test.ts            | 1 +
 src/cli/plugins-cli.policy.test.ts          | 1 +
 src/cli/plugins-config.test.ts              | 1 +
 src/cli/plugins-install-config.test.ts      | 1 +
 src/cli/plugins-install-persist.test.ts     | 1 +
 src/cli/plugins-list-command.test.ts        | 1 +
 src/cli/plugins-search-command.test.ts      | 1 +
 src/cli/ports.test.ts                       | 1 +
 src/cli/program.nodes-test-helpers.test.ts  | 1 +
 src/cli/run-main.exit.test.ts               | 1 +
 src/cli/secrets-cli.test.ts                 | 1 +
 src/cli/security-cli.test.ts                | 1 +
 src/cli/skills-cli.test.ts                  | 1 +
 src/cli/skills-cli.verify.test.ts           | 1 +
 src/cli/windows-argv.test.ts                | 1 +
 39 files changed, 39 insertions(+)

diff --git a/src/cli/acp-cli.option-collisions.test.ts b/src/cli/acp-cli.option-collisions.test.ts
index 17503f494517..aeb3da57e265 100644
--- a/src/cli/acp-cli.option-collisions.test.ts
+++ b/src/cli/acp-cli.option-collisions.test.ts
@@ -1,3 +1,4 @@
+// ACP CLI option collision tests cover ACP command flag registration boundaries.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { runRegisteredCli } from "../test-utils/command-runner.js";
diff --git a/src/cli/channel-options.test.ts b/src/cli/channel-options.test.ts
index 748268171318..c12d06f3a939 100644
--- a/src/cli/channel-options.test.ts
+++ b/src/cli/channel-options.test.ts
@@ -1,3 +1,4 @@
+// Channel option tests cover channel command option parsing and config resolution.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { testing, formatCliChannelOptions, resolveCliChannelOptions } from "./channel-options.js";
 import { testing as startupMetadataTesting } from "./startup-metadata.js";
diff --git a/src/cli/command-config-resolution.test.ts b/src/cli/command-config-resolution.test.ts
index 2d35e7cf61c5..8cbeed7042b2 100644
--- a/src/cli/command-config-resolution.test.ts
+++ b/src/cli/command-config-resolution.test.ts
@@ -1,3 +1,4 @@
+// Command config resolution tests cover config lookup before command execution.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const mocks = vi.hoisted(() => ({
diff --git a/src/cli/command-options.test.ts b/src/cli/command-options.test.ts
index 3013747f6dc6..43e83fbce85b 100644
--- a/src/cli/command-options.test.ts
+++ b/src/cli/command-options.test.ts
@@ -1,3 +1,4 @@
+// Command option tests cover shared CLI option registration and parsing.
 import { Command } from "commander";
 import { describe, expect, it } from "vitest";
 import { inheritOptionFromParent } from "./command-options.js";
diff --git a/src/cli/completion-fish.test.ts b/src/cli/completion-fish.test.ts
index b1b15bf0aeda..7c61b05ca81a 100644
--- a/src/cli/completion-fish.test.ts
+++ b/src/cli/completion-fish.test.ts
@@ -1,3 +1,4 @@
+// Fish completion tests cover fish shell completion script generation.
 import { describe, expect, it } from "vitest";
 import {
   buildFishOptionCompletionLine,
diff --git a/src/cli/config-cli.integration.test.ts b/src/cli/config-cli.integration.test.ts
index 08654fc65183..5a303a606386 100644
--- a/src/cli/config-cli.integration.test.ts
+++ b/src/cli/config-cli.integration.test.ts
@@ -1,3 +1,4 @@
+// Config CLI integration tests cover end-to-end config command reads and writes.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/config-set-input.test.ts b/src/cli/config-set-input.test.ts
index 8ff1595f503b..5844db148675 100644
--- a/src/cli/config-set-input.test.ts
+++ b/src/cli/config-set-input.test.ts
@@ -1,3 +1,4 @@
+// Config set input tests cover config value parsing from CLI input and files.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/config-set-mode.test.ts b/src/cli/config-set-mode.test.ts
index 3c73e0c9bafd..677b89956d6d 100644
--- a/src/cli/config-set-mode.test.ts
+++ b/src/cli/config-set-mode.test.ts
@@ -1,3 +1,4 @@
+// Config set mode tests cover config set input modes and value parsing.
 import { describe, expect, it } from "vitest";
 import { resolveConfigSetMode } from "./config-set-parser.js";
 
diff --git a/src/cli/container-target.test.ts b/src/cli/container-target.test.ts
index cd4c665bcc3a..668d57272e1b 100644
--- a/src/cli/container-target.test.ts
+++ b/src/cli/container-target.test.ts
@@ -1,3 +1,4 @@
+// Container target tests cover CLI container target parsing and validation.
 import { describe, expect, it, vi } from "vitest";
 import {
   maybeRunCliInContainer,
diff --git a/src/cli/cron-cli.test.ts b/src/cli/cron-cli.test.ts
index 8dbddf3aeee6..81b3085017be 100644
--- a/src/cli/cron-cli.test.ts
+++ b/src/cli/cron-cli.test.ts
@@ -1,3 +1,4 @@
+// Cron CLI tests cover cron command registration and schedule output.
 import { Command } from "commander";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { CronJob } from "../cron/types.js";
diff --git a/src/cli/daemon-cli-compat.test.ts b/src/cli/daemon-cli-compat.test.ts
index 4a1a1666de18..757939e85c3d 100644
--- a/src/cli/daemon-cli-compat.test.ts
+++ b/src/cli/daemon-cli-compat.test.ts
@@ -1,3 +1,4 @@
+// Daemon CLI compatibility tests cover legacy daemon command aliases and output.
 import { describe, expect, it } from "vitest";
 import {
   resolveLegacyDaemonCliAccessors,
diff --git a/src/cli/deps.test.ts b/src/cli/deps.test.ts
index 9c80f7a23a7a..279dca005cd3 100644
--- a/src/cli/deps.test.ts
+++ b/src/cli/deps.test.ts
@@ -1,3 +1,4 @@
+// Dependency tests cover CLI dependency imports and cold-start safety.
 import { importFreshModule } from "openclaw/plugin-sdk/test-fixtures";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { ChannelPlugin } from "../channels/plugins/types.js";
diff --git a/src/cli/devices-cli.test.ts b/src/cli/devices-cli.test.ts
index 110fe3abc900..24957679169a 100644
--- a/src/cli/devices-cli.test.ts
+++ b/src/cli/devices-cli.test.ts
@@ -1,3 +1,4 @@
+// Devices CLI tests cover device command registration and output behavior.
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { stripAnsi } from "../../packages/terminal-core/src/ansi.js";
diff --git a/src/cli/exec-policy-cli.test.ts b/src/cli/exec-policy-cli.test.ts
index e65ca41f547b..a81dc05c4a94 100644
--- a/src/cli/exec-policy-cli.test.ts
+++ b/src/cli/exec-policy-cli.test.ts
@@ -1,3 +1,4 @@
+// Exec policy CLI tests cover execution policy command behavior and persistence.
 import crypto from "node:crypto";
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/src/cli/failure-output.test.ts b/src/cli/failure-output.test.ts
index 37b803e46093..0d2baacce37a 100644
--- a/src/cli/failure-output.test.ts
+++ b/src/cli/failure-output.test.ts
@@ -1,3 +1,4 @@
+// Failure output tests cover CLI error formatting and failure summaries.
 import { describe, expect, it } from "vitest";
 import { formatCliFailureLines } from "./failure-output.js";
 
diff --git a/src/cli/help-cold-imports.test.ts b/src/cli/help-cold-imports.test.ts
index a74f671c9541..83ccb638da7d 100644
--- a/src/cli/help-cold-imports.test.ts
+++ b/src/cli/help-cold-imports.test.ts
@@ -1,3 +1,4 @@
+// Help cold import tests cover root help output without loading heavy command modules.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/src/cli/log-level-option.test.ts b/src/cli/log-level-option.test.ts
index d361a1554476..1d9d0fe292b9 100644
--- a/src/cli/log-level-option.test.ts
+++ b/src/cli/log-level-option.test.ts
@@ -1,3 +1,4 @@
+// Log level option tests cover CLI log-level flag parsing and validation.
 import { describe, expect, it } from "vitest";
 import { parseCliLogLevelOption } from "./log-level-option.js";
 
diff --git a/src/cli/model-auth-runtime-boundary.test.ts b/src/cli/model-auth-runtime-boundary.test.ts
index dd3d9b53b93d..aced8d58a6db 100644
--- a/src/cli/model-auth-runtime-boundary.test.ts
+++ b/src/cli/model-auth-runtime-boundary.test.ts
@@ -1,3 +1,4 @@
+// Model auth runtime boundary tests cover CLI/model auth import boundaries.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
diff --git a/src/cli/nodes-camera.test.ts b/src/cli/nodes-camera.test.ts
index c3632838019c..fccd9a6554fc 100644
--- a/src/cli/nodes-camera.test.ts
+++ b/src/cli/nodes-camera.test.ts
@@ -1,3 +1,4 @@
+// Nodes camera tests cover camera node command media handling and file inputs.
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/src/cli/nodes-cli.coverage.test.ts b/src/cli/nodes-cli.coverage.test.ts
index cbdf19114093..99df4b3b8d64 100644
--- a/src/cli/nodes-cli.coverage.test.ts
+++ b/src/cli/nodes-cli.coverage.test.ts
@@ -1,3 +1,4 @@
+// Nodes CLI coverage tests cover node command branches and output formatting.
 import { Command } from "commander";
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { registerNodesCli } from "./nodes-cli.js";
diff --git a/src/cli/pairing-cli.test.ts b/src/cli/pairing-cli.test.ts
index 8b036ed0010f..520f4f583ebc 100644
--- a/src/cli/pairing-cli.test.ts
+++ b/src/cli/pairing-cli.test.ts
@@ -1,3 +1,4 @@
+// Pairing CLI tests cover pairing command registration and pairing status output.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { theme } from "../../packages/terminal-core/src/theme.js";
diff --git a/src/cli/plugin-install-plan.test.ts b/src/cli/plugin-install-plan.test.ts
index 5cf2dba83bfb..5a52d50e39e6 100644
--- a/src/cli/plugin-install-plan.test.ts
+++ b/src/cli/plugin-install-plan.test.ts
@@ -1,3 +1,4 @@
+// Plugin install plan tests cover install planning for local, registry, and bundled plugins.
 import { installedPluginRoot } from "openclaw/plugin-sdk/test-fixtures";
 import { describe, expect, it, vi } from "vitest";
 import { PLUGIN_INSTALL_ERROR_CODE } from "../plugins/install.js";
diff --git a/src/cli/plugins-authoring-command.test.ts b/src/cli/plugins-authoring-command.test.ts
index cbec20bdccbe..a677a7b6b08d 100644
--- a/src/cli/plugins-authoring-command.test.ts
+++ b/src/cli/plugins-authoring-command.test.ts
@@ -1,3 +1,4 @@
+// Plugins authoring command tests cover plugin authoring command output and file generation.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/plugins-cli.install.test.ts b/src/cli/plugins-cli.install.test.ts
index 8567b1e9dba1..193a0c2fb33e 100644
--- a/src/cli/plugins-cli.install.test.ts
+++ b/src/cli/plugins-cli.install.test.ts
@@ -1,3 +1,4 @@
+// Plugins CLI install tests cover plugin install command selection and output.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/plugins-cli.lazy.test.ts b/src/cli/plugins-cli.lazy.test.ts
index 6af944d4dfab..c78deaba9fa4 100644
--- a/src/cli/plugins-cli.lazy.test.ts
+++ b/src/cli/plugins-cli.lazy.test.ts
@@ -1,3 +1,4 @@
+// Plugins CLI lazy tests cover lazy plugin command registration and imports.
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/src/cli/plugins-cli.policy.test.ts b/src/cli/plugins-cli.policy.test.ts
index 8ee64e12eab7..ca2a8300272d 100644
--- a/src/cli/plugins-cli.policy.test.ts
+++ b/src/cli/plugins-cli.policy.test.ts
@@ -1,3 +1,4 @@
+// Plugins CLI policy tests cover plugin command policy checks and warnings.
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";
 import {
diff --git a/src/cli/plugins-config.test.ts b/src/cli/plugins-config.test.ts
index 3406c22e54d0..8338a0c651ff 100644
--- a/src/cli/plugins-config.test.ts
+++ b/src/cli/plugins-config.test.ts
@@ -1,3 +1,4 @@
+// Plugin config tests cover plugin config command parsing and output formatting.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";
 import { setPluginEnabledInConfig } from "./plugins-config.js";
diff --git a/src/cli/plugins-install-config.test.ts b/src/cli/plugins-install-config.test.ts
index 249d9d125725..5008696e279c 100644
--- a/src/cli/plugins-install-config.test.ts
+++ b/src/cli/plugins-install-config.test.ts
@@ -1,3 +1,4 @@
+// Plugin install config tests cover install specs and generated plugin config.
 import { bundledPluginRootAt, repoInstallSpec } from "openclaw/plugin-sdk/test-fixtures";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";
diff --git a/src/cli/plugins-install-persist.test.ts b/src/cli/plugins-install-persist.test.ts
index 0e1ea5c86e92..431893d6aa0d 100644
--- a/src/cli/plugins-install-persist.test.ts
+++ b/src/cli/plugins-install-persist.test.ts
@@ -1,3 +1,4 @@
+// Plugin install persist tests cover saving installed plugin records after install.
 import { beforeEach, describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";
 import {
diff --git a/src/cli/plugins-list-command.test.ts b/src/cli/plugins-list-command.test.ts
index a5ee1a3725da..870124646815 100644
--- a/src/cli/plugins-list-command.test.ts
+++ b/src/cli/plugins-list-command.test.ts
@@ -1,3 +1,4 @@
+// Plugins list command tests cover plugin list command execution and output.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { OutputRuntimeEnv } from "../runtime.js";
 
diff --git a/src/cli/plugins-search-command.test.ts b/src/cli/plugins-search-command.test.ts
index 855910fa3cc4..51456d3942e8 100644
--- a/src/cli/plugins-search-command.test.ts
+++ b/src/cli/plugins-search-command.test.ts
@@ -1,3 +1,4 @@
+// Plugins search command tests cover plugin search command registration and results.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/src/cli/ports.test.ts b/src/cli/ports.test.ts
index cf7859ea91ac..e677a012b4c2 100644
--- a/src/cli/ports.test.ts
+++ b/src/cli/ports.test.ts
@@ -1,3 +1,4 @@
+// Port tests cover CLI port probing and conflict handling.
 import { EventEmitter } from "node:events";
 import net from "node:net";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/src/cli/program.nodes-test-helpers.test.ts b/src/cli/program.nodes-test-helpers.test.ts
index 81db08657e9c..84a859a736ba 100644
--- a/src/cli/program.nodes-test-helpers.test.ts
+++ b/src/cli/program.nodes-test-helpers.test.ts
@@ -1,3 +1,4 @@
+// Program nodes test-helper tests cover node command fixture helpers.
 import { describe, expect, it } from "vitest";
 import { IOS_NODE, createIosNodeListResponse } from "./program.nodes-test-helpers.js";
 
diff --git a/src/cli/run-main.exit.test.ts b/src/cli/run-main.exit.test.ts
index bdfebad0cc21..1a16bc0e053d 100644
--- a/src/cli/run-main.exit.test.ts
+++ b/src/cli/run-main.exit.test.ts
@@ -1,3 +1,4 @@
+// Run main exit tests cover process exit behavior for CLI failures.
 import process from "node:process";
 import { CommanderError } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/src/cli/secrets-cli.test.ts b/src/cli/secrets-cli.test.ts
index 6d92dc01f8b2..d10849de0445 100644
--- a/src/cli/secrets-cli.test.ts
+++ b/src/cli/secrets-cli.test.ts
@@ -1,3 +1,4 @@
+// Secrets CLI tests cover secret command registration, reads, writes, and redaction.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/security-cli.test.ts b/src/cli/security-cli.test.ts
index 2a14a1ab480d..75ef254a4785 100644
--- a/src/cli/security-cli.test.ts
+++ b/src/cli/security-cli.test.ts
@@ -1,3 +1,4 @@
+// Security CLI tests cover security command registration and diagnostics output.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { registerSecurityCli } from "./security-cli.js";
diff --git a/src/cli/skills-cli.test.ts b/src/cli/skills-cli.test.ts
index f5795bf544a8..9499714245de 100644
--- a/src/cli/skills-cli.test.ts
+++ b/src/cli/skills-cli.test.ts
@@ -1,3 +1,4 @@
+// Skills CLI tests cover skill listing, install, and command output behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { SkillStatusEntry, SkillStatusReport } from "../skills/discovery/status.js";
 import { createEmptyInstallChecks } from "./requirements-test-fixtures.js";
diff --git a/src/cli/skills-cli.verify.test.ts b/src/cli/skills-cli.verify.test.ts
index 85d19a7d24aa..431952fa263e 100644
--- a/src/cli/skills-cli.verify.test.ts
+++ b/src/cli/skills-cli.verify.test.ts
@@ -1,3 +1,4 @@
+// Skills CLI verify tests cover skill verification command behavior and diagnostics.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/cli/windows-argv.test.ts b/src/cli/windows-argv.test.ts
index ebf05ec301e0..f0659aa75ccc 100644
--- a/src/cli/windows-argv.test.ts
+++ b/src/cli/windows-argv.test.ts
@@ -1,3 +1,4 @@
+// Windows argv tests cover Windows-specific command-line argument normalization.
 import { describe, expect, it } from "vitest";
 import { mockProcessPlatform } from "../test-utils/vitest-spies.js";
 import { normalizeWindowsArgv } from "./windows-argv.js";