mintree 0.2.3 → 0.3.0

package/dist/commands/dashboard.js

@@ -99,12 +99,12 @@ function kebabize(title) {
  * `w` for an issue. Single-line on purpose — `ink-text-input` is one-line,
  * so multi-line templates render weirdly when the user tabs in to edit.
  * Provider-aware: GitHub issues get the `#<n>` + `gh issue view` form;
- * Plane work items (id like `DSGN-1`) get the bare id + the issue URL,
- * since `gh` can't read Plane and `#` isn't Plane's notation.
+ * Linear issues (id like `FE-123`) get the bare id + the issue URL, since
+ * `gh` can't read Linear and `#` isn't Linear's notation.
  */
 function defaultPromptForIssue(id, title, url) {
-    const isPlane = /^[A-Z][A-Z0-9_]*-\d+$/.test(id);
-    if (isPlane) {
+    const isTeamPrefixed = /^[A-Z][A-Z0-9_]*-\d+$/.test(id);
+    if (isTeamPrefixed) {
         return `Empezá a trabajar el ticket ${id} (${title}). Abrí ${url} para leer el contexto completo y seguí las convenciones del repo.`;
     }
     return `Empezá a trabajar el issue #${id} (${title}). Usá \`gh issue view ${id}\` para leer el contexto completo y seguí las convenciones del repo.`;
@@ -189,8 +189,8 @@ function CreateOverlayView({ overlay, onDescChange, onPromptChange, }) {
     return (_jsxs(Box, { flexGrow: 1, flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "Create worktree" }), _jsx(Text, { dimColor: true, children: ` for ${overlay.issue.issue.id}` })] }), _jsx(Box, { marginTop: 0, children: _jsx(Text, { children: overlay.issue.issue.title }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "branchMode", children: overlay.field === "branchMode" ? "▸ Branch:" : "  Branch:" }) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "<  " }), _jsx(Text, { color: overlay.field === "branchMode" ? "cyan" : undefined, bold: overlay.field === "branchMode", children: isNewBranch ? "new" : `current (${overlay.currentBranch ?? "?"})` }), _jsx(Text, { dimColor: true, children: "  >" })] }), overlay.field === "branchMode" && _jsx(Text, { dimColor: true, children: "   (use ← / → to toggle)" })] }), isNewBranch && (_jsxs(_Fragment, { children: [_jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "type", children: overlay.field === "type" ? "▸ Type:" : "  Type:" }) }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "<  " }), _jsx(Text, { color: overlay.field === "type" ? "cyan" : undefined, bold: overlay.field === "type", children: overlay.type }), _jsx(Text, { dimColor: true, children: "  >" })] }), overlay.field === "type" && _jsx(Text, { dimColor: true, children: "   (use ← / → to cycle)" })] }), _jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "desc", children: overlay.field === "desc" ? "▸ Description:" : "  Description:" }) }), _jsx(Box, { children: overlay.field === "desc" ? (_jsx(TextInput, { value: overlay.desc, onChange: onDescChange, placeholder: "kebab-case" })) : (_jsx(Text, { children: overlay.desc || "(empty)" })) })] })] })), _jsxs(Box, { marginTop: 0, children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { bold: overlay.field === "prompt", children: overlay.field === "prompt" ? "▸ Prompt:" : "  Prompt:" }) }), _jsx(Box, { children: overlay.field === "prompt" ? (_jsx(TextInput, { value: overlay.prompt, onChange: onPromptChange, placeholder: "(empty = no initial message)" })) : (_jsx(Text, { dimColor: true, children: overlay.prompt || "(empty — Claude starts with no message)" })) })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: " Checkout:" }) }), _jsx(Text, { color: "green", children: branchPreview })] }), _jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: " Worktree:" }) }), _jsxs(Text, { dimColor: true, children: [".mintree/worktrees/", dirPreview] })] }), _jsxs(Box, { children: [_jsx(Box, { width: labelWidth, children: _jsx(Text, { dimColor: true, children: " Mode:" }) }), _jsx(Text, { dimColor: true, children: "--work (Claude launches in the new worktree)" })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [isNewBranch ? (_jsxs(Text, { dimColor: true, children: ["Suggestion is a kebab of the title (capped at ", SUGGESTED_DESC_MAX_WORDS, " words). Edit it to match your repo's branch conventions."] })) : (_jsxs(Text, { dimColor: true, children: ["Detached HEAD at the tip of ", overlay.currentBranch ?? "the current branch", ". No new branch is created \u2014 commit on a new one with `git switch -c` when ready."] })), isNewBranch && overlay.conventionDoc && (_jsx(Text, { dimColor: true, children: `This repo has \`${overlay.conventionDoc}\` — review it before creating.` }))] }), overlay.error && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", bold: true, children: ["\u2717 ", overlay.error] }) })), overlay.pending && (_jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", overlay.pending] })] }))] }));
 }
 function IssueListRow({ d, selected, identifierWidth, rowWidth, }) {
-    // Display the issue id raw (e.g. "AUTH-6", "100"). The `#` prefix is a
-    // GitHub convention that reads as noise for Plane's already-prefixed
+    // Display the issue id raw (e.g. "FE-123", "100"). The `#` prefix is a
+    // GitHub convention that reads as noise for Linear's already-prefixed
     // ids, and dropping it across the board keeps the dashboard provider-
     // agnostic.
     const idText = d.issue.id.padEnd(identifierWidth, " ");
@@ -611,11 +611,11 @@ export default function Dashboard() {
         const issues = await loadDashboard(root);
         if (!issues) {
             const provider = readMetadata(root).provider ?? "github";
-            const message = provider === "plane"
-                ? "Could not fetch work items from Plane."
+            const message = provider === "linear"
+                ? "Could not fetch issues from Linear."
                 : "Could not fetch issues from GitHub.";
-            const hint = provider === "plane"
-                ? "Check `mintree doctor` — PLANE_API_KEY must be set and the workspace + projects reachable."
+            const hint = provider === "linear"
+                ? "Check `mintree doctor` — LINEAR_API_KEY must be set and the workspace + teams reachable."
                 : "Check `mintree doctor` — gh must be authenticated and the repo must live on GitHub.";
             setState((prev) => {
                 // Initial load failure → escalate to the full error screen so the
@@ -745,11 +745,11 @@ export default function Dashboard() {
     }, [state.phase === "ready" && state.overlay ? state.overlay.kind : null]);
     // Auto-refresh every 5 minutes while the dashboard is idle. 30s was too
     // aggressive for an issue list — most of the time nothing has changed,
-    // and with multiple Plane projects configured each refresh fires N×2
-    // API calls. Press `r` for an immediate refresh when something
-    // changed externally. Skipped while an overlay is open so we don't yank
-    // state from under a confirmation, and while a manual refresh is in
-    // flight to avoid stomping on its spinner.
+    // and even a single GraphQL refresh isn't worth firing twice a minute.
+    // Press `r` for an immediate refresh when something changed externally.
+    // Skipped while an overlay is open so we don't yank state from under a
+    // confirmation, and while a manual refresh is in flight to avoid
+    // stomping on its spinner.
     const stateRef = useRef(state);
     useEffect(() => {
         stateRef.current = state;
@@ -976,6 +976,26 @@ export default function Dashboard() {
     async function confirmCreate(overlay) {
         if (state.phase !== "ready")
             return;
+        // Validate first so we don't flash a spinner just to immediately show
+        // a sync-fail message.
+        if (overlay.branchMode === "new" && !overlay.desc.trim()) {
+            setState({
+                ...state,
+                overlay: { ...overlay, error: "Description is required." },
+            });
+            return;
+        }
+        // Surface the spinner BEFORE the heavy sync work. runCreate /
+        // runCreateDetached both block the event loop (execSync: git fetch +
+        // worktree add + optional .mintree/init.sh — easily several seconds on
+        // slow remotes or a repo with a real init script). Without the
+        // setImmediate yield Ink wouldn't get to paint the spinner until after
+        // that work finished, leaving the user staring at a frozen overlay.
+        setState({
+            ...state,
+            overlay: { ...overlay, error: null, pending: "Creating worktree..." },
+        });
+        await new Promise((resolve) => setImmediate(resolve));
         const prompt = overlay.prompt.trim();
         const issueId = overlay.issue.issue.id;
         let result;
@@ -993,13 +1013,6 @@ export default function Dashboard() {
         }
         else {
             const desc = overlay.desc.trim();
-            if (!desc) {
-                setState({
-                    ...state,
-                    overlay: { ...overlay, error: "Description is required." },
-                });
-                return;
-            }
             const branch = `${overlay.type}/${issueId}-${desc}`;
             result = runCreate(branch, {
                 work: true,
@@ -1009,7 +1022,11 @@ export default function Dashboard() {
         if (!result.ok) {
             setState({
                 ...state,
-                overlay: { ...overlay, error: result.message + (result.hint ? ` — ${result.hint}` : "") },
+                overlay: {
+                    ...overlay,
+                    pending: null,
+                    error: result.message + (result.hint ? ` — ${result.hint}` : ""),
+                },
             });
             return;
         }

package/dist/commands/doctor.js

@@ -8,7 +8,7 @@ import { createRequire } from "module";
 import { tryExec, getPath } from "../lib/exec.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 { checkLinearSetup } from "../lib/providers/linear.js";
 import { readMetadata } from "../lib/metadata.js";
 import { resolveClaudeBinary } from "../lib/claude.js";
 import { findMainRepoRoot, getMintreeDir, getInitScriptPath, isGitIgnored, isExecutable, pathExists, } from "../lib/git.js";
@@ -52,10 +52,12 @@ async function checkClaude() {
     };
 }
 async function checkGh(provider) {
-    // When provider=plane, gh is only used for PR detection on worktree
+    // When provider=linear, 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 description = provider === "linear"
+        ? "GitHub CLI (for PR status on worktrees)"
+        : "GitHub CLI for issues + PRs";
+    const required = provider !== "linear";
     const binPath = await getPath("gh");
     if (!binPath) {
         return {
@@ -269,10 +271,14 @@ 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);
+function LinearRow({ status }) {
+    const ok = status.configured &&
+        status.hasApiKey &&
+        status.authOk &&
+        status.teams.length > 0 &&
+        status.teams.every((t) => t.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] })] })] }));
+    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: "Linear" }), _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.teams.length > 0 ? (status.teams.map((t) => (_jsxs(Text, { dimColor: true, children: [t.ok ? "✓" : "✗", " team ", t.key, t.name ? ` (${t.name})` : "", t.error ? ` — ${t.error}` : ""] }, t.key)))) : (_jsx(Text, { dimColor: true, children: "No teams 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
@@ -310,7 +316,7 @@ 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 [linear, setLinear] = useState(null);
     const [rc, setRc] = useState(null);
     const [hooks, setHooks] = useState(null);
     const [setup, setSetup] = useState(null);
@@ -348,7 +354,7 @@ export default function Doctor() {
                 version: process.version,
             };
             toolResults.unshift(nodeRow);
-            // GH-specific probes only matter when provider=github. For plane we
+            // GH-specific probes only matter when provider=github. For linear 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"
@@ -357,41 +363,41 @@ export default function Doctor() {
             const projectScopeRes = resolvedProvider === "github"
                 ? await checkProjectScope()
                 : { scopes: null, hasScope: false };
-            // Plane probes only run when provider=plane. Always set state so the
+            // Linear probes only run when provider=linear. Always set state so the
             // loading guard resolves.
-            const planeRes = resolvedProvider === "plane" && root
-                ? await checkPlaneSetup(root)
-                : { configured: false, hasApiKey: false, authOk: false, projects: [] };
+            const linearRes = resolvedProvider === "linear" && root
+                ? await checkLinearSetup(root)
+                : { configured: false, hasApiKey: false, authOk: false, teams: [] };
             setTools(toolResults);
             setGh(ghRes);
             setProjectScope(projectScopeRes);
-            setPlane(planeRes);
+            setLinear(linearRes);
             setRc(checkRemoteControl());
             setHooks(checkSessionSignalHooks());
             setSetup(checkMintreeSetup());
             setShell(checkShellIntegration());
         })();
     }, []);
-    const loading = !tools || !gh || !projectScope || !plane || !rc || !hooks || !setup || !shell || !provider;
+    const loading = !tools || !gh || !projectScope || !linear || !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);
     // 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)
+    // must pass (auth + repo); when provider=linear, the Linear row must pass
+    // (api key + auth + at least one reachable team).
+    const providerOk = provider === "linear"
+        ? linear.configured &&
+            linear.hasApiKey &&
+            linear.authOk &&
+            linear.teams.length > 0 &&
+            linear.teams.every((t) => t.ok)
         : gh.inGitRepo
             ? gh.authenticated && !!gh.repoName
             : true;
     const shellOk = shell.configured;
     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"] }))] })) })] }));
+    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 === "linear" ? (_jsx(LinearRow, { status: linear })) : (_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

@@ -3,9 +3,10 @@ export declare const description = "Initialize the current repo for mintree (cre
 export declare const options: z.ZodObject<{
     provider: z.ZodDefault<z.ZodEnum<{
         github: "github";
-        plane: "plane";
+        linear: "linear";
     }>>;
     workspace: z.ZodOptional<z.ZodString>;
+    team: z.ZodOptional<z.ZodArray<z.ZodString>>;
     apiUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Props = {

package/dist/commands/init.js

@@ -9,7 +9,7 @@ import { findMainRepoRoot, getMintreeDir, getMetadataPath, getWorktreesDir, getS
 export const description = "Initialize the current repo for mintree (creates .mintree/, updates .gitignore)";
 export const options = z.object({
     provider: z
-        .enum(["github", "plane"])
+        .enum(["github", "linear"])
         .default("github")
         .describe(option({
         description: "Issue provider to scaffold for (default: github)",
@@ -18,13 +18,19 @@ export const options = z.object({
         .string()
         .optional()
         .describe(option({
-        description: "Plane workspace slug (required when --provider plane)",
+        description: "Linear workspace URL key (required when --provider linear)",
+    })),
+    team: z
+        .array(z.string())
+        .optional()
+        .describe(option({
+        description: "Linear team key (repeatable, e.g. --team FE --team BE)",
     })),
     apiUrl: z
         .string()
         .optional()
         .describe(option({
-        description: "Plane API URL (default: https://api.plane.so; override for self-hosted)",
+        description: "Linear GraphQL endpoint (default: https://api.linear.app/graphql; override only for self-hosted/proxy)",
     })),
 });
 function buildMetadataTemplate(opts) {
@@ -33,13 +39,15 @@ function buildMetadataTemplate(opts) {
         provider: opts.provider,
         issues: {},
     };
-    if (opts.provider === "plane") {
-        base["plane"] = {
-            apiUrl: opts.apiUrl ?? "https://api.plane.so",
+    if (opts.provider === "linear") {
+        const teams = (opts.team ?? []).map((key) => ({ key }));
+        base["linear"] = {
+            apiUrl: opts.apiUrl ?? "https://api.linear.app/graphql",
             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: [],
+            // Empty by default unless --team was passed — user fills in their
+            // teams before mintree can list assigned work items. Doctor will
+            // surface this gap.
+            teams,
         };
     }
     return base;
@@ -71,7 +79,7 @@ function runInit(opts) {
             hint: "Run `git init` first, then re-run `mintree init`.",
         };
     }
-    if (opts.provider === "plane" && (!opts.workspace || opts.workspace.length === 0)) {
+    if (opts.provider === "linear" && (!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.
     }
@@ -111,20 +119,24 @@ function runInit(opts) {
             hint: "Run: git rm --cached .mintree/metadata.json && git commit -m 'chore: untrack mintree metadata'",
         });
     }
-    // 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") {
+    // Linear scaffolds may be incomplete — workspaceSlug could be a placeholder
+    // and teams[] empty if no --team flags were passed. Tell the user exactly
+    // what to fix before doctor will pass.
+    if (opts.provider === "linear") {
         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(", ")}`,
-        });
+        if (!opts.team || opts.team.length === 0) {
+            needs.push("teams[] (add at least one { key, name? })");
+        }
+        if (needs.length > 0) {
+            steps.push({
+                kind: "warn",
+                label: "Linear scaffold needs manual edits",
+                hint: `Edit ${metadataPath} and fill in: ${needs.join(", ")}`,
+            });
+        }
     }
     return { ok: true, repoRoot: root, provider: opts.provider, steps };
 }
@@ -163,6 +175,7 @@ export default function Init({ options: opts }) {
                 setResult(runInit({
                     provider: opts.provider,
                     workspace: opts.workspace,
+                    team: opts.team,
                     apiUrl: opts.apiUrl,
                 }));
             }
@@ -173,7 +186,7 @@ export default function Init({ options: opts }) {
                 });
             }
         }, 0);
-    }, [opts.provider, opts.workspace, opts.apiUrl]);
+    }, [opts.provider, opts.workspace, opts.team, opts.apiUrl]);
     if (!result) {
         return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Initializing mintree..." })] }));
     }

package/dist/commands/worktree/list.js

@@ -16,7 +16,7 @@ export const options = z.object({
         .describe(option({ description: "Look up PR status for each branch via `gh` (slower)" })),
 });
 // 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.
+// or `<TEAM>-\d+` (Linear). Used to surface FE-123 in the ISSUE column.
 const ISSUE_ID_REGEX = /^[a-z]+\/((?:[A-Z][A-Z0-9_]*-)?\d+)-/;
 function extractIssueId(branch) {
     if (!branch)

package/dist/commands/worktree/work.js

@@ -69,7 +69,7 @@ function resolve(cwd) {
     // 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 `<PROJ>-\d+` (Plane).
+    // 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 {

package/dist/lib/branch.d.ts

@@ -4,8 +4,8 @@
  *     <type>/<issue>-<kebab-desc>
  *
  * `<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.
+ * bare digit run (GitHub issue number — "100") or a team-prefixed Linear
+ * identifier ("FE-100"); `<desc>` is lower-case kebab-case.
  *
  * Examples that PARSE: feat/100-readme-update, fix/55-upload-timeout,
  *                      feat/BACK-100-readme-update, fix/WEB-7-modal

package/dist/lib/branch.js

@@ -4,8 +4,8 @@
  *     <type>/<issue>-<kebab-desc>
  *
  * `<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.
+ * bare digit run (GitHub issue number — "100") or a team-prefixed Linear
+ * identifier ("FE-100"); `<desc>` is lower-case kebab-case.
  *
  * Examples that PARSE: feat/100-readme-update, fix/55-upload-timeout,
  *                      feat/BACK-100-readme-update, fix/WEB-7-modal
@@ -26,8 +26,8 @@ export const ALLOWED_TYPES = [
     "revert",
 ];
 // `<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
+// `<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.
 const BRANCH_REGEX = /^([a-z]+)\/((?:[A-Z][A-Z0-9_]*-)?\d+)-([a-z0-9][a-z0-9-]*)$/;

package/dist/lib/dashboard.js

@@ -6,7 +6,7 @@ import { fetchPrForBranch } from "./pr.js";
 import { createProvider } from "./providers/index.js";
 /**
  * Builds a map from issue id (the canonical string — "100" on GitHub,
- * "BACK-100" on Plane once that lands) to the matching mintree worktree.
+ * "FE-123" on Linear) to the matching mintree worktree.
  * IssueId comes from the worktree dir name (`<issue>-<desc>`) rather than
  * the branch, so detached worktrees (created via the dashboard's "current
  * branch" mode) are included alongside the regular branch-based ones.
@@ -15,7 +15,7 @@ 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
-    // `<PROJ>-\d+` (Plane). Matches `100-foo` and `BACK-100-foo` alike.
+    // `<TEAM>-\d+` (Linear). Matches `100-foo` and `FE-123-foo` alike.
     const dirNameRegex = /^((?:[A-Z][A-Z0-9_]*-)?\d+)-/;
     const index = new Map();
     for (const w of listWorktrees(repoRoot)) {
@@ -96,8 +96,8 @@ function sortGroupedIssues(issues, configuredUrl) {
             }
         }
         // Newest-first for issues — id is a numeric-or-prefixed string. Numeric
-        // compare falls back to localeCompare for non-numeric ids (Plane's
-        // "BACK-100" form).
+        // compare falls back to localeCompare for non-numeric ids (Linear's
+        // "FE-123" form).
         const an = Number(a.issue.id);
         const bn = Number(b.issue.id);
         if (Number.isFinite(an) && Number.isFinite(bn))
@@ -123,9 +123,7 @@ function buildOrphanRows(worktreesByIssue, assignedIds, sessionLookup, prByBranc
         const dirName = path.basename(w.path);
         // Strip the leading "<issueId>-" — that leaves the kebab description
         // that originally seeded the branch name.
-        const desc = dirName.startsWith(`${issueId}-`)
-            ? dirName.slice(issueId.length + 1)
-            : dirName;
+        const desc = dirName.startsWith(`${issueId}-`) ? dirName.slice(issueId.length + 1) : dirName;
         const sessionId = metadataSessionId(issueId);
         const worktree = { ...w, sessionId };
         const pr = w.branch ? (prByBranch.get(w.branch) ?? null) : null;

package/dist/lib/gh.d.ts

@@ -1,11 +1,11 @@
 /**
  * Thin shell helpers around the `gh` CLI. These are deliberately
- * provider-agnostic — even when mintree's issue provider is Plane, `gh` is
+ * provider-agnostic — even when mintree's issue provider is Linear, `gh` is
  * still used to look up PR status for worktree branches, so doctor and a
  * couple of dashboard surfaces need to know whether `gh` is reachable.
  *
  * The GitHub issue / Project v2 logic lives in `providers/github.ts` and
- * uses these helpers internally; the Plane provider doesn't touch them.
+ * uses these helpers internally; the Linear provider doesn't touch them.
  */
 export declare function ghCliAvailable(): Promise<boolean>;
 export declare function getGhUserLogin(): Promise<string | null>;

package/dist/lib/gh.js

@@ -1,11 +1,11 @@
 /**
  * Thin shell helpers around the `gh` CLI. These are deliberately
- * provider-agnostic — even when mintree's issue provider is Plane, `gh` is
+ * provider-agnostic — even when mintree's issue provider is Linear, `gh` is
  * still used to look up PR status for worktree branches, so doctor and a
  * couple of dashboard surfaces need to know whether `gh` is reachable.
  *
  * The GitHub issue / Project v2 logic lives in `providers/github.ts` and
- * uses these helpers internally; the Plane provider doesn't touch them.
+ * uses these helpers internally; the Linear provider doesn't touch them.
  */
 import { tryExec } from "./exec.js";
 export async function ghCliAvailable() {

package/dist/lib/metadata.d.ts

@@ -8,25 +8,24 @@ export type ProjectMeta = {
     inProgressOption?: string;
     protectedStatuses?: string[];
 };
-export type ProviderKind = "github" | "plane";
-export type PlaneProjectRef = {
-    id: string;
-    identifier: string;
+export type ProviderKind = "github" | "linear";
+export type LinearTeamRef = {
+    key: string;
     name?: string;
 };
-export type PlaneMeta = {
+export type LinearMeta = {
     apiUrl?: string;
     workspaceSlug: string;
-    projects: PlaneProjectRef[];
+    teams: LinearTeamRef[];
     inProgressStateName?: string;
-    protectedStateGroups?: string[];
+    protectedStateTypes?: string[];
 };
 export type Metadata = {
     version: 1;
     provider?: ProviderKind;
     issues: Record<string, IssueMeta>;
     project?: ProjectMeta;
-    plane?: PlaneMeta;
+    linear?: LinearMeta;
 };
 export declare function readMetadata(repoRoot: string): Metadata;
 export declare function writeMetadata(repoRoot: string, data: Metadata): void;

package/dist/lib/metadata.js

@@ -2,49 +2,47 @@ import * as fs from "fs";
 import { getMetadataPath } from "./git.js";
 const EMPTY = { version: 1, issues: {} };
 function sanitizeProvider(raw) {
-    if (raw === "github" || raw === "plane")
+    if (raw === "github" || raw === "linear")
         return raw;
     return undefined;
 }
-function sanitizePlaneProject(raw) {
+function sanitizeLinearTeam(raw) {
     if (typeof raw !== "object" || raw === null)
         return undefined;
     const r = raw;
-    if (typeof r["id"] !== "string" || r["id"].length === 0)
+    if (typeof r["key"] !== "string" || r["key"].length === 0)
         return undefined;
-    if (typeof r["identifier"] !== "string" || r["identifier"].length === 0)
-        return undefined;
-    const out = { id: r["id"], identifier: r["identifier"] };
+    const out = { key: r["key"] };
     if (typeof r["name"] === "string" && r["name"].length > 0)
         out.name = r["name"];
     return out;
 }
-function sanitizePlane(raw) {
+function sanitizeLinear(raw) {
     if (typeof raw !== "object" || raw === null)
         return undefined;
     const r = raw;
     if (typeof r["workspaceSlug"] !== "string" || r["workspaceSlug"].length === 0)
         return undefined;
-    const projectsRaw = Array.isArray(r["projects"]) ? r["projects"] : [];
-    const projects = [];
-    for (const p of projectsRaw) {
-        const sanitized = sanitizePlaneProject(p);
+    const teamsRaw = Array.isArray(r["teams"]) ? r["teams"] : [];
+    const teams = [];
+    for (const t of teamsRaw) {
+        const sanitized = sanitizeLinearTeam(t);
         if (sanitized)
-            projects.push(sanitized);
+            teams.push(sanitized);
     }
     const out = {
         workspaceSlug: r["workspaceSlug"],
-        projects,
+        teams,
     };
     if (typeof r["apiUrl"] === "string" && r["apiUrl"].length > 0)
         out.apiUrl = r["apiUrl"];
     if (typeof r["inProgressStateName"] === "string" && r["inProgressStateName"].length > 0) {
         out.inProgressStateName = r["inProgressStateName"];
     }
-    if (Array.isArray(r["protectedStateGroups"])) {
-        const arr = r["protectedStateGroups"].filter((v) => typeof v === "string" && v.length > 0);
+    if (Array.isArray(r["protectedStateTypes"])) {
+        const arr = r["protectedStateTypes"].filter((v) => typeof v === "string" && v.length > 0);
         if (arr.length > 0)
-            out.protectedStateGroups = arr;
+            out.protectedStateTypes = arr;
     }
     return out;
 }
@@ -78,7 +76,7 @@ export function readMetadata(repoRoot) {
             return { ...EMPTY, issues: {} };
         const project = sanitizeProject(parsed.project);
         const provider = sanitizeProvider(parsed.provider);
-        const plane = sanitizePlane(parsed.plane);
+        const linear = sanitizeLinear(parsed.linear);
         return {
             version: 1,
             issues: typeof parsed.issues === "object" && parsed.issues !== null
@@ -86,7 +84,7 @@ export function readMetadata(repoRoot) {
                 : {},
             ...(provider ? { provider } : {}),
             ...(project ? { project } : {}),
-            ...(plane ? { plane } : {}),
+            ...(linear ? { linear } : {}),
         };
     }
     catch {

package/dist/lib/pr.d.ts

@@ -4,8 +4,8 @@
  * same `gh pr list --head <branch>` shape. Centralising them here avoids
  * three copies of the shell-quote + JSON-parse dance going out of sync.
  *
- * PR detection stays gh-only even when the issue provider is Plane —
- * mintree's worktree branches live on GitHub, and Plane has no concept of
+ * PR detection stays gh-only even when the issue provider is Linear —
+ * mintree's worktree branches live on GitHub, and Linear has no concept of
  * git PRs. Callers that aren't sure whether `gh` is available pass through
  * `tryExec`-style failures as `null`, so the dashboard degrades to "no PR"
  * rows instead of erroring.