santree 0.1.2 → 0.1.4

package/README.md

@@ -110,6 +110,7 @@ With the `stw` alias: `stw create`, `stw list`, `stw switch`, `stw work`, `stw c
 | Command | Description |
 |---------|-------------|
 | `santree linear auth` | Authenticate with Linear (OAuth) |
+| `santree linear switch` | Switch Linear workspace for this repo |
 | `santree linear open` | Open the current Linear ticket in the browser |
 
 ### Helpers (`santree helpers`)

package/dist/commands/helpers/template.d.ts

@@ -4,6 +4,8 @@ export declare const args: z.ZodTuple<[z.ZodEnum<{
     linear: "linear";
     "git-changes": "git-changes";
     pr: "pr";
+    "fix-pr": "fix-pr";
+    review: "review";
 }>], null>;
 type Props = {
     args: z.infer<typeof args>;

package/dist/commands/helpers/template.js

@@ -7,12 +7,13 @@ import { z } from "zod/v4";
 import { findRepoRoot, findMainRepoRoot, getCurrentBranch, extractTicketId, } from "../../lib/git.js";
 import { renderTicket } from "../../lib/prompts.js";
 import { getTicketContent } from "../../lib/linear.js";
-import { fetchAndRenderPR, fetchAndRenderDiff } from "../../lib/ai.js";
+import { resolveAIContext, renderAIPrompt, fetchAndRenderPR, fetchAndRenderDiff, } from "../../lib/ai.js";
 export const description = "Render a template to stdout";
 export const args = z.tuple([
-    z
-        .enum(["linear", "git-changes", "pr"])
-        .describe(argument({ name: "type", description: "Template type (linear, git-changes, or pr)" })),
+    z.enum(["linear", "git-changes", "pr", "fix-pr", "review"]).describe(argument({
+        name: "type",
+        description: "Template type (linear, git-changes, pr, fix-pr, or review)",
+    })),
 ]);
 export default function Template({ args }) {
     const [type] = args;
@@ -41,13 +42,13 @@ export default function Template({ args }) {
                 return;
             }
             if (type === "git-changes") {
-                const output = fetchAndRenderDiff(branch);
+                const output = await fetchAndRenderDiff(branch);
                 process.stdout.write(output);
                 setStatus("done");
                 setTimeout(() => exit(), 100);
             }
             else if (type === "pr") {
-                const output = fetchAndRenderPR(branch);
+                const output = await fetchAndRenderPR(branch);
                 if (!output) {
                     setStatus("error");
                     setMessage(`No pull request found for branch '${branch}'`);
@@ -58,6 +59,39 @@ export default function Template({ args }) {
                 setStatus("done");
                 setTimeout(() => exit(), 100);
             }
+            else if (type === "fix-pr" || type === "review") {
+                const result = await resolveAIContext();
+                if (!result.ok) {
+                    setStatus("error");
+                    setMessage(result.error);
+                    setTimeout(() => exit(), 100);
+                    return;
+                }
+                const ctx = result.context;
+                const diffContent = await fetchAndRenderDiff(branch);
+                if (type === "fix-pr") {
+                    const prFeedback = await fetchAndRenderPR(branch);
+                    if (!prFeedback) {
+                        setStatus("error");
+                        setMessage(`No pull request found for branch '${branch}'`);
+                        setTimeout(() => exit(), 100);
+                        return;
+                    }
+                    const output = renderAIPrompt("fix-pr", ctx, {
+                        pr_feedback: prFeedback,
+                        diff_content: diffContent,
+                    });
+                    process.stdout.write(output);
+                }
+                else {
+                    const output = renderAIPrompt("review", ctx, {
+                        diff_content: diffContent,
+                    });
+                    process.stdout.write(output);
+                }
+                setStatus("done");
+                setTimeout(() => exit(), 100);
+            }
             else {
                 const ticketId = extractTicketId(branch);
                 if (!ticketId) {
@@ -83,10 +117,13 @@ export default function Template({ args }) {
     }, [type]);
     if (status === "done")
         return null;
-    const spinnerText = type === "linear"
-        ? "Fetching Linear ticket..."
-        : type === "pr"
-            ? "Fetching PR feedback..."
-            : "Gathering changes...";
+    const spinnerTexts = {
+        linear: "Fetching Linear ticket...",
+        "git-changes": "Gathering changes...",
+        pr: "Fetching PR feedback...",
+        "fix-pr": "Building fix-pr prompt...",
+        review: "Building review prompt...",
+    };
+    const spinnerText = spinnerTexts[type] ?? "Loading...";
     return (_jsxs(Box, { children: [status === "loading" && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", spinnerText] })] })), status === "error" && (_jsx(Text, { color: "red", bold: true, children: message }))] }));
 }

package/dist/commands/linear/switch.d.ts

@@ -0,0 +1,2 @@
+export declare const description = "Switch Linear workspace for this repo";
+export default function LinearSwitch(): import("react/jsx-runtime").JSX.Element;

package/dist/commands/linear/switch.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Text, Box, useInput } from "ink";
+import Spinner from "ink-spinner";
+import { findMainRepoRoot, setRepoLinearOrg, getRepoLinearOrg } from "../../lib/git.js";
+import { readAuthStore } from "../../lib/linear.js";
+export const description = "Switch Linear workspace for this repo";
+export default function LinearSwitch() {
+    const [status, setStatus] = useState("checking");
+    const [message, setMessage] = useState("");
+    const [error, setError] = useState(null);
+    const [choices, setChoices] = useState([]);
+    const [selected, setSelected] = useState(0);
+    const [currentOrg, setCurrentOrg] = useState(null);
+    useInput((input, key) => {
+        if (status !== "choosing")
+            return;
+        if (key.upArrow) {
+            setSelected((s) => Math.max(0, s - 1));
+        }
+        else if (key.downArrow) {
+            setSelected((s) => Math.min(choices.length - 1, s + 1));
+        }
+        else if (key.return) {
+            const choice = choices[selected];
+            const repoRoot = findMainRepoRoot();
+            setRepoLinearOrg(repoRoot, choice.slug);
+            setMessage(`Switched to ${choice.name} (${choice.slug})`);
+            setStatus("done");
+        }
+    });
+    useEffect(() => {
+        async function run() {
+            await new Promise((r) => setTimeout(r, 100));
+            const repoRoot = findMainRepoRoot();
+            if (!repoRoot) {
+                setError("Not inside a git repository");
+                setStatus("error");
+                return;
+            }
+            const store = readAuthStore();
+            const orgs = Object.entries(store).map(([slug, tokens]) => ({
+                slug,
+                name: tokens.org_name,
+            }));
+            if (orgs.length === 0) {
+                setError("No authenticated workspaces. Run: santree linear auth");
+                setStatus("error");
+                return;
+            }
+            if (orgs.length === 1) {
+                const org = orgs[0];
+                setRepoLinearOrg(repoRoot, org.slug);
+                setMessage(`Linked to ${org.name} (${org.slug})`);
+                setStatus("done");
+                return;
+            }
+            setCurrentOrg(getRepoLinearOrg(repoRoot));
+            setChoices(orgs);
+            setStatus("choosing");
+        }
+        run();
+    }, []);
+    useEffect(() => {
+        if (status === "done" || status === "error") {
+            const timer = setTimeout(() => process.exit(status === "error" ? 1 : 0), 100);
+            return () => clearTimeout(timer);
+        }
+    }, [status]);
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Linear Switch" }) }), status === "checking" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Checking..." })] })), status === "choosing" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Select a workspace to link to this repo:" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: choices.map((org, i) => (_jsxs(Text, { children: [i === selected ? (_jsx(Text, { color: "cyan", bold: true, children: "> " })) : (_jsx(Text, { children: "  " })), org.name, " (", org.slug, ")", org.slug === currentOrg && _jsx(Text, { dimColor: true, children: " (current)" })] }, org.slug))) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u2191/\u2193 to select, Enter to confirm" }) })] })), status === "done" && _jsxs(Text, { color: "green", children: ["\u2713 ", message] }), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] }));
+}

package/dist/commands/pr/create.js

@@ -3,7 +3,7 @@ import { useEffect, useState } from "react";
 import { Text, Box, useInput, useApp } from "ink";
 import Spinner from "ink-spinner";
 import { z } from "zod";
-import { exec, spawnSync } from "child_process";
+import { exec } from "child_process";
 import { promisify } from "util";
 import { join } from "path";
 import { writeFileSync } from "fs";
@@ -11,6 +11,7 @@ import { tmpdir } from "os";
 import { findMainRepoRoot, findRepoRoot, getCurrentBranch, getBaseBranch, hasUncommittedChanges, getCommitsAhead, remoteBranchExists, getUnpushedCommits, extractTicketId, isInWorktree, getFirstCommitMessage, getCommitLog, getDiffStat, getDiffContent, } from "../../lib/git.js";
 import { ghCliAvailable, getPRInfoAsync, pushBranch, createPR, getPRTemplate, } from "../../lib/github.js";
 import { renderPrompt, renderDiff } from "../../lib/prompts.js";
+import { runAgent } from "../../lib/ai.js";
 const execAsync = promisify(exec);
 export const description = "Create a GitHub pull request";
 export const options = z.object({
@@ -72,17 +73,14 @@ export default function PR({ options }) {
                 ticket_id: ticketId ?? "",
                 branch_name: branch,
             });
-            const result = spawnSync("happy", ["-p", prompt, "--output-format", "text"], {
-                encoding: "utf-8",
-                maxBuffer: 10 * 1024 * 1024,
-            });
-            if (result.status !== 0) {
+            const result = runAgent(prompt);
+            if (!result.success) {
                 setStatus("error");
                 setMessage("Failed to generate PR body with Claude");
                 setTimeout(() => exit(), 100);
                 return;
             }
-            const body = result.stdout.trim();
+            const body = result.output;
             bodyFile = join(tmpdir(), `santree-pr-${Date.now()}.md`);
             writeFileSync(bodyFile, body);
         }

package/dist/commands/pr/fix.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { Text, Box } from "ink";
 import Spinner from "ink-spinner";
-import { resolveAIContext, renderAIPrompt, launchHappy, cleanupImages, fetchAndRenderPR, fetchAndRenderDiff, } from "../../lib/ai.js";
+import { resolveAIContext, renderAIPrompt, launchAgent, cleanupImages, fetchAndRenderPR, fetchAndRenderDiff, } from "../../lib/ai.js";
 export const description = "Fix PR review comments";
 export default function Fix() {
     const [status, setStatus] = useState("loading");
@@ -22,28 +22,35 @@ export default function Fix() {
             const ctx = result.context;
             setBranch(ctx.branch);
             setTicketId(ctx.ticketId);
-            const prFeedback = fetchAndRenderPR(ctx.branch);
+            const prFeedback = await fetchAndRenderPR(ctx.branch);
             if (!prFeedback) {
                 setStatus("error");
                 setError(`No pull request found for branch '${ctx.branch}'`);
                 return;
             }
-            const diffContent = fetchAndRenderDiff(ctx.branch);
+            const diffContent = await fetchAndRenderDiff(ctx.branch);
             setStatus("launching");
             const prompt = renderAIPrompt("fix-pr", ctx, {
                 pr_feedback: prFeedback,
                 diff_content: diffContent,
             });
-            const child = launchHappy(prompt);
-            child.on("error", (err) => {
+            try {
+                const child = launchAgent(prompt);
+                child.on("error", (err) => {
+                    setStatus("error");
+                    setError(`Failed to launch agent: ${err.message}`);
+                });
+                child.on("close", () => {
+                    if (ctx.ticketId)
+                        cleanupImages(ctx.ticketId);
+                    process.exit(0);
+                });
+            }
+            catch (err) {
                 setStatus("error");
-                setError(`Failed to launch happy: ${err.message}`);
-            });
-            child.on("close", () => {
-                if (ctx.ticketId)
-                    cleanupImages(ctx.ticketId);
-                process.exit(0);
-            });
+                setError(err instanceof Error ? err.message : "Failed to launch agent");
+                return;
+            }
         }
         init();
     }, []);

package/dist/commands/pr/review.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { Text, Box } from "ink";
 import Spinner from "ink-spinner";
-import { resolveAIContext, renderAIPrompt, launchHappy, cleanupImages, fetchAndRenderDiff, } from "../../lib/ai.js";
+import { resolveAIContext, renderAIPrompt, launchAgent, cleanupImages, fetchAndRenderDiff, } from "../../lib/ai.js";
 export const description = "Review changes against ticket requirements";
 export default function Review() {
     const [status, setStatus] = useState("loading");
@@ -22,21 +22,28 @@ export default function Review() {
             const ctx = result.context;
             setBranch(ctx.branch);
             setTicketId(ctx.ticketId);
-            const diffContent = fetchAndRenderDiff(ctx.branch);
+            const diffContent = await fetchAndRenderDiff(ctx.branch);
             setStatus("launching");
             const prompt = renderAIPrompt("review", ctx, {
                 diff_content: diffContent,
             });
-            const child = launchHappy(prompt);
-            child.on("error", (err) => {
+            try {
+                const child = launchAgent(prompt);
+                child.on("error", (err) => {
+                    setStatus("error");
+                    setError(`Failed to launch agent: ${err.message}`);
+                });
+                child.on("close", () => {
+                    if (ctx.ticketId)
+                        cleanupImages(ctx.ticketId);
+                    process.exit(0);
+                });
+            }
+            catch (err) {
                 setStatus("error");
-                setError(`Failed to launch happy: ${err.message}`);
-            });
-            child.on("close", () => {
-                if (ctx.ticketId)
-                    cleanupImages(ctx.ticketId);
-                process.exit(0);
-            });
+                setError(err instanceof Error ? err.message : "Failed to launch agent");
+                return;
+            }
         }
         init();
     }, []);

package/dist/commands/worktree/remove.d.ts

@@ -1,10 +1,12 @@
 import { z } from "zod";
 export declare const description = "Remove a worktree and its branch";
-export declare const options: z.ZodObject<{}, z.core.$strip>;
+export declare const options: z.ZodObject<{
+    force: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 export declare const args: z.ZodTuple<[z.ZodString], null>;
 type Props = {
     options: z.infer<typeof options>;
     args: z.infer<typeof args>;
 };
-export default function Remove({ args }: Props): import("react/jsx-runtime").JSX.Element;
+export default function Remove({ args, options }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/commands/worktree/remove.js

@@ -1,40 +1,81 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
-import { Text, Box } from "ink";
+import { Text, Box, useInput, useApp } from "ink";
 import Spinner from "ink-spinner";
 import { z } from "zod";
 import { removeWorktree, findMainRepoRoot } from "../../lib/git.js";
 export const description = "Remove a worktree and its branch";
-export const options = z.object({});
+export const options = z.object({
+    force: z.boolean().optional().describe("Skip confirmation prompt"),
+});
 export const args = z.tuple([z.string().describe("Branch name to remove")]);
-export default function Remove({ args }) {
+export default function Remove({ args, options }) {
     const [branchName] = args;
-    const [status, setStatus] = useState("idle");
+    const { exit } = useApp();
+    const [status, setStatus] = useState("checking");
     const [message, setMessage] = useState("");
+    const [repoRoot, setRepoRoot] = useState(null);
+    useInput((input) => {
+        if (status !== "confirming")
+            return;
+        if (input === "y" || input === "Y") {
+            doRemove();
+        }
+        else if (input === "n" || input === "N" || input === "\x03") {
+            setStatus("cancelled");
+            setMessage("Cancelled");
+            setTimeout(() => exit(), 100);
+        }
+    });
+    async function doRemove() {
+        if (!repoRoot)
+            return;
+        setStatus("removing");
+        setMessage(`Removing worktree ${branchName}...`);
+        const result = await removeWorktree(branchName, repoRoot, true);
+        if (result.success) {
+            setStatus("done");
+            setMessage(`Removed worktree and branch: ${branchName}`);
+        }
+        else {
+            setStatus("error");
+            setMessage(result.error ?? "Unknown error");
+        }
+    }
     useEffect(() => {
         async function run() {
-            // Small delay to allow spinner to render
             await new Promise((r) => setTimeout(r, 100));
-            const repoRoot = findMainRepoRoot();
-            if (!repoRoot) {
+            const root = findMainRepoRoot();
+            if (!root) {
                 setStatus("error");
                 setMessage("Not inside a git repository");
                 return;
             }
-            setStatus("removing");
-            setMessage(`Removing worktree ${branchName}...`);
-            const result = await removeWorktree(branchName, repoRoot, true);
-            if (result.success) {
-                setStatus("done");
-                setMessage(`Removed worktree and branch: ${branchName}`);
-            }
-            else {
-                setStatus("error");
-                setMessage(result.error ?? "Unknown error");
+            setRepoRoot(root);
+            if (options.force) {
+                setStatus("removing");
+                setMessage(`Removing worktree ${branchName}...`);
+                const result = await removeWorktree(branchName, root, true);
+                if (result.success) {
+                    setStatus("done");
+                    setMessage(`Removed worktree and branch: ${branchName}`);
+                }
+                else {
+                    setStatus("error");
+                    setMessage(result.error ?? "Unknown error");
+                }
+                return;
             }
+            setStatus("confirming");
         }
         run();
     }, [branchName]);
-    const isLoading = status === "idle" || status === "removing";
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83D\uDDD1\uFE0F Remove" }) }), _jsx(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : status === "done" ? "green" : "yellow", paddingX: 1, width: "100%", children: _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "red", bold: true, children: branchName })] }) }), _jsxs(Box, { marginTop: 1, children: [isLoading && (_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", message || "Removing..."] })] })), status === "done" && (_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] })] }));
+    useEffect(() => {
+        if (status === "done" || status === "error") {
+            const timer = setTimeout(() => process.exit(status === "error" ? 1 : 0), 100);
+            return () => clearTimeout(timer);
+        }
+    }, [status]);
+    const isLoading = status === "checking" || status === "removing";
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83D\uDDD1\uFE0F Remove" }) }), _jsx(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : status === "done" ? "green" : "yellow", paddingX: 1, width: "100%", children: _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "red", bold: true, children: branchName })] }) }), _jsxs(Box, { marginTop: 1, children: [isLoading && (_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", message || "Removing..."] })] })), status === "confirming" && (_jsxs(Text, { bold: true, color: "yellow", children: ["Remove this worktree and delete the branch? [y/N]:", " "] })), status === "done" && (_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] })), status === "cancelled" && _jsxs(Text, { color: "yellow", children: ["\u2717 ", message] }), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] })] }));
 }

package/dist/commands/worktree/work.js

@@ -3,7 +3,7 @@ import { useEffect, useState } from "react";
 import { Text, Box } from "ink";
 import Spinner from "ink-spinner";
 import { z } from "zod";
-import { resolveAIContext, renderAIPrompt, launchHappy, cleanupImages, } from "../../lib/ai.js";
+import { resolveAIContext, renderAIPrompt, launchAgent, cleanupImages, } from "../../lib/ai.js";
 export const description = "Launch Claude to work on current ticket";
 export const options = z.object({
     plan: z.boolean().optional().describe("Only create implementation plan"),
@@ -45,16 +45,22 @@ export default function Work({ options }) {
             return;
         setStatus("launching");
         const prompt = renderAIPrompt("work", aiContext, { mode });
-        const child = launchHappy(prompt, { planMode: mode === "plan" });
-        child.on("error", (err) => {
+        try {
+            const child = launchAgent(prompt, { planMode: mode === "plan" });
+            child.on("error", (err) => {
+                setStatus("error");
+                setError(`Failed to launch agent: ${err.message}`);
+            });
+            child.on("close", () => {
+                if (aiContext.ticketId)
+                    cleanupImages(aiContext.ticketId);
+                process.exit(0);
+            });
+        }
+        catch (err) {
             setStatus("error");
-            setError(`Failed to launch happy: ${err.message}`);
-        });
-        child.on("close", () => {
-            if (aiContext.ticketId)
-                cleanupImages(aiContext.ticketId);
-            process.exit(0);
-        });
+            setError(err instanceof Error ? err.message : "Failed to launch agent");
+        }
     }, [status, aiContext, mode]);
     return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Work" }) }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : getModeColor(mode), paddingX: 1, width: "100%", children: [branch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branch })] })), ticketId && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "ticket:" }), _jsx(Text, { color: "blue", bold: true, children: ticketId })] })), _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "mode:" }), _jsx(Text, { backgroundColor: getModeColor(mode), color: "white", bold: true, children: ` ${getModeLabel(mode)} ` })] })] }), _jsxs(Box, { marginTop: 1, children: [status === "loading" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Loading..." })] })), status === "fetching" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Fetching ticket from Linear..." })] })), status === "launching" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude (through Happy)..." }), _jsxs(Text, { dimColor: true, children: [" ", "happy", mode === "plan" ? " --permission-mode plan" : "", " ", `"<${getModeLabel(mode)} prompt for ${ticketId}>"`] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] })] }));
 }

package/dist/lib/ai.d.ts

@@ -27,22 +27,35 @@ export declare function buildPromptContext(ctx: AIContext, extra?: Record<string
  */
 export declare function renderAIPrompt(template: string, ctx: AIContext, extra?: Record<string, string | undefined>): string;
 /**
- * Fetch and render PR feedback for a branch.
+ * Fetch and render PR feedback for a branch (async, non-blocking).
  * Returns rendered markdown or null if no PR exists.
  */
-export declare function fetchAndRenderPR(branch: string): string | null;
+export declare function fetchAndRenderPR(branch: string): Promise<string | null>;
 /**
- * Fetch and render diff for a branch against its base branch.
+ * Fetch and render diff for a branch against its base branch (async, non-blocking).
  * Returns rendered markdown.
  */
-export declare function fetchAndRenderDiff(branch: string): string;
+export declare function fetchAndRenderDiff(branch: string): Promise<string>;
 /**
- * Spawns `happy` CLI with a rendered prompt.
- * Returns the child process so callers can listen for close/error.
+ * Launch an interactive agent session with a prompt.
+ * Resolves the agent binary (happy > claude), passes prompt directly
+ * or via temp file if too large for OS arg limit.
+ * Throws if no agent binary is found.
  */
-export declare function launchHappy(prompt: string, opts?: {
+export declare function launchAgent(prompt: string, opts?: {
     planMode?: boolean;
 }): ChildProcess;
+export interface RunAgentResult {
+    success: boolean;
+    output: string;
+}
+/**
+ * Run an agent in non-interactive print mode and capture output.
+ * Resolves the agent binary (happy > claude), passes prompt directly
+ * or via temp file if too large for OS arg limit.
+ * Throws if no agent binary is found.
+ */
+export declare function runAgent(prompt: string): RunAgentResult;
 /**
  * Cleanup images downloaded for a ticket.
  */

package/dist/lib/ai.js

@@ -1,8 +1,12 @@
-import { spawn } from "child_process";
-import { getCurrentBranch, extractTicketId, findRepoRoot, findMainRepoRoot, getBaseBranch, getCommitLog, getDiffStat, getDiffContent, } from "./git.js";
+import { execSync, spawn, spawnSync } from "child_process";
+import { writeFileSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+import { getCurrentBranch, extractTicketId, findRepoRoot, findMainRepoRoot, getBaseBranch, } from "./git.js";
 import { renderPrompt, renderTicket, renderDiff, renderPR } from "./prompts.js";
 import { getTicketContent, cleanupImages } from "./linear.js";
-import { getPRInfo, getPRChecks, getPRReviews, getPRReviewComments, getPRConversationComments, getFailedCheckDetails, } from "./github.js";
+import { getPRInfoAsync, getPRChecksAsync, getPRReviewsAsync, getPRReviewCommentsAsync, getPRConversationCommentsAsync, getFailedCheckDetailsAsync, } from "./github.js";
+import { runAsync } from "./exec.js";
 /**
  * Resolves repo, branch, ticket ID, and fetches the Linear ticket.
  * Returns an error string if any required context is missing.
@@ -56,20 +60,20 @@ const BOT_AUTHORS = new Set([
     "vercel",
 ]);
 /**
- * Fetch and render PR feedback for a branch.
+ * Fetch and render PR feedback for a branch (async, non-blocking).
  * Returns rendered markdown or null if no PR exists.
  */
-export function fetchAndRenderPR(branch) {
-    const prInfo = getPRInfo(branch);
+export async function fetchAndRenderPR(branch) {
+    const prInfo = await getPRInfoAsync(branch);
     if (!prInfo)
         return null;
-    const checks = getPRChecks(prInfo.number);
-    const failedChecks = (checks ?? [])
-        .filter((c) => c.bucket === "fail")
-        .map((c) => getFailedCheckDetails(c));
-    const reviews = getPRReviews(prInfo.number);
-    const reviewComments = getPRReviewComments(prInfo.number);
-    const allComments = getPRConversationComments(prInfo.number);
+    const [checks, reviews, reviewComments, allComments] = await Promise.all([
+        getPRChecksAsync(prInfo.number),
+        getPRReviewsAsync(prInfo.number),
+        getPRReviewCommentsAsync(prInfo.number),
+        getPRConversationCommentsAsync(prInfo.number),
+    ]);
+    const failedChecks = await Promise.all((checks ?? []).filter((c) => c.bucket === "fail").map((c) => getFailedCheckDetailsAsync(c)));
     const conversationComments = (allComments ?? []).filter((c) => !BOT_AUTHORS.has(c.author) && !c.author.endsWith("[bot]"));
     return renderPR({
         pr_number: prInfo.number,
@@ -83,29 +87,91 @@ export function fetchAndRenderPR(branch) {
     });
 }
 /**
- * Fetch and render diff for a branch against its base branch.
+ * Fetch and render diff for a branch against its base branch (async, non-blocking).
  * Returns rendered markdown.
  */
-export function fetchAndRenderDiff(branch) {
+export async function fetchAndRenderDiff(branch) {
     const baseBranch = getBaseBranch(branch);
+    const [commitLog, diffStat, diff] = await Promise.all([
+        runAsync(`git log ${baseBranch}..HEAD --format="- %s"`).then((v) => v || null),
+        runAsync(`git diff ${baseBranch}..HEAD --stat`).then((v) => v || null),
+        runAsync(`git diff ${baseBranch}..HEAD`, { maxBuffer: 10 * 1024 * 1024 }).then((v) => v || null),
+    ]);
     return renderDiff({
         base_branch: baseBranch,
-        commit_log: getCommitLog(baseBranch),
-        diff_stat: getDiffStat(baseBranch),
-        diff: getDiffContent(baseBranch),
+        commit_log: commitLog,
+        diff_stat: diffStat,
+        diff,
     });
 }
 /**
- * Spawns `happy` CLI with a rendered prompt.
- * Returns the child process so callers can listen for close/error.
+ * Resolve which agent binary to use (happy or claude).
+ * Returns the binary name, or null if neither is installed.
  */
-export function launchHappy(prompt, opts) {
+function resolveAgentBinary() {
+    for (const bin of ["happy", "claude"]) {
+        try {
+            execSync(`which ${bin}`, { stdio: "ignore" });
+            return bin;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+// Conservative limit: 200KB leaves room for env vars within macOS 256KB ARG_MAX
+const ARG_MAX_SAFE = 200 * 1024;
+/**
+ * Build the prompt argument for the agent.
+ * If the prompt fits in ARG_MAX, returns it directly.
+ * Otherwise, writes to a temp file and returns a short instruction to read it.
+ */
+function promptArg(prompt) {
+    if (Buffer.byteLength(prompt) <= ARG_MAX_SAFE) {
+        return prompt;
+    }
+    const filePath = join(tmpdir(), `santree-prompt-${Date.now()}.md`);
+    writeFileSync(filePath, prompt);
+    return `Read ${filePath} and follow the instructions inside.`;
+}
+/**
+ * Launch an interactive agent session with a prompt.
+ * Resolves the agent binary (happy > claude), passes prompt directly
+ * or via temp file if too large for OS arg limit.
+ * Throws if no agent binary is found.
+ */
+export function launchAgent(prompt, opts) {
+    const bin = resolveAgentBinary();
+    if (!bin) {
+        throw new Error("No agent found. Install happy (npm i -g happy-coder) or claude (npm i -g @anthropic-ai/claude-code).");
+    }
     const args = [];
     if (opts?.planMode) {
         args.push("--permission-mode", "plan");
     }
-    args.push(prompt);
-    return spawn("happy", args, { stdio: "inherit" });
+    args.push("--", promptArg(prompt));
+    return spawn(bin, args, { stdio: "inherit" });
+}
+/**
+ * Run an agent in non-interactive print mode and capture output.
+ * Resolves the agent binary (happy > claude), passes prompt directly
+ * or via temp file if too large for OS arg limit.
+ * Throws if no agent binary is found.
+ */
+export function runAgent(prompt) {
+    const bin = resolveAgentBinary();
+    if (!bin) {
+        throw new Error("No agent found. Install happy (npm i -g happy-coder) or claude (npm i -g @anthropic-ai/claude-code).");
+    }
+    const result = spawnSync(bin, ["-p", "--output-format", "text", "--", promptArg(prompt)], {
+        encoding: "utf-8",
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    return {
+        success: result.status === 0,
+        output: result.stdout?.trim() ?? "",
+    };
 }
 /**
  * Cleanup images downloaded for a ticket.

package/dist/lib/exec.d.ts

@@ -5,6 +5,13 @@ export declare function run(command: string, options?: {
     cwd?: string;
     maxBuffer?: number;
 }): string | null;
+/**
+ * Run a shell command asynchronously and return trimmed stdout, or null on failure.
+ */
+export declare function runAsync(command: string, options?: {
+    cwd?: string;
+    maxBuffer?: number;
+}): Promise<string | null>;
 /**
  * Spawn a command asynchronously and capture its output.
  * Returns the exit code and combined stdout/stderr.

package/dist/lib/exec.js

@@ -1,4 +1,6 @@
-import { execSync, spawn } from "child_process";
+import { execSync, exec, spawn } from "child_process";
+import { promisify } from "util";
+const execPromise = promisify(exec);
 /**
  * Run a shell command and return trimmed stdout, or null on failure.
  */
@@ -10,6 +12,18 @@ export function run(command, options) {
         return null;
     }
 }
+/**
+ * Run a shell command asynchronously and return trimmed stdout, or null on failure.
+ */
+export async function runAsync(command, options) {
+    try {
+        const { stdout } = await execPromise(command, { encoding: "utf-8", ...options });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Spawn a command asynchronously and capture its output.
  * Returns the exit code and combined stdout/stderr.

package/dist/lib/github.d.ts

@@ -4,13 +4,7 @@ export interface PRInfo {
     url?: string;
 }
 /**
- * Get PR info (number, state, url) for a branch using the GitHub CLI.
- * Runs: `gh pr view "<branchName>" --json number,state,url`
- * Returns null if no PR exists for the branch or gh CLI fails.
- */
-export declare function getPRInfo(branchName: string): PRInfo | null;
-/**
- * Async version of getPRInfo. Get PR info for a branch using the GitHub CLI.
+ * Get PR info for a branch using the GitHub CLI (async).
  * Runs: `gh pr view "<branchName>" --json number,state,url`
  * Returns null if no PR exists for the branch or gh CLI fails.
  */
@@ -42,22 +36,30 @@ export declare function createPR(title: string, baseBranch: string, headBranch:
  */
 export declare function getPRTemplate(): string | null;
 /**
- * Fetch all comments on a pull request.
- * Runs: `gh pr view <prNumber> --json comments --jq '.comments[] | "- \(.author.login): \(.body)"'`
- * Returns empty string if the PR has no comments or on failure.
+ * Fetch CI check results for a pull request (async).
+ */
+export declare function getPRChecksAsync(prNumber: string): Promise<PRCheck[] | null>;
+/**
+ * Fetch reviews for a pull request (async).
+ */
+export declare function getPRReviewsAsync(prNumber: string): Promise<PRReview[] | null>;
+/**
+ * Fetch inline review comments for a pull request via the GitHub API (async).
+ */
+export declare function getPRReviewCommentsAsync(prNumber: string): Promise<PRReviewComment[] | null>;
+/**
+ * Fetch structured conversation comments on a pull request (async).
+ */
+export declare function getPRConversationCommentsAsync(prNumber: string): Promise<PRConversationComment[] | null>;
+/**
+ * Fetch details for a failed CI check (async): which step failed and the failed step's log.
  */
-export declare function getPRComments(prNumber: string): string;
+export declare function getFailedCheckDetailsAsync(check: PRCheck): Promise<FailedCheckDetail>;
 export interface PRConversationComment {
     author: string;
     body: string;
     createdAt: string;
 }
-/**
- * Fetch structured conversation comments on a pull request.
- * Runs: `gh pr view <prNumber> --json comments`
- * Returns null if gh CLI fails.
- */
-export declare function getPRConversationComments(prNumber: string): PRConversationComment[] | null;
 export interface PRCheck {
     name: string;
     state: string;
@@ -74,13 +76,6 @@ export interface FailedCheckDetail {
     failed_step: string | null;
     log: string | null;
 }
-/**
- * Fetch details for a failed CI check: which step failed and the failed step's log.
- * Extracts job ID from the check link, fetches job details for the step name,
- * then fetches the job log via the GitHub API and extracts the failed step's output.
- * Returns enriched detail; gracefully degrades if API calls fail.
- */
-export declare function getFailedCheckDetails(check: PRCheck): FailedCheckDetail;
 export interface PRReview {
     author: {
         login: string;
@@ -102,21 +97,3 @@ export interface PRReviewComment {
     in_reply_to_id?: number;
     id: number;
 }
-/**
- * Fetch CI check results for a pull request.
- * Runs: `gh pr checks <prNumber> --json name,state,bucket,link,description,workflow`
- * Returns null if gh CLI fails.
- */
-export declare function getPRChecks(prNumber: string): PRCheck[] | null;
-/**
- * Fetch reviews for a pull request.
- * Runs: `gh pr view <prNumber> --json reviews`
- * Returns null if gh CLI fails.
- */
-export declare function getPRReviews(prNumber: string): PRReview[] | null;
-/**
- * Fetch inline review comments for a pull request via the GitHub API.
- * Runs: `gh api repos/{owner}/{repo}/pulls/<prNumber>/comments --paginate`
- * Returns null if gh CLI fails.
- */
-export declare function getPRReviewComments(prNumber: string): PRReviewComment[] | null;

package/dist/lib/github.js

@@ -1,30 +1,9 @@
 import { execSync, exec } from "child_process";
 import { promisify } from "util";
-import { run } from "./exec.js";
+import { run, runAsync } from "./exec.js";
 const execAsync = promisify(exec);
 /**
- * Get PR info (number, state, url) for a branch using the GitHub CLI.
- * Runs: `gh pr view "<branchName>" --json number,state,url`
- * Returns null if no PR exists for the branch or gh CLI fails.
- */
-export function getPRInfo(branchName) {
-    const output = run(`gh pr view "${branchName}" --json number,state,url`);
-    if (!output)
-        return null;
-    try {
-        const data = JSON.parse(output);
-        return {
-            number: String(data.number ?? ""),
-            state: data.state ?? "OPEN",
-            url: data.url,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Async version of getPRInfo. Get PR info for a branch using the GitHub CLI.
+ * Get PR info for a branch using the GitHub CLI (async).
  * Runs: `gh pr view "<branchName>" --json number,state,url`
  * Returns null if no PR exists for the branch or gh CLI fails.
  */
@@ -102,20 +81,53 @@ export function getPRTemplate() {
     return Buffer.from(output, "base64").toString("utf-8");
 }
 /**
- * Fetch all comments on a pull request.
- * Runs: `gh pr view <prNumber> --json comments --jq '.comments[] | "- \(.author.login): \(.body)"'`
- * Returns empty string if the PR has no comments or on failure.
+ * Fetch CI check results for a pull request (async).
  */
-export function getPRComments(prNumber) {
-    return (run(`gh pr view ${prNumber} --json comments --jq '.comments[] | "- \\(.author.login): \\(.body)"'`) ?? "");
+export async function getPRChecksAsync(prNumber) {
+    const output = await runAsync(`gh pr checks ${prNumber} --json name,state,bucket,link,description,workflow`);
+    if (!output)
+        return null;
+    try {
+        return JSON.parse(output);
+    }
+    catch {
+        return null;
+    }
 }
 /**
- * Fetch structured conversation comments on a pull request.
- * Runs: `gh pr view <prNumber> --json comments`
- * Returns null if gh CLI fails.
+ * Fetch reviews for a pull request (async).
  */
-export function getPRConversationComments(prNumber) {
-    const output = run(`gh pr view ${prNumber} --json comments`);
+export async function getPRReviewsAsync(prNumber) {
+    const output = await runAsync(`gh pr view ${prNumber} --json reviews`);
+    if (!output)
+        return null;
+    try {
+        const data = JSON.parse(output);
+        return data.reviews ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch inline review comments for a pull request via the GitHub API (async).
+ */
+export async function getPRReviewCommentsAsync(prNumber) {
+    const output = await runAsync(`gh api repos/{owner}/{repo}/pulls/${prNumber}/comments --paginate`);
+    if (!output)
+        return null;
+    try {
+        return JSON.parse(output);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch structured conversation comments on a pull request (async).
+ */
+export async function getPRConversationCommentsAsync(prNumber) {
+    const output = await runAsync(`gh pr view ${prNumber} --json comments`);
     if (!output)
         return null;
     try {
@@ -131,12 +143,9 @@ export function getPRConversationComments(prNumber) {
     }
 }
 /**
- * Fetch details for a failed CI check: which step failed and the failed step's log.
- * Extracts job ID from the check link, fetches job details for the step name,
- * then fetches the job log via the GitHub API and extracts the failed step's output.
- * Returns enriched detail; gracefully degrades if API calls fail.
+ * Fetch details for a failed CI check (async): which step failed and the failed step's log.
  */
-export function getFailedCheckDetails(check) {
+export async function getFailedCheckDetailsAsync(check) {
     const detail = {
         name: check.name,
         workflow: check.workflow,
@@ -151,7 +160,7 @@ export function getFailedCheckDetails(check) {
     const jobId = urlMatch[1];
     let stepStartMs = 0;
     let stepEndMs = 0;
-    const jobOutput = run(`gh api repos/{owner}/{repo}/actions/jobs/${jobId}`);
+    const jobOutput = await runAsync(`gh api repos/{owner}/{repo}/actions/jobs/${jobId}`);
     if (jobOutput) {
         try {
             const job = JSON.parse(jobOutput);
@@ -159,7 +168,6 @@ export function getFailedCheckDetails(check) {
             if (failedStep) {
                 detail.failed_step = failedStep.name;
                 stepStartMs = new Date(failedStep.started_at).getTime();
-                // Add 1s buffer — step API uses second precision but log has sub-second timestamps
                 stepEndMs = new Date(failedStep.completed_at).getTime() + 999;
             }
         }
@@ -167,11 +175,9 @@ export function getFailedCheckDetails(check) {
     }
     if (!stepStartMs)
         return detail;
-    // Fetch job log via API (works even while run is still in progress)
-    const logOutput = run(`gh api repos/{owner}/{repo}/actions/jobs/${jobId}/logs 2>/dev/null`);
+    const logOutput = await runAsync(`gh api repos/{owner}/{repo}/actions/jobs/${jobId}/logs 2>/dev/null`);
     if (logOutput) {
         const lines = logOutput.split("\n");
-        // Filter to lines within the failed step's time range
         const stepLines = lines.filter((line) => {
             const m = line.match(/^(\d{4}-\d{2}-\d{2}T[\d:.]+Z)/);
             if (!m)
@@ -179,12 +185,8 @@ export function getFailedCheckDetails(check) {
             const ms = new Date(m[1]).getTime();
             return ms >= stepStartMs && ms <= stepEndMs;
         });
-        // Truncate at ##[error] — everything after is post-run cleanup noise
         const errorIdx = stepLines.findIndex((l) => l.includes("##[error]"));
         const bounded = errorIdx !== -1 ? stepLines.slice(0, errorIdx) : stepLines;
-        // Split non-group output into segments separated by ##[group]..##[endgroup] blocks.
-        // The last segment is the actual command output, earlier segments are
-        // setup noise (checkout, env vars, etc.).
         const segments = [];
         let current = [];
         let inGroup = false;
@@ -214,52 +216,3 @@ export function getFailedCheckDetails(check) {
     }
     return detail;
 }
-/**
- * Fetch CI check results for a pull request.
- * Runs: `gh pr checks <prNumber> --json name,state,bucket,link,description,workflow`
- * Returns null if gh CLI fails.
- */
-export function getPRChecks(prNumber) {
-    const output = run(`gh pr checks ${prNumber} --json name,state,bucket,link,description,workflow`);
-    if (!output)
-        return null;
-    try {
-        return JSON.parse(output);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Fetch reviews for a pull request.
- * Runs: `gh pr view <prNumber> --json reviews`
- * Returns null if gh CLI fails.
- */
-export function getPRReviews(prNumber) {
-    const output = run(`gh pr view ${prNumber} --json reviews`);
-    if (!output)
-        return null;
-    try {
-        const data = JSON.parse(output);
-        return data.reviews ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Fetch inline review comments for a pull request via the GitHub API.
- * Runs: `gh api repos/{owner}/{repo}/pulls/<prNumber>/comments --paginate`
- * Returns null if gh CLI fails.
- */
-export function getPRReviewComments(prNumber) {
-    const output = run(`gh api repos/{owner}/{repo}/pulls/${prNumber}/comments --paginate`);
-    if (!output)
-        return null;
-    try {
-        return JSON.parse(output);
-    }
-    catch {
-        return null;
-    }
-}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "santree",
-	"version": "0.1.2",
+	"version": "0.1.4",
 	"description": "Git worktree manager",
 	"license": "MIT",
 	"author": "Santiago Toscanini",

package/prompts/fix-pr.njk

@@ -1,7 +1,9 @@
 {% if ticket_content %}
 {{ ticket_content }}
 {% else %}
-Note: Could not fetch Linear ticket {{ ticket_id }}. Proceed based on branch name context.
+Note: Could not fetch Linear ticket {{ ticket_id }} directly.
+If a Linear MCP server is available, use it to fetch the ticket description, comments, and any relevant details for {{ ticket_id }}.
+Otherwise, proceed based on branch name context.
 {% endif %}
 {% if pr_feedback %}
 {{ pr_feedback }}

package/prompts/review.njk

@@ -1,7 +1,9 @@
 {% if ticket_content %}
 {{ ticket_content }}
 {% else %}
-Note: Could not fetch Linear ticket {{ ticket_id }}. Proceed based on branch name context.
+Note: Could not fetch Linear ticket {{ ticket_id }} directly.
+If a Linear MCP server is available, use it to fetch the ticket description, comments, and any relevant details for {{ ticket_id }}.
+Otherwise, proceed based on branch name context.
 {% endif %}
 {% if diff_content %}
 {{ diff_content }}

package/prompts/work.njk

@@ -1,7 +1,9 @@
 {% if ticket_content %}
 {{ ticket_content }}
 {% else %}
-Note: Could not fetch Linear ticket {{ ticket_id }}. Proceed based on branch name context.
+Note: Could not fetch Linear ticket {{ ticket_id }} directly.
+If a Linear MCP server is available, use it to fetch the ticket description, comments, and any relevant details for {{ ticket_id }}.
+Otherwise, proceed based on branch name context.
 {% endif %}
 
 Review the codebase to understand the relevant areas and existing patterns.