justfile

# agent-coordinator compliance system
#
# Three tiers, composed into one entry point:
#   just compliance    — all tiers (the one command to trust)
#   just gate          — Tier 1: the test suite + lint gates
#   just meta          — Tier 2: governance meta-checks
#   just teeth         — Tier 3: mutation tripwires
#
# Sits alongside existing npm scripts — they still work unchanged.
# See docs/design/architecture-retrospective/architectural-rules-reference.md

# ── Tier 1: the gate ────────────────────────────────────────────

# Full gate — typecheck + architecture checks + test suite.
# check:architectural-rules is non-blocking (3 known R33 violations tracked as debt).
gate:
    npm run typecheck
    npm run check:composition-root
    -npm run check:architectural-rules
    npm test

# ── Tier 2: meta-checks ─────────────────────────────────────────

# Governance tests — rule coverage, gate config completeness
meta:
    npx vitest run test/governance

# ── Tier 3: mutation tripwires ──────────────────────────────────

# Tripwire tests — prove Tier 1 checks have teeth
teeth:
    npx vitest run test/governance/tripwires

# ── Full compliance — all tiers ─────────────────────────────────

# Run all three tiers. Green = the system obeys its own rules.
compliance: gate meta teeth

# ── Quick feedback (fast, local) ─────────────────────────────────


# Fast pre-commit checks — typecheck + architecture boundary only
preflight:
    npm run typecheck
    npm run check:composition-root
    -npm run check:architectural-rules

# Strict lint — blocks on architectural rule violations (including known debt)
lint:
    npm run check:composition-root
    npm run check:architectural-rules

# ── Default ─────────────────────────────────────────────────────

default:
    @just --list