Method / Dependency Map

Dependency Map

Methodological · Schema FVE-1 V5.5 · Maintained with each schema revision

A technician's reference for understanding what must exist before you can run an instrument, and what breaks when foundational components change. Schema is authoritative — if this page drifts from the schema, flag to KC.

Provenance Chain

Everything downstream depends on this chain being intact. Do not skip steps.

1
ROOT JSON
Locked artifact. Do not modify. Do not recreate.
2
Parameter Signing Tool
Signs new JSON against ROOT or prior parent.
3
Signed parameter JSON
Filename IS the variable code.
4
Codebook Tracker
Registers entry, verifies lineage back to ROOT.
5
Recovery Spine §3
Records active variable code.
6
Baseline Deriver
Loads JSON, confirms SIG VALID, reads parameters.
7
BOWL session
Produces baseline profile with baseline_code + provenance_signature.
8
DRILL / FLIGHT
All sessions carry baseline_code as provenance reference.

Build Order — Prerequisites by Instrument

What must exist before you can run each instrument.

Parameter Signing Tool
operational
Prerequisites
ROOT JSON · Operator ID · Intended parameter values

Run once per research program or per parameter adjustment. Not per session. If active parameter set is already signed and SIG VALID confirmed in deriver — do not re-sign.

Codebook Tracker
operational
Prerequisites
Signed parameter JSON · ROOT JSON registered

Run once per new signed JSON. Lineage must trace back to ROOT. Orphan entries fail at aggregation.

Baseline Deriver
operational
Prerequisites
Signed parameter JSON · SIG VALID confirmed · BOWL CSV export

Loads signed JSON, confirms SIG VALID, derives baseline profile from BOWL session output. Produces baseline_code and provenance_signature.

BOWL (Identity/Register Baseline)
operational
Prerequisites
Parameter signing complete · Codebook entry confirmed · Signed JSON SIG VALID in deriver

First instrument to run on any new model. Output is baseline_code — required for register axis data in all downstream sessions.

DRILL
operational
Prerequisites
BOWL baseline on file · baseline_code confirmed · Gödel, Transformer, and FAST NONE stimuli in registry

Three sessions required. Register axis null without BOWL baseline — log null condition on all register fields. Do not run PyHessian alignment on null-register data.

FLIGHT
operational
Prerequisites
BOWL baseline on file · baseline_code confirmed · All four batch stimuli in registry

16 sessions required. Four batches × four frames. Same model throughout. BOWL baseline required for register axis. Null condition must be logged if baseline missing.

ECM
operational
Prerequisites
Behavioral vocabulary internalized · ECM Resolution Code Coder Guide V3.0

Vocabulary layer. No session prerequisites. ECM quadrant definitions travel into all instrument coding.

Divergence Testing
operational
Prerequisites
Stimulus set (Pair ID, Pair Type, Stimulus A/B) · Fresh sessions per model

Runs 1–3 complete. Stopwatch instrument — point-to-point distance only. Cannot derive trajectory. Runs independently of FVE-1 stack.

BSA
ready
Prerequisites
Divergence Testing scores (Phase 2) · ECM quadrant definitions · Stimulus Registry pair

Schema locked, forms built. Divergence Testing is Phase 2 sub-component — run first for full BSA.

EPG
ready
Prerequisites
Clean session · ELS assignment protocol · ECM quadrant definitions

Independent of FVE-1 stack. Can run anytime with clean sessions.

GG-CSAP
deferred
Prerequisites
Data pipeline automation

Pending data pipeline automation.

PyHessian
deferred
Prerequisites
PyHessian repo · Compute access · Register escape specimens from DRILL or FLIGHT

Pending data pipeline automation. Register escape specimens are generated by DRILL and FLIGHT — flagged in Technician's Read #1 when obs_reg produces RS or RC.

Change Impact Matrix

If you update a foundational component, what else must be reviewed.

If you update: FVE-1 Schema (V5.5)

All FVE-1 instrument pages, HTML tools (Session Logger, DRILL Tool, FLIGHT Tool, SOUP Tool, Baseline Deriver), signed parameter JSON format, codebook entries

If you update: Parameter thresholds (any of the five)

Parameter Signing Tool — create new signed JSON. All downstream sessions must carry new baseline_code. Prior sessions under old parameters are not comparable without explicit stratification.

If you update: ROOT JSON

Do not modify ROOT. ROOT is a locked artifact. Modifying it breaks the entire lineage chain. If ROOT is missing, locate in archive — do not recreate.

If you update: ECM quadrant definitions

BSA protocol, EPG protocol, Divergence Testing protocol, Glossary, all coded data — retroactive recoding required if definitions change

If you update: BOWL stimulus

All existing baseline_codes derived under prior stimulus are not comparable. Treat as a new baseline instrument version. Document the change date as a provenance seam.

If you update: CISP Tier A gates

CISP protocol page, all instrument tier assignment checklists

If you update: Divergence flag thresholds

Divergence Testing protocol page, all prior flagged pair classifications

If you update: Coder Guide (ECM Resolution Code Coder Guide)

All coded data — check for retroactive reclassification. Document version of coder guide active at time of each session in fidelity_notes.

For Technicians — What This Means Day-to-Day

Starting a new model

Run the provenance chain first. Parameter signing → codebook → BOWL → baseline derivation. Do not open a DRILL or FLIGHT session until baseline_code is confirmed.

Running BOWL

This is the baseline session. BOWL output feeds directly into the Baseline Deriver. Signed parameter JSON must be loaded and SIG VALID before derivation. Do not derive under the wrong JSON.

Running DRILL

All three sessions required — Gödel, Transformer, FAST NONE. Do not run PyHessian alignment on null-register data. Register axis is null without a confirmed BOWL baseline.

Running FLIGHT

All 16 sessions required. Four batches × four frames. BOWL baseline required for register axis. Batch and frame sequence are locked — do not reorder.

Running Divergence Testing standalone

Only need stimulus set and fresh sessions. No dependency on FVE-1 stack. Stopwatch instrument — measures distance, not trajectory.

If the schema changes

Check this page. The change impact matrix tells you what else to review. Schema is authoritative — if this page drifts from the schema, flag to KC.

If you find drift between this page and the schema

Flag to KC. Schema is authoritative. This page documents it.

Schema FVE-1 V5.5 · Maintained with each schema revision · Atlas Heritage Systems · KC Hoye, PI