@prestyj/cli 5.2.0 → 5.3.1

package/dist/core/autopilot-gate.js

@@ -0,0 +1,205 @@
+/**
+ * Autopilot gate — pure decision logic for whether Nolan's auto-review cycle may
+ * start after a finished EZ Coder turn.
+ *
+ * Autopilot must NOT review every turn. The concrete leak cases this gate
+ * closes (each has a matching unit test in autopilot-gate.test.ts):
+ *
+ * - Workflow slash commands (`/compare`, `/bullet-proof`, `/expand`, custom
+ *   `.ezcoder/commands/*.md`) end with reports or A/B/C choices that are reserved
+ *   for the USER. Nolan reviewing them reads "findings" as "something real is
+ *   wrong" and injects fix prompts the user never approved.
+ * - Registry commands (`/help`, `/session`, unknown `/foo`) and failed runs
+ *   add no assistant work at all — a review would judge the PREVIOUS turn
+ *   again (Nolan's cycle memory is wiped per turn) and can flip a settled
+ *   ALL_CLEAR into a fresh PROMPT.
+ * - A turn that ended in plan mode has a pending Accept/Reject modal; Nolan must
+ *   never inject a prompt into a read-only plan-mode session.
+ * - A turn whose ONLY tool calls were mechanical usage — a bash command that
+ *   starts a background process (dev server, watcher), is read-only, or is a
+ *   plain `git add`/`commit`/`push` workflow; a dedicated read-only tool
+ *   (read/grep/find/ls/web_fetch/web_search/source_path/code_search/
+ *   task_output/screenshot/skill); or NO tool calls at all (a plain-text
+ *   answer with nothing built) — was always going to come back as Nolan's
+ *   IGNORE verdict (see the autopilot system prompt's "mechanical operation"
+ *   / "plain question answered with no code touched" rules). Pre-filtering
+ *   these skips the review API call entirely instead of paying for one whose
+ *   answer is already known.
+ *
+ * Kept pure + dependency-light so it's unit-testable without booting the
+ * sidecar (which runs `main()` at import time).
+ */
+import { isReadOnlyCommand } from "../tools/read-only-bash.js";
+/** The exact separator AgentSession.prompt() inserts between a command's
+ *  template and the user's extra args (see agent-session.ts prompt expansion).
+ *  Must stay byte-identical or expanded-command detection silently breaks. */
+export const USER_INSTRUCTIONS_HEADER = "\n\n## User Instructions\n\n";
+/** Extract the `/name` token from raw input, or null when it isn't a slash
+ *  invocation. */
+function parseSlashName(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("/"))
+        return null;
+    const name = trimmed.slice(1).split(/\s/, 1)[0]?.toLowerCase() ?? "";
+    return name.length > 0 ? name : null;
+}
+/**
+ * True when `text` invokes a known workflow command (first token, name or
+ * alias, case-insensitive). Registry/UI commands and unknown `/foo` return
+ * false — those add no assistant work and are caught by the
+ * `no-assistant-output` gate instead.
+ */
+export function isWorkflowCommandText(text, commands) {
+    const name = parseSlashName(text);
+    if (!name)
+        return false;
+    return commands.some((c) => c.name.toLowerCase() === name || (c.aliases ?? []).some((a) => a.toLowerCase() === name));
+}
+/**
+ * Match a transcript user-message body back to the workflow command it was
+ * expanded from. AgentSession stores the EXPANDED template as a plain user
+ * message, so without this Nolan's digest renders 400-line templates as
+ * `**User:** …` and treats them as user-authored asks.
+ *
+ * Returns the matched command plus any trailing user args, or null.
+ */
+export function matchExpandedCommand(text, commands) {
+    for (const command of commands) {
+        if (!command.prompt)
+            continue;
+        if (text === command.prompt)
+            return { command, args: null };
+        const prefix = command.prompt + USER_INSTRUCTIONS_HEADER;
+        if (text.startsWith(prefix)) {
+            const args = text.slice(prefix.length).trim();
+            return { command, args: args.length > 0 ? args : null };
+        }
+    }
+    return null;
+}
+/** Count assistant messages — the "did this run produce reviewable work"
+ *  signal. Compared before/after a run by the sidecar. */
+export function countAssistantMessages(messages) {
+    let count = 0;
+    for (const m of messages)
+        if (m.role === "assistant")
+            count++;
+    return count;
+}
+/** Extract every tool call made by assistant messages from `startIndex`
+ *  onward — i.e. the tool calls added during one turn, given the message
+ *  array length captured before that turn ran. Used to feed
+ *  isMechanicalOnlyTurn without the gate module depending on gg-ai's full
+ *  Message type (kept structurally typed so it's easy to unit test). */
+export function extractTurnToolCalls(messages, startIndex) {
+    const calls = [];
+    for (const m of messages.slice(startIndex)) {
+        if (m.role !== "assistant" || typeof m.content === "string")
+            continue;
+        for (const part of m.content) {
+            if (part.type === "tool_call" && typeof part.name === "string") {
+                calls.push({ name: part.name, args: part.args });
+            }
+        }
+    }
+    return calls;
+}
+/**
+ * Decide whether the autopilot cycle may start for a just-finished turn.
+ * Checks are ordered cheapest/most-fundamental first; the reason is logged by
+ * the sidecar so skips are debuggable from ezcoder-app-sidecar.log.
+ *
+ * `planPending` beats the workflow/mechanical/no-output checks: a plan
+ * submission via exit_plan flips plan mode OFF and often has only mechanical
+ * tool calls, but it IS reviewable work — Nolan reviews the plan itself
+ * (kind: "plan") instead of skipping. `planMode` still wins over it: a turn
+ * that ended INSIDE plan mode (enter without exit) has no submitted plan and
+ * Nolan must never prompt into a read-only session.
+ */
+export function shouldStartAutopilotCycle(input) {
+    if (!input.enabled)
+        return { start: false, reason: "disabled" };
+    if (input.cancelled)
+        return { start: false, reason: "cancelled" };
+    if (input.planMode)
+        return { start: false, reason: "plan-mode" };
+    if (input.planPending)
+        return { start: true, kind: "plan" };
+    if (input.workflowCommand)
+        return { start: false, reason: "workflow-command" };
+    if (input.mechanicalOnly)
+        return { start: false, reason: "mechanical-only" };
+    if (input.assistantMessagesAdded <= 0)
+        return { start: false, reason: "no-assistant-output" };
+    return { start: true, kind: "work" };
+}
+/** Dedicated tools that can never touch the repo/filesystem in a way worth
+ *  reviewing: pure lookups (read/grep/find/ls/source_path/code_search),
+ *  network research (web_fetch/web_search), reading a background process's
+ *  output (task_output), a UI screenshot, or loading a skill definition. Any
+ *  call to one of these is mechanical regardless of its arguments — unlike
+ *  bash, which needs isMechanicalBashCall to tell a read-only invocation from
+ *  a mutating one. Deliberately excludes generate_image (produces a real
+ *  artifact), subagent (can do anything internally), tasks/task_send/
+ *  task_stop (mutate task/process state), and enter_plan/exit_plan (mode
+ *  transitions already handled by the separate plan-mode gate check). */
+const READ_ONLY_TOOL_NAMES = new Set([
+    "read",
+    "grep",
+    "find",
+    "ls",
+    "web_fetch",
+    "web_search",
+    "source_path",
+    "code_search",
+    "task_output",
+    "screenshot",
+    "skill",
+]);
+/** Leading git subcommands that are a plain add/commit/push workflow —
+ *  mechanical for review purposes even though they mutate the repo (distinct
+ *  from plan-mode's stricter read-only bar in read-only-bash.ts). */
+const GIT_COMMIT_WORKFLOW = /^git\s+(add|commit|push)\b/i;
+/**
+ * True when a bash call is mechanical: starting a background process (a dev
+ * server or watcher — nothing to review until it's stopped and its actual
+ * code changes land in a later turn), a read-only command (reuses the same
+ * conservative classifier plan mode trusts), or a plain git add/commit/push
+ * chain. Conservative by construction: anything it can't prove mechanical
+ * (including a chain mixing git with other commands) returns false, so the
+ * turn still gets reviewed — false negatives are safe here, false positives
+ * are not.
+ */
+function isMechanicalBashCall(args) {
+    if (!args)
+        return false;
+    if (args.run_in_background === true)
+        return true;
+    const command = typeof args.command === "string" ? args.command : "";
+    if (!command.trim())
+        return false;
+    if (isReadOnlyCommand(command))
+        return true;
+    const segments = command
+        .split(/&&|;|\|/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    return segments.length > 0 && segments.every((s) => GIT_COMMIT_WORKFLOW.test(s));
+}
+/**
+ * True when the turn has nothing for Nolan to review: either it made NO tool
+ * calls at all (a plain-text answer — "a plain question that got answered
+ * with no code touched" is IGNORE per the autopilot contract), or EVERY tool
+ * call was mechanical (a dedicated read-only tool, or bash usage that starts
+ * a background process / is read-only / is a plain git commit-push chain).
+ * ANY non-mechanical call (edit, write, subagent, generate_image, or bash
+ * outside these safe shapes) makes the whole turn reviewable — conservative
+ * default: keep reviewing whenever it's unclear.
+ */
+export function isMechanicalOnlyTurn(toolCalls) {
+    if (toolCalls.length === 0)
+        return true;
+    return toolCalls.every((call) => READ_ONLY_TOOL_NAMES.has(call.name) ||
+        (call.name === "bash" && isMechanicalBashCall(call.args)));
+}
+//# sourceMappingURL=autopilot-gate.js.map

package/dist/core/autopilot-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autopilot-gate.js","sourceRoot":"","sources":["../../src/core/autopilot-gate.ts"],"names":[],"mappings":"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"}

package/dist/core/autopilot-gate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=autopilot-gate.test.d.ts.map

package/dist/core/autopilot-gate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autopilot-gate.test.d.ts","sourceRoot":"","sources":["../../src/core/autopilot-gate.test.ts"],"names":[],"mappings":""}

package/dist/core/autopilot-gate.test.js

@@ -0,0 +1,295 @@
+import { describe, it, expect } from "vitest";
+import { isWorkflowCommandText, matchExpandedCommand, countAssistantMessages, shouldStartAutopilotCycle, isMechanicalOnlyTurn, extractTurnToolCalls, USER_INSTRUCTIONS_HEADER, } from "./autopilot-gate.js";
+import { PROMPT_COMMANDS } from "./prompt-commands.js";
+const COMMANDS = [
+    { name: "compare", aliases: [], prompt: "Compare the code you just created…" },
+    { name: "bullet-proof", aliases: ["bp"], prompt: "Audit the project…" },
+];
+describe("isWorkflowCommandText", () => {
+    it("matches a bare command", () => {
+        expect(isWorkflowCommandText("/compare", COMMANDS)).toBe(true);
+    });
+    it("matches a command with trailing args", () => {
+        expect(isWorkflowCommandText("/compare src/foo.ts please", COMMANDS)).toBe(true);
+    });
+    it("matches aliases and is case-insensitive", () => {
+        expect(isWorkflowCommandText("/bp", COMMANDS)).toBe(true);
+        expect(isWorkflowCommandText("/COMPARE", COMMANDS)).toBe(true);
+        expect(isWorkflowCommandText("/Bullet-Proof", COMMANDS)).toBe(true);
+    });
+    it("tolerates leading whitespace (matches trim semantics of the prompt path)", () => {
+        expect(isWorkflowCommandText("  /compare", COMMANDS)).toBe(true);
+    });
+    it("rejects unknown commands, non-slash text, and prefix collisions", () => {
+        expect(isWorkflowCommandText("/help", COMMANDS)).toBe(false);
+        expect(isWorkflowCommandText("/comparex", COMMANDS)).toBe(false);
+        expect(isWorkflowCommandText("compare the files", COMMANDS)).toBe(false);
+        expect(isWorkflowCommandText("run /compare for me", COMMANDS)).toBe(false);
+        expect(isWorkflowCommandText("/", COMMANDS)).toBe(false);
+        expect(isWorkflowCommandText("", COMMANDS)).toBe(false);
+    });
+    it("recognizes EVERY built-in workflow command (the real leak set)", () => {
+        // The reported bug: /compare fired an autopilot review of a report-only
+        // command. Prove the gate recognizes every shipped PROMPT_COMMAND (and its
+        // aliases) so none of them can leak into a review.
+        for (const cmd of PROMPT_COMMANDS) {
+            expect(isWorkflowCommandText(`/${cmd.name}`, PROMPT_COMMANDS)).toBe(true);
+            expect(isWorkflowCommandText(`/${cmd.name} with args`, PROMPT_COMMANDS)).toBe(true);
+            for (const alias of cmd.aliases) {
+                expect(isWorkflowCommandText(`/${alias}`, PROMPT_COMMANDS)).toBe(true);
+            }
+        }
+    });
+});
+describe("matchExpandedCommand", () => {
+    it("matches an exact template body", () => {
+        const m = matchExpandedCommand("Compare the code you just created…", COMMANDS);
+        expect(m?.command.name).toBe("compare");
+        expect(m?.args).toBeNull();
+    });
+    it("matches template + user-instructions suffix and extracts the args", () => {
+        const text = `Audit the project…${USER_INSTRUCTIONS_HEADER}only the auth module`;
+        const m = matchExpandedCommand(text, COMMANDS);
+        expect(m?.command.name).toBe("bullet-proof");
+        expect(m?.args).toBe("only the auth module");
+    });
+    it("uses the exact separator AgentSession.prompt() inserts", () => {
+        // Lockstep guard: if agent-session.ts ever changes its expansion format,
+        // this literal must change with it or digest labeling silently breaks.
+        expect(USER_INSTRUCTIONS_HEADER).toBe("\n\n## User Instructions\n\n");
+    });
+    it("returns null for ordinary user text and near-misses", () => {
+        expect(matchExpandedCommand("compare my code to the repo", COMMANDS)).toBeNull();
+        // Template body with arbitrary extra text but no separator is NOT an expansion.
+        expect(matchExpandedCommand("Compare the code you just created… and also do X", COMMANDS)).toBeNull();
+        expect(matchExpandedCommand("", COMMANDS)).toBeNull();
+    });
+    it("matches every real built-in template round-tripped through expansion", () => {
+        for (const cmd of PROMPT_COMMANDS) {
+            // Mirrors AgentSession.prompt(): bare command → template verbatim.
+            expect(matchExpandedCommand(cmd.prompt, PROMPT_COMMANDS)?.command.name).toBe(cmd.name);
+            // Command with args → template + header + args.
+            const withArgs = `${cmd.prompt}${USER_INSTRUCTIONS_HEADER}focus on src/`;
+            const m = matchExpandedCommand(withArgs, PROMPT_COMMANDS);
+            expect(m?.command.name).toBe(cmd.name);
+            expect(m?.args).toBe("focus on src/");
+        }
+    });
+});
+describe("countAssistantMessages", () => {
+    it("counts only assistant-role messages", () => {
+        expect(countAssistantMessages([
+            { role: "system" },
+            { role: "user" },
+            { role: "assistant" },
+            { role: "tool" },
+            { role: "assistant" },
+        ])).toBe(2);
+        expect(countAssistantMessages([])).toBe(0);
+    });
+});
+describe("shouldStartAutopilotCycle", () => {
+    const reviewable = {
+        enabled: true,
+        cancelled: false,
+        planMode: false,
+        workflowCommand: false,
+        assistantMessagesAdded: 1,
+    };
+    it("starts a work review for a normal reviewable turn", () => {
+        expect(shouldStartAutopilotCycle(reviewable)).toEqual({ start: true, kind: "work" });
+    });
+    it("starts a plan review when the turn submitted a plan (exit_plan)", () => {
+        expect(shouldStartAutopilotCycle({ ...reviewable, planPending: true })).toEqual({
+            start: true,
+            kind: "plan",
+        });
+    });
+    it("plan review beats workflow-command / mechanical-only / no-assistant-output", () => {
+        // A plan-submission turn often looks skippable (mostly reads + exit_plan,
+        // maybe zero assistant text added by the gate's count) — planPending must
+        // override all the cheap-skip checks so the plan actually gets reviewed.
+        expect(shouldStartAutopilotCycle({
+            ...reviewable,
+            planPending: true,
+            workflowCommand: true,
+            mechanicalOnly: true,
+            assistantMessagesAdded: 0,
+        })).toEqual({ start: true, kind: "plan" });
+    });
+    it("disabled / cancelled / plan-mode still beat a pending plan", () => {
+        expect(shouldStartAutopilotCycle({ ...reviewable, planPending: true, enabled: false })).toEqual({ start: false, reason: "disabled" });
+        expect(shouldStartAutopilotCycle({ ...reviewable, planPending: true, cancelled: true })).toEqual({ start: false, reason: "cancelled" });
+        // Still INSIDE plan mode (entered, never exited) → no submitted plan to
+        // review; Nolan must not touch a read-only session.
+        expect(shouldStartAutopilotCycle({ ...reviewable, planPending: true, planMode: true })).toEqual({ start: false, reason: "plan-mode" });
+    });
+    it("skips when autopilot is off", () => {
+        expect(shouldStartAutopilotCycle({ ...reviewable, enabled: false })).toEqual({
+            start: false,
+            reason: "disabled",
+        });
+    });
+    it("skips when the turn was cancelled", () => {
+        expect(shouldStartAutopilotCycle({ ...reviewable, cancelled: true })).toEqual({
+            start: false,
+            reason: "cancelled",
+        });
+    });
+    it("skips when the turn ended in plan mode (pending Accept/Reject modal)", () => {
+        expect(shouldStartAutopilotCycle({ ...reviewable, planMode: true })).toEqual({
+            start: false,
+            reason: "plan-mode",
+        });
+    });
+    it("skips workflow-command turns (/compare — the reported bug)", () => {
+        expect(shouldStartAutopilotCycle({ ...reviewable, workflowCommand: true })).toEqual({
+            start: false,
+            reason: "workflow-command",
+        });
+    });
+    it("skips turns that added no assistant output (/help, unknown /foo, failed runs)", () => {
+        expect(shouldStartAutopilotCycle({ ...reviewable, assistantMessagesAdded: 0 })).toEqual({
+            start: false,
+            reason: "no-assistant-output",
+        });
+        // A run that somehow REMOVED messages (defensive) also never reviews.
+        expect(shouldStartAutopilotCycle({ ...reviewable, assistantMessagesAdded: -1 })).toEqual({
+            start: false,
+            reason: "no-assistant-output",
+        });
+    });
+    it("skips mechanical-only turns (dev server start, read-only lookup, git commit/push)", () => {
+        expect(shouldStartAutopilotCycle({ ...reviewable, mechanicalOnly: true })).toEqual({
+            start: false,
+            reason: "mechanical-only",
+        });
+    });
+    it("resolves multiple skip conditions in fixed priority order", () => {
+        // disabled beats everything; plan-mode beats workflow-command beats no-output.
+        expect(shouldStartAutopilotCycle({
+            enabled: false,
+            cancelled: true,
+            planMode: true,
+            workflowCommand: true,
+            assistantMessagesAdded: 0,
+        })).toEqual({ start: false, reason: "disabled" });
+        expect(shouldStartAutopilotCycle({
+            ...reviewable,
+            planMode: true,
+            workflowCommand: true,
+            assistantMessagesAdded: 0,
+        })).toEqual({ start: false, reason: "plan-mode" });
+        expect(shouldStartAutopilotCycle({
+            ...reviewable,
+            workflowCommand: true,
+            assistantMessagesAdded: 0,
+        })).toEqual({ start: false, reason: "workflow-command" });
+    });
+});
+describe("isMechanicalOnlyTurn", () => {
+    it("is TRUE for a turn with no tool calls (plain-text answer, nothing built)", () => {
+        // Matches the autopilot contract's own IGNORE example: "a plain question
+        // that got answered with no code touched".
+        expect(isMechanicalOnlyTurn([])).toBe(true);
+    });
+    it("treats dedicated read-only tools as mechanical regardless of args", () => {
+        const calls = [
+            { name: "read", args: { file_path: "a.ts" } },
+            { name: "grep", args: { pattern: "TODO" } },
+            { name: "find", args: { pattern: "*.ts" } },
+            { name: "ls", args: { path: "." } },
+            { name: "web_fetch", args: { url: "https://example.com" } },
+            { name: "web_search", args: { query: "x" } },
+            { name: "source_path", args: { package: "zod" } },
+            { name: "code_search", args: { query: "x" } },
+            { name: "task_output", args: { id: "abc" } },
+            { name: "screenshot", args: { url: "http://localhost:3000" } },
+            { name: "skill", args: { skill: "find-skills" } },
+        ];
+        expect(isMechanicalOnlyTurn(calls)).toBe(true);
+    });
+    it("is NOT mechanical when a research turn also calls write/edit/subagent", () => {
+        expect(isMechanicalOnlyTurn([
+            { name: "read", args: {} },
+            { name: "write", args: {} },
+        ])).toBe(false);
+        expect(isMechanicalOnlyTurn([
+            { name: "grep", args: {} },
+            { name: "subagent", args: {} },
+        ])).toBe(false);
+    });
+    it("is NOT mechanical for tools that mutate task/process state or produce artifacts", () => {
+        expect(isMechanicalOnlyTurn([{ name: "generate_image", args: {} }])).toBe(false);
+        expect(isMechanicalOnlyTurn([{ name: "tasks", args: {} }])).toBe(false);
+        expect(isMechanicalOnlyTurn([{ name: "task_send", args: {} }])).toBe(false);
+        expect(isMechanicalOnlyTurn([{ name: "task_stop", args: {} }])).toBe(false);
+    });
+    it("treats a background bash start (dev server / watcher) as mechanical", () => {
+        const calls = [
+            { name: "bash", args: { command: "npm run dev", run_in_background: true } },
+        ];
+        expect(isMechanicalOnlyTurn(calls)).toBe(true);
+    });
+    it("treats a read-only bash command as mechanical", () => {
+        const calls = [{ name: "bash", args: { command: "git status" } }];
+        expect(isMechanicalOnlyTurn(calls)).toBe(true);
+    });
+    it("treats a plain git add/commit/push workflow as mechanical", () => {
+        const calls = [
+            { name: "bash", args: { command: 'git add -A && git commit -m "fix" && git push' } },
+        ];
+        expect(isMechanicalOnlyTurn(calls)).toBe(true);
+    });
+    it("is NOT mechanical when a git chain mixes in a non-git command", () => {
+        const calls = [
+            { name: "bash", args: { command: "git commit -m x && rm -rf dist" } },
+        ];
+        expect(isMechanicalOnlyTurn(calls)).toBe(false);
+    });
+    it("is NOT mechanical when any call is edit/write", () => {
+        const calls = [
+            { name: "bash", args: { command: "git status" } },
+            { name: "edit", args: { file_path: "a.ts" } },
+        ];
+        expect(isMechanicalOnlyTurn(calls)).toBe(false);
+    });
+    it("is NOT mechanical for an ordinary mutating bash command", () => {
+        const calls = [{ name: "bash", args: { command: "rm -rf node_modules" } }];
+        expect(isMechanicalOnlyTurn(calls)).toBe(false);
+    });
+    it("is NOT mechanical when args are missing (defensive)", () => {
+        expect(isMechanicalOnlyTurn([{ name: "bash" }])).toBe(false);
+    });
+});
+describe("extractTurnToolCalls", () => {
+    it("collects tool calls only from assistant messages at/after startIndex", () => {
+        const messages = [
+            { role: "user", content: "hi" },
+            {
+                role: "assistant",
+                content: [{ type: "tool_call", name: "read", args: { file_path: "old.ts" } }],
+            },
+            { role: "tool", content: "ok" },
+            {
+                role: "assistant",
+                content: [
+                    { type: "text" },
+                    { type: "tool_call", name: "bash", args: { command: "git status" } },
+                ],
+            },
+        ];
+        expect(extractTurnToolCalls(messages, 2)).toEqual([
+            { name: "bash", args: { command: "git status" } },
+        ]);
+    });
+    it("returns an empty array for a string-content assistant message (no tool calls)", () => {
+        const messages = [{ role: "assistant", content: "just text, no tools" }];
+        expect(extractTurnToolCalls(messages, 0)).toEqual([]);
+    });
+    it("returns an empty array when startIndex is at the end", () => {
+        const messages = [{ role: "assistant", content: [{ type: "tool_call", name: "bash" }] }];
+        expect(extractTurnToolCalls(messages, 1)).toEqual([]);
+    });
+});
+//# sourceMappingURL=autopilot-gate.test.js.map

package/dist/core/autopilot-gate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autopilot-gate.test.js","sourceRoot":"","sources":["../../src/core/autopilot-gate.test.ts"],"names":[],"mappings":"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"}

package/dist/core/autopilot-verdict.d.ts

@@ -2,7 +2,7 @@
  * Autopilot Nolan's verdict contract.
  *
  * In autopilot mode Nolan never talks to the user — he auto-reviews EZ Coder's
- * work and replies with exactly one of three machine-parseable verdicts. The
+ * work and replies with exactly one of four machine-parseable verdicts. The
  * first non-empty line carries the keyword; anything after is the payload.
  *
  *   PROMPT
@@ -10,17 +10,35 @@
  *
  *   ALL_CLEAR
  *
+ *   IGNORE
+ *
  *   HUMAN
  *   <one short reason the human is needed>
  *
+ * ALL_CLEAR and IGNORE both stop the cycle with nothing left to do, but they
+ * mean different things to the UI: ALL_CLEAR is a verdict on real work ("GG
+ * Coder built/changed something and it checks out") and renders a one-line Nolan
+ * marker. IGNORE means the turn was never worth reviewing in the first place
+ * (small talk, a question, an ack, a mechanical operation with no code
+ * changes) — it renders NOTHING, not even a marker, so trivial turns don't
+ * spam the transcript with a Nolan bubble that adds no information.
+ *
  * Parsing is forgiving and safe-by-default: any reply we can't confidently map
- * to PROMPT or ALL_CLEAR becomes a HUMAN stop, never a blind loop.
+ * to PROMPT, ALL_CLEAR, or IGNORE becomes a HUMAN stop, never a blind loop.
+ *
+ * Recovery order for prose-then-keyword drift (Nolan writing commentary before
+ * the verdict despite the contract): bare trailing ALL_CLEAR/IGNORE → buried
+ * HUMAN → buried line-start PROMPT (uppercase, line-start only, so prose like
+ * "prompt the user" can never match). HUMAN wins over PROMPT when both appear
+ * — recovering a stop is always safe, recovering an action must lose ties.
  */
 export type AutopilotVerdict = {
     kind: "prompt";
     body: string;
 } | {
     kind: "all_clear";
+} | {
+    kind: "ignore";
 } | {
     kind: "human";
     reason: string;

package/dist/core/autopilot-verdict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autopilot-verdict.d.ts","sourceRoot":"","sources":["../../src/core/autopilot-verdict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA0BtC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAuDrE"}
+{"version":3,"file":"autopilot-verdict.d.ts","sourceRoot":"","sources":["../../src/core/autopilot-verdict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAyDtC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAuGrE"}