Code Fettl - AI Slop Detection Tool

Usage: fettl [OPTIONS] <COMMAND>

Commands:
  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)
  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 migrations in the correct order
  trend                     Show score history over time (sparkline + relative timestamps)
  fix                       Apply deterministic repairs transactionally, then verify and roll back on failure
  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
  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.

          [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)
