docs: document command diagnostics batch

src/commands/agents.identity.test.ts

@@ -1,3 +1,4 @@
+// Agent identity tests cover identity file creation, persistence, and command integration.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { beforeEach, describe, expect, it, vi } from "vitest";

src/commands/backup.test-support.ts

@@ -1,3 +1,4 @@
+// Backup test support provides temp config/state fixtures and mocked backup runtime helpers.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { vi } from "vitest";

src/commands/channels.remove.test.ts

@@ -1,3 +1,4 @@
+// Channels remove tests cover config mutation, plugin catalog repair hints, and account removal behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ChannelPluginCatalogEntry } from "../channels/plugins/catalog.js";
 import type { ChannelPlugin } from "../channels/plugins/types.plugin.js";

src/commands/cleanup-utils.test.ts

@@ -1,3 +1,4 @@
+// Cleanup utility tests cover filesystem cleanup helpers, temp paths, and command runtime behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

src/commands/commitments.test.ts

@@ -1,3 +1,4 @@
+// Commitments command tests cover commitment list/detail output and terminal formatting.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { stripAnsi } from "../../packages/terminal-core/src/ansi.js";
 import type { CommitmentRecord } from "../commitments/types.js";

src/commands/configure.wizard.test.ts

@@ -1,3 +1,4 @@
+// Configure wizard tests cover guided setup routing across gateway, auth, channels, skills, and search.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";
 

src/commands/doctor-bootstrap-size.test.ts

@@ -1,3 +1,4 @@
+// Doctor bootstrap-size tests cover prompt-context budget warnings and note rendering.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../config/config.js";
 

src/commands/doctor-claude-cli.test.ts

@@ -1,3 +1,4 @@
+// Doctor Claude CLI tests cover CLI discovery, version checks, and repair guidance.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

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

@@ -1,3 +1,4 @@
+// Doctor plugin manifest tests cover manifest validation, missing installs, and repair guidance.
 import fs from "node:fs";
 import path from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";

src/commands/doctor-post-upgrade.test.ts

@@ -1,3 +1,4 @@
+// Doctor post-upgrade tests cover upgrade sentinel handling, config/state repair, and plugin record migration.
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import os from "node:os";

src/commands/doctor.warns-per-agent-sandbox-docker-browser-prune.e2e.test.ts

@@ -1,3 +1,4 @@
+// Doctor sandbox browser prune e2e tests cover per-agent stale browser artifacts and warning output.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/commands/sessions-tail.test.ts

@@ -1,3 +1,4 @@
+// Sessions tail tests cover transcript tailing, filtering, and session-store setup.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/commands/sessions.acp-runtime-metadata.test.ts

@@ -1,3 +1,4 @@
+// Sessions ACP runtime metadata tests cover agent runtime metadata derived from model and session keys.
 import { describe, expect, it } from "vitest";
 import { resolveModelAgentRuntimeMetadata } from "../agents/agent-runtime-metadata.js";
 import type { OpenClawConfig } from "../config/types.openclaw.js";

src/commands/sessions.kind-classification.test.ts

@@ -1,3 +1,4 @@
+// Session kind classification tests cover chat, ACP, and agent session metadata classification.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { SessionEntry } from "../config/sessions/types.js";
 import {

src/commands/status-json-command.test.ts

@@ -1,3 +1,4 @@
+// Status JSON command tests cover runtime invocation and structured status JSON output.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { runStatusJsonCommand } from "./status-json-command.ts";
 

src/commands/status-json-payload.test.ts

@@ -1,3 +1,4 @@
+// Status JSON payload tests cover update metadata, overview rows, and structured status output.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { VERSION } from "../version.js";
 import { resolveStatusUpdateChannelInfo } from "./status-all/format.js";

src/commands/status.scan.fast-json.test.ts

@@ -1,3 +1,4 @@
+// Status scan fast-json tests cover scan defaults, memory config, and JSON-safe status payloads.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   applyStatusScanDefaults,

src/commands/status.test.ts

@@ -1,3 +1,4 @@
+// Status command tests cover text/JSON output, gateway health, compatibility notices, and update state.
 import type { Mock } from "vitest";
 import { afterAll, afterEach, beforeAll, describe, expect, it, vi } from "vitest";
 import type { PluginCompatibilityNotice } from "../plugins/status.js";

src/commands/uninstall.test.ts

@@ -1,3 +1,4 @@
+// Uninstall command tests cover cleanup flow, prompts, and runtime messages.
 import { beforeEach, describe, expect, it } from "vitest";
 import {
   cleanupCommandLogMessages,