Make snapshot qualification canonical and byte-exact

[b1rdmania]

Summary

• distinguish raw byte_exact, named normalised, and fuzzy excerpt anchors, including separate verification-metric populations
• classify bounded interstitial/challenge observations as unusable hollow evidence windows and preserve that state through snapshot replay
• add replay-only resolve_snapshot() with raw/canonical identities, one canonical store join, and typed unusable failures
• add hash-bound capture declaration v3 with exact-host retained-query policies and value-free query-policy receipt metadata while preserving v2 replay bytes and hashes
• publish the 0.1.0a15 package version and migration/release documentation

Verification

• python -m pytest -q — 345 passed
• python -m compileall -q groundnut pipeline
• git diff --check
• package smoke check confirms groundnut.__version__ == "0.1.0a15" and the public resolve_snapshot export

The tests cover byte identity, every named normalisation (including en/em dashes), the fuzzy numeric guard, repeated excerpts, serialized method populations, observed eCFR/Federal Register interstitials, Massachusetts/NSF search-form shapes, hollow replay, every snapshot-resolution failure, canonical raw-query joins, retained record keys, host normalization, credential-key redaction, fragments, v2 byte-identical replay, and v3 declaration/receipt tamper detection.

Pipeline boundary

No pipeline repository changes are included or required by this PR. The migration note records the sealed Phase 1/2 qualification and subsequent pipeline cleanup as post-release consumer work; this change does not alter Groundnut's in-repository pipeline/ compatibility package either.

Closes #40

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 342bb7a4-9723-4f4b-98ea-a545044931c3

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}