docs(phase967): update roadmap, release notes, and module docs for v0.8.934

- PLATFORM_ROADMAP.md: all Phase 967 items marked complete, Phase 968 queued - RELEASE_v0.8.934.md: new release notes for guild mesh churn stats extract - MODULES.md: app release version → 0.8.934, test:ci-phase967 added - pearcord-platform/README.md: Phase 967 module table added Co-authored-by: Cursor <[email protected]>
2026-06-05 03:29:42 -04:00
parent 1ca017d575
commit b502300a00
3 changed files with 96 additions and 47 deletions
@@ -0,0 +1,47 @@
+# Release v0.8.934 — Phase 967: Guild Mesh Churn Stats Extract + Peer Join/Leave Keys
+
+**Date:** 2026-06-05
+**Type:** Non-breaking refactor — Guild mesh production hardening
+
+## Summary
+
+Phase 967 centralises all guild mesh churn event payload construction into a new dedicated module
+(`guild-mesh-churn-stats-build.js`), eliminating ad-hoc inline object literals spread across four
+mixin files.  Zero externally visible behavior changes.
+
+## New Module
+
+### `pearcord-platform/guild-mesh-churn-stats-build`
+
+Exports:
+
+- **Key registries** — `meshChurnLogBaseFieldKeys`, `meshChurnPeerJoinLeaveFieldKeys`,
+  `meshChurnStaleEvictFieldKeys`, `meshChurnPushPeerSlotFieldKeys`, `meshChurnGossipFlushFieldKeys`
+- **Listers** — `listMeshChurn*FieldKeys()` (return copies, safe for external consumers)
+- **Builders** — `buildMeshChurnPeerJoinSnapshot`, `buildMeshChurnPeerLeaveSnapshot`,
+  `buildMeshChurnStaleEvictSnapshot`, `buildMeshChurnPushPeerSlotSnapshot`,
+  `buildMeshChurnGossipFlushSnapshot`
+
+All builders default-safe: missing inputs produce correctly typed zero-values.
+
+## Call-site Wiring (non-breaking)
+
+| File | Change |
+|------|--------|
+| `platform-guild-wire-mixin.js` | `peer-join` and `peer-leave` logs delegate to builders |
+| `platform-guild-mesh-peer-mixin.js` | `stale-peer-evict` log delegates to builder |
+| `platform-guild-gossip-outbox-mixin.js` | `gossip-outbox-flush` logs delegate to builder |
+| `platform-guild-sync-export-mixin.js` | `push-peer-slot` log delegates to builder |
+
+## Test Coverage
+
+- `smoke-guild-mesh-churn-stats-build.cjs` — unit tests for all exports
+- `smoke-phase967-boot-gate.cjs` — structural verification + version check (0.8.934)
+- `smoke-agentctl-guild-mesh-churn-stats-journey-stub.cjs` — agentctl integration stub
+- `test:mesh-stability-stats` — extended with churn peer join/leave key assertions
+- `test:gossip-rpc-pull-unit` — extended with all churn builder unit assertions
+- `test:ci-phase967` — full CI bundle (all pass)
+
+## Version
+
+`0.8.933` → `0.8.934`