mintree 0.4.3 → 0.4.5

package/README.md

@@ -4,12 +4,12 @@
 
 mintree wraps the steps you do manually every time a feature begins:
 
-1. Pick an open issue or work item assigned to you (GitHub Issues or Plane).
+1. Pick an open issue or work item assigned to you (GitHub Issues or Linear).
 2. Create a git worktree on a branch named after that item, following the project's convention.
 3. Launch Claude Code inside the worktree with a session ID you can resume later.
 4. Live-track which Claude sessions are active, idle, or waiting.
 
-It is a smaller, opinionated cousin of [santree](https://github.com/santiagotoscanini/santree) — built on the same TypeScript + Ink + Pastel stack but stripped to the `<type>/<issue>-<desc>` branch convention and the two issue trackers most likely to be used by a small team: GitHub Issues and Plane.
+It is a smaller, opinionated cousin of [santree](https://github.com/santiagotoscanini/santree) — built on the same TypeScript + Ink + Pastel stack but stripped to the `<type>/<issue>-<desc>` branch convention and the two issue trackers most likely to be used by a small team: GitHub Issues and Linear.
 
 ---
 
@@ -48,7 +48,7 @@ EOF
 
 `mintree doctor` should report **all required checks pass** before you continue. The most common gaps are:
 
-- `gh` not authenticated → `gh auth login` (still needed when using Plane — mintree uses `gh` for PR status on worktree branches)
+- `gh` not authenticated → `gh auth login` (still needed when using Linear — mintree uses `gh` for PR status on worktree branches)
 - Claude Code not installed → `npm install -g @anthropic-ai/claude-code`
 - Shell integration not loaded → re-run the `echo … >> ~/.zshrc` step and start a new shell
 
@@ -64,8 +64,8 @@ cd path/to/repo
 # Default: GitHub Issues provider
 mintree init
 
-# Or: Plane provider
-mintree init --provider plane --workspace <your-workspace-slug>
+# Or: Linear provider (--team is repeatable, one per team you pull work from)
+mintree init --provider linear --workspace <your-workspace-slug> --team FE --team BE
 
 mintree helpers session-signal install   # optional: live session state in the dashboard
 ```
@@ -77,40 +77,40 @@ mintree helpers session-signal install   # optional: live session state in the d
 mintree supports two issue providers, selected per repo via `.mintree/metadata.json`:
 
 - **`github`** (default): lists issues assigned to you on the current repo via `gh`. Transitions to "In Progress" on a Projects v2 board when present.
-- **`plane`**: lists work items assigned to you across a configured set of [Plane](https://plane.so) projects, via the Plane REST API. Transitions to the project's "started" state on `w`.
+- **`linear`**: lists issues assigned to you across a configured set of [Linear](https://linear.app) teams, via the Linear GraphQL API. Moves the issue to "In Progress" on `w`.
 
-After `mintree init --provider plane`, edit `.mintree/metadata.json` to add at least one project:
+`mintree init --provider linear --workspace <slug> --team FE --team BE` scaffolds the metadata for you. If you skip `--team`, or want to tweak it later, edit `.mintree/metadata.json` so `linear.teams` lists at least one team key:
 
 ```json
 {
   "version": 1,
-  "provider": "plane",
+  "provider": "linear",
   "issues": {},
-  "plane": {
-    "apiUrl": "https://api.plane.so",
+  "linear": {
+    "apiUrl": "https://api.linear.app/graphql",
     "workspaceSlug": "my-team",
-    "projects": [
-      { "id": "<project-uuid>", "identifier": "BACK", "name": "Backend" },
-      { "id": "<project-uuid>", "identifier": "WEB",  "name": "Web" }
+    "teams": [
+      { "key": "FE", "name": "Frontend" },
+      { "key": "BE", "name": "Backend" }
     ]
   }
 }
 ```
 
-You can find each project's UUID in the Plane URL (`app.plane.so/<workspace>/projects/<uuid>/...`). The `identifier` is the short prefix shown on work-item IDs (the `BACK` in `BACK-100`).
+The `workspaceSlug` is the URL key of your Linear workspace (`linear.app/<slug>/...`). Each team `key` is the short prefix shown on issue IDs (the `FE` in `FE-123`); `name` is optional. Optional keys: `inProgressStateName` (override the workflow state `w` transitions to) and `protectedStateTypes` (workflow-state types `clean` won't touch).
 
-Authenticate by setting `PLANE_API_KEY` in your shell, or by writing the key to `~/.mintree/credentials.json`:
+Authenticate by setting `LINEAR_API_KEY` in your shell, or by writing the key to `~/.mintree/credentials.json`:
 
 ```bash
-export PLANE_API_KEY=plane_api_XXXXXXXXXXXXXX
+export LINEAR_API_KEY=lin_api_XXXXXXXXXXXXXX
 # or
 cat > ~/.mintree/credentials.json <<'EOF'
-{ "plane": { "apiKey": "plane_api_XXXXXXXXXXXXXX" } }
+{ "linear": { "apiKey": "lin_api_XXXXXXXXXXXXXX" } }
 EOF
 chmod 600 ~/.mintree/credentials.json
 ```
 
-`mintree doctor` validates the key + each configured project's reachability when `provider === "plane"`.
+The key goes straight into the `Authorization` header (no `Bearer` prefix). `mintree doctor` validates the key, resolves the viewer, and pings each configured team when `provider === "linear"`.
 
 ---
 
@@ -143,10 +143,11 @@ Same building blocks, scriptable from any shell:
 ```bash
 # Create a worktree, optionally launch Claude with an initial prompt
 mintree worktree create feat/100-validar-patente
-mintree worktree create feat/BACK-100-validar-patente --work --prompt "empezar BACK-100"
+mintree worktree create feat/FE-123-validar-patente --work --prompt "empezar FE-123"
 
 # Resume Claude in the worktree you're currently inside
-cd .mintree/worktrees/BACK-100-validar-patente
+# (the worktree dir is the bare issue id)
+cd .mintree/worktrees/FE-123
 mintree worktree work
 
 # Inspect / clean up
@@ -176,11 +177,11 @@ mintree enforces:
 `<issue>` is one of:
 
 - Bare digits for GitHub Issues (the issue number, no `#`): `42`, `100`, `1234`
-- `<PROJ>-<digits>` for Plane work items (the human identifier): `BACK-100`, `WEB-7`, `PROJ_X-12`. The prefix is uppercase letters / digits / underscores, matching Plane's project-identifier constraints.
+- `<TEAM>-<digits>` for Linear issues (the human identifier): `FE-123`, `BE-7`, `DSGN-12`. The prefix is uppercase letters / digits / underscores, matching Linear's team-key constraints.
 
 `<desc>` is lowercase kebab-case.
 
-Examples: `feat/42-validacion-patente`, `fix/55-selfie-upload-timeout`, `feat/BACK-100-readme-update`, `fix/WEB-7-modal`.
+Examples: `feat/42-validacion-patente`, `fix/55-selfie-upload-timeout`, `feat/FE-123-readme-update`, `fix/BE-7-modal`.
 
 When the dashboard's `w` overlay opens, it suggests a kebab description capped at 5 words. If your repo has a `docs/conventions/git-workflow.md`, `CONTRIBUTING.md`, or `.claude/skills/` directory, mintree mentions it on the overlay so you can verify the suggestion against your project's rules — then edit the description to match.
 
@@ -194,16 +195,18 @@ When the dashboard's `w` overlay opens, it suggests a kebab description capped a
 └── .mintree/
     ├── metadata.json             # gitignored. provider config + <issue-id> → { base_branch?, session_id? }
     ├── worktrees/                # gitignored
-    │   ├── 100-validar-patente/      # GH form: <digits>-<desc>
-    │   └── BACK-100-readme-update/   # Plane form: <PROJ-digits>-<desc>
+    │   ├── 100/                  # GH form: <digits>
+    │   └── FE-123/               # Linear form: <TEAM-digits>
     ├── session-states/           # gitignored
     │   └── 100.json              # live state written by Claude hooks (active/waiting/idle/exited)
     └── init.sh                   # opt-in. Runs in the new worktree post-create (copy .env, install deps, …)
 ```
 
-`metadata.json` is gitignored because the `session_id` is local to your machine — sharing it would only generate noise. The `provider` and `plane.*` keys can be re-derived from a Plane workspace if needed; sharing them would just leak local config preference.
+The worktree directory is named after the bare issue id (`100`, `FE-123`); the branch keeps the full `<type>/<issue>-<desc>` name.
 
-Plane authentication lives in `~/.mintree/credentials.json` (user-scoped, not per-repo) or the `PLANE_API_KEY` env var.
+`metadata.json` is gitignored because the `session_id` is local to your machine — sharing it would only generate noise. The `provider` and `linear.*` keys can be re-derived from a Linear workspace if needed; sharing them would just leak local config preference.
+
+Linear authentication lives in `~/.mintree/credentials.json` (user-scoped, not per-repo) or the `LINEAR_API_KEY` env var.
 
 ---
 
@@ -220,7 +223,7 @@ Plane authentication lives in `~/.mintree/credentials.json` (user-scoped, not pe
 - `mintree doctor` is the first stop. It surfaces missing tools, unauthenticated CLIs, missing hooks, and gitignore drift.
 - The shell wrapper exports `MINTREE_SHELL_INTEGRATION=1` — if doctor says it's missing, the wrapper isn't being loaded by your shell init file.
 - If the dashboard ever opens with a stale session state, press `r` to force a refetch (the auto-refresh runs every 5 minutes).
-- Plane-side issues (timeouts, rate limits, unexpected response shapes) can be logged to `~/.mintree/plane-debug.log` by running `MINTREE_DEBUG=1 mintree dashboard`. The log is file-only so it never corrupts the Ink-rendered TUI.
+- Linear-side issues (timeouts, rate limits, unexpected response shapes) can be logged to `~/.mintree/linear-debug.log` by running `MINTREE_DEBUG=1 mintree dashboard`. The log is file-only so it never corrupts the Ink-rendered TUI.
 
 ---
 
@@ -228,7 +231,7 @@ Plane authentication lives in `~/.mintree/credentials.json` (user-scoped, not pe
 
 mintree was written for projects that have:
 
-- A small set of trackers (GitHub Issues or Plane) — santree supports both Linear and GitHub but is heavier.
+- A small set of trackers (GitHub Issues or Linear) — santree supports both too but is heavier.
 - An established branch convention without the `gh-` prefix santree imposes.
 - Skills (`.claude/skills/`) that own the SDD + TDD flow — mintree intentionally leaves the rich PR-create / PR-review prompts out of scope.
 

package/dist/commands/dashboard.js

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

package/dist/commands/worktree/work.js

@@ -67,15 +67,16 @@ function resolve(cwd) {
     const worktreeDirName = path.basename(worktreePath);
     // IssueId comes from the worktree dir name, not the branch — that way
     // detached-HEAD worktrees (the "current branch" path from the dashboard)
-    // still resolve their session_id. Convention guarantees the dir is named
-    // `<issueId>-<desc>` for both attached and detached creates, where
-    // issueId is either bare digits (GitHub) or `<TEAM>-\d+` (Linear).
-    const issueIdMatch = worktreeDirName.match(/^((?:[A-Z][A-Z0-9_]*-)?\d+)-/);
+    // still resolve their session_id. The dir is named after the bare issue
+    // id for both attached and detached creates; the trailing `-` clause still
+    // matches legacy `<issueId>-<desc>` worktrees. issueId is either bare
+    // digits (GitHub) or `<TEAM>-\d+` (Linear).
+    const issueIdMatch = worktreeDirName.match(/^((?:[A-Z][A-Z0-9_]*-)?\d+)(?:-|$)/);
     if (!issueIdMatch || !issueIdMatch[1]) {
         return {
             ok: false,
             message: `Worktree directory '${worktreeDirName}' doesn't start with an issue id.`,
-            hint: "Expected `<issue>-<desc>` (e.g. 100-claude-md-inicial or AUTH-6-legal-endpoint).",
+            hint: "Expected the issue id (e.g. 100 or AUTH-6).",
         };
     }
     const issueId = issueIdMatch[1];

package/dist/lib/branch.js

@@ -29,7 +29,7 @@ export const ALLOWED_TYPES = [
 // `<TEAM_PREFIX>-\d+` (Linear). The TEAM_PREFIX is uppercase letters/digits/
 // underscores starting with a letter, mirroring Linear's team-key
 // constraints. The full issueId captures group 2 verbatim so callers can
-// round-trip it into the worktree dir name.
+// reuse it as the worktree dir name.
 const BRANCH_REGEX = /^([a-z]+)\/((?:[A-Z][A-Z0-9_]*-)?\d+)-([a-z0-9][a-z0-9-]*)$/;
 export function parseBranch(branch) {
     const match = BRANCH_REGEX.exec(branch);
@@ -57,7 +57,9 @@ export function parseBranch(branch) {
         type: type,
         issueId,
         desc,
-        worktreeDirName: `${issueId}-${desc}`,
+        // Worktree dir is the bare issue id (e.g. "100" or "FE-123"). The desc
+        // only seeds the branch name, not the directory.
+        worktreeDirName: issueId,
     };
 }
 export function isParseError(result) {

package/dist/lib/dashboard.js

@@ -16,8 +16,10 @@ import { createProvider } from "./providers/index.js";
 function buildWorktreeIndex(repoRoot) {
     const worktreesRoot = path.resolve(getWorktreesDir(repoRoot));
     // Same shape as the BRANCH_REGEX issueId capture: bare digits (GitHub) or
-    // `<TEAM>-\d+` (Linear). Matches `100-foo` and `FE-123-foo` alike.
-    const dirNameRegex = /^((?:[A-Z][A-Z0-9_]*-)?\d+)-/;
+    // `<TEAM>-\d+` (Linear). The dir name is now the bare issue id (`100`,
+    // `FE-123`); the trailing `-` clause keeps matching legacy `<id>-<desc>`
+    // worktrees still on disk.
+    const dirNameRegex = /^((?:[A-Z][A-Z0-9_]*-)?\d+)(?:-|$)/;
     const index = new Map();
     for (const w of listWorktrees(repoRoot)) {
         const wAbs = path.resolve(w.path);
@@ -119,9 +121,10 @@ function sortGroupedIssues(issues, configuredUrl) {
  * Worktrees" at the bottom of the dashboard so the user can find and `d`elete
  * them.
  *
- * The `issue` stub uses the worktree directory name as the title (the part
- * after the issue id, e.g. "claude-md-inicial") so the row is identifiable
- * even when there's no live issue to fetch a title from.
+ * The `issue` stub uses the worktree directory name as the title — the bare
+ * issue id (e.g. "FE-123"), or the legacy "<id>-<desc>" suffix for older
+ * worktrees — so the row is identifiable even when there's no live issue to
+ * fetch a title from.
  */
 function buildOrphanRows(worktreesByIssue, assignedIds, sessionLookup, prByBranch, metadataSessionId) {
     const orphans = [];

package/dist/lib/session-signal.d.ts

@@ -16,10 +16,12 @@ export declare function extractRepoAndDir(cwd: string): {
     worktreeDir: string;
 } | null;
 /**
- * Pulls the issue id out of a `<issue>-<desc>` worktree directory name.
- * Returns null when the directory name doesn't follow the convention (e.g.
- * a manually-created worktree dropped under .mintree/worktrees/). The id
- * is either bare digits (GitHub) or a `<TEAM>-\d+` Linear identifier.
+ * Pulls the issue id out of a worktree directory name. The dir name is the
+ * bare issue id (`100`, `FE-123`); the trailing `-` clause still matches
+ * legacy `<issue>-<desc>` worktrees on disk. Returns null when the directory
+ * name doesn't follow the convention (e.g. a manually-created worktree
+ * dropped under .mintree/worktrees/). The id is either bare digits (GitHub)
+ * or a `<TEAM>-\d+` Linear identifier.
  */
 export declare function issueIdFromWorktreeDir(worktreeDir: string): string | null;
 export type StatePayload = {

package/dist/lib/session-signal.js

@@ -32,13 +32,15 @@ export function extractRepoAndDir(cwd) {
     return { repoRoot, worktreeDir };
 }
 /**
- * Pulls the issue id out of a `<issue>-<desc>` worktree directory name.
- * Returns null when the directory name doesn't follow the convention (e.g.
- * a manually-created worktree dropped under .mintree/worktrees/). The id
- * is either bare digits (GitHub) or a `<TEAM>-\d+` Linear identifier.
+ * Pulls the issue id out of a worktree directory name. The dir name is the
+ * bare issue id (`100`, `FE-123`); the trailing `-` clause still matches
+ * legacy `<issue>-<desc>` worktrees on disk. Returns null when the directory
+ * name doesn't follow the convention (e.g. a manually-created worktree
+ * dropped under .mintree/worktrees/). The id is either bare digits (GitHub)
+ * or a `<TEAM>-\d+` Linear identifier.
  */
 export function issueIdFromWorktreeDir(worktreeDir) {
-    const m = worktreeDir.match(/^((?:[A-Z][A-Z0-9_]*-)?\d+)-/);
+    const m = worktreeDir.match(/^((?:[A-Z][A-Z0-9_]*-)?\d+)(?:-|$)/);
     return m && m[1] ? m[1] : null;
 }
 /**

package/dist/lib/worktreeCreate.d.ts

@@ -66,7 +66,7 @@ export type CreateDetachedOpts = {
  * the `<type>/<issue>-<desc>` convention upfront. They can `git switch -c`
  * later if/when the work warrants a branch.
  *
- * Worktree dir naming follows the same `<issueId>-<desc>` shape as the
+ * Worktree dir naming follows the same bare-issueId shape as the
  * branch-based flow so `worktree work` can still recover the issueId from
  * the dir name (where it can't read it from the branch).
  */

package/dist/lib/worktreeCreate.js

@@ -238,7 +238,7 @@ export async function runCreate(branchArg, opts) {
  * the `<type>/<issue>-<desc>` convention upfront. They can `git switch -c`
  * later if/when the work warrants a branch.
  *
- * Worktree dir naming follows the same `<issueId>-<desc>` shape as the
+ * Worktree dir naming follows the same bare-issueId shape as the
  * branch-based flow so `worktree work` can still recover the issueId from
  * the dir name (where it can't read it from the branch).
  */
@@ -280,7 +280,7 @@ export async function runCreateDetached(opts) {
             hint: "Switch the main repo to a branch first (`git switch main`) and try again.",
         };
     }
-    const worktreeDirName = `${opts.issueId}-${opts.descKebab}`;
+    const worktreeDirName = opts.issueId;
     const worktreePath = path.join(getWorktreesDir(root), worktreeDirName);
     if (pathExists(worktreePath)) {
         return {

package/package.json

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