mintree 0.4.9 → 0.4.10

package/README.md

@@ -126,6 +126,32 @@ chmod 600 ~/.mintree/credentials.json
 
 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"`.
 
+### Launch behaviour (optional)
+
+Two top-level keys in `.mintree/metadata.json` tune how mintree launches Claude — both apply to GitHub and Linear repos alike:
+
+```json
+{
+  "version": 1,
+  "provider": "linear",
+  "issues": {},
+  "defaultPermissionMode": "auto",
+  "promptTemplate": "Trabajá en el ticket {{id}} ({{title}}). Abrí {{url}} para el contexto completo y seguí las convenciones del repo.",
+  "linear": { "workspaceSlug": "my-team", "teams": [{ "key": "FE" }] }
+}
+```
+
+- **`defaultPermissionMode`** (`"default"` | `"auto"`): the Claude `--permission-mode` mintree uses when it launches a session — from the dashboard (`w` / `↵`), `worktree work`, or `worktree create --work`. Omitted (or `"default"`) keeps the stricter default mode; `"auto"` starts every session with auto-accept on. The `--permission-mode` / `-m` CLI flag still overrides it per launch.
+- **`promptTemplate`**: the initial message seeded into the dashboard's `w` overlay (the text Claude receives as its first prompt). It replaces mintree's built-in default and supports these placeholders, substituted per issue:
+
+  | Placeholder | Replaced with                                         |
+  |-------------|-------------------------------------------------------|
+  | `{{id}}`    | Issue id — `100` (GitHub) or `FE-123` (Linear)        |
+  | `{{title}}` | Issue title                                           |
+  | `{{url}}`   | Issue URL (GitHub issue page / Linear issue link)     |
+
+  It's a single line on purpose — the overlay's prompt field is one line, and you can still edit it before launching. When omitted, mintree falls back to its provider-aware default (`gh issue view` for GitHub, the bare id + URL for Linear).
+
 ---
 
 ## Daily flow

package/dist/commands/dashboard.js

@@ -14,6 +14,7 @@ import { runCreate, runCreateDetached, } from "../lib/worktreeCreate.js";
 import { runRemove, runRemoveByPath } from "../lib/worktreeRemove.js";
 import { buildCreateMarkers, emitMarkers } from "../lib/markers.js";
 import { readMetadata } from "../lib/metadata.js";
+import { renderPromptTemplate } from "../lib/promptTemplate.js";
 import { createProvider } from "../lib/providers/index.js";
 import { loadDashboard } from "../lib/dashboard.js";
 import { priorityDisplay } from "../lib/priority.js";
@@ -121,11 +122,18 @@ function kebabize(title) {
  * Default prompt seeded into the overlay's Prompt field when the user opens
  * `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;
- * 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.
+ *
+ * When the repo configures a `promptTemplate` in `.mintree/metadata.json`,
+ * it wins: the `{{id}}`, `{{title}}` and `{{url}}` placeholders are rendered
+ * and the result seeds the field. Otherwise we fall back to the built-in,
+ * provider-aware default: GitHub issues get the `#<n>` + `gh issue view`
+ * form; 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) {
+function defaultPromptForIssue(id, title, url, template) {
+    if (template) {
+        return renderPromptTemplate(template, { id, title, url });
+    }
     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.`;
@@ -976,7 +984,8 @@ export default function Dashboard() {
         // (its `branchName`) over the synthesised `<type>/<issue>-<desc>` form —
         // that's the convention those repos actually follow. Falls back to the
         // convention form when the issue has no branchName.
-        const provider = root ? readMetadata(root).provider : undefined;
+        const meta = root ? readMetadata(root) : undefined;
+        const provider = meta?.provider;
         const linearBranch = provider === "linear" && issue.issue.branchName ? issue.issue.branchName : null;
         setState({
             ...state,
@@ -988,7 +997,7 @@ export default function Dashboard() {
                 type: "feat",
                 desc: kebabize(issue.issue.title) || `issue-${issue.issue.id}`,
                 linearBranch,
-                prompt: defaultPromptForIssue(issue.issue.id, issue.issue.title, issue.issue.url),
+                prompt: defaultPromptForIssue(issue.issue.id, issue.issue.title, issue.issue.url, meta?.promptTemplate),
                 field: "branchMode",
                 error: null,
                 conventionDoc: root ? findBranchConventionDoc(root) : null,

package/dist/commands/worktree/work.d.ts

@@ -3,7 +3,7 @@ export declare const description = "Launch Claude in the current worktree (creat
 export declare const options: z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
     promptFile: z.ZodOptional<z.ZodString>;
-    permissionMode: z.ZodDefault<z.ZodEnum<{
+    permissionMode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         auto: "auto";
     }>>;

package/dist/commands/worktree/work.js

@@ -8,7 +8,7 @@ import { randomUUID } from "crypto";
 import { readFileSync, unlinkSync } from "fs";
 import * as path from "path";
 import { findMainRepoRoot, getMintreeDir, getWorktreesDir, getCurrentBranch, pathExists, } from "../../lib/git.js";
-import { getSessionId, setSessionId } from "../../lib/metadata.js";
+import { getSessionId, setSessionId, readMetadata } from "../../lib/metadata.js";
 import { launchClaude, PERMISSION_MODES } from "../../lib/claude.js";
 export const description = "Launch Claude in the current worktree (creates or resumes a session)";
 export const options = z.object({
@@ -26,13 +26,13 @@ export const options = z.object({
     })),
     permissionMode: z
         .enum(PERMISSION_MODES)
-        .default("default")
+        .optional()
         .describe(option({
-        description: `Claude --permission-mode (one of: ${PERMISSION_MODES.join(", ")})`,
+        description: `Claude --permission-mode (one of: ${PERMISSION_MODES.join(", ")}). Defaults to metadata.defaultPermissionMode, else "default".`,
         alias: "m",
     })),
 });
-function resolve(cwd) {
+function resolve(cwd, flagPermissionMode) {
     const repoRoot = findMainRepoRoot(cwd);
     if (!repoRoot) {
         return {
@@ -93,6 +93,9 @@ function resolve(cwd) {
         setSessionId(repoRoot, issueId, sessionId);
         resume = false;
     }
+    // Effective permission mode: explicit `--permission-mode` flag wins, else
+    // the repo's `metadata.defaultPermissionMode`, else the stricter "default".
+    const permissionMode = flagPermissionMode ?? readMetadata(repoRoot).defaultPermissionMode ?? "default";
     return {
         ok: true,
         data: {
@@ -103,6 +106,7 @@ function resolve(cwd) {
             issueId,
             sessionId,
             resume,
+            permissionMode,
         },
     };
 }
@@ -118,7 +122,7 @@ export default function Work({ options }) {
                 });
                 return;
             }
-            const result = resolve(process.cwd());
+            const result = resolve(process.cwd(), options.permissionMode);
             if (!result.ok) {
                 setState({ phase: "error", message: result.message, hint: result.hint });
                 return;
@@ -151,7 +155,7 @@ export default function Work({ options }) {
         }
         try {
             const child = launchClaude({
-                permissionMode: options.permissionMode,
+                permissionMode: resolved.permissionMode,
                 sessionId: resolved.sessionId,
                 resume: resolved.resume,
                 prompt: effectivePrompt,
@@ -184,7 +188,7 @@ export default function Work({ options }) {
     const { resolved } = state;
     const sessionShort = resolved.sessionId.slice(0, 8);
     const action = resolved.resume ? "resuming" : "starting";
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree work" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", resolved.branch ?? `detached @ ${resolved.worktreeDirName}`] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "session: " }), _jsxs(Text, { children: [sessionShort, "\u2026"] }), _jsxs(Text, { dimColor: true, children: [" (", action, ")"] })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "permission-mode: " }), _jsx(Text, { children: options.permissionMode })] }), options.prompt && (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "initial prompt: " }), _jsxs(Text, { children: ["\"", truncate(options.prompt, 60), "\""] })] })), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "cwd: " }), _jsx(Text, { dimColor: true, children: resolved.worktreePath })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "mintree worktree work" }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", resolved.branch ?? `detached @ ${resolved.worktreeDirName}`] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "session: " }), _jsxs(Text, { children: [sessionShort, "\u2026"] }), _jsxs(Text, { dimColor: true, children: [" (", action, ")"] })] }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "permission-mode: " }), _jsx(Text, { children: resolved.permissionMode })] }), options.prompt && (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "initial prompt: " }), _jsxs(Text, { children: ["\"", truncate(options.prompt, 60), "\""] })] })), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "cwd: " }), _jsx(Text, { dimColor: true, children: resolved.worktreePath })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2713 Launching Claude..." }) })] }));
 }
 function truncate(s, max) {
     if (s.length <= max)

package/dist/lib/metadata.d.ts

@@ -1,3 +1,4 @@
+import { type PermissionMode } from "./claude.js";
 export type IssueMeta = {
     base_branch?: string;
     session_id?: string;
@@ -26,6 +27,8 @@ export type Metadata = {
     issues: Record<string, IssueMeta>;
     project?: ProjectMeta;
     linear?: LinearMeta;
+    defaultPermissionMode?: PermissionMode;
+    promptTemplate?: string;
 };
 export declare function readMetadata(repoRoot: string): Metadata;
 export declare function writeMetadata(repoRoot: string, data: Metadata): void;

package/dist/lib/metadata.js

@@ -1,11 +1,18 @@
 import * as fs from "fs";
 import { getMetadataPath } from "./git.js";
+import { PERMISSION_MODES } from "./claude.js";
 const EMPTY = { version: 1, issues: {} };
 function sanitizeProvider(raw) {
     if (raw === "github" || raw === "linear")
         return raw;
     return undefined;
 }
+function sanitizePermissionMode(raw) {
+    return PERMISSION_MODES.includes(raw) ? raw : undefined;
+}
+function sanitizePromptTemplate(raw) {
+    return typeof raw === "string" && raw.trim().length > 0 ? raw : undefined;
+}
 function sanitizeLinearTeam(raw) {
     if (typeof raw !== "object" || raw === null)
         return undefined;
@@ -77,6 +84,8 @@ export function readMetadata(repoRoot) {
         const project = sanitizeProject(parsed.project);
         const provider = sanitizeProvider(parsed.provider);
         const linear = sanitizeLinear(parsed.linear);
+        const defaultPermissionMode = sanitizePermissionMode(parsed.defaultPermissionMode);
+        const promptTemplate = sanitizePromptTemplate(parsed.promptTemplate);
         return {
             version: 1,
             issues: typeof parsed.issues === "object" && parsed.issues !== null
@@ -85,6 +94,8 @@ export function readMetadata(repoRoot) {
             ...(provider ? { provider } : {}),
             ...(project ? { project } : {}),
             ...(linear ? { linear } : {}),
+            ...(defaultPermissionMode ? { defaultPermissionMode } : {}),
+            ...(promptTemplate ? { promptTemplate } : {}),
         };
     }
     catch {

package/dist/lib/promptTemplate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Variables available to a `promptTemplate` in `.mintree/metadata.json`.
+ * Kept intentionally small — the template seeds Claude's first message, it
+ * doesn't need the whole issue object.
+ */
+export type PromptVars = {
+    id: string;
+    title: string;
+    url: string;
+};
+export declare const PROMPT_PLACEHOLDERS: readonly ["{{id}}", "{{title}}", "{{url}}"];
+/**
+ * Renders a `promptTemplate` by substituting the `{{id}}`, `{{title}}` and
+ * `{{url}}` placeholders with the issue's values. Whitespace inside the braces
+ * is tolerated (`{{ id }}`). Unknown placeholders are left untouched so a typo
+ * is visible in the launched prompt instead of silently vanishing.
+ */
+export declare function renderPromptTemplate(template: string, vars: PromptVars): string;

package/dist/lib/promptTemplate.js

@@ -0,0 +1,15 @@
+// Placeholder tokens a user can drop into their `promptTemplate`. Documented
+// here so the README and any future `init`/help output stay in sync.
+export const PROMPT_PLACEHOLDERS = ["{{id}}", "{{title}}", "{{url}}"];
+/**
+ * Renders a `promptTemplate` by substituting the `{{id}}`, `{{title}}` and
+ * `{{url}}` placeholders with the issue's values. Whitespace inside the braces
+ * is tolerated (`{{ id }}`). Unknown placeholders are left untouched so a typo
+ * is visible in the launched prompt instead of silently vanishing.
+ */
+export function renderPromptTemplate(template, vars) {
+    return template
+        .replace(/\{\{\s*id\s*\}\}/g, vars.id)
+        .replace(/\{\{\s*title\s*\}\}/g, vars.title)
+        .replace(/\{\{\s*url\s*\}\}/g, vars.url);
+}

package/package.json

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