ReNunney/docs/MIGRATION.md

50 lines
1.7 KiB
Markdown

# Migration
## Goal
Move the current cost-of-substitution implementation into `renunney` in staged,
low-risk steps.
## Current State
Operational code still lives in:
- [`../../collaborations/to_ptbc/evc/cost_of_substitution`](/mnt/CIFS/pengolodh/Docs/Projects/collaborations/to_ptbc/evc/cost_of_substitution)
`renunney` currently acts as:
- a clean git repository,
- a run-control wrapper,
- a stable place for deployment and orchestration commands,
- the eventual destination for migrated code.
## Recommended Migration Order
1. Orchestration control plane has been migrated locally:
- `src/renunney/orchestration.py`
- `scripts/run_orchestration.py`
2. Paper-scale Figure 1 submission configs have been copied locally into `config/`.
3. Track 1 runner and API boundary have been migrated locally:
- `scripts/run_track1.py`
- `src/renunney/track1_api.py`
4. Track 1 analysis boundary has been migrated locally:
- `src/renunney/track1_analysis.py`
5. Track 1 threshold/search boundary has been migrated locally:
- `src/renunney/track1_threshold.py`
6. Track 1 simulation kernel has been migrated locally:
- `src/renunney/track1_reference.py`
7. Track 1 report layer has been migrated locally:
- `src/renunney/track1_report.py`
8. Track 1 extinction-model data layer has been migrated locally:
- `src/renunney/track1_extinction.py`
9. Track 1 dataset generator has been migrated locally:
- `src/renunney/track1_dataset.py`
10. Migrate the fit module next:
- `python/track1_fit.py`
11. Reduce or remove the remaining compatibility-layer imports after those modules are local.
12. Migrate docs and example configs last, after path references are updated.
## Constraint
Do not break the ability to run current Figure 1 jobs while migrating code.