Module responsibilities¶
Experiment YAML in configs/experiments/ defines a launchable run: source data,
model, representation, resources and fit or test stage. The typed boundary
in graphids/exp/config.py expands inheritance, checks representation agreement,
and rejects retired contracts. graphids/data/config.py and
graphids/models/config.py define CANEventDataConfig and
EventGraphMambaConfig; graphids/data/representation.py defines the
CANEventRepresentationConfig contract. The runtime resolves the YAML types
can_event_dm and event_graph_mamba directly to their config classes.
graphids/data/recordings.py owns reviewed recording/provenance validation.
graphids/data/events.py owns lossless caches, chronological independent-stream
scheduling, and eligible target totals. graphids/data/verify.py owns source
ingestion verification.
graphids/models/event_graph_mamba.py owns continuous learned state,
truncated backpropagation, separately normalized objectives, epoch checkpoints,
and Lightning evaluation hooks. graphids/evaluation.py owns packed frame
scores, recording coverage checks and the evaluation index; it uses only NumPy
and the standard library. Shared exact AP and AUC live in graphids/metrics.py, using one
tied-score ranking pass.
graphids/exp/run.py constructs components and executes a validated run through
Lightning and Ray. graphids/exp/records.py owns saved configuration, authoritative
status/results and lifecycle events. graphids/exp/tracking.py derives MLflow
exports from those records and reads historical offline payloads.
graphids/exp/slurm.py renders single-node jobs, freezes source and submits
dependency-aware jobs. graphids/cli/exp.py exposes these operations.
graphids/callbacks.py provides checkpoint hashes and resource callbacks;
graphids/_mlflow.py owns tracking and system metrics.
The active flow is YAML → typed run → Ray/Slurm launch → Lightning fit/test
→ .graphids/ journal and score artifacts → gx exp ingest.
Training uses one GPU. Snapshot reproduction lives in the verified
archives/snapshot-2026-10-16.tar.gz working-tree archive.