@hyperdrive.bot/gut 0.1.12 → 0.1.14-alpha.0

package/dist/utils/entity-spec.js

@@ -0,0 +1,29 @@
+export function parseEntitySpecs(specs) {
+    if (!specs || specs.length === 0)
+        return [];
+    const parsed = [];
+    for (const raw of specs) {
+        const trimmed = raw.trim();
+        if (!trimmed)
+            continue;
+        const colonIdx = trimmed.indexOf(':');
+        if (colonIdx === -1) {
+            parsed.push({ name: trimmed });
+            continue;
+        }
+        const name = trimmed.slice(0, colonIdx).trim();
+        const branch = trimmed.slice(colonIdx + 1).trim();
+        if (!name) {
+            throw new Error(`Invalid --entity spec "${raw}": missing entity name before ":"`);
+        }
+        if (branch) {
+            parsed.push({ branch, name });
+        }
+        else {
+            // "name:" is tolerated — same as bare name. Useful if a caller builds
+            // specs programmatically and omits the branch for some entities.
+            parsed.push({ name });
+        }
+    }
+    return parsed;
+}

package/oclif.manifest.json

@@ -301,9 +301,24 @@
       "args": {},
       "description": "Show current focus context with entity details",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --json",
+        "<%= config.bin %> <%= command.id %> --json --all"
       ],
-      "flags": {},
+      "flags": {
+        "all": {
+          "description": "Include all registered entities, not just focused ones (implies --json or adds to text output)",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Emit structured JSON for programmatic consumption (includes per-entity branch + hasUncommitted)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "context",
@@ -2186,17 +2201,26 @@
       "examples": [
         "<%= config.bin %> worktree create workflow/deploy-batch",
         "<%= config.bin %> worktree create workflow/deploy-batch --from master --install",
-        "<%= config.bin %> worktree create feature/story-42 --base-dir /home/user/worktrees"
+        "<%= config.bin %> worktree create feature/story-42 --base-dir /home/user/worktrees",
+        "<%= config.bin %> worktree create seo-lake --entity serverless-api:feature/seo-lake --entity sign",
+        "GUT_WORKTREE_DIR=/tmp/gut-worktrees <%= config.bin %> worktree create feature/ci-run"
       ],
       "flags": {
         "base-dir": {
-          "description": "Root directory for worktrees",
+          "description": "Root directory for worktrees (default: ~/.local/share/gut/worktrees, override via GUT_WORKTREE_DIR env var; explicit --base-dir wins)",
           "name": "base-dir",
-          "default": "/tmp/gut-worktrees",
+          "default": "/root/.local/share/gut/worktrees",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "entity": {
+          "description": "Entity to include, optionally pinned to a branch via \"name:branch\". Repeatable. Overrides current focus when provided.",
+          "name": "entity",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "from": {
           "description": "Base branch to create from (defaults to current branch)",
           "name": "from",
@@ -2225,7 +2249,170 @@
         "worktree",
         "create.js"
       ]
+    },
+    "worktree:gc": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove worktrees older than a given duration (garbage collection)",
+      "examples": [
+        "<%= config.bin %> worktree gc --older-than 7d",
+        "<%= config.bin %> worktree gc --older-than 14d --force",
+        "<%= config.bin %> worktree gc --older-than 7d --dry-run"
+      ],
+      "flags": {
+        "dry-run": {
+          "char": "n",
+          "description": "List candidates without removing anything",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "char": "f",
+          "description": "Remove even worktrees with uncommitted changes",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "older-than": {
+          "char": "o",
+          "description": "Duration threshold (e.g. '7d', '24h', '30m', '90s')",
+          "name": "older-than",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:gc",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "worktree",
+        "gc.js"
+      ]
+    },
+    "worktree:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all active worktrees with metadata and staleness detection",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:list",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "worktree",
+        "list.js"
+      ]
+    },
+    "worktree:prune": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove worktree records whose paths no longer exist on disk",
+      "examples": [
+        "<%= config.bin %> worktree prune"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:prune",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "worktree",
+        "prune.js"
+      ]
+    },
+    "worktree:remove": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Worktree name to remove",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Remove a worktree and all entity worktrees",
+      "examples": [
+        "<%= config.bin %> worktree remove workflow/batch",
+        "<%= config.bin %> worktree remove workflow/batch --force"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "Remove even with uncommitted changes",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:remove",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "worktree",
+        "remove.js"
+      ]
+    },
+    "worktree:status": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Worktree name (shows all if omitted)",
+          "name": "name",
+          "required": false
+        }
+      },
+      "description": "Show per-entity git status for worktrees",
+      "examples": [
+        "<%= config.bin %> worktree status",
+        "<%= config.bin %> worktree status workflow/deploy-batch"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:status",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "worktree",
+        "status.js"
+      ]
     }
   },
-  "version": "0.1.12"
+  "version": "0.1.14-alpha.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperdrive.bot/gut",
-  "version": "0.1.12",
+  "version": "0.1.14-alpha.0",
   "description": "Git Unified Tooling - Enhanced git with workspace intelligence for entity-based organization",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",