@solaqua/gji 0.13.0 → 0.15.0

package/dist/infrastructure/git/refs.js

@@ -64,17 +64,9 @@ async function resolveCachedRemoteDefaultBranch(cwd, remote) {
         return ref.startsWith(prefix) ? ref.slice(prefix.length) : undefined;
     }
     catch {
-        try {
-            const refs = await runGit(cwd, [
-                "for-each-ref",
-                "--format=%(refname:strip=3)",
-                `refs/remotes/${remote}`,
-            ]);
-            return refs.split("\n").find((ref) => ref !== "HEAD");
-        }
-        catch {
-            return undefined;
-        }
+        // A remote branch list does not identify which branch is the default.
+        // Refuse to guess when the symbolic remote HEAD is unavailable.
+        return undefined;
     }
 }
 export async function readBranchLastCommitTimestamp(cwd, branch) {

package/dist/presentation/shell/completion.js

@@ -221,7 +221,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") )
@@ -454,6 +458,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'
 
@@ -612,7 +617,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'

package/dist/presentation/worktree/picker.d.ts

@@ -30,17 +30,20 @@ export interface WorktreePickerIO {
 }
 export interface WorktreePromptScope {
     label: string;
-    toggle: () => Promise<WorktreePromptScopeResult>;
+    toggle: (signal?: AbortSignal) => Promise<WorktreePromptScopeResult>;
     toggleLabel: string;
 }
 export interface WorktreePromptScopeResult {
-    entries: WorktreePromptEntry[];
     label: string;
+    metadata?: WorktreeMetadataMode;
+    sources: WorktreeSource[];
     toggleLabel: string;
 }
-export declare function buildWorktreePromptEntries(sources: WorktreeSource[], dependencies?: BuildWorktreePromptEntriesDependencies): Promise<WorktreePromptEntry[]>;
-export declare function promptForSingleWorktree(message: string, worktrees: WorktreePromptEntry[], io?: WorktreePickerIO & {
+export interface WorktreePickerOptions extends WorktreePickerIO {
+    catalog?: WorktreeCatalogDependencies;
     scope?: WorktreePromptScope;
-}): Promise<string | null>;
-export declare function promptForMultipleWorktrees(message: string, worktrees: WorktreePromptEntry[], io?: WorktreePickerIO): Promise<string[] | null>;
+}
+export declare function buildWorktreePromptEntries(sources: WorktreeSource[], dependencies?: BuildWorktreePromptEntriesDependencies): Promise<WorktreePromptEntry[]>;
+export declare function promptForSingleWorktree(message: string, worktrees: WorktreePromptEntry[], io?: WorktreePickerOptions): Promise<string | null>;
+export declare function promptForMultipleWorktrees(message: string, worktrees: WorktreePromptEntry[], io?: WorktreePickerOptions): Promise<string[] | null>;
 export declare function formatWorktreeBranchLabel(branch: string | null, pullRequests?: PullRequestInfo[]): string;

package/dist/presentation/worktree/picker.js

@@ -33,6 +33,7 @@ export async function promptForSingleWorktree(message, worktrees, io = {}) {
         message,
         multiple: false,
         output: io.output,
+        catalog: io.catalog,
         scope: io.scope,
     });
     return typeof choice === "string" ? choice : null;
@@ -44,6 +45,8 @@ export async function promptForMultipleWorktrees(message, worktrees, io = {}) {
         message,
         multiple: true,
         output: io.output,
+        catalog: io.catalog,
+        scope: io.scope,
     });
     return Array.isArray(choice) ? choice : null;
 }
@@ -121,6 +124,7 @@ class SearchablePrompt {
     scope;
     scopeTogglePending = false;
     promptClosed = false;
+    cancellation = new AbortController();
     prompt;
     constructor(options, input, output) {
         this.options = options;
@@ -189,10 +193,15 @@ class SearchablePrompt {
         this.scopeTogglePending = true;
         renderPrompt(prompt);
         try {
-            const nextScope = await currentScope.toggle();
+            const nextScope = await currentScope.toggle(this.cancellation.signal);
             if (this.promptClosed)
                 return;
-            this.entries = nextScope.entries.map(buildSearchableWorktreeEntry);
+            const nextEntries = await buildWorktreePromptEntries(nextScope.sources, {
+                catalog: this.options.catalog,
+                metadata: nextScope.metadata,
+            });
+            this.entries = nextEntries.map(buildSearchableWorktreeEntry);
+            this.pruneHiddenSelections();
             this.scope = {
                 label: nextScope.label,
                 toggle: currentScope.toggle,
@@ -228,6 +237,7 @@ class SearchablePrompt {
     }
     cancel(prompt) {
         this.promptClosed = true;
+        this.cancellation.abort();
         prompt.state = "cancel";
         renderPrompt(prompt);
         closePrompt(prompt);
@@ -321,6 +331,13 @@ class SearchablePrompt {
         }
         this.selected.add(entry.value);
     }
+    pruneHiddenSelections() {
+        const visibleValues = new Set(this.entries.filter(isSelectableEntry).map((entry) => entry.value));
+        for (const value of this.selected) {
+            if (!visibleValues.has(value))
+                this.selected.delete(value);
+        }
+    }
     render(state, error) {
         const entries = this.visibleEntries();
         const visibleEntries = windowPromptEntries(entries, this.cursor, this.maxItems());

package/man/man1/gji-back.1

@@ -1,4 +1,4 @@
-.TH GJI\-BACK 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-BACK 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-back \- navigate to the previously visited worktree, optionally N steps back
 .SH SYNOPSIS

package/man/man1/gji-clean.1

@@ -1,4 +1,4 @@
-.TH GJI\-CLEAN 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-CLEAN 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-clean \- interactively prune linked worktrees
 .SH SYNOPSIS
@@ -13,6 +13,9 @@ bypass prompts, force\-remove dirty worktrees, and force\-delete unmerged branch
 .B \-\-stale
 only target clean worktrees whose upstream is gone and branch is merged into the default branch
 .TP
+.B \-\-path <pattern>
+only target worktrees under a directory or matching a path glob (repeatable)
+.TP
 .B \-\-dry\-run
 show what would be deleted without removing anything
 .TP

package/man/man1/gji-completion.1

@@ -1,4 +1,4 @@
-.TH GJI\-COMPLETION 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-COMPLETION 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-completion \- print shell completion definitions
 .SH SYNOPSIS

package/man/man1/gji-config.1

@@ -1,4 +1,4 @@
-.TH GJI\-CONFIG 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-CONFIG 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-config \- manage global config defaults
 .SH SYNOPSIS

package/man/man1/gji-doctor.1

@@ -1,4 +1,4 @@
-.TH GJI\-DOCTOR 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-DOCTOR 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-doctor \- check gji installation and configuration health
 .SH SYNOPSIS

package/man/man1/gji-done.1

@@ -1,4 +1,4 @@
-.TH GJI\-DONE 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-DONE 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-done \- finish the current linked worktree and return safely
 .SH SYNOPSIS

package/man/man1/gji-go.1

@@ -1,4 +1,4 @@
-.TH GJI\-GO 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-GO 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-go \- resolve and jump to a worktree path
 .SH SYNOPSIS

package/man/man1/gji-history.1

@@ -1,4 +1,4 @@
-.TH GJI\-HISTORY 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-HISTORY 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-history \- show navigation history
 .SH SYNOPSIS

package/man/man1/gji-init.1

@@ -1,4 +1,4 @@
-.TH GJI\-INIT 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-INIT 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-init \- set up shell integration interactively or print a shell wrapper
 .SH SYNOPSIS

package/man/man1/gji-ls.1

@@ -1,4 +1,4 @@
-.TH GJI\-LS 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-LS 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-ls \- list active worktrees
 .SH SYNOPSIS

package/man/man1/gji-new.1

@@ -1,4 +1,4 @@
-.TH GJI\-NEW 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-NEW 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-new \- create a branch with an optional linked worktree
 .SH SYNOPSIS

package/man/man1/gji-open.1

@@ -1,4 +1,4 @@
-.TH GJI\-OPEN 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-OPEN 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-open \- open the worktree in an editor
 .SH SYNOPSIS

package/man/man1/gji-pr.1

@@ -1,4 +1,4 @@
-.TH GJI\-PR 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-PR 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-pr \- fetch a pull request by number, #number, or URL into a linked worktree
 .SH SYNOPSIS

package/man/man1/gji-remove.1

@@ -1,4 +1,4 @@
-.TH GJI\-REMOVE 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-REMOVE 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-remove \- deprecated: use gji done for one worktree or gji clean for bulk cleanup
 .SH SYNOPSIS

package/man/man1/gji-root.1

@@ -1,4 +1,4 @@
-.TH GJI\-ROOT 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-ROOT 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-root \- print the main repository root path
 .SH SYNOPSIS

package/man/man1/gji-run-hook.1

@@ -1,4 +1,4 @@
-.TH GJI\-RUN\-HOOK 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-RUN\-HOOK 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-run\-hook \- run a named hook (after\-create, after\-enter, before\-remove) in the current worktree
 .SH SYNOPSIS

package/man/man1/gji-status.1

@@ -1,4 +1,4 @@
-.TH GJI\-STATUS 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-STATUS 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-status \- summarize repository and worktree health
 .SH SYNOPSIS

package/man/man1/gji-sync-files.1

@@ -1,4 +1,4 @@
-.TH GJI\-SYNC\-FILES 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-SYNC\-FILES 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-sync\-files \- manage local files copied into new worktrees
 .SH SYNOPSIS

package/man/man1/gji-sync.1

@@ -1,4 +1,4 @@
-.TH GJI\-SYNC 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-SYNC 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-sync \- fetch and update one or all worktrees
 .SH SYNOPSIS

package/man/man1/gji-task.1

@@ -1,4 +1,4 @@
-.TH GJI\-TASK 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-TASK 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-task \- show or update the current worktree task
 .SH SYNOPSIS

package/man/man1/gji-undo.1

@@ -1,4 +1,4 @@
-.TH GJI\-UNDO 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-UNDO 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-undo \- restore the most recent destructive worktree operation
 .SH SYNOPSIS

package/man/man1/gji-warp.1

@@ -1,4 +1,4 @@
-.TH GJI\-WARP 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI\-WARP 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji\-warp \- deprecated: use gji go (press Tab for all known repos)
 .SH SYNOPSIS

package/man/man1/gji.1

@@ -1,4 +1,4 @@
-.TH GJI 1 "August 2026" "gji 0.13.0" "User Commands"
+.TH GJI 1 "October 2026" "gji 0.15.0" "User Commands"
 .SH NAME
 gji \- Context switching without the mess.
 .SH SYNOPSIS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solaqua/gji",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Git worktree CLI for fast context switching.",
   "license": "MIT",
   "author": "sjquant",