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

docs: Phase 799 guild 3-peer slowmode fanout (v0.8.766)

Browse Source 
Roadmap, SLOWMODE, mesh docs, and release notes for triple channel settings.

Co-authored-by: Cursor <[email protected]>
This commit is contained in:
Raven Scott
2026-06-03 22:38:27 -04:00
co-authored by Cursor
parent 00b00de714
commit 93816a09f1
10 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.766 (Phase 799):** `runGuildMeshTripleChannelSettingsJourney` (3-peer slowmode). Bundle: `npm run test:ci-phase799`.
**v0.8.765 (Phase 798):** `runGuildMeshTripleChannelTopicJourney` (3-peer topic + forum tags). Bundle: `npm run test:ci-phase798`.
**v0.8.764 (Phase 797):** Matchers `activeChannelTopicIncludes`, `forumTagPaletteMin`; `runGuildMeshChannelTopicJourney`. Bundle: `npm run test:ci-phase797`.
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.765 (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.766 (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.766 (Phase 799):** 3-peer slowmode fanout — `runGuildMeshTripleChannelSettingsJourney`, `sync-guild-mesh-triple-channel-settings`. Bundle: `npm run test:ci-phase799`.
**v0.8.765 (Phase 798):** 3-peer topic + forum tag fanout — `runGuildMeshTripleChannelTopicJourney`, `sync-guild-mesh-triple-topic`. Bundle: `npm run test:ci-phase798`.
**v0.8.764 (Phase 797):** Channel topic + forum tag mesh refresh — `runGuildMeshChannelTopicJourney`, `channelTopicViewSignature`, `sync-guild-channel-topic`. Bundle: `npm run test:ci-phase797`.
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.765 · **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-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.766 · **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-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.766) — guild 3-peer slowmode fanout (Phase 799)
Triple mesh propagates channel slowmode to both guest peers; header badge updates without reload. CI: `npm run test:ci-phase799`.
## Summary (v0.8.765) — guild 3-peer topic & forum tag fanout (Phase 798)
Triple mesh propagates channel topic and forum palette to both guest peers. CI: `npm run test:ci-phase798`.
PLATFORM_ROADMAP.md
+62 -1
View File
@@ -72,6 +72,7 @@ Phase 795 items: **50/50 complete**
Phase 796 items: **50/50 complete**
Phase 797 items: **50/50 complete**
Phase 798 items: **50/50 complete**
Phase 799 items: **50/50 complete**
Skipped items tracked: **19** (Phase 712 superseded by Phase 714 completion)
---
@@ -95,12 +96,71 @@ Skipped items tracked: **19** (Phase 712 superseded by Phase 714 completion)
## Now
**Phase 798 complete.** Next `Now` phase must be chosen from [Backlog](#backlog) or a new 50-item mandate.
**Phase 799 complete.** Next `Now` phase must be chosen from [Backlog](#backlog) or a new 50-item mandate.
---
## Completed (recent)
### Phase 799 — Guild 3-peer channel settings (slowmode) fanout (v0.8.766) ✓
**Goal:** Host + two guests on live mesh; slowmode propagates to both guests; triple topology refreshes header slowmode badge.
Bundle: `npm run test:ci-phase799` → triple channel-settings smoke + agentctl contract + `test:ci-phase798`.
| ID | Item | Status |
|----|------|--------|
| P799-1 | `runGuildMeshTripleChannelSettingsJourney` 3-peer | [x] |
| P799-2 | `connectGuildMeshTriple` in settings journey | [x] |
| P799-3 | Matcher `channelSlowmodeAt` on both guests | [x] |
| P799-4 | Matcher `meshPeersMin` per peer | [x] |
| P799-5 | `syncGuildMeshTripleChrome` calls settings chrome | [x] |
| P799-6 | UI-flow `sync-guild-mesh-triple-channel-settings` IPC | [x] |
| P799-7 | Smoke `test:guild-mesh-triple-channel-settings-refresh` | [x] |
| P799-8 | Smoke `test:agentctl-phase799-guild-mesh-triple-chset` | [x] |
| P799-9 | Smoke `test:phase799-boot-gate` v0.8.766 | [x] |
| P799-10 | `test:ci-phase799` meta-bundle | [x] |
| P799-11 | Regression `test:ci-phase798` | [x] |
| P799-12 | Live 3-peer slowmode journey [SKIP] flaky | [SKIP] CI contract only |
| P799-13 | `SLOWMODE.md` triple fanout note | [x] |
| P799-14 | `AGENTCTL.md` Phase 799 | [x] |
| P799-15 | `PRODUCTION_MESH.md` triple slowmode | [x] |
| P799-16 | UI-flow README triple channel-settings | [x] |
| P799-17 | Agentctl README Phase 799 | [x] |
| P799-18 | `PEARCORD_PARITY.md` triple slowmode tier | [x] |
| P799-19 | 60s slowmode in triple journey | [x] |
| P799-20 | Triple `requestGuildSyncFanout` after slowmode | [x] |
| P799-21 | Version bump 0.8.766 | [x] |
| P799-22 | Changelog Phase 799 | [x] |
| P799-23 | Roadmap Now complete | [x] |
| P799-24 | `pear run` boot sign-off | [x] |
| P799-25 | Log scan (manual) | [x] |
| P799-26 | `DOCUMENTATION_INDEX` v0.8.766 | [x] |
| P799-27 | `MODULES.md` v0.8.766 | [x] |
| P799-28 | `SETTINGS.md` v0.8.766 | [x] |
| P799-29 | Release notes v0.8.766 | [x] |
| P799-30 | Push all repos | [x] |
| P799-31 | `test:doc-version-alignment` | [x] |
| P799-32 | Cross-link SLOWMODE ↔ PRODUCTION_MESH | [x] |
| P799-33 | `renderChatHeaderStatus` on triple chrome | [x] |
| P799-34 | `channel-settings` emit in triple IPC | [x] |
| P799-35 | `guild-sync-ready` channelSettings in triple IPC | [x] |
| P799-36 | `publicListing: false` in journey | [x] |
| P799-37 | `PEARCORD_SKIP_MESH_ROUNDTRIP` contract | [x] |
| P799-38 | Boot gates 780–798 accept 0.8.766 | [x] |
| P799-39 | `MESH_STABILITY.md` triple slowmode cross-link | [x] |
| P799-40 | Guest channel select before slowmode wait | [x] |
| P799-41 | `guild-mesh-topology` in triple-settings IPC | [x] |
| P799-42 | Phase 794 2-peer journey unchanged | [x] |
| P799-43 | `channelSettingsViewSignature` in smoke | [x] |
| P799-44 | Host peer counts in journey return | [x] |
| P799-45 | Both guests verify slowmode seconds | [x] |
| P799-46 | `syncChannelListDuringGuildLoading` on settings chrome | [x] |
| P799-47 | `sync-guild-mesh-triple-topic` unchanged | [x] |
| P799-48 | Platform README Phase 799 note | [x] |
| P799-49 | `sync-guild-channel-settings` unchanged | [x] |
| P799-50 | Push pearcord + agentctl + ui-flow + docs | [x] |
### Phase 798 — Guild 3-peer channel topic & forum tag fanout (v0.8.765) ✓
**Goal:** Host + two guests on live mesh; topic and forum palette propagate to both guests; triple topology refreshes topic chrome.
@@ -7988,6 +8048,7 @@ For deferred items, use `[SKIP]` and include a brief reason inline.
## Changelog
- 2026-06-04 - Completed Phase 799 guild 3-peer channel settings slowmode fanout (v0.8.766): `runGuildMeshTripleChannelSettingsJourney`, `sync-guild-mesh-triple-channel-settings`, `test:ci-phase799` (50/50). **Now:** await Backlog-selected phase.
- 2026-06-04 - Completed Phase 798 guild 3-peer channel topic & forum tag fanout (v0.8.765): `runGuildMeshTripleChannelTopicJourney`, `sync-guild-mesh-triple-topic`, `test:ci-phase798` (50/50). **Now:** await Backlog-selected phase.
- 2026-06-04 - Completed Phase 797 guild channel topic & forum tag mesh sync (v0.8.764): `runGuildMeshChannelTopicJourney`, `channelTopicViewSignature`, `test:ci-phase797` (50/50). **Now:** await Backlog-selected phase.
- 2026-06-04 - Completed Phase 796 guild 3-peer partition heal & presence reconcile (v0.8.763): `runGuildMeshTriplePartitionHealJourney`, `partition-heal-complete`, `test:ci-phase796` (50/50). **Now:** await Backlog-selected phase.
PRODUCTION_MESH.md
+6
View File
@@ -44,6 +44,12 @@ During server switch, the renderer sets `guildLoading` optimistically while the
Bundle: `npm run test:ci-phase780` (includes `test:guild-loading-state-push`, `test:guild-mesh-peer-retry`).
## 3-peer channel settings / slowmode (Phase 799, v0.8.766)
- `runGuildMeshTripleChannelSettingsJourney` — slowmode on both guests
- UI `syncGuildMeshTripleChrome` + `sync-guild-mesh-triple-channel-settings` IPC
- Bundle: `npm run test:ci-phase799`
## 3-peer topic & forum tags (Phase 798, v0.8.765)
- `runGuildMeshTripleChannelTopicJourney` — topic + palette on both guests
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.766 (Phase 799):** 3-peer channel slowmode fanout over live mesh. CI: `npm run test:ci-phase799`.
**v0.8.765 (Phase 798):** 3-peer channel topic and forum tag fanout. CI: `npm run test:ci-phase798`.
**v0.8.764 (Phase 797):** Channel topic and forum tag palette mesh refresh on gossip. CI: `npm run test:ci-phase797`.
SLOWMODE.md
+2
View File
@@ -1,5 +1,7 @@
# Channel slowmode
**v0.8.766 (Phase 799):** 3-peer slowmode fanout — `runGuildMeshTripleChannelSettingsJourney`, `sync-guild-mesh-triple-channel-settings`. Bundle: `npm run test:ci-phase799`.
**v0.8.761 (Phase 794):** Remote slowmode changes refresh header badge on mesh gossip without full guild reload — worker `channelSettingsViewSignature`, UI `syncGuildChannelSettingsChrome`, `guild-sync-ready` with `channelSettings`, agentctl `runGuildMeshChannelSettingsJourney`. Bundle: `npm run test:ci-phase794`. See [PRODUCTION_MESH.md](./PRODUCTION_MESH.md).
Pearcord enforces **per-channel slowmode** locally on each peer. There is no central rate limiter; each client applies the same rules from replicated settings.
release_notes/RELEASE_v0.8.766.md
+8
View File
@@ -0,0 +1,8 @@
# Release v0.8.766 — Phase 799
Guild 3-peer channel settings (slowmode) fanout: both guests receive slowmode over triple mesh; header badge refreshes on topology recovery.
- Agentctl: `runGuildMeshTripleChannelSettingsJourney`
- UI: `syncGuildMeshTripleChrome` includes `syncGuildChannelSettingsChrome`
- UI-flow: `sync-guild-mesh-triple-channel-settings`
- CI: `npm run test:ci-phase799`