commandmate 0.47.0 → 0.48.0

package/dist/cli/commands/auto-yes.d.ts

@@ -4,6 +4,30 @@
  */
 import { Command } from 'commander';
 import type { AutoYesContractPolicy } from '../types/api-responses';
+/** Issue #3863: `--answer-mode`'s help, shared with `send --auto-yes-answer-mode`. */
+export declare const ANSWER_MODE_OPTION_DESCRIPTION: string;
+/**
+ * Issue #3863: the stderr line naming the answer mode Auto-Yes is on with, or
+ * null when there is nothing to say. Read off the response — an omitted mode
+ * is resolved by the server (a grant that is on keeps its mode), so the CLI
+ * cannot know it otherwise.
+ *
+ * Said when the mode was asked for, or when it is not the default
+ * (`recommended`) — a re-enable that kept `careful`, say. An enable that asked
+ * for nothing and got the default prints what it printed before the modes
+ * (the output scripts already read); `capture --json`, `instances --json` and
+ * the response's `answerMode` carry the mode in every case.
+ *
+ * @param answerMode - `answerMode` of the auto-yes POST (absent from older servers)
+ * @param requested - Whether the command named a mode
+ */
+export declare function describeAnswerMode(answerMode: string | undefined, requested: boolean): string | null;
+/**
+ * Issue #3863: validate an answer-mode option value, exiting 2 on a bad one.
+ *
+ * @param flag - The option's spelling, for the message
+ */
+export declare function validateAnswerModeOption(value: string | undefined, flag: string): void;
 /**
  * The stderr line(s) describing what the contract on the armed instance lets
  * Auto-Yes answer (Issue #3723), or an empty list when there is nothing to say.

package/dist/cli/commands/auto-yes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-yes.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/auto-yes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EAAE,qBAAqB,EAAoB,MAAM,wBAAwB,CAAC;AAyDtF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAqBjG;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAuG9C"}
+{"version":3,"file":"auto-yes.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/auto-yes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EAAE,qBAAqB,EAAoB,MAAM,wBAAwB,CAAC;AAatF,sFAAsF;AACtF,eAAO,MAAM,8BAA8B,QAGoF,CAAC;AAEhI;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAWpG;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKtF;AAuDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CA2BjG;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAoH9C"}

package/dist/cli/commands/auto-yes.js

@@ -4,6 +4,9 @@
  * Issue #518: [DR1-08] Factory pattern
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANSWER_MODE_OPTION_DESCRIPTION = void 0;
+exports.describeAnswerMode = describeAnswerMode;
+exports.validateAnswerModeOption = validateAnswerModeOption;
 exports.describeContractPolicy = describeContractPolicy;
 exports.createAutoYesCommand = createAutoYesCommand;
 const commander_1 = require("commander");
@@ -14,6 +17,51 @@ const duration_constants_1 = require("../config/duration-constants");
 const cli_tool_ids_1 = require("../config/cli-tool-ids");
 const agent_target_options_1 = require("../config/agent-target-options");
 const instances_1 = require("./instances");
+const auto_yes_answer_mode_1 = require("../../types/auto-yes-answer-mode");
+/** Issue #3863: `--answer-mode`'s help, shared with `send --auto-yes-answer-mode`. */
+exports.ANSWER_MODE_OPTION_DESCRIPTION = `How Auto-Yes answers a question the agent asks (${auto_yes_answer_mode_1.AUTO_YES_ANSWER_MODES.join(', ')}). ` +
+    'recommended: the option marked (Recommended) / （推奨）, else the default; careful: questions are left to you. ' +
+    'Permissions are answered alike (allow this call once). Omitted: a grant that is on keeps its mode, a new one is recommended';
+/**
+ * Issue #3863: the stderr line naming the answer mode Auto-Yes is on with, or
+ * null when there is nothing to say. Read off the response — an omitted mode
+ * is resolved by the server (a grant that is on keeps its mode), so the CLI
+ * cannot know it otherwise.
+ *
+ * Said when the mode was asked for, or when it is not the default
+ * (`recommended`) — a re-enable that kept `careful`, say. An enable that asked
+ * for nothing and got the default prints what it printed before the modes
+ * (the output scripts already read); `capture --json`, `instances --json` and
+ * the response's `answerMode` carry the mode in every case.
+ *
+ * @param answerMode - `answerMode` of the auto-yes POST (absent from older servers)
+ * @param requested - Whether the command named a mode
+ */
+function describeAnswerMode(answerMode, requested) {
+    if (answerMode === undefined)
+        return null;
+    if (answerMode === auto_yes_answer_mode_1.DEFAULT_AUTO_YES_ANSWER_MODE && !requested)
+        return null;
+    if (answerMode === 'recommended') {
+        return 'Answer mode: recommended (questions are answered with the recommended option, else the default).';
+    }
+    if (answerMode === 'careful') {
+        return 'Answer mode: careful (questions are left to you; permissions are still answered).';
+    }
+    // A mode this build does not know (a newer server): name it, judge nothing.
+    return `Answer mode: ${answerMode}.`;
+}
+/**
+ * Issue #3863: validate an answer-mode option value, exiting 2 on a bad one.
+ *
+ * @param flag - The option's spelling, for the message
+ */
+function validateAnswerModeOption(value, flag) {
+    if (value !== undefined && !(0, auto_yes_answer_mode_1.isAutoYesAnswerMode)(value)) {
+        console.error(`Error: Invalid ${flag}. Must be one of: ${auto_yes_answer_mode_1.AUTO_YES_ANSWER_MODES.join(', ')}`);
+        process.exit(types_1.ExitCode.CONFIG_ERROR);
+    }
+}
 /**
  * Report what arming Auto-Yes actually did: which agent (Issue #1909) and what
  * it answered on the way in (Issue #1898-2).
@@ -28,8 +76,9 @@ const instances_1 = require("./instances");
  *
  * @param worktreeId - Worktree the command targeted
  * @param result - Body of the auto-yes POST, or undefined from an old daemon
+ * @param answerModeRequested - Issue #3863: whether `--answer-mode` was given
  */
-function reportEnabled(worktreeId, result) {
+function reportEnabled(worktreeId, result, answerModeRequested = false) {
     const agent = result?.cliToolId;
     const instanceId = result?.instanceId;
     // `instanceId === cliToolId` is how the primary instance is spelled (#868);
@@ -40,6 +89,10 @@ function reportEnabled(worktreeId, result) {
     console.error(label
         ? `Auto-yes enabled for ${worktreeId} (${label}).`
         : `Auto-yes enabled for ${worktreeId}.`);
+    // Issue #3863: the mode the server put it on with.
+    const modeLine = describeAnswerMode(result?.answerMode, answerModeRequested);
+    if (modeLine !== null)
+        console.error(modeLine);
     // Issue #1898-2: enabling Auto-Yes under a dialog that was already up used to
     // do nothing at all, silently. If it answered something on the way in, say so
     // — that is the difference between "armed for next time" and "the worker you
@@ -87,7 +140,13 @@ function describeContractPolicy(policy) {
         ];
     }
     if (policy.mode === 'safe') {
-        return [`Note: ${task} sets autoYes.mode: safe; Auto-Yes answers yes_no prompts only.${deny}`];
+        // Issue #3822: on a tool whose dialog gate is `enforce`, a `yes_no` the
+        // tool's own dialog detector does not vouch for is left to a human too.
+        return [
+            `Note: ${task} sets autoYes.mode: safe; Auto-Yes answers yes_no prompts only ` +
+                '(on claude, codex, copilot, opencode and opencode-v2, only those the tool itself shows as a confirmation, not a generic (y/n)).' +
+                deny,
+        ];
     }
     if (policy.mode === 'allow-listed') {
         const types = policy.allowPromptTypes.length > 0 ? policy.allowPromptTypes.join(', ') : 'none';
@@ -105,6 +164,7 @@ function createAutoYesCommand() {
         .option('--disable', 'Disable auto-yes')
         .option('--duration <duration>', `Duration (${duration_constants_1.ALLOWED_DURATIONS.join(', ')})`)
         .option('--stop-pattern <pattern>', 'Stop pattern (regex, max 500 chars). Matched against terminal output; cannot block commands (build logs mentioning the pattern also trigger it). To suppress auto-responses per command, use the task contract\'s autoYes.denyPatterns')
+        .option('--answer-mode <mode>', exports.ANSWER_MODE_OPTION_DESCRIPTION)
         .option('--instance <id>', agent_target_options_1.INSTANCE_OPTION_DESCRIPTION)
         .option('--agent <agent>', agent_target_options_1.AGENT_OPTION_DESCRIPTION)
         .option('--token <token>', command_helpers_1.TOKEN_WARNING)
@@ -124,6 +184,12 @@ function createAutoYesCommand() {
                 console.error('Error: Cannot specify both --enable and --disable.');
                 process.exit(types_1.ExitCode.CONFIG_ERROR);
             }
+            // Issue #3863
+            validateAnswerModeOption(options.answerMode, '--answer-mode');
+            if (options.answerMode !== undefined && options.disable) {
+                console.error('Error: --answer-mode applies to --enable only.');
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+            }
             if (options.agent && !(0, cli_tool_ids_1.isCliToolId)(options.agent)) {
                 console.error(`Error: Invalid agent. Must be one of: ${cli_tool_ids_1.CLI_TOOL_IDS.join(', ')}`);
                 process.exit(types_1.ExitCode.CONFIG_ERROR);
@@ -155,6 +221,10 @@ function createAutoYesCommand() {
                 if (options.stopPattern) {
                     body.stopPattern = options.stopPattern;
                 }
+                // Issue #3863: sent only when given, so the server keeps a live grant's mode.
+                if (options.answerMode !== undefined) {
+                    body.answerMode = options.answerMode;
+                }
             }
             // Issue #1629: the auto-yes poller keys on (worktree, cliTool, instance)
             // and watches the session cliTool names, so the instance must be paired
@@ -171,7 +241,7 @@ function createAutoYesCommand() {
             }
             const result = await client.post(`/api/worktrees/${worktreeId}/auto-yes`, body);
             if (options.enable) {
-                reportEnabled(worktreeId, result);
+                reportEnabled(worktreeId, result, options.answerMode !== undefined);
             }
             else {
                 console.error(`Auto-yes disabled for ${worktreeId}.`);

package/dist/cli/commands/instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,SAAS,EAAkD,MAAM,qBAAqB,CAAC;AA+JhG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,GAAE,oBAA+B,GACpC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG7B;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,QAE6D,CAAC;AAErG,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,QAE0B,CAAC;AAE/D,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;;;;;;;;;OAYG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,GAAE,oBAA+B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAmCjC;AA4TD,wBAAgB,sBAAsB,IAAI,OAAO,CAgFhD"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,SAAS,EAAkD,MAAM,qBAAqB,CAAC;AAsKhG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,GAAE,oBAA+B,GACpC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG7B;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,QAE6D,CAAC;AAErG,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,QAE0B,CAAC;AAE/D,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;;;;;;;;;OAYG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,GAAE,oBAA+B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAmCjC;AAqUD,wBAAgB,sBAAsB,IAAI,OAAO,CAgFhD"}

package/dist/cli/commands/instances.js

@@ -255,6 +255,7 @@ async function fetchArmedAutoYes(client, worktreeId) {
         const states = response?.instances;
         if (!states || typeof states !== 'object')
             return null;
+        const modes = response?.answerModeByInstance;
         return new Map(Object.entries(states).map(([instanceId, state]) => {
             const enabled = state?.enabled === true;
             return [instanceId, {
@@ -262,6 +263,8 @@ async function fetchArmedAutoYes(client, worktreeId) {
                     blockedByContract: enabled && state?.blockedByContract === true,
                     // Issue #3730: a server older than the field sends none — plain `no`.
                     releasedByRestart: !enabled && state?.stopReason === 'server-restart',
+                    // Issue #3863: an older server sends none — the row then carries none.
+                    ...(enabled && typeof modes?.[instanceId] === 'string' ? { answerMode: modes[instanceId] } : {}),
                 }];
         }));
     }
@@ -294,6 +297,10 @@ async function listInstances(client, worktreeId, options) {
             // is not running. Replaced below when the server names the armed
             // instances itself (Issue #3300).
             autoYes: output.autoYes?.enabled ?? false,
+            // Issue #3863: the session's own reading of the mode, replaced below too.
+            ...(output.autoYes?.enabled === true && typeof output.autoYesAnswerMode === 'string'
+                ? { autoYesAnswerMode: output.autoYesAnswerMode }
+                : {}),
             // Issue #1785: pass-through. `?? null` collapses "this daemon predates
             // the field" into the same null the server sends for "nothing knows" —
             // the CLI has no way to tell those apart and no reason to.
@@ -318,11 +325,13 @@ async function listInstances(client, worktreeId, options) {
     const armed = instances.length > 0 ? await fetchArmedAutoYes(client, worktreeId) : null;
     const rows = armed === null
         ? sessionRows
-        : sessionRows.map(row => {
+        : sessionRows.map(({ autoYesAnswerMode: _sessionMode, ...row }) => {
             const entry = armed.get(row.instanceId);
             return {
                 ...row,
                 autoYes: entry?.enabled ?? false,
+                // Issue #3863: the state store's mode, beside the arming it belongs to.
+                ...(entry?.answerMode !== undefined ? { autoYesAnswerMode: entry.answerMode } : {}),
                 // Issue #3723: only the state store says this, so only this path sets it.
                 ...(entry?.blockedByContract ? { autoYesBlockedByContract: true } : {}),
                 // Issue #3730: likewise only the state store knows the restart took it.

package/dist/cli/commands/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAgB5E;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAIzF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAW9E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CAU/G;AAED,kDAAkD;AAClD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAsExG;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CA8E7C"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAgB5E;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAIzF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAW9E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CAU/G;AA0ED,kDAAkD;AAClD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAkBxG;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CA8E7C"}

package/dist/cli/commands/prompt.js

@@ -74,18 +74,9 @@ function formatLastSend(lastSend, now = Date.now()) {
             : '';
     return `  last send: ${lastSend.state} (${lastSend.reason}, ${ago})${advice}`;
 }
-/** The observation in the words a human reads. */
-function formatPromptObservation(observation, now = Date.now()) {
-    const { target, screen, autoYes } = observation;
+/** The `kind:` line and what the screen asks: question, target, options, answer route and token. */
+function formatScreenLines(observation, screen, now) {
     const lines = [];
-    lines.push(`Instance ${target.instanceId} (${target.cliToolId}) on ${target.worktreeId}, pane ${target.sessionName}`);
-    const lastSendLine = formatLastSend(observation.lastSend, now);
-    if (observation.status === 'unavailable' || screen === null) {
-        lines.push('  No running session: there is no screen to read.');
-        if (lastSendLine !== null)
-            lines.push(lastSendLine);
-        return lines.join('\n');
-    }
     const kindNote = screen.kind === 'none'
         ? ' (nothing on screen asks for a decision)'
         : screen.kind === 'composer'
@@ -119,6 +110,11 @@ function formatPromptObservation(observation, now = Date.now()) {
         // An older server sends no `tokenWithheld`; `no-decision` needs no line.
         lines.push(`  token: none (${screen.tokenWithheld})`);
     }
+    return lines;
+}
+/** The Auto-Yes lines: switch and poller, the poller's last record, and the contract re-evaluated now. */
+function formatAutoYesLines(autoYes) {
+    const lines = [];
     const enabled = autoYes.enabled === null ? 'unknown' : autoYes.enabled ? 'on' : 'off';
     const poller = autoYes.pollerActive === null ? 'unknown' : autoYes.pollerActive ? 'running' : 'stopped';
     lines.push(`  auto-yes: ${enabled}, poller ${poller}${autoYes.stopReason ? `, stopReason=${autoYes.stopReason}` : ''}`);
@@ -130,11 +126,29 @@ function formatPromptObservation(observation, now = Date.now()) {
     const evaluation = autoYes.contractEvaluation;
     const evaluationDetail = evaluation.state === 'policy-withholds'
         ? `policy-withholds reason=${evaluation.reason}${evaluation.pattern !== undefined ? ` pattern=${JSON.stringify(evaluation.pattern)}` : ''}`
-        : evaluation.state === 'not-evaluated'
-            ? `not-evaluated (${evaluation.because})`
-            : evaluation.state;
+        : evaluation.state === 'base-withholds'
+            ? `base-withholds reason=${evaluation.reason}`
+            : evaluation.state === 'not-evaluated'
+                ? `not-evaluated (${evaluation.because})`
+                : evaluation.state;
     lines.push(`  contract re-evaluation: ${evaluationDetail}` +
         (evaluation.contract ? ` (task ${evaluation.contract.taskId ?? 'unknown'}, mode=${evaluation.contract.mode ?? 'none'})` : ' (no contract)'));
+    return lines;
+}
+/** The observation in the words a human reads. */
+function formatPromptObservation(observation, now = Date.now()) {
+    const { target, screen, autoYes } = observation;
+    const lines = [];
+    lines.push(`Instance ${target.instanceId} (${target.cliToolId}) on ${target.worktreeId}, pane ${target.sessionName}`);
+    const lastSendLine = formatLastSend(observation.lastSend, now);
+    if (observation.status === 'unavailable' || screen === null) {
+        lines.push('  No running session: there is no screen to read.');
+        if (lastSendLine !== null)
+            lines.push(lastSendLine);
+        return lines.join('\n');
+    }
+    lines.push(...formatScreenLines(observation, screen, now));
+    lines.push(...formatAutoYesLines(autoYes));
     if (lastSendLine !== null)
         lines.push(lastSendLine);
     return lines.join('\n');

package/dist/cli/commands/send.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/send.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyWpC,wBAAgB,iBAAiB,IAAI,OAAO,CA8J3C"}
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/send.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4XpC,wBAAgB,iBAAiB,IAAI,OAAO,CA+J3C"}

package/dist/cli/commands/send.js

@@ -83,11 +83,19 @@ async function enableAutoYes(client, worktreeId, options, durationMs, agent, ins
     if (options.stopPattern) {
         autoYesBody.stopPattern = options.stopPattern;
     }
+    // Issue #3863: sent only when given, so the server keeps a live grant's mode.
+    if (options.autoYesAnswerMode !== undefined) {
+        autoYesBody.answerMode = options.autoYesAnswerMode;
+    }
     // Issue #3723: the response is read now. It names what the contract on the
     // instance lets Auto-Yes answer; with `autoYes.mode: off` the poller this
     // armed answers nothing, and "Auto-yes enabled." alone said otherwise.
     const result = await client.post(`/api/worktrees/${worktreeId}/auto-yes`, autoYesBody);
     console.error('Auto-yes enabled.');
+    // Issue #3863: the mode the server put it on with.
+    const modeLine = (0, auto_yes_1.describeAnswerMode)(result?.answerMode, options.autoYesAnswerMode !== undefined);
+    if (modeLine !== null)
+        console.error(modeLine);
     // The server's reading wins when it has one. It has none for a `--contract`
     // send armed before the message goes out: the task is still `pending`, which
     // the server does not count as governing the instance (ACTIVE_TASK_STATUSES).
@@ -210,6 +218,12 @@ function validateSendArgs(worktreeId, message, options) {
         console.error(instances_1.INSTANCE_SELECTOR_ERROR);
         process.exit(types_1.ExitCode.CONFIG_ERROR);
     }
+    // Issue #3863: a value the server would refuse, and a mode with nothing to arm.
+    (0, auto_yes_1.validateAnswerModeOption)(options.autoYesAnswerMode, '--auto-yes-answer-mode');
+    if (options.autoYesAnswerMode !== undefined && !options.autoYes) {
+        console.error('Error: --auto-yes-answer-mode requires --auto-yes.');
+        process.exit(types_1.ExitCode.CONFIG_ERROR);
+    }
     // Issue #1000: --register requires --instance, and requires --agent
     // unless the instance id is itself a primary CLI tool id (e.g. claude).
     if (options.register) {
@@ -302,6 +316,7 @@ function createSendCommand() {
         .option('--model <model>', 'Specify AI model for a Copilot, Antigravity or Claude agent. For Antigravity and Claude it is a launch'
         + ' flag: it applies only when this send starts the session, and a running session answers 400')
         .option('--auto-yes', 'Enable auto-yes before sending (session-wide, no policy guard; for unattended runs prefer --contract with an autoYes policy)')
+        .option('--auto-yes-answer-mode <mode>', `With --auto-yes: ${auto_yes_1.ANSWER_MODE_OPTION_DESCRIPTION}`)
         .option('--duration <duration>', `Auto-yes duration (${duration_constants_1.ALLOWED_DURATIONS.join(', ')})`)
         .option('--stop-pattern <pattern>', 'Auto-yes stop pattern (regex). Matched against terminal output; cannot block commands (use the task contract\'s autoYes.denyPatterns for that)')
         .option('--contract <path>', 'Execution contract path relative to the worktree root (e.g. .commandmate/tasks/my-task.yaml). Records a task and sends the contract preamble plus its goal.')

package/dist/cli/commands/wait.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAGV,qBAAqB,EAKrB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,SAAS,EAA+B,MAAM,qBAAqB,CAAC;AA8E7E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAIvD,CAAC;AAiOH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,qBAAqB,EAC3B,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAMf;AAyMD;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AA2JlD;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA21BD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,6EAA6E;IAC7E,aAAa,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,CAAC,CAyID;AAwKD,wBAAgB,iBAAiB,IAAI,OAAO,CA6M3C"}
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAGV,qBAAqB,EAKrB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,SAAS,EAA+B,MAAM,qBAAqB,CAAC;AA8E7E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAIvD,CAAC;AA+RH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,qBAAqB,EAC3B,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAMf;AAsND;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AA2JlD;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA42BD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,6EAA6E;IAC7E,aAAa,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,CAAC,CAyID;AAwKD,wBAAgB,iBAAiB,IAAI,OAAO,CAgN3C"}

package/dist/cli/commands/wait.js

@@ -216,9 +216,25 @@ function describePaneObstruction(data) {
  * error runs towards reporting — a withheld answer to an earlier prompt, under a
  * minute old, still ends the hold, which is the pre-#2463 exit rather than a
  * new failure.
+ *
+ * Issue #3798: a server that names the waiting episodes does what the push gate
+ * does — the record's `episodeId` against the payload's
+ * `autoYes.waitingEpisodeId`, which decide when both are present: another id
+ * (or no wait open) is a record of an earlier wait, however recent; the same
+ * id is this wait's. Either one missing (an older server, a record written
+ * before any wait was open), this window decides as before. Whichever
+ * decides, a record the server marks `lastSuppressionAnswered` — Auto-Yes
+ * answered the open wait after it was written — is history, not this wait's
+ * reason, as the push gate reads it: the hold goes on.
  */
 const SUPPRESSION_FRESH_MS = 60_000;
-/** The suppression currently blocking this session, or null. */
+/**
+ * The suppression currently blocking this session, or null.
+ *
+ * Issue #3863: with the Auto-Yes answer mode in effect (`autoYesAnswerMode`)
+ * when the server publishes one — what `question-left-to-human` and
+ * `recommended-option-unidentified` depend on.
+ */
 function activeSuppression(data, now) {
     // No `autoYes` at all (a session that is not running, Issue #3300) reads as
     // "nothing was withheld", the same as a null record.
@@ -226,10 +242,23 @@ function activeSuppression(data, now) {
     if (!suppression)
         return null;
     const ageMs = now - suppression.at;
-    // A negative age is clock skew between the CLI and the server, not staleness.
-    if (ageMs > SUPPRESSION_FRESH_MS)
+    const waitId = data.autoYes?.waitingEpisodeId;
+    if (suppression.episodeId !== undefined && waitId !== undefined) {
+        if (suppression.episodeId !== waitId)
+            return null;
+    }
+    else if (ageMs > SUPPRESSION_FRESH_MS) {
+        // A negative age is clock skew between the CLI and the server, not staleness.
+        return null;
+    }
+    if (data.autoYes?.lastSuppressionAnswered === true)
         return null;
-    return { suppression, ageSeconds: Math.max(0, Math.round(ageMs / 1000)) };
+    const answerMode = data.autoYesAnswerMode;
+    return {
+        suppression,
+        ageSeconds: Math.max(0, Math.round(ageMs / 1000)),
+        ...(answerMode !== undefined ? { answerMode } : {}),
+    };
 }
 /** The wording for the four reasons a contract's `autoYes` block really authors. */
 const CONTRACT_POLICY_CAUSE = 'by contract policy';
@@ -254,13 +283,23 @@ const CONTRACT_POLICY_CAUSE = 'by contract policy';
  * the poller's stopped-answer branch (`partial-answer`, Issue #3706 / #3713),
  * and the poller's agy trust-screen branch (`startup-trust-unhandled`, Issue #3757),
  * and the poller's question confirm-page branch (`question-confirm-page`, Issue #3748),
- * and the poller's agy receipt-gate branch (`no-hook-receipt`, Issue #3767).
+ * and the poller's question branch (`question-left-to-human`, Issue #3822),
+ * and the resolver's permission-row reading (`allow-once-unidentified`, Issue #3822),
+ * and the resolver's choice of a question's recommended option
+ * (`recommended-option-unidentified`, Issue #3863),
+ * and the poller's agy receipt-gate branch (`no-hook-receipt`, Issue #3767),
+ * and a contract lookup that failed on either of the policy paths
+ * (`policy-lookup-failed`, Issue #3822).
  */
 const SUPPRESSION_CAUSE = {
     'mode-off': CONTRACT_POLICY_CAUSE,
     'deny-pattern': CONTRACT_POLICY_CAUSE,
     'deny-pattern-unusable': CONTRACT_POLICY_CAUSE,
     'type-not-allowed': CONTRACT_POLICY_CAUSE,
+    // Issue #3822. Not "by contract policy": the contract could not be read at
+    // all, so nothing it says was applied. Withheld rather than answered, since
+    // the contract may state `off`; it clears once the server reads it again.
+    'policy-lookup-failed': 'because the server could not read the execution contract (the database lookup failed), so Auto-Yes does not answer until it can; check the server log for policy-lookup-failed',
     // Issue #3790: after the launch window the poller still leaves copilot's and
     // gemini's trust dialogs alone when the cursor is not on the safe row, and
     // nobody else answers them then.
@@ -273,7 +312,10 @@ const SUPPRESSION_CAUSE = {
     // Issue #3713 (#3706's reason). Not "by contract policy" either: an earlier
     // Auto-Yes answer was stopped with some of its keys already in the input, and
     // typing it again would append to them, so the prompt waits for a human.
-    'partial-answer': 'because an earlier answer left partial input; Auto-Yes is waiting for a human',
+    // Issue #3880: or a send of it (Auto-Yes's, or a person's that failed) ended
+    // without tmux confirming it, and no key may be known to be there. The #3713
+    // sentence is kept as it was and the other case follows it.
+    'partial-answer': "because an earlier answer left partial input; Auto-Yes is waiting for a human (or that answer's send could not be confirmed, so the input may hold it: check the pane, then answer; an answer that goes through releases the hold)",
     // Issue #3757. agy's startup folder-trust screen: the launch's to confirm, not
     // Auto-Yes's, and agy drew it after the launch window had ended.
     'startup-trust-unhandled': "because agy's startup folder-trust confirmation is the launch's to answer, not Auto-Yes's; the next send confirms it once, or answer it at the pane",
@@ -282,6 +324,19 @@ const SUPPRESSION_CAUSE = {
     // answers, so it waits for a human. Was recorded as `unclassified-frame`,
     // whose wording above says the opposite (nothing recognised the frame).
     'question-confirm-page': "because the question's Submit/Cancel confirmation commits the answers as they stand, so Auto-Yes leaves it to a human",
+    // Issue #3822. A question the agent asks the operator (an AskUserQuestion
+    // picker, OpenCode V2's question form): Auto-Yes answers permissions only,
+    // and no contract setting delegates the question. Issue #3863: since the
+    // answer modes, that is the `careful` mode's rule (and OpenCode V2's form
+    // under either mode); `answerMode=` on the line says which mode was on.
+    'question-left-to-human': 'because the agent is asking a question, and Auto-Yes answers permissions only (the careful answer mode, or a question form no mode answers); answer it at the pane (prompt --json, respond), or turn Auto-Yes on with --answer-mode recommended to have it pick the recommended option',
+    // Issue #3822. A permission dialog none of whose rows allows this call only
+    // (each saves a rule, changes the mode or denies), or two of which read so.
+    // Auto-Yes never picks a row that outlives this call, so it waits for a human.
+    'allow-once-unidentified': 'because no single option of the permission dialog allows this call only (the others save a rule, change the permission mode, or deny); Auto-Yes does not pick those, so answer it at the pane (prompt --json, respond)',
+    // Issue #3863. The recommended answer mode answers a question with its one
+    // recommended option (else its default), and could not tell which that is.
+    'recommended-option-unidentified': "because the question's recommended option could not be told (two or more marked recommended, a title it could not tell from its description, a typed-text or multi-select answer); answer it at the pane (prompt --json, respond)",
     // Issue #3767. agy's approval dialog has no matching hook question (none, too
     // late, already on screen, or the hook stopped arriving). Not a contract verdict.
     // Issue #3789: nor one left unused — the last was spent on keys Auto-Yes sent,
@@ -314,7 +369,7 @@ function suppressionCause(reason) {
  * in the payload either way, so the prefix is the only part that can lie — and it
  * did, for every non-contract suppression.
  */
-function formatSuppressionNotice(suppression, ageSeconds) {
+function formatSuppressionNotice(suppression, ageSeconds, answerMode) {
     const parts = [
         `reason=${suppression.reason}`,
         `mode=${suppression.mode ?? 'none'}`,
@@ -323,6 +378,10 @@ function formatSuppressionNotice(suppression, ageSeconds) {
     if (suppression.pattern !== undefined) {
         parts.push(`pattern=${JSON.stringify(suppression.pattern)}`);
     }
+    // Issue #3863: the Auto-Yes answer mode in effect, when the server says.
+    if (answerMode !== undefined) {
+        parts.push(`answerMode=${answerMode}`);
+    }
     const cause = suppressionCause(suppression.reason);
     return `  auto-yes suppressed this prompt ${cause}: ${parts.join(' ')} (${ageSeconds}s ago)`;
 }
@@ -380,6 +439,19 @@ function formatEnterFallbackNotice(data, now) {
     }
     return `  auto-yes Enter record for this prompt: outcome=${record.outcome} ${detail} ${ago}`;
 }
+/**
+ * Issue #3821: the server's own word that Auto-Yes left this prompt to a human
+ * (`autoYesDecision.state === 'withheld'`) — `server-poller-inactive` when no
+ * poller runs for the instance, or a stop the suppression record does not
+ * carry. Read only when the server publishes the field; an older one leaves
+ * `wait` holding as before.
+ */
+function decisionWithheldReason(data) {
+    const decision = data.autoYesDecision;
+    if (decision?.state !== 'withheld')
+        return null;
+    return decision.reason ?? 'unknown';
+}
 /**
  * Whether this server publishes a real turn record (Issue #1930).
  *
@@ -802,6 +874,13 @@ function buildPromptOutput(worktreeId, data, promptData, suppressed) {
         ...(promptData.approvalTarget !== undefined && {
             approvalTarget: promptData.approvalTarget,
         }),
+        // Issue #3881: whether that target is the whole request (a `deny-pattern-
+        // unusable` verdict below is read against it), and what the screen was
+        // read as, when the server sent them.
+        ...(promptData.approvalTargetCompleteness !== undefined && {
+            approvalTargetCompleteness: promptData.approvalTargetCompleteness,
+        }),
+        ...(promptData.reading !== undefined && { reading: promptData.reading }),
         ...(suppressed && {
             autoYesSuppression: {
                 reason: suppressed.suppression.reason,
@@ -811,6 +890,8 @@ function buildPromptOutput(worktreeId, data, promptData, suppressed) {
                     pattern: suppressed.suppression.pattern,
                 }),
                 ageSeconds: suppressed.ageSeconds,
+                // Issue #3863: the answer mode in effect, when the server publishes it.
+                ...(suppressed.answerMode !== undefined && { answerMode: suppressed.answerMode }),
             },
         }),
     };
@@ -924,13 +1005,20 @@ function promptStage(poll, state, data) {
         // keeps polling and would otherwise say nothing about why nobody
         // answered, and the agent one is read by pipelines that never see stderr.
         const suppressed = activeSuppression(data, Date.now());
+        // Issue #3821: withheld by the server's decision, with no suppression to say so.
+        const decisionWithheld = suppressed ? null : decisionWithheldReason(data);
+        const decisionNotice = decisionWithheld === null
+            ? null
+            : `  auto-yes is not answering this prompt (reason=${decisionWithheld}); it is a human's to answer.`;
         // [DR1-03] Prompt detection exit code
         if (options.onPrompt === 'human') {
             // Block and continue polling - user handles prompt manually
             console.error(`Prompt detected on ${worktreeId}. Waiting for human response...`);
             if (suppressed) {
-                console.error(formatSuppressionNotice(suppressed.suppression, suppressed.ageSeconds));
+                console.error(formatSuppressionNotice(suppressed.suppression, suppressed.ageSeconds, suppressed.answerMode));
             }
+            if (decisionNotice)
+                console.error(decisionNotice);
             // Issue #3397: and whether Auto-Yes already pressed Enter on it.
             const enterNotice = formatEnterFallbackNotice(data, Date.now());
             if (enterNotice)
@@ -948,7 +1036,8 @@ function promptStage(poll, state, data) {
         // poll that shows no prompt ends the hold below and completion is judged
         // as usual. A withheld answer (`suppressed`) and Auto-Yes being off are
         // the gate's other two branches and still exit 10 at once.
-        if (!suppressed && data.autoYes?.enabled === true && autoYesGraceMs > 0) {
+        // Issue #3821: nor does a prompt the server says Auto-Yes left to a human.
+        if (!suppressed && decisionWithheld === null && data.autoYes?.enabled === true && autoYesGraceMs > 0) {
             const now = Date.now();
             if (state.autoYesAnsweringSince === null) {
                 state.autoYesAnsweringSince = now;
@@ -967,14 +1056,16 @@ function promptStage(poll, state, data) {
                 : `Note: the target's Auto-Yes did not answer the prompt on ${worktreeId} within ` +
                     `${autoYesGraceSeconds}s; reporting it.`);
         }
-        else if (state.autoYesAnsweringSince !== null && !suppressed) {
+        else if (state.autoYesAnsweringSince !== null && !suppressed && decisionWithheld === null) {
             console.error(`Note: Auto-Yes is no longer enabled on ${worktreeId}; reporting the prompt.`);
         }
         // Default (agent mode): output prompt info and exit 10
         const promptOutput = buildPromptOutput(worktreeId, data, data.promptData, suppressed);
         if (suppressed) {
-            console.error(formatSuppressionNotice(suppressed.suppression, suppressed.ageSeconds));
+            console.error(formatSuppressionNotice(suppressed.suppression, suppressed.ageSeconds, suppressed.answerMode));
         }
+        if (decisionNotice)
+            console.error(decisionNotice);
         // Issue #3397: stderr only, like the notice above; the exit-10 payload is unchanged.
         const enterNotice = formatEnterFallbackNotice(data, Date.now());
         if (enterNotice)
@@ -1002,7 +1093,7 @@ function selectionListStage(poll, data) {
             // selection lists, so a policy can be the reason this one is stuck too.
             const suppressed = activeSuppression(data, Date.now());
             if (suppressed) {
-                console.error(formatSuppressionNotice(suppressed.suppression, suppressed.ageSeconds));
+                console.error(formatSuppressionNotice(suppressed.suppression, suppressed.ageSeconds, suppressed.answerMode));
             }
             // Issue #3730
             const restartNotice = formatRestartReleaseNotice(worktreeId, data, poll.options.instance);
@@ -1740,8 +1831,11 @@ The observation on exit 10 (Issue #3755):
   \`commandmate prompt <id> --json\` prints, read off the capture the exit was
   decided on — the screen's kind, an observation token, and Auto-Yes as two
   separate items (the poller's record, the contract re-evaluated now). It
-  changes no exit code, hold or grace. autoYesSuppression keeps its meaning (a
-  record under a minute old); a missing record does not mean Auto-Yes can answer.
+  changes no exit code, hold or grace. autoYesSuppression keeps its meaning
+  (the record of this wait: the same waiting-episode id when the record and
+  the server both name one, else a record under a minute old; either way not
+  one written before Auto-Yes answered this wait, as the push gate reads it);
+  a missing record does not mean Auto-Yes can answer.
 `)
         .action(async (worktreeIds, options) => {
         try {