Files
thesis-prototype-agregation/exploration_v2
willtanoe 7a538e7316 research: add exploration_v2 aggregation diagnosis and confirmation
- Phase 1/2 inventory and diagnosis of the restored 108-run grid
- six candidate aggregators screened on validation (seed 0)
- top-2 confirmed on new seeds 3/4; v_shrink met the pre-registered improvement rule (4/4 pairs, mean +0.0180 validation), v_cap4 did not
- report, tables, frozen plan/ranking hashes, driver scripts and tests
2026-11-02 08:09:29 +01:00
..

exploration_v2

Diagnostic follow-up to the completed 108-run PROTEAN beta grid. Everything in this directory is new; the tracked research code, configs, tests, scripts, results, partition manifests and the immutable research specification are untouched.

Layout

path purpose
PLAN.md pre-registered plan (hash in PLAN.sha256)
PLAN_CHECK.md self-check against the task constraints
CANDIDATES.md Phase 3 candidate catalogue
scripts/ copied runner, variant implementations, ranking/analysis, driver
tests/ unit tests for the variants (baseline and β=0 unchanged)
queue_screen.csv 12 screening runs
queue_confirm.csv generated after the ranking freeze (20 runs)
partitions/ new-seed manifests (seeds 3 and 4)
results/runs/ per-run outputs, logs, COMPLETE markers
analysis/ final CSV tables
REPORT_DATA.md all generated tables (written after confirmation)
REPORT.md narrative report (Phase 6)
ACCESS_LOG.txt every file opened by the validation-only ranking script
HEARTBEAT, state.json, summary.csv driver state
ISSUES.md failures, deviations and permission problems
STOP, DONE stop request / completion marker

Entry points

# start / resume the detached driver in tmux session explore_v2
bash exploration_v2/resume.sh

# short status (returns immediately)
bash exploration_v2/status.sh

# manual re-run of one stage (only when the driver is not running)
.venv/bin/python exploration_v2/scripts/rank_screening.py
.venv/bin/python exploration_v2/scripts/analyze_results.py

The driver is idempotent: it reconstructs queue state from COMPLETE, .failed, .running and live systemd scopes, retries a failed run once from a clean directory, and never kills a process it did not start.