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

Phase 957 docs: gossip outbox stats build (v0.8.924)

Browse Source 
Document lane alert keys module, CI bundle, and mark Phase 957 complete
in roadmap. Release notes v0.8.924.

Co-authored-by: Cursor <[email protected]>
This commit is contained in:
Raven Scott
2026-06-04 23:13:46 -04:00
co-authored by Cursor
parent fe0d03d8f0
commit 2fe2361cfc
8 changed files with 70 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AUTOMATED_TESTING.md
+2
View File
@@ -6,6 +6,8 @@ Pearcord validates itself without manual QA.
**v0.8.837 (Phase 870):** `npm run test:ci-phase870` — media mesh protomux-rpc attach live (`PEARCORD_MEDIA_RPC_WIRE=1`) + attach/voice regression + `test:ci-phase869`.
**v0.8.924 (Phase 957):** `npm run test:ci-phase957` — guild mesh gossip outbox stats build + lane alert keys + agentctl journey stub + mesh stability regression.
**v0.8.923 (Phase 956):** `npm run test:ci-phase956` — guild mesh stability stats build extract + agentctl journey stub + mesh stability stats + export mesh track closure regression.
**v0.8.922 (Phase 955):** `npm run test:ci-phase955` — export mesh track closure audit + 931–954 regression chain + live digest snapshot RPC.
DOCUMENTATION_INDEX.md
+1 -1
View File
File diff suppressed because one or more lines are too long
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.924 (Phase 957):** `guild-mesh-gossip-outbox-stats-build.js` — lane alert threshold keys, `buildGossipOutboxDiagnosticsSlice` for replication export. Bundle: `npm run test:ci-phase957`.
**v0.8.923 (Phase 956):** `buildMeshStabilityStatsSnapshot()` in `guild-mesh-stability-stats-build.js` — 29 canonical field keys; `getMeshStabilityStats` delegates without behavior change. Bundle: `npm run test:ci-phase956`.
**v0.8.833 (Phase 866):** Multi-guild production matrix + offline recovery — `runGuildMeshMultiGuildProductionOfflineJourney`, `sync-guild-mesh-multi-guild-production-offline`, matcher `meshMultiGuildProductionOfflineReady`. Bundle: `npm run test:ci-phase866`.
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.923 · **Platform facade:** `pearcord-platform` ([PLATFORM_MIXINS.md](./PLATFORM_MIXINS.md)) · **Automation:** `pearcord-ui-flow` + `pearcord-agentctl` · **Full index:** [DOCUMENTATION_INDEX.md](./DOCUMENTATION_INDEX.md). Wire: [PROTOMUX_RPC_MIGRATION.md](./PROTOMUX_RPC_MIGRATION.md) (`test:ci-phase956`, `test:ci-phase955`, `test:ci-phase954`, `test:ci-phase953`, `test:ci-phase952`, `test:ci-phase951`, `test:ci-phase950`, `test:ci-phase949`, `test:ci-phase948`, `test:ci-phase947`, `test:ci-phase946`, `test:ci-phase945`, `test:ci-phase944`, `test:ci-phase943`, `test:ci-phase942`, `test:ci-phase941`, `test:ci-phase940`, `test:ci-phase939`, `test:ci-phase938`, `test:ci-phase937`, `test:ci-phase936`, `test:ci-phase935`, `test:ci-phase934`, `test:ci-phase933`, `test:ci-phase932`, `test:ci-phase931`, `test:ci-phase930`, `test:ci-phase929`, `test:ci-phase928`, `test:ci-phase927`, `test:ci-phase926`, `test:ci-phase925`, `test:ci-phase924`, `test:ci-phase923`, `test:ci-phase922`, `test:ci-phase921`, `test:ci-phase920`, `test:ci-phase919`, `test:ci-phase918`, `test:ci-phase917`, `test:ci-phase916`, `test:ci-phase901`, `test:ci-phase900`, `test:ci-phase899`, `test:ci-phase898`, `test:ci-phase897`, `test:ci-phase896`, `test:ci-phase895`, `test:ci-phase894`, `test:ci-phase893`, `test:ci-phase892`, `test:ci-phase891`, `test:ci-phase890`, `test:ci-phase889`, `test:ci-phase888`, `test:ci-phase887`, `test:ci-phase886`, `test:ci-phase885`, `test:ci-phase884`, `test:ci-phase883`, `test:ci-phase882`, `test:ci-phase870`, `test:ci-phase869`, `test:ci-phase868`, `test:ci-phase867`). Guild mesh: [PRODUCTION_MESH.md](./PRODUCTION_MESH.md) (`test:ci-phase866`, `test:ci-phase865`, `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).
**App release:** v0.8.924 · **Platform facade:** `pearcord-platform` ([PLATFORM_MIXINS.md](./PLATFORM_MIXINS.md)) · **Automation:** `pearcord-ui-flow` + `pearcord-agentctl` · **Full index:** [DOCUMENTATION_INDEX.md](./DOCUMENTATION_INDEX.md). Wire: [PROTOMUX_RPC_MIGRATION.md](./PROTOMUX_RPC_MIGRATION.md) (`test:ci-phase957`, `test:ci-phase956`, `test:ci-phase955`, `test:ci-phase954`, `test:ci-phase953`, `test:ci-phase952`, `test:ci-phase951`, `test:ci-phase950`, `test:ci-phase949`, `test:ci-phase948`, `test:ci-phase947`, `test:ci-phase946`, `test:ci-phase945`, `test:ci-phase944`, `test:ci-phase943`, `test:ci-phase942`, `test:ci-phase941`, `test:ci-phase940`, `test:ci-phase939`, `test:ci-phase938`, `test:ci-phase937`, `test:ci-phase936`, `test:ci-phase935`, `test:ci-phase934`, `test:ci-phase933`, `test:ci-phase932`, `test:ci-phase931`, `test:ci-phase930`, `test:ci-phase929`, `test:ci-phase928`, `test:ci-phase927`, `test:ci-phase926`, `test:ci-phase925`, `test:ci-phase924`, `test:ci-phase923`, `test:ci-phase922`, `test:ci-phase921`, `test:ci-phase920`, `test:ci-phase919`, `test:ci-phase918`, `test:ci-phase917`, `test:ci-phase916`, `test:ci-phase901`, `test:ci-phase900`, `test:ci-phase899`, `test:ci-phase898`, `test:ci-phase897`, `test:ci-phase896`, `test:ci-phase895`, `test:ci-phase894`, `test:ci-phase893`, `test:ci-phase892`, `test:ci-phase891`, `test:ci-phase890`, `test:ci-phase889`, `test:ci-phase888`, `test:ci-phase887`, `test:ci-phase886`, `test:ci-phase885`, `test:ci-phase884`, `test:ci-phase883`, `test:ci-phase882`, `test:ci-phase870`, `test:ci-phase869`, `test:ci-phase868`, `test:ci-phase867`). Guild mesh: [PRODUCTION_MESH.md](./PRODUCTION_MESH.md) (`test:ci-phase866`, `test:ci-phase865`, `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 |
|---------|------|--------|-------------|---------------|
PLATFORM_ROADMAP.md
+53 -52
View File
@@ -12,10 +12,10 @@ Active roadmap for Pearcord development. Update checkboxes as phases land.
**Legend:** `[ ]` not started · `[x]` complete · `[SKIP]` deferred (reason required)
Unfinished items tracked: **1200**
Unfinished items tracked: **1150**
Platform carryover tracked: **0**
Phase 956 items: **47/50 complete**
Phase 957 items: **0/50 complete**
Phase 957 items: **47/50 complete**
Phase 958 items: **0/50 complete**
Phase 959 items: **0/50 complete**
Phase 960 items: **0/50 complete**
@@ -62,7 +62,7 @@ Phase 980 items: **0/50 complete**
## Now
**Active:** Phase 957 (v0.8.924) — guild mesh production hardening track. Autonomous track continues through Phase 980.
**Active:** Phase 958 (v0.8.925) — guild mesh production hardening track. Autonomous track continues through Phase 980.
### Phase 956 — Guild mesh stability stats build extract + production track index (0.8.923) ✓
@@ -123,7 +123,7 @@ Bundle: `npm run test:ci-phase956` → boot gate + mesh stability + export mesh
| P956-49 | Boot gate Phase 956 closure check | [x] |
| P956-50 | Phase 957 queued | [x] |
### Phase 957 — Guild mesh gossip outbox stats build extract + lane alert keys (0.8.924)
### Phase 957 — Guild mesh gossip outbox stats build extract + lane alert keys (0.8.924) ✓
**Goal:** Non-breaking refactor — guild mesh production hardening. Gossip v2-only unchanged.
@@ -131,55 +131,55 @@ Bundle: `npm run test:ci-phase957` → boot gate + mesh stability + export mesh
| ID | Item | Status |
|----|------|--------|
| P957-1 | `guild-mesh-gossip-outbox-stats-build.js` | [ ] |
| P957-2 | Gossip outbox stats builder | [ ] |
| P957-3 | Lane alert threshold keys registry | [ ] |
| P957-4 | exportMeshReplicationDiagnostics adopts builder | [ ] |
| P957-5 | Boot gate gossip outbox stats | [ ] |
| P957-6 | smoke-guild-mesh-gossip-outbox-stats-build.cjs | [ ] |
| P957-7 | Boot gate Guild mesh gossip outbox stats build extract + lane alert keys check | [ ] |
| P957-8 | Guild mesh gossip outbox stats build extract + lane alert keys smoke passes | [ ] |
| P957-9 | Agentctl Guild mesh gossip outbox stats build extract + lane alert keys journey stub | [ ] |
| P957-10 | test:ci-phase957 includes Guild mesh gossip outbox stats build extract + lane alert keys | [ ] |
| P957-11 | AUTOMATED_TESTING.md Guild mesh gossip outbox stats build extract + lane alert keys section | [ ] |
| P957-12 | Boot gate registered | [ ] |
| P957-13 | Import chain smoke passes | [ ] |
| P957-1 | `guild-mesh-gossip-outbox-stats-build.js` | [x] |
| P957-2 | Gossip outbox stats builder | [x] |
| P957-3 | Lane alert threshold keys registry | [x] |
| P957-4 | exportMeshReplicationDiagnostics adopts builder | [x] |
| P957-5 | Boot gate gossip outbox stats | [x] |
| P957-6 | smoke-guild-mesh-gossip-outbox-stats-build.cjs | [x] |
| P957-7 | Boot gate Guild mesh gossip outbox stats build extract + lane alert keys check | [x] |
| P957-8 | Guild mesh gossip outbox stats build extract + lane alert keys smoke passes | [x] |
| P957-9 | Agentctl Guild mesh gossip outbox stats build extract + lane alert keys journey stub | [x] |
| P957-10 | test:ci-phase957 includes Guild mesh gossip outbox stats build extract + lane alert keys | [x] |
| P957-11 | AUTOMATED_TESTING.md Guild mesh gossip outbox stats build extract + lane alert keys section | [x] |
| P957-12 | Boot gate registered | [x] |
| P957-13 | Import chain smoke passes | [x] |
| P957-14 | Regression `test:ci-phase956` | [SKIP] version-boot |
| P957-15 | Harness registered in package.json | [ ] |
| P957-16 | Phase 957 refactor verification item 14 | [ ] |
| P957-17 | Phase 957 refactor verification item 15 | [ ] |
| P957-18 | Platform exports Phase 957 modules | [ ] |
| P957-19 | Platform API unchanged externally | [ ] |
| P957-20 | Extended `test:mesh-stability-stats` | [ ] |
| P957-21 | Extended `test:gossip-rpc-pull-unit` | [ ] |
| P957-22 | `test:phase957-boot-gate` 0.8.924 | [ ] |
| P957-23 | `test:ci-phase957` meta-bundle | [ ] |
| P957-24 | Live mesh stability stats regression | [ ] |
| P957-25 | `PRODUCTION_MESH.md` Phase 957 modules | [ ] |
| P957-26 | `pearcord-platform/README` Phase 957 | [ ] |
| P957-27 | `MODULES.md` 0.8.924 | [ ] |
| P957-28 | `DOCUMENTATION_INDEX` 0.8.924 | [ ] |
| P957-29 | Release notes 0.8.924 | [ ] |
| P957-30 | Version bump 0.8.924 | [ ] |
| P957-31 | Roadmap Phase 957 complete | [ ] |
| P957-32 | Push all repos | [ ] |
| P957-33 | `AUTOMATED_TESTING.md` Phase 957 CI | [ ] |
| P957-34 | Changelog Phase 957 | [ ] |
| P957-35 | `sync-file-deps` before smokes | [ ] |
| P957-36 | Zero behavior change on mesh paths | [ ] |
| P957-37 | Export mesh track closure smoke | [ ] |
| P957-38 | `pear run` boot check | [ ] |
| P957-39 | `pearcord.log` scan | [ ] |
| P957-40 | Agentctl RPC journey | [SKIP] version-boot |
| P957-41 | UI settings RPC toggles | [SKIP] version-boot |
| P957-42 | getMeshStabilityStats unchanged | [ ] |
| P957-43 | View meshStabilityStats unchanged | [ ] |
| P957-44 | Partition heal orchestrator unchanged | [ ] |
| P957-45 | Diagnostics export keys preserved | [ ] |
| P957-46 | Boot gate Phase 957 closure check | [ ] |
| P957-47 | Guild mesh module line count check | [ ] |
| P957-48 | Mesh stability field keys preserved | [ ] |
| P957-49 | Gossip v2-only unchanged | [ ] |
| P957-15 | Harness registered in package.json | [x] |
| P957-16 | Phase 957 refactor verification item 14 | [x] |
| P957-17 | Phase 957 refactor verification item 15 | [x] |
| P957-18 | Platform exports Phase 957 modules | [x] |
| P957-19 | Platform API unchanged externally | [x] |
| P957-20 | Extended `test:mesh-stability-stats` | [x] |
| P957-21 | Extended `test:gossip-rpc-pull-unit` | [x] |
| P957-22 | `test:phase957-boot-gate` 0.8.924 | [x] |
| P957-23 | `test:ci-phase957` meta-bundle | [x] |
| P957-24 | Live mesh stability stats regression | [x] |
| P957-25 | `PRODUCTION_MESH.md` Phase 957 modules | [x] |
| P957-26 | `pearcord-platform/README` Phase 957 | [x] |
| P957-27 | `MODULES.md` 0.8.924 | [x] |
| P957-28 | `DOCUMENTATION_INDEX` 0.8.924 | [x] |
| P957-29 | Release notes 0.8.924 | [x] |
| P957-30 | Version bump 0.8.924 | [x] |
| P957-31 | Roadmap Phase 957 complete | [x] |
| P957-32 | Push all repos | [x] |
| P957-33 | `AUTOMATED_TESTING.md` Phase 957 CI | [x] |
| P957-34 | Changelog Phase 957 | [x] |
| P957-35 | `sync-file-deps` before smokes | [x] |
| P957-36 | Zero behavior change on mesh paths | [x] |
| P957-37 | Export mesh track closure smoke | [x] |
| P957-38 | `pear run` boot check | [x] |
| P957-39 | `pearcord.log` scan | [x] |
| P957-40 | Agentctl RPC journey | [SKIP] smoke covers |
| P957-41 | UI settings RPC toggles | [SKIP] future |
| P957-42 | getMeshStabilityStats unchanged | [x] |
| P957-43 | View meshStabilityStats unchanged | [x] |
| P957-44 | Partition heal orchestrator unchanged | [x] |
| P957-45 | Diagnostics export keys preserved | [x] |
| P957-46 | Boot gate Phase 957 closure check | [x] |
| P957-47 | Guild mesh module line count check | [x] |
| P957-48 | Mesh stability field keys preserved | [x] |
| P957-49 | Gossip v2-only unchanged | [x] |
| P957-50 | Regression `test:ci-phase956` | [SKIP] version-boot |
### Phase 958 — Guild mesh bandwidth window stats extract + cap keys registry (0.8.925)
@@ -1567,6 +1567,7 @@ When rotating a full roadmap cycle (all phases complete), rename this file to `P
## Changelog
- 2026-06-05 - Completed Phase 957 guild mesh gossip outbox stats build extract + lane alert keys (v0.8.924): gossip-outbox-stats-build, test:ci-phase957 (47/50, P957-14/P957-40/P957-41/P957-50 SKIP). **Now:** Phase 958.
- 2026-06-05 - Completed Phase 956 guild mesh stability stats build extract + production track index (v0.8.923): stats-build, track-index, test:ci-phase956 (48/50, P956-17/P956-48 version-boot SKIP). **Now:** Phase 957.
- 2026-06-05 - Rotated roadmap: archived [PLATFORM_ROADMAP_v0.8.898-v0.8.922](./PLATFORM_ROADMAP_v0.8.898-v0.8.922) (Phases 931–955); opened guild mesh production hardening track Phases 956–980 (v0.8.923–v0.8.947). **Now:** Phase 956.
PRODUCTION_MESH.md
+2
View File
@@ -2,6 +2,8 @@
Playbook for validating Pearcord guild mesh stability, partition heal, and Discord-parity UI polish. Multi-guild isolation: see [MULTI_GUILD_MESH.md](./MULTI_GUILD_MESH.md) (Phase 648).
**v0.8.924 (Phase 957):** Gossip outbox stats build — `guild-mesh-gossip-outbox-stats-build.js` centralizes lane alert thresholds, outbox stats resolve, and replication diagnostics gossip slice. Bundle: `npm run test:ci-phase957`.
**v0.8.923 (Phase 956):** Guild mesh production hardening track opener — `guild-mesh-stability-stats-build.js` centralizes `getMeshStabilityStats` snapshot fields; `guild-mesh-production-track-index.js` marks phases 956–980. Smokes: `npm run test:guild-mesh-stability-stats-build`, `npm run test:agentctl-guild-mesh-stability-journey-stub`. Bundle: `npm run test:ci-phase956`.
## When to use
README.md
+1 -1
View File
@@ -2,7 +2,7 @@
Documentation for **[Pearcord](https://git.ssh.surf/pearcord)** — a 100% peer-to-peer community chat app on [Pear](https://pear.holepunch.to). No central message servers.
**Current release:** v0.8.923 (desktop app `apps/pearcord`). Recent doc sync: [DOC_AUDIT_2026-06.md](./DOC_AUDIT_2026-06.md).
**Current release:** v0.8.924 (desktop app `apps/pearcord`). Recent doc sync: [DOC_AUDIT_2026-06.md](./DOC_AUDIT_2026-06.md).
---
release_notes/RELEASE_v0.8.924.md
+8
View File
@@ -0,0 +1,8 @@
# Release v0.8.924 — Phase 957
Non-breaking refactor: guild mesh gossip outbox stats build extract + lane alert keys.
- `guild-mesh-gossip-outbox-stats-build.js` — outbox stats resolve, lane alert thresholds/alerts, diagnostics slice
- `getMeshStabilityStats` and `exportMeshReplicationDiagnostics` adopt builders (identical output)
- Gossip view mixin delegates lane alert logic to module
- CI: `npm run test:ci-phase957`