@hyperdrive.bot/gut 0.1.3 → 0.1.6

package/README.md

@@ -18,7 +18,7 @@ $ npm install -g @hyperdrive.bot/gut
 $ gut COMMAND
 running command...
 $ gut (--version)
-@hyperdrive.bot/gut/0.1.1 linux-x64 node-v22.16.0
+@hyperdrive.bot/gut/0.1.5 linux-x64 node-v24.13.0
 $ gut --help [COMMAND]
 USAGE
   $ gut COMMAND
@@ -27,783 +27,5 @@ USAGE
 <!-- usagestop -->
 # Commands
 <!-- commands -->
-* [`gut add [PATH]`](#gut-add-path)
-* [`gut affected [ENTITY]`](#gut-affected-entity)
-* [`gut audit`](#gut-audit)
-* [`gut back`](#gut-back)
-* [`gut commit`](#gut-commit)
-* [`gut context`](#gut-context)
-* [`gut contexts`](#gut-contexts)
-* [`gut deps [ENTITY]`](#gut-deps-entity)
-* [`gut entity add TYPE NAME`](#gut-entity-add-type-name)
-* [`gut entity clone NAME`](#gut-entity-clone-name)
-* [`gut entity clone-all`](#gut-entity-clone-all)
-* [`gut entity list`](#gut-entity-list)
-* [`gut entity remove NAME`](#gut-entity-remove-name)
-* [`gut focus [ENTITYTYPEORNAME] [ENTITYNAME]`](#gut-focus-entitytypeorname-entityname)
-* [`gut graph`](#gut-graph)
-* [`gut help [COMMAND]`](#gut-help-command)
-* [`gut init`](#gut-init)
-* [`gut insights`](#gut-insights)
-* [`gut patterns`](#gut-patterns)
-* [`gut pull`](#gut-pull)
-* [`gut push`](#gut-push)
-* [`gut quick-setup`](#gut-quick-setup)
-* [`gut recent`](#gut-recent)
-* [`gut related [ENTITY]`](#gut-related-entity)
-* [`gut repos`](#gut-repos)
-* [`gut stack`](#gut-stack)
-* [`gut status`](#gut-status)
-* [`gut sync`](#gut-sync)
-* [`gut unfocus`](#gut-unfocus)
-* [`gut used-by [ENTITY]`](#gut-used-by-entity)
-* [`gut workspace ACTION`](#gut-workspace-action)
 
-## `gut add [PATH]`
-
-Stage changes in focused entities
-
-```
-USAGE
-  $ gut add [PATH] [-A] [-p]
-
-ARGUMENTS
-  PATH  [default: .] Path(s) to stage
-
-FLAGS
-  -A, --all    Stage all changes (equivalent to git add -A)
-  -p, --patch  Interactive staging
-
-DESCRIPTION
-  Stage changes in focused entities
-
-EXAMPLES
-  $ gut add
-
-  $ gut add .
-
-  $ gut add src/
-
-  $ gut add --all
-```
-
-## `gut affected [ENTITY]`
-
-Detect entities potentially affected by changes in current focus
-
-```
-USAGE
-  $ gut affected [ENTITY] [-s <value>] [--include-tests] [--include-docs] [-v]
-
-ARGUMENTS
-  ENTITY  Entity to analyze (uses current focus if not provided)
-
-FLAGS
-  -s, --since=<value>  [default: HEAD~1] Git reference to compare against
-  -v, --verbose        Show detailed analysis
-      --include-docs   Include documentation changes in analysis
-      --include-tests  Include test file changes in analysis
-
-DESCRIPTION
-  Detect entities potentially affected by changes in current focus
-
-EXAMPLES
-  $ gut affected
-
-  $ gut affected my-app
-
-  $ gut affected --since HEAD~5
-
-  $ gut affected --include-tests
-```
-
-## `gut audit`
-
-Access and change audit across workspace
-
-```
-USAGE
-  $ gut audit [-e <value>] [-s] [-c] [-a] [--changes] [--json]
-
-FLAGS
-  -a, --access          audit access patterns and permissions
-  -c, --compliance      focus on compliance audit
-  -e, --entity=<value>  audit specific entity
-  -s, --security        focus on security audit
-      --changes         audit recent changes and activity
-      --json            output as JSON
-
-DESCRIPTION
-  Access and change audit across workspace
-
-EXAMPLES
-  $ gut audit
-
-  $ gut audit --entity mindtools
-
-  $ gut audit --security
-
-  $ gut audit --compliance
-```
-
-## `gut back`
-
-Navigate back to the previous focus
-
-```
-USAGE
-  $ gut back
-
-DESCRIPTION
-  Navigate back to the previous focus
-
-EXAMPLES
-  $ gut back
-```
-
-## `gut commit`
-
-Commit changes in focused repositories
-
-```
-USAGE
-  $ gut commit [-m <value>] [-a] [--amend]
-
-FLAGS
-  -a, --all              Stage all changes before committing
-  -m, --message=<value>  Commit message
-      --amend            Amend the previous commit
-
-DESCRIPTION
-  Commit changes in focused repositories
-
-EXAMPLES
-  $ gut commit -m "Fix bug"
-
-  $ gut commit --message "Add feature"
-
-  $ gut commit
-```
-
-## `gut context`
-
-Show current focus context with entity details
-
-```
-USAGE
-  $ gut context
-
-DESCRIPTION
-  Show current focus context with entity details
-
-EXAMPLES
-  $ gut context
-```
-
-## `gut contexts`
-
-List all available contexts and focus history
-
-```
-USAGE
-  $ gut contexts
-
-DESCRIPTION
-  List all available contexts and focus history
-
-EXAMPLES
-  $ gut contexts
-```
-
-## `gut deps [ENTITY]`
-
-Show dependencies of current focus or specified entity
-
-```
-USAGE
-  $ gut deps [ENTITY]
-
-ARGUMENTS
-  ENTITY  Entity name to analyze dependencies for
-
-DESCRIPTION
-  Show dependencies of current focus or specified entity
-
-EXAMPLES
-  $ gut deps
-
-  $ gut deps mindtools
-```
-
-## `gut entity add TYPE NAME`
-
-Add a new entity to the workspace
-
-```
-USAGE
-  $ gut entity add TYPE NAME -p <value> [-r <value>] [-d <value>] [--repo <value>]
-
-ARGUMENTS
-  TYPE  (client|prospect|company|initiative|system|delivery|module|service|tool) Entity type
-  NAME  Entity name
-
-FLAGS
-  -d, --description=<value>  entity description
-  -p, --path=<value>         (required) path to entity
-  -r, --remote=<value>       git remote URL
-      --repo=<value>         repository name (for GitLab/GitHub)
-
-DESCRIPTION
-  Add a new entity to the workspace
-
-EXAMPLES
-  $ gut entity add delivery my-app --path ./apps/my-app
-
-  $ gut entity add module my-lib --path ./libs/my-lib --remote git@github.com:org/my-lib.git
-```
-
-## `gut entity clone NAME`
-
-Clone a specific entity from its repository
-
-```
-USAGE
-  $ gut entity clone NAME [-b <value>] [-d <value>] [-p <value>] [-f]
-
-ARGUMENTS
-  NAME  Name of the entity to clone
-
-FLAGS
-  -b, --branch=<value>  [default: main] Branch to clone
-  -d, --depth=<value>   Create a shallow clone with specified depth
-  -f, --force           Force clone even if directory exists
-  -p, --path=<value>    Custom path to clone to (relative to workspace)
-
-DESCRIPTION
-  Clone a specific entity from its repository
-
-EXAMPLES
-  $ gut entity clone my-app
-
-  $ gut entity clone my-app --branch develop
-
-  $ gut entity clone my-app --depth 1
-```
-
-## `gut entity clone-all`
-
-Clone all configured entities from their repositories
-
-```
-USAGE
-  $ gut entity clone-all [-b <value>] [-d <value>] [-p] [--skip-existing] [-f]
-
-FLAGS
-  -b, --branch=<value>  [default: main] Branch to clone for all entities
-  -d, --depth=<value>   Create shallow clones with specified depth
-  -f, --force           Force clone even if directories exist
-  -p, --parallel        Clone entities in parallel
-      --skip-existing   Skip entities that already exist
-
-DESCRIPTION
-  Clone all configured entities from their repositories
-
-EXAMPLES
-  $ gut entity clone-all
-
-  $ gut entity clone-all --parallel
-
-  $ gut entity clone-all --branch develop
-
-  $ gut entity clone-all --skip-existing
-```
-
-## `gut entity list`
-
-List all configured entities
-
-```
-USAGE
-  $ gut entity list [-t delivery|module|service|tool] [--json] [-v]
-
-FLAGS
-  -t, --type=<option>  filter by entity type
-                       <options: delivery|module|service|tool>
-  -v, --verbose        show detailed information
-      --json           output as JSON
-
-DESCRIPTION
-  List all configured entities
-
-EXAMPLES
-  $ gut entity list
-
-  $ gut entity list --type delivery
-
-  $ gut entity list --json
-```
-
-## `gut entity remove NAME`
-
-Remove an entity from the workspace configuration
-
-```
-USAGE
-  $ gut entity remove NAME [-f]
-
-ARGUMENTS
-  NAME  Entity name to remove
-
-FLAGS
-  -f, --force  skip confirmation prompt
-
-DESCRIPTION
-  Remove an entity from the workspace configuration
-
-EXAMPLES
-  $ gut entity remove my-app
-
-  $ gut entity remove my-app --force
-```
-
-## `gut focus [ENTITYTYPEORNAME] [ENTITYNAME]`
-
-Set focus on one or more entities with optional type and mode
-
-```
-USAGE
-  $ gut focus [ENTITYTYPEORNAME...] [ENTITYNAME...] [-c | -a | -m
-    delivery|strategy|audit|debug|research|proposal] [-d <value>] [-r]
-
-ARGUMENTS
-  ENTITYTYPEORNAME...  Entity type (client/prospect/company/initiative) or entity name
-  ENTITYNAME...        Entity name (when first arg is entity type)
-
-FLAGS
-  -a, --add               add to current focus instead of replacing
-  -c, --clear             clear current focus
-  -d, --duration=<value>  focus duration (e.g., 2h, 90m)
-  -m, --mode=<option>     focus mode (delivery, strategy, audit, debug, research, proposal)
-                          <options: delivery|strategy|audit|debug|research|proposal>
-  -r, --remember          remember current focus before switching
-
-DESCRIPTION
-  Set focus on one or more entities with optional type and mode
-
-EXAMPLES
-  $ gut focus my-app
-
-  $ gut focus client mindtools
-
-  $ gut focus client mindtools --mode delivery
-
-  $ gut focus prospect jazida --mode research
-
-  $ gut focus my-app auth-service
-
-  $ gut focus --clear
-```
-
-## `gut graph`
-
-Visualize repository relationships and dependencies
-
-```
-USAGE
-  $ gut graph [-f ascii|dot|json] [--focus-only] [-d <value>]
-
-FLAGS
-  -d, --depth=<value>    [default: 2] maximum depth of relationships to show
-  -f, --format=<option>  [default: ascii] output format
-                         <options: ascii|dot|json>
-      --focus-only       show only focused entities and their relationships
-
-DESCRIPTION
-  Visualize repository relationships and dependencies
-
-EXAMPLES
-  $ gut graph
-
-  $ gut graph --format ascii
-
-  $ gut graph --focus-only
-```
-
-## `gut help [COMMAND]`
-
-Display help for gut.
-
-```
-USAGE
-  $ gut help [COMMAND...] [-n]
-
-ARGUMENTS
-  COMMAND...  Command to show help for.
-
-FLAGS
-  -n, --nested-commands  Include all nested commands in the output.
-
-DESCRIPTION
-  Display help for gut.
-```
-
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.32/src/commands/help.ts)_
-
-## `gut init`
-
-Initialize a gut workspace
-
-```
-USAGE
-  $ gut init [-f] [-w <value>]
-
-FLAGS
-  -f, --force              force initialization even if already initialized
-  -w, --workspace=<value>  [default: /builds/JOkrpDV8M/0/dev_squad/repo/cli/gut] workspace root directory
-
-DESCRIPTION
-  Initialize a gut workspace
-
-EXAMPLES
-  $ gut init
-
-  $ gut init --force
-```
-
-## `gut insights`
-
-Display analytics and insights about the workspace
-
-```
-USAGE
-  $ gut insights [-d] [-f table|json|summary] [--include-ignored]
-
-FLAGS
-  -d, --detailed         Show detailed statistics for each entity
-  -f, --format=<option>  [default: table] Output format
-                         <options: table|json|summary>
-      --include-ignored  Include gitignored files in statistics
-
-DESCRIPTION
-  Display analytics and insights about the workspace
-
-EXAMPLES
-  $ gut insights
-
-  $ gut insights --detailed
-
-  $ gut insights --format json
-```
-
-## `gut patterns`
-
-Show learned patterns for current context or entities
-
-```
-USAGE
-  $ gut patterns [-e <value>] [-t client|prospect|company|initiative|system] [-m
-    delivery|strategy|audit|debug|research|proposal] [--json]
-
-FLAGS
-  -e, --entity=<value>  show patterns for specific entity
-  -m, --mode=<option>   show patterns for focus mode
-                        <options: delivery|strategy|audit|debug|research|proposal>
-  -t, --type=<option>   show patterns for entity type
-                        <options: client|prospect|company|initiative|system>
-      --json            output as JSON
-
-DESCRIPTION
-  Show learned patterns for current context or entities
-
-EXAMPLES
-  $ gut patterns
-
-  $ gut patterns --entity mindtools
-
-  $ gut patterns --type client
-
-  $ gut patterns --mode strategy
-```
-
-## `gut pull`
-
-Pull changes from remote repositories
-
-```
-USAGE
-  $ gut pull [-r] [--all] [--no-commit]
-
-FLAGS
-  -r, --rebase     Rebase instead of merge
-      --all        Fetch all remotes
-      --no-commit  Perform merge but do not commit
-
-DESCRIPTION
-  Pull changes from remote repositories
-
-EXAMPLES
-  $ gut pull
-
-  $ gut pull --rebase
-
-  $ gut pull --all
-```
-
-## `gut push`
-
-Push commits to remote repositories
-
-```
-USAGE
-  $ gut push [-f] [-u] [--tags]
-
-FLAGS
-  -f, --force         Force push (use with caution)
-  -u, --set-upstream  Set upstream branch
-      --tags          Push tags
-
-DESCRIPTION
-  Push commits to remote repositories
-
-EXAMPLES
-  $ gut push
-
-  $ gut push --force
-
-  $ gut push --set-upstream
-```
-
-## `gut quick-setup`
-
-Automated workspace setup based on common patterns
-
-```
-USAGE
-  $ gut quick-setup [-a] [-p monorepo|microservices|fullstack|library] [--scan-depth <value>] [--clone-missing]
-
-FLAGS
-  -a, --auto                Auto-detect and configure without prompts
-  -p, --profile=<option>    Use specific setup profile
-                            <options: monorepo|microservices|fullstack|library>
-      --clone-missing       Clone missing repositories if found
-      --scan-depth=<value>  [default: 2] Directory depth to scan for entities
-
-DESCRIPTION
-  Automated workspace setup based on common patterns
-
-EXAMPLES
-  $ gut quick-setup
-
-  $ gut quick-setup --auto
-
-  $ gut quick-setup --profile monorepo
-
-  $ gut quick-setup --scan-depth 3
-```
-
-## `gut recent`
-
-Show recent focus history
-
-```
-USAGE
-  $ gut recent [-l <value>]
-
-FLAGS
-  -l, --limit=<value>  [default: 5] Number of recent items to show
-
-DESCRIPTION
-  Show recent focus history
-
-EXAMPLES
-  $ gut recent
-
-  $ gut recent --limit 10
-```
-
-## `gut related [ENTITY]`
-
-Find entities related to a specific entity or current focus
-
-```
-USAGE
-  $ gut related [ENTITY] [-t <value>] [--type all|dependencies|git|files] [-d]
-
-ARGUMENTS
-  ENTITY  Entity name (uses current focus if not provided)
-
-FLAGS
-  -d, --detailed           Show detailed relation information
-  -t, --threshold=<value>  [default: 0.2] Minimum relation score (0-1)
-      --type=<option>      [default: all] Type of relation to check
-                           <options: all|dependencies|git|files>
-
-DESCRIPTION
-  Find entities related to a specific entity or current focus
-
-EXAMPLES
-  $ gut related my-app
-
-  $ gut related --threshold 0.3
-
-  $ gut related --type dependencies
-```
-
-## `gut repos`
-
-List accessible repositories in the workspace
-
-```
-USAGE
-  $ gut repos [-t client|prospect|company|initiative|system|delivery|module|service|tool] [-s] [--json] [-a]
-
-FLAGS
-  -a, --accessible     show only accessible repositories (with valid paths)
-  -s, --status         show git status for each repository
-  -t, --type=<option>  filter by entity type
-                       <options: client|prospect|company|initiative|system|delivery|module|service|tool>
-      --json           output as JSON
-
-DESCRIPTION
-  List accessible repositories in the workspace
-
-EXAMPLES
-  $ gut repos
-
-  $ gut repos --type client
-
-  $ gut repos --status
-
-  $ gut repos --json
-```
-
-## `gut stack`
-
-Show and manage the focus stack
-
-```
-USAGE
-  $ gut stack [-c]
-
-FLAGS
-  -c, --clear  clear the focus stack
-
-DESCRIPTION
-  Show and manage the focus stack
-
-EXAMPLES
-  $ gut stack
-
-  $ gut stack --clear
-```
-
-## `gut status`
-
-Show git status for focused entities
-
-```
-USAGE
-  $ gut status [-a] [-v] [--json]
-
-FLAGS
-  -a, --all      show status for all entities
-  -v, --verbose  show detailed status
-      --json     output as JSON
-
-DESCRIPTION
-  Show git status for focused entities
-
-EXAMPLES
-  $ gut status
-
-  $ gut status --all
-
-  $ gut status --verbose
-```
-
-## `gut sync`
-
-Synchronize repositories with remote (fetch, merge/rebase, push)
-
-```
-USAGE
-  $ gut sync [-r] [-f] [--no-push]
-
-FLAGS
-  -f, --force    Force push after sync
-  -r, --rebase   Use rebase instead of merge
-      --no-push  Skip the push step
-
-DESCRIPTION
-  Synchronize repositories with remote (fetch, merge/rebase, push)
-
-EXAMPLES
-  $ gut sync
-
-  $ gut sync --rebase
-
-  $ gut sync --force
-```
-
-## `gut unfocus`
-
-Clear the current focus
-
-```
-USAGE
-  $ gut unfocus
-
-DESCRIPTION
-  Clear the current focus
-
-EXAMPLES
-  $ gut unfocus
-```
-
-## `gut used-by [ENTITY]`
-
-Show what entities depend on current focus or specified entity
-
-```
-USAGE
-  $ gut used-by [ENTITY]
-
-ARGUMENTS
-  ENTITY  Entity name to analyze usage for
-
-DESCRIPTION
-  Show what entities depend on current focus or specified entity
-
-EXAMPLES
-  $ gut used-by
-
-  $ gut used-by api
-```
-
-## `gut workspace ACTION`
-
-Manage workspace structure and entity metadata
-
-```
-USAGE
-  $ gut workspace ACTION [-f] [-t client|prospect|company|initiative|system]
-
-ARGUMENTS
-  ACTION  (init|structure|generate-metadata) Action to perform (init, structure, generate-metadata)
-
-FLAGS
-  -f, --force                 force overwrite existing files
-  -t, --entity-type=<option>  entity type for metadata generation
-                              <options: client|prospect|company|initiative|system>
-
-DESCRIPTION
-  Manage workspace structure and entity metadata
-
-EXAMPLES
-  $ gut workspace init
-
-  $ gut workspace structure
-
-  $ gut workspace generate-metadata
-```
 <!-- commandsstop -->