santree 0.7.5 → 0.7.7

package/dist/commands/doctor.js

@@ -1,545 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Box, Text } from "ink";
-import { useEffect, useState } from "react";
-import SquirrelLoader from "../lib/squirrel-loader.js";
-import { exec, execSync } from "child_process";
-import { promisify } from "util";
-import { createRequire } from "module";
-import * as fs from "fs";
-import * as path from "path";
-const require = createRequire(import.meta.url);
-const { version } = require("../../package.json");
-import { findMainRepoRoot, getSantreeDir, getInitScriptPath } from "../lib/git.js";
-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";
-/**
- * Executes a command asynchronously and returns the output, or null if it fails.
- */
-async function tryExec(command) {
-    try {
-        const { stdout } = await execAsync(command);
-        return stdout.trim();
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Gets the path of a command using `which`.
- */
-async function getPath(command) {
-    return tryExec(`which ${command}`);
-}
-/**
- * Checks if a tool is installed and gets its version.
- */
-async function checkTool(name, description, required, versionCommand, hint) {
-    const path = await getPath(name);
-    if (!path) {
-        return {
-            name,
-            description,
-            required,
-            installed: false,
-            hint,
-        };
-    }
-    const version = await tryExec(versionCommand);
-    return {
-        name,
-        description,
-        required,
-        installed: true,
-        version: version || "unknown",
-        path,
-    };
-}
-/**
- * Reports the active multiplexer (tmux/cmux/none) and verifies the underlying
- * binary is reachable. Detection is auto — each adapter's `isActive()` checks
- * its own runtime env (`$TMUX`, `$CMUX_SURFACE_ID`).
- */
-async function checkMultiplexer() {
-    const mux = getMultiplexer();
-    const description = `Multiplexer (active: ${mux.kind})`;
-    if (mux.kind === "none") {
-        return {
-            name: "multiplexer",
-            description,
-            required: false,
-            installed: false,
-            hint: "Run inside tmux or cmux to enable session window renaming. Install tmux: brew install tmux",
-        };
-    }
-    if (mux.kind === "tmux") {
-        const path = await getPath("tmux");
-        if (!path) {
-            return {
-                name: "tmux",
-                description,
-                required: false,
-                installed: false,
-                hint: "Install: brew install tmux",
-            };
-        }
-        const version = await tryExec("tmux -V");
-        return {
-            name: "tmux",
-            description,
-            required: false,
-            installed: true,
-            version: version || "unknown",
-            path,
-        };
-    }
-    // cmux
-    const path = await getPath("cmux");
-    if (!path) {
-        return {
-            name: "cmux",
-            description,
-            required: false,
-            installed: false,
-            hint: "Install cmux.app from https://cmux.com (cmux is macOS-only).",
-        };
-    }
-    const version = await tryExec("cmux --version 2>/dev/null");
-    const ping = await tryExec("cmux ping 2>/dev/null");
-    // Note: cmux #1472 (programmatic workspaces with dead PTYs) is a real
-    // limitation but only surfaces when a specific dashboard flow tries to
-    // auto-execute a command in a freshly-created workspace. Showing it on
-    // every doctor run made cmux look broken when it isn't — the limitation
-    // is documented in CLAUDE.md and the README. We only flag a hint here
-    // when cmux is actually unreachable.
-    return {
-        name: "cmux",
-        description,
-        required: false,
-        installed: !!ping,
-        version: version || "unknown",
-        path,
-        hint: !ping ? "cmux app not reachable — open cmux.app." : undefined,
-    };
-}
-/**
- * Checks the Claude CLI, preferring cmux's bundled binary when running inside
- * cmux. The standard `checkTool` uses `which claude` which can't locate the
- * cmux shim at /Applications/cmux.app/Contents/Resources/bin/claude — that
- * binary isn't on PATH. See manaflow-ai/cmux#2048.
- */
-async function checkClaude() {
-    const resolved = resolveClaudeBinary();
-    const usingBundled = resolved?.startsWith("/Applications/cmux.app/") ?? false;
-    const inCmux = getMultiplexer().kind === "cmux";
-    const description = usingBundled ? "Claude Code CLI (cmux-bundled)" : "Claude Code CLI";
-    if (!resolved) {
-        return {
-            name: "claude",
-            description,
-            required: true,
-            installed: false,
-            hint: inCmux
-                ? "Open cmux.app to install its bundled Claude, or install standalone: npm install -g @anthropic-ai/claude-code"
-                : "Install: npm install -g @anthropic-ai/claude-code",
-        };
-    }
-    const version = await tryExec(`"${resolved}" --version 2>/dev/null | head -1`);
-    return {
-        name: "claude",
-        description,
-        required: true,
-        installed: true,
-        version: version || "unknown",
-        path: resolved,
-    };
-}
-/**
- * Checks GitHub CLI auth status.
- * Uses `gh api user` which works across all gh versions.
- */
-async function checkGhAuth() {
-    const path = await getPath("gh");
-    if (!path) {
-        return {
-            name: "gh",
-            description: "GitHub CLI for PR operations",
-            required: true,
-            installed: false,
-            hint: "Install: brew install gh && gh auth login",
-        };
-    }
-    const version = await tryExec("gh --version | head -1");
-    const login = await tryExec("gh api user --jq .login 2>/dev/null");
-    if (!login) {
-        return {
-            name: "gh",
-            description: "GitHub CLI for PR operations",
-            required: true,
-            installed: true,
-            version: version || "unknown",
-            path,
-            hint: "Run: gh auth login",
-        };
-    }
-    return {
-        name: "gh",
-        description: "GitHub CLI for PR operations",
-        required: true,
-        installed: true,
-        version: version || "unknown",
-        path,
-        authStatus: `Authenticated as ${login}`,
-    };
-}
-/**
- * Checks the active issue tracker's auth state. The tracker (Linear, GitHub)
- * is resolved from the repo's `_tracker` config (or env / auto-detect).
- * Doctor is the one place that legitimately names the active tracker — it's
- * diagnostic context, not a generic UI string.
- */
-async function checkTrackerAuth() {
-    const repoRoot = findMainRepoRoot();
-    const tracker = getIssueTracker(repoRoot);
-    const status = await tracker.getAuthStatus(repoRoot);
-    return {
-        displayName: tracker.displayName,
-        authenticated: status.authenticated,
-        accountLabel: status.accountLabel,
-        expiresAt: status.expiresAt,
-        repoLinked: status.repoLinked,
-        hint: status.hint,
-    };
-}
-/**
- * Checks if Claude Code Remote Control is enabled for all sessions.
- * Remote Control lets you continue local sessions from any device.
- *
- * This reads from ~/.claude.json (the "global config" / application state file),
- * which is separate from ~/.claude/settings.json (the declarative settings file).
- * See: https://code.claude.com/docs/en/settings#settings-files
- */
-function checkRemoteControl() {
-    if (isRemoteControlEnabled()) {
-        return { enabled: true };
-    }
-    return {
-        enabled: false,
-        hint: 'Run `santree setup` (or /config in Claude Code → "Enable Remote Control for all sessions")',
-    };
-}
-/**
- * Checks statusline configuration:
- * If ~/.claude/settings.json has statusLine pointing to santree
- */
-async function checkStatusline() {
-    const claudeSettingsConfigured = isStatuslineConfigured();
-    const currentCommand = getStatuslineCommand();
-    let hint;
-    if (!claudeSettingsConfigured) {
-        hint =
-            'Run `santree setup`, or add to ~/.claude/settings.json: "statusLine": { "type": "command", "command": "santree helpers statusline" }';
-    }
-    return {
-        claudeSettingsConfigured,
-        currentCommand,
-        hint,
-    };
-}
-/**
- * Checks if session-signal hooks are configured in ~/.claude/settings.json.
- * Looks for hooks on Notification, Stop, UserPromptSubmit, and SessionEnd
- * that run "santree helpers session-signal".
- */
-function checkSessionSignalHooks() {
-    const missingHooks = missingSessionSignalHooks();
-    if (missingHooks.length === 0) {
-        return { configured: true, missingHooks: [] };
-    }
-    return {
-        configured: false,
-        missingHooks,
-        hint: `Missing: ${missingHooks.join(", ")}. Run: santree setup (or santree helpers session-signal install)`,
-    };
-}
-/**
- * Checks if english-tutor hooks are configured. Verifies the UserPromptSubmit
- * and SessionStart hooks plus the scoped Edit permission for the practice log.
- */
-function checkEnglishTutorHooks() {
-    const home = process.env.HOME || "";
-    const claudeSettingsPath = path.join(home, ".claude", "settings.json");
-    const requiredEvents = ["UserPromptSubmit", "SessionStart"];
-    const missingHooks = [];
-    let missingPermission = true;
-    const configDir = process.env.XDG_CONFIG_HOME || path.join(home, ".config");
-    const expectedPermission = `Edit(${path.join(configDir, "santree", "english-practice-log.md")})`;
-    try {
-        if (fs.existsSync(claudeSettingsPath)) {
-            const settings = JSON.parse(fs.readFileSync(claudeSettingsPath, "utf-8"));
-            const hooks = settings.hooks || {};
-            for (const event of requiredEvents) {
-                const eventHooks = hooks[event];
-                if (!Array.isArray(eventHooks)) {
-                    missingHooks.push(event);
-                    continue;
-                }
-                const found = eventHooks.some((entry) => {
-                    const innerHooks = entry.hooks || [];
-                    return innerHooks.some((h) => typeof h.command === "string" && h.command.includes("english-tutor"));
-                });
-                if (!found)
-                    missingHooks.push(event);
-            }
-            const allow = settings.permissions?.allow;
-            if (Array.isArray(allow) && allow.includes(expectedPermission)) {
-                missingPermission = false;
-            }
-        }
-        else {
-            missingHooks.push(...requiredEvents);
-        }
-    }
-    catch {
-        missingHooks.push(...requiredEvents);
-    }
-    if (missingHooks.length === 0 && !missingPermission) {
-        return { configured: true, missingHooks: [], missingPermission: false };
-    }
-    return {
-        configured: false,
-        missingHooks,
-        missingPermission,
-        hint: "Run: santree helpers english-tutor install",
-    };
-}
-/**
- * Checks if a path is gitignored (via .gitignore or .git/info/exclude).
- */
-function isGitIgnored(filePath, cwd) {
-    try {
-        execSync(`git check-ignore -q "${filePath}"`, { cwd, stdio: "ignore" });
-        return true; // exit 0 = ignored
-    }
-    catch {
-        return false; // exit 1 = not ignored
-    }
-}
-/**
- * Checks if the current directory is a git repo and if .santree/init.sh exists and is executable.
- */
-function checkSantreeSetup() {
-    const mainRepoRoot = findMainRepoRoot();
-    if (!mainRepoRoot) {
-        return {
-            isGitRepo: false,
-            santreeFolderExists: false,
-            initShExists: false,
-            initShExecutable: false,
-            worktreesIgnored: false,
-            metadataIgnored: false,
-            hints: ["Not in a git repository"],
-        };
-    }
-    const santreeDir = getSantreeDir(mainRepoRoot);
-    const initShPath = getInitScriptPath(mainRepoRoot);
-    const santreeFolderExists = fs.existsSync(santreeDir);
-    const initShExists = fs.existsSync(initShPath);
-    let initShExecutable = false;
-    if (initShExists) {
-        try {
-            fs.accessSync(initShPath, fs.constants.X_OK);
-            initShExecutable = true;
-        }
-        catch {
-            initShExecutable = false;
-        }
-    }
-    // Check gitignore status (use relative paths for git check-ignore)
-    const worktreesIgnored = isGitIgnored(".santree/worktrees", mainRepoRoot);
-    const metadataIgnored = isGitIgnored(".santree/metadata.json", mainRepoRoot);
-    const hints = [];
-    if (!santreeFolderExists) {
-        hints.push(`Create .santree folder: mkdir ${santreeDir}`);
-    }
-    else if (!initShExists) {
-        hints.push(`Create init.sh: touch ${initShPath} && chmod +x ${initShPath}`);
-    }
-    else if (!initShExecutable) {
-        hints.push(`Make init.sh executable: chmod +x ${initShPath}`);
-    }
-    if (!worktreesIgnored) {
-        hints.push("Add .santree/worktrees to .gitignore");
-    }
-    if (!metadataIgnored) {
-        hints.push("Add .santree/metadata.json to .gitignore");
-    }
-    return {
-        isGitRepo: true,
-        mainRepoRoot,
-        santreeFolderExists,
-        initShExists,
-        initShExecutable,
-        worktreesIgnored,
-        metadataIgnored,
-        hints,
-    };
-}
-function StatusIcon({ ok, required }) {
-    if (ok) {
-        return _jsx(Text, { color: "green", children: "\u2713" });
-    }
-    return required ? _jsx(Text, { color: "red", children: "\u2717" }) : _jsx(Text, { color: "yellow", children: "\u25CB" });
-}
-function ToolRow({ tool }) {
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: tool.installed && !tool.hint, required: tool.required }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: tool.name }), _jsxs(Text, { dimColor: true, children: [" - ", tool.description] }), !tool.required && _jsx(Text, { dimColor: true, children: " (optional)" })] }), tool.installed ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Version: ", tool.version] }), tool.latestVersion && tool.version && (_jsxs(Text, { color: isUpdateAvailable(tool.version, tool.latestVersion) ? "yellow" : undefined, dimColor: !isUpdateAvailable(tool.version, tool.latestVersion), children: ["Latest: ", tool.latestVersion, isUpdateAvailable(tool.version, tool.latestVersion) ? " ⬆ update available" : ""] })), tool.path && _jsxs(Text, { dimColor: true, children: ["Path: ", tool.path] }), tool.authStatus && _jsxs(Text, { dimColor: true, children: ["Auth: ", tool.authStatus] }), tool.updateHint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.updateHint] }), tool.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.hint] }) }))] }));
-}
-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 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] })] })] }));
-}
-function RemoteControlRow({ status }) {
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.enabled, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Remote Control" }), _jsx(Text, { dimColor: true, children: " - Continue sessions from any device" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Enabled: ", status.enabled ? "yes" : "no"] }), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })] }));
-}
-function SessionSignalRow({ status }) {
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.configured, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Session Signal Hooks" }), _jsx(Text, { dimColor: true, children: " - Surface session state in dashboard/tmux" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsx(Box, { marginLeft: 2, flexDirection: "column", children: status.configured ? (_jsx(Text, { dimColor: true, children: "All hooks configured" })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { dimColor: true, children: ["Missing: ", status.missingHooks.join(", ")] }), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })) })] }));
-}
-function EnglishTutorRow({ status }) {
-    const missingParts = [];
-    if (status.missingHooks.length > 0)
-        missingParts.push(`hooks: ${status.missingHooks.join(", ")}`);
-    if (status.missingPermission)
-        missingParts.push("log Edit permission");
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.configured, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "English Tutor Hooks" }), _jsx(Text, { dimColor: true, children: " - Inline grammar corrections" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsx(Box, { marginLeft: 2, flexDirection: "column", children: status.configured ? (_jsx(Text, { dimColor: true, children: "Hooks and log permission configured" })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { dimColor: true, children: ["Missing: ", missingParts.join("; ") || "—"] }), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })) })] }));
-}
-function SantreeSetupRow({ status }) {
-    const isOk = status.santreeFolderExists &&
-        status.initShExists &&
-        status.initShExecutable &&
-        status.worktreesIgnored &&
-        status.metadataIgnored;
-    if (!status.isGitRepo) {
-        return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: false, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Repository Setup" }), _jsx(Text, { dimColor: true, children: " - .santree configuration" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { dimColor: true, children: "Not in a git repository" }) })] }));
-    }
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: isOk, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Repository Setup" }), _jsx(Text, { dimColor: true, children: " - .santree configuration" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Main repo: ", status.mainRepoRoot] }), _jsxs(Text, { dimColor: true, children: [".santree folder: ", status.santreeFolderExists ? "exists" : "missing"] }), status.santreeFolderExists && (_jsxs(Text, { dimColor: true, children: ["init.sh:", " ", status.initShExists
-                                ? status.initShExecutable
-                                    ? "executable"
-                                    : "not executable"
-                                : "missing"] })), _jsxs(Text, { dimColor: true, children: [".santree/worktrees ignored: ", status.worktreesIgnored ? "yes" : "no"] }), _jsxs(Text, { dimColor: true, children: [".santree/metadata.json ignored: ", status.metadataIgnored ? "yes" : "no"] }), status.hints.map((hint, i) => (_jsxs(Text, { color: "yellow", children: ["\u21B3 ", hint] }, i)))] })] }));
-}
-export default function Doctor() {
-    const [tools, setTools] = useState([]);
-    const [tracker, setTracker] = useState(null);
-    const [remoteControl, setRemoteControl] = useState(null);
-    const [statusline, setStatusline] = useState(null);
-    const [sessionSignal, setSessionSignal] = useState(null);
-    const [englishTutor, setEnglishTutor] = useState(null);
-    const [santreeSetup, setSantreeSetup] = useState(null);
-    const [loading, setLoading] = useState(true);
-    useEffect(() => {
-        async function runChecks() {
-            const pm = detectPackageManager();
-            const [results, latestSantree, latestClaude] = await Promise.all([
-                Promise.all([
-                    checkTool("git", "Version control", true, "git --version | head -1", "Install: brew install git"),
-                    checkGhAuth(),
-                    checkMultiplexer(),
-                    checkClaude(),
-                ]),
-                getLatestVersionFor(SANTREE_PACKAGE),
-                getLatestVersionFor(CLAUDE_CODE_PACKAGE),
-            ]);
-            // Synthetic row for santree itself — surfaces update status.
-            const santreeRow = {
-                name: "santree",
-                description: "Santree CLI (this app)",
-                required: true,
-                installed: true,
-                version: CURRENT_VERSION,
-                latestVersion: latestSantree ?? undefined,
-                updateHint: latestSantree && isUpdateAvailable(CURRENT_VERSION, latestSantree)
-                    ? "Run: santree update"
-                    : undefined,
-            };
-            results.unshift(santreeRow);
-            // Augment the claude row with latest-version info from npm registry.
-            // When the resolved binary is the cmux-bundled one, npm install can't
-            // update it — the bundled binary is shipped inside cmux.app. Show a
-            // cmux-aware hint instead of the generic npm command.
-            const claudeRow = results.find((r) => r.name === "claude");
-            if (claudeRow && claudeRow.installed && latestClaude) {
-                claudeRow.latestVersion = latestClaude;
-                if (claudeRow.version && isUpdateAvailable(claudeRow.version, latestClaude)) {
-                    const isCmuxBundled = !!claudeRow.path?.includes("/cmux.app/");
-                    if (isCmuxBundled) {
-                        claudeRow.updateHint = "Bundled with cmux — update cmux.app to get the latest Claude.";
-                    }
-                    else {
-                        const cmd = getInstallCommandFor(pm, `${CLAUDE_CODE_PACKAGE}@latest`);
-                        claudeRow.updateHint = `Run: ${cmd.display}`;
-                    }
-                }
-            }
-            // 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
-            // falls back to git's default pager. Delta is the most popular
-            // choice so we check for it as a convenience, but it is never a
-            // hard dependency.
-            const deltaCheck = await checkTool("delta", "Recommended diff pager — any diff pager works", false, "delta --version | head -1", "Optional — santree's built-in colorizer handles the dashboard overlay; the CLI falls back to git's default pager. Set SANTREE_DIFF_TOOL to override. To install delta: brew install git-delta");
-            results.push(deltaCheck);
-            // Optional: a `.code-workspace`-aware editor (VSCode or Cursor).
-            // Santree itself works with any editor via $SANTREE_EDITOR — this
-            // check exists only because the dashboard's `E workspace` shortcut
-            // needs an editor that understands `.code-workspace` files. Missing
-            // here just means the shortcut is hidden; everything else still works.
-            const workspaceEditorDesc = "Workspace editor (`E workspace` shortcut)";
-            const [codeCheck, cursorCheck] = await Promise.all([
-                checkTool("code", workspaceEditorDesc, false, "code --version | head -1", ""),
-                checkTool("cursor", workspaceEditorDesc, false, "cursor --version | head -1", ""),
-            ]);
-            if (codeCheck.installed) {
-                results.push(codeCheck);
-            }
-            else if (cursorCheck.installed) {
-                results.push(cursorCheck);
-            }
-            else {
-                results.push({
-                    name: "code/cursor",
-                    description: workspaceEditorDesc,
-                    required: false,
-                    installed: false,
-                    hint: "Optional — santree works with any $SANTREE_EDITOR. Only needed for the dashboard's `.code-workspace` shortcut.",
-                });
-            }
-            const trackerResult = await checkTrackerAuth();
-            const statuslineResult = await checkStatusline();
-            setTools(results);
-            setTracker(trackerResult);
-            setRemoteControl(checkRemoteControl());
-            setStatusline(statuslineResult);
-            setSessionSignal(checkSessionSignalHooks());
-            setEnglishTutor(checkEnglishTutorHooks());
-            setSantreeSetup(checkSantreeSetup());
-            setLoading(false);
-        }
-        runChecks();
-    }, []);
-    if (loading) {
-        return (_jsx(Box, { paddingY: 1, children: _jsx(SquirrelLoader, { text: "Checking system requirements..." }) }));
-    }
-    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;
-    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/github/auth.d.ts

@@ -1,2 +0,0 @@
-export declare const description = "Authenticate with GitHub via the gh CLI";
-export default function GithubAuth(): import("react/jsx-runtime").JSX.Element;

package/dist/commands/github/auth.js

@@ -1,56 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
-import { Text, Box } from "ink";
-import Spinner from "ink-spinner";
-import { exec } from "child_process";
-import { promisify } from "util";
-import { findMainRepoRoot } from "../../lib/git.js";
-import { getAuthenticatedUser } from "../../lib/trackers/github/auth.js";
-import { setRepoTracker } from "../../lib/trackers/index.js";
-const execAsync = promisify(exec);
-export const description = "Authenticate with GitHub via the gh CLI";
-export default function GithubAuth() {
-    const [status, setStatus] = useState("checking");
-    const [message, setMessage] = useState("");
-    const [error, setError] = useState(null);
-    useEffect(() => {
-        async function run() {
-            await new Promise((r) => setTimeout(r, 100));
-            const repoRoot = findMainRepoRoot();
-            if (!repoRoot) {
-                setError("Not inside a git repository");
-                setStatus("error");
-                return;
-            }
-            let user = await getAuthenticatedUser();
-            if (!user) {
-                setStatus("logging-in");
-                try {
-                    await execAsync("gh auth login -p https -h github.com -w", { stdio: "inherit" });
-                }
-                catch (e) {
-                    setError(e instanceof Error ? e.message : "gh auth login failed");
-                    setStatus("error");
-                    return;
-                }
-                user = await getAuthenticatedUser();
-                if (!user) {
-                    setError("gh auth login completed but no authenticated user — try `gh auth status`");
-                    setStatus("error");
-                    return;
-                }
-            }
-            setRepoTracker(repoRoot, "github");
-            setMessage(`Authenticated as @${user.login}; this repo now uses GitHub Issues`);
-            setStatus("done");
-        }
-        run();
-    }, []);
-    useEffect(() => {
-        if (status === "done" || status === "error") {
-            const timer = setTimeout(() => process.exit(status === "error" ? 1 : 0), 100);
-            return () => clearTimeout(timer);
-        }
-    }, [status]);
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "GitHub Auth" }) }), status === "checking" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Checking gh auth status..." })] })), status === "logging-in" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Running `gh auth login` \u2014 follow the browser prompt..." })] })), status === "done" && (_jsxs(Text, { color: "green", bold: true, children: ["\u2713 ", message] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] }));
-}

package/dist/commands/github/index.d.ts

@@ -1 +0,0 @@
-export declare const description = "GitHub Issues tracker commands";

package/dist/commands/github/index.js

@@ -1 +0,0 @@
-export const description = "GitHub Issues tracker commands";

package/dist/commands/helpers/english-tutor/index.d.ts

@@ -1 +0,0 @@
-export declare const description = "Nudge Claude to correct your English (Claude Code hooks)";

package/dist/commands/helpers/english-tutor/index.js

@@ -1 +0,0 @@
-export const description = "Nudge Claude to correct your English (Claude Code hooks)";

package/dist/commands/helpers/english-tutor/install.d.ts

@@ -1,8 +0,0 @@
-import { z } from "zod";
-export declare const description = "Install English-tutor hooks into Claude Code settings";
-export declare const options: z.ZodObject<{
-    dry: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-export default function Install({ options: opts }: {
-    options: z.infer<typeof options>;
-}): null;

package/dist/commands/helpers/english-tutor/install.js

@@ -1,24 +0,0 @@
-import { useEffect, useRef } from "react";
-import { z } from "zod";
-import { getInstallSnippet, installHooks } from "../../../lib/english-tutor.js";
-export const description = "Install English-tutor hooks into Claude Code settings";
-export const options = z.object({
-    dry: z.boolean().optional().describe("Print the hooks JSON without writing"),
-});
-export default function Install({ options: opts }) {
-    const hasRun = useRef(false);
-    useEffect(() => {
-        if (hasRun.current)
-            return;
-        hasRun.current = true;
-        if (opts?.dry) {
-            process.stdout.write(JSON.stringify(getInstallSnippet(), null, 2) + "\n");
-            process.exit(0);
-        }
-        const { settingsPath, logPath } = installHooks();
-        process.stdout.write(`English-tutor hooks installed in ${settingsPath}\n`);
-        process.stdout.write(`Practice log: ${logPath}\n`);
-        process.exit(0);
-    }, []);
-    return null;
-}

package/dist/commands/helpers/english-tutor/prompt.d.ts

@@ -1,2 +0,0 @@
-export declare const description = "English-tutor instruction (UserPromptSubmit hook)";
-export default function Prompt(): null;