mintree 0.1.5 → 0.1.7

package/dist/commands/dashboard.js

@@ -8,11 +8,13 @@ import { createRequire } from "module";
 import { findBranchConventionDoc, findMainRepoRoot, getCurrentBranch, getMintreeDir, pathExists, } from "../lib/git.js";
 import { resolveClaudeBinary } from "../lib/claude.js";
 import { tryExec } from "../lib/exec.js";
+import { getLatestVersion, isNewerVersion } from "../lib/version.js";
 import { ALLOWED_TYPES } from "../lib/branch.js";
 import { runCreate, runCreateDetached } from "../lib/worktreeCreate.js";
 import { runRemove, runRemoveByPath } from "../lib/worktreeRemove.js";
 import { buildCreateMarkers, emitMarkers } from "../lib/markers.js";
-import { loadDashboard, } from "../lib/dashboard.js";
+import { transitionIssueToInProgress } from "../lib/githubProject.js";
+import { loadDashboard } from "../lib/dashboard.js";
 const require = createRequire(import.meta.url);
 const { version: mintreeVersion } = require("../../package.json");
 export const description = "Interactive dashboard listing open issues assigned to you with worktree + session state";
@@ -131,11 +133,7 @@ function sanitizeDesc(value) {
 }
 function openInBrowser(url) {
     try {
-        const cmd = process.platform === "darwin"
-            ? "open"
-            : process.platform === "win32"
-                ? "start"
-                : "xdg-open";
+        const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
         execSync(`${cmd} ${shQuote(url)}`, { stdio: "ignore" });
         return true;
     }
@@ -163,23 +161,23 @@ function useTerminalSize() {
     }, [stdout]);
     return size;
 }
-function HeaderRow({ repoName, claudeVersion, issueCount, }) {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "green", children: "mintree" }), _jsx(Text, { dimColor: true, children: `  v${mintreeVersion}` }), claudeVersion && _jsx(Text, { dimColor: true, children: `   ·   claude ${claudeVersion}` }), repoName && _jsx(Text, { dimColor: true, children: `   ·   ${repoName}` })] }), _jsx(Box, { children: _jsx(Text, { bold: true, backgroundColor: "cyan", color: "black", children: ` Issues (${issueCount}) ` }) })] }));
+function HeaderRow({ repoName, claudeVersion, issueCount, updateAvailable, }) {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "green", children: "mintree" }), _jsx(Text, { dimColor: true, children: `  v${mintreeVersion}` }), updateAvailable && _jsx(Text, { color: "yellow", children: " (*)" }), claudeVersion && _jsx(Text, { dimColor: true, children: `   ·   claude ${claudeVersion}` }), repoName && _jsx(Text, { dimColor: true, children: `   ·   ${repoName}` })] }), _jsx(Box, { children: _jsx(Text, { bold: true, backgroundColor: "cyan", color: "black", children: ` Issues (${issueCount}) ` }) })] }));
 }
-function FooterRow({ phase, overlayKind, }) {
+function FooterRow({ phase, overlayKind, latestVersion, }) {
     if (phase === "error") {
         return (_jsx(Box, { children: _jsx(Text, { dimColor: true, children: "q quit" }) }));
     }
     if (overlayKind === "create") {
-        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Tab" }), _jsx(Text, { dimColor: true, children: " switch field   " }), _jsx(Text, { bold: true, children: "\u2190/\u2192" }), _jsx(Text, { dimColor: true, children: " toggle branch / cycle type   " }), _jsx(Text, { bold: true, children: "Enter" }), _jsx(Text, { dimColor: true, children: " create + work" })] }), _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Esc" }), _jsx(Text, { dimColor: true, children: " cancel" })] })] }));
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Tab" }), _jsx(Text, { dimColor: true, children: " switch field " }), _jsx(Text, { bold: true, children: "\u2190/\u2192" }), _jsx(Text, { dimColor: true, children: " toggle branch / cycle type " }), _jsx(Text, { bold: true, children: "Enter" }), _jsx(Text, { dimColor: true, children: " create + work" })] }), _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Esc" }), _jsx(Text, { dimColor: true, children: " cancel" })] })] }));
     }
     if (overlayKind === "remove") {
-        return (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "y/Y" }), _jsx(Text, { dimColor: true, children: " confirm   " }), _jsx(Text, { bold: true, children: "n/Esc" }), _jsx(Text, { dimColor: true, children: " cancel" })] }));
+        return (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "y/Y" }), _jsx(Text, { dimColor: true, children: " confirm " }), _jsx(Text, { bold: true, children: "n/Esc" }), _jsx(Text, { dimColor: true, children: " cancel" })] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { children: _jsxs(Text, { children: [_jsx(Text, { bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " nav   " }), _jsx(Text, { bold: true, children: "\u21B5" }), _jsx(Text, { dimColor: true, children: " work (resume / create)   " }), _jsx(Text, { bold: true, children: "w" }), _jsx(Text, { dimColor: true, children: " work (always create)   " }), _jsx(Text, { bold: true, children: "d" }), _jsx(Text, { dimColor: true, children: " remove" })] }) }), _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "r" }), _jsx(Text, { dimColor: true, children: " refresh   " }), _jsx(Text, { bold: true, children: "o" }), _jsx(Text, { dimColor: true, children: " open in browser   " }), _jsx(Text, { bold: true, children: "PgUp/PgDn" }), _jsx(Text, { dimColor: true, children: "/" }), _jsx(Text, { bold: true, children: "wheel" }), _jsx(Text, { dimColor: true, children: " scroll detail   " }), _jsx(Text, { bold: true, children: "q" }), _jsx(Text, { dimColor: true, children: " quit" })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { children: _jsxs(Text, { children: [_jsx(Text, { bold: true, children: "j/k" }), _jsx(Text, { dimColor: true, children: " nav " }), _jsx(Text, { bold: true, children: "\u21B5" }), _jsx(Text, { dimColor: true, children: " work (resume / create) " }), _jsx(Text, { bold: true, children: "w" }), _jsx(Text, { dimColor: true, children: " work (always create) " }), _jsx(Text, { bold: true, children: "d" }), _jsx(Text, { dimColor: true, children: " remove" })] }) }), _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "r" }), _jsx(Text, { dimColor: true, children: " refresh " }), _jsx(Text, { bold: true, children: "o" }), _jsx(Text, { dimColor: true, children: " open in browser " }), _jsx(Text, { bold: true, children: "PgUp/PgDn" }), _jsx(Text, { dimColor: true, children: "/" }), _jsx(Text, { bold: true, children: "wheel" }), _jsx(Text, { dimColor: true, children: " scroll detail " }), _jsx(Text, { bold: true, children: "q" }), _jsx(Text, { dimColor: true, children: " quit" })] }), latestVersion && (_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: "(*)" }), _jsx(Text, { dimColor: true, children: ` new version available — v${latestVersion} · npm i -g mintree` })] }))] }));
 }
 function RemoveOverlayView({ overlay }) {
-    return (_jsxs(Box, { flexGrow: 1, flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "Remove worktree" }), _jsx(Text, { dimColor: true, children: ` for #${overlay.issue.issue.number}` })] }), _jsx(Box, { marginTop: 0, children: _jsx(Text, { children: overlay.issue.issue.title }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "Branch: " }), _jsx(Text, { color: "cyan", children: overlay.branch ?? `(detached) ${overlay.worktreePath}` })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "State:  " }), overlay.dirty ? (_jsx(Text, { color: "yellow", children: "dirty (uncommitted changes will be lost)" })) : (_jsx(Text, { color: "green", children: "clean" }))] })] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Text, { dimColor: true, children: "Removing the worktree leaves the branch and the issue's session_id in place. You can re-attach later with `mintree worktree create`." }) }), _jsx(Box, { marginTop: 1, children: overlay.dirty ? (_jsxs(Text, { children: ["This worktree is dirty. Press ", _jsx(Text, { bold: true, color: "red", children: "Y" }), " to force-remove,", " ", _jsx(Text, { bold: true, children: "N" }), "/", _jsx(Text, { bold: true, children: "Esc" }), " to cancel."] })) : (_jsxs(Text, { children: ["Press ", _jsx(Text, { bold: true, color: "green", children: "y" }), " to remove,", " ", _jsx(Text, { bold: true, children: "N" }), "/", _jsx(Text, { bold: true, children: "Esc" }), " to cancel."] })) }), overlay.error && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", overlay.error] }) }))] }));
+    return (_jsxs(Box, { flexGrow: 1, flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "Remove worktree" }), _jsx(Text, { dimColor: true, children: ` for #${overlay.issue.issue.number}` })] }), _jsx(Box, { marginTop: 0, children: _jsx(Text, { children: overlay.issue.issue.title }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "Branch: " }), _jsx(Text, { color: "cyan", children: overlay.branch ?? `(detached) ${overlay.worktreePath}` })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "State: " }), overlay.dirty ? (_jsx(Text, { color: "yellow", children: "dirty (uncommitted changes will be lost)" })) : (_jsx(Text, { color: "green", children: "clean" }))] })] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Text, { dimColor: true, children: "Removing the worktree leaves the branch and the issue's session_id in place. You can re-attach later with `mintree worktree create`." }) }), _jsx(Box, { marginTop: 1, children: overlay.dirty ? (_jsxs(Text, { children: ["This worktree is dirty. Press", " ", _jsx(Text, { bold: true, color: "red", children: "Y" }), " ", "to force-remove, ", _jsx(Text, { bold: true, children: "N" }), "/", _jsx(Text, { bold: true, children: "Esc" }), " to cancel."] })) : (_jsxs(Text, { children: ["Press", " ", _jsx(Text, { bold: true, color: "green", children: "y" }), " ", "to remove, ", _jsx(Text, { bold: true, children: "N" }), "/", _jsx(Text, { bold: true, children: "Esc" }), " to cancel."] })) }), overlay.error && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", overlay.error] }) }))] }));
 }
 function CreateOverlayView({ overlay, onDescChange, onPromptChange, }) {
     const labelWidth = 14;
@@ -191,9 +189,7 @@ function CreateOverlayView({ overlay, onDescChange, onPromptChange, }) {
     const dirPreview = isNewBranch
         ? `${overlay.issue.issue.number}-${overlay.desc}`
         : `${overlay.issue.issue.number}-${detachedDesc}`;
-    return (_jsxs(Box, { flexGrow: 1, flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "Create worktree" }), _jsx(Text, { dimColor: true, children: ` for #${overlay.issue.issue.number}` })] }), _jsx(Box, { marginTop: 0, children: _jsx(Text, { children: overlay.issue.issue.title }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "branchMode", children: overlay.field === "branchMode" ? "▸ Branch:" : "  Branch:" }) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "<  " }), _jsx(Text, { color: overlay.field === "branchMode" ? "cyan" : undefined, bold: overlay.field === "branchMode", children: isNewBranch
-                                            ? "new"
-                                            : `current (${overlay.currentBranch ?? "?"})` }), _jsx(Text, { dimColor: true, children: "  >" })] }), overlay.field === "branchMode" && (_jsx(Text, { dimColor: true, children: "   (use ← / → to toggle)" }))] }), isNewBranch && (_jsxs(_Fragment, { children: [_jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "type", children: overlay.field === "type" ? "▸ Type:" : "  Type:" }) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "<  " }), _jsx(Text, { color: overlay.field === "type" ? "cyan" : undefined, bold: overlay.field === "type", children: overlay.type }), _jsx(Text, { dimColor: true, children: "  >" })] }), overlay.field === "type" && (_jsx(Text, { dimColor: true, children: "   (use ← / → to cycle)" }))] }), _jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "desc", children: overlay.field === "desc" ? "▸ Description:" : "  Description:" }) }), _jsx(Box, { children: overlay.field === "desc" ? (_jsx(TextInput, { value: overlay.desc, onChange: onDescChange, placeholder: "kebab-case" })) : (_jsx(Text, { children: overlay.desc || "(empty)" })) })] })] })), _jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "prompt", children: overlay.field === "prompt" ? "▸ Prompt:" : "  Prompt:" }) }), _jsx(Box, { children: overlay.field === "prompt" ? (_jsx(TextInput, { value: overlay.prompt, onChange: onPromptChange, placeholder: "(empty = no initial message)" })) : (_jsx(Text, { dimColor: true, children: overlay.prompt || "(empty — Claude starts with no message)" })) })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: "  Checkout:" }) }), _jsx(Text, { color: "green", children: branchPreview })] }), _jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: "  Worktree:" }) }), _jsxs(Text, { dimColor: true, children: [".mintree/worktrees/", dirPreview] })] }), _jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: "  Mode:" }) }), _jsx(Text, { dimColor: true, children: "--work (Claude launches in the new worktree)" })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [isNewBranch ? (_jsxs(Text, { dimColor: true, children: ["Suggestion is a kebab of the title (capped at ", SUGGESTED_DESC_MAX_WORDS, " words). Edit it to match your repo's branch conventions."] })) : (_jsxs(Text, { dimColor: true, children: ["Detached HEAD at the tip of ", overlay.currentBranch ?? "the current branch", ". No new branch is created \u2014 commit on a new one with `git switch -c` when ready."] })), isNewBranch && overlay.conventionDoc && (_jsx(Text, { dimColor: true, children: `This repo has \`${overlay.conventionDoc}\` — review it before creating.` }))] }), overlay.error && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", overlay.error] }) }))] }));
+    return (_jsxs(Box, { flexGrow: 1, flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "Create worktree" }), _jsx(Text, { dimColor: true, children: ` for #${overlay.issue.issue.number}` })] }), _jsx(Box, { marginTop: 0, children: _jsx(Text, { children: overlay.issue.issue.title }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "branchMode", children: overlay.field === "branchMode" ? "▸ Branch:" : "  Branch:" }) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "<  " }), _jsx(Text, { color: overlay.field === "branchMode" ? "cyan" : undefined, bold: overlay.field === "branchMode", children: isNewBranch ? "new" : `current (${overlay.currentBranch ?? "?"})` }), _jsx(Text, { dimColor: true, children: "  >" })] }), overlay.field === "branchMode" && _jsx(Text, { dimColor: true, children: "   (use ← / → to toggle)" })] }), isNewBranch && (_jsxs(_Fragment, { children: [_jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "type", children: overlay.field === "type" ? "▸ Type:" : "  Type:" }) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "<  " }), _jsx(Text, { color: overlay.field === "type" ? "cyan" : undefined, bold: overlay.field === "type", children: overlay.type }), _jsx(Text, { dimColor: true, children: "  >" })] }), overlay.field === "type" && _jsx(Text, { dimColor: true, children: "   (use ← / → to cycle)" })] }), _jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "desc", children: overlay.field === "desc" ? "▸ Description:" : "  Description:" }) }), _jsx(Box, { children: overlay.field === "desc" ? (_jsx(TextInput, { value: overlay.desc, onChange: onDescChange, placeholder: "kebab-case" })) : (_jsx(Text, { children: overlay.desc || "(empty)" })) })] })] })), _jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "prompt", children: overlay.field === "prompt" ? "▸ Prompt:" : "  Prompt:" }) }), _jsx(Box, { children: overlay.field === "prompt" ? (_jsx(TextInput, { value: overlay.prompt, onChange: onPromptChange, placeholder: "(empty = no initial message)" })) : (_jsx(Text, { dimColor: true, children: overlay.prompt || "(empty — Claude starts with no message)" })) })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: " Checkout:" }) }), _jsx(Text, { color: "green", children: branchPreview })] }), _jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: " Worktree:" }) }), _jsxs(Text, { dimColor: true, children: [".mintree/worktrees/", dirPreview] })] }), _jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: " Mode:" }) }), _jsx(Text, { dimColor: true, children: "--work (Claude launches in the new worktree)" })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [isNewBranch ? (_jsxs(Text, { dimColor: true, children: ["Suggestion is a kebab of the title (capped at ", SUGGESTED_DESC_MAX_WORDS, " words). Edit it to match your repo's branch conventions."] })) : (_jsxs(Text, { dimColor: true, children: ["Detached HEAD at the tip of ", overlay.currentBranch ?? "the current branch", ". No new branch is created \u2014 commit on a new one with `git switch -c` when ready."] })), isNewBranch && overlay.conventionDoc && (_jsx(Text, { dimColor: true, children: `This repo has \`${overlay.conventionDoc}\` — review it before creating.` }))] }), overlay.error && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", overlay.error] }) })), overlay.pending && (_jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", overlay.pending] })] }))] }));
 }
 function stateChar(state) {
     if (!state)
@@ -242,7 +238,10 @@ function wrapLine(s, width) {
 // (consecutive empty lines collapse to one) and trimming leading/trailing
 // blank lines. Used to feed the description into the flat-line renderer.
 function wrapBody(body, width) {
-    const raw = body.replace(/\r\n/g, "\n").split("\n").map(l => l.trimEnd());
+    const raw = body
+        .replace(/\r\n/g, "\n")
+        .split("\n")
+        .map((l) => l.trimEnd());
     while (raw.length > 0 && raw[0] === "")
         raw.shift();
     while (raw.length > 0 && raw[raw.length - 1] === "")
@@ -286,14 +285,17 @@ function buildDetailLines(d, width) {
     const titleWrapped = wrapLine(d.issue.title, Math.max(8, w - titlePrefix.length));
     titleWrapped.forEach((chunk, i) => {
         if (i === 0) {
-            lines.push([{ text: titlePrefix, bold: true }, { text: chunk, bold: true }]);
+            lines.push([
+                { text: titlePrefix, bold: true },
+                { text: chunk, bold: true },
+            ]);
         }
         else {
             lines.push([{ text: " ".repeat(titlePrefix.length) + chunk, bold: true }]);
         }
     });
-    const labels = d.issue.labels.map(l => l.name);
-    const labelText = labels.length > 0 ? labels.map(l => `[${l}]`).join(" ") : "(no labels)";
+    const labels = d.issue.labels.map((l) => l.name);
+    const labelText = labels.length > 0 ? labels.map((l) => `[${l}]`).join(" ") : "(no labels)";
     for (const w2 of wrapLine(labelText, w))
         lines.push([{ text: w2, dim: true }]);
     lines.push([
@@ -321,9 +323,7 @@ function buildDetailLines(d, width) {
         for (const w2 of wrapLine(` path:   ${d.worktree.path}`, w))
             lines.push([{ text: w2, dim: true }]);
         const statusLine = [{ text: ` status: `, dim: true }];
-        statusLine.push(d.worktree.dirty
-            ? { text: "dirty", color: "yellow" }
-            : { text: "clean", color: "green" });
+        statusLine.push(d.worktree.dirty ? { text: "dirty", color: "yellow" } : { text: "clean", color: "green" });
         if (d.worktree.ab) {
             statusLine.push({
                 text: `  +${d.worktree.ab.ahead} / -${d.worktree.ab.behind}`,
@@ -400,6 +400,8 @@ export default function Dashboard() {
     const [state, setState] = useState({ phase: "loading" });
     const [repoName, setRepoName] = useState(null);
     const [claudeVersion, setClaudeVersion] = useState(null);
+    // Set only when the npm registry reports a strictly newer version.
+    const [latestVersion, setLatestVersion] = useState(null);
     const { columns, rows } = useTerminalSize();
     // Switch to the alt-screen buffer once, synchronously, on the first render
     // pass. Doing this here (instead of inside a useEffect) is what makes the
@@ -446,7 +448,7 @@ export default function Dashboard() {
             });
             return;
         }
-        setState(prev => {
+        setState((prev) => {
             const previousIndex = prev.phase === "ready" ? prev.selectedIndex : 0;
             const previousOverlay = prev.phase === "ready" ? prev.overlay : null;
             const previousToast = prev.phase === "ready" ? prev.toast : null;
@@ -480,6 +482,10 @@ export default function Dashboard() {
                     setClaudeVersion(m && m[1] ? m[1] : v);
                 }
             }
+            const latest = await getLatestVersion("mintree");
+            if (latest && isNewerVersion(mintreeVersion, latest)) {
+                setLatestVersion(latest);
+            }
         })();
     }, []);
     // SGR mouse tracking: enable on mount, disable on unmount, and route
@@ -505,7 +511,7 @@ export default function Dashboard() {
                 const inLeftPane = col <= lw;
                 // Functional setState so a fast wheel doesn't read stale
                 // scroll/selection through the ref between dispatches.
-                setState(prev => {
+                setState((prev) => {
                     if (prev.phase !== "ready")
                         return prev;
                     if (prev.overlay)
@@ -638,10 +644,7 @@ export default function Dashboard() {
                 // as `worktree create --work`, minus the create. The wrapper
                 // will cd + run `mintree worktree work`, which itself sees the
                 // session_id in metadata and uses --resume.
-                emitMarkers([
-                    `MINTREE_CD:${issue.worktree.path}`,
-                    "MINTREE_WORK:1",
-                ]);
+                emitMarkers([`MINTREE_CD:${issue.worktree.path}`, "MINTREE_WORK:1"]);
                 exit();
                 return;
             }
@@ -684,6 +687,7 @@ export default function Dashboard() {
                 field: "branchMode",
                 error: null,
                 conventionDoc: root ? findBranchConventionDoc(root) : null,
+                pending: null,
             },
             toast: null,
         });
@@ -692,6 +696,12 @@ export default function Dashboard() {
         if (state.phase !== "ready" || !state.overlay)
             return;
         const overlay = state.overlay;
+        // When a create overlay is finishing its post-create transition the
+        // worktree is already on disk and we're about to exit() — freeze the
+        // overlay so escape / stray keys don't dismiss it mid-flight.
+        if (overlay.kind === "create" && overlay.pending) {
+            return;
+        }
         if (key.escape || (input === "c" && key.ctrl)) {
             setState({ ...state, overlay: null });
             return;
@@ -700,7 +710,6 @@ export default function Dashboard() {
             handleRemoveOverlayInput(input, key, overlay);
             return;
         }
-        // Create overlay from here on.
         // In "current" branch mode we skip type+desc fields entirely — they have
         // no meaning when the worktree is going to be detached. Tab cycles
         // branchMode ⇄ prompt only.
@@ -804,6 +813,23 @@ export default function Dashboard() {
             });
             return;
         }
+        // Worktree's on disk — keep the overlay visible while we move the issue
+        // to In Progress on its project. Errors from the GraphQL call don't
+        // block the worktree hand-off; we swallow them and let `mintree doctor`
+        // surface persistent issues (missing `project` scope, etc.).
+        setState({
+            ...state,
+            overlay: { ...overlay, error: null, pending: "Updating issue status..." },
+        });
+        const repoRoot = findMainRepoRoot();
+        if (repoRoot) {
+            try {
+                await transitionIssueToInProgress(repoRoot, issueNumber);
+            }
+            catch {
+                // best effort — surface via doctor / next dashboard refresh
+            }
+        }
         emitMarkers(buildCreateMarkers({
             worktreePath: result.worktreePath,
             work: result.work,
@@ -870,10 +896,10 @@ export default function Dashboard() {
     // Left pane is the issue list — it only needs room for "#N  ICON  title".
     // We give it ~40% of the width so the detail pane (URLs, descriptions,
     // branch paths) has the room it actually needs.
-    const listWidthPct = 0.40;
+    const listWidthPct = 0.4;
     const listWidth = Math.max(32, Math.floor(columns * listWidthPct));
     const detailWidth = columns - listWidth - 2; // border slack
-    const identifierWidth = Math.max(3, ...issues.map(d => `#${d.issue.number}`.length));
+    const identifierWidth = Math.max(3, ...issues.map((d) => `#${d.issue.number}`.length));
     // Lista ocupa todo menos: " #N  ICON  " (id + 4 cols of pad/icon).
     const maxTitleWidth = Math.max(8, listWidth - identifierWidth - 8);
     // Reserve rows: header (2), top borders (1), footer (3).
@@ -889,12 +915,8 @@ export default function Dashboard() {
     const startIdx = Math.max(0, Math.min(Math.max(0, issues.length - listVisibleRows), selectedIndex - Math.floor(listVisibleRows / 2)));
     const endIdx = Math.min(issues.length, startIdx + listVisibleRows);
     const slice = issues.slice(startIdx, endIdx);
-    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: issues.length }) }), 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: issues.length === 0 ? (_jsx(Text, { dimColor: true, children: "No open issues assigned to you in this repo." })) : (_jsxs(_Fragment, { children: [slice.map((d, i) => {
+    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: issues.length, 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: issues.length === 0 ? (_jsx(Text, { dimColor: true, children: "No open issues assigned to you in this repo." })) : (_jsxs(_Fragment, { children: [slice.map((d, i) => {
                                     const absoluteIdx = startIdx + i;
                                     return (_jsx(IssueListRow, { d: d, selected: absoluteIdx === selectedIndex, identifierWidth: identifierWidth, maxTitleWidth: maxTitleWidth }, d.issue.number));
-                                }), startIdx > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2191 ", startIdx, " more above"] })), endIdx < issues.length && (_jsxs(Text, { dimColor: true, children: ["\u2193 ", issues.length - endIdx, " 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 })] })] }));
+                                }), startIdx > 0 && _jsxs(Text, { dimColor: true, children: ["\u2191 ", startIdx, " more above"] }), endIdx < issues.length && (_jsxs(Text, { dimColor: true, children: ["\u2193 ", issues.length - endIdx, " 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 })] })] }));
 }

package/dist/commands/doctor.js

@@ -7,6 +7,7 @@ import * as path from "path";
 import { createRequire } from "module";
 import { tryExec, getPath } from "../lib/exec.js";
 import { ghCliAvailable, getGhUserLogin, getRepoFullName } from "../lib/github.js";
+import { getGhTokenScopes, hasProjectScope } from "../lib/githubProject.js";
 import { resolveClaudeBinary } from "../lib/claude.js";
 import { findMainRepoRoot, getMintreeDir, getInitScriptPath, isGitIgnored, isExecutable, pathExists, } from "../lib/git.js";
 const require = createRequire(import.meta.url);
@@ -110,6 +111,19 @@ async function checkGithubIssues() {
             : undefined,
     };
 }
+async function checkProjectScope() {
+    const scopes = await getGhTokenScopes();
+    if (scopes === null) {
+        // Auth/install issue — surfaced by the gh row already.
+        return { scopes: null, hasScope: false };
+    }
+    const ok = hasProjectScope(scopes);
+    return {
+        scopes,
+        hasScope: ok,
+        hint: ok ? undefined : "Run: gh auth refresh -s project",
+    };
+}
 function checkRemoteControl() {
     const home = process.env["HOME"] || "";
     const configPath = path.join(home, ".claude.json");
@@ -153,7 +167,7 @@ function checkSessionSignalHooks() {
             }
             const found = eventHooks.some((entry) => {
                 const inner = entry.hooks || [];
-                return inner.some(h => typeof h.command === "string" && h.command.includes("mintree helpers session-signal"));
+                return inner.some((h) => typeof h.command === "string" && h.command.includes("mintree helpers session-signal"));
             });
             if (!found)
                 missing.push(event);
@@ -239,13 +253,23 @@ 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.path && _jsxs(Text, { dimColor: true, children: ["Path: ", tool.path] }), tool.authStatus && _jsxs(Text, { dimColor: true, children: ["Auth: ", tool.authStatus] }), tool.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.hint] }) }))] }));
 }
+function ProjectScopeRow({ status }) {
+    // Optional — auto-discovery still works for the "list issues" path even
+    // without the `project` scope; the scope only matters when we need to
+    // write status back to a Project v2 board (the `w` flow does this).
+    if (status.scopes === null) {
+        // gh not installed / not authenticated — handled by the gh row.
+        return null;
+    }
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.hasScope, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "GitHub Project v2 Scope" }), _jsx(Text, { dimColor: true, children: " - lets `w` move the issue to In Progress" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Token scopes: ", status.scopes.join(", ") || "(none)"] }), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })] }));
+}
 function GithubIssuesRow({ gh }) {
     // Required only when we're inside a git repo. Outside one, the row is
     // purely informational (auth check) so doctor can stay green when run
     // from $HOME or any non-repo directory.
     const required = gh.inGitRepo;
     const ok = required ? gh.authenticated && !!gh.repoName : gh.authenticated;
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: ok, required: required }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "GitHub Issues" }), _jsx(Text, { dimColor: true, children: " - issue listing + PR ops" }), !required && _jsx(Text, { dimColor: true, children: " (no repo here)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [gh.authenticated ? (_jsxs(_Fragment, { children: [_jsxs(Text, { dimColor: true, children: ["User: ", gh.accountName] }), required && (_jsxs(Text, { dimColor: true, children: ["Repo: ", gh.repoName ?? "(not a GitHub repo)"] }))] })) : (_jsx(Text, { dimColor: true, children: "Not authenticated" })), gh.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", gh.hint] })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: ok, required: required }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "GitHub Issues" }), _jsx(Text, { dimColor: true, children: " - issue listing + PR ops" }), !required && _jsx(Text, { dimColor: true, children: " (no repo here)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [gh.authenticated ? (_jsxs(_Fragment, { children: [_jsxs(Text, { dimColor: true, children: ["User: ", gh.accountName] }), required && _jsxs(Text, { dimColor: true, children: ["Repo: ", gh.repoName ?? "(not a GitHub repo)"] })] })) : (_jsx(Text, { dimColor: true, children: "Not authenticated" })), gh.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", gh.hint] })] })] }));
 }
 function ShellRow({ status }) {
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.configured, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Shell Integration" }), _jsx(Text, { dimColor: true, children: " - enables `cd` into worktrees" })] }), _jsx(Box, { marginLeft: 2, flexDirection: "column", children: status.configured ? (_jsxs(Text, { dimColor: true, children: ["Shell: ", status.shell ?? "unknown", " (MINTREE_SHELL_INTEGRATION=1)"] })) : status.shell ? (_jsx(Text, { color: "yellow", children: `↳ Add to ~/.${status.shell}rc: eval "$(mintree helpers shell-init ${status.shell})"` })) : (_jsx(Text, { color: "yellow", children: "\u21B3 Unsupported shell. mintree shell integration supports zsh and bash." })) })] }));
@@ -274,6 +298,7 @@ function MintreeSetupRow({ status }) {
 export default function Doctor() {
     const [tools, setTools] = useState(null);
     const [gh, setGh] = useState(null);
+    const [projectScope, setProjectScope] = useState(null);
     const [rc, setRc] = useState(null);
     const [hooks, setHooks] = useState(null);
     const [setup, setSetup] = useState(null);
@@ -303,25 +328,27 @@ export default function Doctor() {
             };
             toolResults.unshift(nodeRow);
             const ghRes = await checkGithubIssues();
+            const projectScopeRes = await checkProjectScope();
             setTools(toolResults);
             setGh(ghRes);
+            setProjectScope(projectScopeRes);
             setRc(checkRemoteControl());
             setHooks(checkSessionSignalHooks());
             setSetup(checkMintreeSetup());
             setShell(checkShellIntegration());
         })();
     }, []);
-    const loading = !tools || !gh || !rc || !hooks || !setup || !shell;
+    const loading = !tools || !gh || !projectScope || !rc || !hooks || !setup || !shell;
     if (loading) {
         return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Checking system requirements..." })] }));
     }
-    const requiredMissing = tools.filter(t => t.required && (!t.installed || t.hint));
-    const optionalMissing = tools.filter(t => !t.required && !t.installed);
+    const requiredMissing = tools.filter((t) => t.required && (!t.installed || t.hint));
+    const optionalMissing = tools.filter((t) => !t.required && !t.installed);
     // GitHub Issues only counts toward the required tally when we're inside a
     // git repo; otherwise the auth-only check is purely informational.
     const ghOk = gh.inGitRepo ? gh.authenticated && !!gh.repoName : true;
     const shellOk = shell.configured;
     const allRequired = requiredMissing.length === 0 && ghOk && shellOk;
     const requiredFailing = requiredMissing.length + (ghOk ? 0 : 1) + (shellOk ? 0 : 1);
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Mintree 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(t => (_jsx(ToolRow, { tool: t }, t.name))), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Integrations" }) }), _jsx(GithubIssuesRow, { gh: gh }), _jsx(ShellRow, { status: shell }), _jsx(MintreeSetupRow, { status: setup }), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Claude Code" }) }), _jsx(RemoteControlRow, { status: rc }), _jsx(SessionSignalRow, { status: hooks }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: allRequired ? "green" : "yellow", paddingX: 2, children: allRequired ? (_jsx(Text, { color: "green", children: "All required checks pass. mintree is ready to use." })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: [requiredFailing, " required item(s) need attention"] }), optionalMissing.length > 0 && (_jsxs(Text, { dimColor: true, children: [optionalMissing.length, " optional item(s) not installed"] }))] })) })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Mintree 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((t) => (_jsx(ToolRow, { tool: t }, t.name))), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Integrations" }) }), _jsx(GithubIssuesRow, { gh: gh }), _jsx(ProjectScopeRow, { status: projectScope }), _jsx(ShellRow, { status: shell }), _jsx(MintreeSetupRow, { status: setup }), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Claude Code" }) }), _jsx(RemoteControlRow, { status: rc }), _jsx(SessionSignalRow, { status: hooks }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: allRequired ? "green" : "yellow", paddingX: 2, children: allRequired ? (_jsx(Text, { color: "green", children: "All required checks pass. mintree is ready to use." })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: [requiredFailing, " required item(s) need attention"] }), optionalMissing.length > 0 && (_jsxs(Text, { dimColor: true, children: [optionalMissing.length, " optional item(s) not installed"] }))] })) })] }));
 }

package/dist/commands/init.js

@@ -121,7 +121,7 @@ export default function Init() {
     if (!result.ok) {
         return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", result.message] }), result.hint && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", result.hint] }) }))] }));
     }
-    const anyChange = result.steps.some(s => s.kind === "created" || s.kind === "added");
+    const anyChange = result.steps.some((s) => s.kind === "created" || s.kind === "added");
     return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree init" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", result.repoRoot] })] }), result.steps.map((step, i) => {
                 const detail = stepDetail(step.kind);
                 return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(StepIcon, { kind: step.kind }), _jsx(Text, { children: " " }), _jsx(Text, { children: step.label }), detail && _jsxs(Text, { dimColor: true, children: [" (", detail, ")"] })] }), step.hint && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", step.hint] }) }))] }, i));

package/dist/commands/worktree/clean.js

@@ -67,7 +67,7 @@ async function loadCandidates(force) {
     if (ours.length === 0) {
         return { phase: "nothing", message: "No mintree worktrees in this repo. Nothing to clean." };
     }
-    const prs = await Promise.all(ours.map(w => fetchPr(w.branch)));
+    const prs = await Promise.all(ours.map((w) => fetchPr(w.branch)));
     const candidates = [];
     for (let i = 0; i < ours.length; i++) {
         const w = ours[i];
@@ -96,7 +96,7 @@ async function loadCandidates(force) {
     return { phase: "prompt", repoRoot: root, candidates };
 }
 function executeRemovals(repoRoot, candidates) {
-    const toRemove = candidates.filter(c => c.willClean);
+    const toRemove = candidates.filter((c) => c.willClean);
     const results = [];
     for (const c of toRemove) {
         try {
@@ -120,7 +120,10 @@ function PrTag({ pr }) {
 }
 export default function Clean({ options }) {
     const { exit } = useApp();
-    const [state, setState] = useState({ phase: "loading", message: "Inspecting worktrees..." });
+    const [state, setState] = useState({
+        phase: "loading",
+        message: "Inspecting worktrees...",
+    });
     useEffect(() => {
         (async () => {
             try {
@@ -193,14 +196,14 @@ export default function Clean({ options }) {
         return (_jsx(Box, { padding: 1, children: _jsx(Text, { dimColor: true, children: state.message }) }));
     }
     if (state.phase === "prompt" || state.phase === "executing") {
-        const willCleanCount = state.candidates.filter(c => c.willClean).length;
-        return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree clean" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", state.candidates.length, " candidate(s)"] })] }), state.candidates.map((c, i) => (_jsxs(Box, { children: [_jsx(Text, { color: c.willClean ? "green" : "yellow", children: c.willClean ? "✓" : "○" }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: c.branch }), _jsx(Text, { children: " " }), _jsx(PrTag, { pr: c.pr }), c.dirty && _jsx(Text, { color: "yellow", children: " [dirty]" }), c.reasonSkipped && _jsxs(Text, { dimColor: true, children: [" \u2014 ", c.reasonSkipped] })] }, i))), _jsx(Box, { marginTop: 1, children: state.phase === "prompt" ? (_jsxs(Text, { children: ["Remove ", willCleanCount, " worktree(s)?", " ", _jsx(Text, { bold: true, children: "[y/N]" })] })) : (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Removing..." })] })) })] }));
+        const willCleanCount = state.candidates.filter((c) => c.willClean).length;
+        return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree clean" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", state.candidates.length, " candidate(s)"] })] }), state.candidates.map((c, i) => (_jsxs(Box, { children: [_jsx(Text, { color: c.willClean ? "green" : "yellow", children: c.willClean ? "✓" : "○" }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: c.branch }), _jsx(Text, { children: " " }), _jsx(PrTag, { pr: c.pr }), c.dirty && _jsx(Text, { color: "yellow", children: " [dirty]" }), c.reasonSkipped && _jsxs(Text, { dimColor: true, children: [" \u2014 ", c.reasonSkipped] })] }, i))), _jsx(Box, { marginTop: 1, children: state.phase === "prompt" ? (_jsxs(Text, { children: ["Remove ", willCleanCount, " worktree(s)? ", _jsx(Text, { bold: true, children: "[y/N]" })] })) : (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Removing..." })] })) })] }));
     }
     // state.phase === "done"
     if (state.cancelled) {
         return (_jsx(Box, { padding: 1, children: _jsx(Text, { dimColor: true, children: "Cancelled. No worktrees were removed." }) }));
     }
-    const okCount = state.results.filter(r => r.ok).length;
+    const okCount = state.results.filter((r) => r.ok).length;
     const failCount = state.results.length - okCount;
     return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "mintree worktree clean \u00B7 done" }) }), state.results.map((r, i) => (_jsxs(Box, { children: [_jsx(Text, { color: r.ok ? "green" : "red", children: r.ok ? "✓" : "✗" }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: r.branch }), !r.ok && _jsxs(Text, { color: "red", children: [" \u2014 ", r.error] })] }, i))), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: ["Removed ", okCount, failCount > 0 && (_jsxs(_Fragment, { children: [", ", _jsxs(Text, { color: "red", children: [failCount, " failed"] })] })), ". Branches and metadata preserved."] }) })] }));
 }

package/dist/commands/worktree/create.js

@@ -7,11 +7,11 @@ import { z } from "zod";
 import { PERMISSION_MODES } from "../../lib/claude.js";
 import { runCreate } from "../../lib/worktreeCreate.js";
 import { buildCreateMarkers, emitMarkers } from "../../lib/markers.js";
+import { findMainRepoRoot } from "../../lib/git.js";
+import { transitionIssueToInProgress, describeTransition, } from "../../lib/githubProject.js";
 export const description = "Create a worktree for an issue branch";
 export const args = z.tuple([
-    z
-        .string()
-        .describe(argument({
+    z.string().describe(argument({
         name: "branch",
         description: "Branch in `<type>/<issue>-<kebab-desc>` format (e.g. feat/100-claude-md-inicial)",
     })),
@@ -53,6 +53,7 @@ function StepIcon({ kind }) {
 export default function Create({ args, options }) {
     const [branch] = args;
     const [result, setResult] = useState(null);
+    const [transition, setTransition] = useState("idle");
     useEffect(() => {
         setTimeout(() => {
             try {
@@ -68,26 +69,70 @@ export default function Create({ args, options }) {
             }
         }, 0);
     }, [branch, options.base, options.work, options.prompt, options.permissionMode]);
-    // Emit shell-wrapper markers when create succeeded. Goes through the
-    // emitMarkers helper so it lands in MINTREE_MARKER_FILE if set, otherwise
-    // stdout. Bypasses Ink so word-wrap can't split a long path mid-marker.
+    // Kick the Project v2 transition once the worktree is in place. Only when
+    // --work was on — non-work creates leave status untouched. Errors from the
+    // GraphQL call surface as a step but never block the worktree hand-off.
     useEffect(() => {
         if (!result || !result.ok)
             return;
+        if (!result.work) {
+            setTransition("skipped");
+            return;
+        }
+        setTransition("running");
+        let cancelled = false;
+        (async () => {
+            const root = findMainRepoRoot();
+            if (!root) {
+                if (!cancelled)
+                    setTransition("skipped");
+                return;
+            }
+            try {
+                const r = await transitionIssueToInProgress(root, result.issueId);
+                if (!cancelled)
+                    setTransition(r);
+            }
+            catch (err) {
+                if (cancelled)
+                    return;
+                setTransition({
+                    kind: "error",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [result]);
+    // Emit shell-wrapper markers when create succeeded AND the transition has
+    // settled (run or skipped). Goes through the emitMarkers helper so it
+    // lands in MINTREE_MARKER_FILE if set, otherwise stdout. Bypasses Ink so
+    // word-wrap can't split a long path mid-marker.
+    useEffect(() => {
+        if (!result || !result.ok)
+            return;
+        if (transition === "idle" || transition === "running")
+            return;
         emitMarkers(buildCreateMarkers({
             worktreePath: result.worktreePath,
             work: result.work,
             promptFile: result.promptFile,
             permissionMode: result.permissionMode,
         }));
-    }, [result]);
+    }, [result, transition]);
     if (!result) {
         return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" Creating worktree for ", branch, "..."] })] }));
     }
     if (!result.ok) {
         return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", result.message] }), result.hint && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", result.hint] }) }))] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree create" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", result.branch] })] }), result.steps.map((step, i) => (_jsxs(Box, { children: [_jsx(StepIcon, { kind: step.kind }), _jsx(Text, { children: " " }), _jsx(Text, { children: step.label }), step.detail && _jsxs(Text, { dimColor: true, children: [" (", step.detail, ")"] })] }, i))), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: "green", children: ["Worktree ready at ", _jsx(Text, { bold: true, children: result.worktreePath })] }), _jsx(Text, { dimColor: true, children: result.work
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree create" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", result.branch] })] }), result.steps.map((step, i) => (_jsxs(Box, { children: [_jsx(StepIcon, { kind: step.kind }), _jsx(Text, { children: " " }), _jsx(Text, { children: step.label }), step.detail && _jsxs(Text, { dimColor: true, children: [" (", step.detail, ")"] })] }, i))), transition === "running" && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Updating issue status..." })] })), typeof transition === "object" &&
+                (() => {
+                    const step = describeTransition(transition);
+                    return (_jsxs(Box, { children: [_jsx(StepIcon, { kind: step.kind }), _jsx(Text, { children: " " }), _jsx(Text, { children: step.label }), step.detail && _jsxs(Text, { dimColor: true, children: [" (", step.detail, ")"] })] }));
+                })(), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: "green", children: ["Worktree ready at ", _jsx(Text, { bold: true, children: result.worktreePath })] }), _jsx(Text, { dimColor: true, children: result.work
                             ? "Launching Claude in the new worktree..."
                             : "Next: `mt worktree work` to start a Claude session, or `cd` and run `claude` directly." })] })] }));
 }

package/dist/commands/worktree/list.js

@@ -58,7 +58,7 @@ async function load(checkPr) {
     }
     const worktreesDir = getWorktreesDir(root);
     const all = listWorktrees(root);
-    const ours = all.filter(w => {
+    const ours = all.filter((w) => {
         // Filter to worktrees that live under .mintree/worktrees/. macOS reports
         // /private/tmp paths so use a relative-prefix check after resolving both
         // to absolute.
@@ -70,7 +70,7 @@ async function load(checkPr) {
         return { phase: "empty", repoRoot: root };
     }
     const metadata = readMetadata(root);
-    const rows = ours.map(w => {
+    const rows = ours.map((w) => {
         const issueId = extractIssueId(w.branch);
         const baseFromMeta = issueId ? metadata.issues[issueId]?.base_branch : undefined;
         return {
@@ -82,7 +82,7 @@ async function load(checkPr) {
         };
     });
     if (checkPr) {
-        const prResults = await Promise.all(rows.map(r => (r.branch === "(detached)" ? Promise.resolve(undefined) : fetchPrStatus(r.branch))));
+        const prResults = await Promise.all(rows.map((r) => r.branch === "(detached)" ? Promise.resolve(undefined) : fetchPrStatus(r.branch)));
         rows.forEach((r, i) => {
             r.pr = prResults[i];
         });
@@ -137,7 +137,7 @@ export default function List({ options }) {
     if (state.phase === "empty") {
         return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Text, { dimColor: true, children: ["No mintree worktrees in ", state.repoRoot, "."] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: ["Create one with ", _jsx(Text, { bold: true, children: "mintree worktree create <branch>" }), "."] }) })] }));
     }
-    const issueWidth = Math.max(5, ...state.rows.map(r => (r.issueId ?? "—").length));
-    const branchWidth = Math.max(6, ...state.rows.map(r => r.branch.length));
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, children: pad("ISSUE", issueWidth) }), _jsx(Text, { children: "  " }), _jsx(Text, { bold: true, children: pad("BRANCH", branchWidth) }), _jsx(Text, { children: "  " }), _jsx(Text, { bold: true, children: "STATUS" }), _jsx(Text, { children: "   " }), _jsx(Text, { bold: true, children: "\u0394" }), _jsx(Text, { children: "           " }), state.checkedPr && _jsx(Text, { bold: true, children: "PR" })] }), state.rows.map((r, i) => (_jsxs(Box, { children: [_jsx(Text, { children: pad(r.issueId ?? "—", issueWidth) }), _jsx(Text, { children: "  " }), _jsx(Text, { color: "cyan", children: pad(r.branch, branchWidth) }), _jsx(Text, { children: "  " }), _jsx(Box, { width: 9, children: _jsx(StatusCell, { dirty: r.dirty }) }), _jsx(Box, { width: 12, children: _jsx(AheadBehindCell, { ab: r.ab }) }), _jsx(PrCell, { pr: r.pr, checked: state.checkedPr })] }, i)))] }));
+    const issueWidth = Math.max(5, ...state.rows.map((r) => (r.issueId ?? "—").length));
+    const branchWidth = Math.max(6, ...state.rows.map((r) => r.branch.length));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, children: pad("ISSUE", issueWidth) }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: pad("BRANCH", branchWidth) }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "STATUS" }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "\u0394" }), _jsx(Text, { children: " " }), state.checkedPr && _jsx(Text, { bold: true, children: "PR" })] }), state.rows.map((r, i) => (_jsxs(Box, { children: [_jsx(Text, { children: pad(r.issueId ?? "—", issueWidth) }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: pad(r.branch, branchWidth) }), _jsx(Text, { children: " " }), _jsx(Box, { width: 9, children: _jsx(StatusCell, { dirty: r.dirty }) }), _jsx(Box, { width: 12, children: _jsx(AheadBehindCell, { ab: r.ab }) }), _jsx(PrCell, { pr: r.pr, checked: state.checkedPr })] }, i)))] }));
 }

package/dist/commands/worktree/remove.js

@@ -42,5 +42,5 @@ export default function Remove({ args, options }) {
     if (!result.ok) {
         return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", result.message] }), result.hint && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", result.hint] }) }))] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree remove" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", result.branch] })] }), result.variant === "pruned-orphan" ? (_jsxs(Text, { children: [_jsx(Text, { color: "yellow", children: "!" }), " worktree directory was already deleted; pruned the dangling reference"] })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "\u2713" }), " removed", " ", _jsxs(Text, { dimColor: true, children: ["(", result.worktreePath, ")"] })] }), result.wasDirty && (_jsx(Text, { color: "yellow", children: "\u21B3 forced past uncommitted changes" }))] })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Branch ", _jsx(Text, { color: "cyan", children: result.branch }), " was preserved (use `git branch -D", " ", result.branch, "` to delete it)."] }), _jsx(Text, { dimColor: true, children: "Issue metadata (incl. session_id) was preserved for re-attach." })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree remove" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", result.branch] })] }), result.variant === "pruned-orphan" ? (_jsxs(Text, { children: [_jsx(Text, { color: "yellow", children: "!" }), " worktree directory was already deleted; pruned the dangling reference"] })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { color: "green", children: "\u2713" }), " removed ", _jsxs(Text, { dimColor: true, children: ["(", result.worktreePath, ")"] })] }), result.wasDirty && _jsx(Text, { color: "yellow", children: "\u21B3 forced past uncommitted changes" })] })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Branch ", _jsx(Text, { color: "cyan", children: result.branch }), " was preserved (use `git branch -D", " ", result.branch, "` to delete it)."] }), _jsx(Text, { dimColor: true, children: "Issue metadata (incl. session_id) was preserved for re-attach." })] })] }));
 }

package/dist/commands/worktree/work.js

@@ -50,9 +50,7 @@ function resolve(cwd) {
     }
     const worktreesDir = path.resolve(getWorktreesDir(repoRoot));
     const cwdAbs = path.resolve(cwd);
-    const insideMintreeWorktree = cwdAbs === worktreesDir
-        ? false
-        : cwdAbs.startsWith(worktreesDir + path.sep);
+    const insideMintreeWorktree = cwdAbs === worktreesDir ? false : cwdAbs.startsWith(worktreesDir + path.sep);
     if (!insideMintreeWorktree) {
         return {
             ok: false,

package/dist/lib/dashboard.js

@@ -126,7 +126,7 @@ export async function loadDashboard(repoRoot) {
             prByBranch.set(w.branch, pr);
     });
     await Promise.all(prFetches);
-    return issues.map(issue => {
+    return issues.map((issue) => {
         const issueId = String(issue.number);
         const worktreeRaw = worktreesByIssue.get(issueId) ?? null;
         const sessionId = metadata.issues[issueId]?.session_id;

package/dist/lib/git.js

@@ -16,9 +16,7 @@ export function findMainRepoRoot(cwd = process.cwd()) {
         })
             .toString()
             .trim();
-        const absoluteCommonDir = path.isAbsolute(commonDir)
-            ? commonDir
-            : path.resolve(cwd, commonDir);
+        const absoluteCommonDir = path.isAbsolute(commonDir) ? commonDir : path.resolve(cwd, commonDir);
         // `--git-common-dir` points at `<root>/.git` in a normal repo. Its parent
         // is the working tree root we want.
         if (path.basename(absoluteCommonDir) === ".git") {
@@ -119,7 +117,7 @@ export function isExecutable(p) {
  */
 export function ensureGitignoreEntries(repoRoot, entries) {
     const gitignorePath = path.join(repoRoot, ".gitignore");
-    const toAdd = entries.filter(entry => !isGitIgnored(entry, repoRoot));
+    const toAdd = entries.filter((entry) => !isGitIgnored(entry, repoRoot));
     if (toAdd.length === 0)
         return [];
     const existing = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, "utf-8") : "";

package/dist/lib/githubProject.d.ts

@@ -0,0 +1,55 @@
+export type TransitionResult = {
+    kind: "transitioned";
+    projectTitle: string;
+    from: string | null;
+    to: string;
+} | {
+    kind: "noop-already";
+    projectTitle: string;
+} | {
+    kind: "noop-protected";
+    projectTitle: string;
+    current: string;
+} | {
+    kind: "skip-no-repo";
+} | {
+    kind: "skip-no-issue";
+} | {
+    kind: "skip-no-project";
+} | {
+    kind: "skip-ambiguous";
+    projects: string[];
+} | {
+    kind: "skip-no-status-field";
+    projects: string[];
+} | {
+    kind: "skip-no-in-progress-option";
+    projects: string[];
+} | {
+    kind: "error";
+    message: string;
+    hint?: string;
+};
+/**
+ * Moves the GitHub issue to "In Progress" on its project. Auto-discovers the
+ * project from the issue's projectItems; if there are several candidates and
+ * `.mintree/metadata.json` doesn't pin one (via `project.url`), bails out
+ * rather than guess.
+ *
+ * Skips silently when the status is already In Progress or one of the
+ * protected statuses (In Review, Done by default) — to avoid clobbering
+ * a PR-driven transition done by something else.
+ */
+export declare function transitionIssueToInProgress(repoRoot: string, issueNumber: number | string): Promise<TransitionResult>;
+/**
+ * Returns the gh CLI token scopes for github.com, or null when `gh` can't be
+ * called / the user isn't authenticated. `gh auth status` writes the scopes
+ * line to stderr; we capture both streams and grep for it.
+ */
+export declare function getGhTokenScopes(): Promise<string[] | null>;
+export declare function hasProjectScope(scopes: string[]): boolean;
+export declare function describeTransition(result: TransitionResult): {
+    kind: "ok" | "skip" | "warn";
+    label: string;
+    detail?: string;
+};

package/dist/lib/githubProject.js

@@ -0,0 +1,277 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { getRepoFullName } from "./github.js";
+import { readMetadata } from "./metadata.js";
+const execFileAsync = promisify(execFile);
+const DEFAULT_STATUS_FIELD = "Status";
+const DEFAULT_IN_PROGRESS_OPTION = "In Progress";
+const DEFAULT_PROTECTED_STATUSES = ["In Review", "Done"];
+async function runGhGraphql(query, fields) {
+    const args = ["api", "graphql", "-f", `query=${query}`];
+    for (const [key, value] of fields) {
+        if (typeof value === "number") {
+            args.push("-F", `${key}=${value}`);
+        }
+        else {
+            args.push("-f", `${key}=${value}`);
+        }
+    }
+    const { stdout } = await execFileAsync("gh", args);
+    return JSON.parse(stdout);
+}
+function readProjectConfig(repoRoot) {
+    return readMetadata(repoRoot).project ?? {};
+}
+function parseProjectNumberFromUrl(url) {
+    const m = url.match(/\/projects\/(\d+)/);
+    return m && m[1] ? Number(m[1]) : null;
+}
+function interpretGhError(err) {
+    const stderr = err && typeof err === "object" && "stderr" in err
+        ? String(err.stderr)
+        : err instanceof Error
+            ? err.message
+            : String(err);
+    if (/INSUFFICIENT_SCOPES/i.test(stderr) || (/scope/i.test(stderr) && /project/i.test(stderr))) {
+        return {
+            kind: "error",
+            message: "gh token is missing the `project` scope.",
+            hint: "Run: gh auth refresh -s project",
+        };
+    }
+    if (/Could not resolve to a Repository/i.test(stderr)) {
+        return { kind: "skip-no-repo" };
+    }
+    if (/Could not resolve to an Issue/i.test(stderr)) {
+        return { kind: "skip-no-issue" };
+    }
+    const firstLine = stderr.split("\n").find((line) => line.trim().length > 0) ?? "";
+    return {
+        kind: "error",
+        message: firstLine.slice(0, 200) || "gh api graphql failed",
+    };
+}
+/**
+ * Moves the GitHub issue to "In Progress" on its project. Auto-discovers the
+ * project from the issue's projectItems; if there are several candidates and
+ * `.mintree/metadata.json` doesn't pin one (via `project.url`), bails out
+ * rather than guess.
+ *
+ * Skips silently when the status is already In Progress or one of the
+ * protected statuses (In Review, Done by default) — to avoid clobbering
+ * a PR-driven transition done by something else.
+ */
+export async function transitionIssueToInProgress(repoRoot, issueNumber) {
+    const repo = await getRepoFullName();
+    if (!repo)
+        return { kind: "skip-no-repo" };
+    const [owner, name] = repo.split("/");
+    if (!owner || !name)
+        return { kind: "skip-no-repo" };
+    const cfg = readProjectConfig(repoRoot);
+    const statusFieldName = cfg.statusField ?? DEFAULT_STATUS_FIELD;
+    const inProgressOptionName = cfg.inProgressOption ?? DEFAULT_IN_PROGRESS_OPTION;
+    const protectedStatuses = cfg.protectedStatuses ?? DEFAULT_PROTECTED_STATUSES;
+    // The Status field name is interpolated into the query (not a variable)
+    // because GraphQL field-argument names are not parameterizable through
+    // the variables object. Escape any embedded quotes to keep the query valid.
+    const escapedFieldName = statusFieldName.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    const query = `query($owner: String!, $repo: String!, $number: Int!) {
+  repository(owner: $owner, name: $repo) {
+    issue(number: $number) {
+      id
+      projectItems(first: 20, includeArchived: false) {
+        nodes {
+          id
+          project {
+            id
+            title
+            number
+            url
+            field(name: "${escapedFieldName}") {
+              ... on ProjectV2SingleSelectField {
+                id
+                name
+                options { id name }
+              }
+            }
+          }
+          fieldValues(first: 30) {
+            nodes {
+              ... on ProjectV2ItemFieldSingleSelectValue {
+                name
+                field {
+                  ... on ProjectV2SingleSelectField { name }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}`;
+    let raw;
+    try {
+        raw = (await runGhGraphql(query, [
+            ["owner", owner],
+            ["repo", name],
+            ["number", Number(issueNumber)],
+        ]));
+    }
+    catch (err) {
+        return interpretGhError(err);
+    }
+    const issue = raw?.data?.repository?.issue;
+    if (!issue)
+        return { kind: "skip-no-issue" };
+    let nodes = issue.projectItems.nodes;
+    if (nodes.length === 0)
+        return { kind: "skip-no-project" };
+    // Honour an explicit project URL in the config before doing anything else.
+    if (cfg.url) {
+        const targetNumber = parseProjectNumberFromUrl(cfg.url);
+        nodes = nodes.filter((n) => n.project.url === cfg.url || (targetNumber !== null && n.project.number === targetNumber));
+        if (nodes.length === 0)
+            return { kind: "skip-no-project" };
+    }
+    const withField = nodes.filter((n) => n.project.field !== null);
+    if (withField.length === 0) {
+        return { kind: "skip-no-status-field", projects: nodes.map((n) => n.project.title) };
+    }
+    const withOption = withField.filter((n) => n.project.field.options.some((o) => o.name === inProgressOptionName));
+    if (withOption.length === 0) {
+        return {
+            kind: "skip-no-in-progress-option",
+            projects: withField.map((n) => n.project.title),
+        };
+    }
+    if (withOption.length > 1) {
+        return { kind: "skip-ambiguous", projects: withOption.map((n) => n.project.title) };
+    }
+    const item = withOption[0];
+    const project = item.project;
+    const field = project.field;
+    const option = field.options.find((o) => o.name === inProgressOptionName);
+    if (!option) {
+        // Defensive — already filtered above, but TypeScript can't see it.
+        return { kind: "skip-no-in-progress-option", projects: [project.title] };
+    }
+    const currentStatus = item.fieldValues.nodes.find((v) => v.field?.name === statusFieldName)?.name ?? null;
+    if (currentStatus === inProgressOptionName) {
+        return { kind: "noop-already", projectTitle: project.title };
+    }
+    if (currentStatus !== null && protectedStatuses.includes(currentStatus)) {
+        return { kind: "noop-protected", projectTitle: project.title, current: currentStatus };
+    }
+    const mutation = `mutation($projectId: ID!, $itemId: ID!, $fieldId: ID!, $optionId: String!) {
+  updateProjectV2ItemFieldValue(input: {
+    projectId: $projectId
+    itemId: $itemId
+    fieldId: $fieldId
+    value: { singleSelectOptionId: $optionId }
+  }) {
+    projectV2Item { id }
+  }
+}`;
+    try {
+        await runGhGraphql(mutation, [
+            ["projectId", project.id],
+            ["itemId", item.id],
+            ["fieldId", field.id],
+            ["optionId", option.id],
+        ]);
+    }
+    catch (err) {
+        return interpretGhError(err);
+    }
+    return {
+        kind: "transitioned",
+        projectTitle: project.title,
+        from: currentStatus,
+        to: inProgressOptionName,
+    };
+}
+/**
+ * Returns the gh CLI token scopes for github.com, or null when `gh` can't be
+ * called / the user isn't authenticated. `gh auth status` writes the scopes
+ * line to stderr; we capture both streams and grep for it.
+ */
+export async function getGhTokenScopes() {
+    try {
+        const { stdout, stderr } = await execFileAsync("gh", ["auth", "status"]);
+        const combined = `${stdout}\n${stderr}`;
+        return parseScopesFromAuthStatus(combined);
+    }
+    catch (err) {
+        const out = err && typeof err === "object" && "stdout" in err && "stderr" in err
+            ? `${String(err.stdout)}\n${String(err.stderr)}`
+            : "";
+        const parsed = parseScopesFromAuthStatus(out);
+        return parsed ?? null;
+    }
+}
+function parseScopesFromAuthStatus(text) {
+    const m = text.match(/Token scopes:\s*([^\n]+)/i);
+    if (!m || !m[1])
+        return null;
+    return m[1]
+        .split(",")
+        .map((s) => s.trim().replace(/^['"]|['"]$/g, ""))
+        .filter(Boolean);
+}
+export function hasProjectScope(scopes) {
+    return scopes.some((s) => s === "project" || s === "write:project");
+}
+export function describeTransition(result) {
+    switch (result.kind) {
+        case "transitioned":
+            return {
+                kind: "ok",
+                label: `issue → ${result.to}`,
+                detail: result.from ? `${result.projectTitle} (was: ${result.from})` : result.projectTitle,
+            };
+        case "noop-already":
+            return {
+                kind: "skip",
+                label: "issue already In Progress",
+                detail: result.projectTitle,
+            };
+        case "noop-protected":
+            return {
+                kind: "skip",
+                label: `issue kept at ${result.current}`,
+                detail: `${result.projectTitle} (status is protected)`,
+            };
+        case "skip-no-repo":
+            return { kind: "skip", label: "no GitHub repo — skipping project update" };
+        case "skip-no-issue":
+            return { kind: "skip", label: "issue not found on GitHub — skipping project update" };
+        case "skip-no-project":
+            return { kind: "skip", label: "issue not on any project — skipping project update" };
+        case "skip-ambiguous":
+            return {
+                kind: "warn",
+                label: "multiple matching projects — skipping",
+                detail: `set .mintree/metadata.json project.url to one of: ${result.projects.join(", ")}`,
+            };
+        case "skip-no-status-field":
+            return {
+                kind: "skip",
+                label: "no Status field on project — skipping",
+                detail: result.projects.join(", "),
+            };
+        case "skip-no-in-progress-option":
+            return {
+                kind: "skip",
+                label: "no In Progress option on Status field — skipping",
+                detail: result.projects.join(", "),
+            };
+        case "error":
+            return {
+                kind: "warn",
+                label: "project update failed",
+                detail: result.hint ? `${result.message} — ${result.hint}` : result.message,
+            };
+    }
+}

package/dist/lib/metadata.d.ts

@@ -2,9 +2,16 @@ export type IssueMeta = {
     base_branch?: string;
     session_id?: string;
 };
+export type ProjectMeta = {
+    url?: string;
+    statusField?: string;
+    inProgressOption?: string;
+    protectedStatuses?: string[];
+};
 export type Metadata = {
     version: 1;
     issues: Record<string, IssueMeta>;
+    project?: ProjectMeta;
 };
 export declare function readMetadata(repoRoot: string): Metadata;
 export declare function writeMetadata(repoRoot: string, data: Metadata): void;

package/dist/lib/metadata.js

@@ -1,6 +1,26 @@
 import * as fs from "fs";
 import { getMetadataPath } from "./git.js";
 const EMPTY = { version: 1, issues: {} };
+function sanitizeProject(raw) {
+    if (typeof raw !== "object" || raw === null)
+        return undefined;
+    const r = raw;
+    const out = {};
+    if (typeof r["url"] === "string" && r["url"].length > 0)
+        out.url = r["url"];
+    if (typeof r["statusField"] === "string" && r["statusField"].length > 0) {
+        out.statusField = r["statusField"];
+    }
+    if (typeof r["inProgressOption"] === "string" && r["inProgressOption"].length > 0) {
+        out.inProgressOption = r["inProgressOption"];
+    }
+    if (Array.isArray(r["protectedStatuses"])) {
+        const arr = r["protectedStatuses"].filter((v) => typeof v === "string" && v.length > 0);
+        if (arr.length > 0)
+            out.protectedStatuses = arr;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
 export function readMetadata(repoRoot) {
     const filePath = getMetadataPath(repoRoot);
     if (!fs.existsSync(filePath))
@@ -9,11 +29,13 @@ export function readMetadata(repoRoot) {
         const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
         if (typeof parsed !== "object" || parsed === null)
             return { ...EMPTY, issues: {} };
+        const project = sanitizeProject(parsed.project);
         return {
             version: 1,
             issues: typeof parsed.issues === "object" && parsed.issues !== null
                 ? parsed.issues
                 : {},
+            ...(project ? { project } : {}),
         };
     }
     catch {

package/dist/lib/session-signal.js

@@ -140,15 +140,15 @@ export function installHooks() {
             existingHooks[event] = hookEntries;
             continue;
         }
-        const filtered = existing.filter(entry => {
+        const filtered = existing.filter((entry) => {
             if (!entry || typeof entry !== "object")
                 return true;
             const inner = entry.hooks ?? [];
-            return !inner.some(h => {
+            return !inner.some((h) => {
                 return (h !== null &&
                     typeof h === "object" &&
                     typeof h.command === "string" &&
-                    (h.command).includes("mintree helpers session-signal"));
+                    h.command.includes("mintree helpers session-signal"));
             });
         });
         existingHooks[event] = [...filtered, ...hookEntries];

package/dist/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare function getLatestVersion(pkg: string): Promise<string | null>;
+export declare function isNewerVersion(current: string, latest: string): boolean;

package/dist/lib/version.js

@@ -0,0 +1,45 @@
+// Update check: ask the npm registry for the latest published version and
+// compare it against what's running. Best-effort — any failure (offline,
+// timeout, private registry) resolves to null and the dashboard simply
+// doesn't show an update hint.
+const REGISTRY_TIMEOUT_MS = 3000;
+export async function getLatestVersion(pkg) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), REGISTRY_TIMEOUT_MS);
+        const res = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
+            signal: controller.signal,
+            headers: { accept: "application/json" },
+        });
+        clearTimeout(timer);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return typeof data.version === "string" ? data.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+// Returns true when `latest` is strictly newer than `current`. Both are
+// expected as plain `major.minor.patch` strings; anything unparseable is
+// treated as "not newer" so we never nag on a bad comparison.
+export function isNewerVersion(current, latest) {
+    const parse = (v) => v
+        .trim()
+        .split(".")
+        .map((n) => parseInt(n, 10));
+    const a = parse(current);
+    const b = parse(latest);
+    for (let i = 0; i < 3; i++) {
+        const ca = a[i] ?? 0;
+        const cb = b[i] ?? 0;
+        if (Number.isNaN(ca) || Number.isNaN(cb))
+            return false;
+        if (cb > ca)
+            return true;
+        if (cb < ca)
+            return false;
+    }
+    return false;
+}

package/package.json

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