Code Fettl - AI Slop Detection Tool

Usage: fettl [OPTIONS] <COMMAND>

Commands:
  trellis                   Validate or import operator-authored Trellis knowledge
  check                     Run all checks against the project and report violations
  score                     Compute a weighted AI-slop density score (0-10) across named categories
  audit                     Audit each exception with adversarial skepticism, showing what each suppression hides
  init                      Initialize project (create baseline exception file, config, or agent skills)
  local-store               Initialize shared local state or explicitly import stopped legacy sessions
  checkpoint                Manage the incremental scan checkpoint
  list                      List all available checks and their categories
  readme                    Print the project README
  changelog                 Print the CHANGELOG (current series by default; use --all or --since for more)
  migrate-ledger            Translate per-entry ledger keys to per-file keys (one-time upgrade step)
  migrate-exceptions        Migrate monolithic fettl-exceptions.toml to per-file .d/ format
  migrate-exception-format  Consolidate flat per-entry .d/ files into per-check files using the [[locations]] array format
  migrate-check-names       Rewrite project config files to use compound check IDs
  describe                  Show detailed information about a single check
  upgrade                   Auto-detect and apply needed configuration migrations (not a product update)
  trend                     Show score history over time (sparkline + relative timestamps)
  fix                       Apply deterministic repairs transactionally, then verify and roll back on failure
  uninstall                 Remove every fettl-managed hook entry across all agents and scopes
  hook                      Install, uninstall, or check status of editor/agent hooks
  supervisor                Start or interact with the local supervisor process
  agent                     Run an external coding agent (Codex, Hermes, `OpenCode`) to repair violations
  login                     Log in to Fettl Pro (browser-assisted flow)
  account                   Show account and entitlement status
  provider-status           Show local/offline or authoritative repository PR-provider status
  logout                    Log out and clear cached entitlement
  adjudicate                Request an adjudication review, or continue one under its own budgets
  diagnostics               The hosted diagnostics bridge: bind, submit, status, disable
  help                      Print this message or the help of the given subcommand(s)

Options:
      --config <CONFIG>
          Path to a fettl config file (overrides auto-detection)

      --force
          Force operation even if directory doesn't look like a project root

      --cache-dir <CACHE_DIR>
          Cache directory (default: .fettl-cache/ in project root)

      --timeout <SECS>
          Kill fettl after this many seconds (default: 60; 0 = disabled).

          A background watchdog thread exits the process with code 2 if the command has not finished within the given duration. Set to 0 to run without any time limit. Protects CI pipelines and agent workflows from indefinite hangs. Trellis manifest commands use a cooperative deadline and require nonzero.

          [default: 60]

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Exit Codes:
  0  No violations found
  1  One or more violations found
  2  Watchdog timeout (process killed by --timeout)
  3  Fatal error (broken config, I/O failure — see stderr)
