ReNunney/README.md

1.7 KiB

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:

The Track 1 simulation backend still lives there. The orchestration control plane is now local to renunney.

renunney provides:

  • a clean git repo,
  • a stable working directory layout,
  • a local orchestration CLI and library,
  • 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:

make init

Submit a paper-scale Figure 1 treatment:

make submit-figure1-m10

Run one worker loop locally:

make run-loop

Collate completed Figure 1 jobs:

make collate-figure1

Status

The current state is split:

  • orchestration control plane: local to renunney
  • Track 1 simulation backend: still in the older cost_of_substitution directory

This repo is now the clean operational entry point while the simulation code is migrated in later stages.