mintree 0.1.7 → 0.1.9

package/dist/commands/dashboard.js

@@ -208,10 +208,147 @@ 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;
+}
+/**
+ * Splits the grouped list into a pinned-header region and a scrollable body
+ * windowed around the selected issue. The selected issue's own project and
+ * Status headers are lifted out of the scroll flow so they stay visible
+ * ("sticky") while paging through a long group — without them the user loses
+ * track of which project/status the rows below belong to.
+ *
+ * Navigation is unaffected: it still moves `selectedIndex` over the flat
+ * issues array; this only decides what's drawn where.
+ */
+function windowListRows(listRows, selectedIndex, viewportRows) {
+    const selRow = listRows.findIndex((r) => r.kind === "issue" && r.index === selectedIndex);
+    const anchor = selRow >= 0 ? selRow : 0;
+    // Walk back from the selected row to find its enclosing project and Status
+    // headers. A "Sin proyecto" issue has a project header but no status one.
+    let projIdx = -1;
+    let statusIdx = -1;
+    for (let i = anchor; i >= 0; i--) {
+        const r = listRows[i];
+        if (!r)
+            continue;
+        if (statusIdx === -1 && r.kind === "status")
+            statusIdx = i;
+        if (r.kind === "project") {
+            projIdx = i;
+            break;
+        }
+    }
+    // Pinned rows are pulled out of the body so they never render twice. The
+    // blank spacer that precedes a project header is dropped too, so the pane
+    // doesn't open with an empty line.
+    const pinned = new Set();
+    const sticky = [];
+    if (projIdx >= 0) {
+        pinned.add(projIdx);
+        sticky.push(listRows[projIdx]);
+        const before = listRows[projIdx - 1];
+        if (before && before.kind === "spacer")
+            pinned.add(projIdx - 1);
+    }
+    if (statusIdx >= 0) {
+        pinned.add(statusIdx);
+        sticky.push(listRows[statusIdx]);
+    }
+    const body = [];
+    let anchorInBody = 0;
+    listRows.forEach((r, i) => {
+        if (pinned.has(i))
+            return;
+        if (i === anchor)
+            anchorInBody = body.length;
+        body.push(r);
+    });
+    const bodyViewport = Math.max(1, viewportRows - sticky.length);
+    const maxStart = Math.max(0, body.length - bodyViewport);
+    const start = Math.max(0, Math.min(maxStart, anchorInBody - Math.floor(bodyViewport / 2)));
+    const end = Math.min(body.length, start + bodyViewport);
+    return {
+        sticky,
+        body: body.slice(start, end),
+        issuesAbove: body.slice(0, start).filter((r) => r.kind === "issue").length,
+        issuesBelow: body.slice(end).filter((r) => r.kind === "issue").length,
+    };
+}
+// Renders a single grouped-list row — used for both the sticky header region
+// and the scrollable body so the two stay visually identical.
+function ListRowView({ row, selectedIndex, identifierWidth, maxTitleWidth, width, }) {
+    if (row.kind === "spacer")
+        return _jsx(Text, { children: " " });
+    if (row.kind === "project") {
+        return _jsx(ProjectHeaderRow, { title: row.title, count: row.count, width: width });
+    }
+    if (row.kind === "status") {
+        return _jsx(StatusHeaderRow, { name: row.name, color: row.color, count: row.count, width: width });
+    }
+    return (_jsx(IssueListRow, { d: row.d, selected: row.index === selectedIndex, identifierWidth: identifierWidth, maxTitleWidth: maxTitleWidth }));
+}
 // 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
@@ -298,6 +435,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)}`,
@@ -900,8 +1044,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,
@@ -912,11 +1056,11 @@ 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, 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, latestVersion: latestVersion })] })] }));
+    // Grouped list: build the project/status header rows interleaved with
+    // issue rows, then split into a sticky header region (the selected issue's
+    // project + Status, pinned to the top) and a windowed scrollable body.
+    const listRows = buildListRows(issues);
+    const listView = windowListRows(listRows, selectedIndex, listVisibleRows);
+    const listContentWidth = Math.max(8, listWidth - 4);
+    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsx(Box, { paddingX: 1, paddingTop: 0, flexDirection: "column", children: _jsx(HeaderRow, { repoName: repoName, claudeVersion: claudeVersion, issueCount: 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: [listView.sticky.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, maxTitleWidth: maxTitleWidth, width: listContentWidth }, `sticky-${i}`))), listView.issuesAbove > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2191 ", listView.issuesAbove, " more above"] })), listView.body.map((row, i) => (_jsx(ListRowView, { row: row, selectedIndex: selectedIndex, identifierWidth: identifierWidth, maxTitleWidth: maxTitleWidth, width: listContentWidth }, `body-${i}`))), listView.issuesBelow > 0 && (_jsxs(Text, { dimColor: true, children: ["\u2193 ", listView.issuesBelow, " more below"] }))] })) }), _jsx(Box, { width: detailWidth, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsx(DetailPane, { d: selected, contentWidth: detailWidth - 4, contentHeight: detailContentHeight, scrollOffset: state.detailScrollOffset }) })] })), _jsxs(Box, { paddingX: 1, flexDirection: "column", children: [toast && (_jsx(Box, { children: _jsxs(Text, { color: toast.kind === "success" ? "green" : toast.kind === "error" ? "red" : "cyan", children: [toast.kind === "success" ? "✓ " : toast.kind === "error" ? "✗ " : "· ", toast.text] }) })), refreshing && (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { dimColor: true, children: " refreshing" })] })), _jsx(FooterRow, { phase: "ready", overlayKind: overlay?.kind, latestVersion: latestVersion })] })] }));
 }

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/package.json

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