santree 0.5.6 → 0.6.0

package/dist/lib/ai.js

@@ -226,6 +226,36 @@ export function runAgent(prompt, opts) {
         output: result.stdout?.trim() ?? "",
     };
 }
+/**
+ * Async version of runAgent. Use this from Ink renderers — spawnSync
+ * blocks Node's event loop, freezing the UI (no spinner animation, no
+ * keystroke processing) for the entire duration of Claude's generation.
+ * spawn() lets the loop run during the call.
+ */
+export function runAgentAsync(prompt, opts) {
+    const bin = resolveAgentBinary();
+    if (!bin) {
+        return Promise.reject(new Error("Claude CLI not found. Install: npm install -g @anthropic-ai/claude-code"));
+    }
+    const toolArgs = opts?.allowedTools?.length ? ["--allowedTools", ...opts.allowedTools] : [];
+    const args = [
+        "--permission-mode",
+        "auto",
+        ...toolArgs,
+        "-p",
+        "--output-format",
+        "text",
+        "--",
+        promptArg(prompt),
+    ];
+    return new Promise((resolve) => {
+        const child = spawn(bin, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        child.stdout?.on("data", (chunk) => (stdout += chunk.toString("utf-8")));
+        child.on("error", () => resolve({ success: false, output: "" }));
+        child.on("close", (code) => resolve({ success: code === 0, output: stdout.trim() }));
+    });
+}
 /**
  * Clean up cached image downloads for an issue identifier on the active tracker.
  */
@@ -233,3 +263,26 @@ export function cleanupImages(ticketId) {
     const repoRoot = findMainRepoRoot();
     getIssueTracker(repoRoot).cleanupCache(ticketId);
 }
+/**
+ * Generate a short imperative commit message from a staged diff.
+ * Async so callers (the Ink dashboard, the CLI commit flow) keep the
+ * event loop turning during Claude's ~5–30s generation — using the sync
+ * runAgent here freezes the renderer.
+ *
+ * Returns the trimmed message string (no quotes, no preamble) on success,
+ * or null if Claude failed. Caller is responsible for ensuring the diff
+ * is non-empty.
+ */
+export async function fillCommitMessage(opts) {
+    const prompt = renderPrompt("fill-commit", {
+        branch_name: opts.branch,
+        ticket_id: opts.ticketId ?? "",
+        ticket_content: opts.ticketContent,
+        diff_content: opts.diffContent,
+    });
+    const result = await runAgentAsync(prompt);
+    if (!result.success)
+        return null;
+    // Trim quotes/whitespace; Claude occasionally wraps despite instructions.
+    return result.output.trim().replace(/^["'`]|["'`]$/g, "");
+}

package/dist/lib/claude-todos.d.ts

@@ -0,0 +1,37 @@
+export type ClaudeTodoStatus = "pending" | "in_progress" | "completed";
+export interface ClaudeTodo {
+    id: string;
+    content: string;
+    status: ClaudeTodoStatus;
+}
+/** Read the main-agent todo list for a Claude Code session.
+ *
+ * Claude Code persists `TodoWrite` state to
+ * `~/.claude/todos/<sessionId>-agent-<agentId>.json`. The file with
+ * `agentId === sessionId` is the user-visible list; sub-agent files
+ * (different agentId) are noise and ignored here.
+ *
+ * Returns null when the file is missing, empty, or unparseable. The
+ * dashboard treats a null/empty result as "hide the section" so a
+ * stray malformed file never blocks rendering. */
+export declare function readMainAgentTodos(sessionId: string): ClaudeTodo[] | null;
+/** Locate the cwd from which a Claude Code session is resumable.
+ *
+ * Claude stores transcripts at
+ * `~/.claude/projects/<encodedCwd>/<sessionId>.jsonl`, where `encodedCwd`
+ * replaces every `/` and `.` with `-`. `claude --resume <id>` is cwd-scoped:
+ * a session created at the worktree root is NOT resumable from a
+ * subdirectory like `backend/canary`, even though the file exists somewhere
+ * under `~/.claude/projects/`. The dashboard's tmux send-keys flow has no
+ * control over where the user's shell init / direnv leaves the window's
+ * cwd, so we resolve the original launch cwd here and prepend a `cd` to
+ * the resume command.
+ *
+ * Returns the real path of the cwd where the session is resumable —
+ * constrained to the worktree subtree so we never recommend `cd`-ing
+ * outside it. Returns null when the file isn't found anywhere matching
+ * the worktree (the file was deleted, or the session was created in a
+ * cwd we can't reconstruct). The encoding is lossy (`-` could come from
+ * `/` or `.`), so we verify candidates against real filesystem paths
+ * under `worktreeRoot` rather than guessing. */
+export declare function findClaudeSessionCwd(worktreeRoot: string, sessionId: string): string | null;

package/dist/lib/claude-todos.js

@@ -0,0 +1,98 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+/** Read the main-agent todo list for a Claude Code session.
+ *
+ * Claude Code persists `TodoWrite` state to
+ * `~/.claude/todos/<sessionId>-agent-<agentId>.json`. The file with
+ * `agentId === sessionId` is the user-visible list; sub-agent files
+ * (different agentId) are noise and ignored here.
+ *
+ * Returns null when the file is missing, empty, or unparseable. The
+ * dashboard treats a null/empty result as "hide the section" so a
+ * stray malformed file never blocks rendering. */
+export function readMainAgentTodos(sessionId) {
+    const file = path.join(os.homedir(), ".claude", "todos", `${sessionId}-agent-${sessionId}.json`);
+    let raw;
+    try {
+        raw = fs.readFileSync(file, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return null;
+        const out = [];
+        for (const item of parsed) {
+            if (!item || typeof item !== "object")
+                continue;
+            const { id, content, status } = item;
+            if (typeof id !== "string" || typeof content !== "string")
+                continue;
+            if (status !== "pending" && status !== "in_progress" && status !== "completed")
+                continue;
+            out.push({ id, content, status });
+        }
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+function encodeCwd(cwd) {
+    return cwd.replace(/[/.]/g, "-");
+}
+/** Locate the cwd from which a Claude Code session is resumable.
+ *
+ * Claude stores transcripts at
+ * `~/.claude/projects/<encodedCwd>/<sessionId>.jsonl`, where `encodedCwd`
+ * replaces every `/` and `.` with `-`. `claude --resume <id>` is cwd-scoped:
+ * a session created at the worktree root is NOT resumable from a
+ * subdirectory like `backend/canary`, even though the file exists somewhere
+ * under `~/.claude/projects/`. The dashboard's tmux send-keys flow has no
+ * control over where the user's shell init / direnv leaves the window's
+ * cwd, so we resolve the original launch cwd here and prepend a `cd` to
+ * the resume command.
+ *
+ * Returns the real path of the cwd where the session is resumable —
+ * constrained to the worktree subtree so we never recommend `cd`-ing
+ * outside it. Returns null when the file isn't found anywhere matching
+ * the worktree (the file was deleted, or the session was created in a
+ * cwd we can't reconstruct). The encoding is lossy (`-` could come from
+ * `/` or `.`), so we verify candidates against real filesystem paths
+ * under `worktreeRoot` rather than guessing. */
+export function findClaudeSessionCwd(worktreeRoot, sessionId) {
+    const projectsRoot = path.join(os.homedir(), ".claude", "projects");
+    const wtEncoded = encodeCwd(worktreeRoot);
+    // Fast path: session was created at the worktree root itself.
+    if (fs.existsSync(path.join(projectsRoot, wtEncoded, `${sessionId}.jsonl`))) {
+        return worktreeRoot;
+    }
+    // Slow path: session was created in a subdir of the worktree (e.g.
+    // project conventions auto-cd into `backend/canary` via direnv).
+    let dirs;
+    try {
+        dirs = fs.readdirSync(projectsRoot);
+    }
+    catch {
+        return null;
+    }
+    const prefix = `${wtEncoded}-`;
+    for (const dir of dirs) {
+        if (!dir.startsWith(prefix))
+            continue;
+        if (!fs.existsSync(path.join(projectsRoot, dir, `${sessionId}.jsonl`)))
+            continue;
+        // Decode the suffix back to a real path under the worktree. The
+        // encoding is lossy, so we verify candidates against the filesystem
+        // rather than guessing — only return a path that actually exists.
+        const suffix = dir.slice(prefix.length);
+        const candidate = path.join(worktreeRoot, ...suffix.split("-"));
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+    }
+    return null;
+}

package/dist/lib/dashboard/DetailPanel.js

@@ -10,6 +10,8 @@ function stateColor(type) {
             return "gray";
         case "orphaned":
             return "gray";
+        case "main":
+            return "magenta";
         default:
             return "yellow";
     }
@@ -58,6 +60,19 @@ function fileColor(xy) {
 export function buildIssueActions(di, trackerName) {
     const { worktree, pr, issue } = di;
     const items = [];
+    // The synthetic "Main repo" row is special: no PR/Switch/Resume/Remove,
+    // no work-launching (you're already on it). Only commit / diff /
+    // editor — the actions that make sense for "I have changes in main and
+    // want to review or land them".
+    if (issue.state.type === "main") {
+        if (worktree) {
+            items.push({ key: "e", label: "Editor", color: "cyan" });
+            if (worktree.dirty)
+                items.push({ key: "C", label: "Commit", color: "cyan" });
+            items.push({ key: "v", label: "View diff", color: "cyan" });
+        }
+        return items;
+    }
     if (worktree?.sessionId) {
         items.push({ key: "↵", label: "Resume", color: "cyan" });
     }
@@ -164,19 +179,21 @@ export default function DetailPanel({ issue, scrollOffset, height, width, creati
         lines.push({ text: `  ${worktree.path}`, dim: true });
         // Single metric row: files / +ins / -dels / commits ahead.
         const ds = worktree.diffStats;
-        if (ds && (ds.insertions > 0 || ds.deletions > 0 || ds.filesChanged > 0)) {
+        const behind = worktree.commitsBehind ?? 0;
+        const hasDiff = ds && (ds.insertions > 0 || ds.deletions > 0 || ds.filesChanged > 0);
+        if (hasDiff || worktree.commitsAhead > 0 || behind > 0) {
             const segs = [{ text: "  " }];
-            if (ds.filesChanged > 0) {
+            if (ds && ds.filesChanged > 0) {
                 segs.push({
                     text: `${ds.filesChanged} file${ds.filesChanged === 1 ? "" : "s"}`,
                 });
             }
-            if (ds.insertions > 0) {
+            if (ds && ds.insertions > 0) {
                 if (segs.length > 1)
                     segs.push({ text: "   " });
                 segs.push({ text: `+${ds.insertions}`, color: "green" });
             }
-            if (ds.deletions > 0) {
+            if (ds && ds.deletions > 0) {
                 if (segs.length > 1)
                     segs.push({ text: "   " });
                 segs.push({ text: `−${ds.deletions}`, color: "red" });
@@ -186,6 +203,11 @@ export default function DetailPanel({ issue, scrollOffset, height, width, creati
                     segs.push({ text: "   " });
                 segs.push({ text: `↑ ${worktree.commitsAhead}`, color: "cyan" });
             }
+            if (behind > 0) {
+                if (segs.length > 1)
+                    segs.push({ text: "   " });
+                segs.push({ text: `↓ ${behind} behind`, color: "yellow" });
+            }
             lines.push({ text: "", segments: segs });
         }
         // Per-status counts only when there's something dirty — when the tree is
@@ -277,10 +299,78 @@ export default function DetailPanel({ issue, scrollOffset, height, width, creati
         lines.push(sectionHeader("⎇", "Worktree"));
         lines.push({ text: "  no worktree for this ticket", dim: true });
     }
+    // ── Claude tasks ──────────────────────────────────────────────────
+    // Reads `~/.claude/todos/<sessionId>-agent-<sessionId>.json` (main-agent
+    // list only — sub-agent todos are noise). Section is hidden when the
+    // session has no todos or has exited; the header shows done/total at a
+    // glance. Up to 6 rows are rendered before collapsing into "+ N more".
+    const todos = worktree?.claudeTodos ?? null;
+    if (todos && todos.length > 0) {
+        const completed = todos.filter((t) => t.status === "completed").length;
+        const inProgress = todos.filter((t) => t.status === "in_progress").length;
+        lines.push(ruleLine);
+        const headerSegs = [
+            { text: "⎈ ", color: "cyan", bold: true },
+            { text: "Tasks", bold: true },
+            { text: "   " },
+            {
+                text: `${completed}/${todos.length}`,
+                color: completed === todos.length ? "green" : "cyan",
+            },
+        ];
+        if (inProgress > 0) {
+            headerSegs.push({ text: "  ·  ", dim: true });
+            headerSegs.push({ text: `${inProgress} in progress`, color: "yellow" });
+        }
+        lines.push({ text: "", segments: headerSegs });
+        const maxRows = 6;
+        // Surface in-progress first so the active task is always visible even
+        // when the list is long; pending next; completed last (most likely to
+        // be elided when truncating).
+        const ordered = [
+            ...todos.filter((t) => t.status === "in_progress"),
+            ...todos.filter((t) => t.status === "pending"),
+            ...todos.filter((t) => t.status === "completed"),
+        ];
+        for (const t of ordered.slice(0, maxRows)) {
+            if (t.status === "in_progress") {
+                lines.push({
+                    text: "",
+                    segments: [
+                        { text: "  ◐ ", color: "yellow", bold: true },
+                        { text: t.content, color: "yellow" },
+                    ],
+                });
+            }
+            else if (t.status === "completed") {
+                lines.push({
+                    text: "",
+                    segments: [
+                        { text: "  ✓ ", color: "green" },
+                        { text: t.content, dim: true },
+                    ],
+                });
+            }
+            else {
+                lines.push({
+                    text: "",
+                    segments: [{ text: "  ◯ ", dim: true }, { text: t.content }],
+                });
+            }
+        }
+        if (ordered.length > maxRows) {
+            lines.push({ text: `  + ${ordered.length - maxRows} more`, dim: true });
+        }
+    }
     // ── Pull Request ──────────────────────────────────────────────────
+    // Skip PR/Checks/Reviews sections entirely for the synthetic main row
+    // — those concepts don't apply to "the user's main checkout".
+    const isMain = li.state.type === "main";
     const { checks, reviews } = issue;
-    lines.push(ruleLine);
-    if (pr) {
+    if (!isMain) {
+        lines.push(ruleLine);
+    }
+    if (!isMain && pr) {
         const prColor = pr.state === "MERGED" ? "magenta" : pr.state === "OPEN" ? "green" : "red";
         const draft = pr.isDraft ? " · draft" : "";
         lines.push({
@@ -299,12 +389,12 @@ export default function DetailPanel({ issue, scrollOffset, height, width, creati
             lines.push({ text: `  ${pr.url}`, dim: true });
         }
     }
-    else {
+    else if (!isMain) {
         lines.push(sectionHeader("◉", "Pull Request"));
         lines.push({ text: "  no PR yet", dim: true });
     }
     // ── Checks ────────────────────────────────────────────────────────
-    if (checks && checks.length > 0) {
+    if (!isMain && checks && checks.length > 0) {
         const passing = checks.filter((c) => c.bucket === "pass");
         const failing = checks.filter((c) => c.bucket === "fail");
         const pending = checks.filter((c) => c.bucket !== "pass" && c.bucket !== "fail");
@@ -338,7 +428,7 @@ export default function DetailPanel({ issue, scrollOffset, height, width, creati
         }
     }
     // ── Reviews ───────────────────────────────────────────────────────
-    if (reviews && reviews.length > 0) {
+    if (!isMain && reviews && reviews.length > 0) {
         lines.push(ruleLine);
         lines.push(sectionHeader("★", "Reviews"));
         for (const review of reviews) {

package/dist/lib/dashboard/IssueList.js

@@ -17,6 +17,8 @@ function stateColor(type, name) {
             return "gray";
         case "orphaned":
             return "gray";
+        case "main":
+            return "magenta";
         default:
             return "yellow";
     }

package/dist/lib/dashboard/MultilineTextArea.js

@@ -297,7 +297,20 @@ export function MultilineTextArea({ value, onChange, onSubmit, onCancel, placeho
             return;
         if (!input)
             return;
-        insertAt(cursor, input.replace(/\r\n?/g, "\n"));
+        // Strip OSC sequences (terminal-side responses to OSC 11/52 etc.
+        // queries) — they leak into stdin while a refresh is querying
+        // the background color and would otherwise type themselves into
+        // the buffer. Pattern: anything starting with `]` followed by a
+        // number, semicolon, payload, then BEL or ST. We strip both the
+        // fully-formed OSC `\x1b]…\x07` and the bracket-only fragment
+        // that arrives when Ink consumed the leading ESC as a separate
+        // keypress (which it does for almost all OSC responses).
+        let cleaned = input
+            .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, "")
+            .replace(/^\][0-9]+;[^\x07]*\x07?/, "");
+        if (!cleaned)
+            return;
+        insertAt(cursor, cleaned.replace(/\r\n?/g, "\n"));
     }, { isActive: focus });
     const innerWidth = Math.max(1, (width ?? 80) - 4);
     const rows = buildVisualRows(value, innerWidth);

package/dist/lib/dashboard/Overlays.d.ts

@@ -25,4 +25,9 @@ interface PrCreateOverlayProps {
     dispatch: React.Dispatch<DashboardAction>;
 }
 export declare function PrCreateOverlay({ width, height, branch, ticketId, phase, error, url, body, title, dispatch, }: PrCreateOverlayProps): import("react/jsx-runtime").JSX.Element;
+interface HelpOverlayProps {
+    width: number;
+    height: number;
+}
+export declare function HelpOverlay({ width, height }: HelpOverlayProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/lib/dashboard/Overlays.js

@@ -1,7 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 import Spinner from "ink-spinner";
-import TextInput from "ink-text-input";
 import { MultilineTextArea } from "./MultilineTextArea.js";
 export function CommitOverlay({ width, height, branch, ticketId, gitStatus, phase, message, error, dispatch, onSubmit, }) {
     return (_jsxs(Box, { flexDirection: "column", width: width, height: height, children: [_jsx(Text, { bold: true, color: "cyan", children: "Commit & Push" }), _jsx(Text, { dimColor: true, children: "─".repeat(Math.min(width, 50)) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "branch: " }), _jsx(Text, { children: branch })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "ticket: " }), _jsx(Text, { children: ticketId })] }), _jsx(Text, { children: " " }), gitStatus ? (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "Changes:" }), gitStatus
@@ -19,7 +18,7 @@ export function CommitOverlay({ width, height, branch, ticketId, gitStatus, phas
                             color = "yellow";
                         }
                         return (_jsxs(Text, { color: color, children: [" ", line] }, i));
-                    }), gitStatus.split("\n").length > 8 && (_jsxs(Text, { dimColor: true, children: [" +", gitStatus.split("\n").length - 8, " more"] }))] })) : null, _jsx(Text, { children: " " }), phase === "confirm-stage" && (_jsxs(Text, { children: ["Stage all changes?", " ", _jsx(Text, { color: "cyan", bold: true, children: "y" }), "/", _jsx(Text, { color: "cyan", bold: true, children: "n" })] })), phase === "awaiting-message" && (_jsxs(Box, { children: [_jsx(Text, { children: "Message: " }), _jsx(TextInput, { value: message, onChange: (v) => dispatch({ type: "COMMIT_MESSAGE", message: v }), onSubmit: onSubmit })] })), phase === "committing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Committing..."] })), phase === "pushing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Pushing..."] })), phase === "done" && (_jsx(Text, { color: "green", bold: true, children: "Committed and pushed!" })), phase === "error" && _jsx(Text, { color: "red", children: error }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "ESC to cancel" })] }));
+                    }), gitStatus.split("\n").length > 8 && (_jsxs(Text, { dimColor: true, children: [" +", gitStatus.split("\n").length - 8, " more"] }))] })) : null, _jsx(Text, { children: " " }), phase === "confirm-stage" && (_jsxs(Text, { children: ["Stage all changes?", " ", _jsx(Text, { color: "cyan", bold: true, children: "y" }), "/", _jsx(Text, { color: "cyan", bold: true, children: "n" })] })), phase === "choose-mode" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "How do you want to write the message?" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [" ", _jsx(Text, { color: "cyan", bold: true, children: "f" }), " ", "Fill \u2014 let Claude draft a short message"] }), _jsxs(Text, { children: [" ", _jsx(Text, { color: "cyan", bold: true, children: "m" }), " ", "Manual \u2014 type it yourself"] })] })), phase === "filling" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Drafting commit message with Claude..."] })), phase === "awaiting-message" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "Edit commit message" }), _jsx(Text, { children: " " }), _jsx(MultilineTextArea, { value: message, onChange: (v) => dispatch({ type: "COMMIT_MESSAGE", message: v }), onSubmit: () => onSubmit(message), onCancel: () => dispatch({ type: "COMMIT_CANCEL" }), width: width, height: Math.max(3, Math.min(6, height - 12)), placeholder: "(empty)" }), _jsx(Text, { children: " " }), _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "cyan", bold: true, children: "Ctrl+D" }), " commit  ·  ", _jsx(Text, { color: "cyan", bold: true, children: "Ctrl+O" }), " editor  ·  ", _jsx(Text, { color: "cyan", bold: true, children: "Ctrl+G" }), " cancel"] })] })), phase === "committing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Committing..."] })), phase === "pushing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Pushing..."] })), phase === "done" && (_jsx(Text, { color: "green", bold: true, children: "Committed and pushed!" })), phase === "error" && _jsx(Text, { color: "red", children: error }), phase !== "awaiting-message" && phase !== "done" && phase !== "error" && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "ESC to cancel" })] }))] }));
 }
 export function PrCreateOverlay({ width, height, branch, ticketId, phase, error, url, body, title, dispatch, }) {
     return (_jsxs(Box, { flexDirection: "column", width: width, height: height, children: [_jsx(Text, { bold: true, color: "cyan", children: "Create Pull Request" }), _jsx(Text, { dimColor: true, children: "─".repeat(Math.min(width, 50)) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "branch: " }), _jsx(Text, { children: branch })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "ticket: " }), _jsx(Text, { children: ticketId })] }), _jsx(Text, { children: " " }), phase === "choose-mode" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "How do you want to create this PR?" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [" ", _jsx(Text, { color: "cyan", bold: true, children: "f" }), " ", "Fill \u2014 use AI to fill the PR template"] }), _jsxs(Text, { children: [" ", _jsx(Text, { color: "cyan", bold: true, children: "w" }), " ", "Web \u2014 open in browser to edit manually"] })] })), phase === "pushing" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Pushing branch..."] })), phase === "filling" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Filling PR template with AI..."] })), phase === "review" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "Edit PR description" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "title: " }), _jsx(Text, { children: title })] }), _jsx(Text, { children: " " }), _jsx(MultilineTextArea, { value: body ?? "", onChange: (v) => dispatch({ type: "PR_CREATE_BODY_CHANGE", body: v }), onSubmit: () => dispatch({ type: "PR_CREATE_CONFIRM" }), onCancel: () => dispatch({ type: "PR_CREATE_CANCEL" }), width: width, height: Math.max(6, height - 10), placeholder: "(empty PR body)" }), _jsx(Text, { children: " " }), _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "cyan", bold: true, children: "Ctrl+D" }), " send  ·  ", _jsx(Text, { color: "cyan", bold: true, children: "Ctrl+O" }), " editor  ·  ", _jsx(Text, { color: "cyan", bold: true, children: "Ctrl+G" }), " cancel"] })] })), phase === "confirm" && (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: "Create this PR?" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "title: " }), _jsx(Text, { children: title })] }), _jsx(Text, { children: " " }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "green", paddingX: 1, children: [(body ?? "")
@@ -27,3 +26,77 @@ export function PrCreateOverlay({ width, height, branch, ticketId, phase, error,
                                 .slice(0, Math.max(4, height - 12))
                                 .map((line, i) => (_jsx(Text, { wrap: "truncate", children: line || " " }, i))), (body ?? "").split("\n").length > Math.max(4, height - 12) && (_jsxs(Text, { dimColor: true, children: ["\u2026+", (body ?? "").split("\n").length - Math.max(4, height - 12), " more lines"] }))] }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsx(Text, { color: "green", bold: true, children: "y" }), " / ", _jsx(Text, { color: "green", bold: true, children: "Enter" }), "  create   ", _jsx(Text, { color: "yellow", bold: true, children: "e" }), "  keep editing   ", _jsx(Text, { color: "cyan", bold: true, children: "w" }), "  open in browser   ", _jsx(Text, { color: "red", bold: true, children: "ESC" }), "  cancel"] })] })), phase === "creating" && (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), " ", "Creating PR..."] })), phase === "done" && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "green", bold: true, children: "PR created!" }), url ? _jsx(Text, { dimColor: true, children: url }) : null] })), phase === "error" && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "red", children: error }), _jsx(Text, { children: " " }), _jsxs(Text, { dimColor: true, children: [_jsx(Text, { color: "cyan", bold: true, children: "w" }), " ", "open in browser ESC cancel"] })] })), phase !== "review" && phase !== "confirm" && phase !== "error" && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "ESC to cancel" })] }))] }));
 }
+const LEGEND = [
+    {
+        title: "Issue list",
+        rows: [
+            { glyph: "▎", color: "red", meaning: "Urgent (P1) priority" },
+            { glyph: "▎", color: "yellow", meaning: "High (P2) priority" },
+            { glyph: "●", color: "green", meaning: "State: started / In Progress" },
+            { glyph: "●", color: "blue", meaning: "State: unstarted / In Review" },
+            { glyph: "●", color: "gray", meaning: "State: backlog / orphaned" },
+            { glyph: "●", color: "magenta", meaning: "State: main repo (your non-worktree checkout)" },
+            { glyph: "✓", color: "green", meaning: "WT column: worktree exists" },
+            { glyph: "·", color: "gray", meaning: "WT column: no worktree" },
+            { glyph: "✓", color: "green", meaning: "CI column: all checks passing" },
+            { glyph: "✗", color: "red", meaning: "CI column: a check is failing" },
+            { glyph: "●", color: "yellow", meaning: "CI column: checks pending / running" },
+            { glyph: "·", color: "gray", meaning: "CI column: no PR or no checks" },
+        ],
+    },
+    {
+        title: "Detail panel — Worktree",
+        rows: [
+            { glyph: "● dirty", color: "yellow", meaning: "Uncommitted changes" },
+            { glyph: "✓ clean", color: "green", meaning: "Working tree clean" },
+            { glyph: "↑ N", color: "cyan", meaning: "N commits ahead of base" },
+            { glyph: "↓ N behind", color: "yellow", meaning: "Main repo: N commits to pull from origin" },
+            { glyph: "◆", color: "red", meaning: "Session needs input (permission prompt)" },
+            { glyph: "◆", color: "green", meaning: "Session active (Claude is working)" },
+            { glyph: "◆", color: "yellow", meaning: "Session idle (waiting for prompt)" },
+            { glyph: "◇", color: "cyan", meaning: "Session id stored, no live signal" },
+            { glyph: "◇", color: "gray", meaning: "No session" },
+        ],
+    },
+    {
+        title: "Detail panel — Tasks (Claude todos)",
+        rows: [
+            { glyph: "◐", color: "yellow", meaning: "Task in progress" },
+            { glyph: "◯", color: "gray", meaning: "Task pending" },
+            { glyph: "✓", color: "green", meaning: "Task completed" },
+        ],
+    },
+    {
+        title: "Section icons",
+        rows: [
+            { glyph: "⎇", color: "cyan", meaning: "Worktree / Branch" },
+            { glyph: "◉", color: "cyan", meaning: "Pull Request" },
+            { glyph: "✓", color: "cyan", meaning: "Checks" },
+            { glyph: "★", color: "cyan", meaning: "Reviews" },
+            { glyph: "⎈", color: "cyan", meaning: "Tasks (Claude todos)" },
+            { glyph: "◎", color: "cyan", meaning: "Linked tracker ticket (review tab)" },
+        ],
+    },
+];
+export function HelpOverlay({ width, height }) {
+    const lines = [];
+    for (const section of LEGEND) {
+        lines.push({ text: section.title, bold: true });
+        for (const row of section.rows) {
+            lines.push({
+                text: "",
+                segments: [
+                    { text: "  " },
+                    { text: row.glyph.padEnd(3, " "), color: row.color, bold: true },
+                    { text: "  " },
+                    { text: row.meaning, dim: true },
+                ],
+            });
+        }
+        lines.push({ text: "" });
+    }
+    // Trim trailing blank
+    if (lines[lines.length - 1]?.text === "")
+        lines.pop();
+    return (_jsx(Box, { width: width, height: height, flexDirection: "column", alignItems: "center", justifyContent: "center", children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 3, paddingY: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Dashboard glyph reference" }), _jsx(Text, { children: " " }), lines.map((line, i) => (_jsx(Box, { children: line.segments ? (_jsx(Text, { children: line.segments.map((seg, j) => (_jsx(Text, { color: seg.color, bold: seg.bold, dimColor: seg.dim, children: seg.text }, j))) })) : (_jsx(Text, { bold: line.bold, dimColor: line.dim, children: line.text || " " })) }, i))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "Press ? or Esc to close" })] }) }));
+}

package/dist/lib/dashboard/ReviewDetailPanel.d.ts

@@ -10,6 +10,13 @@ export type ReviewActionItem = {
     label: string;
     color: string;
 };
+/**
+ * Action footer for the reviews tab. The factory mirrors `buildIssueActions`
+ * over in DetailPanel — same shape so the dashboard's action-row renderer
+ * doesn't need a per-tab branch. Disabled-state semantics: when an action
+ * doesn't apply (no ticket, no worktree), we omit the entry rather than
+ * dimming it, matching the issues tab's convention.
+ */
 export declare function buildReviewActions(item: EnrichedReviewPR): ReviewActionItem[];
 export default function ReviewDetailPanel({ item, scrollOffset, height, width }: Props): import("react/jsx-runtime").JSX.Element;
 export {};