santree 0.5.3 → 0.5.5

package/dist/commands/doctor.js

@@ -10,7 +10,7 @@ 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 { getAuthStatus, getValidTokens } from "../lib/linear.js";
+import { getIssueTracker } from "../lib/trackers/index.js";
 import { getMultiplexer } from "../lib/multiplexer/index.js";
 import { resolveClaudeBinary } from "../lib/ai.js";
 import { CURRENT_VERSION, CLAUDE_CODE_PACKAGE, SANTREE_PACKAGE, getLatestVersionFor, isUpdateAvailable, detectPackageManager, getInstallCommandFor, } from "../lib/version.js";
@@ -60,19 +60,19 @@ async function checkTool(name, description, required, versionCommand, hint) {
 }
 /**
  * Reports the active multiplexer (tmux/cmux/none) and verifies the underlying
- * binary is reachable. Surfaces a hint when the configured multiplexer can't run.
+ * 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 explicit = process.env["SANTREE_MULTIPLEXER"]?.toLowerCase();
-    const description = `Multiplexer (active: ${mux.kind}${explicit ? `, SANTREE_MULTIPLEXER=${explicit}` : ""})`;
+    const description = `Multiplexer (active: ${mux.kind})`;
     if (mux.kind === "none") {
         return {
             name: "multiplexer",
             description,
             required: false,
             installed: false,
-            hint: "No multiplexer active. Set SANTREE_MULTIPLEXER=tmux (or cmux) and run inside one. Install: brew install tmux",
+            hint: "Run inside tmux or cmux to enable session window renaming. Install tmux: brew install tmux",
         };
     }
     if (mux.kind === "tmux") {
@@ -104,7 +104,7 @@ async function checkMultiplexer() {
             description,
             required: false,
             installed: false,
-            hint: "Install cmux.app from https://cmux.com or set SANTREE_MULTIPLEXER=tmux. cmux is macOS-only.",
+            hint: "Install cmux.app from https://cmux.com (cmux is macOS-only).",
         };
     }
     const version = await tryExec("cmux --version 2>/dev/null");
@@ -122,9 +122,7 @@ async function checkMultiplexer() {
         installed: !!ping,
         version: version || "unknown",
         path,
-        hint: !ping
-            ? "cmux app not reachable — open cmux.app or set SANTREE_MULTIPLEXER=tmux."
-            : undefined,
+        hint: !ping ? "cmux app not reachable — open cmux.app." : undefined,
     };
 }
 /**
@@ -135,8 +133,9 @@ async function checkMultiplexer() {
  */
 async function checkClaude() {
     const resolved = resolveClaudeBinary();
+    const usingBundled = resolved?.startsWith("/Applications/cmux.app/") ?? false;
     const inCmux = getMultiplexer().kind === "cmux";
-    const description = inCmux ? "Claude Code CLI (cmux-bundled)" : "Claude Code CLI";
+    const description = usingBundled ? "Claude Code CLI (cmux-bundled)" : "Claude Code CLI";
     if (!resolved) {
         return {
             name: "claude",
@@ -197,30 +196,22 @@ async function checkGhAuth() {
     };
 }
 /**
- * Checks Linear API authentication status.
+ * 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 checkLinearAuth() {
+async function checkTrackerAuth() {
     const repoRoot = findMainRepoRoot();
-    const status = getAuthStatus(repoRoot);
-    if (!status.authenticated || !status.orgSlug) {
-        return {
-            authenticated: false,
-            hint: "Run: santree linear auth",
-        };
-    }
-    // Try to validate/refresh tokens
-    const valid = await getValidTokens(status.orgSlug);
+    const tracker = getIssueTracker(repoRoot);
+    const status = await tracker.getAuthStatus(repoRoot);
     return {
-        authenticated: true,
-        orgSlug: status.orgSlug,
-        orgName: status.orgName,
-        tokenValid: valid !== null,
+        displayName: tracker.displayName,
+        authenticated: status.authenticated,
+        accountLabel: status.accountLabel,
+        expiresAt: status.expiresAt,
         repoLinked: status.repoLinked,
-        hint: !valid
-            ? "Token expired. Run: santree linear auth"
-            : !status.repoLinked
-                ? "Repo not linked. Run: santree linear auth"
-                : undefined,
+        hint: status.hint,
     };
 }
 /**
@@ -334,40 +325,64 @@ function checkSessionSignalHooks() {
     catch {
         missingHooks.push(...requiredEvents);
     }
-    // Check hook script files in .santree/hooks/
-    const hookScripts = [];
-    const mainRepoRoot = findMainRepoRoot();
-    let hooksDir = null;
-    if (mainRepoRoot) {
-        hooksDir = path.join(mainRepoRoot, ".santree", "hooks");
-        const scriptNames = ["on-waiting.sh", "on-active.sh", "on-idle.sh", "on-exited.sh"];
-        for (const name of scriptNames) {
-            const scriptPath = path.join(hooksDir, name);
-            const exists = fs.existsSync(scriptPath);
-            let executable = false;
-            if (exists) {
-                try {
-                    fs.accessSync(scriptPath, fs.constants.X_OK);
-                    executable = true;
-                }
-                catch {
-                    // not executable
+    if (missingHooks.length === 0) {
+        return { configured: true, missingHooks: [] };
+    }
+    return {
+        configured: false,
+        missingHooks,
+        hint: `Missing: ${missingHooks.join(", ")}. Run: 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);
             }
-            if (exists) {
-                hookScripts.push({ name, exists, executable });
+            const allow = settings.permissions?.allow;
+            if (Array.isArray(allow) && allow.includes(expectedPermission)) {
+                missingPermission = false;
             }
         }
+        else {
+            missingHooks.push(...requiredEvents);
+        }
     }
-    if (missingHooks.length === 0) {
-        return { configured: true, missingHooks: [], hookScripts, hooksDir };
+    catch {
+        missingHooks.push(...requiredEvents);
+    }
+    if (missingHooks.length === 0 && !missingPermission) {
+        return { configured: true, missingHooks: [], missingPermission: false };
     }
     return {
         configured: false,
         missingHooks,
-        hookScripts,
-        hooksDir,
-        hint: `Missing: ${missingHooks.join(", ")}. Run: santree helpers session-signal install`,
+        missingPermission,
+        hint: "Run: santree helpers english-tutor install",
     };
 }
 /**
@@ -451,9 +466,9 @@ function StatusIcon({ ok, required }) {
 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 LinearRow({ linear }) {
-    const isOk = linear.authenticated && linear.tokenValid && linear.repoLinked;
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: !!isOk, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Linear API" }), _jsx(Text, { dimColor: true, children: " - Linear ticket integration" })] }), linear.authenticated ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Organization: ", linear.orgName, " (", linear.orgSlug, ")"] }), _jsxs(Text, { dimColor: true, children: ["Token: ", linear.tokenValid ? "valid" : "expired"] }), _jsxs(Text, { dimColor: true, children: ["Repo linked: ", linear.repoLinked ? "yes" : "no"] }), linear.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", linear.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", linear.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 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, ")\""] }) }))] }));
@@ -465,13 +480,15 @@ 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 }) {
-    const allScriptNames = ["on-waiting.sh", "on-active.sh", "on-idle.sh", "on-exited.sh"];
-    const existingNames = new Set(status.hookScripts.map((s) => s.name));
-    const missingScripts = allScriptNames.filter((n) => !existingNames.has(n));
-    const nonExecutable = status.hookScripts.filter((s) => !s.executable);
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.configured && nonExecutable.length === 0, 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)" })] }), _jsxs(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] })] })), status.hooksDir && (_jsxs(Text, { dimColor: true, children: ["Hook scripts:", " ", status.hookScripts.length > 0
-                                ? status.hookScripts.map((s) => s.name).join(", ")
-                                : "none"] })), status.hooksDir && missingScripts.length > 0 && (_jsxs(Text, { color: "yellow", children: ["\u21B3 Create in ", status.hooksDir, ": ", missingScripts.join(", ")] })), nonExecutable.map((s) => (_jsxs(Text, { color: "yellow", children: ["\u21B3 ", s.name, " is not executable. Run: chmod +x .santree/hooks/", s.name] }, s.name)))] })] }));
+    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 &&
@@ -490,11 +507,12 @@ function SantreeSetupRow({ status }) {
 }
 export default function Doctor() {
     const [tools, setTools] = useState([]);
-    const [linear, setLinear] = useState(null);
+    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);
+    const [englishTutor, setEnglishTutor] = useState(null);
     const [santreeSetup, setSantreeSetup] = useState(null);
     const [loading, setLoading] = useState(true);
     useEffect(() => {
@@ -541,12 +559,14 @@ export default function Doctor() {
                     }
                 }
             }
-            // Optional: a syntax-highlighted diff pager — used by `st worktree diff`
+            // Optional: a syntax-highlighting diff pager — used by `st worktree diff`
             // and the dashboard `v` overlay when SANTREE_DIFF_TOOL is set. Any
-            // pager works (delta, diff-so-fancy, …); without one set, git's
-            // default pager runs. 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 pager works", false, "delta --version | head -1", "Optional — git's default pager works too. Set SANTREE_DIFF_TOOL or `git config core.pager <tool>`. To install delta: brew install git-delta");
+            // 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
@@ -573,14 +593,15 @@ export default function Doctor() {
                     hint: "Optional — santree works with any $SANTREE_EDITOR. Only needed for the dashboard's `.code-workspace` shortcut.",
                 });
             }
-            const linearResult = await checkLinearAuth();
+            const trackerResult = await checkTrackerAuth();
             const statuslineResult = await checkStatusline();
             setTools(results);
-            setLinear(linearResult);
+            setTracker(trackerResult);
             setShellStatus(checkShellIntegration());
             setRemoteControl(checkRemoteControl());
             setStatusline(statuslineResult);
             setSessionSignal(checkSessionSignalHooks());
+            setEnglishTutor(checkEnglishTutorHooks());
             setSantreeSetup(checkSantreeSetup());
             setLoading(false);
         }
@@ -591,7 +612,7 @@ 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 linearOk = linear?.authenticated && linear?.tokenValid && linear?.repoLinked;
-    const allRequired = requiredMissing.length === 0 && linearOk && 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" }) }), linear && _jsx(LinearRow, { linear: linear }), 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 }), _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 + (linearOk ? 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 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"] }))] })) })] }));
 }

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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1,56 @@
+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

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

package/dist/commands/github/index.js

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

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

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

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

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

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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,24 @@
+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

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

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

@@ -0,0 +1,16 @@
+import { useEffect, useRef } from "react";
+import { renderPrompt } from "../../../lib/prompts.js";
+import { getLogPath } from "../../../lib/english-tutor.js";
+export const description = "English-tutor instruction (UserPromptSubmit hook)";
+export default function Prompt() {
+    const hasRun = useRef(false);
+    useEffect(() => {
+        if (hasRun.current)
+            return;
+        hasRun.current = true;
+        const text = renderPrompt("english-tutor-prompt", { logPath: getLogPath() });
+        process.stdout.write(text);
+        process.exit(0);
+    }, []);
+    return null;
+}

package/dist/commands/helpers/english-tutor/session-start.d.ts

@@ -0,0 +1,2 @@
+export declare const description = "Replay practice log (SessionStart hook)";
+export default function SessionStart(): null;

package/dist/commands/helpers/english-tutor/session-start.js

@@ -0,0 +1,34 @@
+import * as fs from "fs";
+import { useEffect, useRef } from "react";
+import { getLogPath } from "../../../lib/english-tutor.js";
+export const description = "Replay practice log (SessionStart hook)";
+export default function SessionStart() {
+    const hasRun = useRef(false);
+    useEffect(() => {
+        if (hasRun.current)
+            return;
+        hasRun.current = true;
+        try {
+            const logPath = getLogPath();
+            if (fs.existsSync(logPath)) {
+                const contents = fs.readFileSync(logPath, "utf-8").trim();
+                const entryCount = (contents.match(/^- /gm) || []).length;
+                if (contents.length > 0) {
+                    process.stdout.write(`[ENGLISH TUTOR — PRACTICE LOG REPLAY]\n\n${contents}\n\n--- LOG END ---\n`);
+                    // Only ask for a summary once there are enough entries to be useful.
+                    // Below that threshold the log is too sparse to surface real patterns,
+                    // and a forced summary would just noise up new sessions.
+                    if (entryCount >= 3) {
+                        process.stdout.write(`\n[ENGLISH TUTOR — SESSION-START INSTRUCTION]\n` +
+                            `At the very start of your first response in this session, briefly note any RECURRING patterns from the log above (1-3 short bullets, e.g. "you frequently drop articles", "watch for 'their' vs 'there'"). Skip this entirely if no clear patterns emerge or if the user's first message is purely a coding task. Do not list every entry — only patterns.\n`);
+                    }
+                }
+            }
+        }
+        catch {
+            // hook must never block the session — silently no-op on read error
+        }
+        process.exit(0);
+    }, []);
+    return null;
+}

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

@@ -0,0 +1,2 @@
+export declare const description = "Remove English-tutor hooks from Claude Code settings";
+export default function Uninstall(): null;

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

@@ -0,0 +1,15 @@
+import { useEffect, useRef } from "react";
+import { uninstallHooks } from "../../../lib/english-tutor.js";
+export const description = "Remove English-tutor hooks from Claude Code settings";
+export default function Uninstall() {
+    const hasRun = useRef(false);
+    useEffect(() => {
+        if (hasRun.current)
+            return;
+        hasRun.current = true;
+        const settingsPath = uninstallHooks();
+        process.stdout.write(`English-tutor hooks removed from ${settingsPath}\n`);
+        process.exit(0);
+    }, []);
+    return null;
+}

package/dist/commands/helpers/template.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod/v4";
 export declare const description = "Render a template to stdout";
 export declare const args: z.ZodTuple<[z.ZodEnum<{
     linear: "linear";
+    ticket: "ticket";
     review: "review";
     pr: "pr";
     "git-changes": "git-changes";

package/dist/commands/helpers/template.js

@@ -6,13 +6,13 @@ import { argument } from "pastel";
 import { z } from "zod/v4";
 import { findRepoRoot, findMainRepoRoot, getCurrentBranch, extractTicketId, } from "../../lib/git.js";
 import { renderTicket } from "../../lib/prompts.js";
-import { getTicketContent } from "../../lib/linear.js";
+import { getIssueTracker } from "../../lib/trackers/index.js";
 import { resolveAIContext, renderAIPrompt, fetchAndRenderPR, fetchAndRenderDiff, } from "../../lib/ai.js";
 export const description = "Render a template to stdout";
 export const args = z.tuple([
-    z.enum(["linear", "git-changes", "pr", "fix-pr", "review"]).describe(argument({
+    z.enum(["ticket", "linear", "git-changes", "pr", "fix-pr", "review"]).describe(argument({
         name: "type",
-        description: "Template type (linear, git-changes, pr, fix-pr, or review)",
+        description: "Template type (ticket, git-changes, pr, fix-pr, or review)",
     })),
 ]);
 export default function Template({ args }) {
@@ -93,22 +93,24 @@ export default function Template({ args }) {
                 setTimeout(() => exit(), 100);
             }
             else {
+                const mainRoot = findMainRepoRoot() ?? repoRoot;
+                const tracker = getIssueTracker(mainRoot);
                 const ticketId = extractTicketId(branch);
                 if (!ticketId) {
                     setStatus("error");
-                    setMessage("Could not extract ticket ID from branch name. Expected format: user/TEAM-123-description");
+                    setMessage(`Could not extract ${tracker.issueNoun} ID from branch name '${branch}'.`);
                     setTimeout(() => exit(), 100);
                     return;
                 }
-                const mainRoot = findMainRepoRoot() ?? repoRoot;
-                const ticket = await getTicketContent(ticketId, mainRoot);
-                if (!ticket) {
+                const result = await tracker.getIssue(ticketId, mainRoot);
+                if (!result.ok) {
+                    const status = await tracker.getAuthStatus(mainRoot);
                     setStatus("error");
-                    setMessage(`Could not fetch Linear ticket ${ticketId}. Run 'santree linear auth' to authenticate.`);
+                    setMessage(`Could not fetch ${tracker.issueNoun} ${ticketId}.${status.hint ? ` ${status.hint}` : ""}`);
                     setTimeout(() => exit(), 100);
                     return;
                 }
-                process.stdout.write(renderTicket(ticket));
+                process.stdout.write(renderTicket(result.value, tracker.displayName));
                 setStatus("done");
                 setTimeout(() => exit(), 100);
             }
@@ -118,7 +120,8 @@ export default function Template({ args }) {
     if (status === "done")
         return null;
     const spinnerTexts = {
-        linear: "Fetching Linear ticket...",
+        ticket: "Fetching issue...",
+        linear: "Fetching issue...",
         "git-changes": "Gathering changes...",
         pr: "Fetching PR feedback...",
         "fix-pr": "Building fix-pr prompt...",

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

@@ -0,0 +1 @@
+export declare const description = "Issue tracker commands (Linear / GitHub)";

package/dist/commands/issue/index.js

@@ -0,0 +1 @@
+export const description = "Issue tracker commands (Linear / GitHub)";

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

@@ -0,0 +1,2 @@
+export declare const description = "Open the current branch's issue in the browser";
+export default function IssueOpen(): import("react/jsx-runtime").JSX.Element;