@solaqua/gji 0.14.0 → 0.16.0

package/man/man1/gji-back.1

@@ -1,4 +1,4 @@
-.TH GJI\-BACK 1 "August 2026" "gji 0.14.0" "User Commands"
+.TH GJI\-BACK 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-CLEAN 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-COMPLETION 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-CONFIG 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-DOCTOR 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-DONE 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-GO 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-HISTORY 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-INIT 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-LS 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-NEW 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-OPEN 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-PR 1 "October 2026" "gji 0.16.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-root.1

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

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

@@ -1,9 +1,9 @@
-.TH GJI\-RUN\-HOOK 1 "August 2026" "gji 0.14.0" "User Commands"
+.TH GJI\-RUN\-HOOK 1 "October 2026" "gji 0.16.0" "User Commands"
 .SH NAME
-gji\-run\-hook \- run a named hook (after\-create, after\-enter, before\-remove) in the current worktree
+gji\-run\-hook \- run a named hook (after\-branch\-create, after\-create, after\-enter, after\-switch, before\-remove) in the current worktree
 .SH SYNOPSIS
 .B gji run\-hook [options] <hook>
 .SH DESCRIPTION
-run a named hook (after\-create, after\-enter, before\-remove) in the current worktree
+run a named hook (after\-branch\-create, after\-create, after\-enter, after\-switch, before\-remove) in the current worktree
 .SH "SEE ALSO"
 .BR gji (1)

package/man/man1/gji-status.1

@@ -1,4 +1,4 @@
-.TH GJI\-STATUS 1 "August 2026" "gji 0.14.0" "User Commands"
+.TH GJI\-STATUS 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-SYNC\-FILES 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-SYNC 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-TASK 1 "October 2026" "gji 0.16.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.14.0" "User Commands"
+.TH GJI\-UNDO 1 "October 2026" "gji 0.16.0" "User Commands"
 .SH NAME
 gji\-undo \- restore the most recent destructive worktree operation
 .SH SYNOPSIS

package/man/man1/gji.1

@@ -1,4 +1,4 @@
-.TH GJI 1 "August 2026" "gji 0.14.0" "User Commands"
+.TH GJI 1 "October 2026" "gji 0.16.0" "User Commands"
 .SH NAME
 gji \- Context switching without the mess.
 .SH SYNOPSIS
@@ -67,19 +67,11 @@ list active worktrees
 .B clean [options]
 interactively prune linked worktrees
 .TP
-.B remove [options] [branch]
-deprecated: use gji done for one worktree or gji clean for bulk cleanup
-.br
-Alias: \fBrm\fR
-.TP
 .B run\-hook [options] <hook>
-run a named hook (after\-create, after\-enter, before\-remove) in the current worktree
+run a named hook (after\-branch\-create, after\-create, after\-enter, after\-switch, before\-remove) in the current worktree
 .br
 Alias: \fBtrigger\-hook\fR
 .TP
-.B warp [options] [branch]
-deprecated: use gji go (press Tab for all known repos)
-.TP
 .B config [options] [command]
 manage global config defaults
 .SH OPTIONS
@@ -105,7 +97,5 @@ output the version number
 .BR gji\-sync\-files (1),
 .BR gji\-ls (1),
 .BR gji\-clean (1),
-.BR gji\-remove (1),
 .BR gji\-run\-hook (1),
-.BR gji\-warp (1),
 .BR gji\-config (1)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@solaqua/gji",
-  "version": "0.14.0",
-  "description": "Git worktree CLI for fast context switching.",
+  "version": "0.16.0",
+  "description": "Git worktree CLI for switching tasks without disturbing your work.",
   "license": "MIT",
   "author": "sjquant",
   "type": "module",
@@ -65,6 +65,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.15",
     "@j178/prek": "^0.3.13",
+    "@resvg/resvg-js": "^2.6.2",
     "@types/node": "^24.6.0",
     "@vitest/coverage-v8": "3.2.4",
     "esbuild": "^0.27.0",

package/dist/cli/commands/remove.d.ts

@@ -1,21 +0,0 @@
-import type { WorktreeEntry } from "../../domain/worktree/types.js";
-import { type WorktreePromptEntry } from "../../presentation/worktree/picker.js";
-import { type CliRuntime } from "../dependencies.js";
-export interface RemoveCommandOptions {
-    branch?: string;
-    cwd: string;
-    dryRun?: boolean;
-    force?: boolean;
-    json?: boolean;
-    runtime?: CliRuntime<"git" | "config" | "configStore" | "slots" | "hooks" | "repositoryContext" | "repositoryRegistry" | "worktrees" | "worktreeLifecycle" | "worktreeCatalog">;
-    stderr: (chunk: string) => void;
-    stdout: (chunk: string) => void;
-}
-export interface RemoveCommandDependencies {
-    confirmForceDeleteBranch: (branch: string) => Promise<boolean>;
-    confirmForceRemoveWorktree: (worktreePath: string) => Promise<boolean>;
-    confirmRemoval: (worktree: WorktreeEntry) => Promise<boolean>;
-    promptForWorktree: (worktrees: WorktreePromptEntry[]) => Promise<string | null>;
-}
-export declare function createRemoveCommand(dependencies?: Partial<RemoveCommandDependencies>): (options: RemoveCommandOptions) => Promise<number>;
-export declare const runRemoveCommand: (options: RemoveCommandOptions) => Promise<number>;

package/dist/cli/commands/remove.js

@@ -1,189 +0,0 @@
-import { basename } from "node:path";
-import { confirm, isCancel } from "@clack/prompts";
-import { loadLinkedWorktrees } from "../../application/worktree/catalog.js";
-import { writeShellOutput } from "../../presentation/shell/handoff.js";
-import { buildWorktreePromptEntries, promptForSingleWorktree, } from "../../presentation/worktree/picker.js";
-import { defaultConfirmForceDeleteBranch, defaultConfirmForceRemoveWorktree, } from "../../presentation/worktree/prompts.js";
-import { defaultCliDependencies } from "../dependencies.js";
-import { isHeadless } from "../runtime/headless.js";
-import { finalizeUndoOperation, recordUndoOperation } from "./undo.js";
-const REMOVE_OUTPUT_FILE_ENV = "GJI_REMOVE_OUTPUT_FILE";
-export function createRemoveCommand(dependencies = {}) {
-    const promptForWorktree = dependencies.promptForWorktree ?? defaultPromptForWorktree;
-    const confirmRemoval = dependencies.confirmRemoval ?? defaultConfirmRemoval;
-    const confirmForceRemoveWorktree = dependencies.confirmForceRemoveWorktree ??
-        defaultConfirmForceRemoveWorktree;
-    const confirmForceDeleteBranch = dependencies.confirmForceDeleteBranch ?? defaultConfirmForceDeleteBranch;
-    return async function runRemoveCommand(options) {
-        const runtime = options.runtime ?? defaultCliDependencies;
-        const { loadEffectiveConfig } = runtime.config;
-        const { releaseWorktreeSlot } = runtime.slots;
-        const { extractHooks, runHook } = runtime.hooks;
-        const sourceDependencies = {
-            ...runtime.repositoryContext,
-            ...runtime.repositoryRegistry,
-            ...runtime.worktrees,
-        };
-        const { deleteBranch, forceDeleteBranch, forceRemoveWorktree, isBranchUnmergedError, isWorktreeForceRemovalError, removeWorktree, } = runtime.worktreeLifecycle;
-        const { linkedWorktrees, repository } = await loadLinkedWorktrees(options.cwd, sourceDependencies);
-        if (linkedWorktrees.length === 0) {
-            emitError(options, "No linked worktrees to finish");
-            return 1;
-        }
-        if (!options.branch && (options.json || isHeadless())) {
-            const message = "branch argument is required";
-            if (options.json) {
-                emitError(options, message);
-            }
-            else {
-                options.stderr(`gji remove: ${message} in non-interactive mode (GJI_NO_TUI=1)\n`);
-            }
-            return 1;
-        }
-        const selection = options.branch ??
-            (await promptForWorktree(await buildWorktreePromptEntries(linkedWorktrees.map((worktree) => ({
-                repoName: repository.repoName,
-                worktree,
-            })), { catalog: runtime.worktreeCatalog })));
-        if (!selection) {
-            options.stderr("Aborted\n");
-            return 1;
-        }
-        const worktree = linkedWorktrees.find((entry) => entry.branch === selection || entry.path === selection);
-        if (!worktree) {
-            emitError(options, `No linked worktree found for branch: ${selection}`);
-            return 1;
-        }
-        if (!options.dryRun && !options.force && (options.json || isHeadless())) {
-            const message = "--force is required";
-            if (options.json) {
-                emitError(options, message);
-            }
-            else {
-                options.stderr(`gji remove: ${message} in non-interactive mode (GJI_NO_TUI=1)\n`);
-            }
-            return 1;
-        }
-        if (!options.dryRun &&
-            !options.force &&
-            !(await confirmRemoval(worktree))) {
-            options.stderr("Aborted\n");
-            return 1;
-        }
-        if (options.dryRun) {
-            if (options.json) {
-                options.stdout(`${JSON.stringify({ branch: worktree.branch, path: worktree.path, dryRun: true }, null, 2)}\n`);
-            }
-            else {
-                const desc = worktree.branch
-                    ? `branch: ${worktree.branch}`
-                    : "detached";
-                options.stdout(`Would remove worktree at ${worktree.path} (${desc})\n`);
-            }
-            return 0;
-        }
-        const config = await loadEffectiveConfig(repository.repoRoot, undefined, options.stderr);
-        const hooks = extractHooks(config);
-        let journal;
-        try {
-            journal = await recordUndoOperation("remove", repository.repoRoot, [worktree], undefined, runtime);
-        }
-        catch (error) {
-            emitError(options, `could not write undo journal; no worktree was removed: ${toMessage(error)}`);
-            return 1;
-        }
-        if (!journal) {
-            emitError(options, "could not capture undo state; no worktree was removed");
-            return 1;
-        }
-        await runHook(hooks["before-remove"], worktree.path, {
-            branch: worktree.branch ?? undefined,
-            path: worktree.path,
-            repo: basename(repository.repoRoot),
-        }, options.stderr);
-        try {
-            await removeWorktree(repository.repoRoot, worktree.path);
-        }
-        catch (error) {
-            if (!isWorktreeForceRemovalError(error)) {
-                await finalizeUndoOperation(journal, [], undefined, runtime.configStore.GLOBAL_CONFIG_DIRECTORY);
-                throw error;
-            }
-            if (!options.force &&
-                !(await confirmForceRemoveWorktree(worktree.path))) {
-                await finalizeUndoOperation(journal, [], undefined, runtime.configStore.GLOBAL_CONFIG_DIRECTORY);
-                options.stderr("Aborted\n");
-                return 1;
-            }
-            try {
-                await forceRemoveWorktree(repository.repoRoot, worktree.path);
-            }
-            catch (forceError) {
-                await finalizeUndoOperation(journal, [], undefined, runtime.configStore.GLOBAL_CONFIG_DIRECTORY);
-                emitError(options, `Failed to remove worktree at ${worktree.path}: ${toMessage(forceError)}`);
-                return 1;
-            }
-        }
-        await finalizeUndoOperation(journal, [worktree], undefined, runtime.configStore.GLOBAL_CONFIG_DIRECTORY);
-        await releaseWorktreeSlot(worktree.path);
-        if (worktree.branch) {
-            try {
-                await deleteBranch(repository.repoRoot, worktree.branch);
-            }
-            catch (error) {
-                if (!isBranchUnmergedError(error)) {
-                    throw error;
-                }
-                if (options.force ||
-                    (await confirmForceDeleteBranch(worktree.branch))) {
-                    try {
-                        await forceDeleteBranch(repository.repoRoot, worktree.branch);
-                    }
-                    catch (forceError) {
-                        options.stderr(`Failed to delete branch ${worktree.branch}: ${toMessage(forceError)}\n`);
-                    }
-                }
-                else {
-                    options.stderr(`Branch ${worktree.branch} was not deleted (has unmerged commits)\n`);
-                }
-            }
-        }
-        if (options.json) {
-            options.stdout(`${JSON.stringify({ branch: worktree.branch, path: worktree.path, deleted: true }, null, 2)}\n`);
-        }
-        else {
-            options.stderr("undo: gji undo\n");
-            await writeOutput(repository.repoRoot, options.stdout);
-        }
-        return 0;
-    };
-}
-export const runRemoveCommand = createRemoveCommand();
-async function defaultPromptForWorktree(worktrees) {
-    return promptForSingleWorktree("Choose a worktree to finish", worktrees);
-}
-async function defaultConfirmRemoval(worktree) {
-    const choice = await confirm({
-        message: worktree.branch
-            ? `Remove worktree and delete branch ${worktree.branch}?`
-            : `Remove detached worktree ${worktree.path}?`,
-        active: "Yes",
-        inactive: "No",
-        initialValue: true,
-    });
-    return !isCancel(choice) && choice;
-}
-async function writeOutput(repoRoot, stdout) {
-    await writeShellOutput(REMOVE_OUTPUT_FILE_ENV, repoRoot, stdout);
-}
-function emitError(options, message) {
-    if (options.json) {
-        options.stderr(`${JSON.stringify({ error: message }, null, 2)}\n`);
-    }
-    else {
-        options.stderr(`${message}\n`);
-    }
-}
-function toMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/cli/commands/warp.d.ts

@@ -1,28 +0,0 @@
-import { type NavigationRepository } from "../../presentation/terminal/navigation.js";
-import { type QueryWorktreePullRequests } from "../../presentation/worktree/picker.js";
-import { type CliRuntime } from "../dependencies.js";
-export interface WarpCommandOptions {
-    branch?: string;
-    cwd: string;
-    json?: boolean;
-    queryPullRequests?: QueryWorktreePullRequests;
-    runtime?: CliRuntime<"history" | "repositoryContext" | "repositoryRegistry" | "worktrees" | "worktreeCatalog">;
-    stderr: (chunk: string) => void;
-    stdout: (chunk: string) => void;
-}
-export declare function runWarpCommand(options: WarpCommandOptions): Promise<number>;
-export interface WarpTarget {
-    branch: string | null;
-    path: string;
-    repository: NavigationRepository;
-}
-export declare function resolveWarpTarget(options: {
-    branch?: string;
-    commandName?: string;
-    cwd: string;
-    excludeRepoRoot?: string;
-    json?: boolean;
-    queryPullRequests?: QueryWorktreePullRequests;
-    runtime?: CliRuntime<"history" | "repositoryContext" | "repositoryRegistry" | "worktrees" | "worktreeCatalog">;
-    stderr: (chunk: string) => void;
-}): Promise<WarpTarget | null>;

package/dist/cli/commands/warp.js

@@ -1,123 +0,0 @@
-import { listRegisteredWorktreeSources } from "../../application/worktree/sources.js";
-import { resolveWorktreeQuery } from "../../domain/worktree/matching.js";
-import { writeShellOutput } from "../../presentation/shell/handoff.js";
-import { createNavigationRepository, createNavigationTarget, } from "../../presentation/terminal/navigation.js";
-import { buildWorktreePromptEntries, promptForSingleWorktree, } from "../../presentation/worktree/picker.js";
-import { defaultCliDependencies, withPullRequestQueries, } from "../dependencies.js";
-import { isHeadless } from "../runtime/headless.js";
-const WARP_OUTPUT_FILE_ENV = "GJI_WARP_OUTPUT_FILE";
-export async function runWarpCommand(options) {
-    return runWarpNavigate(options);
-}
-async function runWarpNavigate(options) {
-    const runtime = options.runtime ?? defaultCliDependencies;
-    const { recordWorktreeUsage } = runtime.history;
-    if ((isHeadless() || options.json) && !options.branch) {
-        const message = "branch argument is required";
-        if (options.json) {
-            options.stderr(`${JSON.stringify({ error: message }, null, 2)}\n`);
-        }
-        else {
-            options.stderr("gji warp: branch argument is required in non-interactive mode (GJI_NO_TUI=1)\n");
-        }
-        return 1;
-    }
-    const target = await resolveWarpTarget({
-        ...options,
-        commandName: "gji warp",
-        json: options.json,
-        queryPullRequests: options.queryPullRequests,
-        runtime,
-    });
-    if (!target)
-        return 1;
-    if (options.json) {
-        // json callers use the output programmatically; skip history and shell handoff.
-        options.stdout(`${JSON.stringify(createNavigationTarget(target.repository, target.path, target.branch), null, 2)}\n`);
-        return 0;
-    }
-    await recordWorktreeUsage(target.path, target.branch);
-    await writeShellOutput(WARP_OUTPUT_FILE_ENV, target.path, options.stdout);
-    return 0;
-}
-export async function resolveWarpTarget(options) {
-    const cmd = options.commandName ?? "gji";
-    const runtime = options.runtime ?? defaultCliDependencies;
-    const { detectRepository } = runtime.repositoryContext;
-    const { loadRegistry } = runtime.repositoryRegistry;
-    const sourceDependencies = {
-        ...runtime.repositoryContext,
-        ...runtime.repositoryRegistry,
-        ...runtime.worktrees,
-    };
-    const emitError = (message, hint) => {
-        if (options.json) {
-            options.stderr(`${JSON.stringify({ error: message }, null, 2)}\n`);
-        }
-        else {
-            options.stderr(`${cmd}: ${message}\n`);
-            if (hint)
-                options.stderr(hint);
-        }
-    };
-    const registry = await loadRegistry();
-    if (registry.length === 0) {
-        emitError("not in a git repository and no repos registered yet.", "Use any gji command inside a repository to register it.\n");
-        return null;
-    }
-    const registered = await listRegisteredWorktreeSources({
-        cwd: options.cwd,
-        repositoryPort: sourceDependencies,
-    });
-    const skippedRegisteredRepos = registered.skipped.length;
-    const allItems = registered.sources.filter((item) => item.repoRoot !== options.excludeRepoRoot);
-    if (allItems.length === 0) {
-        emitError("no accessible worktrees found in any registered repo.", skippedRegisteredRepos > 0
-            ? "Hint: Run 'gji doctor' to inspect stale repository entries.\n"
-            : undefined);
-        return null;
-    }
-    const promptSources = allItems.map((item) => ({
-        repoRoot: item.repoRoot,
-        repoName: item.repoName,
-        worktree: item.worktree,
-    }));
-    if (options.branch) {
-        const match = resolveWorktreeQuery(promptSources, options.branch);
-        if (!match) {
-            emitError(`no worktree found matching: ${options.branch}`, skippedRegisteredRepos > 0
-                ? "Hint: Run 'gji doctor' to inspect stale repository entries.\n"
-                : undefined);
-            return null;
-        }
-        return {
-            branch: match.worktree.branch,
-            path: match.worktree.path,
-            repository: createNavigationRepository(match.repoName, match.repoRoot ??
-                (await detectRepository(match.worktree.path)).repoRoot),
-        };
-    }
-    const promptEntries = await buildWorktreePromptEntries(promptSources, {
-        metadata: "fast",
-        catalog: withPullRequestQueries(runtime, options.queryPullRequests),
-    });
-    const path = await promptForWarpTarget(promptEntries);
-    if (!path) {
-        options.stderr("Aborted\n");
-        return null;
-    }
-    const chosenSource = promptSources.find((item) => item.worktree.path === path);
-    if (chosenSource === undefined) {
-        emitError("selected worktree is no longer registered");
-        return null;
-    }
-    return {
-        branch: chosenSource.worktree.branch,
-        path,
-        repository: createNavigationRepository(chosenSource.repoName, chosenSource.repoRoot ??
-            (await detectRepository(chosenSource.worktree.path)).repoRoot),
-    };
-}
-async function promptForWarpTarget(items) {
-    return promptForSingleWorktree("Warp to a worktree", items);
-}

package/man/man1/gji-remove.1

@@ -1,19 +0,0 @@
-.TH GJI\-REMOVE 1 "August 2026" "gji 0.14.0" "User Commands"
-.SH NAME
-gji\-remove \- deprecated: use gji done for one worktree or gji clean for bulk cleanup
-.SH SYNOPSIS
-.B gji remove [\fIoptions\fR] [options] [branch]
-.SH DESCRIPTION
-deprecated: use gji done for one worktree or gji clean for bulk cleanup
-.SH OPTIONS
-.TP
-.B \-f, \-\-force
-bypass prompts, force\-remove a dirty worktree, and force\-delete an unmerged branch
-.TP
-.B \-\-dry\-run
-show what would be deleted without removing anything
-.TP
-.B \-\-json
-emit JSON on success or error instead of human\-readable output
-.SH "SEE ALSO"
-.BR gji (1)

package/man/man1/gji-warp.1

@@ -1,16 +0,0 @@
-.TH GJI\-WARP 1 "August 2026" "gji 0.14.0" "User Commands"
-.SH NAME
-gji\-warp \- deprecated: use gji go (press Tab for all known repos)
-.SH SYNOPSIS
-.B gji warp [\fIoptions\fR] [options] [branch]
-.SH DESCRIPTION
-deprecated: use gji go (press Tab for all known repos)
-.SH OPTIONS
-.TP
-.B \-\-print
-print the resolved worktree path without changing directory
-.TP
-.B \-\-json
-emit JSON on success or error instead of human\-readable output
-.SH "SEE ALSO"
-.BR gji (1)