docs: document remaining command tests

src/commands/agent-via-gateway.test.ts

@@ -1,3 +1,4 @@
+// Agent via gateway tests cover gateway-backed agent command dispatch and session loading.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/commands/auth-choice.test.ts

@@ -1,3 +1,4 @@
+// Auth choice tests cover auth choice application, provider config, and credential prompts.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { afterAll, afterEach, beforeAll, describe, expect, it, vi } from "vitest";

src/commands/backup.test.ts

@@ -1,3 +1,4 @@
+// Backup command tests cover backup create, verify, and runtime output paths.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

src/commands/channels.resolve.test.ts

@@ -1,3 +1,4 @@
+// Channels resolve tests cover channel/account selection and command output for message routing.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { channelsResolveCommand } from "./channels/resolve.js";
 

src/commands/channels.surfaces-signal-runtime-errors-channels-status-output.test.ts

@@ -1,3 +1,4 @@
+// Channels status error-surface tests cover Signal runtime errors in channel status output.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { collectStatusIssuesFromLastError } from "../plugin-sdk/status-helpers.js";
 import { setActivePluginRegistry } from "../plugins/runtime.js";

src/commands/config-validation.test.ts

@@ -1,3 +1,4 @@
+// Config validation tests cover config snapshot validation and command error handling.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { PluginCompatibilityNotice } from "../plugins/status.js";
 import { createCompatibilityNotice } from "../plugins/status.test-helpers.js";

src/commands/daemon-install-plan.shared.test.ts

@@ -1,3 +1,4 @@
+// Daemon install plan tests cover shared install plan validation and platform warning helpers.
 import { describe, expect, it } from "vitest";
 import {
   resolveDaemonInstallRuntimeInputs,

src/commands/doctor-auth.deprecated-cli-profiles.test.ts

@@ -1,3 +1,4 @@
+// Doctor deprecated CLI profile tests cover legacy auth profile migration and warnings.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { AuthProfileStore } from "../agents/auth-profiles/types.js";
 import type { OpenClawConfig } from "../config/config.js";

src/commands/doctor-completion.test.ts

@@ -1,3 +1,4 @@
+// Doctor completion tests cover final doctor status summaries and completion messaging.
 import { describe, expect, it } from "vitest";
 import {
   shellCompletionStatusToHealthFindings,

src/commands/doctor-config-flow.include-warning.test.ts

@@ -1,3 +1,4 @@
+// Doctor config-flow include-warning tests cover config include warnings during repair.
 import { describe, expect, it, vi } from "vitest";
 import { note } from "../../packages/terminal-core/src/note.js";
 import { noteIncludeConfinementWarning } from "./doctor-config-analysis.js";

src/commands/doctor-device-pairing.test.ts

@@ -1,3 +1,4 @@
+// Doctor device pairing tests cover device-pairing checks, repair prompts, and diagnostics.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";

src/commands/doctor-format.test.ts

@@ -1,3 +1,4 @@
+// Doctor format tests cover doctor output formatting and issue display helpers.
 import { describe, expect, it } from "vitest";
 import { buildGatewayRuntimeHints } from "./doctor-format.js";
 

src/commands/doctor-gateway-auth-token.test.ts

@@ -1,3 +1,4 @@
+// Doctor gateway auth token tests cover token resolution, repair prompts, and credential status output.
 import fs from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";

src/commands/doctor-heartbeat-session-target.test.ts

@@ -1,3 +1,4 @@
+// Doctor heartbeat session-target tests cover heartbeat target checks and repair output.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/commands/doctor-plugin-registry.test.ts

@@ -1,3 +1,4 @@
+// Doctor plugin registry tests cover plugin registry checks and repair diagnostics.
 import fs from "node:fs";
 import path from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";

src/commands/doctor-session-snapshots.test.ts

@@ -1,3 +1,4 @@
+// Doctor session snapshot tests cover session snapshot validation and repair guidance.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

src/commands/doctor-session-transcripts.test.ts

@@ -1,3 +1,4 @@
+// Doctor session transcript tests cover transcript inspection and repair guidance.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

src/commands/doctor-state-integrity.test.ts

@@ -1,3 +1,4 @@
+// Doctor state integrity tests cover state directory checks, migration, and repair diagnostics.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/commands/doctor-state-migrations.test.ts

@@ -1,3 +1,4 @@
+// Doctor state migration tests cover legacy state moves, archive markers, and repair behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/commands/doctor-workspace-status.test.ts

@@ -1,3 +1,4 @@
+// Doctor workspace status tests cover workspace inspection and status output.
 import { describe, expect, it, vi } from "vitest";
 import * as noteModule from "../../packages/terminal-core/src/note.js";
 import {

src/commands/doctor.warns-state-directory-is-missing.e2e.test.ts

@@ -1,3 +1,4 @@
+// Doctor missing-state e2e tests cover warning output when the state directory is absent.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/commands/export-trajectory.test.ts

@@ -1,3 +1,4 @@
+// Export trajectory tests cover trajectory export command output and file selection.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { RuntimeEnv } from "../runtime.js";
 import { exportTrajectoryCommand } from "./export-trajectory.js";

src/commands/gateway-readiness.test.ts

@@ -1,3 +1,4 @@
+// Gateway readiness tests cover readiness checks, status details, and failure messages.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { DaemonStatus } from "../cli/daemon-cli/status.gather.js";
 import { ensureGatewayReadyForOperation } from "./gateway-readiness.js";

src/commands/health.test.ts

@@ -1,3 +1,4 @@
+// Health command tests cover gateway health probes, JSON output, and status formatting.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { stripAnsi } from "../../packages/terminal-core/src/ansi.js";
 import {

src/commands/models.auth.provider-resolution.test.ts

@@ -1,3 +1,4 @@
+// Models auth provider-resolution tests cover provider auth status grouping and selection.
 import { describe, expect, it } from "vitest";
 import type { ProviderPlugin } from "../plugins/types.js";
 import { resolveRequestedLoginProviderOrThrow } from "./models/auth.js";

src/commands/node-daemon-install-helpers.test.ts

@@ -1,3 +1,4 @@
+// Node daemon install helper tests cover node daemon install plans and runtime warnings.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const mocks = vi.hoisted(() => ({

src/commands/onboard-auth.config-shared.test.ts

@@ -1,3 +1,4 @@
+// Onboard auth shared-config tests cover provider config merges for auth setup.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";
 import type { AgentModelEntryConfig } from "../config/types.agent-defaults.js";

src/commands/onboard-channels.post-write.test.ts

@@ -1,3 +1,4 @@
+// Onboard channel post-write tests cover plugin post-write hooks after channel setup.
 import { describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";
 import {

src/commands/onboard-helpers.test.ts

@@ -1,3 +1,4 @@
+// Onboard helper tests cover workspace setup, control UI links, and gateway reachability probes.
 import * as fs from "node:fs";
 import fsPromises from "node:fs/promises";
 import os from "node:os";

src/commands/onboarding-plugin-install.test.ts

@@ -1,3 +1,4 @@
+// Onboarding plugin install tests cover install sources, trust checks, and install records.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { beforeEach, describe, expect, it, vi } from "vitest";

src/commands/setup.test.ts

@@ -1,3 +1,4 @@
+// Setup command tests cover local setup initialization and next-step messaging.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { withTempHome } from "openclaw/plugin-sdk/test-env";

src/commands/status.link-channel.test.ts

@@ -1,3 +1,4 @@
+// Status link-channel tests cover channel link status summaries and redaction.
 import { describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";