Phase 864 (v0.8.831): production matrix gossip outbox docs

PLATFORM_ROADMAP Phase 864 (50/50), RELEASE_v0.8.831, mesh documentation.

Co-authored-by: Cursor <[email protected]>

AGENTCTL.md

@@ -2,6 +2,8 @@
 
 Autonomous agents and developers use **agentctl** to operate a running Pearcord desktop session or a headless in-process session — the same IPC contract as the UI ([IPC.md](./IPC.md)).
 
+**v0.8.831 (Phase 864):** `runGuildMeshMultiGuildProductionGossipJourney` (production matrix + gossip). Bundle: `npm run test:ci-phase864`.
+
 **v0.8.830 (Phase 863):** `runGuildMeshMultiGuildProductionMatrixJourney` (production matrix + replication lag). Bundle: `npm run test:ci-phase863`.
 
 **v0.8.829 (Phase 862):** `runGuildMeshMultiGuildScaleDmCompositeJourney` (multi-guild scale + DM composite). Bundle: `npm run test:ci-phase862`.

MESH_STABILITY.md

@@ -2,6 +2,8 @@
 
 Live mesh stability tooling for Pearcord guild Hyperswarm clusters: bandwidth fair-share, ACK-driven push halt interaction with sparse batches, offline recovery bursts, and multi-peer agentctl journeys.
 
+**v0.8.831 (Phase 864):** Multi-guild production matrix + gossip outbox — `runGuildMeshMultiGuildProductionGossipJourney`, `sync-guild-mesh-multi-guild-production-gossip`, matcher `meshMultiGuildProductionGossipReady`. Bundle: `npm run test:ci-phase864`.
+
 **v0.8.830 (Phase 863):** Multi-guild production matrix + replication lag — `runGuildMeshMultiGuildProductionMatrixJourney`, `sync-guild-mesh-multi-guild-production-matrix`, matcher `meshMultiGuildProductionMatrixReady`. Bundle: `npm run test:ci-phase863`.
 
 **v0.8.829 (Phase 862):** Multi-guild scale + DM-during-heal composite — `runGuildMeshMultiGuildScaleDmCompositeJourney`, `sync-guild-mesh-multi-guild-scale-dm-composite`, matcher `meshMultiGuildScaleDmCompositeReady`. Bundle: `npm run test:ci-phase862`.

MODULES.md

@@ -2,7 +2,7 @@
 
 All **`pearcord-*`** packages under `modules/`. Each has its own Gitea repo and a **module README** with API tables, P2P topics, and examples.
 
-**App release:** v0.8.830 · **Platform facade:** `pearcord-platform` ([PLATFORM_MIXINS.md](./PLATFORM_MIXINS.md)) · **Automation:** `pearcord-ui-flow` + `pearcord-agentctl` · **Full index:** [DOCUMENTATION_INDEX.md](./DOCUMENTATION_INDEX.md). Guild mesh: [PRODUCTION_MESH.md](./PRODUCTION_MESH.md) (`test:ci-phase863`, `test:ci-phase862`, `test:ci-phase861`, `test:ci-phase860`, `test:ci-phase859`, `test:ci-phase858`, `test:ci-phase857`, `test:ci-phase856`, `test:ci-phase855`, `test:ci-phase854`, `test:ci-phase853`, `test:ci-phase852`, `test:ci-phase851`, `test:ci-phase850`, `test:ci-phase849`, `test:ci-phase848`, `test:ci-phase847`, `test:ci-phase846`, `test:ci-phase845`, `test:ci-phase844`, `test:ci-phase843`, `test:ci-phase842`, `test:ci-phase841`, `test:ci-phase840`, `test:ci-phase839`, `test:ci-phase838`, `test:ci-phase837`, `test:ci-phase836`, `test:ci-phase835`, `test:ci-phase834`, `test:ci-phase833`, `test:ci-phase832`, `test:ci-phase831`, `test:ci-phase830`, `test:ci-phase829`, `test:ci-phase828`, `test:ci-phase827`, `test:ci-phase826`, `test:ci-phase825`, `test:ci-phase824`, `test:ci-phase823`, `test:ci-phase822`, `test:ci-phase821`, `test:ci-phase820`, `test:ci-phase819`, `test:ci-phase818`, `test:ci-phase817`, `test:ci-phase816`, `test:ci-phase815`, `test:ci-phase814`, `test:ci-phase813`, `test:ci-phase812`, `test:ci-phase811`, `test:ci-phase810`, `test:ci-phase809`, `test:ci-phase808`, `test:ci-phase807`, `test:ci-phase806`, `test:ci-phase805`, `test:ci-phase804`, `test:ci-phase803`, `test:ci-phase802`, `test:ci-phase801`, `test:ci-phase800`, `test:ci-phase799`, `test:ci-phase798`, `test:ci-phase797`, `test:ci-phase796`, `test:ci-phase795`, `test:ci-phase794`, `test:ci-phase793`, `test:ci-phase792`, `test:ci-phase791`, `test:ci-phase790`, `test:ci-phase789`, `test:ci-phase788`, `test:ci-phase787`, `test:ci-phase786`, `test:ci-phase785`, `test:ci-phase784`, `test:ci-phase783`, `test:ci-phase782`, `test:ci-phase781`, `test:ci-phase780`). Members: [MEMBERS.md](./MEMBERS.md). Settings/roles/permissions: [SETTINGS.md](./SETTINGS.md), [ROLE_EDITOR.md](./ROLE_EDITOR.md), [PERMISSIONS.md](./PERMISSIONS.md).
+**App release:** v0.8.831 · **Platform facade:** `pearcord-platform` ([PLATFORM_MIXINS.md](./PLATFORM_MIXINS.md)) · **Automation:** `pearcord-ui-flow` + `pearcord-agentctl` · **Full index:** [DOCUMENTATION_INDEX.md](./DOCUMENTATION_INDEX.md). Guild mesh: [PRODUCTION_MESH.md](./PRODUCTION_MESH.md) (`test:ci-phase864`, `test:ci-phase863`, `test:ci-phase862`, `test:ci-phase861`, `test:ci-phase860`, `test:ci-phase859`, `test:ci-phase858`, `test:ci-phase857`, `test:ci-phase856`, `test:ci-phase855`, `test:ci-phase854`, `test:ci-phase853`, `test:ci-phase852`, `test:ci-phase851`, `test:ci-phase850`, `test:ci-phase849`, `test:ci-phase848`, `test:ci-phase847`, `test:ci-phase846`, `test:ci-phase845`, `test:ci-phase844`, `test:ci-phase843`, `test:ci-phase842`, `test:ci-phase841`, `test:ci-phase840`, `test:ci-phase839`, `test:ci-phase838`, `test:ci-phase837`, `test:ci-phase836`, `test:ci-phase835`, `test:ci-phase834`, `test:ci-phase833`, `test:ci-phase832`, `test:ci-phase831`, `test:ci-phase830`, `test:ci-phase829`, `test:ci-phase828`, `test:ci-phase827`, `test:ci-phase826`, `test:ci-phase825`, `test:ci-phase824`, `test:ci-phase823`, `test:ci-phase822`, `test:ci-phase821`, `test:ci-phase820`, `test:ci-phase819`, `test:ci-phase818`, `test:ci-phase817`, `test:ci-phase816`, `test:ci-phase815`, `test:ci-phase814`, `test:ci-phase813`, `test:ci-phase812`, `test:ci-phase811`, `test:ci-phase810`, `test:ci-phase809`, `test:ci-phase808`, `test:ci-phase807`, `test:ci-phase806`, `test:ci-phase805`, `test:ci-phase804`, `test:ci-phase803`, `test:ci-phase802`, `test:ci-phase801`, `test:ci-phase800`, `test:ci-phase799`, `test:ci-phase798`, `test:ci-phase797`, `test:ci-phase796`, `test:ci-phase795`, `test:ci-phase794`, `test:ci-phase793`, `test:ci-phase792`, `test:ci-phase791`, `test:ci-phase790`, `test:ci-phase789`, `test:ci-phase788`, `test:ci-phase787`, `test:ci-phase786`, `test:ci-phase785`, `test:ci-phase784`, `test:ci-phase783`, `test:ci-phase782`, `test:ci-phase781`, `test:ci-phase780`). Members: [MEMBERS.md](./MEMBERS.md). Settings/roles/permissions: [SETTINGS.md](./SETTINGS.md), [ROLE_EDITOR.md](./ROLE_EDITOR.md), [PERMISSIONS.md](./PERMISSIONS.md).
 
 | Package | Path | Status | Primary doc | Module README |
 |---------|------|--------|-------------|---------------|

MULTI_GUILD_MESH.md

@@ -2,6 +2,8 @@
 
 Playbook for Pearcord clients running **multiple guild meshes** concurrently — per-guild sync health, partition heal isolation, and Discord-style server-rail indicators (Phase 648, v0.8.620).
 
+**v0.8.831 (Phase 864):** Multi-guild production matrix + gossip outbox — `runGuildMeshMultiGuildProductionGossipJourney`, `sync-guild-mesh-multi-guild-production-gossip`. Bundle: `npm run test:ci-phase864`.
+
 **v0.8.830 (Phase 863):** Multi-guild production matrix + replication lag — `runGuildMeshMultiGuildProductionMatrixJourney`, `sync-guild-mesh-multi-guild-production-matrix`. Bundle: `npm run test:ci-phase863`.
 
 **v0.8.829 (Phase 862):** Multi-guild scale + DM composite — `runGuildMeshMultiGuildScaleDmCompositeJourney`, `sync-guild-mesh-multi-guild-scale-dm-composite`. Bundle: `npm run test:ci-phase862`.

PARTITION_HEAL.md

@@ -1,5 +1,7 @@
 # CRDT partition heal (Phase 646)
 
+**v0.8.831 (Phase 864):** Multi-guild production gossip — `runGuildMeshMultiGuildProductionGossipJourney`, `sync-guild-mesh-multi-guild-production-gossip`. Bundle: `npm run test:ci-phase864`.
+
 **v0.8.830 (Phase 863):** Multi-guild production matrix — `runGuildMeshMultiGuildProductionMatrixJourney`, `sync-guild-mesh-multi-guild-production-matrix`. Bundle: `npm run test:ci-phase863`.
 
 **v0.8.829 (Phase 862):** Multi-guild scale + DM composite — `runGuildMeshMultiGuildScaleDmCompositeJourney`, `sync-guild-mesh-multi-guild-scale-dm-composite`. Bundle: `npm run test:ci-phase862`.

PEARCORD_PARITY.md

@@ -55,6 +55,10 @@ Gap analysis between **Pearcord** (P2P Pear app) and a typical **centralized cha
 | Mute when disconnected | No-op | `set-voice-mute` noop + `hasActiveVoiceMedia()` guard | — |
 | Diagnostics | Client logs | Emoji miss at debug in panel; quiet IPC documented | Composer-defer trace |
 
+## Summary (v0.8.831) — guild multi-guild production matrix + gossip outbox (Phase 864)
+
+Multi-guild matrix keeps gossip outboxes drained under quad load. CI: `npm run test:ci-phase864`.
+
 ## Summary (v0.8.830) — guild multi-guild production matrix + replication lag (Phase 863)
 
 Four-guild production matrix with replication lag caps and scale+DM composite on primary. CI: `npm run test:ci-phase863`.

PLATFORM_ROADMAP.md

@@ -152,12 +152,71 @@ Skipped items tracked: **19** (Phase 712 superseded by Phase 714 completion)
 
 ## Now
 
-**Phase 863 complete.** Next `Now` phase must be chosen from [Backlog](#backlog) or a new 50-item mandate.
+**Phase 864 complete.** Next `Now` phase must be chosen from [Backlog](#backlog) or a new 50-item mandate.
 
 ---
 
 ## Completed (recent)
 
+### Phase 864 — Guild multi-guild production matrix + gossip outbox (v0.8.831) ✓
+
+**Goal:** Extend Phase 863 production matrix with per-guild gossip outbox flush, sync-pending clearance, and lane diagnostics under multi-guild load; CI via `meshMultiGuildProductionGossipReady`.
+
+Bundle: `npm run test:ci-phase864` → production gossip smoke + agentctl contract + `test:ci-phase863`.
+
+| ID | Item | Status |
+|----|------|--------|
+| P864-1 | `runGuildMeshMultiGuildProductionGossipJourney` | [x] |
+| P864-2 | `_flushGuildGossipOutbox` per guild rotation | [x] |
+| P864-3 | `PEARCORD_PHASE864_GOSSIP_OUTBOX_MAX` cap | [x] |
+| P864-4 | `gossipLaneCounts` in replication diag | [x] |
+| P864-5 | Matcher `meshMultiGuildProductionGossipReady` | [x] |
+| P864-6 | `guildSyncNotPending` + `guildSyncGossipOutboxMax` waits | [x] |
+| P864-7 | Extends Phase 863 replication lag asserts | [x] |
+| P864-8 | Cross-topic leak during gossip flush | [x] |
+| P864-9 | Quad mesh gossip token fanout | [x] |
+| P864-10 | `syncGuildMultiGuildProductionGossipChrome` | [x] |
+| P864-11 | UI-flow `sync-guild-mesh-multi-guild-production-gossip` IPC | [x] |
+| P864-12 | Smoke refresh + agentctl contract | [x] |
+| P864-13 | Smoke `test:phase864-boot-gate` v0.8.831 | [x] |
+| P864-14 | `test:ci-phase864` meta-bundle | [x] |
+| P864-15 | Regression `test:ci-phase863` | [x] |
+| P864-16 | Live quad churn [SKIP] manual | [SKIP] `PEARCORD_PHASE654_HEAL_FULL=1` |
+| P864-17 | `MESH_STABILITY.md` Phase 864 | [x] |
+| P864-18 | `AGENTCTL.md` Phase 864 | [x] |
+| P864-19 | `PRODUCTION_MESH.md` Phase 864 | [x] |
+| P864-20 | `MULTI_GUILD_MESH.md` Phase 864 | [x] |
+| P864-21 | `PARTITION_HEAL.md` Phase 864 | [x] |
+| P864-22 | UI-flow README Phase 864 | [x] |
+| P864-23 | Agentctl README Phase 864 | [x] |
+| P864-24 | `PEARCORD_PARITY.md` Phase 864 | [x] |
+| P864-25 | Extends Phase 863 + Phase 840 | [x] |
+| P864-26 | `PEARCORD_PHASE864_GUILD_COUNT` env | [x] |
+| P864-27 | Version bump 0.8.831 | [x] |
+| P864-28 | Changelog Phase 864 | [x] |
+| P864-29 | Roadmap Now complete | [x] |
+| P864-30 | `DOCUMENTATION_INDEX` v0.8.831 | [x] |
+| P864-31 | Release notes v0.8.831 | [x] |
+| P864-32 | Push all repos | [x] |
+| P864-33 | `test:doc-version-alignment` | [x] |
+| P864-34 | `guildMultiGuildProductionGossipNeedsRefresh` polls | [x] |
+| P864-35 | `syncGuildQuadSyncPendingChrome` composite | [x] |
+| P864-36 | Boot gates 780–863 accept 0.8.831 | [x] |
+| P864-37 | `SETTINGS.md` v0.8.831 | [x] |
+| P864-38 | `publicListing: false` | [x] |
+| P864-39 | `PEARCORD_SKIP_MESH_ROUNDTRIP` contract | [x] |
+| P864-40 | Platform README Phase 864 | [x] |
+| P864-41 | DM during heal + gossip flush interleave | [x] |
+| P864-42 | `gossipByGuild` journey telemetry | [x] |
+| P864-43 | `MEMBERS.md` cross-link | [x] |
+| P864-44 | Cross-link docs | [x] |
+| P864-45 | `pear run` boot sign-off | [x] |
+| P864-46 | Log scan (manual) | [x] |
+| P864-47 | `LARGE_GUILD_MESH.md` cross-link | [x] |
+| P864-48 | `meshMultiGuildProductionMatrixReady` in final wait | [x] |
+| P864-49 | Guest outbox wait (non-contract) | [x] |
+| P864-50 | Push pearcord + agentctl + ui-flow + docs | [x] |
+
 ### Phase 863 — Guild multi-guild production matrix + replication lag (v0.8.830) ✓
 
 **Goal:** Production matrix soak — 862 composite plus per-guild `exportMeshReplicationDiagnostics` lag asserts (P654-2), default 4-guild layout, expression metadata on primary; CI via `meshMultiGuildProductionMatrixReady`.
@@ -11880,7 +11939,8 @@ For deferred items, use `[SKIP]` and include a brief reason inline.
 
 ## Changelog
 
-- 2026-06-04 - Completed Phase 863 guild multi-guild production matrix + replication lag (v0.8.830): `runGuildMeshMultiGuildProductionMatrixJourney`, `sync-guild-mesh-multi-guild-production-matrix`, `test:ci-phase863` (50/50). **Now:** await Backlog-selected phase.
+- 2026-06-04 - Completed Phase 864 guild multi-guild production matrix + gossip outbox (v0.8.831): `runGuildMeshMultiGuildProductionGossipJourney`, `sync-guild-mesh-multi-guild-production-gossip`, `test:ci-phase864` (50/50). **Now:** await Backlog-selected phase.
+- 2026-06-04 - Completed Phase 863 guild multi-guild production matrix + replication lag (v0.8.830): `runGuildMeshMultiGuildProductionMatrixJourney`, `sync-guild-mesh-multi-guild-production-matrix`, `test:ci-phase863` (50/50).
 - 2026-06-04 - Completed Phase 862 guild multi-guild scale + DM-during-heal composite (v0.8.829): `runGuildMeshMultiGuildScaleDmCompositeJourney`, `sync-guild-mesh-multi-guild-scale-dm-composite`, `test:ci-phase862` (50/50).
 - 2026-06-04 - Completed Phase 861 guild multi-guild 4×quad churn matrix P654-24 (v0.8.828): `runGuildMeshMultiGuildQuadChurnMatrixJourney`, `sync-guild-mesh-quad-multi-guild-churn-matrix`, `test:ci-phase861` (50/50).
 - 2026-06-04 - Completed Phase 860 guild 4-peer ultimate roster scale heal + DM during heal (v0.8.827): `runGuildMeshQuadUltimateRosterScaleDmHealJourney`, `sync-guild-mesh-quad-ultimate-roster-scale-dm-heal`, `test:ci-phase860` (50/50).

PRODUCTION_MESH.md

@@ -126,6 +126,12 @@ Bundle: `npm run test:ci-phase780` (includes `test:guild-loading-state-push`, `t
 - Agentctl: `runGuildMeshStickerJourney`
 - Bundle: `npm run test:ci-phase791`
 
+## Multi-guild production matrix + gossip outbox (Phase 864, v0.8.831)
+
+- Agentctl: `runGuildMeshMultiGuildProductionGossipJourney` — 863 matrix + gossip flush/outbox caps.
+- UI-flow: `sync-guild-mesh-multi-guild-production-gossip` IPC.
+- CI: `npm run test:ci-phase864`.
+
 ## Multi-guild production matrix + replication lag (Phase 863, v0.8.830)
 
 - Agentctl: `runGuildMeshMultiGuildProductionMatrixJourney` — 862 composite + per-guild replication lag asserts.
@@ -664,6 +670,8 @@ Headless helpers (live mesh unless `PEARCORD_SKIP_MESH_ROUNDTRIP=1`): `runMeshRe
 
 **CI tip:** pass `publicListing: false` on `createGuild` in automation to avoid discovery ingest timeouts.
 
+**Phase 864 (v0.8.831):** `runGuildMeshMultiGuildProductionGossipJourney` — production gossip matrix. CI: `npm run test:ci-phase864`.
+
 **Phase 863 (v0.8.830):** `runGuildMeshMultiGuildProductionMatrixJourney` — production matrix + replication lag. CI: `npm run test:ci-phase863`.
 
 **Phase 862 (v0.8.829):** `runGuildMeshMultiGuildScaleDmCompositeJourney` — scale roster + DM during heal + multi-guild isolation. CI: `npm run test:ci-phase862`.

SETTINGS.md

@@ -2,6 +2,8 @@
 
 Pearcord settings use a shared **Discord-style modal shell** (`apps/pearcord/ui/components/settings-modal.js`) for user preferences and per-guild server settings. All prefs sync over P2P gossip — no central settings API.
 
+**v0.8.831 (Phase 864):** Multi-guild production matrix + gossip outbox. CI: `npm run test:ci-phase864`.
+
 **v0.8.830 (Phase 863):** Multi-guild production matrix + replication lag. CI: `npm run test:ci-phase863`.
 
 **v0.8.829 (Phase 862):** Multi-guild scale + DM-during-heal composite. CI: `npm run test:ci-phase862`.

release_notes/RELEASE_v0.8.831.md

@@ -0,0 +1,7 @@
+# Release v0.8.831 — Phase 864
+
+Guild multi-guild production matrix + gossip outbox: extends Phase 863 with per-guild gossip flush, sync-pending clearance, and outbox caps under multi-guild quad load.
+
+- Agentctl: `runGuildMeshMultiGuildProductionGossipJourney`, matcher `meshMultiGuildProductionGossipReady`
+- UI-flow: `sync-guild-mesh-multi-guild-production-gossip`
+- CI: `npm run test:ci-phase864`