fix: check F audits the candidate in a TestPyPI rehearsal, reports the released bootstrap as WARN #229

Affected Repositories

• PyAutoHeart (primary)

Branch Survey

Suggested branch: feature/colab-gate-candidate-audit

Implementation Steps

1. heart/checks/verify_install.sh check_f, only when TARGET_VERSION is set: after the verbatim setup-cell driver succeeds, (a) run colab_gate.py verify once as the RELEASED facet, advisory only, capturing its detail and the installed autonerves version from the report's packages block; (b) re-pin: pip install --no-deps "${PIP_INDEX_ARGS[@]}" autonerves==$T autofit==$T autoarray==$T autogalaxy==$T autolens==$T, then importlib.reload(autonerves.setup_colab) and pip install --no-deps of _PROJECTS["autolens"]["packages"] (mirrors _colab_setup, does not call setup() again); fold the COLAB_GATE_AUTONERVES_SRC overlay into this step as an extra overlay after the re-pin; (c) run colab_gate.py verify again into a second report as the CANDIDATE facet with today's FAIL semantics; (d) RESULTS rows: candidate FAIL → F|FAIL|<detail>; candidate pass + released failed → extra row F|WARN|released Colab bootstrap (autonerves=<ver>) broken for readers: <detail>; candidate passes, then the notebook cell and F|PASS as today; (e) the results table prints WARN rows, n_fail counts only FAIL so ready stays true on WARN, n_warn joins the Overall line, both gate reports go into the sidecar (VI_F_GATE_VERIFY candidate + new VI_F_GATE_VERIFY_RELEASED), header comment and usage text updated.
2. heart/readiness.py install block: no verdict change for WARN; a comment records that WARN is verdict-neutral by decision 2026-09-17 (a broken released bootstrap is not evidence against shipping; the release is the remedy).
3. heart/dashboard.py Install verify section: ready true + any check WARN → section WARN, summary passed with warnings (<index>; <letters>), WARN details as detail lines. FAIL / find-links unchanged.
4. heart/checks/colab_gate.py: no behaviour change expected (verify already takes --report-json).
5. Tests: tests/test_verify_install_script.py (usage text mentions WARN + rehearsal re-pin; sidecar snippet turns F|WARN|... into status WARN with ready true when no FAIL), tests/test_readiness.py (checks [F PASS, F WARN] ready true → no red, no yellow; ready false with FAIL still red), tests/test_dashboard.py (WARN row renders WARN; FAIL still FAIL).
6. Docs: verify_install.sh header, skills/verify_install/verify_install.md, docs/release_validation.md check F paragraph, health_agent/capabilities.yaml measures line.

Witness (red first; needs python3.12)

bash heart/checks/verify_install.sh F --testpypi --version 2026.9.17.1.dev77201 --report-json /tmp/vi.json

Before: the verify line shows autonerves=2026.9.15.1 and F FAIL. After: released facet → F WARN (6 missing), candidate facet → autonerves=2026.9.17.1.dev77201, F PASS, ready true. Negative control: no --version → one verify, unchanged. Then pytest tests/test_verify_install_script.py tests/test_readiness.py tests/test_dashboard.py.

Key Files

• heart/checks/verify_install.sh — check F driver, results table, sidecar writer
• heart/readiness.py — install-verification leg of the verdict
• heart/dashboard.py — Install verify section
• heart/checks/colab_gate.py — the gate's seed/verify commands

PyAutoMind/draft/bug/pyautoheart/colab_gate_rehearsal_audits_released_bootstrap.md (Mind commit 92e7c04) — "Check F audits the released Colab bootstrap in a TestPyPI rehearsal, not the candidate". Type: bug; Target: PyAutoHeart; Difficulty: moderate; Autonomy: supervised; Priority: high; Consequence: block. Related: PyAutoHeart#228, PyAutoNerves#168, PyAutoNerves#169.