santree 0.7.4 → 0.7.5

package/dist/commands/dashboard.js

@@ -10,6 +10,7 @@ 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 { 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";
@@ -1049,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);
@@ -1091,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) => {
@@ -1100,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,
@@ -1123,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]);
@@ -1277,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();
             }
         }
@@ -2572,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",
@@ -2584,7 +2587,7 @@ export default function Dashboard() {
                 }
                 else {
                     leaveAltScreen();
-                    console.log(`SANTREE_CD:${ri.worktree.path}`);
+                    printCdHint({ path: ri.worktree.path });
                     exit();
                 }
                 return;
@@ -2849,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,
@@ -2865,7 +2868,7 @@ export default function Dashboard() {
             }
             else {
                 leaveAltScreen();
-                console.log(`SANTREE_CD:${di.worktree.path}`);
+                printCdHint({ path: di.worktree.path });
                 exit();
             }
             return;
@@ -2924,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",
@@ -2936,7 +2939,7 @@ export default function Dashboard() {
             }
             else {
                 leaveAltScreen();
-                console.log(`SANTREE_CD:${di.worktree.path}`);
+                printCdHint({ path: di.worktree.path });
                 exit();
             }
             return;
@@ -2993,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",
@@ -3005,7 +3008,7 @@ export default function Dashboard() {
             }
             else {
                 leaveAltScreen();
-                console.log(`SANTREE_CD:${di.worktree.path}`);
+                printCdHint({ path: di.worktree.path });
                 exit();
             }
             return;
@@ -3052,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" })] }) }));
@@ -3152,7 +3155,7 @@ 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, triageInvestigateConfigured: triageInvestigateConfigured }) })] })) })] })] }));
+                                            : 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 / …)

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."] }))] }))] }));
+}

package/dist/commands/worktree/create.js

@@ -6,6 +6,7 @@ import { z } from "zod";
 import * as fs from "fs";
 import { createWorktree, findMainRepoRoot, getDefaultBranch, pullLatest, hasInitScript, getInitScriptPath, extractTicketId, } from "../../lib/git.js";
 import { spawnAsync } from "../../lib/exec.js";
+import { formatCdCommand } from "../../lib/cd-hint.js";
 import { getMultiplexer } from "../../lib/multiplexer/index.js";
 export const description = "Create a new worktree from a branch";
 export const options = z.object({
@@ -36,6 +37,7 @@ export default function Create({ options, args }) {
     const [worktreePath, setWorktreePath] = useState("");
     const [baseBranch, setBaseBranch] = useState(null);
     const [muxWindowName, setMuxWindowName] = useState(null);
+    const [cdHint, setCdHint] = useState(null);
     async function finalize(path, branch) {
         const wantsWindow = options.window || options.tmux;
         if (wantsWindow) {
@@ -43,7 +45,7 @@ export default function Create({ options, args }) {
             if (!mux.isActive()) {
                 setMessage("Worktree created, but no active multiplexer");
                 setStatus("done");
-                console.log(`SANTREE_CD:${path}`);
+                setCdHint(formatCdCommand({ path }));
                 return;
             }
             setStatus("spawning-window");
@@ -52,28 +54,27 @@ export default function Create({ options, args }) {
             setMuxWindowName(windowName);
             let runCommand;
             if (options.work) {
-                runCommand = options.plan ? "st worktree work --plan" : "st worktree work";
+                runCommand = options.plan ? "santree worktree work --plan" : "santree worktree work";
             }
             const result = await mux.createWindow({ name: windowName, cwd: path, command: runCommand });
             if (!result.ok) {
                 setMessage(`Worktree created, but failed to create window${result.message ? `: ${result.message}` : ""}`);
                 setStatus("done");
-                console.log(`SANTREE_CD:${path}`);
+                setCdHint(formatCdCommand({ path }));
                 return;
             }
             setStatus("done");
             const workInfo = options.work ? (options.plan ? " + Claude (plan)" : " + Claude") : "";
             setMessage(`Worktree and window created!${workInfo}`);
-            // Don't output SANTREE_CD when a window is created — user is already in the new window
+            // No cd hint when a window is created — the user is already in the new window
             return;
         }
         setStatus("done");
         setMessage("Worktree created successfully!");
-        console.log(`SANTREE_CD:${path}`);
-        if (options.work) {
-            const mode = options.plan ? "plan" : "implement";
-            console.log(`SANTREE_WORK:${mode}`);
-        }
+        setCdHint(formatCdCommand({
+            path,
+            work: options.work ? { mode: options.plan ? "plan" : "implement" } : undefined,
+        }));
     }
     useEffect(() => {
         async function run() {
@@ -159,5 +160,5 @@ export default function Create({ options, args }) {
         status === "creating" ||
         status === "init-script" ||
         status === "spawning-window";
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83C\uDF31 Create Worktree" }) }), branchName && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : status === "done" ? "green" : "blue", paddingX: 1, width: "100%", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branchName })] }), baseBranch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "base:" }), _jsx(Text, { color: "blue", children: baseBranch })] })), options["no-pull"] && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "skip pull:" }), _jsx(Text, { color: "yellow", children: "yes" })] })), options.work && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "after:" }), _jsx(Text, { backgroundColor: "magenta", color: "white", children: options.plan ? " plan " : " work " })] })), (options.window || options.tmux) && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "window:" }), _jsx(Text, { backgroundColor: "green", color: "white", children: ` ${options.name || "auto"} ` })] }))] })), _jsxs(Box, { marginTop: 1, children: [isLoading && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", message] })] })), status === "done" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] }), _jsxs(Text, { dimColor: true, children: [" ", worktreePath] }), muxWindowName && _jsxs(Text, { dimColor: true, children: [" window: ", muxWindowName] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83C\uDF31 Create Worktree" }) }), branchName && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : status === "done" ? "green" : "blue", paddingX: 1, width: "100%", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branchName })] }), baseBranch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "base:" }), _jsx(Text, { color: "blue", children: baseBranch })] })), options["no-pull"] && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "skip pull:" }), _jsx(Text, { color: "yellow", children: "yes" })] })), options.work && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "after:" }), _jsx(Text, { backgroundColor: "magenta", color: "white", children: options.plan ? " plan " : " work " })] })), (options.window || options.tmux) && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "window:" }), _jsx(Text, { backgroundColor: "green", color: "white", children: ` ${options.name || "auto"} ` })] }))] })), _jsxs(Box, { marginTop: 1, children: [isLoading && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", message] })] })), status === "done" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] }), _jsxs(Text, { dimColor: true, children: [" ", worktreePath] }), muxWindowName && _jsxs(Text, { dimColor: true, children: [" window: ", muxWindowName] }), cdHint && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "\u2192 Run this to enter the worktree:" }), _jsxs(Text, { color: "cyan", children: [" ", cdHint] })] }))] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] })] }));
 }