Skip to content

Compare page: list xNet as a protocol; fix sync-layer framing - #299

Merged
crs48 merged 4 commits into
mainfrom
claude/0236-compare-page-xnet-placement
Jun 27, 2026
Merged

Compare page: list xNet as a protocol; fix sync-layer framing#299
crs48 merged 4 commits into
mainfrom
claude/0236-compare-page-xnet-placement

Conversation

@crs48

@crs48 crs48 commented Jun 27, 2026

Copy link
Copy Markdown
Owner

What

Implements docs/explorations/0236_[x]_COMPARE_PAGE_XNET_PLACEMENT_IN_SYNC_AND_PROTOCOL_LAYERS.md.

Answers the question "shouldn't xNet be listed under sync engines and protocols on the compare page?" — and the answer turned out to be yes for Protocols, and the Sync note was wrong and needed fixing.

Protocols & P2P primitives layer

  • Adds xNet as a highlighted row. xNet ships a written, conformance-tested protocol (data model · replication · authorization) at the same altitude as AT Protocol and Matrix — both already rows in this layer, and both already named on the home page's OpenProtocol section ("an open protocol… like Matrix or the AT Protocol"). The compare page had been silently omitting xNet, contradicting our own marketing.
  • Adds an xnet-kernel footnote (signed, hash-chained LWW change log; reference Python kernel + conformance corpus; hub-to-hub federation noted as roadmap, not shipped).
  • Upgrades the layer note to state xNet is both a consumer of primitives (WebRTC, DID:key, UCAN) and a provider of its own protocol.

Sync engines & embedded databases layer

  • No new row — xNet's store+sync is adopted as the framework (already a row in the Frameworks layer), not as a drop-in under an existing app.
  • Rewrites the intro so the existing own-store entries (Turso, Ditto) stop contradicting the framing. The old note said "xNet doesn't compete here — it brings its own store", but Ditto and Turso also bring their own store and are listed. New criterion: "not a drop-in sync layer under an existing app."

Substrates layer

  • Unchanged by design — xNet is a genuine consumer of Yjs there, not a peer; the existing note is correct.

Decisions

  • License/maturity: the row uses MIT / pre-release (all xNet packages + repo are MIT; corrected the exploration's placeholder MIT / Apache-2.0).
  • Highlight vs reference row: chose highlight: true for consistency with the other "this is xNet" rows; the upgraded note keeps it from over-claiming.

Verification

  • pnpm --filter site validate:comparecompare.ts OK: 5 layers, 44 rows, 35 chips (+1 row).
  • pnpm --filter site build → 93 pages built; rendered /compare HTML contains the xNet protocols row (App + data protocol, Signed, hash-chained LWW change log), the footnote, and the corrected sync note (no more "doesn't compete here").
  • Full test suite re-run green (865 files / 9579 tests); pre-push flake was unrelated (site/ data isn't in any vitest project).

🤖 Generated with Claude Code

xNet Test and others added 4 commits June 27, 2026 12:11
…ol layers

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

Add xNet as a highlighted row in the Protocols & P2P primitives layer of
/compare — it ships a written, conformance-tested protocol (data model ·
replication · authorization), the same altitude as AT Protocol and Matrix,
which the home page already benchmarks against. Adds an xnet-kernel footnote
(signed hash-chained LWW change log; federation noted as roadmap) and upgrades
the layer note to state xNet is both a consumer of primitives and a provider.

Rewrite the Sync engines & embedded databases intro so the 'own-store' projects
already in the table (Turso, Ditto) no longer contradict the framing: the
exclusion criterion is 'not a drop-in sync layer under an existing app', not
'brings its own store'.
@crs48
crs48 temporarily deployed to pr-299 June 27, 2026 19:22 — with GitHub Actions Inactive
@github-actions

github-actions Bot commented Jun 27, 2026

Copy link
Copy Markdown
Contributor

Preview removed for PR #299.

github-actions Bot added a commit that referenced this pull request Jun 27, 2026
@crs48
crs48 merged commit 01f01f2 into main Jun 27, 2026
13 checks passed
@crs48
crs48 deleted the claude/0236-compare-page-xnet-placement branch June 27, 2026 19:36
github-actions Bot added a commit that referenced this pull request Jun 27, 2026
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