santree 0.1.2 → 0.1.3

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/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/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

@@ -47,6 +47,26 @@ export declare function getPRTemplate(): string | null;
  * Returns empty string if the PR has no comments or on failure.
  */
 export declare function getPRComments(prNumber: string): string;
+/**
+ * Async version of getPRChecks.
+ */
+export declare function getPRChecksAsync(prNumber: string): Promise<PRCheck[] | null>;
+/**
+ * Async version of getPRReviews.
+ */
+export declare function getPRReviewsAsync(prNumber: string): Promise<PRReview[] | null>;
+/**
+ * Async version of getPRReviewComments.
+ */
+export declare function getPRReviewCommentsAsync(prNumber: string): Promise<PRReviewComment[] | null>;
+/**
+ * Async version of getPRConversationComments.
+ */
+export declare function getPRConversationCommentsAsync(prNumber: string): Promise<PRConversationComment[] | null>;
+/**
+ * Async version of getFailedCheckDetails.
+ */
+export declare function getFailedCheckDetailsAsync(check: PRCheck): Promise<FailedCheckDetail>;
 export interface PRConversationComment {
     author: string;
     body: string;

package/dist/lib/github.js

@@ -1,6 +1,6 @@
 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.
@@ -109,6 +109,142 @@ export function getPRTemplate() {
 export function getPRComments(prNumber) {
     return (run(`gh pr view ${prNumber} --json comments --jq '.comments[] | "- \\(.author.login): \\(.body)"'`) ?? "");
 }
+/**
+ * Async version of getPRChecks.
+ */
+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;
+    }
+}
+/**
+ * Async version of getPRReviews.
+ */
+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;
+    }
+}
+/**
+ * Async version of getPRReviewComments.
+ */
+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;
+    }
+}
+/**
+ * Async version of getPRConversationComments.
+ */
+export async function getPRConversationCommentsAsync(prNumber) {
+    const output = await runAsync(`gh pr view ${prNumber} --json comments`);
+    if (!output)
+        return null;
+    try {
+        const data = JSON.parse(output);
+        return (data.comments ?? []).map((c) => ({
+            author: c.author?.login ?? "unknown",
+            body: c.body ?? "",
+            createdAt: c.createdAt ?? "",
+        }));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Async version of getFailedCheckDetails.
+ */
+export async function getFailedCheckDetailsAsync(check) {
+    const detail = {
+        name: check.name,
+        workflow: check.workflow,
+        description: check.description,
+        link: check.link,
+        failed_step: null,
+        log: null,
+    };
+    const urlMatch = check.link?.match(/job\/(\d+)/);
+    if (!urlMatch)
+        return detail;
+    const jobId = urlMatch[1];
+    let stepStartMs = 0;
+    let stepEndMs = 0;
+    const jobOutput = await runAsync(`gh api repos/{owner}/{repo}/actions/jobs/${jobId}`);
+    if (jobOutput) {
+        try {
+            const job = JSON.parse(jobOutput);
+            const failedStep = job.steps?.find((s) => s.conclusion === "failure");
+            if (failedStep) {
+                detail.failed_step = failedStep.name;
+                stepStartMs = new Date(failedStep.started_at).getTime();
+                stepEndMs = new Date(failedStep.completed_at).getTime() + 999;
+            }
+        }
+        catch { }
+    }
+    if (!stepStartMs)
+        return detail;
+    const logOutput = await runAsync(`gh api repos/{owner}/{repo}/actions/jobs/${jobId}/logs 2>/dev/null`);
+    if (logOutput) {
+        const lines = logOutput.split("\n");
+        const stepLines = lines.filter((line) => {
+            const m = line.match(/^(\d{4}-\d{2}-\d{2}T[\d:.]+Z)/);
+            if (!m)
+                return false;
+            const ms = new Date(m[1]).getTime();
+            return ms >= stepStartMs && ms <= stepEndMs;
+        });
+        const errorIdx = stepLines.findIndex((l) => l.includes("##[error]"));
+        const bounded = errorIdx !== -1 ? stepLines.slice(0, errorIdx) : stepLines;
+        const segments = [];
+        let current = [];
+        let inGroup = false;
+        for (const raw of bounded) {
+            const line = raw.replace(/^\d{4}-\d{2}-\d{2}T[\d:.]+Z\s*/, "");
+            if (line.startsWith("##[group]")) {
+                if (current.length) {
+                    segments.push(current);
+                    current = [];
+                }
+                inGroup = true;
+                continue;
+            }
+            if (line.startsWith("##[endgroup]")) {
+                inGroup = false;
+                continue;
+            }
+            if (line.startsWith("##["))
+                continue;
+            if (!inGroup)
+                current.push(line);
+        }
+        if (current.length)
+            segments.push(current);
+        if (segments.length)
+            detail.log = segments[segments.length - 1].join("\n");
+    }
+    return detail;
+}
 /**
  * Fetch structured conversation comments on a pull request.
  * Runs: `gh pr view <prNumber> --json comments`

package/package.json

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