@hyperdrive.bot/gut 0.1.11 → 0.1.12

package/README.md

@@ -18,7 +18,7 @@ $ npm install -g @hyperdrive.bot/gut
 $ gut COMMAND
 running command...
 $ gut (--version)
-@hyperdrive.bot/gut/0.1.11 linux-x64 node-v22.22.0
+@hyperdrive.bot/gut/0.1.12 linux-x64 node-v22.22.1
 $ gut --help [COMMAND]
 USAGE
   $ gut COMMAND
@@ -30,6 +30,9 @@ USAGE
 * [`gut add [PATH]`](#gut-add-path)
 * [`gut affected [ENTITY]`](#gut-affected-entity)
 * [`gut audit`](#gut-audit)
+* [`gut auth login`](#gut-auth-login)
+* [`gut auth logout`](#gut-auth-logout)
+* [`gut auth status`](#gut-auth-status)
 * [`gut back`](#gut-back)
 * [`gut checkout BRANCH`](#gut-checkout-branch)
 * [`gut commit`](#gut-commit)
@@ -58,6 +61,7 @@ USAGE
 * [`gut status`](#gut-status)
 * [`gut sync`](#gut-sync)
 * [`gut ticket`](#gut-ticket)
+* [`gut ticket config`](#gut-ticket-config)
 * [`gut ticket focus TICKETID`](#gut-ticket-focus-ticketid)
 * [`gut ticket get TICKETID`](#gut-ticket-get-ticketid)
 * [`gut ticket hint [HINT] TICKETID`](#gut-ticket-hint-hint-ticketid)
@@ -67,6 +71,7 @@ USAGE
 * [`gut unfocus`](#gut-unfocus)
 * [`gut used-by [ENTITY]`](#gut-used-by-entity)
 * [`gut workspace ACTION`](#gut-workspace-action)
+* [`gut worktree create NAME`](#gut-worktree-create-name)
 
 ## `gut add [PATH]`
 
@@ -155,6 +160,64 @@ EXAMPLES
   $ gut audit --compliance
 ```
 
+## `gut auth login`
+
+Authenticate with Gut using OAuth 2.0 PKCE flow
+
+```
+USAGE
+  $ gut auth login [-d <value>] [-p <value>]
+
+FLAGS
+  -d, --domain=<value>  Tenant domain (e.g., acme.hyperdrive.bot)
+  -p, --port=<value>    [default: 8766] Local callback server port
+
+DESCRIPTION
+  Authenticate with Gut using OAuth 2.0 PKCE flow
+
+EXAMPLES
+  $ gut auth login
+
+  $ gut auth login --domain acme.hyperdrive.bot
+
+  $ gut auth login --port 9876
+```
+
+## `gut auth logout`
+
+Remove stored credentials and logout
+
+```
+USAGE
+  $ gut auth logout
+
+DESCRIPTION
+  Remove stored credentials and logout
+
+EXAMPLES
+  $ gut auth logout
+```
+
+## `gut auth status`
+
+Show current authentication status
+
+```
+USAGE
+  $ gut auth status [-v]
+
+FLAGS
+  -v, --verbose  Show detailed credential information
+
+DESCRIPTION
+  Show current authentication status
+
+EXAMPLES
+  $ gut auth status
+
+  $ gut auth status --verbose
+```
+
 ## `gut back`
 
 Navigate back to the previous focus
@@ -842,6 +905,31 @@ EXAMPLES
   $ gut ticket update PROJ-1234 --status in_progress
 ```
 
+## `gut ticket config`
+
+Configure ticket source (JIRA, GitHub, etc.) for this tenant
+
+```
+USAGE
+  $ gut ticket config [--secret-arn <value>] [-j] [--show] [--type jira|github|linear] [--url <value>]
+
+FLAGS
+  -j, --json                output as JSON
+      --secret-arn=<value>  AWS Secrets Manager ARN for credentials
+      --show                show current configuration
+      --type=<option>       source type
+                            <options: jira|github|linear>
+      --url=<value>         base URL (e.g., https://company.atlassian.net)
+
+DESCRIPTION
+  Configure ticket source (JIRA, GitHub, etc.) for this tenant
+
+EXAMPLES
+  $ gut ticket config --show
+
+  $ gut ticket config --type jira --url https://company.atlassian.net --secret-arn arn:aws:secretsmanager:...
+```
+
 ## `gut ticket focus TICKETID`
 
 Focus on a ticket - downloads manifest and clones required entities
@@ -959,25 +1047,35 @@ Sync ticket state with external source (JIRA, GitHub, etc.)
 
 ```
 USAGE
-  $ gut ticket sync TICKETID [-d push|pull] [-j]
+  $ gut ticket sync TICKETID [-d push|pull] [-j] [--no-enrich]
 
 ARGUMENTS
-  TICKETID  ticket ID to sync
+  TICKETID  ticket ID to sync (e.g., PROJ-1234)
 
 FLAGS
   -d, --direction=<option>  [default: push] sync direction (push: gut -> source, pull: source -> gut)
                             <options: push|pull>
   -j, --json                output as JSON
+      --no-enrich           skip enrichment queue when pulling new tickets
 
 DESCRIPTION
   Sync ticket state with external source (JIRA, GitHub, etc.)
 
+  For pull direction:
+  - If ticket exists in gut: updates from source
+  - If ticket doesn't exist: creates it and queues enrichment
+
+  For push direction:
+  - Updates source system with gut ticket state
+
 EXAMPLES
   $ gut ticket sync PROJ-1234
 
   $ gut ticket sync PROJ-1234 --direction push
 
   $ gut ticket sync PROJ-1234 --direction pull
+
+  $ gut ticket sync PROJ-1234 --direction pull --no-enrich
 ```
 
 ## `gut ticket update TICKETID`
@@ -1075,4 +1173,31 @@ EXAMPLES
 
   $ gut workspace generate-metadata
 ```
+
+## `gut worktree create NAME`
+
+Create mirrored worktrees for super-repo and focused entities
+
+```
+USAGE
+  $ gut worktree create NAME [--base-dir <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
+
+DESCRIPTION
+  Create mirrored worktrees for super-repo and focused entities
+
+EXAMPLES
+  $ gut worktree create workflow/deploy-batch
+
+  $ gut worktree create workflow/deploy-batch --from master --install
+
+  $ gut worktree create feature/story-42 --base-dir /home/user/worktrees
+```
 <!-- commandsstop -->

package/dist/commands/worktree/create.js

@@ -53,13 +53,11 @@ export default class WorktreeCreate extends BaseCommand {
                 const entityRelativePath = entity.path.replace(/^\.\//, '');
                 const entityWtPath = path.join(wtPath, entityRelativePath);
                 const entityMainPath = path.join(workspaceRoot, entityRelativePath);
-                // Resolve base branch per-entity: use super-repo branch if it exists,
-                // otherwise fall back to the entity's current branch
-                let entityBaseBranch = baseBranch;
-                const branchExistsInEntity = await this.gitService.branchExists(entityMainPath, baseBranch);
-                if (!branchExistsInEntity) {
-                    entityBaseBranch = await this.gitService.getCurrentBranch(entityMainPath);
-                    this.log(chalk.yellow(`⚠ Entity "${entity.name}" does not have branch "${baseBranch}", using "${entityBaseBranch}" instead`));
+                // Always use the entity's current branch as base — the super-repo branch
+                // may exist but be stale (e.g., api has master but works on develop)
+                const entityBaseBranch = await this.gitService.getCurrentBranch(entityMainPath);
+                if (entityBaseBranch !== baseBranch) {
+                    this.log(chalk.yellow(`⚠ Entity "${entity.name}" is on "${entityBaseBranch}" (super-repo: "${baseBranch}")`));
                 }
                 // Remove submodule stub
                 fs.rmSync(entityWtPath, { force: true, recursive: true });

package/oclif.manifest.json

@@ -2227,5 +2227,5 @@
       ]
     }
   },
-  "version": "0.1.11"
+  "version": "0.1.12"
 }

package/package.json

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