santree 0.5.3 → 0.5.4

package/dist/commands/worktree/create.js

@@ -36,7 +36,6 @@ export default function Create({ options, args }) {
     const [worktreePath, setWorktreePath] = useState("");
     const [baseBranch, setBaseBranch] = useState(null);
     const [muxWindowName, setMuxWindowName] = useState(null);
-    const [muxKind, setMuxKind] = useState(null);
     async function finalize(path, branch) {
         const wantsWindow = options.window || options.tmux;
         if (wantsWindow) {
@@ -48,24 +47,23 @@ export default function Create({ options, args }) {
                 return;
             }
             setStatus("spawning-window");
-            setMessage(`Creating ${mux.kind} window...`);
+            setMessage("Creating window...");
             const windowName = getWindowName(branch, options.name);
             setMuxWindowName(windowName);
-            setMuxKind(mux.kind);
             let runCommand;
             if (options.work) {
                 runCommand = options.plan ? "st worktree work --plan" : "st worktree work";
             }
             const result = await mux.createWindow({ name: windowName, cwd: path, command: runCommand });
             if (!result.ok) {
-                setMessage(`Worktree created, but failed to create ${mux.kind} window${result.message ? `: ${result.message}` : ""}`);
+                setMessage(`Worktree created, but failed to create window${result.message ? `: ${result.message}` : ""}`);
                 setStatus("done");
                 console.log(`SANTREE_CD:${path}`);
                 return;
             }
             setStatus("done");
             const workInfo = options.work ? (options.plan ? " + Claude (plan)" : " + Claude") : "";
-            setMessage(`Worktree and ${mux.kind} window created!${workInfo}`);
+            setMessage(`Worktree and window created!${workInfo}`);
             // Don't output SANTREE_CD when a window is created — user is already in the new window
             return;
         }
@@ -161,5 +159,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: [" ", muxKind ?? "tmux", " 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] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", message] }))] })] }));
 }

package/dist/commands/worktree/work.js

@@ -99,5 +99,5 @@ export default function Work({ options }) {
             setError(err instanceof Error ? err.message : "Failed to launch agent");
         }
     }, [status, aiContext, mode]);
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Work" }) }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : getModeColor(mode), paddingX: 1, width: "100%", children: [branch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branch })] })), ticketId && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "ticket:" }), _jsx(Text, { color: "blue", bold: true, children: ticketId })] })), _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "mode:" }), _jsx(Text, { backgroundColor: getModeColor(mode), color: "white", bold: true, children: ` ${getModeLabel(mode)} ` })] })] }), _jsxs(Box, { marginTop: 1, children: [status === "loading" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Loading..." })] })), status === "fetching" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Fetching ticket from Linear..." })] })), status === "launching" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }), _jsxs(Text, { dimColor: true, children: [" ", "claude", mode === "plan" ? " --permission-mode plan" : "", " ", `"<${getModeLabel(mode)} prompt for ${ticketId}>"`] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Work" }) }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: status === "error" ? "red" : getModeColor(mode), paddingX: 1, width: "100%", children: [branch && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "branch:" }), _jsx(Text, { color: "cyan", bold: true, children: branch })] })), ticketId && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "ticket:" }), _jsx(Text, { color: "blue", bold: true, children: ticketId })] })), _jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "mode:" }), _jsx(Text, { backgroundColor: getModeColor(mode), color: "white", bold: true, children: ` ${getModeLabel(mode)} ` })] })] }), _jsxs(Box, { marginTop: 1, children: [status === "loading" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Loading..." })] })), status === "fetching" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Fetching issue from tracker..." })] })), status === "launching" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }), _jsxs(Text, { dimColor: true, children: [" ", "claude", mode === "plan" ? " --permission-mode plan" : "", " ", `"<${getModeLabel(mode)} prompt for ${ticketId}>"`] })] })), status === "error" && (_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", error] }))] })] }));
 }

package/dist/lib/ai.d.ts

@@ -1,15 +1,17 @@
 import { type ChildProcess } from "child_process";
-import { cleanupImages, type LinearIssue } from "./linear.js";
+import type { Issue } from "./trackers/types.js";
 export interface AIContext {
     repoRoot: string;
     mainRoot: string;
     branch: string;
     ticketId: string | null;
-    ticket: LinearIssue | null;
+    ticket: Issue | null;
+    trackerName: string;
+    issueNoun: string;
 }
 /**
- * Resolves repo, branch, ticket ID, and fetches the Linear ticket.
- * Returns an error string if any required context is missing.
+ * Resolves repo, branch, issue identifier, and fetches the issue from the
+ * active tracker (Linear or GitHub Issues — selected by repo config).
  */
 export declare function resolveAIContext(): Promise<{
     ok: true;
@@ -74,6 +76,6 @@ export declare function runAgent(prompt: string, opts?: {
     allowedTools?: string[];
 }): RunAgentResult;
 /**
- * Cleanup images downloaded for a ticket.
+ * Clean up cached image downloads for an issue identifier on the active tracker.
  */
-export { cleanupImages };
+export declare function cleanupImages(ticketId: string): void;

package/dist/lib/ai.js

@@ -2,15 +2,14 @@ import { execSync, spawn, spawnSync } from "child_process";
 import { existsSync, writeFileSync } from "fs";
 import { join } from "path";
 import { homedir, tmpdir } from "os";
-import { getMultiplexer } from "./multiplexer/index.js";
-import { getCurrentBranch, extractTicketId, findRepoRoot, findMainRepoRoot, getBaseBranch, } from "./git.js";
+import { getCurrentBranch, findRepoRoot, findMainRepoRoot, getBaseBranch } from "./git.js";
 import { renderPrompt, renderTicket, renderDiff, renderPR } from "./prompts.js";
-import { getTicketContent, cleanupImages } from "./linear.js";
+import { getIssueTracker } from "./trackers/index.js";
 import { getPRInfoAsync, getPRChecksAsync, getPRReviewsAsync, getPRReviewCommentsAsync, getPRConversationCommentsAsync, getFailedCheckDetailsAsync, } from "./github.js";
 import { runAsync } from "./exec.js";
 /**
- * Resolves repo, branch, ticket ID, and fetches the Linear ticket.
- * Returns an error string if any required context is missing.
+ * Resolves repo, branch, issue identifier, and fetches the issue from the
+ * active tracker (Linear or GitHub Issues — selected by repo config).
  */
 export async function resolveAIContext() {
     const repoRoot = findRepoRoot();
@@ -21,18 +20,28 @@ export async function resolveAIContext() {
     if (!branch) {
         return { ok: false, error: "Could not determine current branch" };
     }
-    const ticketId = extractTicketId(branch);
+    const mainRoot = findMainRepoRoot() ?? repoRoot;
+    const tracker = getIssueTracker(mainRoot);
+    const ticketId = tracker.extractIdFromBranch(branch);
     if (!ticketId) {
         return {
             ok: false,
-            error: "Could not extract ticket ID from branch name. Expected format: user/TEAM-123-description",
+            error: `Could not extract ${tracker.issueNoun} ID from branch name '${branch}'.`,
         };
     }
-    const mainRoot = findMainRepoRoot() ?? repoRoot;
-    const ticket = await getTicketContent(ticketId, mainRoot);
+    const result = await tracker.getIssue(ticketId, mainRoot);
+    const ticket = result.ok ? result.value : null;
     return {
         ok: true,
-        context: { repoRoot, mainRoot, branch, ticketId, ticket },
+        context: {
+            repoRoot,
+            mainRoot,
+            branch,
+            ticketId,
+            ticket,
+            trackerName: tracker.displayName,
+            issueNoun: tracker.issueNoun,
+        },
     };
 }
 /**
@@ -41,7 +50,7 @@ export async function resolveAIContext() {
 export function buildPromptContext(ctx, extra) {
     return {
         ticket_id: ctx.ticketId ?? undefined,
-        ticket_content: ctx.ticket ? renderTicket(ctx.ticket) : undefined,
+        ticket_content: ctx.ticket ? renderTicket(ctx.ticket, ctx.trackerName) : undefined,
         ...extra,
     };
 }
@@ -122,8 +131,10 @@ const CMUX_CLAUDE_PATH = "/Applications/cmux.app/Contents/Resources/bin/claude";
  */
 export function resolveClaudeBinary() {
     // Inside cmux, the bundled binary is the only one wired to the active
-    // workspace. Always prefer it when present.
-    if (getMultiplexer().kind === "cmux" && existsSync(CMUX_CLAUDE_PATH)) {
+    // workspace. Gate on `CMUX_SURFACE_ID` (actual cmux runtime), not
+    // `SANTREE_MULTIPLEXER=cmux` — outside a live workspace the bundled
+    // binary has no auth context and exits with "Invalid API key".
+    if (process.env["CMUX_SURFACE_ID"] && existsSync(CMUX_CLAUDE_PATH)) {
         return CMUX_CLAUDE_PATH;
     }
     // PATH lookup
@@ -216,6 +227,9 @@ export function runAgent(prompt, opts) {
     };
 }
 /**
- * Cleanup images downloaded for a ticket.
+ * Clean up cached image downloads for an issue identifier on the active tracker.
  */
-export { cleanupImages };
+export function cleanupImages(ticketId) {
+    const repoRoot = findMainRepoRoot();
+    getIssueTracker(repoRoot).cleanupCache(ticketId);
+}

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

@@ -14,7 +14,10 @@ export type IssueActionItem = {
 };
 /** Returns the context-sensitive action key list for the selected issue.
  * Lifted out of the panel so the dashboard can render it on the same row as
- * the global command bar (so left- and right-pane key hints align). */
-export declare function buildIssueActions(di: DashboardIssue): IssueActionItem[];
+ * the global command bar (so left- and right-pane key hints align). The
+ * `trackerName` is the active tracker's `displayName` ("Linear" / "GitHub"),
+ * surfaced as the open-in-browser action label so the panel doesn't hardcode
+ * a vendor name. */
+export declare function buildIssueActions(di: DashboardIssue, trackerName: string): IssueActionItem[];
 export default function DetailPanel({ issue, scrollOffset, height, width, creatingForTicket, creationLogs, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/lib/dashboard/DetailPanel.js

@@ -51,8 +51,11 @@ function fileColor(xy) {
 }
 /** Returns the context-sensitive action key list for the selected issue.
  * Lifted out of the panel so the dashboard can render it on the same row as
- * the global command bar (so left- and right-pane key hints align). */
-export function buildIssueActions(di) {
+ * the global command bar (so left- and right-pane key hints align). The
+ * `trackerName` is the active tracker's `displayName` ("Linear" / "GitHub"),
+ * surfaced as the open-in-browser action label so the panel doesn't hardcode
+ * a vendor name. */
+export function buildIssueActions(di, trackerName) {
     const { worktree, pr, issue } = di;
     const items = [];
     if (worktree?.sessionId) {
@@ -82,7 +85,7 @@ export function buildIssueActions(di) {
         items.push({ key: "r", label: "Review", color: "cyan" });
     }
     if (issue.url) {
-        items.push({ key: "o", label: "Linear", color: "gray" });
+        items.push({ key: "o", label: trackerName, color: "gray" });
     }
     if (pr)
         items.push({ key: "p", label: "Open PR", color: "gray" });

package/dist/lib/dashboard/data.js

@@ -1,14 +1,18 @@
 import { listWorktrees, extractTicketId, getBaseBranch, readAllMetadata, readSessionState, isSessionAlive, clearSessionState, getGitStatusAsync, getCommitsAheadAsync, getDiffShortstatAsync, } from "../git.js";
 import { getPRInfoAsync, getPRChecksAsync, getPRReviewsAsync, getPRConversationCommentsAsync, getPRViewAsync, getReviewRequestedPRsAsync, getRepoNameAsync, } from "../github.js";
-import { fetchAssignedIssues } from "../linear.js";
+import { getIssueTracker } from "../trackers/index.js";
 export async function loadDashboardData(repoRoot) {
     // Fetch issues and worktrees in parallel
-    const [issues, worktrees] = await Promise.all([
-        fetchAssignedIssues(repoRoot),
+    const tracker = getIssueTracker(repoRoot);
+    const [listResult, worktrees] = await Promise.all([
+        tracker.listAssigned(repoRoot),
         Promise.resolve(listWorktrees()),
     ]);
-    if (!issues)
-        throw new Error("Failed to authenticate with Linear. Run: santree linear auth");
+    if (!listResult.ok) {
+        const status = await tracker.getAuthStatus(repoRoot);
+        throw new Error(listResult.message ?? status.hint ?? `Failed to authenticate with ${tracker.displayName}`);
+    }
+    const issues = listResult.value;
     // Build worktree map: ticketId -> worktree info
     const wtMap = new Map();
     for (const wt of worktrees) {
@@ -92,10 +96,14 @@ export async function loadDashboardData(repoRoot) {
                 getPRReviewsAsync(pr.number),
             ]);
         }
-        // Derive a readable title from branch name: strip prefix and ticket ID
-        const titleFromBranch = wt.branch
-            .replace(/^[^/]+\//, "") // strip prefix (e.g. "feature/")
-            .replace(/^[A-Z]+-\d+-?/, "") // strip ticket ID
+        // Derive a readable title from branch name: strip prefix and the
+        // tracker-format ID literal (e.g. "TEAM-123-" or "123-"). The ID
+        // shape comes from the tracker's parser so this works for both
+        // Linear and GitHub branches.
+        const idLiteral = tid ? new RegExp(`^${tid}-?`) : null;
+        const titleFromBranch = (idLiteral
+            ? wt.branch.replace(/^[^/]+\//, "").replace(idLiteral, "")
+            : wt.branch.replace(/^[^/]+\//, ""))
             .replace(/-/g, " ")
             .trim() || tid;
         let sessState = readSessionState(repoRoot, tid);

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

@@ -1,19 +1,6 @@
 import type { PRInfo, PRCheck, PRReview, PRConversationComment, SearchPR } from "../github.js";
-export interface LinearAssignedIssue {
-    identifier: string;
-    title: string;
-    description: string | null;
-    url: string;
-    priority: number;
-    priorityLabel: string;
-    state: {
-        name: string;
-        type: string;
-    };
-    labels: string[];
-    projectId: string | null;
-    projectName: string | null;
-}
+import type { AssignedIssue } from "../trackers/types.js";
+export type { AssignedIssue } from "../trackers/types.js";
 export interface WorktreeInfo {
     path: string;
     branch: string;
@@ -30,7 +17,7 @@ export interface WorktreeInfo {
     } | null;
 }
 export interface DashboardIssue {
-    issue: LinearAssignedIssue;
+    issue: AssignedIssue;
     worktree: WorktreeInfo | null;
     pr: PRInfo | null;
     checks: PRCheck[] | null;

package/dist/lib/git.d.ts

@@ -1,3 +1,4 @@
+export { getSantreeDir, readAllMetadata, writeAllMetadata } from "./metadata.js";
 export interface SessionState {
     state: "waiting" | "idle" | "active" | "exited";
     message: string | null;
@@ -53,10 +54,6 @@ export declare function getDefaultBranch(): string;
  * Returns an empty array on failure.
  */
 export declare function listWorktrees(): Worktree[];
-/**
- * Get the path to the .santree directory inside a repo root.
- */
-export declare function getSantreeDir(repoRoot: string): string;
 /**
  * Get the path to the .santree/worktrees directory inside a repo root.
  */
@@ -82,9 +79,14 @@ export declare function removeWorktree(branchName: string, repoRoot: string, for
     error?: string;
 }>;
 /**
- * Extract a ticket ID (e.g. "TEAM-123") from a branch name.
- * Matches the first occurrence of LETTERS-DIGITS in the string.
- * Returns null if no ticket ID pattern is found.
+ * Extract an issue identifier from a branch name. Delegates to the active
+ * issue tracker (Linear: `[A-Z]+-\d+`; GitHub: explicit-prefix numeric),
+ * resolving the tracker from the main repo's config.
+ *
+ * This is the single shim that frees every caller from having to know which
+ * tracker is active or how it formats IDs. Returns null when the active
+ * tracker doesn't recognize the branch's ID shape, or when no main repo can
+ * be resolved (e.g. before a worktree is created).
  */
 export declare function extractTicketId(branch: string): string | null;
 /**
@@ -93,30 +95,6 @@ export declare function extractTicketId(branch: string): string | null;
  * Returns null if no worktree is checked out on that branch.
  */
 export declare function getWorktreePath(branchName: string): string | null;
-/**
- * Read all entries from .santree/metadata.json.
- * Returns an empty object if the file doesn't exist or can't be parsed.
- */
-export declare function readAllMetadata(repoRoot: string): Record<string, any>;
-/**
- * Write all entries to .santree/metadata.json.
- */
-export declare function writeAllMetadata(repoRoot: string, data: Record<string, any>): void;
-/**
- * Get the Linear org slug associated with this repo.
- * Stored as `_linear.org` in .santree/metadata.json.
- */
-export declare function getRepoLinearOrg(repoRoot: string): string | null;
-/**
- * Associate a Linear org slug with this repo.
- * Stored as `_linear.org` in .santree/metadata.json.
- */
-export declare function setRepoLinearOrg(repoRoot: string, orgSlug: string): void;
-/**
- * Remove the Linear org association from this repo.
- * Deletes the `_linear` key from .santree/metadata.json.
- */
-export declare function removeRepoLinearOrg(repoRoot: string): void;
 /**
  * Get the stored session ID for a given ticket from .santree/metadata.json.
  * Returns null if no session ID is stored.
@@ -191,8 +169,13 @@ export declare function getCommitsAhead(baseBranch: string): number;
  */
 export declare function getCommitsAheadAsync(cwd: string, baseBranch: string): Promise<number>;
 /**
- * Read the SANTREE_DIFF_TOOL env var, returning the configured pager command
- * (e.g. "delta", "diff-so-fancy") or null if unset/invalid.
+ * Read the SANTREE_DIFF_TOOL env var, returning the configured diff pager
+ * command (e.g. "delta", "diff-so-fancy") or null if unset/invalid.
+ *
+ * The CLI `worktree diff` flow lets the pager do its full job (render +
+ * scroll) via git's `core.pager`. The dashboard's `[v]` overlay only uses
+ * the rendering half — it captures the pager's stdout as a string and
+ * handles scrolling itself in Ink.
  *
  * The value is restricted to a safe shell-token character set since it ends
  * up in arguments passed to spawn() — even though we never use shell:true,

package/dist/lib/git.js

@@ -4,6 +4,9 @@ import * as path from "path";
 import * as fs from "fs";
 import { run, runAsync, spawnAsync } from "./exec.js";
 import { getMultiplexer } from "./multiplexer/index.js";
+import { getSantreeDir, readAllMetadata, writeAllMetadata } from "./metadata.js";
+import { getIssueTracker } from "./trackers/index.js";
+export { getSantreeDir, readAllMetadata, writeAllMetadata } from "./metadata.js";
 const execAsync = promisify(exec);
 /**
  * Find the toplevel directory of the current git repository.
@@ -114,12 +117,6 @@ export function listWorktrees() {
     }
     return worktrees;
 }
-/**
- * Get the path to the .santree directory inside a repo root.
- */
-export function getSantreeDir(repoRoot) {
-    return path.join(repoRoot, ".santree");
-}
 /**
  * Get the path to the .santree/worktrees directory inside a repo root.
  */
@@ -247,16 +244,18 @@ export async function removeWorktree(branchName, repoRoot, force = false) {
     }
 }
 /**
- * Extract a ticket ID (e.g. "TEAM-123") from a branch name.
- * Matches the first occurrence of LETTERS-DIGITS in the string.
- * Returns null if no ticket ID pattern is found.
+ * Extract an issue identifier from a branch name. Delegates to the active
+ * issue tracker (Linear: `[A-Z]+-\d+`; GitHub: explicit-prefix numeric),
+ * resolving the tracker from the main repo's config.
+ *
+ * This is the single shim that frees every caller from having to know which
+ * tracker is active or how it formats IDs. Returns null when the active
+ * tracker doesn't recognize the branch's ID shape, or when no main repo can
+ * be resolved (e.g. before a worktree is created).
  */
 export function extractTicketId(branch) {
-    const match = branch.match(/([a-zA-Z]+)-(\d+)/);
-    if (match) {
-        return `${match[1].toUpperCase()}-${match[2]}`;
-    }
-    return null;
+    const repoRoot = findMainRepoRoot();
+    return getIssueTracker(repoRoot).extractIdFromBranch(branch);
 }
 /**
  * Get the filesystem path for a worktree by its branch name.
@@ -278,64 +277,6 @@ export function getWorktreePath(branchName) {
     }
     return null;
 }
-/**
- * Get path to centralized metadata file: .santree/metadata.json in the repo root.
- */
-function getMetadataFilePath(repoRoot) {
-    return path.join(getSantreeDir(repoRoot), "metadata.json");
-}
-/**
- * Read all entries from .santree/metadata.json.
- * Returns an empty object if the file doesn't exist or can't be parsed.
- */
-export function readAllMetadata(repoRoot) {
-    const filePath = getMetadataFilePath(repoRoot);
-    if (!fs.existsSync(filePath))
-        return {};
-    try {
-        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * Write all entries to .santree/metadata.json.
- */
-export function writeAllMetadata(repoRoot, data) {
-    const filePath = getMetadataFilePath(repoRoot);
-    const dir = path.dirname(filePath);
-    if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
-}
-/**
- * Get the Linear org slug associated with this repo.
- * Stored as `_linear.org` in .santree/metadata.json.
- */
-export function getRepoLinearOrg(repoRoot) {
-    const all = readAllMetadata(repoRoot);
-    return all._linear?.org ?? null;
-}
-/**
- * Associate a Linear org slug with this repo.
- * Stored as `_linear.org` in .santree/metadata.json.
- */
-export function setRepoLinearOrg(repoRoot, orgSlug) {
-    const all = readAllMetadata(repoRoot);
-    all._linear = { org: orgSlug };
-    writeAllMetadata(repoRoot, all);
-}
-/**
- * Remove the Linear org association from this repo.
- * Deletes the `_linear` key from .santree/metadata.json.
- */
-export function removeRepoLinearOrg(repoRoot) {
-    const all = readAllMetadata(repoRoot);
-    delete all._linear;
-    writeAllMetadata(repoRoot, all);
-}
 /**
  * Get the stored session ID for a given ticket from .santree/metadata.json.
  * Returns null if no session ID is stored.
@@ -469,8 +410,13 @@ export async function getCommitsAheadAsync(cwd, baseBranch) {
     return output ? parseInt(output, 10) || 0 : 0;
 }
 /**
- * Read the SANTREE_DIFF_TOOL env var, returning the configured pager command
- * (e.g. "delta", "diff-so-fancy") or null if unset/invalid.
+ * Read the SANTREE_DIFF_TOOL env var, returning the configured diff pager
+ * command (e.g. "delta", "diff-so-fancy") or null if unset/invalid.
+ *
+ * The CLI `worktree diff` flow lets the pager do its full job (render +
+ * scroll) via git's `core.pager`. The dashboard's `[v]` overlay only uses
+ * the rendering half — it captures the pager's stdout as a string and
+ * handles scrolling itself in Ink.
  *
  * The value is restricted to a safe shell-token character set since it ends
  * up in arguments passed to spawn() — even though we never use shell:true,

package/dist/lib/metadata.d.ts

@@ -0,0 +1,3 @@
+export declare function getSantreeDir(repoRoot: string): string;
+export declare function readAllMetadata(repoRoot: string): Record<string, any>;
+export declare function writeAllMetadata(repoRoot: string, data: Record<string, any>): void;

package/dist/lib/metadata.js

@@ -0,0 +1,27 @@
+import * as fs from "fs";
+import * as path from "path";
+export function getSantreeDir(repoRoot) {
+    return path.join(repoRoot, ".santree");
+}
+function getMetadataFilePath(repoRoot) {
+    return path.join(getSantreeDir(repoRoot), "metadata.json");
+}
+export function readAllMetadata(repoRoot) {
+    const filePath = getMetadataFilePath(repoRoot);
+    if (!fs.existsSync(filePath))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeAllMetadata(repoRoot, data) {
+    const filePath = getMetadataFilePath(repoRoot);
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
+}

package/dist/lib/multiplexer/cmux.js

@@ -77,7 +77,7 @@ export const cmuxMultiplexer = {
         // follow-up sends to an existing workspace, which doesn't.
         return {
             ok: false,
-            reason: "unsupported",
+            reason: "failed",
             message: "blocked by manaflow-ai/cmux#1472",
         };
     },

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

@@ -3,7 +3,7 @@ export type SessionResult = {
     ok: true;
 } | {
     ok: false;
-    reason: "not-active" | "unsupported" | "failed";
+    reason: "not-active" | "failed";
     message?: string;
 };
 export interface CreateWindowOpts {

package/dist/lib/prompts.d.ts

@@ -1,4 +1,4 @@
-import type { LinearIssue } from "./linear.js";
+import type { Issue } from "./trackers/types.js";
 import type { PRCheck, PRReview, PRReviewComment, FailedCheckDetail, PRConversationComment } from "./github.js";
 /**
  * Render a nunjucks template from the prompts/ directory.
@@ -7,9 +7,10 @@ import type { PRCheck, PRReview, PRReviewComment, FailedCheckDetail, PRConversat
  */
 export declare function renderPrompt(template: string, context: Record<string, string | undefined>): string;
 /**
- * Render a LinearIssue into formatted markdown using the ticket template.
+ * Render an issue into formatted markdown using the ticket template.
+ * `trackerName` is injected for header/link text ("Linear" / "GitHub").
  */
-export declare function renderTicket(issue: LinearIssue): string;
+export declare function renderTicket(issue: Issue, trackerName: string): string;
 export interface DiffData {
     base_branch: string;
     commit_log: string | null;

package/dist/lib/prompts.js

@@ -33,10 +33,11 @@ export function renderPrompt(template, context) {
     return promptsEnv.render(`${template}.njk`, context);
 }
 /**
- * Render a LinearIssue into formatted markdown using the ticket template.
+ * Render an issue into formatted markdown using the ticket template.
+ * `trackerName` is injected for header/link text ("Linear" / "GitHub").
  */
-export function renderTicket(issue) {
-    return promptsEnv.render("ticket.njk", issue);
+export function renderTicket(issue, trackerName) {
+    return promptsEnv.render("ticket.njk", { ...issue, trackerName });
 }
 /**
  * Render diff data into formatted markdown using the diff template.

package/dist/lib/session-signal.d.ts

@@ -4,11 +4,10 @@ export declare function extractRepoAndTicket(cwd: string): {
     repoRoot: string;
     ticketId: string;
 } | null;
-export declare function renameTmuxWindow(ticketId: string, state: SessionStateValue): void;
-export declare function runHookScript(repoRoot: string, state: SessionStateValue, env: Record<string, string>): void;
+export declare function renameSessionWindow(ticketId: string, state: SessionStateValue): void;
 /**
  * Unified helper: reads stdin, extracts repo/ticket, writes state file,
- * renames tmux window, runs hook script, then exits.
+ * renames the multiplexer window, then exits.
  */
 export declare function signalState(state: SessionStateValue): void;
 export declare function getHooksJson(): Record<string, unknown>;