@solaqua/gji 0.14.0 → 0.15.0

package/dist/gji-bundle.mjs

@@ -5386,7 +5386,7 @@ var require_minimist = __commonJS({
 var require_rc = __commonJS({
   "node_modules/.pnpm/rc@1.2.8/node_modules/rc/index.js"(exports, module) {
     var cc = require_utils();
-    var join16 = __require("path").join;
+    var join17 = __require("path").join;
     var deepExtend = require_deep_extend();
     var etc = "/etc";
     var win = process.platform === "win32";
@@ -5411,15 +5411,15 @@ var require_rc = __commonJS({
       }
       if (!win)
         [
-          join16(etc, name, "config"),
-          join16(etc, name + "rc")
+          join17(etc, name, "config"),
+          join17(etc, name + "rc")
         ].forEach(addConfigFile);
       if (home)
         [
-          join16(home, ".config", name, "config"),
-          join16(home, ".config", name),
-          join16(home, "." + name, "config"),
-          join16(home, "." + name + "rc")
+          join17(home, ".config", name, "config"),
+          join17(home, ".config", name),
+          join17(home, "." + name, "config"),
+          join17(home, "." + name + "rc")
         ].forEach(addConfigFile);
       addConfigFile(cc.find("." + name + "rc"));
       if (env5.config) addConfigFile(env5.config);
@@ -6757,11 +6757,11 @@ var require_util = __commonJS({
           if (files.includes("node_modules") || files.includes("package.json") || files.includes("package.json5") || files.includes("package.yaml") || files.includes("pnpm-workspace.yaml")) {
             return name2;
           }
-          const dirname14 = path9.dirname(name2);
-          if (dirname14 === name2) {
+          const dirname15 = path9.dirname(name2);
+          if (dirname15 === name2) {
             return original;
           }
-          return find(dirname14, original);
+          return find(dirname15, original);
         } catch (error) {
           if (name2 === original) {
             if (error.code === "ENOENT") {
@@ -9519,7 +9519,7 @@ var retryifyAsync = (fn, options) => {
           throw error;
         const delay2 = Math.round(interval * Math.random());
         if (delay2 > 0) {
-          const delayPromise = new Promise((resolve12) => setTimeout(resolve12, delay2));
+          const delayPromise = new Promise((resolve13) => setTimeout(resolve13, delay2));
           return delayPromise.then(() => attempt.apply(void 0, args));
         } else {
           return attempt.apply(void 0, args);
@@ -9778,14 +9778,14 @@ var Temp = {
     }
   },
   truncate: (filePath) => {
-    const basename13 = path2.basename(filePath);
-    if (basename13.length <= LIMIT_BASENAME_LENGTH)
+    const basename14 = path2.basename(filePath);
+    if (basename14.length <= LIMIT_BASENAME_LENGTH)
       return filePath;
-    const truncable = /^(\.?)(.*?)((?:\.[^.]+)?(?:\.tmp-\d{10}[a-f0-9]{6})?)$/.exec(basename13);
+    const truncable = /^(\.?)(.*?)((?:\.[^.]+)?(?:\.tmp-\d{10}[a-f0-9]{6})?)$/.exec(basename14);
     if (!truncable)
       return filePath;
-    const truncationLength = basename13.length - LIMIT_BASENAME_LENGTH;
-    return `${filePath.slice(0, -basename13.length)}${truncable[1]}${truncable[2].slice(0, -truncationLength)}${truncable[3]}`;
+    const truncationLength = basename14.length - LIMIT_BASENAME_LENGTH;
+    return `${filePath.slice(0, -basename14.length)}${truncable[1]}${truncable[2].slice(0, -truncationLength)}${truncable[3]}`;
   }
 };
 node_default(Temp.purgeSyncAll);
@@ -11085,14 +11085,14 @@ var TimeoutError = class extends Error {
 
 // node_modules/.pnpm/ky@1.14.3/node_modules/ky/distribution/utils/timeout.js
 async function timeout(request, init, abortController, options) {
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const timeoutId = setTimeout(() => {
       if (abortController) {
         abortController.abort();
       }
       reject(new TimeoutError(request));
     }, options.timeout);
-    void options.fetch(request, init).then(resolve12).catch(reject).then(() => {
+    void options.fetch(request, init).then(resolve13).catch(reject).then(() => {
       clearTimeout(timeoutId);
     });
   });
@@ -11100,7 +11100,7 @@ async function timeout(request, init, abortController, options) {
 
 // node_modules/.pnpm/ky@1.14.3/node_modules/ky/distribution/utils/delay.js
 async function delay(ms, { signal }) {
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     if (signal) {
       signal.throwIfAborted();
       signal.addEventListener("abort", abortHandler, { once: true });
@@ -11111,7 +11111,7 @@ async function delay(ms, { signal }) {
     }
     const timeoutId = setTimeout(() => {
       signal?.removeEventListener("abort", abortHandler);
-      resolve12();
+      resolve13();
     }, ms);
   });
 }
@@ -12810,7 +12810,7 @@ function updateNotifier(options) {
 // package.json
 var package_default = {
   name: "@solaqua/gji",
-  version: "0.14.0",
+  version: "0.15.0",
   description: "Git worktree CLI for fast context switching.",
   license: "MIT",
   author: "sjquant",
@@ -13093,7 +13093,7 @@ async function ensureDestinationDirectory(root, path9) {
 // src/infrastructure/process/command-runner.ts
 import { spawn as spawn2 } from "node:child_process";
 var runCommand = async (command, cwd, stderr, stdout3 = (chunk) => process.stdout.write(chunk), options) => {
-  await new Promise((resolve12, reject) => {
+  await new Promise((resolve13, reject) => {
     const shell = options?.shell ?? true;
     const [executable, args] = shell ? [command, []] : splitCommand(command);
     const child = spawn2(executable, args, {
@@ -13112,7 +13112,7 @@ var runCommand = async (command, cwd, stderr, stdout3 = (chunk) => process.stdou
       if (code !== 0) {
         reject(new Error(`exited with code ${code}`));
       } else {
-        resolve12();
+        resolve13();
       }
     });
     child.on("error", reject);
@@ -14019,9 +14019,9 @@ var EDITORS = [
 ];
 async function defaultSpawnEditor(cli, args) {
   const child = spawn3(cli, args, { detached: true, stdio: "ignore" });
-  await new Promise((resolve12, reject) => {
+  await new Promise((resolve13, reject) => {
     child.once("error", reject);
-    child.once("spawn", resolve12);
+    child.once("spawn", resolve13);
   });
   child.unref();
 }
@@ -14863,7 +14863,7 @@ async function runArgvHook(hookCmd, cwd, context, stderr, stdout3) {
     stderr("gji: hook argv command must include a non-empty command\n");
     return;
   }
-  await new Promise((resolve12) => {
+  await new Promise((resolve13) => {
     const child = spawn4(command, args, {
       cwd,
       shell: false,
@@ -14883,18 +14883,18 @@ async function runArgvHook(hookCmd, cwd, context, stderr, stdout3) {
 `
         );
       }
-      resolve12();
+      resolve13();
     });
     child.on("error", (err) => {
       stderr(`gji: hook failed to start: ${err.message}
 `);
-      resolve12();
+      resolve13();
     });
   });
 }
 async function runShellHook(hookCmd, cwd, context, stderr, stdout3) {
   const interpolated = interpolate(hookCmd, context);
-  await new Promise((resolve12) => {
+  await new Promise((resolve13) => {
     const child = spawn4(interpolated, {
       cwd,
       shell: true,
@@ -14912,12 +14912,12 @@ async function runShellHook(hookCmd, cwd, context, stderr, stdout3) {
         stderr(`gji: hook exited with code ${code}: ${interpolated}
 `);
       }
-      resolve12();
+      resolve13();
     });
     child.on("error", (err) => {
       stderr(`gji: hook failed to start: ${err.message}
 `);
-      resolve12();
+      resolve13();
     });
   });
 }
@@ -15082,8 +15082,8 @@ async function removeMissingRegistryEntries(paths, home = homedir4()) {
 async function withRegistryLock(registryPath, operation) {
   const previous = registryLocks.get(registryPath);
   let release;
-  const current = new Promise((resolve12) => {
-    release = resolve12;
+  const current = new Promise((resolve13) => {
+    release = resolve13;
   });
   registryLocks.set(registryPath, current);
   if (previous) await previous;
@@ -15690,6 +15690,10 @@ function formatAge(timestamp) {
   return `${days}d ago`;
 }
 
+// src/cli/commands/clean.ts
+import { realpath as realpath5 } from "node:fs/promises";
+import { basename as basename8, dirname as dirname10, join as join12, resolve as resolve11 } from "node:path";
+
 // node_modules/.pnpm/@clack+core@0.5.0/node_modules/@clack/core/dist/index.mjs
 var import_sisteransi = __toESM(require_src(), 1);
 var import_picocolors = __toESM(require_picocolors(), 1);
@@ -16480,6 +16484,121 @@ function throwIfAborted2(signal) {
   if (signal?.aborted) throw new Error("Operation cancelled");
 }
 
+// src/domain/worktree/path-filter.ts
+function createWorktreePathFilter(patterns) {
+  const matchers = patterns.map(createPathMatcher);
+  if (matchers.length === 0) return () => true;
+  return (worktreePath) => matchers.some((matches) => matches(worktreePath));
+}
+function findGlobIndex(pattern) {
+  for (let index = 0; index < pattern.length; index += 1) {
+    const character = pattern[index];
+    if (character === "\\") index += 1;
+    else if (character === "*" || character === "?") return index;
+  }
+  return -1;
+}
+function escapePathPattern(path9) {
+  return path9.replace(/[\\*?]/g, "\\$&");
+}
+function unescapePathPattern(pattern) {
+  return pattern.replace(/\\(.)/g, "$1");
+}
+function createPathMatcher(pattern) {
+  if (findGlobIndex(pattern) !== -1) {
+    const regExp = globToRegExp(pattern);
+    return (path9) => regExp.test(path9);
+  }
+  const literal = unescapePathPattern(pattern);
+  const prefix = literal === "/" ? "/" : `${literal}/`;
+  return (path9) => path9 === literal || path9.startsWith(prefix);
+}
+function globToRegExp(pattern) {
+  let source = "";
+  for (let index = 0; index < pattern.length; index += 1) {
+    let character = pattern[index];
+    if (character === "*") {
+      if (pattern[index + 1] === "*") {
+        index += 1;
+        if (pattern[index + 1] === "/") {
+          index += 1;
+          source += "(?:.*/)?";
+        } else {
+          source += ".*";
+        }
+      } else {
+        source += "[^/]*";
+      }
+    } else if (character === "?") {
+      source += "[^/]";
+    } else {
+      if (character === "\\" && index + 1 < pattern.length) {
+        index += 1;
+        character = pattern[index];
+      }
+      source += character.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }
+  }
+  return new RegExp(`^${source}$`);
+}
+
+// src/domain/worktree/policy.ts
+import { homedir as homedir5 } from "node:os";
+import { basename as basename7, dirname as dirname8, join as join10 } from "node:path";
+function resolveWorktreePath(repoRoot, branch, basePath) {
+  const segments = branch.split("/").filter(Boolean);
+  if (segments.length === 0) {
+    throw new Error("Branch name must not be empty.");
+  }
+  if (segments.some((segment) => segment === "." || segment === "..")) {
+    throw new Error(
+      `Branch name '${branch}' contains an invalid path segment.`
+    );
+  }
+  const base = basePath ? expandTildeInPath(basePath) : join10(dirname8(repoRoot), "worktrees", basename7(repoRoot));
+  return join10(base, ...segments);
+}
+function validateBranchName(name) {
+  if (name.length === 0) {
+    return "Branch name must not be empty.";
+  }
+  if (/[\x00-\x1f\x7f ~^:?*[\\\s]/.test(name)) {
+    return `Branch name '${name}' contains an invalid character.`;
+  }
+  if (name.startsWith("-")) {
+    return `Branch name '${name}' must not start with a dash.`;
+  }
+  if (name.startsWith("/") || name.endsWith("/") || name.includes("//")) {
+    return `Branch name '${name}' has invalid slash placement.`;
+  }
+  if (name.includes("..")) {
+    return `Branch name '${name}' must not contain '..'.`;
+  }
+  if (name.endsWith(".")) {
+    return `Branch name '${name}' must not end with '.'.`;
+  }
+  if (name.includes("@{")) {
+    return `Branch name '${name}' must not contain '@{'.`;
+  }
+  if (name === "@") {
+    return "Branch name cannot be '@'.";
+  }
+  for (const segment of name.split("/")) {
+    if (segment.startsWith(".")) {
+      return `Branch name '${name}' contains a path component starting with '.'.`;
+    }
+    if (segment.endsWith(".lock")) {
+      return `Branch name '${name}' contains a path component ending with '.lock'.`;
+    }
+  }
+  return null;
+}
+function expandTildeInPath(path9) {
+  if (path9 === "~") return homedir5();
+  if (path9.startsWith("~/")) return join10(homedir5(), path9.slice(2));
+  return path9;
+}
+
 // src/presentation/worktree/picker.ts
 import { env as env4, platform as platform2, stdin, stdout } from "node:process";
 
@@ -17489,21 +17608,21 @@ import {
   unlink as unlink2,
   writeFile as writeFile7
 } from "node:fs/promises";
-import { homedir as homedir5 } from "node:os";
-import { dirname as dirname8, join as join10, resolve as resolve10 } from "node:path";
+import { homedir as homedir6 } from "node:os";
+import { dirname as dirname9, join as join11, resolve as resolve10 } from "node:path";
 var MAX_UNDO_RECORDS = 20;
 var UNDO_LOCK_STALE_AFTER_MS = 6e4;
 var UNDO_LOCK_RETRY_DELAY_MS = 5;
 var UNDO_LOCK_WAIT_TIMEOUT_MS = UNDO_LOCK_STALE_AFTER_MS + UNDO_LOCK_RETRY_DELAY_MS;
 var undoLogQueues = /* @__PURE__ */ new Map();
-function undoLogPath(home = homedir5(), globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
+function undoLogPath(home = homedir6(), globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
   const configured = process.env.GJI_CONFIG_DIR;
-  return join10(
-    configured ? resolve10(configured) : join10(home, globalConfigDirectory),
+  return join11(
+    configured ? resolve10(configured) : join11(home, globalConfigDirectory),
     "undo-log.json"
   );
 }
-async function loadUndoRecords(home = homedir5(), globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
+async function loadUndoRecords(home = homedir6(), globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
   try {
     const parsed = JSON.parse(
       await readFile7(undoLogPath(home, globalConfigDirectory), "utf8")
@@ -17513,7 +17632,7 @@ async function loadUndoRecords(home = homedir5(), globalConfigDirectory = defaul
     return [];
   }
 }
-async function recordUndoOperation(op, repoRoot, worktrees, home = homedir5(), runtime = defaultCliDependencies) {
+async function recordUndoOperation(op, repoRoot, worktrees, home = homedir6(), runtime = defaultCliDependencies) {
   const globalConfigDirectory = runtime.configStore.GLOBAL_CONFIG_DIRECTORY;
   const { isDirtyWorktree: isDirtyWorktree2, runGit: runGit2 } = runtime.git;
   const entries = [];
@@ -17563,7 +17682,7 @@ async function recordUndoOperation(op, repoRoot, worktrees, home = homedir5(), r
     globalConfigDirectory
   );
 }
-async function finalizeUndoOperation(record, removedWorktrees, home = homedir5(), globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
+async function finalizeUndoOperation(record, removedWorktrees, home = homedir6(), globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
   const removedPaths = new Set(
     removedWorktrees.map((worktree) => worktree.path)
   );
@@ -17583,7 +17702,7 @@ async function finalizeUndoOperation(record, removedWorktrees, home = homedir5()
     globalConfigDirectory
   );
 }
-async function restoreUndoRecord(record, home = homedir5(), runtime = defaultCliDependencies) {
+async function restoreUndoRecord(record, home = homedir6(), runtime = defaultCliDependencies) {
   const globalConfigDirectory = runtime.configStore.GLOBAL_CONFIG_DIRECTORY;
   const restored = [];
   const failed = [];
@@ -17628,7 +17747,7 @@ async function runUndoCommand(options) {
     options.stderr(
       "Warning: undo journal is invalid; starting with an empty journal\n"
     );
-  const records = await loadUndoRecords(homedir5(), globalConfigDirectory);
+  const records = await loadUndoRecords(homedir6(), globalConfigDirectory);
   if (options.list) {
     if (options.json) options.stdout(`${JSON.stringify(records, null, 2)}
 `);
@@ -17675,7 +17794,7 @@ async function runUndoCommand(options) {
   }
   if (!record)
     return emitUndoError(options, `undo record not found: ${options.id}`);
-  const result = await restoreUndoRecord(record, homedir5(), runtime);
+  const result = await restoreUndoRecord(record, homedir6(), runtime);
   if (options.json)
     options.stdout(
       `${JSON.stringify({ restored: result.restored.map((entry) => ({ branch: entry.branch, path: entry.path })), failed: result.failed.map((entry) => ({ branch: entry.branch, path: entry.path, error: entry.message })) }, null, 2)}
@@ -17703,7 +17822,7 @@ async function runUndoCommand(options) {
 async function hasMalformedUndoLog(globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
   try {
     const parsed = JSON.parse(
-      await readFile7(undoLogPath(homedir5(), globalConfigDirectory), "utf8")
+      await readFile7(undoLogPath(homedir6(), globalConfigDirectory), "utf8")
     );
     return !Array.isArray(parsed) || parsed.some((entry) => !isUndoRecord(entry));
   } catch (error) {
@@ -17795,7 +17914,7 @@ async function assertCommitExists(repoRoot, headSha, runGit2) {
 }
 async function enqueueUndoLogWrite(home, operation, globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
   const path9 = undoLogPath(home, globalConfigDirectory);
-  await mkdir6(dirname8(path9), { recursive: true });
+  await mkdir6(dirname9(path9), { recursive: true });
   const previous = undoLogQueues.get(path9) ?? Promise.resolve();
   const runLocked = async () => {
     const release = await acquireUndoLogLock(path9);
@@ -17836,7 +17955,7 @@ async function acquireUndoLogLock(path9) {
       const remainingMs = deadline - Date.now();
       if (remainingMs > 0)
         await new Promise(
-          (resolve12) => setTimeout(resolve12, Math.min(UNDO_LOCK_RETRY_DELAY_MS, remainingMs))
+          (resolve13) => setTimeout(resolve13, Math.min(UNDO_LOCK_RETRY_DELAY_MS, remainingMs))
         );
     }
   }
@@ -17844,7 +17963,7 @@ async function acquireUndoLogLock(path9) {
 }
 async function writeUndoRecords(home, records, globalConfigDirectory = defaultCliDependencies.configStore.GLOBAL_CONFIG_DIRECTORY) {
   const path9 = undoLogPath(home, globalConfigDirectory);
-  await mkdir6(dirname8(path9), { recursive: true });
+  await mkdir6(dirname9(path9), { recursive: true });
   const temporaryPath = `${path9}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
   try {
     await writeFile7(temporaryPath, `${JSON.stringify(records, null, 2)}
@@ -17936,7 +18055,28 @@ function createCleanCommand(dependencies = {}) {
       options.cwd,
       sourceDependencies
     );
-    const currentSources = linkedWorktrees.filter((worktree) => worktree.path !== repository.currentRoot).map((worktree) => ({
+    const pathPatterns = await canonicalizePathPatterns(
+      options.cwd,
+      options.paths ?? []
+    );
+    const matchesPathFilter = createWorktreePathFilter(pathPatterns);
+    const searchAllRepositories = pathPatterns.length > 0;
+    let allSourceCount = 0;
+    const emitNoCandidates = (sourceCount) => {
+      if (pathPatterns.length > 0 && sourceCount === 0) {
+        emitError(options, "No linked worktrees match --path");
+        return 1;
+      }
+      if (options.stale) {
+        emitNoStaleCandidates(options);
+        return 0;
+      }
+      emitError(options, "No linked worktrees to clean");
+      return 1;
+    };
+    const currentSources = linkedWorktrees.filter(
+      (worktree) => worktree.path !== repository.currentRoot && matchesPathFilter(worktree.path)
+    ).map((worktree) => ({
       repoName: repository.repoName,
       repoRoot: repository.repoRoot,
       worktree
@@ -17977,8 +18117,9 @@ function createCleanCommand(dependencies = {}) {
         ...currentSources,
         ...registered.sources
       ]).filter(
-        (source) => source.repoRoot !== void 0 && source.worktree.path !== source.repoRoot && source.worktree.path !== repository.currentRoot
+        (source) => source.repoRoot !== void 0 && source.worktree.path !== source.repoRoot && source.worktree.path !== repository.currentRoot && matchesPathFilter(source.worktree.path)
       );
+      allSourceCount = sources.length;
       const otherRepositorySources = sources.filter(
         (source) => source.repoRoot !== repository.repoRoot
       );
@@ -18012,28 +18153,17 @@ function createCleanCommand(dependencies = {}) {
         };
       }
     };
-    if (currentCandidates.length === 0 && interactiveSelection) {
+    if (searchAllRepositories || interactiveSelection && currentCandidates.length === 0) {
       const loadedAllCandidates = await loadAllCandidates();
       if (loadedAllCandidates.length === 0) {
-        if (options.stale) {
-          emitNoStaleCandidates(options);
-          return 0;
-        }
-        emitError(options, "No linked worktrees to clean");
-        return 1;
+        return emitNoCandidates(allSourceCount);
       }
       currentScope = false;
       activeCandidates = loadedAllCandidates;
       scope.label = "all repositories";
       scope.toggleLabel = "current repository";
-    }
-    if (currentCandidates.length === 0 && !interactiveSelection) {
-      if (options.stale) {
-        emitNoStaleCandidates(options);
-        return 0;
-      }
-      emitError(options, "No linked worktrees to clean");
-      return 1;
+    } else if (currentCandidates.length === 0) {
+      return emitNoCandidates(currentSources.length);
     }
     if (!options.dryRun && !options.force && (options.json || isHeadless())) {
       const message = "--force is required";
@@ -18260,6 +18390,31 @@ function createCleanCommand(dependencies = {}) {
   };
 }
 var runCleanCommand = createCleanCommand();
+async function canonicalizePathPatterns(cwd, patterns) {
+  return Promise.all(
+    patterns.map(
+      (pattern) => canonicalizeLiteralPrefix(resolve11(cwd, expandTildeInPath(pattern)))
+    )
+  );
+}
+async function canonicalizeLiteralPrefix(pattern) {
+  const globIndex = findGlobIndex(pattern);
+  let prefix = globIndex === -1 ? pattern : dirname10(`${pattern.slice(0, globIndex)}x`);
+  let suffix = pattern.slice(prefix.length);
+  for (; ; ) {
+    try {
+      const canonicalPrefix = escapePathPattern(
+        await realpath5(unescapePathPattern(prefix))
+      );
+      return `${canonicalPrefix}${suffix}`.replace(/^\/\//, "/");
+    } catch {
+      const parent = dirname10(prefix);
+      if (parent === prefix) return pattern;
+      suffix = join12("/", basename8(prefix), suffix);
+      prefix = parent;
+    }
+  }
+}
 async function resolveCleanupCandidates(options, dependencies) {
   const { sources, stale, stderr, signal } = options;
   const grouped = /* @__PURE__ */ new Map();
@@ -18761,7 +18916,11 @@ _gji_completion() {
       COMPREPLY=( $(compgen -W "--compact --json --help" -- "$cur") )
       ;;
     clean)
-      COMPREPLY=( $(compgen -W "-f --force --stale --dry-run --json --help" -- "$cur") )
+      if [ "\${COMP_WORDS[COMP_CWORD-1]}" = "--path" ]; then
+        COMPREPLY=( $(compgen -d -- "$cur") )
+      else
+        COMPREPLY=( $(compgen -W "-f --force --stale --path --dry-run --json --help" -- "$cur") )
+      fi
       ;;
     remove|rm)
       COMPREPLY=( $(compgen -W "$(__gji_worktree_branches) -f --force --dry-run --json --help" -- "$cur") )
@@ -19004,6 +19163,7 @@ complete -c gji -n '__fish_seen_subcommand_from ls' -l json -d 'print active wor
 
 complete -c gji -n '__fish_seen_subcommand_from clean' -s f -l force -d 'bypass prompts, force-remove dirty worktrees, and force-delete unmerged branches'
 complete -c gji -n '__fish_seen_subcommand_from clean' -l stale -d 'only target clean worktrees whose upstream is gone and branch is merged into the default branch'
+complete -c gji -n '__fish_seen_subcommand_from clean' -l path -r -F -d 'only target worktrees under a directory or matching a path glob (repeatable)'
 complete -c gji -n '__fish_seen_subcommand_from clean' -l dry-run -d 'show what would be deleted without removing anything'
 complete -c gji -n '__fish_seen_subcommand_from clean' -l json -d 'emit JSON on success or error instead of human-readable output'
 
@@ -19164,7 +19324,7 @@ case "\${words[2]}" in
     _arguments '--compact[show only branch and path columns]' '--json[print active worktrees as JSON]'
     ;;
   clean)
-    _arguments '(-f --force)'{-f,--force}'[bypass prompts, force-remove dirty worktrees, and force-delete unmerged branches]' '--stale[only target clean worktrees whose upstream is gone and branch is merged into the default branch]' '--dry-run[show what would be deleted without removing anything]' '--json[emit JSON on success or error instead of human-readable output]'
+    _arguments '(-f --force)'{-f,--force}'[bypass prompts, force-remove dirty worktrees, and force-delete unmerged branches]' '--stale[only target clean worktrees whose upstream is gone and branch is merged into the default branch]' '*--path[only target worktrees under a directory or matching a path glob]:pattern:_files' '--dry-run[show what would be deleted without removing anything]' '--json[emit JSON on success or error instead of human-readable output]'
     ;;
   remove|rm)
     _arguments '(-f --force)'{-f,--force}'[bypass prompts, force-remove a dirty worktree, and force-delete an unmerged branch]' '--dry-run[show what would be deleted without removing anything]' '--json[emit JSON on success or error instead of human-readable output]' '2:branch:->worktrees'
@@ -19301,20 +19461,20 @@ function writeJson(stdout3, value) {
 import { execFile as execFile8 } from "node:child_process";
 import { constants as constants6 } from "node:fs";
 import { access as access6, readFile as readFile8 } from "node:fs/promises";
-import { homedir as homedir6 } from "node:os";
-import { basename as basename7, dirname as dirname9, join as join12 } from "node:path";
+import { homedir as homedir7 } from "node:os";
+import { basename as basename9, dirname as dirname11, join as join14 } from "node:path";
 import { promisify as promisify9 } from "node:util";
 
 // src/presentation/shell/setup.ts
 import { constants as constants5 } from "node:fs";
 import { access as access5 } from "node:fs/promises";
-import { delimiter, join as join11 } from "node:path";
+import { delimiter, join as join13 } from "node:path";
 var SHELL_INTEGRATION_START_MARKER = "# >>> gji init >>>";
 var SHELL_INTEGRATION_END_MARKER = "# <<< gji init <<<";
 var ONBOARDING_SHELL_INTEGRATION_START_MARKER = "# >>> gji shell integration >>>";
 var ONBOARDING_SHELL_INTEGRATION_END_MARKER = "# <<< gji shell integration <<<";
 async function executableExists(command) {
-  const candidates = command.includes("/") ? [command] : (process.env.PATH ?? "").split(delimiter).filter(Boolean).map((directory) => join11(directory, command));
+  const candidates = command.includes("/") ? [command] : (process.env.PATH ?? "").split(delimiter).filter(Boolean).map((directory) => join13(directory, command));
   for (const path9 of candidates) {
     try {
       await access5(path9, constants5.X_OK);
@@ -19327,17 +19487,17 @@ async function executableExists(command) {
 function resolveShellConfigPath(shell, home) {
   switch (shell) {
     case "bash":
-      return join11(home, ".bashrc");
+      return join13(home, ".bashrc");
     case "fish":
-      return join11(home, ".config", "fish", "config.fish");
+      return join13(home, ".config", "fish", "config.fish");
     case "zsh":
-      return join11(home, ".zshrc");
+      return join13(home, ".zshrc");
   }
 }
 function resolveCompletionPath(shell, home) {
   switch (shell) {
     case "bash":
-      return join11(
+      return join13(
         home,
         ".local",
         "share",
@@ -19346,9 +19506,9 @@ function resolveCompletionPath(shell, home) {
         "gji"
       );
     case "fish":
-      return join11(home, ".config", "fish", "completions", "gji.fish");
+      return join13(home, ".config", "fish", "completions", "gji.fish");
     case "zsh":
-      return join11(home, ".zsh", "completions", "_gji");
+      return join13(home, ".zsh", "completions", "_gji");
   }
 }
 function hasShellIntegration(config, shell) {
@@ -19380,7 +19540,7 @@ async function runDoctorCommand(options) {
     }
     return 1;
   }
-  const home = options.home ?? homedir6();
+  const home = options.home ?? homedir7();
   const shell = resolveSupportedShell(
     void 0,
     options.shell ?? process.env.SHELL
@@ -19445,7 +19605,7 @@ async function collectDoctorInspection(cwd, home, shell, runtime) {
     KNOWN_GLOBAL_CONFIG_KEYS2
   );
   const localConfig = repository ? await inspectConfig(
-    join12(repository.repoRoot, CONFIG_FILE_NAME2),
+    join14(repository.repoRoot, CONFIG_FILE_NAME2),
     "local",
     KNOWN_CONFIG_KEYS2
   ) : null;
@@ -19624,7 +19784,7 @@ function resolvePerRepoConfig(repos, repoRoot, home) {
 }
 function expandTilde2(path9, home) {
   if (path9 === "~") return home;
-  if (path9.startsWith("~/")) return join12(home, path9.slice(2));
+  if (path9.startsWith("~/")) return join14(home, path9.slice(2));
   return path9;
 }
 async function checkGitVersion() {
@@ -19751,7 +19911,7 @@ function resolveWorktreeBase(repoRoot, config, home) {
   if (typeof configuredPath === "string" && (configuredPath.startsWith("/") || configuredPath.startsWith("~"))) {
     return expandTilde2(configuredPath, home);
   }
-  return join12(dirname9(repoRoot), "worktrees", basename7(repoRoot));
+  return join14(dirname11(repoRoot), "worktrees", basename9(repoRoot));
 }
 async function findNearestExistingPath(path9) {
   let candidate = path9;
@@ -19760,7 +19920,7 @@ async function findNearestExistingPath(path9) {
       await access6(candidate, constants6.F_OK);
       return candidate;
     } catch {
-      const parent = dirname9(candidate);
+      const parent = dirname11(candidate);
       if (parent === candidate) return null;
       candidate = parent;
     }
@@ -19911,7 +20071,7 @@ function statusSymbol(status) {
 }
 
 // src/cli/commands/done.ts
-import { basename as basename8 } from "node:path";
+import { basename as basename10 } from "node:path";
 var DONE_OUTPUT_FILE_ENV = "GJI_DONE_OUTPUT_FILE";
 async function runDoneCommand(options) {
   const runtime = options.runtime ?? defaultCliDependencies;
@@ -20019,7 +20179,7 @@ async function runDoneCommand(options) {
     {
       branch: target.branch ?? void 0,
       path: target.path,
-      repo: basename8(repository.repoRoot)
+      repo: basename10(repository.repoRoot)
     },
     options.stderr
   );
@@ -20210,7 +20370,7 @@ function toMessage3(error) {
 }
 
 // src/cli/commands/go.ts
-import { basename as basename10 } from "node:path";
+import { basename as basename11 } from "node:path";
 
 // src/application/worktree/context-card.ts
 async function loadContextCardModel(worktreePath, dependencies) {
@@ -20541,64 +20701,7 @@ function formatLastCommit2(info) {
 
 // src/cli/commands/new.ts
 import { access as access8, mkdir as mkdir7 } from "node:fs/promises";
-import { dirname as dirname11, resolve as resolve11 } from "node:path";
-
-// src/domain/worktree/policy.ts
-import { homedir as homedir7 } from "node:os";
-import { basename as basename9, dirname as dirname10, join as join13 } from "node:path";
-function resolveWorktreePath(repoRoot, branch, basePath) {
-  const segments = branch.split("/").filter(Boolean);
-  if (segments.length === 0) {
-    throw new Error("Branch name must not be empty.");
-  }
-  if (segments.some((segment) => segment === "." || segment === "..")) {
-    throw new Error(
-      `Branch name '${branch}' contains an invalid path segment.`
-    );
-  }
-  const base = basePath ? expandTildeInPath(basePath) : join13(dirname10(repoRoot), "worktrees", basename9(repoRoot));
-  return join13(base, ...segments);
-}
-function validateBranchName(name) {
-  if (name.length === 0) {
-    return "Branch name must not be empty.";
-  }
-  if (/[\x00-\x1f\x7f ~^:?*[\\\s]/.test(name)) {
-    return `Branch name '${name}' contains an invalid character.`;
-  }
-  if (name.startsWith("-")) {
-    return `Branch name '${name}' must not start with a dash.`;
-  }
-  if (name.startsWith("/") || name.endsWith("/") || name.includes("//")) {
-    return `Branch name '${name}' has invalid slash placement.`;
-  }
-  if (name.includes("..")) {
-    return `Branch name '${name}' must not contain '..'.`;
-  }
-  if (name.endsWith(".")) {
-    return `Branch name '${name}' must not end with '.'.`;
-  }
-  if (name.includes("@{")) {
-    return `Branch name '${name}' must not contain '@{'.`;
-  }
-  if (name === "@") {
-    return "Branch name cannot be '@'.";
-  }
-  for (const segment of name.split("/")) {
-    if (segment.startsWith(".")) {
-      return `Branch name '${name}' contains a path component starting with '.'.`;
-    }
-    if (segment.endsWith(".lock")) {
-      return `Branch name '${name}' contains a path component ending with '.lock'.`;
-    }
-  }
-  return null;
-}
-function expandTildeInPath(path9) {
-  if (path9 === "~") return homedir7();
-  if (path9.startsWith("~/")) return join13(homedir7(), path9.slice(2));
-  return path9;
-}
+import { dirname as dirname12, resolve as resolve12 } from "node:path";
 
 // src/presentation/bootstrap/output.ts
 function createBootstrapReporter(write, json) {
@@ -20908,7 +21011,7 @@ ${formatDependencyBootstrapPreview(dryRunDependencyBootstrap)}`
       }
       return 0;
     }
-    await mkdir7(dirname11(worktreePath), { recursive: true });
+    await mkdir7(dirname12(worktreePath), { recursive: true });
     const startPoint = options.fromCurrent && !options.detached ? await resolveCurrentWorktreeHead(options.cwd, runtime.git.runGit) : void 0;
     const takeStartPoint = options.take ? await resolveCurrentWorktreeHead(options.cwd, runtime.git.runGit) : void 0;
     const changedTakeFiles = options.take ? await listTakeFiles(options.cwd, runtime.git.runGitRaw) : [];
@@ -21500,7 +21603,7 @@ async function detectInProgressGitState(cwd, runGit2) {
   for (const [marker, name] of markers) {
     try {
       const gitPath = await runGit2(cwd, ["rev-parse", "--git-path", marker]);
-      await access8(resolve11(cwd, gitPath));
+      await access8(resolve12(cwd, gitPath));
       return name;
     } catch {
     }
@@ -21652,7 +21755,7 @@ function emitNewError(options, message, details) {
 
 // src/cli/commands/pr.ts
 import { mkdir as mkdir8 } from "node:fs/promises";
-import { dirname as dirname12 } from "node:path";
+import { dirname as dirname13 } from "node:path";
 var PR_OUTPUT_FILE_ENV = "GJI_PR_OUTPUT_FILE";
 function createPrCommand(dependencies = {}) {
   const prompt = dependencies.promptForPathConflict ?? promptForPathConflict;
@@ -21791,7 +21894,7 @@ ${formatDependencyBootstrapPreview(dryRunDependencyBootstrap)}`
       }
       return 1;
     }
-    await mkdir8(dirname12(worktreePath), { recursive: true });
+    await mkdir8(dirname13(worktreePath), { recursive: true });
     const branchAlreadyExists = await localBranchExists2(
       repository.repoRoot,
       branchName,
@@ -22200,7 +22303,7 @@ async function navigateToExistingWorktree(options, path9, worktree, runtime) {
     {
       branch: worktree?.branch ?? void 0,
       path: path9,
-      repo: basename10(repository.repoRoot),
+      repo: basename11(repository.repoRoot),
       slot: await runtime.slots.getWorktreeSlot(path9)
     },
     options.stderr
@@ -22340,7 +22443,7 @@ async function runHistoryCommand(options) {
 }
 
 // src/cli/commands/hub.ts
-import { basename as basename11 } from "node:path";
+import { basename as basename12 } from "node:path";
 import { stdin as stdin2, stdout as stdout2 } from "node:process";
 var MAX_HUB_REPOSITORY_CONCURRENCY = 4;
 async function buildHubData(cwd, dependencies = {}, runtime = defaultCliDependencies) {
@@ -22365,7 +22468,7 @@ async function buildHubData(cwd, dependencies = {}, runtime = defaultCliDependen
       existing.sources.push(source);
     } else {
       groups.set(repoRoot, {
-        name: source.repoName || basename11(repoRoot),
+        name: source.repoName || basename12(repoRoot),
         sources: [source]
       });
     }
@@ -22616,7 +22719,7 @@ function formatHumanText(value, maxLength) {
 import { constants as constants8 } from "node:fs";
 import { access as access9, mkdir as mkdir9, readFile as readFile9, writeFile as writeFile8 } from "node:fs/promises";
 import { homedir as homedir8 } from "node:os";
-import { dirname as dirname13 } from "node:path";
+import { dirname as dirname14 } from "node:path";
 var ZSH_COMPLETION_PATH_LINE = "fpath=(~/.zsh/completions $fpath)";
 var SHELL_WRAPPED_COMMANDS = [
   {
@@ -22741,7 +22844,7 @@ async function runDefaultOnboarding(context, runtime) {
   const installCompletion = await promptForCompletion(shell, completionPath);
   if (installCompletion === null) return abortDefaultOnboarding();
   if (installCompletion) {
-    await mkdir9(dirname13(completionPath), { recursive: true });
+    await mkdir9(dirname14(completionPath), { recursive: true });
     await writeFile8(completionPath, renderShellCompletion(shell), "utf8");
   }
   if (shell === "zsh" && (completionAlreadyInstalled || installCompletion)) {
@@ -22847,7 +22950,7 @@ async function applyOnboardingResult(result, home, runtime) {
     runtime
   );
   if (result.installCompletion) {
-    await mkdir9(dirname13(completionPath), { recursive: true });
+    await mkdir9(dirname14(completionPath), { recursive: true });
     await writeFile8(
       completionPath,
       renderShellCompletion(result.shell),
@@ -22867,7 +22970,7 @@ async function applyOnboardingResult(result, home, runtime) {
 }
 async function installOnboardingShellIntegration(shell, home) {
   const rcPath = resolveShellConfigPath(shell, home);
-  await mkdir9(dirname13(rcPath), { recursive: true });
+  await mkdir9(dirname14(rcPath), { recursive: true });
   const current = await readExistingConfig(rcPath);
   if (shell === "fish") {
     await writeFile8(
@@ -22955,7 +23058,7 @@ async function runLegacyInitCommand(options, runtime) {
     return 0;
   }
   const rcPath = resolveShellConfigPath(shell, home);
-  await mkdir9(dirname13(rcPath), { recursive: true });
+  await mkdir9(dirname14(rcPath), { recursive: true });
   const current = await readExistingConfig(rcPath);
   const next = upsertShellIntegration(current, script);
   await writeFile8(rcPath, next, "utf8");
@@ -23313,7 +23416,7 @@ function sortWorktrees(worktrees) {
 // src/cli/commands/open.ts
 import { execFile as execFile9 } from "node:child_process";
 import { access as access10, writeFile as writeFile9 } from "node:fs/promises";
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 import { promisify as promisify10 } from "node:util";
 var execFileAsync9 = promisify10(execFile9);
 function createOpenCommand(dependencies = {}) {
@@ -23492,7 +23595,7 @@ async function defaultPromptForEditor(editors) {
   return choice;
 }
 async function ensureWorkspaceFile(worktreePath, repoName) {
-  const workspacePath = join14(worktreePath, `${repoName}.code-workspace`);
+  const workspacePath = join15(worktreePath, `${repoName}.code-workspace`);
   try {
     await access10(workspacePath);
     return workspacePath;
@@ -23879,7 +23982,7 @@ function formatError(error) {
 }
 
 // src/cli/commands/remove.ts
-import { basename as basename12 } from "node:path";
+import { basename as basename13 } from "node:path";
 var REMOVE_OUTPUT_FILE_ENV = "GJI_REMOVE_OUTPUT_FILE";
 function createRemoveCommand(dependencies = {}) {
   const promptForWorktree2 = dependencies.promptForWorktree ?? defaultPromptForWorktree3;
@@ -24008,7 +24111,7 @@ function createRemoveCommand(dependencies = {}) {
       {
         branch: worktree.branch ?? void 0,
         path: worktree.path,
-        repo: basename12(repository.repoRoot)
+        repo: basename13(repository.repoRoot)
       },
       options.stderr
     );
@@ -24447,7 +24550,7 @@ function resolveConfiguredString2(value) {
 
 // src/cli/commands/sync-files-command.ts
 import { homedir as homedir9 } from "node:os";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 async function runSyncFilesCommand(options) {
   const runtime = options.runtime ?? defaultCliDependencies;
   const { validateSyncFilePattern: validateSyncFilePattern2 } = runtime.filesystem;
@@ -24601,7 +24704,7 @@ function writeError(options, message) {
 }
 function expandTilde3(value, home) {
   if (value === "~") return home;
-  if (value.startsWith("~/")) return join15(home, value.slice(2));
+  if (value.startsWith("~/")) return join16(home, value.slice(2));
   return value;
 }
 
@@ -24969,6 +25072,10 @@ function registerCommands(program2) {
   ).option(
     "--stale",
     "only target clean worktrees whose upstream is gone and branch is merged into the default branch"
+  ).option(
+    "--path <pattern>",
+    "only target worktrees under a directory or matching a path glob (repeatable)",
+    collectOption
   ).option("--dry-run", "show what would be deleted without removing anything").option(
     "--json",
     "emit JSON on success or error instead of human-readable output"
@@ -25336,6 +25443,7 @@ function attachCommandActions(program2, options) {
         dryRun: commandOptions2.dryRun,
         force: commandOptions2.force,
         json: commandOptions2.json,
+        paths: commandOptions2.path,
         stale: commandOptions2.stale,
         runtime: options.dependencies,
         stderr: options.stderr,
@@ -25463,6 +25571,9 @@ function requireCommand(parent, name) {
   }
   return command;
 }
+function collectOption(value, previous = []) {
+  return [...previous, value];
+}
 function notImplemented(commandName) {
   return () => {
     throw new Error(`'${commandName}' is not implemented yet.`);