grounding-conformance

/foundry:grounding-conformance

An operator/agent ADVISORY sweep that answers "how much of the frozen corpus is reality-grounded, and which atoms are not?" — the coverage analogue of /foundry:drift-sweep (the batch sweep, which answers a delta question: "did a schema change just invalidate frozen specs?"). This atom closes the reality-grounding gate's retroactive gap: atoms authorized before the gate existed (the system_grounding validators) carry no system_grounding block at all, so the corpus is only partially covered — this sweep measures the gap and lists exactly the atoms that still need attention.

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/foundry_grounding_conformance.py" \
  --corpus-root "$CLAUDE_PROJECT_DIR"     # default: $CLAUDE_PROJECT_DIR or cwd
  # --snapshot /path/to/snapshot.json     # optional: inject a pre-built system-state snapshot;
                                           # default: build a fresh one host-side against --corpus-root

Input — the current system-state snapshot (host-side, HOW obtained is a wiring concern)

The engine entrypoint, foundry_grounding_conformance.classify_corpus(corpus_root, snapshot), takes an already-built snapshot from the system-state snapshot tool (foundry_system_snapshot.build_system_snapshot() — {schema_ version, schema_grounded, module_grounded, grounding_configured, entities, modules, signature}) as a parameter. It opens no grounding source itself. The standalone CLI above builds one fresh by default (or accepts --snapshot for a pre-built/pinned one) — how the snapshot is obtained is the caller's wiring concern, not the engine's.

The three-way classification (per atom, per the AC-GCB-1 normative rule)

For every frozen contract (carries an authorized: trailer — foundry_authz._authorized_block), against the current snapshot:

• GROUNDED — carries a system_grounding block that passes structural validation (_system_grounding_structural_errors, zero errors) AND consistency validation (system_grounding_errors, zero errors vs. the snapshot). A well-formed empty artifacts: [] block is GROUNDED (conformant — nothing to ground).
• UNGROUNDED — carries no system_grounding block at all (a pre-gate atom).
• STALE — carries a block that is present but non-conformant: either structurally malformed (≥1 structural error — checked first, fail-safe) or contradicts the current snapshot (≥1 consistency error). A structurally malformed block is never silently GROUNDED — the consistency validator alone would skip it silently (it assumes the structural floor already ran), so both validators run, structural first.