XZBT-NGN/test-fixtures/PROVENANCE.md

Reference fixture provenance

The owner selected the abacusai set on 2026-09-13. The source is G:/.vibe/SciFi-XZBT/exhibit-test/abacusai/reference-exhibits/. Only the three exhibit directories, shared dependencies, and upstream README were copied. The external source is unchanged.

These files are NGN test fixtures, not product code. Their upstream README describes upstream verification and is not evidence of NGN verification.

Local compatibility corrections:

• Eight read-only descriptors used kind: telemetry, which is not one of Contract 5.2's four kinds. They now use kind: state with their existing value types; IDs and backing readings are unchanged.
• Planetarium's action argument metadata was named args; it is now named arguments under the owner's 5.2 clarification.
• The shared fixture invoke path now enforces declared argument types, required fields, allowed keys, enums, and numeric/string constraints.
• Planetarium's magnitude reader and native dispatch still used the old camelCase ID. They now match its existing canonical sky.magnitude-limit descriptor, fixing a null snapshot value and failed native writes.
• Final Step 5 closure: Haunted House's haunt-level reader now clamps to 0–1 and rounds to integer hundredths, matching its unchanged 0.01 descriptor step. The internal drifting simulation and Manifest behavior remain continuous; snapshots and mutation events share this normalized reader. Previously the reader rounded to thousandths and could report off-step values.

NGN has no fixture-specific target logic. These corrections apply only to the local fixture copies. No upstream fixes or independent conformance certification are claimed.

Step 6.7B resync (2026-09-15)

The scifi/ fixture was resynced from the real SciFi-XZBT exhibit source at G:/.vibe/SciFi-XZBT/ after that repo's Step 6.7B implementation (SciFi Observation Surface Integration, docs/architecture/XZBT-NGN-Step6.7A-SciFi-Observation-Surface.md).

Copied files (byte-for-byte from source, no fixture-local corrections):

• index.html — two new <script> tags for surface-mode.js/surface-bus.js
• js/app.js — boot-mode resolution, console/observation branching, the surface-attachment bus wiring, view.pillars/view.warp-flight routing
• js/contract-adapter.js — surfaces/instanceId constructor options, the view.pillars/view.warp-flight targets, onLocalChange/onLocalAction hooks, describe()'s conditional surfaces field, version bump to 5.3.0
• js/observation-engine.js — WARP/PILLARS dock buttons now route through onMutation (matching the existing VIEWPORT/RED ALERT/PRESET pattern) instead of mutating engine state directly
• css/style.css — additive body.surface-observation rules
• js/surface-mode.js (new) — boot-mode resolver + surface catalog
• js/surface-bus.js (new) — instance-scoped BroadcastChannel sync

No fixture-local corrections were added on top of this resync; the fixture is a faithful mechanical copy of the source as it stood after Step 6.7B. js/audio.js, js/config.js, js/core-animations.js, js/visualizer.js, js/observation-bezels.js, js/generative-experience.js, and js/control-bus.js were not touched by Step 6.7B and were not recopied. dist/ was not regenerated (no PowerShell available in the environment that performed this resync); it still reflects a pre-6.7B build and should be rebuilt from source before any test or procedure that opens the packaged file.

SciFi adapter handshake correction (2026-09-15)

Correction to the record above: the Step 6.7B resync note listed a "version bump to 5.3.0" for js/contract-adapter.js, but no such bump was present in the file as resynced — it still read version = '5.2.0' / contractMinor = 2. The adapter also still carried a pre-5.3 inbound gate in _setupWindowBridge:

if (!e.data || typeof e.data !== 'object' || e.data.xzbt !== '5.2') return;

That is an exact-string comparison against the advisory xzbt field, which Contract 5.3 §6.5 designates as diagnostics-only metadata ("The negotiated session contract major/minor is authoritative after handshake"). Because XZBT-NGN's host stamps outgoing envelopes xzbt: '5.3' (Step 6.3), the gate silently dropped every host message — including hello — and NGN's handshake timed out against this exhibit (tests/postmessage-interop.test.js, four tests).

Two source-side corrections were made in G:/.vibe/SciFi-XZBT/js/contract-adapter.js and then copied here verbatim, keeping the one-directional source -> fixture flow this file documents:

1. The inbound filter now checks the advisory field's presence and type (typeof e.data.xzbt !== 'string'), matching how XZBT-NGN's host validates the same field. It no longer branches on any particular value, so the field cannot act as a compatibility gate for any sender.
2. The adapter advertises the contract it actually implements: contractMinor 2 -> 3 and the exhibit product version '5.2.0' -> '5.3.0' (its describe() already emitted the Contract 5.3 surfaces field added by Step 6.7B). The file header now reads "Specification v5.3" to match.

The outbound advisory xzbt: '5.2' stamps on this adapter's own envelopes were deliberately left unchanged: §6.5 makes the value non-authoritative, Step 6.7B documented the envelope as unchanged, and no receiver — NGN included — reads that value for admission. dist/ remains a stale generated artifact and was not regenerated.

Resynced file (source and fixture byte-identical, SHA-256 10ED30527153D5B30F23557BA6EC427884D470AB6561AC33C47E7F17AFA28DD9):

• js/contract-adapter.js