45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
|
# Doc Review: harden-parse-verdict
|
|||
|
|
|
|||
|
|
## Docs touched
|
|||
|
|
|
|||
|
|
- `design/loops/technical.md` §7 — tick-flow step 7 (parse verdict):
|
|||
|
|
added 4-line inline block documenting the defensive coercion (pass
|
|||
|
|
string acceptance; score clamp + NaN/inf/non-numeric → 0.5).
|
|||
|
|
- `design/loops/functional.md` §10 — Verifier Contract: annotated
|
|||
|
|
`pass` (bool) definitive + runner accepts `"true"`/`"false"` strings;
|
|||
|
|
annotated `score` (0.0–1.0) clamp + NaN/inf/non-numeric → 0.5 neutral.
|
|||
|
|
- `CHANGELOG.md` — new `[unreleased]` "Fixed — `parse_verdict`
|
|||
|
|
defensive coercion" block above the existing `add-state-loop-lock` and
|
|||
|
|
`fix-harness-command-template` blocks.
|
|||
|
|
|
|||
|
|
## Docs NOT touched (intentional)
|
|||
|
|
|
|||
|
|
- `AGENTS.md`: parse_verdict is not a user-visible CLI surface; the
|
|||
|
|
hardening doesn't change phase enforcement, `.state.loop`, or any
|
|||
|
|
contract that harness integrators need to know. The Verifier Contract
|
|||
|
|
lives in `design/loops/functional.md` §10; AGENTS.md already points to
|
|||
|
|
design docs at the top. No edit.
|
|||
|
|
- `README.md`: user-facing README doesn't enumerate `parse_verdict`
|
|||
|
|
internals; loop monitoring table mentions verdicts as a concept, not
|
|||
|
|
the parser. No edit.
|
|||
|
|
- `prompts/loop-verifier.md`: contract was already `bool pass` + `score
|
|||
|
|
0.0–1.0`. The hardening is belt-and-suspenders against malformed
|
|||
|
|
output, not a contract change. The prompt's strict-JSON directive
|
|||
|
|
stays authoritative. No edit.
|
|||
|
|
- `templates/loops/self-improvement/loop.json`: no schema change. No
|
|||
|
|
edit.
|
|||
|
|
|
|||
|
|
## Cross-references
|
|||
|
|
|
|||
|
|
- `tasks/add-loop-runner/BUG_REPORT.md` O6 — the original finding —
|
|||
|
|
now closed by this task. The CHANGELOG entry explicitly references it.
|
|||
|
|
- `tasks/add-loop-runner/ADVERSARIAL_BUG_REPORT.md` A6 — the score-
|
|||
|
|
clamping observation — also closed by this task. The CHANGELOG entry
|
|||
|
|
references the clamping.
|
|||
|
|
- `tasks/harden-parse-verdict/BUG_REPORT.md` O3 — notes that clamping
|
|||
|
|
improves plateau detection (a tighter `score_history` range makes
|
|||
|
|
plateau more honest). Cross-referenced from the CHANGELOG.
|
|||
|
|
|
|||
|
|
## Verdict
|
|||
|
|
|
|||
|
|
Docs are in sync with the implementation. Proceed to referee.
|