docs(link,installer): protocol 4 is live - correct every stale 3
Protocol 4 shipped on 2026-08-19 as sidecar v2.0.0 and overlay v1.0.0, paired in bundle 2026.08.19. Three documents still said 3. INTEGRATION.md contradicted itself: its event catalog fully documents the protocol-4 kinds, including a subsection headed "On Protocol 4", while its normative section 2 still declared X-UOLink-Version: 3, "protocol": 3 in /health and ws.hello, and a worked JS client sending "3". That is the contract a third-party integrator implements against, so it mattered most. Section 2 now states the current version and what shipped it, and gains a v4 paragraph alongside v2 and v3. The "(Protocol 3.0)" markers on individual features are left alone - those record which version introduced a kind and are correct. Two stale examples the audit had not spotted: the --print-config sample reported version 0.1.0, and the minimal browser client told readers to check ev.protocol === 1, a leftover from protocol 1. INSTALL.md is the one that actively misconfigured a real install. Line 413 is the "Protocol version" value an operator pastes into Admin -> Shard, and the document's own troubleshooting table says a stale number comes back as a 409 that "looks exactly like your shard going offline". Corrected along with the stale bundle, overlay and sidecar versions throughout, including Appendix A's copy-pasteable curl commands, which pointed at overlay v0.1.1 and sidecar v1.1.0. v4.md still said the cutover had not happened. It has. Its outstanding- work note said the five-rung shard visibility walk was "outstanding for the cutover", which is now self-contradictory - so it says plainly that the cutover shipped without it and no result is recorded anywhere. guild.roster carries actor objects for every member of every guild, the widest surface any protocol version has added to that check, so it is worth walking against the released pair. No code or contract changes. Every value verified against the Gitea API: link main sidecar/src/main.rs PROTOCOL_VERSION, servuo-plugins overlay.toml, and current.json on the installer bundles branch. Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
11
link/v4.md
11
link/v4.md
@@ -1,7 +1,7 @@
|
||||
# Protocol 4 — Guild membership on the wire
|
||||
|
||||
**Status:** Feature-complete on `edge`. All work lands on an `edge` branch in each repo; `edge` → `main` is the v4 cutover.
|
||||
**Date:** 2026-08-17
|
||||
**Status:** **Shipped.** The `edge` → `main` cutover is done and protocol 4 is live — released as uo-link sidecar **v2.0.0** and plugin overlay **v1.0.0**, paired in bundle **2026.08.19**.
|
||||
**Date:** 2026-08-17; cutover 2026-08-19
|
||||
**Codebase:** ServUO 57.4, `<servuo>`, net48 / x64, Expansion **EJ**.
|
||||
**Companion to** [`PLAN.md`](PLAN.md) (1.0 read/event plane), [`PROTOCOL_2.md`](PROTOCOL_2.md) (2.0 provisioning + world-state streams), [`v3.md`](v3.md) (3.0 shard content + the visibility framework), [`INTEGRATION.md`](INTEGRATION.md) (website API).
|
||||
|
||||
@@ -265,5 +265,8 @@ evidence and neither is a clean boot. What was actually run:
|
||||
Step 2 is what caught the reassembly bug in §3.1: every unit test passed through it, because they all
|
||||
exercised a single-frame roster. The case does not arise until a guild exceeds the cap.
|
||||
|
||||
Still outstanding for the cutover: the five-rung shard visibility walk against a live shard, confirming
|
||||
`acct`/`webId` never reach a caller below their rung.
|
||||
**Still outstanding, and the cutover shipped without it:** the five-rung shard visibility walk against
|
||||
a live shard, confirming `acct`/`webId` never reach a caller below their rung. `guild.roster` carries
|
||||
actor objects for every member of every guild, so it is the widest surface any protocol version has
|
||||
added to that check — the walk is worth doing against the released pair even though v4 is now live.
|
||||
No result is recorded here or in [`../website/SHARD_VISIBILITY.md`](../website/SHARD_VISIBILITY.md).
|
||||
|
||||
Reference in New Issue
Block a user