@wipcomputer/wip-ai-devops-toolbox 1.9.45 → 1.9.46

package/CHANGELOG.md

@@ -31,6 +31,47 @@
 
 
 
+
+## 1.9.46 (2026-03-18)
+
+# Release Notes: wip-ai-devops-toolbox v1.9.46
+
+**Centralized worktree management: guard rule, wip-release prune, Dev Guide convention.**
+
+## What changed
+
+### Guard: worktree path warning (#212)
+Branch guard now warns when `git worktree add` creates a worktree outside `_worktrees/`. Shows the convention and suggests `ldm worktree add`. Warning only, not a hard block.
+
+### wip-release: worktree prune (#212)
+New step 12 in the release pipeline. After branch cleanup, prunes stale worktrees from `_worktrees/` whose branches are merged into main. Automatic cleanup after every release.
+
+### Dev Guide: _worktrees/ convention (#212)
+Documents the centralized worktree convention:
+- All worktrees go in `_worktrees/<repo-name>--<branch-suffix>/`
+- Use `ldm worktree add` (auto-detects repo, creates in the right place)
+- Guard warns about worktrees outside the convention
+- `wip-release` auto-prunes merged worktrees
+
+## Why
+
+Worktrees created as repo siblings confused iCloud sync, looked like real repos in directory listings, and were never cleaned up. This session alone created 10+ stale worktrees. The convention keeps them organized and the release pipeline cleans them automatically.
+
+## Issues closed
+
+- #212
+- #213
+
+## How to verify
+
+```bash
+# Guard warning:
+cd /path/to/repo
+git worktree add ../my-worktree -b test   # should warn about _worktrees/
+
+# Correct path:
+ldm worktree add cc-mini/test             # creates _worktrees/<repo>--cc-mini--test/
+```
 
 ## 1.9.45 (2026-03-18)
 

package/DEV-GUIDE-GENERAL-PUBLIC.md

@@ -524,16 +524,42 @@ gh api "repos/<org>/<repo>/branches/main/protection" -X PUT \
 
 The main working tree stays on `main` and is read-only in practice. All development happens in git worktrees. This keeps the primary clone clean, prevents accidental commits to main, and enables parallel work within a single agent.
 
+### Worktree Location Convention
+
+**All worktrees go in `_worktrees/` as a sibling to the repos directory.** Never create worktrees as siblings to repos directly. They look like real repos, confuse iCloud sync, and are hard to find/clean.
+
+**Convention:** `_worktrees/<repo-name>--<branch-suffix>/`
+
+```
+repos/
+  ldm-os/
+    components/
+      memory-crystal-private/     <- real repo
+    devops/
+      wip-ai-devops-toolbox-private/  <- real repo
+  _worktrees/
+    memory-crystal-private--cc-mini--fix-search/   <- worktree
+    wip-ai-devops-toolbox-private--cc-mini--guard/  <- worktree
+```
+
 ### Starting a Worktree
 
-From Claude Code:
+**Preferred:** Use the `ldm worktree` command:
+```bash
+ldm worktree add cc-mini/fix-bug    # auto-detects repo, creates in _worktrees/
+```
+
+**From Claude Code:**
 ```bash
 claude --worktree <name>
 ```
 
-Or mid-session, say "work in a worktree" and the session will move into one.
+**Manual:**
+```bash
+git worktree add ../_worktrees/<repo>--<branch> -b <branch>
+```
 
-Worktrees live at `.claude/worktrees/` inside the repo. Each worktree gets its own directory with a full checkout on a separate branch.
+The branch guard warns if you create worktrees outside `_worktrees/` or `.claude/worktrees/`.
 
 ### Branch Naming
 

package/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 interface: [cli, module, mcp, skill, hook, plugin]
 metadata:
   display-name: "WIP AI DevOps Toolbox"
-  version: "1.9.45"
+  version: "1.9.46"
   homepage: "https://github.com/wipcomputer/wip-ai-devops-toolbox"
   author: "Parker Todd Brooks"
   category: dev-tools

package/_trash/RELEASE-NOTES-v1-9-41.md

@@ -0,0 +1,28 @@
+# Release Notes: wip-ai-devops-toolbox v1.9.41
+
+**One-line summary of what this release does**
+
+## What changed
+
+Describe the changes. Not a commit list. Explain:
+- What was built or fixed
+- Why it matters
+- What the user should know
+
+## Why
+
+What problem does this solve? What was broken or missing?
+
+## Issues closed
+
+- #251
+- #117
+- #128
+- #250
+- #73
+
+## How to verify
+
+```bash
+# Commands to test the changes
+```

package/_trash/RELEASE-NOTES-v1-9-46.md

@@ -0,0 +1,38 @@
+# Release Notes: wip-ai-devops-toolbox v1.9.46
+
+**Centralized worktree management: guard rule, wip-release prune, Dev Guide convention.**
+
+## What changed
+
+### Guard: worktree path warning (#212)
+Branch guard now warns when `git worktree add` creates a worktree outside `_worktrees/`. Shows the convention and suggests `ldm worktree add`. Warning only, not a hard block.
+
+### wip-release: worktree prune (#212)
+New step 12 in the release pipeline. After branch cleanup, prunes stale worktrees from `_worktrees/` whose branches are merged into main. Automatic cleanup after every release.
+
+### Dev Guide: _worktrees/ convention (#212)
+Documents the centralized worktree convention:
+- All worktrees go in `_worktrees/<repo-name>--<branch-suffix>/`
+- Use `ldm worktree add` (auto-detects repo, creates in the right place)
+- Guard warns about worktrees outside the convention
+- `wip-release` auto-prunes merged worktrees
+
+## Why
+
+Worktrees created as repo siblings confused iCloud sync, looked like real repos in directory listings, and were never cleaned up. This session alone created 10+ stale worktrees. The convention keeps them organized and the release pipeline cleans them automatically.
+
+## Issues closed
+
+- #212
+- #213
+
+## How to verify
+
+```bash
+# Guard warning:
+cd /path/to/repo
+git worktree add ../my-worktree -b test   # should warn about _worktrees/
+
+# Correct path:
+ldm worktree add cc-mini/test             # creates _worktrees/<repo>--cc-mini--test/
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-ai-devops-toolbox",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "type": "module",
   "description": "The complete AI DevOps toolkit for AI-assisted development teams.",
   "license": "MIT",

package/tools/deploy-public/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/deploy-public",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "description": "Private-to-public repo sync. Excludes ai/ folder, creates PR, merges, cleans up branches.",
   "bin": {
     "deploy-public": "./deploy-public.sh"

package/tools/post-merge-rename/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/post-merge-rename",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "description": "Post-merge branch renaming. Appends --merged-YYYY-MM-DD to preserve history.",
   "bin": {
     "post-merge-rename": "./post-merge-rename.sh"

package/tools/wip-branch-guard/guard.mjs

@@ -225,6 +225,21 @@ async function main() {
         }
       } catch {}
     }
+
+    // Warn when creating worktrees outside _worktrees/ (#212)
+    const wtMatch = cmd.match(/\bgit\s+worktree\s+add\s+["']?([^\s"']+)/);
+    if (wtMatch) {
+      const wtPath = wtMatch[1];
+      if (!wtPath.includes('_worktrees') && !wtPath.includes('.claude/worktrees')) {
+        deny(`WARNING: Creating worktree outside _worktrees/. Use: ldm worktree add <branch>
+
+The convention is _worktrees/<repo>--<branch>/ so worktrees don't mix with real repos.
+Manual equivalent: git worktree add ../_worktrees/<repo>--<branch> -b <branch>
+
+This is a warning, not a block. If you need to create it here, retry.`);
+        process.exit(0);
+      }
+    }
   }
 
   // Determine which repo to check.

package/tools/wip-branch-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-branch-guard",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "description": "PreToolUse hook that blocks all writes on main branch. Forces agents to work on branches or worktrees.",
   "type": "module",
   "main": "guard.mjs",

package/tools/wip-file-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-file-guard",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "type": "module",
   "description": "Hook that blocks destructive edits to protected identity files. For Claude Code CLI and OpenClaw.",
   "main": "guard.mjs",

package/tools/wip-license-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-license-guard",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "description": "License compliance for your own repos. Ensures correct copyright, dual-license blocks, and LICENSE files.",
   "type": "module",
   "bin": {

package/tools/wip-license-hook/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-license-hook",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "description": "License rug-pull detection and dependency license compliance for open source projects",
   "type": "module",
   "main": "dist/cli/index.js",

package/tools/wip-readme-format/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-readme-format",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "description": "Reformat any repo's README to follow the WIP Computer standard. Agent-first, human-readable.",
   "type": "module",
   "bin": {

package/tools/wip-release/core.mjs

@@ -1579,6 +1579,39 @@ export async function release({ repoPath, level, notes, notesSource, dryRun, noP
     console.log(`  ! Branch prune skipped: ${e.message}`);
   }
 
+  // 12. Prune stale worktrees (#212)
+  try {
+    execSync('git worktree prune', { cwd: repoPath, stdio: 'pipe' });
+    // Also check _worktrees/ for dirs whose branches are now merged
+    const worktreesDir = join(dirname(repoPath), '_worktrees');
+    if (existsSync(worktreesDir)) {
+      const repoBase = basename(repoPath);
+      const wtDirs = readdirSync(worktreesDir, { withFileTypes: true })
+        .filter(d => d.isDirectory() && d.name.startsWith(repoBase + '--'));
+      let wtPruned = 0;
+      for (const d of wtDirs) {
+        const wtPath = join(worktreesDir, d.name);
+        try {
+          // Check if branch is merged into main
+          const branch = execSync('git branch --show-current', {
+            cwd: wtPath, encoding: 'utf8', timeout: 3000
+          }).trim();
+          if (branch) {
+            execSync(`git merge-base --is-ancestor "${branch}" main`, {
+              cwd: repoPath, stdio: 'pipe', timeout: 5000
+            });
+            // Branch is merged. Remove worktree.
+            execSync(`git worktree remove "${wtPath}"`, { cwd: repoPath, stdio: 'pipe' });
+            wtPruned++;
+          }
+        } catch {} // Branch not merged or other issue, leave it
+      }
+      if (wtPruned > 0) {
+        console.log(`  ✓ Pruned ${wtPruned} merged worktree(s) from _worktrees/`);
+      }
+    }
+  } catch {}
+
   // Write release marker so branch guard blocks immediate install (#73)
   try {
     const markerDir = join(process.env.HOME || '', '.ldm', 'state');

package/tools/wip-release/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-release",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "type": "module",
   "description": "One-command release pipeline. Bumps version, updates changelog + SKILL.md, publishes to npm + GitHub.",
   "main": "core.mjs",

package/tools/wip-repo-init/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-repo-init",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "description": "Scaffold the standard ai/ directory structure in any repo",
   "type": "module",
   "bin": {

package/tools/wip-repo-permissions-hook/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-repo-permissions-hook",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "type": "module",
   "description": "Repo visibility guard. Blocks repos from going public without a -private counterpart.",
   "main": "core.mjs",

package/tools/wip-repos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-repos",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "type": "module",
   "description": "Repo manifest reconciler. Single source of truth for repo organization. Like prettier for folder structure.",
   "main": "core.mjs",

package/tools/wip-universal-installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/universal-installer",
-  "version": "1.9.45",
+  "version": "1.9.46",
   "type": "module",
   "description": "The Universal Interface specification for agent-native software. Teaches your AI how to build repos with every interface: CLI, Module, MCP Server, OpenClaw Plugin, Skill, Claude Code Hook.",
   "main": "detect.mjs",