mintree 0.5.13 → 0.5.14

package/README.md

@@ -161,11 +161,11 @@ Three top-level keys in `.mintree/metadata.json` tune how mintree launches Claud
 
   When omitted, mintree uses a built-in default that asks Claude to orchestrate the selected tickets with minimal intervention — parallelising via subagents unless dependencies force sequential work, creating a worktree per ticket with mintree, using the repo's skills, and moving each ticket to *in progress* on start and closing it when done.
 
-### Linking gitignored files into worktrees (optional)
+### Copying gitignored files into worktrees (optional)
 
 Git worktrees don't share **untracked** files: a new worktree is a fresh working directory, so gitignored config like `.env` lives only in your main checkout and is **absent** in every worktree mintree creates. That breaks per-worktree tooling that needs it — e.g. running an E2E suite that reads `.env` for staging credentials.
 
-The `linkFiles` top-level key (valid on GitHub and Linear repos) lists repo-root-relative paths that mintree **symlinks** into each new worktree, right after creating it:
+The `linkFiles` top-level key (valid on GitHub and Linear repos) lists repo-root-relative paths that mintree **copies** into each new worktree, right after creating it:
 
 ```json
 {
@@ -177,10 +177,11 @@ The `linkFiles` top-level key (valid on GitHub and Linear repos) lists repo-root
 }
 ```
 
-- **Symlink, not copy** — one source of truth. Rotate a credential in the main `.env` and every worktree sees it; no re-copying. `worktree remove` deletes the link, never the original file.
+- **Copy, not symlink** — each worktree gets its **own** file. Editing the worktree's `.env` (a port, a feature flag, a per-worktree tweak) stays local and never mutates the main checkout's. The trade-off: it's a snapshot taken at create time, so rotating a credential in the main `.env` does **not** propagate to worktrees already created — re-copy by hand if you need it.
+  > Up to 0.5.13 these were **symlinks**, so editing a worktree's `.env` wrote through to the main checkout. The switch to copies only affects worktrees created from 0.5.14 on — existing worktrees keep their old symlink. To convert one, replace the link with a real copy: `rm <worktree>/.env && cp <repo-root>/.env <worktree>/.env`.
 - **Best-effort, never fatal** — an entry that doesn't exist in the repo root is skipped, and so is one whose target is already present in the worktree (e.g. a tracked file). Both show up as `skip` steps in the create log.
-- **Runs before `.mintree/init.sh`** — so the post-create hook (if any) can rely on the linked files being there.
-- **Sandboxed paths** — entries must be repo-root-relative; absolute paths and `..` escapes are dropped on read, so a stray `metadata.json` can't make mintree link something outside the worktree.
+- **Runs before `.mintree/init.sh`** — so the post-create hook (if any) can rely on the copied files being there.
+- **Sandboxed paths** — entries must be repo-root-relative; absolute paths and `..` escapes are dropped on read, so a stray `metadata.json` can't make mintree copy something outside the worktree.
 
 This applies to `worktree create` (CLI), the dashboard `w` overlay, and the detached-worktree flow alike. For more involved per-worktree setup (installing deps, copying templated files), use `.mintree/init.sh` instead — see [What gets stored where](#what-gets-stored-where).
 
@@ -226,6 +227,9 @@ Same building blocks, scriptable from any shell:
 mintree worktree create feat/100-validar-patente
 mintree worktree create feat/FE-123-validar-patente --work --prompt "empezar FE-123"
 
+# Fork from a specific base instead of origin/HEAD (defaults to main/master)
+mintree worktree create fix/55-hotfix --base release/2.1
+
 # On a Linear repo you can pass the issue's own Linear branch name
 mintree worktree create martinmineo/val-68-landing-publica --work
 
@@ -314,7 +318,7 @@ Linear authentication lives in `~/.mintree/credentials.json` (user-scoped, not p
 
 - **Sessions persist by issue**: each issue gets a UUID stored in `metadata.json`. Subsequent `worktree work` calls pass `--resume <uuid>` so Claude reopens the same conversation.
 - **Live state** (optional): the four hooks installed by `mintree helpers session-signal install` write the current Claude state to `.mintree/session-states/<issue>.json` on every prompt / stop / notification / session-end. The dashboard reads those files to colour each row in real time.
-- **Remote Control** (optional): `mintree doctor` checks `~/.claude.json` for `remoteControlAtStartup: true`. Enabling it lets you continue a local session from a different device.
+- **Remote Control** (optional): `mintree doctor` checks `~/.claude.json` for `remoteControlAtStartup: true`. Enable it by running `/config` inside Claude Code and turning on *Enable Remote Control for all sessions* — it lets you continue a local session from a different device.
 - **iTerm2 session badge** (automatic): when you launch on [iTerm2](https://iterm2.com), mintree sets the terminal **badge** — the large translucent label drawn over the session — to the session name (the worktree issue id like `VAL-68`, or the orchestrator's name) so each tab stays identifiable at a glance. It uses the badge rather than the tab title because Claude Code overwrites the title while it runs; the badge is independent of it and persists for the whole session, then clears on exit. No-op on other terminals (detected via `TERM_PROGRAM` / `LC_TERMINAL`).
 
 ---

package/dist/lib/metadata.js

@@ -20,7 +20,7 @@ function sanitizeOrchestratorPromptTemplate(raw) {
 /**
  * Keeps only safe, repo-root-relative paths. Drops non-strings, blanks,
  * absolute paths and any entry that escapes the repo root via `..` — a
- * malicious / fat-fingered `metadata.json` must never make mintree symlink
+ * malicious / fat-fingered `metadata.json` must never make mintree copy
  * something outside the worktree. Normalises and de-dupes the survivors.
  */
 function sanitizeLinkFiles(raw) {

package/dist/lib/worktreeCreate.js

@@ -50,23 +50,25 @@ function tryRunInitScript(scriptPath, worktreePath, repoRoot) {
     }
 }
 /**
- * Symlinks each `metadata.linkFiles` entry from the main repo into the freshly
+ * Copies each `metadata.linkFiles` entry from the main repo into the freshly
  * created worktree. Git worktrees don't share untracked files, so gitignored
- * config like `.env` is absent in a new worktree; this links it in so the
+ * config like `.env` is absent in a new worktree; this copies it in so the
  * worktree's tooling finds the same secrets/config as the main checkout.
  *
- * A symlink (not a copy) keeps a single source of truth — rotating a credential
- * in the main `.env` is seen by every worktree, and `worktree remove` deletes
- * only the link. Entries are repo-root-relative (already validated by
- * `sanitizeLinkFiles`). Each entry is best-effort: a missing source or an
+ * A copy (not a symlink) gives each worktree its OWN file — editing the
+ * worktree's `.env` no longer mutates the main checkout's, so a per-worktree
+ * tweak (a port, a feature flag) stays local. The trade-off is no single source
+ * of truth: rotating a credential in the main `.env` does NOT propagate to
+ * already-created worktrees. Entries are repo-root-relative (already validated
+ * by `sanitizeLinkFiles`). Each entry is best-effort: a missing source or an
  * already-present target is skipped, never fatal.
  */
-function linkFilesIntoWorktree(repoRoot, worktreePath, linkFiles, pushStep) {
+function copyFilesIntoWorktree(repoRoot, worktreePath, linkFiles, pushStep) {
     for (const rel of linkFiles) {
         const source = path.join(repoRoot, rel);
         const target = path.join(worktreePath, rel);
         if (!pathExists(source)) {
-            pushStep({ kind: "skip", label: `skipped link ${rel}`, detail: "not present in repo root" });
+            pushStep({ kind: "skip", label: `skipped copy ${rel}`, detail: "not present in repo root" });
             continue;
         }
         // lstat (not pathExists) so an existing symlink/file/dir already at the
@@ -83,20 +85,20 @@ function linkFilesIntoWorktree(repoRoot, worktreePath, linkFiles, pushStep) {
         if (targetTaken) {
             pushStep({
                 kind: "skip",
-                label: `skipped link ${rel}`,
+                label: `skipped copy ${rel}`,
                 detail: "already present in worktree",
             });
             continue;
         }
         try {
             fs.mkdirSync(path.dirname(target), { recursive: true });
-            fs.symlinkSync(source, target);
-            pushStep({ kind: "ok", label: `linked ${rel}`, detail: `→ ${source}` });
+            fs.copyFileSync(source, target);
+            pushStep({ kind: "ok", label: `copied ${rel}`, detail: `from ${source}` });
         }
         catch (err) {
             pushStep({
                 kind: "warn",
-                label: `failed to link ${rel}`,
+                label: `failed to copy ${rel}`,
                 detail: err instanceof Error ? err.message : String(err),
             });
         }
@@ -260,11 +262,11 @@ export async function runCreate(branchArg, opts) {
     upsertIssue(root, parsed.issueId, base ? { base_branch: base } : {});
     pushStep({ kind: "ok", label: "metadata updated", detail: `issue ${parsed.issueId}` });
     await nextFrame(progress);
-    // Link gitignored config (e.g. .env) before init.sh, so the hook can rely
+    // Copy gitignored config (e.g. .env) before init.sh, so the hook can rely
     // on those files being present.
     const linkFiles = readMetadata(root).linkFiles;
     if (linkFiles && linkFiles.length > 0) {
-        linkFilesIntoWorktree(root, worktreePath, linkFiles, pushStep);
+        copyFilesIntoWorktree(root, worktreePath, linkFiles, pushStep);
         await nextFrame(progress);
     }
     const initShPath = getInitScriptPath(root);
@@ -422,11 +424,11 @@ export async function runCreateDetached(opts) {
     upsertIssue(root, opts.issueId, { base_branch: currentBranch });
     pushStep({ kind: "ok", label: "metadata updated", detail: `issue ${opts.issueId}` });
     await nextFrame(progress);
-    // Link gitignored config (e.g. .env) before init.sh, so the hook can rely
+    // Copy gitignored config (e.g. .env) before init.sh, so the hook can rely
     // on those files being present.
     const linkFiles = readMetadata(root).linkFiles;
     if (linkFiles && linkFiles.length > 0) {
-        linkFilesIntoWorktree(root, worktreePath, linkFiles, pushStep);
+        copyFilesIntoWorktree(root, worktreePath, linkFiles, pushStep);
         await nextFrame(progress);
     }
     const initShPath = getInitScriptPath(root);

package/package.json

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