mintree 0.4.2 → 0.4.4

package/dist/commands/dashboard.js

@@ -23,11 +23,19 @@ export const description = "Interactive dashboard listing open issues assigned t
 function isOrphan(d) {
     return d.orphan === true;
 }
-function tabIssues(issues, tab) {
-    return issues.filter((d) => (tab === "issues" ? !isOrphan(d) : isOrphan(d)));
+// Matches an issue against the live numeric filter by substring on the digit
+// portion of its id ("PLA-234" → "234", "BE-34" → "34"). Letters are ignored,
+// so the user filters by ticket number alone. Empty filter matches everything.
+function issueMatchesFilter(d, filter) {
+    if (!filter)
+        return true;
+    return d.issue.id.replace(/\D/g, "").includes(filter);
+}
+function tabIssues(issues, tab, filter = "") {
+    return issues.filter((d) => (tab === "issues" ? !isOrphan(d) : isOrphan(d)) && issueMatchesFilter(d, filter));
 }
 function currentSelected(s) {
-    const displayed = tabIssues(s.issues, s.activeTab);
+    const displayed = tabIssues(s.issues, s.activeTab, s.filter);
     const selectedIndex = s.activeTab === "issues" ? s.issuesIndex : s.worktreesIndex;
     return { displayed, selectedIndex };
 }
@@ -186,7 +194,7 @@ function FooterRow({ phase, overlayKind, latestVersion, listWidth, }) {
     // align under the left (list) pane; ticket-specific actions align under
     // the right (detail) pane. Falls back to a single inline row when no
     // width hint is available (e.g. the error path).
-    const common = (_jsxs(Text, { children: [_jsx(Text, { bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " nav " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " PgUp/PgDn" }), _jsx(Text, { dimColor: true, children: " scroll " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " r" }), _jsx(Text, { dimColor: true, children: " refresh " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " q" }), _jsx(Text, { dimColor: true, children: " quit" })] }));
+    const common = (_jsxs(Text, { children: [_jsx(Text, { bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " nav " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " PgUp/PgDn" }), _jsx(Text, { dimColor: true, children: " scroll " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " r" }), _jsx(Text, { dimColor: true, children: " refresh " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " #" }), _jsx(Text, { dimColor: true, children: " filter " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " q" }), _jsx(Text, { dimColor: true, children: " quit" })] }));
     const ticket = (_jsxs(Text, { children: [_jsx(Text, { bold: true, children: "\u21B5" }), _jsx(Text, { dimColor: true, children: " Switch " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " w" }), _jsx(Text, { dimColor: true, children: " Work " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " o" }), _jsx(Text, { dimColor: true, children: " Open " }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { bold: true, children: " d" }), _jsx(Text, { dimColor: true, children: " Remove" })] }));
     return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: listWidth, children: common }), _jsx(Box, { flexGrow: 1, children: ticket })] }), latestVersion && (_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: "(*)" }), _jsx(Text, { dimColor: true, children: ` new version available — v${latestVersion} · npm i -g mintree` })] }))] }));
 }
@@ -674,14 +682,15 @@ export default function Dashboard() {
             const previousOverlay = prevReady?.overlay ?? null;
             const previousToast = prevReady?.toast ?? null;
             const previousScroll = prevReady?.detailScrollOffset ?? 0;
-            const issuesList = tabIssues(issues, "issues");
-            const worktreesList = tabIssues(issues, "worktrees");
+            const filter = prevReady?.filter ?? "";
+            const issuesList = tabIssues(issues, "issues", filter);
+            const worktreesList = tabIssues(issues, "worktrees", filter);
             const issuesIndex = Math.min(previousIssuesIndex, Math.max(0, issuesList.length - 1));
             const worktreesIndex = Math.min(previousWorktreesIndex, Math.max(0, worktreesList.length - 1));
             // Preserve scroll only when the active tab's selected issue still
             // resolves to the same row — clamping or list churn means the user
             // is now reading something else.
-            const prevDisplayed = prevReady ? tabIssues(prevReady.issues, activeTab) : [];
+            const prevDisplayed = prevReady ? tabIssues(prevReady.issues, activeTab, filter) : [];
             const nextDisplayed = activeTab === "issues" ? issuesList : worktreesList;
             const prevSelectedId = prevDisplayed[activeTab === "issues" ? previousIssuesIndex : previousWorktreesIndex]?.issue
                 .id ?? null;
@@ -697,6 +706,7 @@ export default function Dashboard() {
                 refreshing: false,
                 overlay: previousOverlay,
                 toast: previousToast,
+                filter,
             };
         });
     };
@@ -818,12 +828,42 @@ export default function Dashboard() {
             handleOverlayInput(input, key);
             return;
         }
+        // Esc clears an active numeric filter before it falls through to quit —
+        // so the user can back out of a search without leaving the dashboard.
+        if (key.escape && state.phase === "ready" && state.filter) {
+            setState({ ...state, filter: "", issuesIndex: 0, worktreesIndex: 0, detailScrollOffset: 0 });
+            return;
+        }
         if (input === "q" || key.escape || (input === "c" && key.ctrl)) {
             exit();
             return;
         }
         if (state.phase !== "ready")
             return;
+        // Numeric filter: typing a digit narrows the list by ticket number
+        // (matched on the digits of the id, so "34" hits both PLA-234 and BE-34).
+        // Backspace pops a digit; Esc (handled above) clears it. Reset selection
+        // to the first match so the cursor stays on a visible row as it narrows.
+        if (/^[0-9]$/.test(input)) {
+            setState({
+                ...state,
+                filter: state.filter + input,
+                issuesIndex: 0,
+                worktreesIndex: 0,
+                detailScrollOffset: 0,
+            });
+            return;
+        }
+        if ((key.backspace || key.delete) && state.filter) {
+            setState({
+                ...state,
+                filter: state.filter.slice(0, -1),
+                issuesIndex: 0,
+                worktreesIndex: 0,
+                detailScrollOffset: 0,
+            });
+            return;
+        }
         if (key.leftArrow || key.rightArrow) {
             // Two tabs only — either arrow toggles. Per-tab indices are
             // preserved, so the user returns to the row they left.
@@ -1172,7 +1212,7 @@ export default function Dashboard() {
     if (state.phase === "error") {
         return (_jsxs(Box, { width: columns, height: rows, flexDirection: "column", borderStyle: "round", borderColor: "red", paddingX: 1, children: [_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", state.message] }), state.hint && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", state.hint] }) })), _jsx(Box, { marginTop: 1, children: _jsx(FooterRow, { phase: "error" }) })] }));
     }
-    const { issues, refreshing, overlay, toast, activeTab } = state;
+    const { issues, refreshing, overlay, toast, activeTab, filter } = state;
     const { displayed, selectedIndex } = currentSelected(state);
     const selected = displayed[selectedIndex] ?? null;
     const issuesTabCount = issues.reduce((n, d) => (isOrphan(d) ? n : n + 1), 0);
@@ -1224,7 +1264,9 @@ export default function Dashboard() {
         : displayed.map((d, index) => ({ kind: "issue", d, index }));
     const listView = windowListRows(listRows, selectedIndex, listVisibleRows);
     const listContentWidth = Math.max(8, listWidth - 4);
-    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsx(Box, { paddingX: 1, paddingTop: 0, flexDirection: "column", children: _jsx(HeaderRow, { repoName: repoName, claudeVersion: claudeVersion, issueCount: issuesTabCount, worktreeCount: worktreesTabCount, activeTab: activeTab, updateAvailable: latestVersion !== null }) }), overlay ? (_jsx(Box, { flexGrow: 1, flexDirection: "column", borderStyle: "round", borderColor: overlay.kind === "remove" ? "yellow" : "cyan", children: overlay.kind === "create" ? (_jsx(CreateOverlayView, { overlay: overlay, onDescChange: onOverlayDescChange, onPromptChange: onOverlayPromptChange })) : (_jsx(RemoveOverlayView, { overlay: overlay })) })) : (_jsxs(Box, { flexGrow: 1, flexDirection: "row", children: [_jsx(Box, { width: listWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: displayed.length === 0 ? (_jsx(Text, { dimColor: true, children: activeTab === "issues"
-                                ? "No open issues assigned to you in this repo."
-                                : "No orphaned worktrees — anything in `.mintree/worktrees/` matches an open issue." })) : (_jsxs(_Fragment, { children: [listView.sticky.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, width: listContentWidth }, `sticky-${i}`))), listView.issuesAbove > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2191 ", listView.issuesAbove, " more above"] })), listView.body.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, width: listContentWidth }, `body-${i}`))), listView.issuesBelow > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2193 ", listView.issuesBelow, " more below"] }))] })) }), _jsx(Box, { width: detailWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsx(DetailPane, { d: selected, contentWidth: detailWidth - 4, contentHeight: detailContentHeight, scrollOffset: state.detailScrollOffset }) })] })), _jsxs(Box, { paddingX: 1, flexDirection: "column", children: [toast && (_jsx(Box, { children: _jsxs(Text, { color: toast.kind === "success" ? "green" : toast.kind === "error" ? "red" : "cyan", children: [toast.kind === "success" ? "✓ " : toast.kind === "error" ? "✗ " : "· ", toast.text] }) })), refreshing && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { dimColor: true, children: " refreshing" })] })), _jsx(FooterRow, { phase: "ready", overlayKind: overlay?.kind, latestVersion: latestVersion, listWidth: listWidth })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsx(Box, { paddingX: 1, paddingTop: 0, flexDirection: "column", children: _jsx(HeaderRow, { repoName: repoName, claudeVersion: claudeVersion, issueCount: issuesTabCount, worktreeCount: worktreesTabCount, activeTab: activeTab, updateAvailable: latestVersion !== null }) }), overlay ? (_jsx(Box, { flexGrow: 1, flexDirection: "column", borderStyle: "round", borderColor: overlay.kind === "remove" ? "yellow" : "cyan", children: overlay.kind === "create" ? (_jsx(CreateOverlayView, { overlay: overlay, onDescChange: onOverlayDescChange, onPromptChange: onOverlayPromptChange })) : (_jsx(RemoveOverlayView, { overlay: overlay })) })) : (_jsxs(Box, { flexGrow: 1, flexDirection: "row", children: [_jsx(Box, { width: listWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: displayed.length === 0 ? (_jsx(Text, { dimColor: true, children: filter
+                                ? `No tickets match #${filter} — Esc to clear the filter.`
+                                : activeTab === "issues"
+                                    ? "No open issues assigned to you in this repo."
+                                    : "No orphaned worktrees — anything in `.mintree/worktrees/` matches an open issue." })) : (_jsxs(_Fragment, { children: [listView.sticky.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, width: listContentWidth }, `sticky-${i}`))), listView.issuesAbove > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2191 ", listView.issuesAbove, " more above"] })), listView.body.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, width: listContentWidth }, `body-${i}`))), listView.issuesBelow > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2193 ", listView.issuesBelow, " more below"] }))] })) }), _jsx(Box, { width: detailWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsx(DetailPane, { d: selected, contentWidth: detailWidth - 4, contentHeight: detailContentHeight, scrollOffset: state.detailScrollOffset }) })] })), _jsxs(Box, { paddingX: 1, flexDirection: "column", children: [filter && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", bold: true, children: `⌕ #${filter}` }), _jsx(Text, { dimColor: true, children: ` · ${displayed.length} match${displayed.length === 1 ? "" : "es"} · Esc clear` })] })), toast && (_jsx(Box, { children: _jsxs(Text, { color: toast.kind === "success" ? "green" : toast.kind === "error" ? "red" : "cyan", children: [toast.kind === "success" ? "✓ " : toast.kind === "error" ? "✗ " : "· ", toast.text] }) })), refreshing && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { dimColor: true, children: " refreshing" })] })), _jsx(FooterRow, { phase: "ready", overlayKind: overlay?.kind, latestVersion: latestVersion, listWidth: listWidth })] })] }));
 }

package/dist/commands/update.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const description = "Update mintree to the latest version (npm i -g mintree)";
+export declare const options: z.ZodObject<{
+    force: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type Props = {
+    options: z.infer<typeof options>;
+};
+export default function Update({ options: opts }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/commands/update.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text } from "ink";
+import Spinner from "ink-spinner";
+import { option } from "pastel";
+import { z } from "zod";
+import { createRequire } from "module";
+import { getLatestVersion, isNewerVersion } from "../lib/version.js";
+import { installLatest, PACKAGE_NAME } from "../lib/update.js";
+const require = createRequire(import.meta.url);
+const { version: currentVersion } = require("../../package.json");
+export const description = "Update mintree to the latest version (npm i -g mintree)";
+export const options = z.object({
+    force: z
+        .boolean()
+        .default(false)
+        .describe(option({
+        description: "Reinstall even when you're already on the latest version",
+        alias: "f",
+    })),
+});
+export default function Update({ options: opts }) {
+    const [phase, setPhase] = useState({ kind: "checking" });
+    useEffect(() => {
+        let cancelled = false;
+        (async () => {
+            const latest = await getLatestVersion(PACKAGE_NAME);
+            if (cancelled)
+                return;
+            // Skip the reinstall only when we're provably current and the user
+            // didn't force it. A null probe (offline/private registry) falls
+            // through to the install so `mt update` still does something useful.
+            if (!opts.force && latest && !isNewerVersion(currentVersion, latest)) {
+                setPhase({ kind: "uptodate", latest });
+                return;
+            }
+            setPhase({ kind: "installing", latest });
+            const result = await installLatest();
+            if (cancelled)
+                return;
+            setPhase({ kind: "done", result, latest });
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [opts.force]);
+    if (phase.kind === "checking") {
+        return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" Checking for updates... (current v", currentVersion, ")"] })] }));
+    }
+    if (phase.kind === "uptodate") {
+        return (_jsxs(Box, { flexDirection: "column", paddingY: 0, children: [_jsxs(Text, { color: "green", children: ["\u2713 mintree is already up to date (v", phase.latest, ")."] }), _jsx(Text, { dimColor: true, children: "Run with --force to reinstall anyway." })] }));
+    }
+    if (phase.kind === "installing") {
+        const target = phase.latest ? `v${phase.latest}` : "latest";
+        return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", "Updating mintree from v", currentVersion, " to ", target, "..."] })] }));
+    }
+    // done
+    const { result, latest } = phase;
+    if (result.ok) {
+        const target = latest ? `v${latest}` : "the latest version";
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "green", children: ["\u2713 mintree updated to ", target, "."] }), _jsx(Text, { dimColor: true, children: "Open a new shell (or re-run your command) to use it." })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "red", children: "\u2717 Update failed." }), _jsx(Text, { children: result.message }), result.hint ? _jsx(Text, { dimColor: true, children: result.hint }) : null] }));
+}

package/dist/lib/update.d.ts

@@ -0,0 +1,16 @@
+export declare const PACKAGE_NAME = "mintree";
+export type UpdateResult = {
+    ok: true;
+    output: string;
+} | {
+    ok: false;
+    message: string;
+    hint?: string;
+};
+/**
+ * Reinstalls `mintree@latest` globally via npm. Returns a discriminated result
+ * so the command can render a precise message instead of dumping a raw stack.
+ * The common failure — EACCES on a root-owned global prefix — gets a targeted
+ * hint pointing at the usual fixes.
+ */
+export declare function installLatest(): Promise<UpdateResult>;

package/dist/lib/update.js

@@ -0,0 +1,43 @@
+// Self-update: reinstall the globally-installed mintree from npm. The CLI is
+// distributed via `npm i -g mintree`, so updating is just re-running that
+// install for the `@latest` tag. We shell out to `npm` rather than reuse the
+// registry probe in version.ts because npm owns the global prefix, perms, and
+// bin-linking we can't replicate reliably here.
+import { exec } from "child_process";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+// npm global installs can be slow on a cold cache; give them room before we
+// give up. 2 minutes mirrors what a fresh `npm i -g` typically needs.
+const INSTALL_TIMEOUT_MS = 120_000;
+export const PACKAGE_NAME = "mintree";
+/**
+ * Reinstalls `mintree@latest` globally via npm. Returns a discriminated result
+ * so the command can render a precise message instead of dumping a raw stack.
+ * The common failure — EACCES on a root-owned global prefix — gets a targeted
+ * hint pointing at the usual fixes.
+ */
+export async function installLatest() {
+    try {
+        const { stdout, stderr } = await execAsync(`npm install -g ${PACKAGE_NAME}@latest`, {
+            timeout: INSTALL_TIMEOUT_MS,
+        });
+        return { ok: true, output: (stdout || stderr || "").trim() };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, message, hint: hintForError(message) };
+    }
+}
+function hintForError(message) {
+    const m = message.toLowerCase();
+    if (m.includes("eacces") || m.includes("permission denied")) {
+        return "npm couldn't write to its global prefix. Either fix the prefix ownership (npm docs: 'resolving EACCES permissions errors') or re-run with sudo.";
+    }
+    if (m.includes("command not found") || m.includes("not recognized")) {
+        return "npm wasn't found on your PATH. Install Node.js (which bundles npm) and try again.";
+    }
+    if (m.includes("etimedout") || m.includes("network") || m.includes("enotfound")) {
+        return "Looks like a network problem reaching the npm registry. Check your connection and retry.";
+    }
+    return undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mintree",
-	"version": "0.4.2",
+	"version": "0.4.4",
 	"description": "Issue-driven git worktrees + Claude Code sessions for repos with an opinionated SDD+TDD flow.",
 	"license": "MIT",
 	"author": "Martin Mineo <mmineo@canarytechnologies.com>",