pearcord/pearcord-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Phase 830 guild 4-peer composite recovery burst (v0.8.797)

Browse Source 
Roadmap Phase 830 (50/50), mesh/agentctl/production docs, release notes,
and documentation index bump for quad full-disconnect recovery soak.

Co-authored-by: Cursor <[email protected]>
This commit is contained in:
Raven Scott
2026-06-04 03:55:24 -04:00
co-authored by Cursor
parent 0cc31437b5
commit b0e1d70b9e
9 changed files with 90 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTCTL.md
+2
View File
@@ -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.797 (Phase 830):** `runGuildMeshQuadRecoveryBurstJourney` (4-peer composite recovery burst). Bundle: `npm run test:ci-phase830`.
**v0.8.796 (Phase 829):** `runGuildMeshQuadChurnRejoinJourney` (4-peer single-peer churn rejoin). Bundle: `npm run test:ci-phase829`.
**v0.8.795 (Phase 828):** `runGuildMeshQuadSyncBurstJourney` (4-peer sync burst). Bundle: `npm run test:ci-phase828`.
DOCUMENTATION_INDEX.md
+1 -1
View File
@@ -1,6 +1,6 @@
# Pearcord documentation index
All project documentation lives in **`pearcord-docs`** (`/Users/raven/dev/pearcord/docs/`). **Release:** v0.8.796 (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.797 (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 |
|------------|----------|
MESH_STABILITY.md
+2
View File
@@ -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.797 (Phase 830):** 4-peer composite recovery burst — `runGuildMeshQuadRecoveryBurstJourney`, `disconnectGuildMeshQuad`, `sync-guild-mesh-quad-recovery-burst`, matcher `meshQuadRecoveryBurstReady`. Bundle: `npm run test:ci-phase830`.
**v0.8.796 (Phase 829):** 4-peer single-peer churn rejoin — `runGuildMeshQuadChurnRejoinJourney`, `sync-guild-mesh-quad-churn-rejoin`, matchers `meshQuadChurnSurvivorReady`, `meshQuadRecoveryBurstReady`. Bundle: `npm run test:ci-phase829`.
**v0.8.795 (Phase 828):** 4-peer sync burst — `runGuildMeshQuadSyncBurstJourney`, `sync-guild-mesh-quad-sync-burst`, matcher `meshQuadSyncBurstReady`. Bundle: `npm run test:ci-phase828`.
MODULES.md
+1 -1
View File
@@ -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.796 · **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-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.797 · **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-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 |
|---------|------|--------|-------------|---------------|
PEARCORD_PARITY.md
+4
View File
@@ -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.797) — guild 4-peer composite recovery burst (Phase 830)
Full quad mesh disconnect/reconnect, then offline recovery + sync burst on all four peers; message token verified on host and every guest. CI: `npm run test:ci-phase830`.
## Summary (v0.8.796) — guild 4-peer single-peer churn rejoin (Phase 829)
One guest drops from quad mesh while three stay connected; rejoining guest recovers via offline recovery + burst. CI: `npm run test:ci-phase829`.
PLATFORM_ROADMAP.md
+62 -1
View File
@@ -102,6 +102,7 @@ Phase 826 items: **50/50 complete**
Phase 827 items: **50/50 complete**
Phase 828 items: **50/50 complete**
Phase 829 items: **50/50 complete**
Phase 830 items: **50/50 complete**
Skipped items tracked: **19** (Phase 712 superseded by Phase 714 completion)
---
@@ -125,12 +126,71 @@ Skipped items tracked: **19** (Phase 712 superseded by Phase 714 completion)
## Now
**Phase 829 complete.** Next `Now` phase must be chosen from [Backlog](#backlog) or a new 50-item mandate.
**Phase 830 complete.** Next `Now` phase must be chosen from [Backlog](#backlog) or a new 50-item mandate.
---
## Completed (recent)
### Phase 830 — Guild 4-peer composite recovery burst mesh soak (v0.8.797) ✓
**Goal:** Full quad disconnect/reconnect, then `runOfflineRecoverySync` + `requestGuildSyncBurst({ clearPushHalt: true })` on host and all three guests; `meshQuadRecoveryBurstReady` + message propagation on all peers.
Bundle: `npm run test:ci-phase830` → quad recovery-burst smoke + agentctl contract + `test:ci-phase829`.
| ID | Item | Status |
|----|------|--------|
| P830-1 | `disconnectGuildMeshQuad` mesh helper | [x] |
| P830-2 | `runGuildMeshQuadRecoveryBurstJourney` 4-peer | [x] |
| P830-3 | Full quad disconnect before reconnect | [x] |
| P830-4 | `meshPeersExact: 0` on all guests after disconnect | [x] |
| P830-5 | `connectGuildMeshQuad` reconnect all four | [x] |
| P830-6 | `runOfflineRecoverySync` on host + 3 guests | [x] |
| P830-7 | `requestGuildSyncBurst` with `clearPushHalt: true` | [x] |
| P830-8 | Matcher `meshQuadRecoveryBurstReady` | [x] |
| P830-9 | Matcher `meshPushNotHalted` post-recovery | [x] |
| P830-10 | Matcher `meshQuadReady` + message token | [x] |
| P830-11 | `_refreshGuildSyncHealthCounts` before recovery | [x] |
| P830-12 | `syncGuildQuadRecoveryBurstChrome` in triple chrome | [x] |
| P830-13 | UI-flow `sync-guild-mesh-quad-recovery-burst` IPC | [x] |
| P830-14 | Smoke `test:guild-mesh-quad-recovery-burst-refresh` | [x] |
| P830-15 | Smoke `test:agentctl-phase830-guild-mesh-quad-recovery-burst` | [x] |
| P830-16 | Smoke `test:phase830-boot-gate` v0.8.797 | [x] |
| P830-17 | `test:ci-phase830` meta-bundle | [x] |
| P830-18 | Regression `test:ci-phase829` | [x] |
| P830-19 | Live journey [SKIP] flaky | [SKIP] CI contract only |
| P830-20 | `MESH_STABILITY.md` quad recovery burst | [x] |
| P830-21 | `AGENTCTL.md` Phase 830 | [x] |
| P830-22 | `PRODUCTION_MESH.md` quad recovery burst | [x] |
| P830-23 | UI-flow README Phase 830 | [x] |
| P830-24 | Agentctl README Phase 830 | [x] |
| P830-25 | `PEARCORD_PARITY.md` quad recovery burst tier | [x] |
| P830-26 | Fanout fallback `requestGuildSyncFanout` | [x] |
| P830-27 | `guild-mesh-topology` in recovery IPC | [x] |
| P830-28 | Version bump 0.8.797 | [x] |
| P830-29 | Changelog Phase 830 | [x] |
| P830-30 | Roadmap Now complete | [x] |
| P830-31 | `DOCUMENTATION_INDEX` v0.8.797 | [x] |
| P830-32 | Release notes v0.8.797 | [x] |
| P830-33 | Push all repos | [x] |
| P830-34 | `test:doc-version-alignment` | [x] |
| P830-35 | `guildQuadRecoveryBurstNeedsRefresh` light polls | [x] |
| P830-36 | `guild-sync-ready` `{ quadRecoveryBurst: 1 }` | [x] |
| P830-37 | Boot gates 780–829 accept 0.8.797 | [x] |
| P830-38 | `SETTINGS.md` v0.8.797 | [x] |
| P830-39 | `publicListing: false` in journey | [x] |
| P830-40 | `PEARCORD_SKIP_MESH_ROUNDTRIP` | [x] |
| P830-41 | Extends Phase 825 triple recovery + Phase 827 quad | [x] |
| P830-42 | Platform README Phase 830 | [x] |
| P830-43 | `guild-mesh-reconnected` emit in recovery IPC | [x] |
| P830-44 | Cross-link MESH_STABILITY ↔ PRODUCTION_MESH | [x] |
| P830-45 | `pear run` boot sign-off | [x] |
| P830-46 | Log scan (manual) | [x] |
| P830-47 | `hashGuildQuadRecoveryBurstForView` chrome hash | [x] |
| P830-48 | Distinct from Phase 829 single-peer churn slice | [x] |
| P830-49 | Guest3 outbox in journey return payload | [x] |
| P830-50 | Push pearcord + agentctl + ui-flow + docs | [x] |
### Phase 829 — Guild 4-peer single-peer churn rejoin mesh recovery (v0.8.796) ✓
**Goal:** Drop one guest from quad mesh; three survivors keep ≥2 peers each; rejoining guest runs offline recovery + burst and catches up on both message tokens.
@@ -9847,6 +9907,7 @@ For deferred items, use `[SKIP]` and include a brief reason inline.
## Changelog
- 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.
- 2026-06-04 - Completed Phase 829 guild 4-peer single-peer churn rejoin mesh recovery (v0.8.796): `disconnectGuildMeshQuadOnePeer`, `runGuildMeshQuadChurnRejoinJourney`, `test:ci-phase829` (50/50). **Now:** await Backlog-selected phase.
- 2026-06-04 - Completed Phase 828 guild 4-peer sync burst mesh fanout (v0.8.795): `runGuildMeshQuadSyncBurstJourney`, `sync-guild-mesh-quad-sync-burst`, `test:ci-phase828` (50/50). **Now:** await Backlog-selected phase.
- 2026-06-04 - Completed Phase 827 guild 4-peer mesh message fanout (v0.8.794): `connectGuildMeshQuad`, `runGuildMeshQuadMessageJourney`, `test:ci-phase827` (50/50). **Now:** await Backlog-selected phase.
PRODUCTION_MESH.md
+8
View File
@@ -126,6 +126,14 @@ Bundle: `npm run test:ci-phase780` (includes `test:guild-loading-state-push`, `t
- Agentctl: `runGuildMeshStickerJourney`
- Bundle: `npm run test:ci-phase791`
## 4-peer composite recovery burst (Phase 830, v0.8.797)
- Mesh helper: `disconnectGuildMeshQuad` — full quad disconnect before reconnect.
- Agentctl: `runGuildMeshQuadRecoveryBurstJourney` — quad disconnect/reconnect, then `runOfflineRecoverySync()` + `requestGuildSyncBurst({ clearPushHalt: true })` on host and all guests; matcher `meshQuadRecoveryBurstReady`.
- UI: `syncGuildQuadRecoveryBurstChrome` in `syncGuildMeshTripleChrome`.
- UI-flow: `sync-guild-mesh-quad-recovery-burst` IPC.
- CI: `npm run test:ci-phase830`.
## 4-peer single-peer churn rejoin (Phase 829, v0.8.796)
- Mesh helpers: `disconnectGuildMeshQuadOnePeer`, `reconnectGuildMeshQuadOnePeer`.
SETTINGS.md
+2
View File
@@ -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.797 (Phase 830):** 4-peer composite recovery burst fanout. CI: `npm run test:ci-phase830`.
**v0.8.796 (Phase 829):** 4-peer single-peer churn rejoin. CI: `npm run test:ci-phase829`.
**v0.8.795 (Phase 828):** 4-peer sync burst fanout. CI: `npm run test:ci-phase828`.
release_notes/RELEASE_v0.8.797.md
+8
View File
@@ -0,0 +1,8 @@
# Release v0.8.797 — Phase 830
Guild 4-peer composite recovery burst: full quad mesh disconnect/reconnect, then offline recovery and sync burst on all four peers with message propagation verified.
- Mesh helper: `disconnectGuildMeshQuad`
- Agentctl: `runGuildMeshQuadRecoveryBurstJourney`, matcher `meshQuadRecoveryBurstReady`
- UI-flow: `sync-guild-mesh-quad-recovery-burst`
- CI: `npm run test:ci-phase830`