santree 0.6.2 → 0.7.0

package/dist/commands/issue/setup.d.ts

@@ -0,0 +1,2 @@
+export declare const description = "Pick and configure the issue tracker for this repo";
+export default function IssueSetup(): import("react/jsx-runtime").JSX.Element;

package/dist/commands/issue/setup.js

@@ -0,0 +1,108 @@
+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 } from "../../lib/git.js";
+import { setRepoTracker, getIssueTracker } from "../../lib/trackers/index.js";
+import { setRepoLinearOrg } from "../../lib/trackers/linear/index.js";
+import { readLinearAuthStore } from "../../lib/trackers/auth-store.js";
+import { getAuthenticatedUser, getCurrentRepoNwo } from "../../lib/trackers/github/auth.js";
+export const description = "Pick and configure the issue tracker for this repo";
+const TRACKERS = [
+    { kind: "local", label: "Local", hint: "built-in, file-based — no account needed" },
+    { kind: "linear", label: "Linear", hint: "OAuth workspace" },
+    { kind: "github", label: "GitHub", hint: "GitHub Issues via gh CLI" },
+];
+export default function IssueSetup() {
+    const [phase, setPhase] = useState("checking");
+    const [message, setMessage] = useState("");
+    const [error, setError] = useState(null);
+    const [trackerIdx, setTrackerIdx] = useState(0);
+    const [orgs, setOrgs] = useState([]);
+    const [orgIdx, setOrgIdx] = useState(0);
+    const [repoRoot, setRepoRoot] = useState(null);
+    useEffect(() => {
+        const root = findMainRepoRoot();
+        if (!root) {
+            setError("Not inside a git repository");
+            setPhase("error");
+            return;
+        }
+        setRepoRoot(root);
+        setPhase("pick-tracker");
+    }, []);
+    function finish(label) {
+        setMessage(label);
+        setPhase("done");
+    }
+    async function chooseTracker(kind) {
+        const root = repoRoot;
+        if (kind === "local") {
+            setRepoTracker(root, "local");
+            finish(`Active tracker for this repo: ${getIssueTracker(root).displayName}`);
+            return;
+        }
+        if (kind === "linear") {
+            const store = readLinearAuthStore();
+            const list = Object.entries(store).map(([slug, tokens]) => ({
+                slug,
+                name: tokens.org_name,
+            }));
+            if (list.length === 0) {
+                setError("No authenticated Linear workspaces. Run: santree linear auth");
+                setPhase("error");
+                return;
+            }
+            if (list.length === 1) {
+                setRepoLinearOrg(root, list[0].slug);
+                setRepoTracker(root, "linear");
+                finish(`Linked to ${list[0].name} (${list[0].slug})`);
+                return;
+            }
+            setOrgs(list);
+            setOrgIdx(0);
+            setPhase("pick-org");
+            return;
+        }
+        // github
+        setPhase("checking");
+        const user = await getAuthenticatedUser();
+        if (!user) {
+            setError("GitHub CLI not authenticated. Run: santree github auth");
+            setPhase("error");
+            return;
+        }
+        setRepoTracker(root, "github");
+        const nwo = await getCurrentRepoNwo(root);
+        finish(`Active tracker: GitHub (@${user.login}${nwo ? ` · ${nwo}` : ""})`);
+    }
+    useInput((_input, key) => {
+        if (phase === "pick-tracker") {
+            if (key.upArrow)
+                setTrackerIdx((i) => Math.max(0, i - 1));
+            else if (key.downArrow)
+                setTrackerIdx((i) => Math.min(TRACKERS.length - 1, i + 1));
+            else if (key.return)
+                void chooseTracker(TRACKERS[trackerIdx].kind);
+        }
+        else if (phase === "pick-org") {
+            if (key.upArrow)
+                setOrgIdx((i) => Math.max(0, i - 1));
+            else if (key.downArrow)
+                setOrgIdx((i) => Math.min(orgs.length - 1, i + 1));
+            else if (key.return) {
+                const org = orgs[orgIdx];
+                setRepoLinearOrg(repoRoot, org.slug);
+                setRepoTracker(repoRoot, "linear");
+                finish(`Linked to ${org.name} (${org.slug})`);
+            }
+        }
+    });
+    useEffect(() => {
+        if (phase === "done" || phase === "error") {
+            const timer = setTimeout(() => process.exit(phase === "error" ? 1 : 0), 100);
+            return () => clearTimeout(timer);
+        }
+    }, [phase]);
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Issue tracker setup" }) }), phase === "checking" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Checking\u2026" })] })), phase === "pick-tracker" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Select the issue tracker for this repo:" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: TRACKERS.map((t, i) => (_jsxs(Text, { children: [i === trackerIdx ? (_jsx(Text, { color: "cyan", bold: true, children: "> " })) : (_jsx(Text, { children: "  " })), t.label, " ", _jsxs(Text, { dimColor: true, children: ["\u2014 ", t.hint] })] }, t.kind))) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u2191/\u2193 to select, Enter to confirm" }) })] })), phase === "pick-org" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Select a Linear workspace to link:" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: orgs.map((org, i) => (_jsxs(Text, { children: [i === orgIdx ? (_jsx(Text, { color: "cyan", bold: true, children: "> " })) : (_jsx(Text, { children: "  " })), org.name, " (", org.slug, ")"] }, org.slug))) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u2191/\u2193 to select, Enter to confirm" }) })] })), phase === "done" && _jsxs(Text, { color: "green", children: ["\u2713 ", message] }), phase === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] }));
+}

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

@@ -3,6 +3,7 @@ export declare const description = "Switch the active issue tracker for this rep
 export declare const args: z.ZodTuple<[z.ZodEnum<{
     linear: "linear";
     github: "github";
+    local: "local";
 }>], null>;
 type Props = {
     args: z.infer<typeof args>;

package/dist/commands/issue/switch.js

@@ -7,9 +7,9 @@ import { findMainRepoRoot } from "../../lib/git.js";
 import { setRepoTracker, getIssueTracker } from "../../lib/trackers/index.js";
 export const description = "Switch the active issue tracker for this repo";
 export const args = z.tuple([
-    z.enum(["linear", "github"]).describe(argument({
+    z.enum(["linear", "github", "local"]).describe(argument({
         name: "kind",
-        description: "Tracker kind: linear or github",
+        description: "Tracker kind: linear, github, or local (built-in)",
     })),
 ]);
 export default function IssueSwitch({ args }) {

package/dist/commands/worktree/work.js

@@ -99,5 +99,5 @@ export default function Work({ options }) {
             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 issue from tracker..." })] })), status === "launching" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }), _jsxs(Text, { dimColor: true, children: [" ", "claude", mode === "plan" ? " --permission-mode plan" : "", " ", `"<${getModeLabel(mode)} prompt for ${ticketId}>"`] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] })] }));
+    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 issue from tracker..." })] })), status === "launching" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }), _jsxs(Text, { dimColor: true, children: [" ", "claude --permission-mode ", mode === "plan" ? "plan" : "auto", " ", `"<${getModeLabel(mode)} prompt for ${ticketId}>"`] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] })] }));
 }

package/dist/lib/ai.js

@@ -185,6 +185,10 @@ export function launchAgent(prompt, opts) {
         throw new Error("Claude CLI not found. Install: npm install -g @anthropic-ai/claude-code");
     }
     const args = [];
+    // Plan mode uses Claude Code's `--permission-mode plan` (read-only,
+    // restrictive); implement runs use `auto`. Auto-acceptance of non-mutating
+    // tools while planning is governed by the user's `useAutoModeDuringPlan`
+    // setting in ~/.claude/settings.json, not by santree.
     args.push("--permission-mode", opts?.planMode ? "plan" : "auto");
     if (opts?.sessionId) {
         if (opts.resume) {

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

@@ -1,4 +1,4 @@
-import type { DashboardIssue } from "./types.js";
+import type { DashboardIssue, DashboardTab } from "./types.js";
 interface Props {
     issue: DashboardIssue | null;
     scrollOffset: number;
@@ -18,6 +18,9 @@ export type IssueActionItem = {
  * `trackerName` is the active tracker's `displayName` ("Linear" / "GitHub"),
  * surfaced as the open-in-browser action label so the panel doesn't hardcode
  * a vendor name. */
-export declare function buildIssueActions(di: DashboardIssue, trackerName: string): IssueActionItem[];
+export declare function buildIssueActions(di: DashboardIssue, trackerName: string, opts?: {
+    tab?: DashboardTab;
+    canMutate?: boolean;
+}): IssueActionItem[];
 export default function DetailPanel({ issue, scrollOffset, height, width, creatingForTicket, creationLogs, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/lib/dashboard/DetailPanel.js

@@ -1,4 +1,4 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 function stateColor(type) {
     switch (type) {
@@ -57,9 +57,26 @@ function fileColor(xy) {
  * `trackerName` is the active tracker's `displayName` ("Linear" / "GitHub"),
  * surfaced as the open-in-browser action label so the panel doesn't hardcode
  * a vendor name. */
-export function buildIssueActions(di, trackerName) {
+export function buildIssueActions(di, trackerName, opts) {
     const { worktree, pr, issue } = di;
     const items = [];
+    // Issues tab = backlog/planning. No worktree actions here (commit / PR /
+    // diff / fix live on the Trees tab). Offer Work (start → creates a
+    // worktree, moving the row to Trees) plus issue CRUD when the active
+    // tracker supports mutation (built-in Local only — feature-detected via
+    // `canMutate`, never a kind string check).
+    if (opts?.tab === "issues") {
+        items.push({ key: "w", label: "Work", color: "cyan" });
+        if (opts.canMutate) {
+            items.push({ key: "n", label: "New", color: "cyan" });
+            items.push({ key: "e", label: "Edit", color: "cyan" });
+            items.push({ key: "d", label: "Delete", color: "red" });
+        }
+        if (issue.url) {
+            items.push({ key: "o", label: trackerName, color: "gray" });
+        }
+        return 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
@@ -127,7 +144,11 @@ export default function DetailPanel({ issue, scrollOffset, height, width, creati
         const contentRows = height - 1;
         const startIdx = Math.max(0, logLines.length - contentRows);
         const visible = logLines.slice(startIdx, startIdx + contentRows);
-        return (_jsxs(Box, { flexDirection: "column", width: width, height: height, children: [_jsxs(Text, { color: "yellow", bold: true, children: ["Setting up worktree for ", creatingForTicket, "..."] }), visible.map((line, i) => (_jsx(Box, { children: _jsx(Text, { dimColor: true, children: line }) }, i)))] }));
+        // Setup-script output is arbitrary-length; clamp each line to the pane
+        // width so long lines truncate instead of wrapping/overflowing into the
+        // left pane. Ink's default soft-wrap would push the box past `height`.
+        const clampLine = (s) => s.length > width ? s.slice(0, Math.max(0, width - 1)) + "…" : s;
+        return (_jsxs(Box, { flexDirection: "column", width: width, height: height, children: [_jsx(Text, { color: "yellow", bold: true, children: clampLine(`Setting up worktree for ${creatingForTicket}...`) }), visible.map((line, i) => (_jsx(Box, { children: _jsx(Text, { dimColor: true, children: clampLine(line) }) }, i)))] }));
     }
     if (!issue) {
         return (_jsx(Box, { width: width, height: height, justifyContent: "center", alignItems: "center", children: _jsx(Text, { dimColor: true, children: "No issue selected" }) }));

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

@@ -10,6 +10,8 @@ interface Props {
     selectionBg?: string;
 }
 export type ListRow = {
+    kind: "spacer";
+} | {
     kind: "header";
     name: string;
     count: number;

package/dist/lib/dashboard/IssueList.js

@@ -64,6 +64,11 @@ export function buildIssueListRows(groups, flatIssues) {
     }
     groups.forEach((group, gi) => {
         const totalIssues = group.statusGroups.reduce((sum, sg) => sum + sg.issues.length, 0);
+        // Blank line between projects. Modelled as a real row (not a render-only
+        // `marginTop`) so `rows[]` indices line up 1:1 with rendered rows —
+        // otherwise the dashboard's click→row mapping drifts by one per project.
+        if (gi > 0)
+            rows.push({ kind: "spacer" });
         rows.push({ kind: "header", name: group.name, count: totalIssues, isFirst: gi === 0 });
         for (const sg of group.statusGroups) {
             rows.push({ kind: "status-header", name: sg.name, type: sg.type, count: sg.issues.length });
@@ -86,6 +91,9 @@ export default function IssueList({ groups, flatIssues, selectedIndex, scrollOff
     const visible = rows.slice(scrollOffset, scrollOffset + height);
     const titleMaxWidth = Math.max(width - LEFT_FIXED - 1 /* leading space */ - RIGHT_FIXED - TITLE_GAP, 10);
     return (_jsx(Box, { flexDirection: "column", width: width, height: height, children: _jsx(Box, { flexDirection: "column", height: height, children: visible.map((row, i) => {
+                if (row.kind === "spacer") {
+                    return _jsx(Box, { height: 1 }, `sp-${i}`);
+                }
                 if (row.kind === "header") {
                     // On the first project header, also render the WT/CI column
                     // labels right-aligned to the worktree/CI glyph columns —
@@ -97,7 +105,7 @@ export default function IssueList({ groups, flatIssues, selectedIndex, scrollOff
                     const labelPad = row.isFirst
                         ? Math.max(2, width - namePart.length - labelText.length)
                         : 0;
-                    return (_jsxs(Box, { marginTop: i === 0 ? 0 : 1, children: [_jsx(Text, { bold: true, children: row.name }), _jsxs(Text, { dimColor: true, children: ["  ", row.count] }), row.isFirst && _jsx(Text, { dimColor: true, children: `${" ".repeat(labelPad)}${labelText}` })] }, `h-${i}`));
+                    return (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: row.name }), _jsxs(Text, { dimColor: true, children: ["  ", row.count] }), row.isFirst && _jsx(Text, { dimColor: true, children: `${" ".repeat(labelPad)}${labelText}` })] }, `h-${i}`));
                 }
                 if (row.kind === "status-header") {
                     return (_jsxs(Box, { children: [_jsxs(Text, { color: stateColor(row.type, row.name), children: ["  ", row.name] }), _jsxs(Text, { dimColor: true, children: ["  ", row.count] })] }, `sh-${i}`));

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

@@ -22,9 +22,10 @@ interface PrCreateOverlayProps {
     url: string | null;
     body: string | null;
     title: string | null;
+    draft: boolean;
     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;
+export declare function PrCreateOverlay({ width, height, branch, ticketId, phase, error, url, body, title, draft, dispatch, }: PrCreateOverlayProps): import("react/jsx-runtime").JSX.Element;
 interface HelpOverlayProps {
     width: number;
     height: number;

package/dist/lib/dashboard/Overlays.js

@@ -20,13 +20,27 @@ export function CommitOverlay({ width, height, branch, ticketId, gitStatus, phas
                         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 === "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 ?? "")
+export function PrCreateOverlay({ width, height, branch, ticketId, phase, error, url, body, title, draft, 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: [_jsxs(Text, { bold: true, children: ["Create this PR?", " ", _jsxs(Text, { color: draft ? "yellow" : "green", children: ["(", draft ? "draft" : "ready for review", ")"] })] }), _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 ?? "")
                                 .split("\n")
                                 .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" })] }))] }));
+                                .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: "d" }), `  ${draft ? "mark ready" : "mark draft"}   `, _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: "Tabs & keys",
+        rows: [
+            { glyph: "1", color: "cyan", meaning: "Issues tab — backlog / planning" },
+            { glyph: "2", color: "cyan", meaning: "Trees tab — worktrees in progress" },
+            { glyph: "3", color: "cyan", meaning: "Reviews tab — PRs awaiting your review" },
+            { glyph: "Tab", color: "cyan", meaning: "Cycle Issues → Trees → Reviews" },
+            { glyph: "t", color: "cyan", meaning: "Switch / set up the issue tracker" },
+            { glyph: "n", color: "cyan", meaning: "New issue (built-in tracker, Issues tab)" },
+            { glyph: "e", color: "cyan", meaning: "Edit issue (built-in tracker, Issues tab)" },
+            { glyph: "d", color: "red", meaning: "Delete issue (built-in) / remove worktree (Trees)" },
+            { glyph: "w", color: "cyan", meaning: "Start work (creates a worktree → Trees tab)" },
+        ],
+    },
     {
         title: "Issue list",
         rows: [

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

@@ -2,6 +2,8 @@ import type { DashboardIssue, ProjectGroup, EnrichedReviewPR } from "./types.js"
 export declare function loadDashboardData(repoRoot: string): Promise<{
     groups: ProjectGroup[];
     flatIssues: DashboardIssue[];
+    treeGroups: ProjectGroup[];
+    flatTrees: DashboardIssue[];
 }>;
 export declare function loadReviewsData(repoRoot: string): Promise<{
     flatReviews: EnrichedReviewPR[];

package/dist/lib/dashboard/data.js

@@ -203,16 +203,6 @@ export async function loadDashboardData(repoRoot) {
         parent.children.push(di);
         childTicketIds.add(ticketId);
     }
-    // Group by project (excluding children — they'll appear nested under parents)
-    const groupMap = new Map();
-    for (const di of enriched) {
-        if (childTicketIds.has(di.issue.identifier))
-            continue;
-        const key = di.issue.projectName ?? "No Project";
-        const list = groupMap.get(key) ?? [];
-        list.push(di);
-        groupMap.set(key, list);
-    }
     // Status type priority: started > unstarted > backlog > triage
     const statusTypePriority = {
         started: 0,
@@ -220,44 +210,35 @@ export async function loadDashboardData(repoRoot) {
         backlog: 2,
         triage: 3,
     };
-    const groups = [...groupMap.entries()].map(([name, issues]) => {
-        // Sub-group by status
-        const statusMap = new Map();
+    // Group a set of (non-child) issues by project, then by status.
+    function buildProjectGroups(issues) {
+        const groupMap = new Map();
         for (const di of issues) {
-            const statusName = di.issue.state.name;
-            const existing = statusMap.get(statusName);
-            if (existing) {
-                existing.issues.push(di);
-            }
-            else {
-                statusMap.set(statusName, {
-                    name: statusName,
-                    type: di.issue.state.type,
-                    issues: [di],
-                });
-            }
+            if (childTicketIds.has(di.issue.identifier))
+                continue;
+            const key = di.issue.projectName ?? "No Project";
+            const list = groupMap.get(key) ?? [];
+            list.push(di);
+            groupMap.set(key, list);
         }
-        // Sort status groups by type priority
-        const statusGroups = [...statusMap.values()].sort((a, b) => (statusTypePriority[a.type] ?? 99) - (statusTypePriority[b.type] ?? 99));
-        return {
-            name,
-            id: issues[0]?.issue.projectId ?? null,
-            statusGroups,
-        };
-    });
-    // Append orphaned worktrees as a separate group at the bottom (excluding children)
-    const topLevelOrphans = orphans.filter((di) => !childTicketIds.has(di.issue.identifier));
-    if (topLevelOrphans.length > 0) {
-        groups.push({
-            name: "Orphaned Worktrees",
-            id: null,
-            statusGroups: [
-                {
-                    name: "Orphaned",
-                    type: "orphaned",
-                    issues: topLevelOrphans,
-                },
-            ],
+        return [...groupMap.entries()].map(([name, list]) => {
+            const statusMap = new Map();
+            for (const di of list) {
+                const statusName = di.issue.state.name;
+                const existing = statusMap.get(statusName);
+                if (existing) {
+                    existing.issues.push(di);
+                }
+                else {
+                    statusMap.set(statusName, {
+                        name: statusName,
+                        type: di.issue.state.type,
+                        issues: [di],
+                    });
+                }
+            }
+            const statusGroups = [...statusMap.values()].sort((a, b) => (statusTypePriority[a.type] ?? 99) - (statusTypePriority[b.type] ?? 99));
+            return { name, id: list[0]?.issue.projectId ?? null, statusGroups };
         });
     }
     // Flatten with children inserted right after their parent
@@ -270,21 +251,42 @@ export async function loadDashboardData(repoRoot) {
         }
         return result;
     }
-    const flatIssues = groups.flatMap((g) => g.statusGroups.flatMap((sg) => sg.issues.flatMap(flattenWithChildren)));
-    // Synthesize a "Main repo" row at the very top so users can commit /
-    // view diffs / inspect drift on whatever branch their main checkout
-    // happens to be on. The row uses the same WorktreeInfo shape but with
-    // state.type === "main" so the renderer can differentiate.
+    function flatten(g) {
+        return g.flatMap((grp) => grp.statusGroups.flatMap((sg) => sg.issues.flatMap(flattenWithChildren)));
+    }
+    // ── Partition: Issues tab (backlog/planning) vs Trees tab (work in
+    // progress). A tracker issue with no worktree is backlog; once it gains a
+    // worktree it moves to the Trees tab. Children always have a worktree, so
+    // they only ever appear nested in Trees. Main-repo + orphaned worktrees
+    // belong to Trees (they're active checkouts, not backlog).
+    const backlogIssues = enriched.filter((di) => !di.worktree);
+    const treeIssues = enriched.filter((di) => di.worktree);
+    const groups = buildProjectGroups(backlogIssues);
+    const flatIssues = flatten(groups);
+    const treeGroups = buildProjectGroups(treeIssues);
+    const topLevelOrphans = orphans.filter((di) => !childTicketIds.has(di.issue.identifier));
+    if (topLevelOrphans.length > 0) {
+        treeGroups.push({
+            name: "Orphaned Worktrees",
+            id: null,
+            statusGroups: [{ name: "Orphaned", type: "orphaned", issues: topLevelOrphans }],
+        });
+    }
+    const flatTrees = flatten(treeGroups);
+    // Synthesize a "Main repo" row at the top of the Trees tab so users can
+    // commit / view diffs / inspect drift on whatever branch their main
+    // checkout happens to be on. state.type === "main" lets the renderer
+    // differentiate.
     const mainEntry = await buildMainEntry(repoRoot);
     if (mainEntry) {
-        groups.unshift({
+        treeGroups.unshift({
             name: "Main repo",
             id: null,
             statusGroups: [{ name: "Main", type: "main", issues: [mainEntry] }],
         });
-        flatIssues.unshift(mainEntry);
+        flatTrees.unshift(mainEntry);
     }
-    return { groups, flatIssues };
+    return { groups, flatIssues, treeGroups, flatTrees };
 }
 /** Build the synthetic dashboard row for the main repo checkout — the
  * non-worktree clone that the user typically commits master/main from.

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

@@ -72,8 +72,19 @@ export interface EnrichedReviewPR {
      * Null when the user hasn't set one or the lookup failed. */
     authorName: string | null;
 }
-export type DashboardTab = "issues" | "reviews";
-export type ActionOverlay = "mode-select" | "context-input" | "base-select" | "confirm-delete" | "confirm-setup" | "commit" | "pr-create" | "diff" | "help" | null;
+export type DashboardTab = "issues" | "trees" | "reviews";
+export type ActionOverlay = "mode-select" | "context-input" | "base-select" | "confirm-delete" | "confirm-setup" | "commit" | "pr-create" | "diff" | "help" | "tracker-select" | "issue-form" | "confirm-delete-issue" | null;
+/** Tracker-selection overlay sub-phase: pick a tracker, then (for Linear with
+ * multiple authenticated workspaces) pick the org. */
+export type TrackerSelectPhase = "root" | "linear-org";
+/** Issue create/edit form sub-phase. Title and description are captured in
+ * two sequential MultilineTextArea steps (reusing the context-input pattern);
+ * "saving" blocks input while the tracker writes the file. */
+export type IssueFormPhase = "title" | "description" | "saving";
+export interface TrackerOrgOption {
+    slug: string;
+    name: string;
+}
 export type DiffFileStatus = "M" | "A" | "D" | "R" | "C" | "U" | "?";
 export interface DiffFile {
     path: string;
@@ -96,6 +107,21 @@ export interface DashboardState {
     reviewSelectedIndex: number;
     reviewListScrollOffset: number;
     reviewDetailScrollOffset: number;
+    treeGroups: ProjectGroup[];
+    flatTrees: DashboardIssue[];
+    treeSelectedIndex: number;
+    treeListScrollOffset: number;
+    treeDetailScrollOffset: number;
+    trackerSelectPhase: TrackerSelectPhase;
+    trackerSelectIndex: number;
+    trackerSelectOrgs: TrackerOrgOption[];
+    trackerSelectMessage: string | null;
+    issueFormMode: "create" | "edit" | null;
+    issueFormPhase: IssueFormPhase;
+    issueFormId: string | null;
+    issueFormTitle: string;
+    issueFormDescription: string;
+    issueFormError: string | null;
     loading: boolean;
     refreshing: boolean;
     error: string | null;
@@ -120,6 +146,7 @@ export interface DashboardState {
     prCreateUrl: string | null;
     prCreateBody: string | null;
     prCreateTitle: string | null;
+    prCreateDraft: boolean;
     setupMode: "plan" | "implement" | null;
     baseSelectOptions: string[];
     baseSelectIndex: number;
@@ -154,9 +181,58 @@ export type DashboardAction = {
     type: "SET_DATA";
     groups: ProjectGroup[];
     flatIssues: DashboardIssue[];
+    treeGroups: ProjectGroup[];
+    flatTrees: DashboardIssue[];
 } | {
     type: "SELECT";
     index: number;
+} | {
+    type: "TREE_SELECT";
+    index: number;
+} | {
+    type: "TREE_SCROLL_LIST";
+    offset: number;
+} | {
+    type: "TREE_SCROLL_DETAIL";
+    offset: number;
+} | {
+    type: "TRACKER_SELECT_OPEN";
+} | {
+    type: "TRACKER_SELECT_MOVE";
+    index: number;
+} | {
+    type: "TRACKER_SELECT_PHASE";
+    phase: TrackerSelectPhase;
+    orgs?: TrackerOrgOption[];
+} | {
+    type: "TRACKER_SELECT_MESSAGE";
+    message: string | null;
+} | {
+    type: "TRACKER_SELECT_CLOSE";
+} | {
+    type: "ISSUE_FORM_OPEN";
+    mode: "create" | "edit";
+    id: string | null;
+    title: string;
+    description: string;
+} | {
+    type: "ISSUE_FORM_PHASE";
+    phase: IssueFormPhase;
+} | {
+    type: "ISSUE_FORM_TITLE";
+    title: string;
+} | {
+    type: "ISSUE_FORM_DESC";
+    description: string;
+} | {
+    type: "ISSUE_FORM_ERROR";
+    error: string;
+} | {
+    type: "ISSUE_FORM_CLOSE";
+} | {
+    type: "ISSUE_DELETE_OPEN";
+} | {
+    type: "ISSUE_DELETE_CLOSE";
 } | {
     type: "SCROLL_LIST";
     offset: number;
@@ -237,6 +313,8 @@ export type DashboardAction = {
     type: "PR_CREATE_CONFIRM";
 } | {
     type: "PR_CREATE_EDIT";
+} | {
+    type: "PR_CREATE_TOGGLE_DRAFT";
 } | {
     type: "PR_CREATE_DONE";
     url: string;