docs: document auto reply command gates

src/auto-reply/reply/acp-projector.test.ts

@@ -1,3 +1,4 @@
+// Tests ACP event projection into session updates and reply payloads.
 import { describe, expect, it, vi } from "vitest";
 import { prefixSystemMessage } from "../../infra/system-message.js";
 import { createAcpReplyProjector } from "./acp-projector.js";

src/auto-reply/reply/command-gates.ts

@@ -1,3 +1,4 @@
+// Applies command feature gates before command handlers execute.
 import { isCommandFlagEnabled, type CommandFlagKey } from "../../config/commands.flags.js";
 import { logVerbose } from "../../globals.js";
 import { redactIdentifier } from "../../logging/redact-identifier.js";

src/auto-reply/reply/commands-filesystem.test-support.ts

@@ -1,3 +1,4 @@
+// Shared filesystem fixtures for command tests that write session artifacts.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

src/auto-reply/reply/commands-handlers.runtime.ts

@@ -1,3 +1,4 @@
+// Loads command handlers behind a runtime boundary for the command dispatcher.
 import { handleAcpCommand } from "./commands-acp.js";
 import { handleAllowlistCommand } from "./commands-allowlist.js";
 import { handleApproveCommand } from "./commands-approve.js";

src/auto-reply/reply/commands-info.tools.test.ts

@@ -1,3 +1,4 @@
+// Tests tool listing in info command responses.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { EffectiveToolInventoryResult } from "../../agents/tools-effective-inventory.types.js";
 import type { OpenClawConfig } from "../../config/config.js";

src/auto-reply/reply/commands-session-abort.ts

@@ -1,3 +1,4 @@
+// Implements session abort commands and active-run stop targeting.
 import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";
 import type { SessionEntry } from "../../config/sessions.js";
 import { logVerbose } from "../../globals.js";

src/auto-reply/reply/commands-session-usage.test.ts

@@ -1,3 +1,4 @@
+// Tests session usage command output and token accounting summaries.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import type {

src/auto-reply/reply/commands-status.thinking-default.test.ts

@@ -1,3 +1,4 @@
+// Tests status command defaults for thinking and reasoning display.
 import { beforeAll, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 

src/auto-reply/reply/commands-subagents-status.test.ts

@@ -1,3 +1,4 @@
+// Tests subagent status command output and active run summaries.
 import { beforeEach, describe, expect, it } from "vitest";
 import { subagentRuns } from "../../agents/subagent-registry-memory.js";
 import {

src/auto-reply/reply/conversation-label-generator.ts

@@ -1,3 +1,4 @@
+// Generates short labels for sessions from conversation context.
 import { resolveModelAsync } from "../../agents/embedded-agent-runner/model.js";
 import { requireApiKey } from "../../agents/model-auth.js";
 import { resolveDefaultModelForAgent } from "../../agents/model-selection.js";

src/auto-reply/reply/debug-commands.ts

@@ -1,3 +1,4 @@
+// Implements debug command toggles used by maintainers during reply runs.
 import { parseStandardSetUnsetSlashCommand } from "./commands-setunset-standard.js";
 
 export type DebugCommand =

src/auto-reply/reply/dispatch-acp.ts

@@ -1,3 +1,4 @@
+// Dispatches reply turns through ACP runtimes and projects their events.
 import { formatAcpRuntimeErrorText } from "@openclaw/acp-core/runtime/error-text";
 import { resolveAcpThreadSessionDetailLines } from "@openclaw/acp-core/runtime/session-identifiers";
 import {

src/auto-reply/reply/dispatch-from-config.shared.test-harness.ts

@@ -1,3 +1,4 @@
+// Shared harness for dispatch-from-config tests and mocked runtimes.
 import { vi } from "vitest";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import type { SessionBindingRecord } from "../../infra/outbound/session-binding-service.js";

src/auto-reply/reply/get-reply.fast-path.runtime.test.ts

@@ -1,3 +1,4 @@
+// Tests runtime-loaded fast-path command behavior for get-reply.
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import {

src/auto-reply/reply/get-reply.types.ts

@@ -1,3 +1,4 @@
+// Shared get-reply type contracts for command, directive, and runtime layers.
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import type { GetReplyOptions } from "../get-reply-options.types.js";
 import type { ReplyPayload } from "../reply-payload.js";

src/auto-reply/reply/group-id-simple.ts

@@ -1,3 +1,4 @@
+// Derives stable group ids from simple channel and conversation facts.
 import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";
 
 /** Extracts a simple group/channel id from stable group-like source ids. */

src/auto-reply/reply/mentions.test.ts

@@ -1,3 +1,4 @@
+// Tests mention detection and command trigger matching.
 import { describe, expect, it } from "vitest";
 import { stripStructuralPrefixes } from "./mentions.js";
 

src/auto-reply/reply/plugins-commands.ts

@@ -1,3 +1,4 @@
+// Provides plugin command discovery and handler registration helpers.
 import {
   normalizeOptionalLowercaseString,
   normalizeOptionalString,

src/auto-reply/reply/provider-dispatcher.types.ts

@@ -1,3 +1,4 @@
+// Shared provider dispatch type contracts for reply runtime execution.
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import type { GetReplyOptions } from "../get-reply-options.types.js";
 import type { FinalizedMsgContext, MsgContext } from "../templating.js";

src/auto-reply/reply/queue-policy.test.ts

@@ -1,3 +1,4 @@
+// Tests queue policy parsing and admission decisions.
 import { describe, expect, it } from "vitest";
 import { resolveActiveRunQueueAction } from "./queue-policy.js";
 

src/auto-reply/reply/reply-media-paths.test.ts

@@ -1,3 +1,4 @@
+// Tests media path normalization and attachment metadata generation.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

src/auto-reply/reply/reply-state.test.ts

@@ -1,3 +1,4 @@
+// Tests reply state persistence and recovery across process restarts.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

src/auto-reply/reply/session-hooks-context.test.ts

@@ -1,3 +1,4 @@
+// Tests context passed to session lifecycle hooks.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

src/auto-reply/reply/typing-mode.ts

@@ -1,3 +1,4 @@
+// Normalizes typing indicator modes from config and directives.
 import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";
 import type { TypingMode } from "../../config/types.js";
 import type { SourceReplyDeliveryMode } from "../get-reply-options.types.js";