@solaqua/gji 0.10.0 → 0.12.0

package/dist/worktree-picker.js

@@ -2,38 +2,81 @@ import { env, platform, stdin, stdout } from "node:process";
 import { isCancel, Prompt } from "@clack/core";
 import { loadHistory } from "./history.js";
 import { createPullRequestQuery, } from "./pull-requests.js";
+import { readTask } from "./task.js";
+import { middleEllipsize, sanitizeTerminalText, startEllipsize, terminalWidth, } from "./terminal-text.js";
 import { readWorktreeInfos, } from "./worktree-info.js";
 const MAX_PULL_REQUEST_REPOSITORY_QUERY_CONCURRENCY = 4;
+const MAX_TASK_READ_CONCURRENCY = 8;
 export async function buildWorktreePromptEntries(sources, dependencies = {}) {
+    const metadataMode = dependencies.metadata ?? "full";
+    const includeMetadata = metadataMode === "full";
     const pullRequestQuery = createPullRequestQuery();
     const queryPullRequests = dependencies.queryPullRequests ?? pullRequestQuery.listOpenPullRequests;
-    const queryRepositoryPullRequests = dependencies.queryRepositoryPullRequests ??
-        (dependencies.queryPullRequests === undefined
-            ? pullRequestQuery.listOpenPullRequestsForRepository
-            : undefined);
+    const queryRepositoryPullRequests = includeMetadata
+        ? (dependencies.queryRepositoryPullRequests ??
+            (dependencies.queryPullRequests === undefined
+                ? pullRequestQuery.listOpenPullRequestsForRepository
+                : undefined))
+        : undefined;
     const repositoryPullRequests = queryRepositoryPullRequests === undefined
         ? Promise.resolve(null)
         : readRepositoryPullRequests(sources, queryRepositoryPullRequests);
     const [history, infos, pullRequestsByRepository] = await Promise.all([
         loadHistory(),
-        readWorktreeInfos(sources.map((source) => source.worktree)),
+        includeMetadata
+            ? readWorktreeInfos(sources.map((source) => source.worktree))
+            : mapWithConcurrency(sources, MAX_TASK_READ_CONCURRENCY, (source) => createUnhydratedWorktreeInfo(source.worktree)),
         repositoryPullRequests,
     ]);
-    const pullRequests = await Promise.all(sources.map((source) => readSourcePullRequests(source, queryPullRequests, pullRequestsByRepository)));
+    const pullRequests = includeMetadata
+        ? await Promise.all(sources.map((source) => readSourcePullRequests(source, queryPullRequests, pullRequestsByRepository)))
+        : sources.map(() => []);
     const historyByPath = new Map(history.map((entry) => [entry.path, entry]));
     const entries = sources.map((source, index) => buildWorktreePromptEntry(source, infos[index], pullRequests[index], historyByPath.get(source.worktree.path)?.timestamp ?? null, Date.now()));
     return entries
         .sort(comparePromptEntries)
         .map(({ lastActivityTimestamp: _lastActivityTimestamp, ...entry }) => entry);
 }
+async function createUnhydratedWorktreeInfo(worktree) {
+    let task = null;
+    try {
+        task = (await readTask(worktree.path))?.task ?? null;
+    }
+    catch {
+        // Task metadata is optional picker decoration.
+    }
+    return {
+        ...worktree,
+        lastCommitTimestamp: null,
+        slot: null,
+        status: "unknown",
+        task,
+        upstream: { kind: "unknown" },
+    };
+}
 export function resolveWorktreeQuery(sources, query) {
+    return resolveWorktreeQueryMatches(sources, query)[0] ?? null;
+}
+export function resolveWorktreeQueryMatches(sources, query) {
     const normalizedQuery = normalizeQuery(query);
     if (normalizedQuery === null)
-        return null;
+        return [];
     const matches = findWorktreePromptSourceMatches(sources, normalizedQuery);
     if (isAmbiguousRepoOnlyQuery(matches, normalizedQuery))
-        return null;
-    return matches[0]?.source ?? null;
+        return [];
+    const bestScore = matches[0]?.matchScore;
+    return matches
+        .filter((match) => match.matchScore === bestScore)
+        .map((match) => match.source);
+}
+export function resolveExactWorktreeQueryMatches(sources, query) {
+    const normalizedQuery = normalizeQuery(query);
+    if (normalizedQuery === null)
+        return [];
+    return sources.filter((source) => scoreWorktreeMatch({
+        ...source.worktree,
+        repoName: source.repoName,
+    }, normalizedQuery) === 1000);
 }
 function findWorktreePromptSourceMatches(sources, normalizedQuery) {
     return sources
@@ -59,6 +102,7 @@ export async function promptForSingleWorktree(message, worktrees, io = {}) {
         message,
         multiple: false,
         output: io.output,
+        scope: io.scope,
     });
     return typeof choice === "string" ? choice : null;
 }
@@ -116,17 +160,24 @@ function buildSearchableWorktreeEntry(worktree) {
     const metadata = worktree.metadata ?? null;
     const branch = worktree.branch ?? "(detached)";
     return {
-        detail: [worktree.repoName, branch, metadata, worktree.path]
+        detail: [
+            worktree.repoName,
+            branch,
+            metadata,
+            worktree.task == null ? null : sanitizeTerminalText(worktree.task),
+            worktree.path,
+        ]
             .filter((part) => part !== null && part.length > 0)
             .join(" · "),
         label: worktree.label,
         searchText: buildPromptSearchText(worktree),
         value: worktree.path,
         worktree: {
-            branch: formatWorktreeBranchLabel(worktree.branch, worktree.pullRequestNumbers),
+            branch: formatWorktreeBranchLabel(worktree.branch, worktree.pullRequests),
             metadata,
             path: worktree.path,
             repoName: worktree.repoName,
+            task: worktree.task == null ? null : sanitizeTerminalText(worktree.task),
         },
     };
 }
@@ -144,13 +195,18 @@ class SearchablePrompt {
     options;
     output;
     cursor = 0;
+    entries;
     query = "";
     searchActive = false;
     selected = new Set();
+    scope;
+    scopeTogglePending = false;
     prompt;
     constructor(options, input, output) {
         this.options = options;
         this.output = output;
+        this.entries = options.entries;
+        this.scope = options.scope;
         this.cursor = this.firstSelectableIndex();
         const owner = this;
         this.prompt = new WorktreeCorePrompt(this, {
@@ -183,6 +239,10 @@ class SearchablePrompt {
             this.submit(prompt);
             return;
         }
+        if (isScopeToggleKey(character, key)) {
+            void this.toggleScope(prompt);
+            return;
+        }
         if (this.searchActive && this.handleSearchKey(character, key?.name)) {
             this.syncValue();
             renderPrompt(prompt);
@@ -200,6 +260,34 @@ class SearchablePrompt {
         this.syncValue();
         renderPrompt(prompt);
     }
+    async toggleScope(prompt) {
+        const currentScope = this.scope;
+        if (currentScope === undefined || this.scopeTogglePending)
+            return;
+        this.scopeTogglePending = true;
+        renderPrompt(prompt);
+        try {
+            const nextScope = await currentScope.toggle();
+            this.entries = nextScope.entries.map(buildSearchableWorktreeEntry);
+            this.scope = {
+                label: nextScope.label,
+                toggle: currentScope.toggle,
+                toggleLabel: nextScope.toggleLabel,
+            };
+            this.query = "";
+            this.cursor = this.firstSelectableIndex();
+            this.syncValue();
+        }
+        catch (error) {
+            prompt.error =
+                error instanceof Error ? error.message : "Could not load worktrees";
+            prompt.state = "error";
+        }
+        finally {
+            this.scopeTogglePending = false;
+            renderPrompt(prompt);
+        }
+    }
     handleEscapeKey(prompt) {
         if (this.searchActive) {
             this.searchActive = false;
@@ -334,20 +422,40 @@ class SearchablePrompt {
     renderTitle(state, glyphs, colors) {
         const symbol = colors.symbol(promptSymbol(state, glyphs), state);
         const maxTitleLength = Math.max(8, this.columns() - 3);
+        const title = this.scope
+            ? `${this.options.message} · ${this.scope.label}`
+            : this.options.message;
         if (!this.searchActive) {
-            return `${symbol}  ${middleEllipsize(this.options.message, maxTitleLength)}`;
+            return `${symbol}  ${middleEllipsize(title, maxTitleLength)}`;
         }
         const search = ` /${this.query}`;
         const maxSearchLength = Math.min(terminalWidth(search), Math.floor(maxTitleLength / 2));
-        const message = middleEllipsize(this.options.message, Math.max(1, maxTitleLength - maxSearchLength));
+        const message = middleEllipsize(title, Math.max(1, maxTitleLength - maxSearchLength));
         const visibleSearch = middleEllipsize(search, Math.max(1, maxTitleLength - terminalWidth(message)));
         return `${symbol}  ${message}${colors.search(visibleSearch)}`;
     }
     renderSearchHint(colors) {
+        const scopeHint = this.scope
+            ? `${colors.key("tab")} ${colors.hint(this.scope.toggleLabel)}`
+            : null;
+        const separator = colors.hint(" · ");
+        if (this.scopeTogglePending) {
+            return `${colors.hint("loading worktrees")} ${separator}${scopeHint}`;
+        }
         if (this.searchActive) {
-            return `${colors.hint("type to filter")} ${colors.hint("·")} ${colors.key("esc")} ${colors.hint("clears")}`;
+            return [
+                `${colors.hint("type to filter")} ${separator} ${colors.key("esc")} ${colors.hint("clears")}`,
+                scopeHint,
+            ]
+                .filter((hint) => hint !== null)
+                .join(separator);
         }
-        return `${colors.hint("press ")}${colors.key("/")}${colors.hint(" to search")}`;
+        return [
+            `${colors.hint("press ")}${colors.key("/")}${colors.hint(" to search")}`,
+            scopeHint,
+        ]
+            .filter((hint) => hint !== null)
+            .join(separator);
     }
     renderEntries(entries, visibleEntries, glyphs, colors, frame) {
         if (entries.length === 0) {
@@ -399,6 +507,7 @@ class SearchablePrompt {
                 ellipsize: middleEllipsize,
                 max: 18,
                 min: 6,
+                removablePriority: entry.worktree.task === null ? undefined : 1,
                 value: entry.worktree.repoName,
             },
             {
@@ -414,13 +523,25 @@ class SearchablePrompt {
                         ellipsize: middleEllipsize,
                         max: 30,
                         min: 10,
+                        removablePriority: entry.worktree.task === null ? undefined : 0,
                         value: entry.worktree.metadata,
                     },
                 ]),
+            ...(entry.worktree.task === null
+                ? []
+                : [
+                    {
+                        ellipsize: middleEllipsize,
+                        max: 36,
+                        min: 10,
+                        value: entry.worktree.task,
+                    },
+                ]),
             {
                 ellipsize: startEllipsize,
                 max: 36,
                 min: 12,
+                removablePriority: entry.worktree.task === null ? undefined : 2,
                 value: entry.worktree.path,
             },
         ], width);
@@ -460,9 +581,9 @@ class SearchablePrompt {
     visibleEntries() {
         const query = normalizeQuery(this.query);
         if (query === null) {
-            return this.options.entries;
+            return this.entries;
         }
-        return filterSearchablePromptEntries(this.options.entries, query);
+        return filterSearchablePromptEntries(this.entries, query);
     }
     maxItems() {
         const rows = this.output.rows ?? 16;
@@ -505,6 +626,9 @@ function closePrompt(prompt) {
 function onWorktreeKeypress(character, key) {
     this.worktreePrompt.handleKeypress(this, character, key);
 }
+function isScopeToggleKey(character, key) {
+    return key?.name === "tab" || character === "\t";
+}
 function resolvePromptAction(character, key) {
     if ((key?.ctrl && key.name === "c") || character === "\u0003") {
         return "cancel";
@@ -653,13 +777,25 @@ function windowPromptEntries(entries, cursor, maxItems) {
     }
     return window;
 }
+function findPromptPieceToRemove(pieces, fallbackIndex) {
+    let candidate = fallbackIndex;
+    let priority = Infinity;
+    for (let index = 0; index < pieces.length; index += 1) {
+        const piecePriority = pieces[index].removablePriority;
+        if (piecePriority !== undefined && piecePriority < priority) {
+            candidate = index;
+            priority = piecePriority;
+        }
+    }
+    return candidate;
+}
 function fitPromptPieces(pieces, width) {
     const separator = " · ";
     let visiblePieces = pieces.filter((piece) => piece.value.length > 0);
     let available = width - terminalWidth(separator) * Math.max(0, visiblePieces.length - 1);
     while (visiblePieces.length > 1 &&
         available < minimumPieceLength(visiblePieces)) {
-        const removableIndex = visiblePieces.length === 4 ? 2 : visiblePieces.length - 2;
+        const removableIndex = findPromptPieceToRemove(visiblePieces, visiblePieces.length === 4 ? 2 : visiblePieces.length - 2);
         visiblePieces = visiblePieces.filter((_, index) => index !== removableIndex);
         available =
             width - terminalWidth(separator) * Math.max(0, visiblePieces.length - 1);
@@ -727,9 +863,13 @@ function buildPromptSearchText(worktree) {
         worktree.branch ?? "detached",
         worktree.path,
         worktree.label,
+        worktree.task ?? "",
         `${worktree.repoName}/${worktree.branch ?? "detached"}`,
-        ...(worktree.pullRequestNumbers ?? []).map((number) => `#${number}`),
-        ...(worktree.pullRequestUrls ?? []),
+        ...(worktree.pullRequests ?? []).flatMap((pullRequest) => [
+            `#${pullRequest.number}`,
+            pullRequest.title ?? "",
+            pullRequest.url,
+        ]),
     ]
         .join(" ")
         .toLowerCase();
@@ -742,7 +882,7 @@ function buildWorktreePromptEntry(source, info, pullRequests, lastUsedTimestamp,
         : lastWorkedTimestamp !== null
             ? "worked"
             : null;
-    const branch = formatWorktreeBranchLabel(source.worktree.branch, pullRequests.map((pullRequest) => pullRequest.number));
+    const branch = formatWorktreeBranchLabel(source.worktree.branch, pullRequests);
     const badges = buildStatusBadges(info);
     const recency = formatPromptRecency(lastActivityTimestamp, lastActivityType, now);
     const status = badges.length > 0 ? badges.map((badge) => `[${badge}]`).join(" ") : null;
@@ -753,6 +893,9 @@ function buildWorktreePromptEntry(source, info, pullRequests, lastUsedTimestamp,
         middleEllipsize(source.repoName, 22),
         middleEllipsize(branch, 34),
         metadata,
+        info.task === null
+            ? null
+            : middleEllipsize(sanitizeTerminalText(info.task), 36),
         path,
     ]
         .filter((part) => part !== null && part.length > 0)
@@ -763,9 +906,9 @@ function buildWorktreePromptEntry(source, info, pullRequests, lastUsedTimestamp,
         label,
         lastActivityTimestamp,
         metadata,
-        pullRequestNumbers: pullRequests.map((pullRequest) => pullRequest.number),
-        pullRequestUrls: pullRequests.map((pullRequest) => pullRequest.url),
+        pullRequests,
         repoName: source.repoName,
+        task: info.task,
     };
 }
 async function readSourcePullRequests(source, queryPullRequests, pullRequestsByRepository) {
@@ -823,11 +966,18 @@ async function mapWithConcurrency(items, limit, mapper) {
 function sortSourcePullRequests(pullRequests) {
     return [...(pullRequests ?? [])].sort((a, b) => a.number - b.number);
 }
-export function formatWorktreeBranchLabel(branch, pullRequestNumbers = []) {
+export function formatWorktreeBranchLabel(branch, pullRequests = []) {
     const branchLabel = branch ?? "(detached)";
-    if (pullRequestNumbers.length === 0)
+    if (pullRequests.length === 0)
         return branchLabel;
-    return `${branchLabel} (${pullRequestNumbers.map((number) => `#${number}`).join(", ")})`;
+    return `${branchLabel} (${pullRequests
+        .map((pullRequest) => {
+        const title = pullRequest.title
+            ? ` ${middleEllipsize(sanitizeTerminalText(pullRequest.title), 48)}`
+            : "";
+        return `#${pullRequest.number}${title}`;
+    })
+        .join(", ")})`;
 }
 function buildStatusBadges(info) {
     const badges = [];
@@ -931,72 +1081,3 @@ function scoreWorktreeMatch(entry, query) {
     }
     return buildSearchText(entry.repoName, entry).includes(query) ? 1 : null;
 }
-function middleEllipsize(value, maxLength) {
-    if (terminalWidth(value) <= maxLength) {
-        return value;
-    }
-    if (maxLength <= 1) {
-        return "…";
-    }
-    const keep = maxLength - 1;
-    const start = takeTerminalColumns(value, Math.ceil(keep / 2), "start");
-    const end = takeTerminalColumns(value, Math.floor(keep / 2), "end");
-    return `${start}…${end}`;
-}
-function startEllipsize(value, maxLength) {
-    if (terminalWidth(value) <= maxLength) {
-        return value;
-    }
-    if (maxLength <= 1) {
-        return "…";
-    }
-    return `…${takeTerminalColumns(value, maxLength - 1, "end")}`;
-}
-function takeTerminalColumns(value, maxWidth, direction) {
-    const characters = direction === "start" ? Array.from(value) : Array.from(value).reverse();
-    const kept = [];
-    let width = 0;
-    for (const character of characters) {
-        const characterWidth = terminalWidth(character);
-        if (width + characterWidth > maxWidth)
-            break;
-        kept.push(character);
-        width += characterWidth;
-    }
-    return direction === "start" ? kept.join("") : kept.reverse().join("");
-}
-function terminalWidth(value) {
-    let width = 0;
-    for (const character of Array.from(value)) {
-        width += characterTerminalWidth(character);
-    }
-    return width;
-}
-function characterTerminalWidth(character) {
-    const codePoint = character.codePointAt(0);
-    if (codePoint === undefined)
-        return 0;
-    if (isZeroWidthCodePoint(codePoint) || /\p{Mark}/u.test(character)) {
-        return 0;
-    }
-    return isWideCodePoint(codePoint) ? 2 : 1;
-}
-function isZeroWidthCodePoint(codePoint) {
-    return (codePoint === 0 ||
-        codePoint === 0x200d ||
-        (codePoint >= 0xfe00 && codePoint <= 0xfe0f));
-}
-function isWideCodePoint(codePoint) {
-    return ((codePoint >= 0x1100 && codePoint <= 0x115f) ||
-        codePoint === 0x2329 ||
-        codePoint === 0x232a ||
-        (codePoint >= 0x2e80 && codePoint <= 0xa4cf) ||
-        (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
-        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
-        (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
-        (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
-        (codePoint >= 0xff00 && codePoint <= 0xff60) ||
-        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
-        (codePoint >= 0x1f300 && codePoint <= 0x1faff) ||
-        (codePoint >= 0x20000 && codePoint <= 0x3fffd));
-}

package/dist/worktree-prompts.js

@@ -4,7 +4,7 @@ export async function defaultConfirmForceRemoveWorktree(worktreePath) {
         active: "Yes",
         inactive: "No",
         initialValue: false,
-        message: `Worktree at ${worktreePath} has untracked or modified files. Force remove?`,
+        message: `Worktree at ${worktreePath} contains files or initialized submodules that cannot be undone. Force remove?`,
     });
     return !isCancel(choice) && choice;
 }

package/dist/worktree-source.d.ts

@@ -0,0 +1,6 @@
+import type { WorktreeEntry } from "./repo.js";
+export interface WorktreeSource {
+    repoRoot?: string;
+    repoName: string;
+    worktree: WorktreeEntry;
+}

package/dist/worktree-source.js

@@ -0,0 +1 @@
+export {};

package/dist/worktree-sources.d.ts

@@ -0,0 +1,4 @@
+import { type RepoRegistryEntry } from "./repo-registry.js";
+import type { WorktreeSource } from "./worktree-source.js";
+export declare function listRegisteredWorktreeSources(cwd: string, onSkipped?: (entry: RepoRegistryEntry) => void): Promise<WorktreeSource[]>;
+export declare function listDiscoverableWorktreeSources(cwd: string, onSkipped?: (entry: RepoRegistryEntry) => void): Promise<WorktreeSource[]>;

package/dist/worktree-sources.js

@@ -0,0 +1,77 @@
+import { detectRepository, listWorktrees } from "./repo.js";
+import { loadRegistry } from "./repo-registry.js";
+const MAX_REPOSITORY_DISCOVERY_CONCURRENCY = 4;
+export async function listRegisteredWorktreeSources(cwd, onSkipped) {
+    const registry = await loadRegistry();
+    const currentRoot = await detectRepository(cwd)
+        .then((repository) => repository.currentRoot)
+        .catch(() => null);
+    const results = await mapWithConcurrency(registry, MAX_REPOSITORY_DISCOVERY_CONCURRENCY, async (entry) => {
+        try {
+            const worktrees = await listWorktrees(entry.path);
+            return { entry, worktrees };
+        }
+        catch {
+            onSkipped?.(entry);
+            return null;
+        }
+    });
+    const allItems = [];
+    for (const result of results) {
+        if (result === null)
+            continue;
+        const { entry, worktrees } = result;
+        for (const worktree of worktrees) {
+            allItems.push({
+                repoRoot: entry.path,
+                repoName: entry.name,
+                worktree: {
+                    ...worktree,
+                    isCurrent: currentRoot !== null && worktree.path === currentRoot,
+                },
+            });
+        }
+    }
+    return allItems;
+}
+export async function listDiscoverableWorktreeSources(cwd, onSkipped) {
+    const currentRepository = await detectRepository(cwd).catch(() => null);
+    const registeredSources = await listRegisteredWorktreeSources(cwd, onSkipped);
+    if (currentRepository === null)
+        return dedupeSources(registeredSources);
+    let currentSources = [];
+    try {
+        currentSources = (await listWorktrees(cwd)).map((worktree) => ({
+            repoName: currentRepository.repoName,
+            repoRoot: currentRepository.repoRoot,
+            worktree,
+        }));
+    }
+    catch {
+        // Registered repositories remain discoverable when the current checkout is transiently unavailable.
+    }
+    return dedupeSources([...currentSources, ...registeredSources]);
+}
+async function mapWithConcurrency(items, limit, mapper) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    async function readNext() {
+        for (;;) {
+            const index = nextIndex++;
+            if (index >= items.length)
+                return;
+            results[index] = await mapper(items[index]);
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => readNext()));
+    return results;
+}
+function dedupeSources(sources) {
+    const seen = new Set();
+    return sources.filter((source) => {
+        if (seen.has(source.worktree.path))
+            return false;
+        seen.add(source.worktree.path);
+        return true;
+    });
+}

package/man/man1/gji-back.1

@@ -1,4 +1,4 @@
-.TH GJI\-BACK 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-BACK 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-CLEAN 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
 gji\-clean \- interactively prune linked worktrees
 .SH SYNOPSIS

package/man/man1/gji-completion.1

@@ -1,4 +1,4 @@
-.TH GJI\-COMPLETION 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-COMPLETION 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-CONFIG 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-DOCTOR 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
 gji\-doctor \- check gji installation and configuration health
 .SH SYNOPSIS

package/man/man1/gji-done.1

@@ -0,0 +1,19 @@
+.TH GJI\-DONE 1 "July 2026" "gji 0.12.0" "User Commands"
+.SH NAME
+gji\-done \- finish the current linked worktree and return safely
+.SH SYNOPSIS
+.B gji done [\fIoptions\fR] [options] [branch]
+.SH DESCRIPTION
+finish the current linked worktree and return safely
+.SH OPTIONS
+.TP
+.B \-\-force
+remove dirty or unmerged worktrees without prompting
+.TP
+.B \-\-keep\-branch
+remove the worktree but preserve its branch
+.TP
+.B \-\-json
+emit JSON on success or error instead of human\-readable output
+.SH "SEE ALSO"
+.BR gji (1)

package/man/man1/gji-go.1

@@ -1,13 +1,22 @@
-.TH GJI\-GO 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-GO 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
-gji\-go \- print or select a worktree path
+gji\-go \- resolve and jump to a worktree path
 .SH SYNOPSIS
 .B gji go [\fIoptions\fR] [options] [branch]
 .SH DESCRIPTION
-print or select a worktree path
+resolve and jump to a worktree path
 .SH OPTIONS
 .TP
+.B \-\-root
+navigate to the main repository root
+.TP
 .B \-\-print
 print the resolved worktree path explicitly
+.TP
+.B \-\-quiet
+suppress the context card
+.TP
+.B \-\-json
+emit JSON for an existing worktree destination
 .SH "SEE ALSO"
 .BR gji (1)

package/man/man1/gji-history.1

@@ -1,4 +1,4 @@
-.TH GJI\-HISTORY 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-HISTORY 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-INIT 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-LS 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
 gji\-ls \- list active worktrees
 .SH SYNOPSIS