@hyperdrive.bot/gut 0.1.13 → 0.1.14

package/README.md

@@ -18,7 +18,7 @@ $ npm install -g @hyperdrive.bot/gut
 $ gut COMMAND
 running command...
 $ gut (--version)
-@hyperdrive.bot/gut/0.1.13 linux-x64 node-v22.22.1
+@hyperdrive.bot/gut/0.1.14-alpha.0 linux-x64 node-v22.22.2
 $ gut --help [COMMAND]
 USAGE
   $ gut COMMAND
@@ -290,13 +290,21 @@ Show current focus context with entity details
 
 ```
 USAGE
-  $ gut context
+  $ gut context [--all] [--json]
+
+FLAGS
+  --all   Include all registered entities, not just focused ones (implies --json or adds to text output)
+  --json  Emit structured JSON for programmatic consumption (includes per-entity branch + hasUncommitted)
 
 DESCRIPTION
   Show current focus context with entity details
 
 EXAMPLES
   $ gut context
+
+  $ gut context --json
+
+  $ gut context --json --all
 ```
 
 ## `gut contexts`
@@ -1180,15 +1188,18 @@ Create mirrored worktrees for super-repo and focused entities
 
 ```
 USAGE
-  $ gut worktree create NAME [--base-dir <value>] [--from <value>] [--install]
+  $ gut worktree create NAME [--base-dir <value>] [--entity <value>...] [--from <value>] [--install]
 
 ARGUMENTS
   NAME  Branch name for the worktree
 
 FLAGS
-  --base-dir=<value>  [default: /tmp/gut-worktrees] Root directory for worktrees
-  --from=<value>      Base branch to create from (defaults to current branch)
-  --install           Run pnpm install after creation
+  --base-dir=<value>   [default: /root/.local/share/gut/worktrees] Root directory for worktrees (default:
+                       ~/.local/share/gut/worktrees, override via GUT_WORKTREE_DIR env var; explicit --base-dir wins)
+  --entity=<value>...  Entity to include, optionally pinned to a branch via "name:branch". Repeatable. Overrides current
+                       focus when provided.
+  --from=<value>       Base branch to create from (defaults to current branch)
+  --install            Run pnpm install after creation
 
 DESCRIPTION
   Create mirrored worktrees for super-repo and focused entities
@@ -1199,5 +1210,9 @@ EXAMPLES
   $ gut worktree create workflow/deploy-batch --from master --install
 
   $ gut worktree create feature/story-42 --base-dir /home/user/worktrees
+
+  $ gut worktree create seo-lake --entity serverless-api:feature/seo-lake --entity sign
+
+  GUT_WORKTREE_DIR=/tmp/gut-worktrees gut worktree create feature/ci-run
 ```
 <!-- commandsstop -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperdrive.bot/gut",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Git Unified Tooling - Enhanced git with workspace intelligence for entity-based organization",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -93,4 +93,4 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}