ReNunney/README.md

69 lines
1.5 KiB
Markdown

# renunney
Clean working repository for:
- faithful replication of Leonard Nunney's 2003 cost-of-substitution results,
- orchestration of distributed sweep runs,
- later migration to a faster Rust-backed worker.
## Current Scope
This repository is the clean operational wrapper around the current work in:
- [`../collaborations/to_ptbc/evc/cost_of_substitution`](/mnt/CIFS/pengolodh/Docs/Projects/collaborations/to_ptbc/evc/cost_of_substitution)
The current orchestration and Track 1 simulation code still live there.
`renunney` provides:
- a clean git repo,
- a stable working directory layout,
- a Makefile for common tasks,
- migration notes for pulling code into this repo in stages.
## Layout
- `docs/`
- project and migration notes
- `config/`
- configuration templates and examples
- `runs/state/`
- SQLite registries and persistent orchestration state
- `runs/results/`
- result artifacts collected by orchestration
- `runs/scratch/`
- local worker scratch and cache files
- `src/renunney/`
- future in-repo Python package and migration target
## Start
Initialize the local run directories and SQLite registry:
```bash
make init
```
Submit a paper-scale Figure 1 treatment:
```bash
make submit-figure1-m10
```
Run one worker loop locally:
```bash
make run-loop
```
Collate completed Figure 1 jobs:
```bash
make collate-figure1
```
## Status
The active simulation/orchestration implementation remains in the older
`cost_of_substitution` directory for now. This repo is the clean shell for
running, organizing, and gradually migrating that work.