@solaqua/gji 0.10.0 → 0.12.0

package/man/man1/gji-new.1

@@ -1,10 +1,16 @@
-.TH GJI\-NEW 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-NEW 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
-gji\-new \- create a new branch or detached linked worktree
+gji\-new \- create a new branch or detached linked worktree and CoW\-bootstrap configured directories
 .SH SYNOPSIS
 .B gji new [\fIoptions\fR] [options] [branch]
 .SH DESCRIPTION
-create a new branch or detached linked worktree
+create a new branch or detached linked worktree and CoW\-bootstrap configured directories
+.SH BOOTSTRAP_POLICY
+dependencyBuildCommand overrides Cargo's default cargo check. Supported lockfiles trigger an interactive dependencyBootstrap choice when no explicit policy exists; the choice is saved according to installSaveTarget. JSON and headless modes never prompt and keep off. npm is always install\-only, and sync\-file failures stop dependency repair, install prompts, and after\-create hooks. JSON bootstrap events include structured reasons, and failed setup reports the created worktree path.
+
+.SH BOOTSTRAP
+syncDirs performs generic copy\-on\-write directory seeding before syncFiles. It never falls back to ordinary copying and never suppresses installation or repair. Set dependencyBootstrap to off, cow\-then\-repair, or install\-only to enable deterministic project\-local package\-manager or build\-cache repair. The lifecycle is CoW seed, syncFiles, repair or install, then after\-create. CoW failures fall back to repair from an empty target; partial clones are removed and existing targets are never deleted. Bundler uses vendor/bundle only; global gem stores and caches are not cloned.
+
 .SH OPTIONS
 .TP
 .B \-f, \-\-force
@@ -16,6 +22,18 @@ create a detached worktree without a branch
 .B \-\-from\-current
 base the new branch on the current worktree instead of the main worktree (cannot be combined with \-\-detached)
 .TP
+.B \-\-no\-fetch
+skip refreshing the remote default branch before creating the new branch
+.TP
+.B \-\-take
+move current uncommitted changes into the new worktree
+.TP
+.B \-\-task <description>
+record the purpose of the new worktree
+.TP
+.B \-\-copy
+copy current uncommitted changes instead of moving them (requires \-\-take)
+.TP
 .B \-\-open
 open the new worktree in an editor after creation
 .TP

package/man/man1/gji-open.1

@@ -1,4 +1,4 @@
-.TH GJI\-OPEN 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-OPEN 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
 gji\-open \- open the worktree in an editor
 .SH SYNOPSIS

package/man/man1/gji-pr.1

@@ -1,10 +1,16 @@
-.TH GJI\-PR 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-PR 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
 gji\-pr \- fetch a pull request by number, #number, or URL into a linked worktree
 .SH SYNOPSIS
 .B gji pr [\fIoptions\fR] [options] <ref>
 .SH DESCRIPTION
 fetch a pull request by number, #number, or URL into a linked worktree
+.SH BOOTSTRAP_POLICY
+dependencyBuildCommand overrides Cargo's default cargo check. Supported lockfiles trigger an interactive dependencyBootstrap choice when no explicit policy exists; the choice is saved according to installSaveTarget. JSON and headless modes never prompt and keep off. npm is always install\-only, and sync\-file failures stop dependency repair, install prompts, and after\-create hooks. JSON bootstrap events include structured reasons, and failed setup reports the created worktree path.
+
+.SH BOOTSTRAP
+syncDirs performs generic copy\-on\-write directory seeding before syncFiles. It never falls back to ordinary copying and never suppresses installation or repair. Set dependencyBootstrap to off, cow\-then\-repair, or install\-only to enable deterministic project\-local package\-manager or build\-cache repair. The lifecycle is CoW seed, syncFiles, repair or install, then after\-create. CoW failures fall back to repair from an empty target; partial clones are removed and existing targets are never deleted. Bundler uses vendor/bundle only; global gem stores and caches are not cloned.
+
 .SH OPTIONS
 .TP
 .B \-\-dry\-run

package/man/man1/gji-remove.1

@@ -1,10 +1,10 @@
-.TH GJI\-REMOVE 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-REMOVE 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
-gji\-remove \- remove a linked worktree and delete its branch when present
+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
-remove a linked worktree and delete its branch when present
+deprecated: use gji done for one worktree or gji clean for bulk cleanup
 .SH OPTIONS
 .TP
 .B \-f, \-\-force

package/man/man1/gji-root.1

@@ -1,4 +1,4 @@
-.TH GJI\-ROOT 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-ROOT 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-RUN\-HOOK 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-STATUS 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-SYNC\-FILES 1 "July 2026" "gji 0.12.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 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-SYNC 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
 gji\-sync \- fetch and update one or all worktrees
 .SH SYNOPSIS

package/man/man1/gji-task.1

@@ -0,0 +1,16 @@
+.TH GJI\-TASK 1 "July 2026" "gji 0.12.0" "User Commands"
+.SH NAME
+gji\-task \- show or update the current worktree task
+.SH SYNOPSIS
+.B gji task [\fIoptions\fR] [options] [task]
+.SH DESCRIPTION
+show or update the current worktree task
+.SH OPTIONS
+.TP
+.B \-\-clear
+clear the current worktree task
+.TP
+.B \-\-json
+emit task metadata as JSON
+.SH "SEE ALSO"
+.BR gji (1)

package/man/man1/gji-undo.1

@@ -0,0 +1,16 @@
+.TH GJI\-UNDO 1 "July 2026" "gji 0.12.0" "User Commands"
+.SH NAME
+gji\-undo \- restore the most recent destructive worktree operation
+.SH SYNOPSIS
+.B gji undo [\fIoptions\fR] [options] [id]
+.SH DESCRIPTION
+restore the most recent destructive worktree operation
+.SH OPTIONS
+.TP
+.B \-\-list
+list recoverable operations
+.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,15 +1,12 @@
-.TH GJI\-WARP 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI\-WARP 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
-gji\-warp \- jump to any worktree across all known repos
+gji\-warp \- deprecated: use gji go (press Tab for all known repos)
 .SH SYNOPSIS
 .B gji warp [\fIoptions\fR] [options] [branch]
 .SH DESCRIPTION
-jump to any worktree across all known repos
+deprecated: use gji go (press Tab for all known repos)
 .SH OPTIONS
 .TP
-.B \-n, \-\-new [branch]
-create a new worktree in a registered repo
-.TP
 .B \-\-print
 print the resolved worktree path without changing directory
 .TP

package/man/man1/gji.1

@@ -1,4 +1,4 @@
-.TH GJI 1 "July 2026" "gji 0.10.0" "User Commands"
+.TH GJI 1 "July 2026" "gji 0.12.0" "User Commands"
 .SH NAME
 gji \- Context switching without the mess.
 .SH SYNOPSIS
@@ -12,7 +12,13 @@ eliminating the need for \fBgit stash\fR when switching contexts.
 .SH COMMANDS
 .TP
 .B new [options] [branch]
-create a new branch or detached linked worktree
+create a new branch or detached linked worktree and CoW\-bootstrap configured directories
+.TP
+.B done [options] [branch]
+finish the current linked worktree and return safely
+.TP
+.B undo [options] [id]
+restore the most recent destructive worktree operation
 .TP
 .B init [options] [shell]
 set up shell integration interactively or print a shell wrapper
@@ -36,7 +42,7 @@ show navigation history
 open the worktree in an editor
 .TP
 .B go [options] [branch]
-print or select a worktree path
+resolve and jump to a worktree path
 .br
 Alias: \fBjump\fR
 .TP
@@ -46,6 +52,9 @@ print the main repository root path
 .B status [options]
 summarize repository and worktree health
 .TP
+.B task [options] [task]
+show or update the current worktree task
+.TP
 .B sync [options]
 fetch and update one or all worktrees
 .TP
@@ -59,7 +68,7 @@ list active worktrees
 interactively prune linked worktrees
 .TP
 .B remove [options] [branch]
-remove a linked worktree and delete its branch when present
+deprecated: use gji done for one worktree or gji clean for bulk cleanup
 .br
 Alias: \fBrm\fR
 .TP
@@ -69,7 +78,7 @@ run a named hook (after\-create, after\-enter, before\-remove) in the current wo
 Alias: \fBtrigger\-hook\fR
 .TP
 .B warp [options] [branch]
-jump to any worktree across all known repos
+deprecated: use gji go (press Tab for all known repos)
 .TP
 .B config [options] [command]
 manage global config defaults
@@ -79,6 +88,8 @@ manage global config defaults
 output the version number
 .SH "SEE ALSO"
 .BR gji\-new (1),
+.BR gji\-done (1),
+.BR gji\-undo (1),
 .BR gji\-init (1),
 .BR gji\-doctor (1),
 .BR gji\-completion (1),
@@ -89,6 +100,7 @@ output the version number
 .BR gji\-go (1),
 .BR gji\-root (1),
 .BR gji\-status (1),
+.BR gji\-task (1),
 .BR gji\-sync (1),
 .BR gji\-sync\-files (1),
 .BR gji\-ls (1),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solaqua/gji",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Git worktree CLI for fast context switching.",
   "license": "MIT",
   "author": "sjquant",
@@ -49,6 +49,7 @@
     "docs:start": "pnpm --dir website start",
     "prepublishOnly": "pnpm test && pnpm build && pnpm generate-man",
     "test": "vitest run --passWithNoTests",
+    "test:coverage": "vitest run --coverage --passWithNoTests",
     "test:watch": "vitest",
     "lint": "biome lint --write .",
     "format": "biome format --write .",
@@ -65,6 +66,7 @@
     "@biomejs/biome": "^2.4.15",
     "@j178/prek": "^0.3.13",
     "@types/node": "^24.6.0",
+    "@vitest/coverage-v8": "3.2.4",
     "esbuild": "^0.27.0",
     "tsx": "^4.22.4",
     "typescript": "^5.9.3",