santree 0.7.3 → 0.7.4

package/dist/commands/dashboard.js

@@ -10,7 +10,8 @@ const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 import { findMainRepoRoot, createWorktree, getDefaultBranch, getBaseBranch, hasInitScript, getInitScriptPath, removeWorktree, getDiffTool, getWorktreeStatus, stageFile, unstageFile, stageAll, unstageAll, discardFile, } from "../lib/git.js";
 import { run, spawnAsync } from "../lib/exec.js";
-import { resolveAgentBinary, fillCommitMessage, askTicketQuestion } from "../lib/ai.js";
+import { resolveAgentBinary, resolveClaudeBinary, fillCommitMessage, askTicketQuestion, } from "../lib/ai.js";
+import { readTriageInvestigateConfig, isTriageInvestigateConfigured, buildInvestigatePrompt, buildInvestigateCommand, } from "../lib/triage-config.js";
 import { getInstalledClaudeVersion } from "../lib/version.js";
 import { extractTicketId, getStagedDiffContent } from "../lib/git.js";
 import { getMultiplexer } from "../lib/multiplexer/index.js";
@@ -325,6 +326,11 @@ export default function Dashboard() {
     // Triage tab appears at all. Recomputed on every data refresh — feature
     // detection via `tracker.supportsTriage`, never a kind check.
     const [supportsTriage, setSupportsTriage] = useState(false);
+    // Whether `.santree/metadata.json` configures an "investigate triage ticket"
+    // skill/prompt (`_triage.skill_name` / `_triage.prompt`). Drives whether the
+    // Triage `[i]` action renders enabled (cyan) or greyed. Read fresh on every
+    // data refresh so manual edits to metadata.json show up within a cycle.
+    const [triageInvestigateConfigured, setTriageInvestigateConfigured] = useState(false);
     const refreshTimerRef = useRef(null);
     const repoRootRef = useRef(null);
     const stateRef = useRef(state);
@@ -440,6 +446,7 @@ export default function Dashboard() {
             setHasWorkspaceFile(hasWs);
             const tracker = getIssueTracker(repoRoot);
             setSupportsTriage(tracker.supportsTriage === true);
+            setTriageInvestigateConfigured(isTriageInvestigateConfigured(readTriageInvestigateConfig(repoRoot)));
             dispatch({ type: "SET_DATA", ...data });
             dispatch({ type: "SET_REVIEWS_DATA", flatReviews: reviewData.flatReviews });
             // Triage on-call rotations (Linear). Best-effort, non-blocking — never
@@ -2658,6 +2665,43 @@ export default function Dashboard() {
                 dispatch({ type: "TRIAGE_ASK_OPEN", ticketId: di.issue.identifier });
                 return;
             }
+            // Investigate — hand the ticket to a user-configured skill/prompt in a
+            // new multiplexer window. Config lives in `.santree/metadata.json`
+            // (`_triage.skill_name` or `_triage.prompt`); read fresh so manual
+            // edits take effect without waiting for a refresh.
+            if (input === "i") {
+                const root = repoRootRef.current;
+                if (!root)
+                    return;
+                const prompt = buildInvestigatePrompt(readTriageInvestigateConfig(root), di.issue.identifier);
+                if (!prompt) {
+                    dispatch({
+                        type: "SET_ACTION_MESSAGE",
+                        message: "Set _triage.skill_name (or _triage.prompt) in .santree/metadata.json to enable investigate",
+                    });
+                    return;
+                }
+                const mux = getMultiplexer();
+                if (!mux.isActive()) {
+                    dispatch({
+                        type: "SET_ACTION_MESSAGE",
+                        message: "Investigate needs a multiplexer (tmux or cmux)",
+                    });
+                    return;
+                }
+                const command = buildInvestigateCommand(resolveClaudeBinary() ?? "claude", prompt);
+                const windowName = `investigate-${di.issue.identifier}`;
+                void (async () => {
+                    const created = await mux.createWindow({ name: windowName, cwd: root, command });
+                    dispatch({
+                        type: "SET_ACTION_MESSAGE",
+                        message: created.ok
+                            ? "Launched investigation in new window"
+                            : `Failed to launch investigation${created.message ? `: ${created.message}` : ""}`,
+                    });
+                })();
+                return;
+            }
             if (input === "o") {
                 if (!di.issue.url) {
                     dispatch({ type: "SET_ACTION_MESSAGE", message: "No issue URL available" });
@@ -3108,14 +3152,14 @@ export default function Dashboard() {
                                         ? state.treeDetailScrollOffset
                                         : state.activeTab === "triage"
                                             ? state.triageDetailScrollOffset
-                                            : state.detailScrollOffset, height: contentHeight, width: rightWidth, creatingForTicket: state.creatingForTicket, creationLogs: state.creationLogs, deleteStatus: selectedDeleteStatus, triage: state.activeTab === "triage", comments: triageComments, onCall: onCall })) })] })), _jsx(Box, { children: state.overlay === "diff" ? (_jsx(Box, { width: innerWidth, paddingX: 1, children: _jsx(CommandBar, { showWorkspace: hasWorkspaceFile, mode: "diff" }) })) : state.overlay === "triage-schedule" ? (_jsx(Box, { width: innerWidth, paddingX: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " scroll" }), _jsx(Text, { dimColor: true, children: "  ·  " }), _jsx(Text, { color: "cyan", bold: true, children: "q" }), _jsx(Text, { dimColor: true, children: " close" })] }) })) : (_jsxs(_Fragment, { children: [_jsx(Box, { width: leftWidth + separatorWidth, paddingX: 1, children: _jsx(CommandBar, { showWorkspace: hasWorkspaceFile, mode: "default" }) }), _jsx(Box, { width: rightWidth, children: _jsx(ActionRow, { activeTab: state.activeTab, selectedIssue: selectedIssue, selectedReview: selectedReview, overlay: state.overlay, trackerName: activeTracker.displayName, canMutate: activeTracker.canMutate === true }) })] })) })] })] }));
+                                            : state.detailScrollOffset, height: contentHeight, width: rightWidth, creatingForTicket: state.creatingForTicket, creationLogs: state.creationLogs, deleteStatus: selectedDeleteStatus, triage: state.activeTab === "triage", comments: triageComments, onCall: onCall })) })] })), _jsx(Box, { children: state.overlay === "diff" ? (_jsx(Box, { width: innerWidth, paddingX: 1, children: _jsx(CommandBar, { showWorkspace: hasWorkspaceFile, mode: "diff" }) })) : state.overlay === "triage-schedule" ? (_jsx(Box, { width: innerWidth, paddingX: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " scroll" }), _jsx(Text, { dimColor: true, children: "  ·  " }), _jsx(Text, { color: "cyan", bold: true, children: "q" }), _jsx(Text, { dimColor: true, children: " close" })] }) })) : (_jsxs(_Fragment, { children: [_jsx(Box, { width: leftWidth + separatorWidth, paddingX: 1, children: _jsx(CommandBar, { showWorkspace: hasWorkspaceFile, mode: "default" }) }), _jsx(Box, { width: rightWidth, children: _jsx(ActionRow, { activeTab: state.activeTab, selectedIssue: selectedIssue, selectedReview: selectedReview, overlay: state.overlay, trackerName: activeTracker.displayName, canMutate: activeTracker.canMutate === true, triageInvestigateConfigured: triageInvestigateConfigured }) })] })) })] })] }));
 }
 /**
  * Renders the per-issue action key hints (Resume / Editor / View diff / …)
  * lifted out of the detail panels so they sit on the same row as the global
  * command bar. Empty when nothing is selected.
  */
-function ActionRow({ activeTab, selectedIssue, selectedReview, overlay, trackerName, canMutate, }) {
+function ActionRow({ activeTab, selectedIssue, selectedReview, overlay, trackerName, canMutate, triageInvestigateConfigured, }) {
     // During the diff overlay, none of the per-issue actions apply (View diff
     // is what got us here, Commit/PR/etc. need the detail panel context). Keep
     // the row blank so the diff-specific CommandBar reads cleanly.
@@ -3126,7 +3170,11 @@ function ActionRow({ activeTab, selectedIssue, selectedReview, overlay, trackerN
             ? buildReviewActions(selectedReview)
             : []
         : selectedIssue
-            ? buildIssueActions(selectedIssue, trackerName, { tab: activeTab, canMutate })
+            ? buildIssueActions(selectedIssue, trackerName, {
+                tab: activeTab,
+                canMutate,
+                triageInvestigateConfigured,
+            })
             : [];
     if (items.length === 0)
         return _jsx(Text, { children: " " });

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

@@ -37,6 +37,7 @@ export type IssueActionItem = {
 export declare function buildIssueActions(di: DashboardIssue, trackerName: string, opts?: {
     tab?: DashboardTab;
     canMutate?: boolean;
+    triageInvestigateConfigured?: boolean;
 }): IssueActionItem[];
 export default function DetailPanel({ issue, scrollOffset, height, width, creatingForTicket, creationLogs, deleteStatus, triage, comments, onCall, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/lib/dashboard/DetailPanel.js

@@ -85,6 +85,13 @@ export function buildIssueActions(di, trackerName, opts) {
     if (opts?.tab === "triage") {
         items.push({ key: "w", label: "Send to tree", color: "cyan" });
         items.push({ key: "a", label: "Ask", color: "cyan" });
+        // Greyed until `_triage.skill_name`/`_triage.prompt` is set in
+        // `.santree/metadata.json` — pressing it then just prints a hint.
+        items.push({
+            key: "i",
+            label: "Investigate",
+            color: opts.triageInvestigateConfigured ? "cyan" : "gray",
+        });
         items.push({ key: "s", label: "Schedule", color: "cyan" });
         if (issue.url) {
             items.push({ key: "o", label: trackerName, color: "gray" });

package/dist/lib/dashboard/Overlays.js

@@ -45,6 +45,11 @@ const LEGEND = [
             { glyph: "d", color: "red", meaning: "Delete issue (built-in) / remove worktree (Trees)" },
             { glyph: "w", color: "cyan", meaning: "Start work / send to tree (creates a worktree)" },
             { glyph: "a", color: "cyan", meaning: "Ask Claude about the issue + comments (Triage tab)" },
+            {
+                glyph: "i",
+                color: "cyan",
+                meaning: "Investigate ticket via your configured skill/prompt (Triage tab)",
+            },
             { glyph: "s", color: "cyan", meaning: "Triage on-call schedule (Triage tab)" },
         ],
     },

package/dist/lib/triage-config.d.ts

@@ -0,0 +1,21 @@
+/** Per-repo "investigate triage ticket" config, read from
+ * `.santree/metadata.json` (`_triage.skill_name` / `_triage.prompt`).
+ * metadata.json is gitignored, so this is per-machine — each dev points it at
+ * their own skill or prompt without committing it. */
+export interface TriageInvestigateConfig {
+    /** A Claude slash-command/skill name. Invoked as `/<skill_name> <ticketId>`. */
+    skillName: string | null;
+    /** A free-form prompt template; `{ticket_id}` is substituted with the ticket. */
+    prompt: string | null;
+}
+export declare function readTriageInvestigateConfig(repoRoot: string): TriageInvestigateConfig;
+export declare function isTriageInvestigateConfigured(cfg: TriageInvestigateConfig): boolean;
+/** Builds the prompt handed to Claude for investigating a ticket. Skill name
+ * wins when both are set: `/<skill> <ticketId>`. Otherwise the free-form
+ * template with every `{ticket_id}` replaced. Returns null when unconfigured. */
+export declare function buildInvestigatePrompt(cfg: TriageInvestigateConfig, ticketId: string): string | null;
+/** Builds the shell command line launched in the new multiplexer window:
+ * `<claudeBin> '<prompt>'`. The multiplexer escapes the whole line again for
+ * its send-keys step; this layer just needs the prompt to survive as a single
+ * argv entry so a slash command (`/skill TEAM-1`) reaches Claude intact. */
+export declare function buildInvestigateCommand(claudeBin: string, prompt: string): string;

package/dist/lib/triage-config.js

@@ -0,0 +1,32 @@
+import { readAllMetadata } from "./metadata.js";
+export function readTriageInvestigateConfig(repoRoot) {
+    const all = readAllMetadata(repoRoot);
+    const t = all["_triage"];
+    const skillName = typeof t?.skill_name === "string" && t.skill_name.trim() ? t.skill_name.trim() : null;
+    const prompt = typeof t?.prompt === "string" && t.prompt.trim() ? t.prompt.trim() : null;
+    return { skillName, prompt };
+}
+export function isTriageInvestigateConfigured(cfg) {
+    return cfg.skillName !== null || cfg.prompt !== null;
+}
+/** Builds the prompt handed to Claude for investigating a ticket. Skill name
+ * wins when both are set: `/<skill> <ticketId>`. Otherwise the free-form
+ * template with every `{ticket_id}` replaced. Returns null when unconfigured. */
+export function buildInvestigatePrompt(cfg, ticketId) {
+    if (cfg.skillName)
+        return `/${cfg.skillName} ${ticketId}`;
+    if (cfg.prompt)
+        return cfg.prompt.replace(/\{ticket_id\}/g, ticketId);
+    return null;
+}
+/** POSIX single-quote a shell argument. */
+function shellSingleQuote(s) {
+    return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+/** Builds the shell command line launched in the new multiplexer window:
+ * `<claudeBin> '<prompt>'`. The multiplexer escapes the whole line again for
+ * its send-keys step; this layer just needs the prompt to survive as a single
+ * argv entry so a slash command (`/skill TEAM-1`) reaches Claude intact. */
+export function buildInvestigateCommand(claudeBin, prompt) {
+    return `${claudeBin} ${shellSingleQuote(prompt)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "santree",
-	"version": "0.7.3",
+	"version": "0.7.4",
 	"description": "Git worktree manager",
 	"license": "MIT",
 	"author": "Santiago Toscanini",