gh-velocity risk bus-factor#

Knowledge risk per directory from git history

Synopsis#

Analyzes local git history to identify directories where knowledge is concentrated in one or two people. Helps spot areas that would stall if a key contributor became unavailable.

Risk levels: HIGH — 1 contributor MEDIUM — 2 contributors, primary >70% of commits LOW — 3+ contributors with distributed commits

gh-velocity risk bus-factor [flags]

Examples#

  # Last 90 days (default)
  gh velocity quality bus-factor

  # Last 180 days
  gh velocity quality bus-factor --since 180d

  # JSON for CI/scripts
  gh velocity quality bus-factor --format json

Options#

  -h, --help           help for bus-factor
      --since string   Lookback period (YYYY-MM-DD, RFC3339, or Nd relative) (default "90d")

Options inherited from parent commands#

      --config string   Path to config file (default: .gh-velocity.yml)
      --debug           Print diagnostic info to stderr
  -f, --format string   Output format: json, pretty, markdown (default "pretty")
      --new-post        Force a new post (skip idempotent update; implies --post)
      --post            Post output to GitHub (dry-run by default; set GH_VELOCITY_POST_LIVE=true for live)
  -R, --repo string     Repository in owner/name format
      --scope string    Additional GitHub search qualifier(s) ANDed with config scope

SEE ALSO#

Backward risk status Forward