Roadmap¶
Delivered¶
| Phase | Capability |
|---|---|
| 0 | Foundation: development log and four ADRs |
| 1 | Packaging, tooling, CI across Python 3.11–3.13 |
| 2 | Canonical in-memory data model |
| 3 | Generic CSV/TSV ingestion and the parser registry |
| 4 | Validation tiers, analysis readiness, structured summaries |
| 5 | Basic scan plotting |
| 6 | AUCX archival container, source checksums |
| 7 | Command-line interface |
| 8 | Alpha-release readiness at 0.1.0a1 |
| — | Deterministic synthetic-data generator |
| — | This documentation site |
Open questions¶
Seven were raised at the outset. Six are resolved:
| Question | Status |
|---|---|
| Q1 — In-archive data encoding | Resolved: NumPy .npy (ADR-0003) |
| Q2 — Canonical units | Resolved: fixed, retained, never converted (ADR-0002) |
| Q3 — Minimum valid-experiment metadata | Resolved: construction invariants plus unambiguous keying (ADR-0002) |
| Q4 — Optical systems in v1 | Resolved: five represented (ADR-0002) |
| Q5 — Provenance schema and checksum algorithm | Resolved: SHA-256, per-source entries (ADR-0003) |
| Q6 — Documentation tooling | Resolved: MkDocs Material — this site |
| Q7 — CLI command surface | Resolved: six commands with documented exit codes |
Candidates, not commitments¶
- Vendor-format readers. Each needs a documented, non-reverse-engineered specification before any parsing code is written. See Scientific boundaries.
- Sample-to-scan linkage (
sample_idonScanMetadata). - Heterogeneous per-scan signal units.
- An
acquired_atfield in the manifest schema. - Third-party parser discovery through entry points.
- A coverage gate before the first alpha release.
Never¶
Scientific analysis, quality control, unit conversion and physical simulation are permanent non-goals, not deferred work.