core/docs/decisions/ADR-0100-physics-reasoning-capable-ratification.md
Shay b9a6f2ddb5 feat(packs): ADR-0100/0101/0102 — three sibling domain ratifications
Ratifies the remaining three sibling domains as reasoning-capable
under ADR-0091's Domain Pack Contract v1, using the template
ADR-0097 established for mathematics_logic. The capability ledger
now has four reasoning-capable rows backed by validated contracts.

ADR-0100 physics (en_physics_v1):
  domain_id: physics
  claimed_operators: causal, modal
  teaching_chains: [physics_chains_v1]
  eval_lanes: foundational_physics_ood, inference_closure,
    fabrication_control
  9/9 predicates pass

ADR-0101 systems_software (en_systems_software_v1):
  domain_id: systems_software
  claimed_operators: transitive, causal
  teaching_chains: [systems_software_chains_v1]
  eval_lanes: symbolic_logic, inference_closure, fabrication_control
  9/9 predicates pass

ADR-0102 hebrew_greek_textual_reasoning (FIRST MULTI-PACK ratification):
  domain_id: hebrew_greek_textual_reasoning
  claimed_operators: causal, contradiction
  teaching_chains: [hebrew_greek_textual_reasoning_chains_v1]
  eval_lanes: inference_closure, fabrication_control
    (universal lanes only — language-specific fluency lanes lack
    holdout splits; a separate ADR adds those when holdouts ship)
  packs: grc_logos_micro_v1, grc_logos_cognition_v1,
    he_logos_micro_v1, he_core_cognition_v1
  all four pack contracts identical (uniformity invariant pinned);
  all four 9/9 predicates pass
  pre-existing gap: hebrew/greek manifests lacked a provenance field
  entirely; ratification fills that uniformly across the four packs

44 new ratification tests in test_adr_0100_0102_sibling_ratifications.py:
- 6 parametrized 9-predicate validation tests (one per pack)
- 21 per-domain ledger status assertions (status, reasoning_capable,
  expert_demo gated, no_open_gaps, provenance points at correct ADR,
  operator_chain_coverage, intent_shapes minimum) — 7 cases × 3 domains
- 15 per-domain contract field shape assertions (teaching_chains,
  eval_lanes, splits coverage, axioms/rules null, primary reviewer) —
  5 cases × 3 domains
- 2 ADR-0102 multi-pack uniformity invariants (all four packs carry
  the contract; contracts identical across packs)

Capability ledger after ratification:
  systems_software           : reasoning-capable
  mathematics_logic          : reasoning-capable
  physics                    : reasoning-capable
  hebrew_greek_textual_reasoning : reasoning-capable
  philosophy_theology        : reasoning-capable (no contract; pre-existing)

Lane SHA pin update:
- public_demo pin refreshed (21751aaf.. → 71090323..) — the
  ratification adds new manifest fields (provenance,
  domain_contract_*) that surface in pack-related demo paths;
  intentional ADR-tracked change per the verifier doctrine

Smoke 67/67, packs 6/6, sibling ratifications 44/44, cognition eval
byte-identical 100/100/100/100; all 6 lanes match pinned SHAs:
  reviewer_registry            681a2aab..
  miner_loop_closure           9f071733..
  domain_contract_validation   f9c06cde..
  fabrication_control_summary  01e1b6b7..
  demo_composition             27d83824..
  public_demo                  71090323..
2026-05-21 20:25:48 -07:00

3 KiB

ADR-0100 — Physics Reasoning-Capable Ratification

Status: Proposed Date: 2026-05-21 Author: CORE agents + reviewers Depends on: ADR-0091, ADR-0092, ADR-0093, ADR-0096, ADR-0097


Context

The physics substrate is structurally complete:

  • language_packs/data/en_physics_v1/ ships with manifest, lexicon, glosses.
  • teaching/domain_chains/physics_chains_v1.jsonl exists.
  • evals/foundational_physics_ood/ exists with dev/public/holdouts.
  • docs/gaps.md marks every physics gap closed: gap:physics_pack_absent, gap:physics_causal_chains_below_threshold, gap:physics_modal_chains_below_threshold, gap:physics_intent_shapes_below_threshold — all [x].
  • Chain coverage: causal=8, modal=8 (≥8 per claimed operator family ✓); five intent shapes populated (cause, comparison, correction, procedure, verification — ≥3 ✓).

What's missing is the ADR-0091 formal ratification step, matching the template established by ADR-0097 for mathematics_logic.


Decision

Ratify en_physics_v1 as reasoning-capable under ADR-0091 by emitting the contract fields into its manifest and passing core capability domain-contract validate en_physics_v1.

Manifest additions

{
  "domain_contract_version": 1,
  "domain_id": "physics",
  "axioms": null,
  "rules": null,
  "teaching_chains": ["physics_chains_v1"],
  "eval_lanes": [
    {"lane": "foundational_physics_ood", "version": "v1",
     "splits": ["dev", "public", "holdout"]},
    {"lane": "inference_closure", "version": "v1",
     "splits": ["dev", "public", "holdout"]},
    {"lane": "fabrication_control", "version": "v1",
     "splits": ["dev", "public", "holdout"]}
  ],
  "reviewers": ["shay-j"],
  "known_gaps": [],
  "provenance": "adr-0100:reviewed:2026-05-21"
}

Claimed operator families (DOMAIN_OPERATOR_CLAIMS): causal, modal. axioms and rules stay null at v1 — physics demonstrates reasoning through reviewed causal/modal chain composition, not declarative axioms.

What this ADR does not do

  • Does not introduce new lemmas, chains, or evals.
  • Does not promote to expert-demo.
  • Does not modify runtime mount behavior.

Invariant

physics_reasoning_capable_ledger_rowcore capability ledger emits a row for domain_id: physics with status: reasoning-capable, provenance pointing at this ADR, and expert_demo: False until a future ADR attaches the required audit-tour-equivalent reports.


Lane

No new lane. The four existing lanes carry the evidence:

  • foundational_physics_ood/ (positive coverage)
  • inference_closure/ (composition)
  • fabrication_control/ (negative control, ADR-0096)
  • evals/domain_contract_validation/ (ADR-0093 confirms predicates fire)

PR Checklist

  • Capability added: second ratified reasoning-capable domain.
  • Invariant proved: physics_reasoning_capable_ledger_row.
  • Hidden normalization / stochastic fallback / approximate recall / unreviewed mutation: none.
  • Trust boundary: manifest edit through reviewed flow; checksums unchanged.