diff --git a/references/briefs.md b/references/briefs.md index 1e8e55a..3abe82b 100644 --- a/references/briefs.md +++ b/references/briefs.md @@ -106,6 +106,10 @@ test, killed by fixing a degenerate fixture, or equivalent with a one-line reason. A survivor that weakens a rule and cannot be killed is reported, not hidden. Code no tool reaches falls back to `tools/eureka-mutations.ps1`; say why the tool cannot reach it. +A hand mutation hits the rule at the layer it protects: the production call +site, observed where the consequence lands (disk, the kernel, the request +sent). Mutating a helper or an in-memory mirror proves the helper, not the +rule; a later write can hide the deleted one. When a claim is "behaviour unchanged", a value captured from the new code is not evidence. Pin it with a value computed at the base commit. Detached scripts: confirm the log starts within 60 s; a script that dies on a diff --git a/references/changelog.md b/references/changelog.md index 9c1a94e..e47d97e 100644 --- a/references/changelog.md +++ b/references/changelog.md @@ -2,6 +2,16 @@ Record each change to the skill together with the evidence that motivated it. +## 2026-09-22: hand mutations target the rule's layer + +Evidence: in Ghostlight's play agent 8a-fix2 (`74b628d`), Hands reported every +mutation killed, yet Soul found eight rules unguarded. Hands had deleted the +in-memory `record_call` instead of the on-disk persist-before-submit, which +a later persist then hid. It tested `find_handle_collision` directly rather +than its call in `round_tools`, and every test used fresh keys, so +`turn_id = hash(key)` survived. The Hands brief now says to mutate the +production call site and to observe the result where it lands. + ## 2026-09-22: mutation testing moves to the ecosystem's tools Evidence: Aetheria's fire-control campaign carried 23 hand-written harnesses