Skip to content

feat(fixture): the ADR-013 §10 golden fixture — canonical bytes + generator + tests#100

Merged
Polichinel merged 1 commit into
developmentfrom
feat/wire-contract-golden-fixture
Jul 15, 2026
Merged

feat(fixture): the ADR-013 §10 golden fixture — canonical bytes + generator + tests#100
Polichinel merged 1 commit into
developmentfrom
feat/wire-contract-golden-fixture

Conversation

@Polichinel

Copy link
Copy Markdown
Collaborator

Build leg 2e — the contract's executable spec, at its canonical source (§10.1). Both other repos build against these bytes: pipeline-core's vendored fixture-parity test (flagged on closed #269) and faoapi epic S8.

  • tests/fixtures/wire_contract/ — Track-A shard, Hop-A manifest (E1: sidecar_sha256: null), Hop-B arrow shard (sample column = the §4.5(b) ordering oracle), §5.1 sidecar (NaN-GAUL row preserved, pinned), Hop-B run manifest (sidecar hash lives here, per E1). 1 run × 1 target × 1 month × 6 cells × S=4.
  • Root hash (SHA-256 of SHA256SUMS): b1f3878df9ef74b25dce53a070e1711db39dfdf1c6ca3e1f5a716875ceb32f44 — the cross-repo contract per §10.1.
  • Deterministic generator (scripts/build_wire_fixture.py): injected provenance (§10.2), fixed seed, pinned zip timestamps; rebuild-identical (verified). Tool versions pinned in the fixture README.
  • 7 conformance tests incl. byte-level header parity across both envelopes and the §6 policy-gate pass on the fixture's own payload.

Refs: ADR-013 §10/§10.1/§10.2 + Erratum E1; pipeline-core#269 (vendoring follow-through); faoapi#100 S8.

…erator + conformance tests

The wire contract's executable spec, published at its canonical source
(tests/fixtures/wire_contract/): Track-A shard (zip: y_pred (6,4) float32 +
identifiers + byte-pinned §2 header), Hop-A manifest (E1: sidecar_sha256 null),
Hop-B arrow shard (views_frames.io.arrow; sample column = the §4.5(b) ordering
oracle), the §5.1 sidecar (9 pinned columns, NaN-GAUL row preserved), and the
Hop-B run manifest (one per run, sidecar hash lives here per E1).

Deterministic generator (scripts/build_wire_fixture.py): injected provenance
literals (§10.2), fixed seed, pinned zip timestamps — rebuild reproduces the
bytes (verified). Root hash pinned in the fixture README + ADR-013 post-adoption
record: b1f3878df9ef74b25dce53a070e1711db39dfdf1c6ca3e1f5a716875ceb32f44.
Consumers vendor + hash-test per §10.1; the committed bytes are canonical.

Deliberate pins: values row 0 draw-degenerate (§6 per-row rule), lr_ged_sb
vocabulary (§7a), header parity across both envelopes tested byte-level.
7 conformance tests; ruff clean; 152 passed, 43 xfailed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Polichinel Polichinel merged commit fc873b6 into development Jul 15, 2026
3 of 4 checks passed
@Polichinel Polichinel deleted the feat/wire-contract-golden-fixture branch July 15, 2026 18:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant