index.md

pjdoc	version kind scope status revision files 1 spec root draft 24 interface.md comparison.md benchmark.md

hpatch specification

Revision 24 prevents an unchanged target correction from repeating root evaluation while retaining the same recovery baseline for a later different target. doc/spec/interface.md owns the public report grammar, projection rule, continuation semantics, and observable acceptance behavior.

Inventory

• REQ-READ-001: routed verified-row reading and bounded ranges
• REQ-GREP-001: routed ripgrep search with directly editable verified rows
• REQ-PLUGIN-001: router-local custom tools and Code Mode carrier translation
• REQ-SHELL-001: installable free-form script tool and interpreter selection
• REQ-METRICS-001: persistent encoding, command, target, and failure metrics
• REQ-SCRIPT-001: HPATCH/2 grammar and target forms
• REQ-CORRECT-001: rejected-script recovery with ordinary verified-row edits
• REQ-FILE-001: file scope and lifecycle
• REQ-SELECT-001: immutable-baseline target resolution
• REQ-EDIT-001: target-bearing mutation behavior
• REQ-OUTPUT-001: output, validation, and failure behavior
• REQ-COMPARE-001: token comparison scenarios
• REQ-BENCH-001: historical-commit correctness and paired model evaluation
• REQ-GUIDE-001: concise agent guidance

All listed requirements are must-haves for this increment.