usage: pactkit [-h] [-C PROJECT_ROOT]
               {init,update,upgrade,adopt,reconcile,project-preflight,spec-lint,spec-preflight,schema,guard,generate-id,clean,mcp,uninstall,regression,risk,rules-eval,context,board,governance,continuation,workflow,work-unit,sec-scope,spec-graph,lint-context,lint-lessons,lint-testcase,lint-adr,guide,accept-candidates,visualize,sync,garden,observe,stats,doctor,audit,report,backfill-release,issue-sync,test-map,lint,lesson-append,invariants-refresh,coverage-gate,spec-status,done-verify,commit-gate,gate,deps,interface-summary,redetect-stack,query,version}
               ...

PactKit — Spec-driven agentic DevOps toolkit

positional arguments:
  {init,update,upgrade,adopt,reconcile,project-preflight,spec-lint,spec-preflight,schema,guard,generate-id,clean,mcp,uninstall,regression,risk,rules-eval,context,board,governance,continuation,workflow,work-unit,sec-scope,spec-graph,lint-context,lint-lessons,lint-testcase,lint-adr,guide,accept-candidates,visualize,sync,garden,observe,stats,doctor,audit,report,backfill-release,issue-sync,test-map,lint,lesson-append,invariants-refresh,coverage-gate,spec-status,done-verify,commit-gate,gate,deps,interface-summary,redetect-stack,query,version}
    init                Deploy PactKit configuration
    update              Re-deploy PactKit configuration
    upgrade             Upgrade PactKit (migrate legacy scafpy config)
    adopt               Create a minimal PactKit contract in the current
                        project
    reconcile           Safely reconcile the current project contract
    project-preflight   Check project adoption and schema compatibility
    spec-lint           Validate spec file(s) structure
    spec-preflight      Load Spec implementation inputs and write a verified
                        receipt
    schema              Show document structure rules
    guard               Check project init markers
    generate-id         Generate a decentralized time-prefixed item ID
    clean               Remove temp artifacts
    mcp                 RETIRED — prints the retirement notice (no MCP
                        service)
    uninstall           Remove PactKit-deployed files (keeps user-modified
                        ones)
    regression          Classify changes for regression testing
    risk                Evidence-backed engineering-guide selection for a
                        change
    rules-eval          Evaluate spec-lint rules on the fixed corpus
                        (precision/recall)
    context             Generate local .pactkit/context.md
    board               Manage sharded Story records and Board projection
    governance          Governance records and migrations
    continuation        Manage verifiable resumable Act checkpoints
    workflow            Manage registered, verifiable workflow runs
    work-unit           Execute host-neutral leased workflow units
    sec-scope           Auto-detect security scope
    spec-graph          Story dependency graph: execution waves + conflict
                        matrix
    lint-context        Validate context.md structure
    lint-lessons        Validate lessons.md structure
    lint-testcase       Validate test case file structure
    lint-adr            Validate ADR file structure
    guide               Guide operations
    accept-candidates   Accept .pactkit-new deployment candidates and record
                        ownership digests
    visualize           Visualize code dependency graph
    sync                Sync codegraph index
    garden              Codebase quality patrol
    observe             Collect runtime observability signals
    stats               Aggregate run friction metrics from event streams
    doctor              Diagnose project health
    audit               H1-H7 AI Readiness Assessment
    report              Generate unified HTML architecture dashboard
    backfill-release    Replace Release: TBD in completed specs
    issue-sync          Sync GitHub issue for BUG/HOTFIX items
    test-map            Map source files to test files
    lint                Run stack-aware lint
    lesson-append       Append lesson with dedup check
    invariants-refresh  Update test count in rules.md
    coverage-gate       Run coverage verification
    spec-status         Update Status field in a spec file
    done-verify         Verify archive honesty for a story (evidence chain,
                        exit 1 on FAIL)
    commit-gate         Pre-commit test gate (skip != pass transparency)
    gate                Session context hooks + external-effect authorization
                        tokens
    deps                Check or install external dependencies
                        (node/codegraph/gh)
    interface-summary   Output interface summary (signatures only)
    redetect-stack      Re-detect project stacks and update pactkit.yaml
    query               Query the configured static-analysis provider
    version             Show PactKit version

options:
  -h, --help            show this help message and exit
  -C PROJECT_ROOT, --project-root PROJECT_ROOT
                        Initialized PactKit project root (otherwise discovered
                        from CWD)
