@hyperdrive.bot/gut 0.1.9 → 0.1.11

package/dist/services/ticket.service.js

@@ -96,12 +96,16 @@ export class TicketService {
     /**
      * Sync ticket with external source
      */
-    async syncTicket(ticketId, direction = 'push') {
+    async syncTicket(ticketId, direction = 'push', options) {
         if (this.useAuth && this.apiService) {
-            return this.apiService.syncTicket(ticketId, direction);
+            return this.apiService.syncTicket(ticketId, direction, options);
         }
         // Fallback to unauthenticated mode
-        const response = await this.makeFetchRequest('POST', `/gut/tickets/${encodeURIComponent(ticketId)}/sync?direction=${direction}`);
+        const params = new URLSearchParams({ direction });
+        if (options?.noEnrich) {
+            params.set('noEnrich', 'true');
+        }
+        const response = await this.makeFetchRequest('POST', `/gut/tickets/${encodeURIComponent(ticketId)}/sync?${params.toString()}`);
         return response;
     }
     /**

package/dist/services/worktree.service.d.ts

@@ -0,0 +1,16 @@
+import type { WorktreeRecord, WorktreeState } from '../models/entity.model.js';
+import type { ConfigService } from './config.service.js';
+import type { FocusService } from './focus.service.js';
+import type { GitService } from './git.service.js';
+export declare class WorktreeService {
+    private readonly configService;
+    private readonly gitService;
+    private readonly focusService;
+    private readonly stateFile;
+    private readonly stateFileTmp;
+    constructor(configService: ConfigService, gitService: GitService, focusService: FocusService);
+    get(name: string): WorktreeRecord | null;
+    list(): WorktreeRecord[];
+    loadState(): WorktreeState;
+    saveState(state: WorktreeState): void;
+}

package/dist/services/worktree.service.js

@@ -0,0 +1,60 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export class WorktreeService {
+    configService;
+    gitService;
+    focusService;
+    stateFile;
+    stateFileTmp;
+    constructor(configService, gitService, focusService) {
+        this.configService = configService;
+        this.gitService = gitService;
+        this.focusService = focusService;
+        this.stateFile = path.join(this.configService.getGutDir(), 'worktrees.json');
+        this.stateFileTmp = `${this.stateFile}.tmp`;
+    }
+    get(name) {
+        const state = this.loadState();
+        return state.worktrees.find(w => w.name === name) ?? null;
+    }
+    list() {
+        return this.loadState().worktrees;
+    }
+    loadState() {
+        if (!fs.existsSync(this.stateFile)) {
+            return { worktrees: [] };
+        }
+        try {
+            const content = fs.readFileSync(this.stateFile, 'utf-8');
+            const parsed = JSON.parse(content);
+            if (!Array.isArray(parsed.worktrees)) {
+                return { worktrees: [] };
+            }
+            return parsed;
+        }
+        catch {
+            console.warn('Corrupt worktrees.json, resetting state');
+            return { worktrees: [] };
+        }
+    }
+    saveState(state) {
+        const serialized = JSON.stringify(state, null, 2);
+        try {
+            fs.writeFileSync(this.stateFileTmp, serialized, 'utf-8');
+            fs.renameSync(this.stateFileTmp, this.stateFile);
+        }
+        catch (error) {
+            // Cleanup tmp file on failure
+            try {
+                if (fs.existsSync(this.stateFileTmp)) {
+                    fs.unlinkSync(this.stateFileTmp);
+                }
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to save worktree state: ${message}`);
+        }
+    }
+}

package/oclif.manifest.json

@@ -1302,6 +1302,107 @@
         "workspace.js"
       ]
     },
+    "auth:login": {
+      "aliases": [],
+      "args": {},
+      "description": "Authenticate with Gut using OAuth 2.0 PKCE flow",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --domain acme.hyperdrive.bot",
+        "<%= config.bin %> <%= command.id %> --port 9876"
+      ],
+      "flags": {
+        "domain": {
+          "char": "d",
+          "description": "Tenant domain (e.g., acme.hyperdrive.bot)",
+          "name": "domain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "Local callback server port",
+          "name": "port",
+          "default": 8766,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:login",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "login.js"
+      ]
+    },
+    "auth:logout": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove stored credentials and logout",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:logout",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "logout.js"
+      ]
+    },
+    "auth:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show current authentication status",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --verbose"
+      ],
+      "flags": {
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed credential information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:status",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "status.js"
+      ]
+    },
     "entity:add": {
       "aliases": [],
       "args": {
@@ -1394,9 +1495,8 @@
       "flags": {
         "branch": {
           "char": "b",
-          "description": "Branch to clone for all entities",
+          "description": "Branch to clone for all entities (auto-detects workspace branch, falls back to master)",
           "name": "branch",
-          "default": "main",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1463,9 +1563,8 @@
       "flags": {
         "branch": {
           "char": "b",
-          "description": "Branch to clone",
+          "description": "Branch to clone (auto-detects workspace branch, falls back to master)",
           "name": "branch",
-          "default": "main",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1605,6 +1704,70 @@
         "remove.js"
       ]
     },
+    "ticket:config": {
+      "aliases": [],
+      "args": {},
+      "description": "Configure ticket source (JIRA, GitHub, etc.) for this tenant",
+      "examples": [
+        "<%= config.bin %> ticket config --show",
+        "<%= config.bin %> ticket config --type jira --url https://company.atlassian.net --secret-arn arn:aws:secretsmanager:..."
+      ],
+      "flags": {
+        "secret-arn": {
+          "description": "AWS Secrets Manager ARN for credentials",
+          "name": "secret-arn",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "char": "j",
+          "description": "output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "show": {
+          "description": "show current configuration",
+          "name": "show",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "type": {
+          "description": "source type",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "jira",
+            "github",
+            "linear"
+          ],
+          "type": "option"
+        },
+        "url": {
+          "description": "base URL (e.g., https://company.atlassian.net)",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ticket:config",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ticket",
+        "config.js"
+      ]
+    },
     "ticket:focus": {
       "aliases": [],
       "args": {
@@ -1869,16 +2032,17 @@
       "aliases": [],
       "args": {
         "ticketId": {
-          "description": "ticket ID to sync",
+          "description": "ticket ID to sync (e.g., PROJ-1234)",
           "name": "ticketId",
           "required": true
         }
       },
-      "description": "Sync ticket state with external source (JIRA, GitHub, etc.)",
+      "description": "Sync ticket state with external source (JIRA, GitHub, etc.)\n\nFor pull direction:\n  - If ticket exists in gut: updates from source\n  - If ticket doesn't exist: creates it and queues enrichment\n\nFor push direction:\n  - Updates source system with gut ticket state",
       "examples": [
         "<%= config.bin %> <%= command.id %> PROJ-1234",
         "<%= config.bin %> <%= command.id %> PROJ-1234 --direction push",
-        "<%= config.bin %> <%= command.id %> PROJ-1234 --direction pull"
+        "<%= config.bin %> <%= command.id %> PROJ-1234 --direction pull",
+        "<%= config.bin %> <%= command.id %> PROJ-1234 --direction pull --no-enrich"
       ],
       "flags": {
         "direction": {
@@ -1900,6 +2064,12 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "no-enrich": {
+          "description": "skip enrichment queue when pulling new tickets",
+          "name": "no-enrich",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -2002,7 +2172,60 @@
         "ticket",
         "update.js"
       ]
+    },
+    "worktree:create": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Branch name for the worktree",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Create mirrored worktrees for super-repo and focused entities",
+      "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"
+      ],
+      "flags": {
+        "base-dir": {
+          "description": "Root directory for worktrees",
+          "name": "base-dir",
+          "default": "/tmp/gut-worktrees",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "from": {
+          "description": "Base branch to create from (defaults to current branch)",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "install": {
+          "description": "Run pnpm install after creation",
+          "name": "install",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:create",
+      "pluginAlias": "@hyperdrive.bot/gut",
+      "pluginName": "@hyperdrive.bot/gut",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "worktree",
+        "create.js"
+      ]
     }
   },
-  "version": "0.1.9"
+  "version": "0.1.11"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperdrive.bot/gut",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Git Unified Tooling - Enhanced git with workspace intelligence for entity-based organization",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,8 @@
   "files": [
     "/bin",
     "/dist",
-    "/oclif.manifest.json"
+    "/oclif.manifest.json",
+    "/templates"
   ],
   "scripts": {
     "build": "rm -rf dist && tsc -b",
@@ -19,7 +20,8 @@
     "lint": "eslint .",
     "postpack": "rm -f oclif.manifest.json",
     "prepack": "npm run build && npx oclif manifest || true",
-    "test": "npm run build",
+    "test": "vitest run",
+    "test:unit": "vitest run",
     "version": "npx oclif readme && git add README.md || true"
   },
   "keywords": [
@@ -36,6 +38,7 @@
   },
   "dependencies": {
     "@hyperdrive.bot/cli-auth": "^1.1.1",
+    "@hyperdrive.bot/plugin-telemetry": "file:../telemetry-plugin",
     "@oclif/core": "^4.5.2",
     "@oclif/plugin-help": "^6.2.32",
     "axios": "^1.7.1",
@@ -56,14 +59,16 @@
     "eslint-config-oclif-typescript": "^3.1.14",
     "oclif": "^4.22.16",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.0"
   },
   "oclif": {
     "bin": "gut",
     "dirname": "gut",
     "commands": "./dist/commands",
     "plugins": [
-      "@oclif/plugin-help"
+      "@oclif/plugin-help",
+      "@hyperdrive.bot/plugin-telemetry"
     ],
     "topicSeparator": " ",
     "topics": {
@@ -75,6 +80,12 @@
       },
       "ticket": {
         "description": "Manage gut tickets from the ADHB system"
+      },
+      "claude": {
+        "description": "Claude Code integration"
+      },
+      "worktree": {
+        "description": "Manage entity-aware git worktrees for isolated pipeline runs"
       }
     }
   },