Files
LithosAnanke/scripts
Claude be456d44e9 fix(v4): #190 POST regenerates the same; #16 sanitizers and hosted-check nightly
Captain Bob, 2026-11-13: "Create the issues then fix them before the long
acceptance test runs"; #16: "Nightly".

#190 -- make -C v4 post79 did not reproduce POST:
- mkpost.py runs v3 with address randomisation off (setarch -R): its
  printed addresses (>IN, FIND) are the same each run, so POST79.md is.
- v4/Makefile post79 builds hosted v3 from this tree's source first and
  uses it, not the lfs/ copy, which can be older.
- post_cases.c and POST79.md regenerated: 539 cases -- LOAD.rest_of_line,
  which v3 gets through since it changed after 2026-10-07. Two runs the
  same. POST_FLOOR 538 -> 539 (#173).
- test_host_unit.c takes the table's count, not 538 typed in the test.

#16 -- scripts/nightly.sh v4-checks: make -C v4 sanitize hosted-check,
logged under logs/<TS>/v4-checks/, refused without qemu-user; nightly.yml
runs it after publishing, before the proofs, installing qemu-user if the
image lacks it.

Evidence (logs/20261113-014927/post79, -024314): before, regenerated with
nothing changed: 539 cases and addresses differing run to run; after: the
same twice, hosted POST 539/539; test, test-32 99 programs 0 failures;
v4-checks 79 programs under the sanitizers 0 failures, the hosted builds
alike. The first verification failed at test_host_unit.c:442 (kept); a
stray v4-checks run stopped at once is kept, labelled (-014453).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
2026-11-13 03:19:24 +00:00
..

scripts/

Utility scripts for building, profiling, DoE experiments, and documentation.

DoE / experiment scripts

Script Purpose
run_doe.sh Run a standard DoE experiment
run_factorial_doe.sh 2^7 factorial DoE
run_factorial_doe_with_heartbeat.sh Factorial DoE with heartbeat metrics
run_nested_doe.sh Nested DoE design
run_ablation_study.sh Physics loop ablation
run_optimization_doe.sh Optimization-focused DoE
run_quick_doe_test.sh Quick smoke-check DoE (1 rep)
extract_doe.sh Extract CSV rows from QEMU serial logs

Build / profile scripts

Script Purpose
perf-profile.sh Linux perf profiling harness
perf-profile_control.sh Control run for perf comparison
rundisk.sh Boot a disk image in QEMU
qemu_screenshot.sh Capture QEMU serial output

Phase 8 / identity testing scripts

Script Purpose
bleach_zuse_img.sh Reset disk/zuse.img back to pristine/unminted (blank) state, for repeatable first-boot mint-flow testing

FORTH capsule scripts

Script Purpose
4th-apply-init.sh Apply init.4th patches to capsule set
4th-update-init.sh Update init.4th across capsule variants

Documentation scripts

Script Purpose
asciidoc-to-latex.sh Convert AsciiDoc to LaTeX
convert-markdown-to-asciidoc.sh Markdown → AsciiDoc
doxygen-xml-to-asciidoc.py Doxygen XML → AsciiDoc
generate-doxygen-appendix.sh Build Doxygen API appendix
build_patent_structure.sh Scaffold patent document structure
setup-ide-integration.sh Configure IDE integration
analyze_heartbeat_stability.R R analysis of heartbeat stability data
analyze_opp2_regression.py Python regression analysis
gen_pe_reloc.py PE relocation table generator (see also tools/)
remove_loop_conditionals.sh Remove loop conditional guards

See also