mintree 0.1.11 → 0.2.0

package/dist/commands/doctor.js

@@ -6,8 +6,10 @@ import * as fs from "fs";
 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 { ghCliAvailable, getGhUserLogin, getRepoFullName } from "../lib/gh.js";
+import { getGhTokenScopes, hasProjectScope } from "../lib/providers/github.js";
+import { checkPlaneSetup } from "../lib/providers/plane.js";
+import { readMetadata } from "../lib/metadata.js";
 import { resolveClaudeBinary } from "../lib/claude.js";
 import { findMainRepoRoot, getMintreeDir, getInitScriptPath, isGitIgnored, isExecutable, pathExists, } from "../lib/git.js";
 const require = createRequire(import.meta.url);
@@ -49,13 +51,17 @@ async function checkClaude() {
         path: resolved,
     };
 }
-async function checkGh() {
+async function checkGh(provider) {
+    // When provider=plane, gh is only used for PR detection on worktree
+    // branches — still useful, but not strictly required for the issue flow.
+    const description = provider === "plane" ? "GitHub CLI (for PR status on worktrees)" : "GitHub CLI for issues + PRs";
+    const required = provider !== "plane";
     const binPath = await getPath("gh");
     if (!binPath) {
         return {
             name: "gh",
-            description: "GitHub CLI for issues + PRs",
-            required: true,
+            description,
+            required,
             installed: false,
             hint: "Install: brew install gh && gh auth login",
         };
@@ -65,8 +71,8 @@ async function checkGh() {
     if (!login) {
         return {
             name: "gh",
-            description: "GitHub CLI for issues + PRs",
-            required: true,
+            description,
+            required,
             installed: true,
             version: ver || "unknown",
             path: binPath,
@@ -75,8 +81,8 @@ async function checkGh() {
     }
     return {
         name: "gh",
-        description: "GitHub CLI for issues + PRs",
-        required: true,
+        description,
+        required,
         installed: true,
         version: ver || "unknown",
         path: binPath,
@@ -263,6 +269,11 @@ function ProjectScopeRow({ status }) {
     }
     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 PlaneRow({ status }) {
+    const ok = status.configured && status.hasApiKey && status.authOk && status.projects.length > 0 && status.projects.every((p) => p.ok);
+    const required = status.configured;
+    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: "Plane" }), _jsx(Text, { dimColor: true, children: " - issue listing + In Progress transition" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["API key: ", status.hasApiKey ? "loaded" : "missing", status.authOk && status.user ? ` · user: ${status.user}` : ""] }), status.workspaceSlug && (_jsxs(Text, { dimColor: true, children: ["Workspace: ", status.workspaceSlug, status.apiUrl ? ` (${status.apiUrl})` : ""] })), status.projects.length > 0 ? (status.projects.map((p) => (_jsxs(Text, { dimColor: true, children: [p.ok ? "✓" : "✗", " project ", p.identifier, " (", p.id.slice(0, 8), "\u2026)", p.error ? ` — ${p.error}` : ""] }, p.id)))) : (_jsx(Text, { dimColor: true, children: "No projects configured" })), 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
@@ -299,15 +310,25 @@ export default function Doctor() {
     const [tools, setTools] = useState(null);
     const [gh, setGh] = useState(null);
     const [projectScope, setProjectScope] = useState(null);
+    const [plane, setPlane] = useState(null);
     const [rc, setRc] = useState(null);
     const [hooks, setHooks] = useState(null);
     const [setup, setSetup] = useState(null);
     const [shell, setShell] = useState(null);
+    // Provider drives which integration rows appear + tweaks the gh row's
+    // description/required flag. Read once on mount; doctor doesn't react to
+    // metadata changes mid-run.
+    const [provider, setProvider] = useState(null);
     useEffect(() => {
         (async () => {
+            const root = findMainRepoRoot();
+            const resolvedProvider = root
+                ? (readMetadata(root).provider ?? "github")
+                : "github";
+            setProvider(resolvedProvider);
             const toolResults = await Promise.all([
                 checkTool("git", "Version control", true, "git --version | head -1", "Install: brew install git"),
-                checkGh(),
+                checkGh(resolvedProvider),
                 checkClaude(),
                 checkTool("tmux", "Open worktrees in separate windows", false, "tmux -V", "Install: brew install tmux"),
             ]);
@@ -327,28 +348,50 @@ export default function Doctor() {
                 version: process.version,
             };
             toolResults.unshift(nodeRow);
-            const ghRes = await checkGithubIssues();
-            const projectScopeRes = await checkProjectScope();
+            // GH-specific probes only matter when provider=github. For plane we
+            // still need *some* value in state so the loading guard resolves, but
+            // the row is hidden — populate with a default and skip the network.
+            const ghRes = resolvedProvider === "github"
+                ? await checkGithubIssues()
+                : { authenticated: false, inGitRepo: false };
+            const projectScopeRes = resolvedProvider === "github"
+                ? await checkProjectScope()
+                : { scopes: null, hasScope: false };
+            // Plane probes only run when provider=plane. Always set state so the
+            // loading guard resolves.
+            const planeRes = resolvedProvider === "plane" && root
+                ? await checkPlaneSetup(root)
+                : { configured: false, hasApiKey: false, authOk: false, projects: [] };
             setTools(toolResults);
             setGh(ghRes);
             setProjectScope(projectScopeRes);
+            setPlane(planeRes);
             setRc(checkRemoteControl());
             setHooks(checkSessionSignalHooks());
             setSetup(checkMintreeSetup());
             setShell(checkShellIntegration());
         })();
     }, []);
-    const loading = !tools || !gh || !projectScope || !rc || !hooks || !setup || !shell;
+    const loading = !tools || !gh || !projectScope || !plane || !rc || !hooks || !setup || !shell || !provider;
     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);
-    // 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;
+    // Provider-specific OK check: when provider=github, the GH integration row
+    // must pass (auth + repo); when provider=plane, the Plane row must pass
+    // (api key + auth + at least one reachable project).
+    const providerOk = provider === "plane"
+        ? plane.configured &&
+            plane.hasApiKey &&
+            plane.authOk &&
+            plane.projects.length > 0 &&
+            plane.projects.every((p) => p.ok)
+        : 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(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"] }))] })) })] }));
+    const allRequired = requiredMissing.length === 0 && providerOk && shellOk;
+    const requiredFailing = requiredMissing.length + (providerOk ? 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" }) }), provider === "plane" ? (_jsx(PlaneRow, { status: plane })) : (_jsxs(_Fragment, { children: [_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.d.ts

@@ -1,2 +1,15 @@
+import { z } from "zod";
 export declare const description = "Initialize the current repo for mintree (creates .mintree/, updates .gitignore)";
-export default function Init(): import("react/jsx-runtime").JSX.Element;
+export declare const options: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        github: "github";
+        plane: "plane";
+    }>>;
+    workspace: z.ZodOptional<z.ZodString>;
+    apiUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Props = {
+    options: z.infer<typeof options>;
+};
+export default function Init({ options: opts }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/commands/init.js

@@ -3,12 +3,47 @@ import { useEffect, useState } from "react";
 import { Box, Text } from "ink";
 import Spinner from "ink-spinner";
 import * as fs from "fs";
+import { option } from "pastel";
+import { z } from "zod";
 import { findMainRepoRoot, getMintreeDir, getMetadataPath, getWorktreesDir, getSessionStatesDir, ensureGitignoreEntries, isGitTracked, } from "../lib/git.js";
 export const description = "Initialize the current repo for mintree (creates .mintree/, updates .gitignore)";
-const METADATA_TEMPLATE = {
-    version: 1,
-    issues: {},
-};
+export const options = z.object({
+    provider: z
+        .enum(["github", "plane"])
+        .default("github")
+        .describe(option({
+        description: "Issue provider to scaffold for (default: github)",
+    })),
+    workspace: z
+        .string()
+        .optional()
+        .describe(option({
+        description: "Plane workspace slug (required when --provider plane)",
+    })),
+    apiUrl: z
+        .string()
+        .optional()
+        .describe(option({
+        description: "Plane API URL (default: https://api.plane.so; override for self-hosted)",
+    })),
+});
+function buildMetadataTemplate(opts) {
+    const base = {
+        version: 1,
+        provider: opts.provider,
+        issues: {},
+    };
+    if (opts.provider === "plane") {
+        base["plane"] = {
+            apiUrl: opts.apiUrl ?? "https://api.plane.so",
+            workspaceSlug: opts.workspace ?? "FILL-IN-WORKSPACE-SLUG",
+            // Empty by default — user fills in their projects before mintree
+            // can list assigned work items. Doctor will surface this gap.
+            projects: [],
+        };
+    }
+    return base;
+}
 function ensureDir(p, label, steps) {
     if (fs.existsSync(p)) {
         steps.push({ kind: "exists", label });
@@ -18,15 +53,16 @@ function ensureDir(p, label, steps) {
         steps.push({ kind: "created", label });
     }
 }
-function ensureMetadata(metadataPath, steps) {
+function ensureMetadata(metadataPath, opts, steps) {
     if (fs.existsSync(metadataPath)) {
         steps.push({ kind: "exists", label: ".mintree/metadata.json" });
         return;
     }
-    fs.writeFileSync(metadataPath, JSON.stringify(METADATA_TEMPLATE, null, 2) + "\n");
+    const template = buildMetadataTemplate(opts);
+    fs.writeFileSync(metadataPath, JSON.stringify(template, null, 2) + "\n");
     steps.push({ kind: "created", label: ".mintree/metadata.json" });
 }
-function runInit() {
+function runInit(opts) {
     const root = findMainRepoRoot();
     if (!root) {
         return {
@@ -35,6 +71,10 @@ function runInit() {
             hint: "Run `git init` first, then re-run `mintree init`.",
         };
     }
+    if (opts.provider === "plane" && (!opts.workspace || opts.workspace.length === 0)) {
+        // Allow it to proceed with a FILL-IN placeholder so the user gets a
+        // working scaffold to edit, but flag it loudly via a warn step below.
+    }
     const steps = [];
     const mintreeDir = getMintreeDir(root);
     const worktreesDir = getWorktreesDir(root);
@@ -43,7 +83,7 @@ function runInit() {
     ensureDir(mintreeDir, ".mintree/", steps);
     ensureDir(worktreesDir, ".mintree/worktrees/", steps);
     ensureDir(sessionStatesDir, ".mintree/session-states/", steps);
-    ensureMetadata(metadataPath, steps);
+    ensureMetadata(metadataPath, opts, steps);
     // metadata.json holds the per-issue session_id, which is local-only by
     // nature (each dev gets their own UUIDs from `claude`). Versioning it
     // would only generate noise + merge conflicts, so it's gitignored along
@@ -71,7 +111,22 @@ function runInit() {
             hint: "Run: git rm --cached .mintree/metadata.json && git commit -m 'chore: untrack mintree metadata'",
         });
     }
-    return { ok: true, repoRoot: root, steps };
+    // Plane scaffolds are intentionally incomplete — projects[] is empty and
+    // workspaceSlug may be a placeholder. Tell the user exactly what to fix
+    // before doctor will pass.
+    if (opts.provider === "plane") {
+        const needs = [];
+        if (!opts.workspace || opts.workspace.length === 0) {
+            needs.push("workspaceSlug");
+        }
+        needs.push("projects[] (add at least one { id, identifier, name? })");
+        steps.push({
+            kind: "warn",
+            label: "Plane scaffold needs manual edits",
+            hint: `Edit ${metadataPath} and fill in: ${needs.join(", ")}`,
+        });
+    }
+    return { ok: true, repoRoot: root, provider: opts.provider, steps };
 }
 function StepIcon({ kind }) {
     switch (kind) {
@@ -99,13 +154,17 @@ function stepDetail(kind) {
             return null;
     }
 }
-export default function Init() {
+export default function Init({ options: opts }) {
     const [result, setResult] = useState(null);
     useEffect(() => {
         // Defer one tick so the initial render with the spinner gets to paint.
         setTimeout(() => {
             try {
-                setResult(runInit());
+                setResult(runInit({
+                    provider: opts.provider,
+                    workspace: opts.workspace,
+                    apiUrl: opts.apiUrl,
+                }));
             }
             catch (err) {
                 setResult({
@@ -114,7 +173,7 @@ export default function Init() {
                 });
             }
         }, 0);
-    }, []);
+    }, [opts.provider, opts.workspace, opts.apiUrl]);
     if (!result) {
         return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Initializing mintree..." })] }));
     }
@@ -122,7 +181,7 @@ export default function Init() {
         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");
-    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) => {
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree init" }), _jsx(Text, { dimColor: true, children: ` · ${result.repoRoot}` }), _jsx(Text, { dimColor: true, children: ` · provider=${result.provider}` })] }), 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));
             }), _jsx(Box, { marginTop: 1, children: anyChange ? (_jsxs(Text, { color: "green", children: ["mintree initialized. Run ", _jsx(Text, { bold: true, children: "mintree doctor" }), " to verify the rest of your setup."] })) : (_jsx(Text, { color: "cyan", children: "mintree was already initialized \u2014 nothing to do." })) })] }));

package/dist/commands/worktree/clean.js

@@ -6,7 +6,7 @@ import { option } from "pastel";
 import { z } from "zod";
 import * as path from "path";
 import { findMainRepoRoot, getMintreeDir, getWorktreesDir, listWorktrees, isDirty, removeWorktree, pathExists, } from "../../lib/git.js";
-import { tryExec } from "../../lib/exec.js";
+import { fetchPrForBranch } from "../../lib/pr.js";
 export const description = "Remove worktrees whose PR is merged or closed";
 export const options = z.object({
     yes: z
@@ -22,23 +22,6 @@ export const options = z.object({
         description: "Include worktrees with uncommitted changes (clean is conservative by default)",
     })),
 });
-function shQuote(value) {
-    return `'${value.replace(/'/g, `'\\''`)}'`;
-}
-async function fetchPr(branch) {
-    const out = await tryExec(`gh pr list --head ${shQuote(branch)} --state all --json number,state --limit 1 2>/dev/null`);
-    if (!out)
-        return null;
-    try {
-        const arr = JSON.parse(out);
-        if (Array.isArray(arr) && arr.length > 0 && arr[0])
-            return arr[0];
-    }
-    catch {
-        // fall through
-    }
-    return null;
-}
 async function loadCandidates(force) {
     const root = findMainRepoRoot();
     if (!root) {
@@ -67,7 +50,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) => fetchPrForBranch(w.branch, { withUrl: false })));
     const candidates = [];
     for (let i = 0; i < ours.length; i++) {
         const w = ours[i];

package/dist/commands/worktree/create.js

@@ -8,7 +8,7 @@ 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";
+import { createProvider, describeTransition } from "../../lib/providers/index.js";
 export const description = "Create a worktree for an issue branch";
 export const args = z.tuple([
     z.string().describe(argument({
@@ -89,7 +89,8 @@ export default function Create({ args, options }) {
                 return;
             }
             try {
-                const r = await transitionIssueToInProgress(root, result.issueId);
+                const provider = createProvider(root);
+                const r = await provider.transitionIssueToInProgress(result.issueId);
                 if (!cancelled)
                     setTransition(r);
             }

package/dist/commands/worktree/list.js

@@ -7,7 +7,7 @@ import { z } from "zod";
 import * as path from "path";
 import { findMainRepoRoot, getWorktreesDir, listWorktrees, isDirty, getAheadBehind, pathExists, getMintreeDir, } from "../../lib/git.js";
 import { readMetadata } from "../../lib/metadata.js";
-import { tryExec } from "../../lib/exec.js";
+import { fetchPrForBranch } from "../../lib/pr.js";
 export const description = "List mintree-managed worktrees with dirty/ahead/PR status";
 export const options = z.object({
     pr: z
@@ -15,31 +15,15 @@ export const options = z.object({
         .default(false)
         .describe(option({ description: "Look up PR status for each branch via `gh` (slower)" })),
 });
-const ISSUE_ID_REGEX = /^[a-z]+\/(\d+)-/;
+// Matches the BRANCH_REGEX shape from lib/branch.ts: either `\d+` (GitHub)
+// or `<PROJ>-\d+` (Plane). Used to surface BACK-100 in the ISSUE column.
+const ISSUE_ID_REGEX = /^[a-z]+\/((?:[A-Z][A-Z0-9_]*-)?\d+)-/;
 function extractIssueId(branch) {
     if (!branch)
         return null;
     const m = branch.match(ISSUE_ID_REGEX);
     return m && m[1] ? m[1] : null;
 }
-async function fetchPrStatus(branch) {
-    const out = await tryExec(`gh pr list --head ${shQuote(branch)} --state all --json number,state --limit 1 2>/dev/null`);
-    if (!out)
-        return undefined;
-    try {
-        const arr = JSON.parse(out);
-        if (Array.isArray(arr) && arr.length > 0 && arr[0]) {
-            return { number: arr[0].number, state: arr[0].state };
-        }
-    }
-    catch {
-        // fall through
-    }
-    return undefined;
-}
-function shQuote(value) {
-    return `'${value.replace(/'/g, `'\\''`)}'`;
-}
 async function load(checkPr) {
     const root = findMainRepoRoot();
     if (!root) {
@@ -82,9 +66,13 @@ 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(null)
+            : fetchPrForBranch(r.branch, { withUrl: false })));
         rows.forEach((r, i) => {
-            r.pr = prResults[i];
+            const pr = prResults[i];
+            if (pr)
+                r.pr = pr;
         });
     }
     return { phase: "ready", repoRoot: root, rows, checkedPr: checkPr };

package/dist/commands/worktree/work.js

@@ -68,13 +68,14 @@ function resolve(cwd) {
     // 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.
-    const issueIdMatch = worktreeDirName.match(/^(\d+)-/);
+    // `<issueId>-<desc>` for both attached and detached creates, where
+    // issueId is either bare digits (GitHub) or `<PROJ>-\d+` (Plane).
+    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 number.`,
-            hint: "Expected `<issue>-<desc>` (e.g. 100-claude-md-inicial).",
+            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).",
         };
     }
     const issueId = issueIdMatch[1];

package/dist/lib/branch.d.ts

@@ -3,11 +3,14 @@
  *
  *     <type>/<issue>-<kebab-desc>
  *
- * `<type>` is one of the 11 conventional prefixes; `<issue>` is the GitHub
- * issue number (digits only, no `#`); `<desc>` is lower-case kebab-case.
+ * `<type>` is one of the 11 conventional prefixes; `<issue>` is either a
+ * bare digit run (GitHub issue number — "100") or a project-prefixed Plane
+ * identifier ("BACK-100"); `<desc>` is lower-case kebab-case.
  *
- * Examples that PARSE: feat/100-readme-update, fix/55-upload-timeout
- * Examples that REJECT: feat/abc-foo, /100-foo, gh-100-foo, feat/100, feat/100-FooBar
+ * Examples that PARSE: feat/100-readme-update, fix/55-upload-timeout,
+ *                      feat/BACK-100-readme-update, fix/WEB-7-modal
+ * Examples that REJECT: feat/abc-foo, /100-foo, gh-100-foo, feat/100,
+ *                       feat/100-FooBar, feat/back-100-x (lowercase prefix)
  */
 export declare const ALLOWED_TYPES: readonly ["feat", "fix", "docs", "chore", "refactor", "test", "build", "ci", "perf", "style", "revert"];
 export type BranchType = (typeof ALLOWED_TYPES)[number];

package/dist/lib/branch.js

@@ -3,11 +3,14 @@
  *
  *     <type>/<issue>-<kebab-desc>
  *
- * `<type>` is one of the 11 conventional prefixes; `<issue>` is the GitHub
- * issue number (digits only, no `#`); `<desc>` is lower-case kebab-case.
+ * `<type>` is one of the 11 conventional prefixes; `<issue>` is either a
+ * bare digit run (GitHub issue number — "100") or a project-prefixed Plane
+ * identifier ("BACK-100"); `<desc>` is lower-case kebab-case.
  *
- * Examples that PARSE: feat/100-readme-update, fix/55-upload-timeout
- * Examples that REJECT: feat/abc-foo, /100-foo, gh-100-foo, feat/100, feat/100-FooBar
+ * Examples that PARSE: feat/100-readme-update, fix/55-upload-timeout,
+ *                      feat/BACK-100-readme-update, fix/WEB-7-modal
+ * Examples that REJECT: feat/abc-foo, /100-foo, gh-100-foo, feat/100,
+ *                       feat/100-FooBar, feat/back-100-x (lowercase prefix)
  */
 export const ALLOWED_TYPES = [
     "feat",
@@ -22,20 +25,25 @@ export const ALLOWED_TYPES = [
     "style",
     "revert",
 ];
-const BRANCH_REGEX = /^([a-z]+)\/(\d+)-([a-z0-9][a-z0-9-]*)$/;
+// `<type>/<issueId>-<desc>` where issueId is either `\d+` (GitHub) or
+// `<PROJ_PREFIX>-\d+` (Plane). The PROJ_PREFIX is uppercase letters/digits/
+// underscores starting with a letter, mirroring Plane's project-identifier
+// constraints. The full issueId captures group 2 verbatim so callers can
+// round-trip it into 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);
     if (!match) {
         return {
             error: `Invalid branch name: ${branch}`,
-            hint: "Expected `<type>/<issue>-<kebab-desc>`. Example: feat/100-claude-md-inicial",
+            hint: "Expected `<type>/<issue>-<kebab-desc>`. Examples: feat/100-claude-md-inicial, feat/BACK-100-claude-md-inicial",
         };
     }
     const [, type, issueId, desc] = match;
     if (!type || !issueId || !desc) {
         return {
             error: `Invalid branch name: ${branch}`,
-            hint: "Expected `<type>/<issue>-<kebab-desc>`. Example: feat/100-claude-md-inicial",
+            hint: "Expected `<type>/<issue>-<kebab-desc>`. Examples: feat/100-claude-md-inicial, feat/BACK-100-claude-md-inicial",
         };
     }
     if (!ALLOWED_TYPES.includes(type)) {

package/dist/lib/dashboard.d.ts

@@ -1,16 +1,8 @@
 import { type AheadBehind } from "./git.js";
-export type GhIssue = {
-    number: number;
-    title: string;
-    state: string;
-    url: string;
-    labels: {
-        name: string;
-    }[];
-    body: string;
-    createdAt: string;
-    updatedAt: string;
-};
+import { type PrInfo } from "./pr.js";
+import type { IssueProjectInfo, ProviderIssue } from "./providers/types.js";
+export type { PrInfo, PrState } from "./pr.js";
+export type { ProviderIssue, IssueProjectInfo, IssueId } from "./providers/types.js";
 export type WorktreeInfo = {
     path: string;
     branch: string | null;
@@ -24,42 +16,13 @@ export type SessionStateInfo = {
     at: string;
     message: string | null;
 };
-export type PrInfo = {
-    number: number;
-    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;
+    issue: ProviderIssue;
     worktree: WorktreeInfo | null;
     session: SessionStateInfo | null;
     pr: PrInfo | null;
     project: IssueProjectInfo | null;
 };
-/**
- * Fetches open issues assigned to the authenticated GitHub user for the
- * current cwd's repo. Returns null when `gh` isn't authenticated, the cwd
- * isn't a GitHub repo, or the API call fails — the caller surfaces the
- * appropriate hint.
- */
-export declare function fetchAssignedIssues(): Promise<GhIssue[] | null>;
 /**
  * Top-level loader: enriches each assigned issue with its worktree and
  * session snapshot. Designed to be called on dashboard mount and on every