mintree 0.1.6 → 0.1.8

package/dist/commands/dashboard.js

@@ -8,6 +8,7 @@ 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";
@@ -160,10 +161,10 @@ 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" }) }));
     }
@@ -173,7 +174,7 @@ function FooterRow({ phase, overlayKind, }) {
     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, { 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] }) }))] }));
@@ -207,10 +208,70 @@ function IssueListRow({ d, selected, identifierWidth, maxTitleWidth, }) {
     const title = truncate(d.issue.title, maxTitleWidth);
     // One single Text with a single string so the background highlight is
     // continuous across the whole row. Coloured per-state icons live in the
-    // detail pane instead — keeps the list selection visually solid.
-    const line = ` ${idText}  ${icon}  ${title}`;
+    // detail pane instead — keeps the list selection visually solid. The two
+    // leading spaces nest the row under its Status sub-header.
+    const line = `  ${idText}  ${icon}  ${title}`;
     return (_jsx(Box, { children: _jsx(Text, { backgroundColor: selected ? "blue" : undefined, color: selected ? "white" : undefined, children: line }) }));
 }
+// A project board header — the top level of the grouped issue list. Mirrors
+// the bold project name + dim count seen in the santree dashboard.
+function ProjectHeaderRow({ title, count, width, }) {
+    return (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: truncate(title, Math.max(4, width - 6)) }), _jsx(Text, { dimColor: true, children: `  ${count}` })] }));
+}
+// A Status sub-header within a project group. The bullet and name take the
+// colour the board itself assigned to that Status option.
+function StatusHeaderRow({ name, color, count, width, }) {
+    return (_jsxs(Box, { children: [_jsx(Text, { color: color, children: " ●" }), _jsx(Text, { bold: true, color: color, children: ` ${truncate(name, Math.max(4, width - 8))}` }), _jsx(Text, { dimColor: true, children: `  ${count}` })] }));
+}
+/**
+ * Walks the already-grouped flat issue array (loadDashboard sorts it by
+ * project → status → number) and interleaves project/status header rows
+ * whenever the group changes. When no issue belongs to a project board the
+ * list stays flat — same look the dashboard had before grouping existed.
+ */
+function buildListRows(issues) {
+    if (!issues.some((d) => d.project !== null)) {
+        return issues.map((d, index) => ({ kind: "issue", d, index }));
+    }
+    const projectTitle = (d) => d.project?.projectTitle ?? "Sin proyecto";
+    const projectCount = new Map();
+    const statusCount = new Map();
+    for (const d of issues) {
+        const p = projectTitle(d);
+        projectCount.set(p, (projectCount.get(p) ?? 0) + 1);
+        if (d.project) {
+            const key = `${p}${d.project.status ?? "Sin estado"}`;
+            statusCount.set(key, (statusCount.get(key) ?? 0) + 1);
+        }
+    }
+    const rows = [];
+    let curProject = null;
+    let curStatus = null;
+    issues.forEach((d, index) => {
+        const p = projectTitle(d);
+        if (p !== curProject) {
+            if (curProject !== null)
+                rows.push({ kind: "spacer" });
+            rows.push({ kind: "project", title: p, count: projectCount.get(p) ?? 0 });
+            curProject = p;
+            curStatus = null;
+        }
+        if (d.project) {
+            const s = d.project.status ?? "Sin estado";
+            if (s !== curStatus) {
+                rows.push({
+                    kind: "status",
+                    name: s,
+                    color: d.project.statusColor,
+                    count: statusCount.get(`${p}${s}`) ?? 0,
+                });
+                curStatus = s;
+            }
+        }
+        rows.push({ kind: "issue", d, index });
+    });
+    return rows;
+}
 // Word-wraps a single line at `width` columns, breaking on the last space
 // before the limit when that yields a reasonable cut. Falls back to a hard
 // cut for unbroken runs (long URLs, code-fence content) so the detail pane
@@ -297,6 +358,13 @@ function buildDetailLines(d, width) {
     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 }]);
+    if (d.project) {
+        lines.push([
+            { text: "● ", color: d.project.statusColor },
+            { text: d.project.status ?? "Sin estado", color: d.project.statusColor },
+            { text: ` · ${truncate(d.project.projectTitle, Math.max(8, w - 12))}`, dim: true },
+        ]);
+    }
     lines.push([
         {
             text: `updated ${relativeTime(d.issue.updatedAt)} · created ${relativeTime(d.issue.createdAt)}`,
@@ -399,6 +467,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
@@ -479,6 +549,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
@@ -893,8 +967,8 @@ export default function Dashboard() {
     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));
-    // Lista ocupa todo menos: " #N  ICON  " (id + 4 cols of pad/icon).
-    const maxTitleWidth = Math.max(8, listWidth - identifierWidth - 8);
+    // Lista ocupa todo menos: "  #N  ICON  " (2-space nest indent + id + icon).
+    const maxTitleWidth = Math.max(8, listWidth - identifierWidth - 9);
     // Reserve rows: header (2), top borders (1), footer (3).
     const listVisibleRows = Math.max(3, rows - 9);
     // Detail pane content height inside the bordered box. Header eats 2 rows,
@@ -905,11 +979,30 @@ export default function Dashboard() {
     // correct pane. Ref lets the stdin listener (mounted once) read the live
     // value without re-binding on every resize.
     listWidthRef.current = listWidth;
-    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) => {
-                                    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 })] })] }));
+    // Grouped list: build the project/status header rows interleaved with
+    // issue rows, then window the rows around the selected issue's row.
+    // Navigation still moves `selectedIndex` over the flat issues array —
+    // headers and spacers are non-selectable, purely visual rows.
+    const listRows = buildListRows(issues);
+    const selectedRowIdx = listRows.findIndex((r) => r.kind === "issue" && r.index === selectedIndex);
+    const rowAnchor = selectedRowIdx >= 0 ? selectedRowIdx : 0;
+    const maxRowStart = Math.max(0, listRows.length - listVisibleRows);
+    const rowStart = Math.max(0, Math.min(maxRowStart, rowAnchor - Math.floor(listVisibleRows / 2)));
+    const rowEnd = Math.min(listRows.length, rowStart + listVisibleRows);
+    const visibleRows = listRows.slice(rowStart, rowEnd);
+    const issuesAbove = listRows.slice(0, rowStart).filter((r) => r.kind === "issue").length;
+    const issuesBelow = listRows.slice(rowEnd).filter((r) => r.kind === "issue").length;
+    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: 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: [visibleRows.map((row, i) => {
+                                    const key = rowStart + i;
+                                    if (row.kind === "spacer")
+                                        return _jsx(Text, { children: " " }, key);
+                                    if (row.kind === "project") {
+                                        return (_jsx(ProjectHeaderRow, { title: row.title, count: row.count, width: listContentWidth }, key));
+                                    }
+                                    if (row.kind === "status") {
+                                        return (_jsx(StatusHeaderRow, { name: row.name, color: row.color, count: row.count, width: listContentWidth }, key));
+                                    }
+                                    return (_jsx(IssueListRow, { d: row.d, selected: row.index === selectedIndex, identifierWidth: identifierWidth, maxTitleWidth: maxTitleWidth }, key));
+                                }), issuesAbove > 0 && _jsxs(Text, { dimColor: true, children: ["\u2191 ", issuesAbove, " more above"] }), issuesBelow > 0 && _jsxs(Text, { dimColor: true, children: ["\u2193 ", 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 })] })] }));
 }

package/dist/lib/dashboard.d.ts

@@ -29,11 +29,29 @@ export type PrInfo = {
     state: "OPEN" | "CLOSED" | "MERGED";
     url: string;
 };
+/**
+ * The issue's membership in a GitHub Projects v2 board, used to group the
+ * dashboard list. `status` is the value of the board's single-select Status
+ * field (null when the issue is on the board but has no status set).
+ * `statusOrder` is the index of that option in the field definition, so the
+ * dashboard can order status sub-groups the same way the board's columns are
+ * ordered. `statusColor` is an Ink colour derived from the option's own
+ * configured colour.
+ */
+export type IssueProjectInfo = {
+    projectTitle: string;
+    projectUrl: string;
+    projectNumber: number;
+    status: string | null;
+    statusColor: string;
+    statusOrder: number;
+};
 export type DashboardIssue = {
     issue: GhIssue;
     worktree: WorktreeInfo | null;
     session: SessionStateInfo | null;
     pr: PrInfo | null;
+    project: IssueProjectInfo | null;
 };
 /**
  * Fetches open issues assigned to the authenticated GitHub user for the

package/dist/lib/dashboard.js

@@ -1,8 +1,12 @@
 import * as fs from "fs";
 import * as path from "path";
+import { execFile } from "child_process";
+import { promisify } from "util";
 import { tryExec } from "./exec.js";
 import { listWorktrees, getWorktreesDir, isDirty, getAheadBehind, } from "./git.js";
 import { readMetadata } from "./metadata.js";
+import { getRepoFullName } from "./github.js";
+const execFileAsync = promisify(execFile);
 const ISSUE_LIST_LIMIT = 50;
 /**
  * Fetches open issues assigned to the authenticated GitHub user for the
@@ -102,6 +106,163 @@ async function fetchPrForBranch(branch) {
     }
     return null;
 }
+// GitHub Projects v2 single-select options carry their own colour enum.
+// Map each to the closest Ink/chalk colour; ORANGE and PINK have no 16-colour
+// keyword so they use hex (truecolor terminals render them, others approximate).
+const PROJECT_STATUS_COLORS = {
+    GRAY: "gray",
+    BLUE: "blue",
+    GREEN: "green",
+    YELLOW: "yellow",
+    ORANGE: "#d18616",
+    RED: "red",
+    PINK: "#d2a8ff",
+    PURPLE: "magenta",
+};
+const STATUS_ORDER_UNSET = 999;
+function parseProjectNumberFromUrl(url) {
+    const m = url.match(/\/projects\/(\d+)/);
+    return m && m[1] ? Number(m[1]) : null;
+}
+/**
+ * Runs a GraphQL query via `gh api graphql`. Returns null on any failure
+ * (gh not authenticated, missing scope, network) — the caller degrades
+ * gracefully to an ungrouped list.
+ */
+async function ghGraphql(query) {
+    try {
+        const { stdout } = await execFileAsync("gh", ["api", "graphql", "-f", `query=${query}`]);
+        return JSON.parse(stdout);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Picks which project board an issue belongs to for grouping purposes. When
+ * `.mintree/metadata.json` pins a project URL, only that board counts;
+ * otherwise the first board the issue appears on wins.
+ */
+function pickProjectNode(nodes, configuredUrl) {
+    if (nodes.length === 0)
+        return null;
+    if (configuredUrl) {
+        const targetNumber = parseProjectNumberFromUrl(configuredUrl);
+        return (nodes.find((n) => n.project?.url === configuredUrl ||
+            (targetNumber !== null && n.project?.number === targetNumber)) ?? null);
+    }
+    return nodes[0] ?? null;
+}
+function toProjectInfo(node) {
+    const proj = node.project;
+    if (!proj)
+        return null;
+    const options = proj.field?.options ?? [];
+    const status = node.fieldValueByName?.name ?? null;
+    const optionIndex = status ? options.findIndex((o) => o.name === status) : -1;
+    const option = optionIndex >= 0 ? options[optionIndex] : undefined;
+    return {
+        projectTitle: proj.title ?? "(untitled project)",
+        projectUrl: proj.url ?? "",
+        projectNumber: proj.number ?? 0,
+        status,
+        statusColor: option?.color
+            ? (PROJECT_STATUS_COLORS[option.color] ?? "yellow")
+            : status
+                ? "yellow"
+                : "gray",
+        statusOrder: optionIndex >= 0 ? optionIndex : STATUS_ORDER_UNSET,
+    };
+}
+/**
+ * Fetches, in a single GraphQL round-trip, which Projects v2 board (and
+ * Status value) each open assigned issue belongs to. Returns an empty map
+ * when the lookup fails — the dashboard then renders an ungrouped list.
+ */
+async function fetchProjectAssignments(statusFieldName, configuredUrl) {
+    const result = new Map();
+    const repo = await getRepoFullName();
+    if (!repo)
+        return result;
+    // The Status field name is interpolated into the query (not a variable)
+    // because it appears as a field argument; escape embedded quotes.
+    const escapedField = statusFieldName.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    const searchQuery = `repo:${repo} is:issue is:open assignee:@me`.replace(/"/g, '\\"');
+    const query = `query {
+  search(query: "${searchQuery}", type: ISSUE, first: ${ISSUE_LIST_LIMIT}) {
+    nodes {
+      ... on Issue {
+        number
+        projectItems(first: 10, includeArchived: false) {
+          nodes {
+            project {
+              title
+              number
+              url
+              field(name: "${escapedField}") {
+                ... on ProjectV2SingleSelectField {
+                  options { name color }
+                }
+              }
+            }
+            fieldValueByName(name: "${escapedField}") {
+              ... on ProjectV2ItemFieldSingleSelectValue { name }
+            }
+          }
+        }
+      }
+    }
+  }
+}`;
+    const raw = (await ghGraphql(query));
+    const nodes = raw?.data?.search?.nodes;
+    if (!Array.isArray(nodes))
+        return result;
+    for (const node of nodes) {
+        if (typeof node?.number !== "number")
+            continue;
+        const items = node.projectItems?.nodes ?? [];
+        const picked = pickProjectNode(items, configuredUrl);
+        if (!picked)
+            continue;
+        const info = toProjectInfo(picked);
+        if (info)
+            result.set(node.number, info);
+    }
+    return result;
+}
+/**
+ * Orders the flat issue list so issues are contiguous by project, then by
+ * Status (board column order), then newest issue first. The dashboard derives
+ * its group headers by walking this already-ordered array.
+ *
+ * Project group order: a config-pinned project first, then other projects
+ * alphabetically, then issues with no project ("Sin proyecto") last.
+ */
+function sortGroupedIssues(issues, configuredUrl) {
+    const projectTier = (p) => {
+        if (!p)
+            return 2;
+        if (configuredUrl && p.projectUrl === configuredUrl)
+            return 0;
+        return 1;
+    };
+    return [...issues].sort((a, b) => {
+        const ta = projectTier(a.project);
+        const tb = projectTier(b.project);
+        if (ta !== tb)
+            return ta - tb;
+        if (a.project && b.project) {
+            const byTitle = a.project.projectTitle.localeCompare(b.project.projectTitle);
+            if (byTitle !== 0)
+                return byTitle;
+            if (a.project.statusOrder !== b.project.statusOrder) {
+                return a.project.statusOrder - b.project.statusOrder;
+            }
+        }
+        return b.issue.number - a.issue.number;
+    });
+}
 /**
  * Top-level loader: enriches each assigned issue with its worktree and
  * session snapshot. Designed to be called on dashboard mount and on every
@@ -113,6 +274,8 @@ export async function loadDashboard(repoRoot) {
         return null;
     const worktreesByIssue = buildWorktreeIndex(repoRoot);
     const metadata = readMetadata(repoRoot);
+    const projectCfg = metadata.project ?? {};
+    const configuredUrl = projectCfg.url ?? null;
     // Fetch PRs in parallel for branches that actually have a worktree —
     // issues without one wouldn't have a branch on this user's repo, so we
     // skip the per-issue gh call for them. Detached worktrees (branch=null)
@@ -125,8 +288,13 @@ export async function loadDashboard(repoRoot) {
         if (pr)
             prByBranch.set(w.branch, pr);
     });
-    await Promise.all(prFetches);
-    return issues.map((issue) => {
+    // Project membership comes from a single GraphQL query; fetch it alongside
+    // the per-branch PR probes so neither blocks the other.
+    const [, projectByIssue] = await Promise.all([
+        Promise.all(prFetches),
+        fetchProjectAssignments(projectCfg.statusField ?? "Status", configuredUrl),
+    ]);
+    const enriched = issues.map((issue) => {
         const issueId = String(issue.number);
         const worktreeRaw = worktreesByIssue.get(issueId) ?? null;
         const sessionId = metadata.issues[issueId]?.session_id;
@@ -137,6 +305,8 @@ export async function loadDashboard(repoRoot) {
             worktree,
             session: readSessionState(repoRoot, issueId),
             pr,
+            project: projectByIssue.get(issue.number) ?? null,
         };
     });
+    return sortGroupedIssues(enriched, configuredUrl);
 }

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.6",
+	"version": "0.1.8",
 	"description": "Issue-driven git worktrees + Claude Code sessions for repos with an opinionated SDD+TDD flow.",
 	"license": "MIT",
 	"author": "Martin Mineo <mmineo@canarytechnologies.com>",