episoda 0.2.59 → 0.2.62

package/dist/index.js

@@ -3178,6 +3178,7 @@ var WorktreeManager = class _WorktreeManager {
   /**
    * Remove a worktree for a module
    * P1-2: Wrapped entire operation in lock to prevent race with createWorktree
+   * EP1070: Clean build caches before git worktree remove to prevent orphaned directories
    */
   async removeWorktree(moduleUid, force = false) {
     if (!validateModuleUid(moduleUid)) {
@@ -3201,6 +3202,7 @@ var WorktreeManager = class _WorktreeManager {
           error: `No worktree found for module ${moduleUid}`
         };
       }
+      await this.cleanBuildCaches(existing.worktreePath);
       const result = await this.gitExecutor.execute({
         action: "worktree_remove",
         path: existing.worktreePath,
@@ -3425,6 +3427,37 @@ var WorktreeManager = class _WorktreeManager {
     } catch {
     }
   }
+  /**
+   * EP1070: Clean build caches before worktree removal
+   *
+   * Removes common build cache directories that can cause:
+   * 1. git worktree remove to fail (locked files on Windows)
+   * 2. Orphaned directories if removal partially fails
+   * 3. Disk space waste from abandoned build artifacts
+   *
+   * @param worktreePath - Absolute path to the worktree directory
+   */
+  async cleanBuildCaches(worktreePath) {
+    const cacheDirs = [
+      ".next",
+      // Next.js build cache
+      "node_modules/.cache",
+      // Various build tool caches (babel, eslint, etc.)
+      ".turbo"
+      // Turborepo cache
+    ];
+    for (const cacheDir of cacheDirs) {
+      const cachePath = path3.join(worktreePath, cacheDir);
+      try {
+        if (fs2.existsSync(cachePath)) {
+          console.log(`[WorktreeManager] EP1070: Cleaning build cache: ${cacheDir}`);
+          fs2.rmSync(cachePath, { recursive: true, force: true });
+        }
+      } catch (error) {
+        console.warn(`[WorktreeManager] EP1070: Failed to clean ${cacheDir} (non-blocking):`, error.message);
+      }
+    }
+  }
   readConfig() {
     try {
       if (!fs2.existsSync(this.configPath)) {
@@ -5367,6 +5400,13 @@ async function setupWorktreeEnv(worktreePath, apiUrl, accessToken) {
 }
 
 // src/commands/checkout.ts
+function generateBranchName(moduleUid, title) {
+  if (!title) {
+    return moduleUid || "unnamed";
+  }
+  const slug = title.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 50);
+  return `${moduleUid}-${slug}`;
+}
 async function checkoutCommand(moduleUid, options = {}) {
   if (!moduleUid || !moduleUid.match(/^EP\d+$/)) {
     throw new Error(
@@ -5417,7 +5457,7 @@ The .bare directory or .episoda/config.json may be missing.`
     moduleUid,
     config.access_token
   );
-  const branchName = moduleDetails.branch_name || `feature/${moduleUid.toLowerCase()}`;
+  const branchName = moduleDetails.branch_name || generateBranchName(moduleUid, moduleDetails.name);
   let createBranch = !moduleDetails.branch_name || options.create;
   if (createBranch && !moduleDetails.branch_name) {
     const { GitExecutor: GitExecutor4 } = await Promise.resolve().then(() => __toESM(require_dist()));
@@ -5732,11 +5772,12 @@ async function listWorktrees(options) {
     throw new Error(`Invalid worktree project at ${projectRoot}`);
   }
   const config = manager.getConfig();
-  const worktrees = manager.listWorktrees();
+  const { valid, stale, orphaned } = await manager.validateWorktrees();
   console.log("");
   console.log(import_chalk2.default.bold(`Worktrees for ${config?.workspaceSlug}/${config?.projectSlug}`));
   console.log("\u2500".repeat(60));
-  if (worktrees.length === 0) {
+  const hasAnyWorktrees = valid.length > 0 || stale.length > 0 || orphaned.length > 0;
+  if (!hasAnyWorktrees) {
     console.log("");
     console.log(import_chalk2.default.gray("  No worktrees checked out"));
     console.log("");
@@ -5745,7 +5786,7 @@ async function listWorktrees(options) {
     return;
   }
   const gitExecutor = new import_core13.GitExecutor();
-  for (const wt of worktrees) {
+  for (const wt of valid) {
     console.log("");
     let statusIndicator = import_chalk2.default.green("\u25CF");
     let statusNote = "";
@@ -5772,11 +5813,38 @@ async function listWorktrees(options) {
       console.log(import_chalk2.default.gray(`    Last accessed: ${new Date(wt.lastAccessed).toLocaleDateString()}`));
     }
   }
+  if (stale.length > 0) {
+    console.log("");
+    console.log(import_chalk2.default.yellow("  Stale entries (in config but removed from git):"));
+    for (const wt of stale) {
+      console.log(import_chalk2.default.yellow(`    \u26A0 ${wt.moduleUid} - ${wt.worktreePath}`));
+    }
+    console.log(import_chalk2.default.gray("    These will be cleaned up automatically on next daemon restart"));
+  }
+  if (orphaned.length > 0) {
+    console.log("");
+    console.log(import_chalk2.default.red("  Orphaned worktrees (in git but not in config):"));
+    for (const wtPath of orphaned) {
+      const moduleUid = path13.basename(wtPath);
+      console.log(import_chalk2.default.red(`    \u2717 ${moduleUid} - ${wtPath}`));
+    }
+    console.log(import_chalk2.default.gray("    These may be from crashed sessions. Run `episoda release <uid>` to clean up"));
+  }
   console.log("");
   console.log(import_chalk2.default.gray("\u2500".repeat(60)));
-  console.log(`${worktrees.length} worktree${worktrees.length === 1 ? "" : "s"}`);
+  const parts = [];
+  if (valid.length > 0) {
+    parts.push(`${valid.length} active`);
+  }
+  if (stale.length > 0) {
+    parts.push(import_chalk2.default.yellow(`${stale.length} stale`));
+  }
+  if (orphaned.length > 0) {
+    parts.push(import_chalk2.default.red(`${orphaned.length} orphaned`));
+  }
+  console.log(parts.join(", "));
   console.log("");
-  console.log(import_chalk2.default.gray("\u25CF clean  ") + import_chalk2.default.yellow("\u25CF uncommitted changes"));
+  console.log(import_chalk2.default.gray("\u25CF clean  ") + import_chalk2.default.yellow("\u25CF uncommitted  ") + import_chalk2.default.red("\u2717 orphaned"));
   console.log("");
 }