Skip to content

docs: strengthen v0 citation to cross-implementation evidence#9

Merged
amavashev merged 1 commit into
mainfrom
docs/ap2-omh-cross-impl-citation
May 20, 2026
Merged

docs: strengthen v0 citation to cross-implementation evidence#9
amavashev merged 1 commit into
mainfrom
docs/ap2-omh-cross-impl-citation

Conversation

@amavashev
Copy link
Copy Markdown
Contributor

Summary

Follow-up to #8. The v0 conformance vectors citation landed in #8 qualified as "Independently reproduced under rfc8785@0.1.4" — single-library evidence. The AP2 discussion #262 thread has since escalated to cross-implementation evidence:

Implementation Author(s) Language Result
rfc8785@0.1.4 William Woodruff Python 7/7 JCS + 7/7 hash + 4/4 pair invariants ✓ (per PR #8)
canonicalize@3.0.0 Samuel Erdtman + Anders Rundgren (RFC 8785 author, contributor) JavaScript 7/7 JCS + 7/7 hash + 4/4 pair invariants ✓ (#discussioncomment-16988520)

Different authors, different languages, entirely different codebases — same canonical bytes, same hashes, same pair behaviour for every vector. The Unicode NFC-vs-NFD pair agrees byte-for-byte under both, which is direct evidence that the no-Unicode-normalisation rule is implementation-independent, not an rfc8785@0.1.4 artefact.

One README bullet edited to reflect the strengthened scope. Still qualified as community-seeded, not AP2-spec-blessed.

Why

The single-library wording in #8 was honest at the time but the public AP2 thread now carries the cross-impl validation — keeping the README aligned with the strongest evidence form that's currently in the public record.

Out of scope

  • No public API, wire-shape, or protocol-conformance change. Below the AUDIT.md and CHANGELOG.md update thresholds — no entries added.
  • gowebpki/jcs (Go) as the natural third implementation for an AP2-maintainer-blessed CI matrix remains future work; not in this PR.

Test plan

  • Local cross-impl run: Python rfc8785@0.1.4 + JS canonicalize@3.0.0 against all 7 v0 vectors — 7/7 byte-identical JCS + 7/7 hash match + 4/4 pair invariants under each.
  • Provenance verified: canonicalize@3.0.0 package.json on npm lists Anders Rundgren (RFC 8785 author) as contributor alongside Samuel Erdtman. Repo: erdtman/canonicalize.
  • Public AP2 thread reply (discussioncomment-16988520) posts the same validation evidence the README citation now references.

The README citation landed in #8 with the v0 vectors qualified as
"Independently reproduced under rfc8785@0.1.4" — single-library
evidence. The AP2 discussion #262 thread then escalated to
cross-implementation: both @chopmob-cloud and we now have JS
canonicalize@3.0.0 (erdtman + Rundgren, RFC 8785 author as contributor)
reproducing all 7 vectors byte-for-byte against the Python rfc8785@0.1.4
output. Different authors, different languages, different codebases,
same canonical bytes and hashes on every vector, all four pair
invariants hold under both impls.

Tighten the Background bullet to reflect that strengthened scope. Still
qualified as community-seeded and not AP2-spec-blessed.

No public API, wire-shape, or protocol-conformance change. Below the
AUDIT.md / CHANGELOG.md update thresholds (docs-only pointer).
@amavashev amavashev merged commit 756848b into main May 20, 2026
6 checks passed
@amavashev amavashev deleted the docs/ap2-omh-cross-impl-citation branch May 20, 2026 10:27
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