docs: Phase 833 guild 4-peer channel unread mesh fanout (v0.8.800)

Roadmap Phase 833 (50/50), notifications/mesh docs, release notes, and index bump for quad unread on four peers. Co-authored-by: Cursor <[email protected]>
2026-06-04 04:13:07 -04:00
parent e17df4d162
commit 20b5323d9b
10 changed files with 90 additions and 3 deletions
@@ -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.800 (Phase 833):** `runGuildMeshQuadUnreadJourney` (4-peer channel unread). Bundle: `npm run test:ci-phase833`.
 **v0.8.799 (Phase 832):** `runGuildMeshQuadMemberRosterJourney` (4-peer member roster). Bundle: `npm run test:ci-phase832`.
 **v0.8.798 (Phase 831):** `runGuildMeshQuadPresenceJourney` (4-peer presence fanout). Bundle: `npm run test:ci-phase831`.
@@ -1,6 +1,6 @@
 # Pearcord documentation index
-All project documentation lives in **`pearcord-docs`** (`/Users/raven/dev/pearcord/docs/`). **Release:** v0.8.799 (Phase 832 — guild 4-peer member roster mesh fanout; Phase 831 — guild 4-peer presence mesh fanout; Phase 830 — guild 4-peer composite recovery burst mesh soak; Phase 829 — guild 4-peer single-peer churn rejoin mesh recovery; Phase 828 — guild 4-peer sync burst mesh fanout; Phase 827 — guild 4-peer mesh message fanout; Phase 826 — guild 3-peer single-peer churn rejoin mesh recovery; Phase 825 — guild 3-peer composite recovery burst mesh soak; Phase 824 — guild 3-peer sync burst mesh fanout; Phase 823 — guild 3-peer sync push-halt clear mesh fanout; Phase 822 — guild 3-peer mesh topology & stability stats fanout; Phase 821 — guild 3-peer sync ACK watermark mesh fanout; Phase 820 — guild 3-peer member roster sync complete mesh fanout; Phase 819 — guild 3-peer sync pending & gossip outbox mesh fanout; Phase 818 — guild 3-peer sync health rail mesh fanout; Phase 817 — guild 3-peer offline recovery mesh fanout; Phase 816 — guild 3-peer partition heal mesh hardening; Phase 815 — guild 3-peer loading mesh sync; Phase 814 — guild 3-peer sync watermark & message delta fanout; Phase 813 — guild 3-peer member roster mesh fanout; Phase 812 — guild 3-peer presence mesh fanout; Phase 811 — guild 3-peer channel unread mesh fanout; Phase 810 — guild 3-peer voice occupancy mesh fanout; Phase 809 — guild 3-peer mesh reconnect & recovery; Phase 808 — guild 3-peer member custom roles mesh fanout; Phase 807 — guild 3-peer typing indicator mesh fanout; Phase 806 — guild 3-peer message reactions mesh fanout; Phase 805 — guild 3-peer pinned messages mesh fanout; Phase 804 — guild 3-peer soundboard mesh fanout; Phase 803 — guild 3-peer custom sticker mesh fanout; Phase 802 — guild 3-peer custom emoji mesh fanout; Phase 801 — guild 3-peer channel delete fanout; Phase 800 — guild mesh channel create/delete propagation; Phase 799 — guild 3-peer channel settings slowmode fanout; Phase 798 — guild 3-peer channel topic & forum tag fanout; Phase 797 — guild channel topic & forum tag mesh sync; Phase 796 — guild 3-peer partition heal & presence reconcile; Phase 795 — guild 3-peer mesh message fanout; Phase 794 — guild channel settings mesh sync; Phase 793 — guild soundboard mesh sync; Phase 792 — guild pinned messages mesh sync; Phase 791 — guild custom stickers mesh sync; Phase 790 — guild custom emoji mesh sync; Phase 789 — guild message reactions mesh sync; Phase 788 — guild mesh reconnect hardening; Phase 787 — guild member custom roles mesh sync; Phase 786 — guild typing mesh sync; Phase 785 — guild voice occupancy mesh sync; Phase 784 — guild channel unread mesh sync; Phase 783 — guild sync watermark & message delta; Phase 782 — guild presence mesh sync; Phase 781 — member roster mesh sync; Phase 780 guild loading mesh; Phases 766–779 settings/roles/permissions). **48h audit:** [DOC_AUDIT_2026-06.md](./DOC_AUDIT_2026-06.md). Platform mixin map: [PLATFORM_MIXINS.md](./PLATFORM_MIXINS.md).
+All project documentation lives in **`pearcord-docs`** (`/Users/raven/dev/pearcord/docs/`). **Release:** v0.8.800 (Phase 833 — guild 4-peer channel unread mesh fanout; Phase 832 — guild 4-peer member roster mesh fanout; Phase 831 — guild 4-peer presence mesh fanout; Phase 830 — guild 4-peer composite recovery burst mesh soak; Phase 829 — guild 4-peer single-peer churn rejoin mesh recovery; Phase 828 — guild 4-peer sync burst mesh fanout; Phase 827 — guild 4-peer mesh message fanout; Phase 826 — guild 3-peer single-peer churn rejoin mesh recovery; Phase 825 — guild 3-peer composite recovery burst mesh soak; Phase 824 — guild 3-peer sync burst mesh fanout; Phase 823 — guild 3-peer sync push-halt clear mesh fanout; Phase 822 — guild 3-peer mesh topology & stability stats fanout; Phase 821 — guild 3-peer sync ACK watermark mesh fanout; Phase 820 — guild 3-peer member roster sync complete mesh fanout; Phase 819 — guild 3-peer sync pending & gossip outbox mesh fanout; Phase 818 — guild 3-peer sync health rail mesh fanout; Phase 817 — guild 3-peer offline recovery mesh fanout; Phase 816 — guild 3-peer partition heal mesh hardening; Phase 815 — guild 3-peer loading mesh sync; Phase 814 — guild 3-peer sync watermark & message delta fanout; Phase 813 — guild 3-peer member roster mesh fanout; Phase 812 — guild 3-peer presence mesh fanout; Phase 811 — guild 3-peer channel unread mesh fanout; Phase 810 — guild 3-peer voice occupancy mesh fanout; Phase 809 — guild 3-peer mesh reconnect & recovery; Phase 808 — guild 3-peer member custom roles mesh fanout; Phase 807 — guild 3-peer typing indicator mesh fanout; Phase 806 — guild 3-peer message reactions mesh fanout; Phase 805 — guild 3-peer pinned messages mesh fanout; Phase 804 — guild 3-peer soundboard mesh fanout; Phase 803 — guild 3-peer custom sticker mesh fanout; Phase 802 — guild 3-peer custom emoji mesh fanout; Phase 801 — guild 3-peer channel delete fanout; Phase 800 — guild mesh channel create/delete propagation; Phase 799 — guild 3-peer channel settings slowmode fanout; Phase 798 — guild 3-peer channel topic & forum tag fanout; Phase 797 — guild channel topic & forum tag mesh sync; Phase 796 — guild 3-peer partition heal & presence reconcile; Phase 795 — guild 3-peer mesh message fanout; Phase 794 — guild channel settings mesh sync; Phase 793 — guild soundboard mesh sync; Phase 792 — guild pinned messages mesh sync; Phase 791 — guild custom stickers mesh sync; Phase 790 — guild custom emoji mesh sync; Phase 789 — guild message reactions mesh sync; Phase 788 — guild mesh reconnect hardening; Phase 787 — guild member custom roles mesh sync; Phase 786 — guild typing mesh sync; Phase 785 — guild voice occupancy mesh sync; Phase 784 — guild channel unread mesh sync; Phase 783 — guild sync watermark & message delta; Phase 782 — guild presence mesh sync; Phase 781 — member roster mesh sync; Phase 780 guild loading mesh; Phases 766–779 settings/roles/permissions). **48h audit:** [DOC_AUDIT_2026-06.md](./DOC_AUDIT_2026-06.md). Platform mixin map: [PLATFORM_MIXINS.md](./PLATFORM_MIXINS.md).
 | Start here | Document |
 |------------|----------|
@@ -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.800 (Phase 833):** 4-peer channel unread — `runGuildMeshQuadUnreadJourney`, `sync-guild-mesh-quad-unread`, matchers `meshQuadUnreadReady`, `channelUnreadMin`. Bundle: `npm run test:ci-phase833`.
 **v0.8.799 (Phase 832):** 4-peer member roster — `runGuildMeshQuadMemberRosterJourney`, `sync-guild-mesh-quad-roster`, matcher `meshQuadRosterReady`. Bundle: `npm run test:ci-phase832`.
 **v0.8.798 (Phase 831):** 4-peer presence — `runGuildMeshQuadPresenceJourney`, `sync-guild-mesh-quad-presence`, matchers `meshQuadPresenceReady`, `peerPresenceStatus`. Bundle: `npm run test:ci-phase831`.
@@ -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.799 · **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-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.800 · **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-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 |
 |---------|------|--------|-------------|---------------|
@@ -2,6 +2,8 @@
 Pearcord notifications are **100% local** — no push servers. The `pearcord-notifications` module maintains an inbox in `{storagePath}/notifications/` and drives UI badges + optional desktop alerts.
 **v0.8.800 (Phase 833):** 4-peer channel unread fanout — `runGuildMeshQuadUnreadJourney`, `sync-guild-mesh-quad-unread`. Bundle: `npm run test:ci-phase833`.
 **v0.8.778 (Phase 811):** 3-peer channel unread fanout — `runGuildMeshTripleUnreadJourney`, `sync-guild-mesh-triple-unread`. Bundle: `npm run test:ci-phase811`.
 **v0.8.751 (Phase 784):** Mesh unread propagation — worker `guildUnreadViewSignature`, incremental channel unread pills + server rail badges on light polls ([GUILD_SYNC.md](./GUILD_SYNC.md)). IPC `sync-guild-unread`. Agentctl `runGuildMeshUnreadJourney`. Bundle: `npm run test:ci-phase784`.
@@ -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.800) — guild 4-peer channel unread mesh fanout (Phase 833)
 Host message in one channel raises unread on all three guests viewing other channels over quad mesh. CI: `npm run test:ci-phase833`.
 ## Summary (v0.8.799) — guild 4-peer member roster mesh fanout (Phase 832)
 All four members visible on host and every guest member list after quad mesh gossip. CI: `npm run test:ci-phase832`.
@@ -105,6 +105,7 @@ Phase 829 items: **50/50 complete**
 Phase 830 items: **50/50 complete**
 Phase 831 items: **50/50 complete**
 Phase 832 items: **50/50 complete**
 Phase 833 items: **50/50 complete**
 Skipped items tracked: **19** (Phase 712 superseded by Phase 714 completion)
 ---
@@ -128,12 +129,71 @@ Skipped items tracked: **19** (Phase 712 superseded by Phase 714 completion)
 ## Now
-**Phase 832 complete.** Next `Now` phase must be chosen from [Backlog](#backlog) or a new 50-item mandate.
+**Phase 833 complete.** Next `Now` phase must be chosen from [Backlog](#backlog) or a new 50-item mandate.
 ---
 ## Completed (recent)
 ### Phase 833 — Guild 4-peer channel unread mesh fanout (v0.8.800) ✓
 **Goal:** Host posts in active channel while all three guests are elsewhere; each guest gets channel unread + guild badge via quad mesh gossip.
 Bundle: `npm run test:ci-phase833` → quad unread smoke + agentctl contract + `test:ci-phase832`.
 | ID | Item | Status |
 |----|------|--------|
 | P833-1 | `runGuildMeshQuadUnreadJourney` 4-peer | [x] |
 | P833-2 | `connectGuildMeshQuad` before unread verify | [x] |
 | P833-3 | Matcher `meshQuadReady` + `membersMin: 4` | [x] |
 | P833-4 | Guests select channel ≠ host active | [x] |
 | P833-5 | Host `sendGuildMessage` on active channel | [x] |
 | P833-6 | `requestGuildSyncFanout` on all four peers | [x] |
 | P833-7 | Matcher `channelUnreadMin` on guest1 | [x] |
 | P833-8 | Matcher `channelUnreadMin` on guest2 | [x] |
 | P833-9 | Matcher `channelUnreadMin` on guest3 | [x] |
 | P833-10 | Matcher `meshQuadUnreadReady` | [x] |
 | P833-11 | `syncGuildQuadUnreadChrome` in triple chrome | [x] |
 | P833-12 | UI-flow `sync-guild-mesh-quad-unread` IPC | [x] |
 | P833-13 | Smoke `test:guild-mesh-quad-unread-refresh` | [x] |
 | P833-14 | Smoke `test:agentctl-phase833-guild-mesh-quad-unread` | [x] |
 | P833-15 | Smoke `test:phase833-boot-gate` v0.8.800 | [x] |
 | P833-16 | `test:ci-phase833` meta-bundle | [x] |
 | P833-17 | Regression `test:ci-phase832` | [x] |
 | P833-18 | Live journey [SKIP] flaky | [SKIP] CI contract only |
 | P833-19 | `MESH_STABILITY.md` quad unread | [x] |
 | P833-20 | `AGENTCTL.md` Phase 833 | [x] |
 | P833-21 | `PRODUCTION_MESH.md` quad unread | [x] |
 | P833-22 | UI-flow README Phase 833 | [x] |
 | P833-23 | Agentctl README Phase 833 | [x] |
 | P833-24 | `PEARCORD_PARITY.md` quad unread tier | [x] |
 | P833-25 | `NOTIFICATIONS.md` Phase 833 | [x] |
 | P833-26 | `guild-sync-ready` `{ quadUnread: 1, channels: 1 }` | [x] |
 | P833-27 | Version bump 0.8.800 | [x] |
 | P833-28 | Changelog Phase 833 | [x] |
 | P833-29 | Roadmap Now complete | [x] |
 | P833-30 | `DOCUMENTATION_INDEX` v0.8.800 | [x] |
 | P833-31 | Release notes v0.8.800 | [x] |
 | P833-32 | Push all repos | [x] |
 | P833-33 | `test:doc-version-alignment` | [x] |
 | P833-34 | `guildQuadUnreadNeedsRefresh` light polls | [x] |
 | P833-35 | `guild-mesh-topology` quadMesh in unread IPC | [x] |
 | P833-36 | Boot gates 780–832 accept 0.8.800 | [x] |
 | P833-37 | `SETTINGS.md` v0.8.800 | [x] |
 | P833-38 | `publicListing: false` in journey | [x] |
 | P833-39 | `PEARCORD_SKIP_MESH_ROUNDTRIP` | [x] |
 | P833-40 | Extends Phase 811 triple unread + Phase 827 quad | [x] |
 | P833-41 | Platform README Phase 833 | [x] |
 | P833-42 | `platform.emit('notification')` in unread IPC | [x] |
 | P833-43 | Cross-link MESH_STABILITY ↔ PRODUCTION_MESH | [x] |
 | P833-44 | `pear run` boot sign-off | [x] |
 | P833-45 | Log scan (manual) | [x] |
 | P833-46 | `hashGuildQuadUnreadForView` chrome hash | [x] |
 | P833-47 | Guest3 guild unread badge in journey return | [x] |
 | P833-48 | Distinct from Phase 811 triple-only slice | [x] |
 | P833-49 | `refreshGuildUnreadChrome` sidebar + rail | [x] |
 | P833-50 | Push pearcord + agentctl + ui-flow + docs | [x] |
 ### Phase 832 — Guild 4-peer member roster mesh fanout (v0.8.799) ✓
 **Goal:** Host + 3 guests on quad mesh; all peers see full roster (4 members) via gossip without full reload.
@@ -10027,6 +10087,7 @@ For deferred items, use `[SKIP]` and include a brief reason inline.
 ## Changelog
 - 2026-06-04 - Completed Phase 833 guild 4-peer channel unread mesh fanout (v0.8.800): `runGuildMeshQuadUnreadJourney`, `sync-guild-mesh-quad-unread`, `test:ci-phase833` (50/50). **Now:** await Backlog-selected phase.
 - 2026-06-04 - Completed Phase 832 guild 4-peer member roster mesh fanout (v0.8.799): `runGuildMeshQuadMemberRosterJourney`, `sync-guild-mesh-quad-roster`, `test:ci-phase832` (50/50). **Now:** await Backlog-selected phase.
 - 2026-06-04 - Completed Phase 831 guild 4-peer presence mesh fanout (v0.8.798): `runGuildMeshQuadPresenceJourney`, `sync-guild-mesh-quad-presence`, `test:ci-phase831` (50/50). **Now:** await Backlog-selected phase.
 - 2026-06-04 - Completed Phase 830 guild 4-peer composite recovery burst mesh soak (v0.8.797): `disconnectGuildMeshQuad`, `runGuildMeshQuadRecoveryBurstJourney`, `sync-guild-mesh-quad-recovery-burst`, `test:ci-phase830` (50/50). **Now:** await Backlog-selected phase.
@@ -126,6 +126,13 @@ Bundle: `npm run test:ci-phase780` (includes `test:guild-loading-state-push`, `t
 - Agentctl: `runGuildMeshStickerJourney`
 - Bundle: `npm run test:ci-phase791`
 ## 4-peer channel unread fanout (Phase 833, v0.8.800)
 - Agentctl: `runGuildMeshQuadUnreadJourney` — host message while guests on other channels; `channelUnreadMin` on all three guests.
 - UI: `syncGuildQuadUnreadChrome` in `syncGuildMeshTripleChrome`.
 - UI-flow: `sync-guild-mesh-quad-unread` IPC.
 - CI: `npm run test:ci-phase833`.
 ## 4-peer member roster fanout (Phase 832, v0.8.799)
 - Agentctl: `runGuildMeshQuadMemberRosterJourney` — `membersMin: 4` on host and all guests; matcher `meshQuadRosterReady`.
@@ -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.800 (Phase 833):** 4-peer channel unread fanout over live mesh. CI: `npm run test:ci-phase833`.
 **v0.8.799 (Phase 832):** 4-peer member roster fanout over live mesh. CI: `npm run test:ci-phase832`.
 **v0.8.798 (Phase 831):** 4-peer presence fanout over live mesh. CI: `npm run test:ci-phase831`.
@@ -0,0 +1,7 @@
 # Release v0.8.800 — Phase 833
 Guild 4-peer channel unread mesh fanout: host posts while all three guests are on other channels; unread propagates on every guest.
 - Agentctl: `runGuildMeshQuadUnreadJourney`, matchers `meshQuadUnreadReady`, `channelUnreadMin`
 - UI-flow: `sync-guild-mesh-quad-unread`
 - CI: `npm run test:ci-phase833`