# Scripts

The operational source of truth is `docs/current/operations.md`. Canonical
workflow behavior lives in the two root config workflows; runner code is generated
from `scripts/render_workflow_scripts.py`.

Active entry points:

- `generated_chart_workflow.py` — validate, run, evaluate, continue, and batch.
- `chartsmith_evaluator.py` — tiered evaluation and promotion summaries.
- `benchmark_full_process.py` — full redesign plus independent validation.
- `nodebench.py` — deterministic node-local optimization.
- `search_design_references.py` — retrieve local design references.
- `source_design_references.py` — source and catalogue new references.
- `build_repo_manifests.py` — repository, config, and run inventories.
- `validate_repo_state.py` — front-door, path, and boundary validation.

Experimental candidate entry points:

- `chartsmith_vnext.py` — bounded image-only persuasion-first vNext runner.
- `model_invocation.py` — shared Codex CLI, Responses API, and GPT Image
  invocation boundary.

`generated_chart_workflow.py` must not be hand-edited. Regenerate and validate:

```powershell
python scripts\render_workflow_scripts.py
python scripts\generated_chart_workflow.py validate --workflow config\chart_redesign_workflow.yaml
python scripts\generated_chart_workflow.py validate --workflow config\chart_evaluation_workflow.yaml
```

New payloads default to `runs/build_week/`. Files under `scripts/experiments/`
are bounded noncanonical schedulers, and archived scripts live under
`archive/pre_build_week/scripts/`.
