Skip to content

Add Stage 2 saved-run artifact loaders and readiness reports#143

Merged
anth-volk merged 12 commits into
mainfrom
codex/stage-2-manifest-fixes-20260601
Jun 1, 2026
Merged

Add Stage 2 saved-run artifact loaders and readiness reports#143
anth-volk merged 12 commits into
mainfrom
codex/stage-2-manifest-fixes-20260601

Conversation

@anth-volk
Copy link
Copy Markdown
Contributor

Fixes #142

Summary

Follow-up to the canonical US runtime stage taxonomy proposed in #20.

This adds the Stage 2 saved-run artifact/readiness layer:

  • extends stage artifact contracts with path hints, formats, hash modes, and resume roles
  • writes typed per-stage output manifests under stage_artifacts/manifests/
  • writes stage_manifest.json, stage_artifacts/artifact_inventory.json, and stage_artifacts/conditional_readiness.json from saved artifact bundles
  • adds stage artifact loaders, checked path resolution, hashing, and readiness classification helpers
  • wires the saved-run artifacts into versioned artifact saving, PE-US-data checkpoint evidence, backfill paths, experiment summaries, data-flow snapshots, and docs/API exports
  • tightens stage input/output validation, explicit override handling, Stage 8 dataset completeness, and Stage 9 evidence/summary handling
  • adds contract/schema alignment tests so contract outputs/artifacts stay aligned with typed stage manifests

Out of scope

  • live manifest updates during the canonical build
  • start-of-stage runtime gates
  • automatic conditional execution or scheduling
  • partial resume inside calibration/synthesis
  • statistical/modeling behavior changes

Validation

Local focused checks after rebasing on origin/main:

  • ruff format --check src/microplex_us/pipelines/stage_run.py tests/pipelines/test_stage_run.py
  • ruff check src/microplex_us/pipelines/stage_run.py tests/pipelines/test_stage_run.py
  • /opt/miniconda3/bin/python -m py_compile src/microplex_us/pipelines/stage_run.py tests/pipelines/test_stage_run.py
  • git diff --check

Local limitation: targeted pytest collection is blocked in this environment by ModuleNotFoundError: No module named 'microplex'; uv run pytest is also blocked by the macOS x86_64 torch==2.11.0 wheel resolution issue encountered earlier.

@anth-volk anth-volk marked this pull request as ready for review June 1, 2026 18:18
@anth-volk anth-volk merged commit 0943beb into main Jun 1, 2026
5 checks passed
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.

Add Stage 2 saved-run artifact loaders and readiness reports

1 participant