Skip to content

docs(validation): §2 seam-identity anchors, §3 frozen-artifact policy, §5.2 #23 realtime fallback#147

Merged
dzhelezov merged 2 commits into
mainfrom
docs/validation-refresh-postpublish
Jul 10, 2026
Merged

docs(validation): §2 seam-identity anchors, §3 frozen-artifact policy, §5.2 #23 realtime fallback#147
dzhelezov merged 2 commits into
mainfrom
docs/validation-refresh-postpublish

Conversation

@dzhelezov

Copy link
Copy Markdown
Collaborator

Additive-only refresh of VALIDATION.mdno existing line changed (git diff --stat: 1 file changed, 46 insertions(+), 0 deletions). Three insertion blocks:

Block 1 — §2 Layer A (tail). A **Evidence base version and seam-identity transfer.** paragraph: the §3/§5 byte-diff + A/B evidence was gathered on the 0.16.6 graft; it transfers to the published @subsquid/ponder@0.16.8-sqd.1 artifact by seam identity (byte-identical Portal wiring patch across 0.16.6/0.16.7/0.16.8, each upstream delta off the graft surface), so the paid matrix and soak are deliberately not re-run. Adds three direct anchors on the shipped build: examples freshness gate ran against the published package (#139, done); chaos campaign on a 0.16.8-sqd.1 build (planned); ≥72 h A/B soak leg on 0.16.8-sqd.1 (planned) — the two pending anchors are explicitly not yet claimed as evidence.

Block 2 — §3 preamble. A **Frozen-artifact policy.** 5-item list stating current practice: append-only verdict history (the L-base-logs DIFFER-FAIL → PASS row as model), RETIRED cells stay as rows, PASS-cell durability = reproduce-from-seed, FAIL cells freeze until superseded, re-anchor = new row never overwrite.

Block 3 — §5.2 (tail). One paragraph on the #23 body-cap realtime fallback: the unfiltered full-block eth_getLogs crash was RPC-realtime-only (both Portal paths structurally immune); fixed by #144 (merged f79fda6) with a per-registered-filter fallback + non-retryable marking + empty-fallback validateLogsAndBlock skip mirroring the upstream logs.length > 0 guard; #146 (merged fb8f045) adds the createRealtimeSync e2e test. Realtime remains experimental pending the longer soak.

Link format matches house style ([#N](../../pull/N) / [#N](../../issues/N)); all cited issues/PRs verified real and merged/closed (#23, #33, #139, #144, #146; commits f79fda6/fb8f045). Secret-scan clean. Additive-only, no existing line changed.

🤖 Generated with Claude Code

dzhelezov and others added 2 commits July 10, 2026 19:52
…, §5.2 #23 realtime fallback

Additive-only refresh of VALIDATION.md — no existing line changed:
- §2 Layer A: seam-identity evidence-transfer to 0.16.8-sqd.1 + three
  shipped-package anchors (examples gate #139 done; chaos + soak legs planned).
- §3 preamble: frozen-artifact policy (append-only verdict ledger, RETIRED/PASS/FAIL
  handling, re-anchor = new row).
- §5.2: the #23 body-cap realtime fallback (#144 f79fda6 fix, #146 fb8f045 e2e test).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…wording

glm overclaim seat (accuracy pass): §2 now marks the three shipped-build
anchors 'one landed, two planned' up front (was present-tense 'tie', implying
all three exist); §5.2 corrects the #23 fallback to an over-fetch-never-under-fetch
superset of the logs the registered filters require — not of every log in the
block (a per-filter eth_getLogs is a subset of all block logs).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@dzhelezov dzhelezov marked this pull request as ready for review July 10, 2026 19:58
@dzhelezov dzhelezov merged commit 1d30ed5 into main Jul 10, 2026
12 checks passed
@dzhelezov dzhelezov deleted the docs/validation-refresh-postpublish branch July 10, 2026 19:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant