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

PactKit — Spec-driven agentic DevOps toolkit

positional arguments:
  {init,update,upgrade,spec-lint,spec-preflight,schema,guard,generate-id,clean,regression,context,board,governance,continuation,workflow,work-unit,sec-scope,spec-graph,lint-context,lint-lessons,lint-testcase,visualize,sync,garden,observe,doctor,audit,report,backfill-release,issue-sync,test-map,lint,lesson-append,invariants-refresh,coverage-gate,spec-status,done-verify,commit-gate,deps,interface-summary,redetect-stack,query,version}
    init                Deploy PactKit configuration
    update              Re-deploy PactKit configuration
    upgrade             Upgrade PactKit (migrate legacy scafpy config)
    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
    regression          Classify changes for regression testing
    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
    visualize           Visualize code dependency graph
    sync                Sync codegraph index
    garden              Codebase quality patrol
    observe             Collect runtime observability signals
    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)
    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
                        Initialized PactKit project root (otherwise discovered
                        from CWD)
