@prestyj/cli 5.3.0 → 5.4.0

package/dist/core/nolan-prompt.js

@@ -8,9 +8,14 @@
  * runnable prompts the user can fire into EZ Coder, plus blunt, casual
  * mentorship. Nolan never writes code; he recommends, EZ Coder executes.
  *
- * This module owns ONLY Nolan's identity + method. The "what they're building"
- * context is built fresh each turn by `buildNolanContext()` in the sidecar.
+ * This module owns Nolan's identity + method, PLUS the static project-context
+ * files (CLAUDE.md/AGENTS.md up the tree) — they rarely change turn to turn,
+ * so they're read once per session creation and folded into the cached system
+ * prompt instead of being re-sent uncached in every digest (see
+ * `buildNolanDigest()` in nolan-context.ts, which only carries what's genuinely
+ * dynamic: cwd/platform/git branch/recent activity/original request).
  */
+import { collectProjectContext } from "../system-prompt.js";
 /** The fenced-block language Nolan wraps every recommended EZ Coder prompt in.
  *  The webview special-cases ```prompt blocks into a "Send to EZ Coder" button. */
 export const NOLAN_PROMPT_FENCE = "prompt";
@@ -35,10 +40,11 @@ function renderUncachedDateSuffix() {
  * are listed by the session's own Tools section; this prompt teaches him how to
  * think and how to format what he hands back.
  */
-export function buildNolanSystemPrompt() {
+export async function buildNolanSystemPrompt(cwd) {
     return [
         renderIdentity(),
         renderEdge(),
+        renderGGCoderCapabilities(),
         renderSkeptical(),
         renderTaste(),
         renderMethod(),
@@ -47,10 +53,13 @@ export function buildNolanSystemPrompt() {
         renderDiscipline(),
         renderVoice(),
         renderContextNote(),
+        await renderProjectContext(cwd),
         // Volatile date AFTER the uncached marker, so the static persona above stays
         // in the provider prompt cache and only this line changes day to day.
         renderUncachedDateSuffix(),
-    ].join("\n\n");
+    ]
+        .filter(Boolean)
+        .join("\n\n");
 }
 /**
  * Build Autopilot Nolan's system prompt — a separate, non-chatty mode of the same
@@ -61,17 +70,31 @@ export function buildNolanSystemPrompt() {
  * user-facing output contract for the verdict format and drops the chat-voice
  * sections to save tokens.
  */
-export function buildNolanAutopilotSystemPrompt() {
+export async function buildNolanAutopilotSystemPrompt(cwd) {
     return [
         renderIdentity(),
+        renderGGCoderCapabilities(),
         renderSkeptical(),
         renderTaste(),
         renderMethod(),
         renderDiscipline(),
         renderAutopilotContract(),
+        await renderProjectContext(cwd),
         // Volatile date AFTER the uncached marker so the static persona stays cached.
         renderUncachedDateSuffix(),
-    ].join("\n\n");
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+}
+/** Static project-context files (CLAUDE.md/AGENTS.md up the tree from cwd),
+ *  folded into the cached system prompt. Read once per session creation
+ *  instead of per-turn in the digest — rarely changes mid-session, and even
+ *  when it does, a stale read is harmless (Nolan's tools can always re-check). */
+async function renderProjectContext(cwd) {
+    const parts = await collectProjectContext(cwd).catch(() => []);
+    if (parts.length === 0)
+        return "";
+    return `## Project context\n\n${parts.join("\n\n")}`;
 }
 function renderIdentity() {
     return (`You are Nolan Grout, the developer of EZ Coder, sitting beside the user as their ` +
@@ -99,6 +122,36 @@ function renderEdge() {
         `directly for the same result, you added nothing. Be the strategy, the ` +
         `skeptic, or the better-shaped ask.`);
 }
+function renderGGCoderCapabilities() {
+    return (`## What EZ Coder can do\n\n` +
+        `You direct EZ Coder, so you have to know its reach. It is a full coding agent ` +
+        `with these tools, and your prompts should assume them instead of making the ` +
+        `user do anything it can do itself:\n` +
+        `- Edits the repo: read, write, edit files; grep/find/ls to search and navigate.\n` +
+        `- Runs the shell: bash for installs, builds, tests, git, migrations, scripts, ` +
+        `and any long-running/background process. It can and should verify its own work ` +
+        `by running things.\n` +
+        `- Plan mode: enter_plan drops it into read-only research and drafts a written ` +
+        `plan for approval before touching code; exit_plan submits it. Ask for a plan ` +
+        `when a task is big or risky enough to design before building.\n` +
+        `- Spawns subagents: parallel isolated workers for focused subtasks (research, ` +
+        `wide exploration, branch-isolated changes). Big multi-part jobs can fan out.\n` +
+        `- Sees the web: web_search + web_fetch for live docs, and source_path to read ` +
+        `installed dependency source.\n` +
+        `- Sees the UI: screenshot renders a local dev server or URL to a PNG so it can ` +
+        `visually self-check what it built. It can also generate images on request.\n` +
+        `- Live type checking: every edit gets compiler-grade LSP diagnostics fed back, ` +
+        `so it self-corrects type errors as it goes.\n` +
+        `- MCP tools and custom .ezcoder/commands may extend it further per project.\n\n` +
+        `So when you hand over a prompt, tell it to set up, build, test, and screenshot ` +
+        `itself. Push it to plan when the work warrants a plan, to fan out to subagents ` +
+        `when the work is wide, and to prove it ran, not just wrote.\n\n` +
+        `Two different jobs, don't confuse them: your OWN read-only tools are for ` +
+        `checking things yourself right now (verify a claim, read the code, see the UI); ` +
+        `EZ Coder's tools are for the actual building. Check with your own eyes first — ` +
+        `don't send EZ Coder off to find out something you could confirm faster ` +
+        `read-only — then delegate the real work.`);
+}
 function renderSkeptical() {
     return (`## Skeptical by default\n\n` +
         `You do not look at code or a claim and nod. You assume nothing and you verify. ` +
@@ -170,13 +223,28 @@ function renderAutopilotContract() {
     return (`## Autopilot mode: verdict only\n\n` +
         `You are running in autopilot. There is NO user in this conversation — you are ` +
         `reviewing EZ Coder's just-finished turn directly, and your reply is read by a ` +
-        `machine, not a person. Do not greet, explain your reasoning, or mentor. Output ` +
-        `exactly one verdict in this format, first line = keyword:\n\n` +
+        `machine, not a person. Do not greet, explain your reasoning, mentor, or summarize ` +
+        `what changed. In chat mode you drop a one-line reason before a prompt — NOT ` +
+        `here. There is no audience for a why. Never justify your verdict anywhere in ` +
+        `the reply; the only place a reason may exist is INSIDE a PROMPT body, and only ` +
+        `when EZ Coder itself needs it to do the job. The parser reads the FIRST line ` +
+        `of your reply — anything before the keyword (a recap, an opinion, "Looks ` +
+        `good.") is treated as garbage and the whole turn silently falls back to a ` +
+        `HUMAN stop, which is worse than saying nothing. The very first character of ` +
+        `your reply must be the keyword. Output exactly one verdict in this format, ` +
+        `first line = keyword, nothing before it:\n\n` +
         `PROMPT\n<a runnable EZ Coder prompt, 1-3 lines, terminology-correct, says what ` +
-        `to do and why>\n\n` +
+        `to do — include a why only if EZ Coder needs it to do the work>\n\n` +
         `ALL_CLEAR\n\n` +
         `IGNORE\n\n` +
         `HUMAN\n<one short line: why a human decision is needed>\n\n` +
+        `WRONG — reasoning before the keyword kills the whole cycle:\n` +
+        `"The diagnosis is solid and the fix is safe to apply.\nPROMPT Apply the ` +
+        `fix: guard compact() on the transient flag."\n\n` +
+        `RIGHT — keyword first, why (if any) inside the body for EZ Coder's benefit:\n` +
+        `"PROMPT\nGuard AgentSession.compact() on this.opts.transient — it currently ` +
+        `persists transient sessions to disk. Add a test proving no session file is ` +
+        `created."\n\n` +
         `Rules:\n` +
         `- IGNORE first: was this turn even real work? Small talk ("hi", "thanks", ` +
         `"nice"), a plain question that got answered with no code touched, an ack, or a ` +
@@ -193,17 +261,30 @@ function renderAutopilotContract() {
         `obvious bug. The prompt body should tell EZ Coder to fix it AND prove it ` +
         `(run the test, screenshot the UI) — you can't run anything yourself.\n` +
         `- HUMAN only when a real decision needs the user: an ambiguous requirement, a ` +
-        `destructive tradeoff, or missing information you cannot verify with your ` +
-        `read-only tools. HUMAN also whenever EZ Coder ended its turn by asking the ` +
-        `user a question, presenting options (A/B/C choices, "want me to…"), or ` +
-        `submitting a plan for approval — never answer on the user's behalf.\n` +
+        `destructive tradeoff, missing information you cannot verify with your ` +
+        `read-only tools, credentials/secrets, external access, budget/cost, or a ` +
+        `product/taste choice the user must own. EZ Coder asking the user a ` +
+        `question or presenting options is HUMAN only when answering it requires ` +
+        `one of those user-level decisions. If EZ Coder merely asks permission to ` +
+        `continue work that is mechanically implied by the user's original ask and ` +
+        `safe to do without new information, do NOT block on the human. Use PROMPT ` +
+        `with the concrete next step.\n` +
+        `- Plans are YOURS to review. When your context contains a 'Plan under ` +
+        `review' section, you are the plan reviewer: ALL_CLEAR approves it and ` +
+        `implementation starts immediately, PROMPT sends revision feedback, HUMAN ` +
+        `only for a genuine user-level decision (destructive/ambiguous product ` +
+        `choice). Default to approving a sound plan — taste nitpicks are not ` +
+        `blockers. Never IGNORE a plan.\n` +
         `- Transcript lines labeled "Nolan autopilot (injected)" are YOUR own earlier ` +
         `fix prompts, not user asks. Judge only against the original user request.\n` +
         `- You are read-only. Use read/grep/find/ls/web/kencode-search ONLY when a fact ` +
         `is truly in doubt; otherwise judge from the transcript and answer. Every wasted ` +
         `tool call costs tokens.\n` +
-        `- Never wrap the verdict in prose or a code fence. First line is the keyword. ` +
-        `Nothing else.`);
+        `- Never wrap the verdict in prose or a code fence, and never add commentary ` +
+        `before OR after the keyword line (no recap of what you found, no "Looks good", ` +
+        `no explanation of the verdict). The keyword line is your entire reply for ` +
+        `ALL_CLEAR and IGNORE; PROMPT and HUMAN take only the payload described above, ` +
+        `nothing more.`);
 }
 function renderUiTaste() {
     return (`## UI: copy proven winners\n\n` +

package/dist/core/nolan-prompt.js.map

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

package/dist/core/nolan-prompt.test.js

@@ -1,20 +1,46 @@
-import { describe, it, expect } from "vitest";
+import { describe, it, expect, beforeAll } from "vitest";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs/promises";
 import { buildNolanSystemPrompt, buildNolanAutopilotSystemPrompt } from "./nolan-prompt.js";
 import { INJECTED_PROMPT_LABEL } from "./nolan-context.js";
+// No CLAUDE.md/AGENTS.md up the tree from tmpdir, so the appended project-
+// context section is empty and these assertions stay focused on the persona.
+const TEST_CWD = os.tmpdir();
 describe("buildNolanAutopilotSystemPrompt — verdict contract", () => {
-    const prompt = buildNolanAutopilotSystemPrompt();
+    let prompt;
+    beforeAll(async () => {
+        prompt = await buildNolanAutopilotSystemPrompt(TEST_CWD);
+    });
     it("teaches all four verdict keywords", () => {
         for (const keyword of ["PROMPT", "ALL_CLEAR", "IGNORE", "HUMAN"]) {
             expect(prompt).toContain(keyword);
         }
     });
-    it("routes end-of-turn questions/options/plans to HUMAN, never PROMPT", () => {
+    it("routes only real user-level questions/options to HUMAN", () => {
         // Leak regression: without this rule, EZ Coder ending with "want me to…?"
         // or an A/B/C menu reads as "unfinished" and Nolan answers for the user.
+        // But the inverse matters too: permission to continue obvious safe work is
+        // NOT a user decision and should be a PROMPT, not a blocker. This is a
+        // principle, not a list of special-case examples.
         expect(prompt).toContain("asking the ");
         expect(prompt).toContain("presenting options");
-        expect(prompt).toContain("never answer on the user's behalf");
-        expect(prompt).toContain("submitting a plan for approval");
+        expect(prompt).toContain("HUMAN only when answering it requires");
+        expect(prompt).toContain("user-level decisions");
+        expect(prompt).toContain("mechanically implied by the user's original ask");
+        expect(prompt).toContain("safe to do without new information");
+        expect(prompt).toContain("Use PROMPT with the concrete next step");
+    });
+    it("makes Nolan the plan reviewer (no automatic HUMAN on plan submissions)", () => {
+        // In autopilot, a submitted plan is reviewed by Nolan himself — approve,
+        // revise, or (rarely) hand a genuine product decision to the user.
+        expect(prompt).toContain("Plans are YOURS to review");
+        expect(prompt).toContain("'Plan under review' section");
+        expect(prompt).toContain("implementation starts immediately");
+        expect(prompt).toContain("Default to approving a sound plan");
+        expect(prompt).toContain("Never IGNORE a plan");
+        // The old auto-HUMAN clause must be gone.
+        expect(prompt).not.toContain("submitting a plan for approval");
     });
     it("tells Nolan injected transcript lines are his own, not user asks", () => {
         expect(prompt).toContain("Nolan autopilot (injected)");
@@ -31,13 +57,82 @@ describe("buildNolanAutopilotSystemPrompt — verdict contract", () => {
         expect(INJECTED_PROMPT_LABEL).toContain("Nolan autopilot (injected)");
         expect(prompt).toContain("Nolan autopilot (injected)");
     });
+    it("kills the standalone why — reasons live only inside a PROMPT body", () => {
+        // Drift regression: chat Nolan is trained to drop a one-line reason before a
+        // prompt; autopilot Nolan carried that habit over and front-loaded reasoning
+        // prose before the keyword, which parsed as a HUMAN stop and stalled the
+        // cycle. The contract must name the habit and give the why exactly one
+        // legal home: inside the PROMPT body, only when EZ Coder needs it.
+        expect(prompt).toContain("NOT ");
+        expect(prompt).toContain("no audience for a why");
+        expect(prompt).toContain("Never justify your verdict");
+        expect(prompt).toContain("INSIDE a PROMPT body");
+        expect(prompt).toContain("when EZ Coder itself needs it");
+    });
+    it("shows a contrastive WRONG/RIGHT example of the drift", () => {
+        // Models obey a wrong→right pair better than prohibitions alone.
+        expect(prompt).toContain("WRONG — reasoning before the keyword");
+        expect(prompt).toContain("RIGHT — keyword first");
+    });
+    it("forbids commentary before or after the keyword line", () => {
+        // Leak regression: Nolan once prefaced ALL_CLEAR with a recap/opinion ("The
+        // label is now a plain non-clickable span... Typecheck passed.\nALL_CLEAR"),
+        // which the parser couldn't read as a bare verdict and surfaced as a raw
+        // HUMAN bubble. The prompt must explicitly ban prose around the keyword.
+        expect(prompt).toContain("nothing before it");
+        expect(prompt).toContain("never add commentary");
+        expect(prompt).toContain("no recap of what you found");
+    });
 });
 describe("buildNolanSystemPrompt — chat mode unaffected", () => {
-    it("keeps the chat output contract (prompt fence) and no verdict keywords", () => {
-        const prompt = buildNolanSystemPrompt();
+    it("keeps the chat output contract (prompt fence) and no verdict keywords", async () => {
+        const prompt = await buildNolanSystemPrompt(TEST_CWD);
         expect(prompt).toContain("Send to EZ Coder");
         // The verdict contract is autopilot-only.
         expect(prompt).not.toContain("ALL_CLEAR");
     });
 });
+describe("EZ Coder capabilities — both modes know what the executor can do", () => {
+    it("teaches Nolan EZ Coder's real toolset in chat AND autopilot", async () => {
+        // Nolan directs EZ Coder, so both prompts must ground his instructions in the
+        // executor's actual capabilities (plan mode, subagents, bash, screenshots),
+        // not leave him guessing from the transcript.
+        for (const prompt of [
+            await buildNolanSystemPrompt(TEST_CWD),
+            await buildNolanAutopilotSystemPrompt(TEST_CWD),
+        ]) {
+            expect(prompt).toContain("What EZ Coder can do");
+            expect(prompt).toContain("enter_plan");
+            expect(prompt).toContain("subagents");
+            expect(prompt).toContain("bash");
+            expect(prompt).toContain("screenshot");
+        }
+    });
+    it("draws the boundary: Nolan's own tools check, EZ Coder's tools build", async () => {
+        // Nolan should verify facts with his own read-only tools before delegating,
+        // not send EZ Coder to find out something he could confirm faster himself.
+        for (const prompt of [
+            await buildNolanSystemPrompt(TEST_CWD),
+            await buildNolanAutopilotSystemPrompt(TEST_CWD),
+        ]) {
+            expect(prompt).toContain("Check with your own eyes first");
+            expect(prompt).toContain("then delegate the real work");
+        }
+    });
+});
+describe("buildNolanSystemPrompt / buildNolanAutopilotSystemPrompt — project context", () => {
+    it("folds project context into the cached system prompt, not the per-turn digest", async () => {
+        const dir = await fs.mkdtemp(path.join(os.tmpdir(), "nolan-prompt-test-"));
+        await fs.writeFile(path.join(dir, "CLAUDE.md"), "Build a todo app.");
+        try {
+            const chat = await buildNolanSystemPrompt(dir);
+            const autopilot = await buildNolanAutopilotSystemPrompt(dir);
+            expect(chat).toContain("Build a todo app.");
+            expect(autopilot).toContain("Build a todo app.");
+        }
+        finally {
+            await fs.rm(dir, { recursive: true, force: true });
+        }
+    });
+});
 //# sourceMappingURL=nolan-prompt.test.js.map

package/dist/core/nolan-prompt.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"nolan-prompt.test.js","sourceRoot":"","sources":["../../src/core/nolan-prompt.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,QAAQ,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAClE,MAAM,MAAM,GAAG,+BAA+B,EAAE,CAAC;IAEjD,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,KAAK,MAAM,OAAO,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,0EAA0E;QAC1E,yEAAyE;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8CAA8C,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,0EAA0E;QAC1E,8DAA8D;QAC9D,MAAM,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACtE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC7C,0CAA0C;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"nolan-prompt.test.js","sourceRoot":"","sources":["../../src/core/nolan-prompt.test.ts"],"names":[],"mappings":"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"}

package/dist/core/persistent-shell.d.ts

@@ -0,0 +1,27 @@
+export interface PersistentRunResult {
+    exitCode: number | "TIMEOUT";
+    output: string;
+}
+export declare class PersistentShell {
+    private readonly cwd;
+    private readonly env;
+    private readonly maxOutputBytes;
+    private child;
+    private buffer;
+    private busy;
+    constructor(cwd: string, env: NodeJS.ProcessEnv, maxOutputBytes: number);
+    /** True while a previous persistent command is still running. */
+    get isBusy(): boolean;
+    private ensureChild;
+    /**
+     * Run one command in the session shell. Serialized by the tool's sequential
+     * execution mode; a concurrent call while busy is rejected defensively.
+     * On timeout or abort the whole session is killed (state is gone — the next
+     * call starts a fresh shell) because a wedged command cannot be safely
+     * skipped within the same shell.
+     */
+    run(command: string, timeoutMs: number, signal: AbortSignal, onChunk?: (text: string) => void): Promise<PersistentRunResult>;
+    /** Kill the session shell; the next run() starts a fresh one. */
+    kill(): void;
+}
+//# sourceMappingURL=persistent-shell.d.ts.map

package/dist/core/persistent-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-shell.d.ts","sourceRoot":"","sources":["../../src/core/persistent-shell.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IAMxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAPjC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,IAAI,CAAS;gBAGF,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,cAAc,EAAE,MAAM;IAGzC,iEAAiE;IACjE,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,OAAO,CAAC,WAAW;IAkBnB;;;;;;OAMG;IACH,GAAG,CACD,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/B,OAAO,CAAC,mBAAmB,CAAC;IAgG/B,iEAAiE;IACjE,IAAI,IAAI,IAAI;CAKb"}

package/dist/core/persistent-shell.js

@@ -0,0 +1,150 @@
+/**
+ * Persistent bash session for the bash tool's opt-in `persist` mode.
+ *
+ * One long-lived bash per instance; commands are written to stdin and
+ * delimited with a sentinel that carries the exit code. Benchmarked at ~0.3ms
+ * per call vs ~6.4ms for spawn-per-call (see bash-spawn-benchmark.ts), and —
+ * the real win — cd/env/shell state survive across calls.
+ *
+ * POSIX-only (needs a real bash). Callers must fall back to spawn-per-call
+ * when bash is unavailable (Windows cmd.exe fallback path).
+ */
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { killProcessTree } from "../utils/process.js";
+export class PersistentShell {
+    cwd;
+    env;
+    maxOutputBytes;
+    child = null;
+    buffer = "";
+    busy = false;
+    constructor(cwd, env, maxOutputBytes) {
+        this.cwd = cwd;
+        this.env = env;
+        this.maxOutputBytes = maxOutputBytes;
+    }
+    /** True while a previous persistent command is still running. */
+    get isBusy() {
+        return this.busy;
+    }
+    ensureChild() {
+        if (this.child && this.child.exitCode === null && !this.child.killed) {
+            return this.child;
+        }
+        // Fresh session: no rc files so startup is fast and deterministic.
+        const child = spawn("bash", ["--norc", "--noprofile"], {
+            cwd: this.cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+            env: this.env,
+            detached: true,
+        });
+        // Don't let a lingering session shell keep the parent process alive.
+        child.unref();
+        this.child = child;
+        this.buffer = "";
+        return child;
+    }
+    /**
+     * Run one command in the session shell. Serialized by the tool's sequential
+     * execution mode; a concurrent call while busy is rejected defensively.
+     * On timeout or abort the whole session is killed (state is gone — the next
+     * call starts a fresh shell) because a wedged command cannot be safely
+     * skipped within the same shell.
+     */
+    run(command, timeoutMs, signal, onChunk) {
+        if (this.busy) {
+            return Promise.resolve({
+                exitCode: 1,
+                output: "persistent shell is busy with a previous command",
+            });
+        }
+        this.busy = true;
+        const child = this.ensureChild();
+        const sentinel = `__GG_PSH_${randomUUID()}__`;
+        // `</dev/null` keeps stdin-reading commands (cat, read) from eating the
+        // next sentinel line instead of hanging the session.
+        const wrapped = `{ ${command}\n} </dev/null; echo "${sentinel}$?"\n`;
+        return new Promise((resolve) => {
+            let out = "";
+            let capped = false;
+            let done = false;
+            const finish = (result) => {
+                if (done)
+                    return;
+                done = true;
+                child.stdout?.off("data", onData);
+                child.stderr?.off("data", onData);
+                child.off("exit", onExit);
+                child.off("error", onError);
+                clearTimeout(timer);
+                signal.removeEventListener("abort", onAbort);
+                this.busy = false;
+                resolve(result);
+            };
+            // When output is capped we stop growing `out` but MUST keep scanning for
+            // the sentinel — otherwise an over-cap command hangs until timeout and
+            // needlessly destroys the session. `scanTail` keeps a small rolling
+            // window across chunk boundaries so a split sentinel is still found.
+            let scanTail = "";
+            const checkSentinel = (scan, fromCapped) => {
+                const idx = scan.indexOf(sentinel);
+                if (idx === -1)
+                    return;
+                const code = parseInt(scan.slice(idx + sentinel.length), 10);
+                const body = fromCapped ? out : scan.slice(0, idx);
+                finish({
+                    exitCode: Number.isNaN(code) ? 1 : code,
+                    output: body.replace(/\n$/, "") +
+                        (fromCapped ? `\n[Output capped at ${this.maxOutputBytes} bytes]` : ""),
+                });
+            };
+            const onData = (d) => {
+                const text = d.toString("utf-8");
+                if (capped) {
+                    scanTail = (scanTail + text).slice(-(sentinel.length + 16));
+                    checkSentinel(scanTail, true);
+                    return;
+                }
+                out += text;
+                if (out.length > this.maxOutputBytes) {
+                    capped = true;
+                    scanTail = out.slice(-(sentinel.length + 16));
+                    out = out.slice(0, this.maxOutputBytes);
+                }
+                onChunk?.(text);
+                checkSentinel(capped ? scanTail : out, capped);
+            };
+            const timer = setTimeout(() => {
+                this.kill();
+                finish({ exitCode: "TIMEOUT", output: out });
+            }, timeoutMs);
+            const onAbort = () => {
+                this.kill();
+                finish({ exitCode: 1, output: out });
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+            // `exit N` (or a crash) ends the session shell itself — the sentinel
+            // never prints, so settle from the shell's own exit code. The next run()
+            // starts a fresh session.
+            const onExit = (code) => {
+                this.child = null;
+                finish({ exitCode: code ?? 1, output: out.replace(/\n$/, "") });
+            };
+            child.on("exit", onExit);
+            const onError = () => finish({ exitCode: 1, output: "failed to spawn session bash" });
+            child.on("error", onError);
+            child.stdout?.on("data", onData);
+            child.stderr?.on("data", onData);
+            child.stdin?.write(wrapped);
+        });
+    }
+    /** Kill the session shell; the next run() starts a fresh one. */
+    kill() {
+        if (this.child?.pid)
+            killProcessTree(this.child.pid);
+        this.child = null;
+        this.busy = false;
+    }
+}
+//# sourceMappingURL=persistent-shell.js.map

package/dist/core/persistent-shell.js.map

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

package/dist/core/persistent-shell.test.d.ts

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

package/dist/core/persistent-shell.test.d.ts.map

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