santree 0.7.3 → 0.7.5

package/dist/commands/dashboard.js

@@ -10,7 +10,9 @@ const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 import { findMainRepoRoot, createWorktree, getDefaultBranch, getBaseBranch, hasInitScript, getInitScriptPath, removeWorktree, getDiffTool, getWorktreeStatus, stageFile, unstageFile, stageAll, unstageAll, discardFile, } from "../lib/git.js";
 import { run, spawnAsync } from "../lib/exec.js";
-import { resolveAgentBinary, fillCommitMessage, askTicketQuestion } from "../lib/ai.js";
+import { printCdHint } from "../lib/cd-hint.js";
+import { resolveAgentBinary, resolveClaudeBinary, fillCommitMessage, askTicketQuestion, } from "../lib/ai.js";
+import { readTriageInvestigateConfig, isTriageInvestigateConfigured, buildInvestigatePrompt, buildInvestigateCommand, } from "../lib/triage-config.js";
 import { getInstalledClaudeVersion } from "../lib/version.js";
 import { extractTicketId, getStagedDiffContent } from "../lib/git.js";
 import { getMultiplexer } from "../lib/multiplexer/index.js";
@@ -325,6 +327,11 @@ export default function Dashboard() {
     // Triage tab appears at all. Recomputed on every data refresh — feature
     // detection via `tracker.supportsTriage`, never a kind check.
     const [supportsTriage, setSupportsTriage] = useState(false);
+    // Whether `.santree/metadata.json` configures an "investigate triage ticket"
+    // skill/prompt (`_triage.skill_name` / `_triage.prompt`). Drives whether the
+    // Triage `[i]` action renders enabled (cyan) or greyed. Read fresh on every
+    // data refresh so manual edits to metadata.json show up within a cycle.
+    const [triageInvestigateConfigured, setTriageInvestigateConfigured] = useState(false);
     const refreshTimerRef = useRef(null);
     const repoRootRef = useRef(null);
     const stateRef = useRef(state);
@@ -440,6 +447,7 @@ export default function Dashboard() {
             setHasWorkspaceFile(hasWs);
             const tracker = getIssueTracker(repoRoot);
             setSupportsTriage(tracker.supportsTriage === true);
+            setTriageInvestigateConfigured(isTriageInvestigateConfigured(readTriageInvestigateConfig(repoRoot)));
             dispatch({ type: "SET_DATA", ...data });
             dispatch({ type: "SET_REVIEWS_DATA", flatReviews: reviewData.flatReviews });
             // Triage on-call rotations (Linear). Best-effort, non-blocking — never
@@ -1042,7 +1050,9 @@ export default function Dashboard() {
             ? `cd ${shellEscape(sessionCwd)} && ${bin} --resume ${sessionId}`
             : null;
         const contextArg = contextFile ? ` --context-file "${contextFile}"` : "";
-        const workCmd = mode === "plan" ? `st worktree work --plan${contextArg}` : `st worktree work${contextArg}`;
+        const workCmd = mode === "plan"
+            ? `santree worktree work --plan${contextArg}`
+            : `santree worktree work${contextArg}`;
         const cmd = resumeCmd ?? workCmd;
         const mux = getMultiplexer();
         const selected = await mux.selectWindow(windowName);
@@ -1084,7 +1094,7 @@ export default function Dashboard() {
                 });
             }
         }
-        // Delayed refresh to pick up session ID created by `st worktree work`
+        // Delayed refresh to pick up session ID created by `santree worktree work`
         setTimeout(() => refresh(), 3000);
     }, [refresh]);
     const launchAfterCreation = useCallback(async (mode, worktreePath, ticketId, contextFile) => {
@@ -1093,8 +1103,8 @@ export default function Dashboard() {
             const windowName = ticketId;
             const contextArg = contextFile ? ` --context-file "${contextFile}"` : "";
             const workCmd = mode === "plan"
-                ? `st worktree work --plan${contextArg}`
-                : `st worktree work${contextArg}`;
+                ? `santree worktree work --plan${contextArg}`
+                : `santree worktree work${contextArg}`;
             const created = await mux.createWindow({
                 name: windowName,
                 cwd: worktreePath,
@@ -1116,10 +1126,10 @@ export default function Dashboard() {
         }
         else {
             leaveAltScreen();
-            console.log(`SANTREE_CD:${worktreePath}`);
-            console.log(`SANTREE_WORK:${mode}`);
-            if (contextFile)
-                console.log(`SANTREE_WORK_CONTEXT:${contextFile}`);
+            printCdHint({
+                path: worktreePath,
+                work: { mode, contextFile: contextFile || undefined },
+            });
             exit();
         }
     }, [exit, refresh]);
@@ -1270,10 +1280,10 @@ export default function Dashboard() {
             }
             else {
                 leaveAltScreen();
-                console.log(`SANTREE_CD:${di.worktree.path}`);
-                console.log(`SANTREE_WORK:${mode}`);
-                if (contextFile)
-                    console.log(`SANTREE_WORK_CONTEXT:${contextFile}`);
+                printCdHint({
+                    path: di.worktree.path,
+                    work: { mode, contextFile: contextFile || undefined },
+                });
                 exit();
             }
         }
@@ -2565,7 +2575,7 @@ export default function Dashboard() {
                         const created = await mux.createWindow({
                             name: windowName,
                             cwd,
-                            command: "st pr review",
+                            command: "santree pr review",
                         });
                         dispatch({
                             type: "SET_ACTION_MESSAGE",
@@ -2577,7 +2587,7 @@ export default function Dashboard() {
                 }
                 else {
                     leaveAltScreen();
-                    console.log(`SANTREE_CD:${ri.worktree.path}`);
+                    printCdHint({ path: ri.worktree.path });
                     exit();
                 }
                 return;
@@ -2658,6 +2668,43 @@ export default function Dashboard() {
                 dispatch({ type: "TRIAGE_ASK_OPEN", ticketId: di.issue.identifier });
                 return;
             }
+            // Investigate — hand the ticket to a user-configured skill/prompt in a
+            // new multiplexer window. Config lives in `.santree/metadata.json`
+            // (`_triage.skill_name` or `_triage.prompt`); read fresh so manual
+            // edits take effect without waiting for a refresh.
+            if (input === "i") {
+                const root = repoRootRef.current;
+                if (!root)
+                    return;
+                const prompt = buildInvestigatePrompt(readTriageInvestigateConfig(root), di.issue.identifier);
+                if (!prompt) {
+                    dispatch({
+                        type: "SET_ACTION_MESSAGE",
+                        message: "Set _triage.skill_name (or _triage.prompt) in .santree/metadata.json to enable investigate",
+                    });
+                    return;
+                }
+                const mux = getMultiplexer();
+                if (!mux.isActive()) {
+                    dispatch({
+                        type: "SET_ACTION_MESSAGE",
+                        message: "Investigate needs a multiplexer (tmux or cmux)",
+                    });
+                    return;
+                }
+                const command = buildInvestigateCommand(resolveClaudeBinary() ?? "claude", prompt);
+                const windowName = `investigate-${di.issue.identifier}`;
+                void (async () => {
+                    const created = await mux.createWindow({ name: windowName, cwd: root, command });
+                    dispatch({
+                        type: "SET_ACTION_MESSAGE",
+                        message: created.ok
+                            ? "Launched investigation in new window"
+                            : `Failed to launch investigation${created.message ? `: ${created.message}` : ""}`,
+                    });
+                })();
+                return;
+            }
             if (input === "o") {
                 if (!di.issue.url) {
                     dispatch({ type: "SET_ACTION_MESSAGE", message: "No issue URL available" });
@@ -2805,7 +2852,7 @@ export default function Dashboard() {
                     const selected = await mux.selectWindow(windowName);
                     if (selected.ok)
                         return;
-                    const cmd = resumeCmd ?? "st worktree work";
+                    const cmd = resumeCmd ?? "santree worktree work";
                     const created = await mux.createWindow({
                         name: windowName,
                         cwd: worktreePath,
@@ -2821,7 +2868,7 @@ export default function Dashboard() {
             }
             else {
                 leaveAltScreen();
-                console.log(`SANTREE_CD:${di.worktree.path}`);
+                printCdHint({ path: di.worktree.path });
                 exit();
             }
             return;
@@ -2880,7 +2927,7 @@ export default function Dashboard() {
                     const created = await mux.createWindow({
                         name: windowName,
                         cwd,
-                        command: "st pr review",
+                        command: "santree pr review",
                     });
                     dispatch({
                         type: "SET_ACTION_MESSAGE",
@@ -2892,7 +2939,7 @@ export default function Dashboard() {
             }
             else {
                 leaveAltScreen();
-                console.log(`SANTREE_CD:${di.worktree.path}`);
+                printCdHint({ path: di.worktree.path });
                 exit();
             }
             return;
@@ -2949,7 +2996,7 @@ export default function Dashboard() {
                     const created = await mux.createWindow({
                         name: windowName,
                         cwd,
-                        command: "st pr fix",
+                        command: "santree pr fix",
                     });
                     dispatch({
                         type: "SET_ACTION_MESSAGE",
@@ -2961,7 +3008,7 @@ export default function Dashboard() {
             }
             else {
                 leaveAltScreen();
-                console.log(`SANTREE_CD:${di.worktree.path}`);
+                printCdHint({ path: di.worktree.path });
                 exit();
             }
             return;
@@ -3008,7 +3055,7 @@ export default function Dashboard() {
     });
     // ── Render ─────────────────────────────────────────────────────────
     if (state.loading) {
-        return (_jsx(Box, { width: columns, height: rows, flexDirection: "column", children: _jsx(Box, { justifyContent: "center", alignItems: "center", flexGrow: 1, children: _jsx(SquirrelLoader, { text: "Loading dashboard..." }) }) }));
+        return (_jsx(Box, { width: columns, height: rows, flexDirection: "column", children: _jsx(Box, { justifyContent: "center", alignItems: "center", flexGrow: 1, children: _jsx(SquirrelLoader, { text: "Loading dashboard...", version: version }) }) }));
     }
     if (state.error) {
         return (_jsx(Box, { width: columns, height: rows, flexDirection: "column", children: _jsxs(Box, { justifyContent: "center", alignItems: "center", flexGrow: 1, flexDirection: "column", children: [_jsxs(Text, { color: "red", bold: true, children: ["Error: ", state.error] }), _jsx(Text, { dimColor: true, children: "Press R to retry or q to quit" })] }) }));
@@ -3108,14 +3155,14 @@ export default function Dashboard() {
                                         ? state.treeDetailScrollOffset
                                         : state.activeTab === "triage"
                                             ? state.triageDetailScrollOffset
-                                            : state.detailScrollOffset, height: contentHeight, width: rightWidth, creatingForTicket: state.creatingForTicket, creationLogs: state.creationLogs, deleteStatus: selectedDeleteStatus, triage: state.activeTab === "triage", comments: triageComments, onCall: onCall })) })] })), _jsx(Box, { children: state.overlay === "diff" ? (_jsx(Box, { width: innerWidth, paddingX: 1, children: _jsx(CommandBar, { showWorkspace: hasWorkspaceFile, mode: "diff" }) })) : state.overlay === "triage-schedule" ? (_jsx(Box, { width: innerWidth, paddingX: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " scroll" }), _jsx(Text, { dimColor: true, children: "  ·  " }), _jsx(Text, { color: "cyan", bold: true, children: "q" }), _jsx(Text, { dimColor: true, children: " close" })] }) })) : (_jsxs(_Fragment, { children: [_jsx(Box, { width: leftWidth + separatorWidth, paddingX: 1, children: _jsx(CommandBar, { showWorkspace: hasWorkspaceFile, mode: "default" }) }), _jsx(Box, { width: rightWidth, children: _jsx(ActionRow, { activeTab: state.activeTab, selectedIssue: selectedIssue, selectedReview: selectedReview, overlay: state.overlay, trackerName: activeTracker.displayName, canMutate: activeTracker.canMutate === true }) })] })) })] })] }));
+                                            : state.detailScrollOffset, height: contentHeight, width: rightWidth, creatingForTicket: state.creatingForTicket, creationLogs: state.creationLogs, deleteStatus: selectedDeleteStatus, prSyncing: !!selectedIssue && !!state.pendingPrs[selectedIssue.issue.identifier], triage: state.activeTab === "triage", comments: triageComments, onCall: onCall })) })] })), _jsx(Box, { children: state.overlay === "diff" ? (_jsx(Box, { width: innerWidth, paddingX: 1, children: _jsx(CommandBar, { showWorkspace: hasWorkspaceFile, mode: "diff" }) })) : state.overlay === "triage-schedule" ? (_jsx(Box, { width: innerWidth, paddingX: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " scroll" }), _jsx(Text, { dimColor: true, children: "  ·  " }), _jsx(Text, { color: "cyan", bold: true, children: "q" }), _jsx(Text, { dimColor: true, children: " close" })] }) })) : (_jsxs(_Fragment, { children: [_jsx(Box, { width: leftWidth + separatorWidth, paddingX: 1, children: _jsx(CommandBar, { showWorkspace: hasWorkspaceFile, mode: "default" }) }), _jsx(Box, { width: rightWidth, children: _jsx(ActionRow, { activeTab: state.activeTab, selectedIssue: selectedIssue, selectedReview: selectedReview, overlay: state.overlay, trackerName: activeTracker.displayName, canMutate: activeTracker.canMutate === true, triageInvestigateConfigured: triageInvestigateConfigured }) })] })) })] })] }));
 }
 /**
  * Renders the per-issue action key hints (Resume / Editor / View diff / …)
  * lifted out of the detail panels so they sit on the same row as the global
  * command bar. Empty when nothing is selected.
  */
-function ActionRow({ activeTab, selectedIssue, selectedReview, overlay, trackerName, canMutate, }) {
+function ActionRow({ activeTab, selectedIssue, selectedReview, overlay, trackerName, canMutate, triageInvestigateConfigured, }) {
     // During the diff overlay, none of the per-issue actions apply (View diff
     // is what got us here, Commit/PR/etc. need the detail panel context). Keep
     // the row blank so the diff-specific CommandBar reads cleanly.
@@ -3126,7 +3173,11 @@ function ActionRow({ activeTab, selectedIssue, selectedReview, overlay, trackerN
             ? buildReviewActions(selectedReview)
             : []
         : selectedIssue
-            ? buildIssueActions(selectedIssue, trackerName, { tab: activeTab, canMutate })
+            ? buildIssueActions(selectedIssue, trackerName, {
+                tab: activeTab,
+                canMutate,
+                triageInvestigateConfigured,
+            })
             : [];
     if (items.length === 0)
         return _jsx(Text, { children: " " });

package/dist/commands/doctor.js

@@ -13,6 +13,7 @@ import { findMainRepoRoot, getSantreeDir, getInitScriptPath } from "../lib/git.j
 import { getIssueTracker } from "../lib/trackers/index.js";
 import { getMultiplexer } from "../lib/multiplexer/index.js";
 import { resolveClaudeBinary } from "../lib/ai.js";
+import { isStatuslineConfigured, getStatuslineCommand, isRemoteControlEnabled, missingSessionSignalHooks, } from "../lib/claude-config.js";
 import { CURRENT_VERSION, CLAUDE_CODE_PACKAGE, SANTREE_PACKAGE, getLatestVersionFor, isUpdateAvailable, detectPackageManager, getInstallCommandFor, } from "../lib/version.js";
 const execAsync = promisify(exec);
 export const description = "Check system requirements and integrations";
@@ -214,16 +215,6 @@ async function checkTrackerAuth() {
         hint: status.hint,
     };
 }
-/**
- * Checks if the shell integration is set up by looking for the
- * SANTREE_SHELL_INTEGRATION environment variable exported by the shell scripts.
- */
-function checkShellIntegration() {
-    const shell = process.env.SHELL || "";
-    const shellName = shell.includes("zsh") ? "zsh" : shell.includes("bash") ? "bash" : null;
-    const configured = process.env.SANTREE_SHELL_INTEGRATION === "1";
-    return { configured, shell: shellName };
-}
 /**
  * Checks if Claude Code Remote Control is enabled for all sessions.
  * Remote Control lets you continue local sessions from any device.
@@ -233,23 +224,12 @@ function checkShellIntegration() {
  * See: https://code.claude.com/docs/en/settings#settings-files
  */
 function checkRemoteControl() {
-    const home = process.env.HOME || "";
-    const configPath = path.join(home, ".claude.json");
-    try {
-        if (fs.existsSync(configPath)) {
-            const content = fs.readFileSync(configPath, "utf-8");
-            const config = JSON.parse(content);
-            if (config.remoteControlAtStartup === true) {
-                return { enabled: true };
-            }
-        }
-    }
-    catch {
-        // JSON parse error or file read error
+    if (isRemoteControlEnabled()) {
+        return { enabled: true };
     }
     return {
         enabled: false,
-        hint: 'Run /config in Claude Code and enable "Enable Remote Control for all sessions"',
+        hint: 'Run `santree setup` (or /config in Claude Code → "Enable Remote Control for all sessions")',
     };
 }
 /**
@@ -257,30 +237,12 @@ function checkRemoteControl() {
  * If ~/.claude/settings.json has statusLine pointing to santree
  */
 async function checkStatusline() {
-    const home = process.env.HOME || "";
-    const claudeSettingsPath = path.join(home, ".claude", "settings.json");
-    let claudeSettingsConfigured = false;
-    let currentCommand;
-    try {
-        if (fs.existsSync(claudeSettingsPath)) {
-            const content = fs.readFileSync(claudeSettingsPath, "utf-8");
-            const settings = JSON.parse(content);
-            if (settings.statusLine?.command) {
-                currentCommand = String(settings.statusLine.command);
-                // Check if it points to santree statusline
-                claudeSettingsConfigured =
-                    currentCommand.includes("santree statusline") ||
-                        currentCommand.includes("santree helpers statusline");
-            }
-        }
-    }
-    catch {
-        // JSON parse error or file read error
-    }
+    const claudeSettingsConfigured = isStatuslineConfigured();
+    const currentCommand = getStatuslineCommand();
     let hint;
     if (!claudeSettingsConfigured) {
         hint =
-            'Add to ~/.claude/settings.json: "statusLine": { "type": "command", "command": "santree helpers statusline" }';
+            'Run `santree setup`, or add to ~/.claude/settings.json: "statusLine": { "type": "command", "command": "santree helpers statusline" }';
     }
     return {
         claudeSettingsConfigured,
@@ -294,44 +256,14 @@ async function checkStatusline() {
  * that run "santree helpers session-signal".
  */
 function checkSessionSignalHooks() {
-    const home = process.env.HOME || "";
-    const claudeSettingsPath = path.join(home, ".claude", "settings.json");
-    const requiredEvents = ["Notification", "Stop", "UserPromptSubmit", "SessionEnd"];
-    const missingHooks = [];
-    try {
-        if (fs.existsSync(claudeSettingsPath)) {
-            const content = fs.readFileSync(claudeSettingsPath, "utf-8");
-            const settings = JSON.parse(content);
-            const hooks = settings.hooks || {};
-            for (const event of requiredEvents) {
-                const eventHooks = hooks[event];
-                if (!Array.isArray(eventHooks)) {
-                    missingHooks.push(event);
-                    continue;
-                }
-                // Check if any hook entry has a nested hook command containing session-signal
-                const found = eventHooks.some((entry) => {
-                    const innerHooks = entry.hooks || [];
-                    return innerHooks.some((h) => typeof h.command === "string" && h.command.includes("session-signal"));
-                });
-                if (!found)
-                    missingHooks.push(event);
-            }
-        }
-        else {
-            missingHooks.push(...requiredEvents);
-        }
-    }
-    catch {
-        missingHooks.push(...requiredEvents);
-    }
+    const missingHooks = missingSessionSignalHooks();
     if (missingHooks.length === 0) {
         return { configured: true, missingHooks: [] };
     }
     return {
         configured: false,
         missingHooks,
-        hint: `Missing: ${missingHooks.join(", ")}. Run: santree helpers session-signal install`,
+        hint: `Missing: ${missingHooks.join(", ")}. Run: santree setup (or santree helpers session-signal install)`,
     };
 }
 /**
@@ -470,9 +402,6 @@ function TrackerRow({ tracker }) {
     const isOk = tracker.authenticated && !tracker.hint;
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: isOk, required: true }), _jsx(Text, { children: " " }), _jsxs(Text, { bold: true, children: [tracker.displayName, " API"] }), _jsx(Text, { dimColor: true, children: " - Issue tracker integration" })] }), tracker.authenticated ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [tracker.accountLabel && _jsxs(Text, { dimColor: true, children: ["Account: ", tracker.accountLabel] }), tracker.repoLinked !== undefined && (_jsxs(Text, { dimColor: true, children: ["Repo linked: ", tracker.repoLinked ? "yes" : "no"] })), tracker.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tracker.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tracker.hint] }) }))] }));
 }
-function ShellRow({ configured, shell }) {
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: configured, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Shell Integration" }), _jsx(Text, { dimColor: true, children: " - Enables directory switching" })] }), configured ? (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { dimColor: true, children: ["Shell: ", shell] }) })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 Add to .", shell, "rc: eval \"$(santree helpers shell-init ", shell, ")\""] }) }))] }));
-}
 function StatuslineRow({ status }) {
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.claudeSettingsConfigured, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Claude Statusline" }), _jsx(Text, { dimColor: true, children: " - Custom statusline in Claude Code" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [status.currentCommand ? (_jsxs(Text, { dimColor: true, children: ["Command: ", status.currentCommand] })) : (_jsx(Text, { dimColor: true, children: "Command: not configured" })), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })] }));
 }
@@ -508,7 +437,6 @@ function SantreeSetupRow({ status }) {
 export default function Doctor() {
     const [tools, setTools] = useState([]);
     const [tracker, setTracker] = useState(null);
-    const [shellStatus, setShellStatus] = useState(null);
     const [remoteControl, setRemoteControl] = useState(null);
     const [statusline, setStatusline] = useState(null);
     const [sessionSignal, setSessionSignal] = useState(null);
@@ -559,7 +487,7 @@ export default function Doctor() {
                     }
                 }
             }
-            // Optional: a syntax-highlighting diff pager — used by `st worktree diff`
+            // Optional: a syntax-highlighting diff pager — used by `santree worktree diff`
             // and the dashboard `v` overlay when SANTREE_DIFF_TOOL is set. Any
             // diff pager works (delta, diff-so-fancy, …); without one set, the
             // dashboard renders inline with santree's own colorizer and the CLI
@@ -597,7 +525,6 @@ export default function Doctor() {
             const statuslineResult = await checkStatusline();
             setTools(results);
             setTracker(trackerResult);
-            setShellStatus(checkShellIntegration());
             setRemoteControl(checkRemoteControl());
             setStatusline(statuslineResult);
             setSessionSignal(checkSessionSignalHooks());
@@ -613,6 +540,6 @@ export default function Doctor() {
     const requiredMissing = tools.filter((t) => t.required && (!t.installed || t.hint));
     const optionalMissing = tools.filter((t) => !t.required && !t.installed);
     const trackerOk = tracker?.authenticated && !tracker?.hint;
-    const allRequired = requiredMissing.length === 0 && trackerOk && shellStatus?.configured;
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Santree Doctor" }), _jsxs(Text, { dimColor: true, children: [" v", version] })] }), _jsx(Box, { marginBottom: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "CLI Tools" }) }), tools.map((tool) => (_jsx(ToolRow, { tool: tool }, tool.name))), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Integrations" }) }), tracker && _jsx(TrackerRow, { tracker: tracker }), shellStatus && _jsx(ShellRow, { configured: shellStatus.configured, shell: shellStatus.shell }), santreeSetup && _jsx(SantreeSetupRow, { status: santreeSetup }), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Claude Code" }) }), remoteControl && _jsx(RemoteControlRow, { status: remoteControl }), statusline && _jsx(StatuslineRow, { status: statusline }), sessionSignal && _jsx(SessionSignalRow, { status: sessionSignal }), englishTutor && _jsx(EnglishTutorRow, { status: englishTutor }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: allRequired ? "green" : "yellow", paddingX: 2, children: allRequired ? (_jsx(Text, { color: "green", children: "All requirements satisfied! Santree is ready to use." })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: [requiredMissing.length + (trackerOk ? 0 : 1) + (shellStatus?.configured ? 0 : 1), " ", "required item(s) need attention"] }), optionalMissing.length > 0 && (_jsxs(Text, { dimColor: true, children: [optionalMissing.length, " optional item(s) not installed"] }))] })) })] }));
+    const allRequired = requiredMissing.length === 0 && trackerOk;
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Santree Doctor" }), _jsxs(Text, { dimColor: true, children: [" v", version] })] }), _jsx(Box, { marginBottom: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "CLI Tools" }) }), tools.map((tool) => (_jsx(ToolRow, { tool: tool }, tool.name))), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Integrations" }) }), tracker && _jsx(TrackerRow, { tracker: tracker }), santreeSetup && _jsx(SantreeSetupRow, { status: santreeSetup }), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Claude Code" }) }), remoteControl && _jsx(RemoteControlRow, { status: remoteControl }), statusline && _jsx(StatuslineRow, { status: statusline }), sessionSignal && _jsx(SessionSignalRow, { status: sessionSignal }), englishTutor && _jsx(EnglishTutorRow, { status: englishTutor }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: allRequired ? "green" : "yellow", paddingX: 2, children: allRequired ? (_jsx(Text, { color: "green", children: "All requirements satisfied! Santree is ready to use." })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: [requiredMissing.length + (trackerOk ? 0 : 1), " required item(s) need attention"] }), optionalMissing.length > 0 && (_jsxs(Text, { dimColor: true, children: [optionalMissing.length, " optional item(s) not installed"] }))] })) })] }));
 }

package/dist/commands/setup.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const description = "Guided setup \u2014 configure editor, diff tool, Claude Code & this repo";
+export declare const options: z.ZodObject<{
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    yes: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type Props = {
+    options: z.infer<typeof options>;
+};
+export default function Setup({ options: opts }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/commands/setup.js

@@ -0,0 +1,194 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text, useInput } from "ink";
+import Spinner from "ink-spinner";
+import { z } from "zod";
+import { buildContext, buildSteps, } from "../lib/setup/steps.js";
+export const description = "Guided setup — configure editor, diff tool, Claude Code & this repo";
+export const options = z.object({
+    dryRun: z.boolean().default(false).describe("Preview what would change without writing anything"),
+    yes: z.boolean().default(false).describe("Apply all recommended steps non-interactively"),
+});
+export default function Setup({ options: opts }) {
+    const dryRun = opts.dryRun;
+    const [phase, setPhase] = useState("detecting");
+    const [steps, setSteps] = useState([]);
+    const [ctx, setCtx] = useState(null);
+    // select phase
+    const [cursor, setCursor] = useState(0);
+    const [selected, setSelected] = useState(new Set());
+    // configure phase
+    const [configQueue, setConfigQueue] = useState([]);
+    const [configPos, setConfigPos] = useState(0);
+    const [optionCursor, setOptionCursor] = useState(0);
+    const [choices, setChoices] = useState({});
+    // applying phase
+    const [applyIdx, setApplyIdx] = useState(0);
+    const [applyOrder, setApplyOrder] = useState([]);
+    const [applied, setApplied] = useState([]);
+    const [running, setRunning] = useState(null);
+    // ── Detect ────────────────────────────────────────────────────────────────
+    useEffect(() => {
+        (async () => {
+            await new Promise((r) => setTimeout(r, 80)); // let the spinner paint first
+            const c = buildContext(dryRun);
+            const all = buildSteps(c).filter((s) => s.detect === "actionable");
+            setCtx(c);
+            setSteps(all);
+            if (all.length === 0) {
+                setPhase("done");
+                return;
+            }
+            const rec = new Set();
+            all.forEach((s, i) => {
+                if (s.recommended)
+                    rec.add(i);
+            });
+            setSelected(rec);
+            if (opts.yes) {
+                beginApply(all, rec, {});
+            }
+            else {
+                setPhase("select");
+            }
+        })();
+    }, []);
+    function beginApply(allSteps, sel, picked) {
+        const order = [...sel].sort((a, b) => a - b);
+        // For steps with options that weren't interactively chosen, default to the
+        // first option (used by --yes and single-option steps).
+        const merged = { ...picked };
+        for (const i of order) {
+            const s = allSteps[i];
+            if (s.options && s.options.length > 0 && merged[s.id] === undefined) {
+                merged[s.id] = s.options[0].value;
+            }
+        }
+        setChoices(merged);
+        setApplyOrder(order);
+        setApplyIdx(0);
+        setApplied([]);
+        setPhase("applying");
+    }
+    // ── Select phase input ──────────────────────────────────────────────────────
+    useInput((input, key) => {
+        if (key.escape)
+            process.exit(0);
+        else if (key.upArrow)
+            setCursor((c) => Math.max(0, c - 1));
+        else if (key.downArrow)
+            setCursor((c) => Math.min(steps.length - 1, c + 1));
+        else if (input === " ") {
+            setSelected((s) => {
+                const next = new Set(s);
+                if (next.has(cursor))
+                    next.delete(cursor);
+                else
+                    next.add(cursor);
+                return next;
+            });
+        }
+        else if (key.return) {
+            // Steps needing an interactive choice (>1 option).
+            const queue = [...selected]
+                .sort((a, b) => a - b)
+                .filter((i) => (steps[i].options?.length ?? 0) > 1);
+            if (queue.length > 0) {
+                setConfigQueue(queue);
+                setConfigPos(0);
+                setOptionCursor(0);
+                setPhase("configure");
+            }
+            else {
+                beginApply(steps, selected, {});
+            }
+        }
+    }, { isActive: phase === "select" });
+    // ── Configure phase input ───────────────────────────────────────────────────
+    useInput((_input, key) => {
+        if (key.escape) {
+            setPhase("select");
+            return;
+        }
+        const stepIdx = configQueue[configPos];
+        const step = steps[stepIdx];
+        const optCount = step.options.length;
+        if (key.upArrow)
+            setOptionCursor((c) => Math.max(0, c - 1));
+        else if (key.downArrow)
+            setOptionCursor((c) => Math.min(optCount - 1, c + 1));
+        else if (key.return) {
+            const value = step.options[optionCursor].value;
+            const nextChoices = { ...choices, [step.id]: value };
+            setChoices(nextChoices);
+            if (configPos + 1 < configQueue.length) {
+                setConfigPos((p) => p + 1);
+                setOptionCursor(0);
+            }
+            else {
+                beginApply(steps, selected, nextChoices);
+            }
+        }
+    }, { isActive: phase === "configure" });
+    // ── Applying phase ──────────────────────────────────────────────────────────
+    useEffect(() => {
+        if (phase !== "applying")
+            return;
+        if (applyIdx >= applyOrder.length) {
+            setRunning(null);
+            setPhase("done");
+            return;
+        }
+        const step = steps[applyOrder[applyIdx]];
+        setRunning(step.title);
+        let cancelled = false;
+        (async () => {
+            await new Promise((r) => setTimeout(r, 60)); // paint "running" frame
+            let result;
+            try {
+                result = await step.apply(choices[step.id]);
+            }
+            catch (e) {
+                result = { ok: false, message: e instanceof Error ? e.message : String(e) };
+            }
+            if (cancelled)
+                return;
+            setApplied((prev) => [...prev, { step, result }]);
+            setApplyIdx((i) => i + 1);
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [phase, applyIdx]);
+    // ── Exit ────────────────────────────────────────────────────────────────────
+    useEffect(() => {
+        if (phase === "done") {
+            const t = setTimeout(() => process.exit(0), 120);
+            return () => clearTimeout(t);
+        }
+    }, [phase]);
+    // ── Render ──────────────────────────────────────────────────────────────────
+    const title = (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "santree setup" }), dryRun && _jsx(Text, { color: "yellow", children: " (dry run \u2014 nothing will be written)" })] }));
+    if (phase === "detecting") {
+        return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [title, _jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Detecting your setup\u2026" })] })] }));
+    }
+    if (phase === "done" && steps.length === 0) {
+        return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [title, _jsx(Text, { color: "green", children: "\u2713 Everything's already configured \u2014 you're all set." }), !ctx?.repoRoot && (_jsx(Text, { dimColor: true, children: "Tip: run this again inside a git repo to configure repo-specific bits." }))] }));
+    }
+    if (phase === "select") {
+        let lastScope = null;
+        return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [title, _jsx(Text, { children: "What should I set up? (Space toggles, Enter applies)" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: steps.map((s, i) => {
+                        const head = s.scope !== lastScope;
+                        lastScope = s.scope;
+                        const box = selected.has(i) ? "[x]" : "[ ]";
+                        const isCur = i === cursor;
+                        return (_jsxs(Box, { flexDirection: "column", children: [head && _jsx(Text, { dimColor: true, children: s.scope === "global" ? "Global" : "This repo" }), _jsxs(Text, { children: [_jsxs(Text, { color: isCur ? "cyan" : undefined, bold: isCur, children: [isCur ? "> " : "  ", box] }), " ", s.title, s.kind === "spawn" && _jsx(Text, { color: "yellow", children: " \u2937 runs a command" })] }), isCur && _jsx(Text, { dimColor: true, children: "      " + s.detail })] }, s.id));
+                    }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u2191/\u2193 move \u00B7 Space toggle \u00B7 Enter apply \u00B7 Esc cancel" }) })] }));
+    }
+    if (phase === "configure") {
+        const step = steps[configQueue[configPos]];
+        return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [title, _jsx(Text, { bold: true, children: step.title }), _jsx(Text, { children: step.optionPrompt || "Pick one:" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: step.options.map((o, i) => (_jsxs(Text, { children: [_jsx(Text, { color: i === optionCursor ? "cyan" : undefined, bold: i === optionCursor, children: i === optionCursor ? "> " : "  " }), o.label] }, o.value))) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["\u2191/\u2193 select \u00B7 Enter confirm", configQueue.length > 1 ? `  (${configPos + 1}/${configQueue.length})` : ""] }) })] }));
+    }
+    // applying / done
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [title, applied.map(({ step, result }, i) => (_jsxs(Text, { color: result.ok ? "green" : "red", children: [result.ok ? "✓" : "✗", " ", step.title, " ", _jsxs(Text, { dimColor: true, children: ["\u2014 ", result.message] })] }, i))), phase === "applying" && running && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", running, "\u2026"] })] })), phase === "done" && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "green", bold: true, children: "Done. Run `santree doctor` to verify." }), !dryRun && ctx?.shell && (_jsxs(Text, { dimColor: true, children: ["Restart your shell (or `source ", ctx.shell.rcPath, "`) to load the changes."] }))] }))] }));
+}