docs: document command scan batch

src/commands/agent.delivery.test.ts

@@ -1,3 +1,4 @@
+// Agent delivery tests cover command result delivery to reply payloads and CLI dependencies.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { deliverAgentCommandResult } from "../agents/command/delivery.js";
 import type { ReplyPayload } from "../auto-reply/types.js";

src/commands/agents.bind.commands.test.ts

@@ -1,3 +1,4 @@
+// Agent bind command tests cover channel bindings, plugin metadata, and command output.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ChannelId, ChannelPlugin } from "../channels/plugins/types.public.js";
 import type { RuntimeEnv } from "../runtime.js";

src/commands/agents.providers.test.ts

@@ -1,3 +1,4 @@
+// Agents provider tests cover provider status index construction for configured agents.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../config/types.openclaw.js";
 import { buildProviderStatusIndex } from "./agents.providers.js";

src/commands/auth-choice.preferred-provider.test.ts

@@ -1,3 +1,4 @@
+// Preferred provider tests cover auth-choice provider selection and runtime provider discovery.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { resolvePluginProviders as resolvePluginProvidersFn } from "../plugins/providers.runtime.js";
 

src/commands/channels.add.test.ts

@@ -1,3 +1,4 @@
+// Channels add tests cover guided setup, plugin install paths, and channel account config writes.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { getBundledChannelSetupPlugin } from "../channels/plugins/bundled.js";
 import type { ChannelPluginCatalogEntry } from "../channels/plugins/catalog.js";

src/commands/channels.plugin-install.test-helpers.ts

@@ -1,3 +1,4 @@
+// Channels plugin-install test helpers build catalog, plugin, and config fixtures for add/remove suites.
 import { vi } from "vitest";
 import type { ChannelPluginCatalogEntry } from "../channels/plugins/catalog.js";
 import type { ChannelPlugin } from "../channels/plugins/types.plugin.js";

src/commands/configure.gateway-auth.test.ts

@@ -1,3 +1,4 @@
+// Configure gateway auth tests cover gateway auth config generation and token handling.
 import { describe, expect, it } from "vitest";
 import { buildGatewayAuthConfig } from "./configure.js";
 

src/commands/dashboard.links.test.ts

@@ -1,3 +1,4 @@
+// Dashboard link tests cover dashboard command URL resolution and config snapshot handling.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { dashboardCommand } from "./dashboard.js";
 

src/commands/doctor-config-preflight.state-migration.test.ts

@@ -1,3 +1,4 @@
+// Doctor config preflight tests cover state migration preflight behavior before config repair.
 import { describe, expect, it, vi } from "vitest";
 
 const autoMigrateLegacyStateDir = vi.hoisted(() =>

src/commands/doctor-session-state-providers.test.ts

@@ -1,3 +1,4 @@
+// Doctor session state provider tests cover route-state repair and configured provider resolution.
 import { describe, expect, it, vi } from "vitest";
 import {
   applySessionRouteStateRepair,

src/commands/doctor-skills.test.ts

@@ -1,3 +1,4 @@
+// Doctor skills tests cover skill install checks, status summaries, and repair guidance.
 import { describe, expect, it } from "vitest";
 import { createEmptyInstallChecks } from "../cli/requirements-test-fixtures.js";
 import type { OpenClawConfig } from "../config/types.openclaw.js";

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

@@ -1,3 +1,4 @@
+// Doctor Linux storage tests cover SD-card-backed state directory detection.
 import path from "node:path";
 import { describe, expect, it } from "vitest";
 import {

src/commands/onboard-channels.e2e.test.ts

@@ -1,3 +1,4 @@
+// Onboard channels e2e tests cover setup wizard adapters, plugin install hooks, and channel picker behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { ChannelPluginCatalogEntry } from "../channels/plugins/catalog.js";
 import {

src/commands/provider-setup-cold-imports.test.ts

@@ -1,3 +1,4 @@
+// Provider setup cold-import tests guard provider setup paths against runtime-heavy imports.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

src/commands/sandbox-formatters.test.ts

@@ -1,3 +1,4 @@
+// Sandbox formatter tests cover duration, mismatch, and sandbox diagnostic display helpers.
 import { describe, expect, it } from "vitest";
 import { formatDurationCompact } from "../infra/format-time/format-duration.js";
 import {

src/commands/sessions.acp-model-display.test.ts

@@ -1,3 +1,4 @@
+// Sessions ACP model display tests cover model metadata rendering for ACP-backed sessions.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/commands/status.scan-overview.test.ts

@@ -1,3 +1,4 @@
+// Status scan overview tests cover overview collection and gateway/runtime summary inputs.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { collectStatusScanOverview } from "./status.scan-overview.ts";
 

src/commands/status.scan.test-helpers.ts

@@ -1,3 +1,4 @@
+// Status scan test helpers provide shared mocks and config fixtures for scan suites.
 import type { Mock } from "vitest";
 import { vi } from "vitest";
 import type { OpenClawConfig } from "../config/types.js";

src/commands/status.scan.test.ts

@@ -1,3 +1,4 @@
+// Status scan tests cover fast scan defaults, memory setup, gateway probes, and status aggregation.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   applyStatusScanDefaults,

src/commands/status.summary.runtime.test.ts

@@ -1,3 +1,4 @@
+// Status summary runtime tests cover model context-token resolution.
 import { describe, expect, it } from "vitest";
 import { statusSummaryRuntime } from "./status.summary.runtime.js";