docs: mark P410-16 stale peer eviction complete

Document eviction env knobs, logging, and the new platform smoke test.

Co-authored-by: Cursor <[email protected]>
This commit is contained in:
Raven Scott
2026-06-02 11:23:56 -04:00
co-authored by Cursor
parent e756db5b67
commit 605c668031
2 changed files with 5 additions and 2 deletions
+2
View File
@@ -128,6 +128,8 @@ Worker boot profiling now emits explicit spans for startup triage: `runtime.boot
**v0.8.374 (Phase 411):** Dev log clipboard + save JSONL meta include `mode` (`home`, `dm`, `guild`) for inbox debugging. **Voice errors** filter bundle re-verified. Smoke: `npm run test:dev-log-clipboard-mode`, `npm run test:dev-log-voice-errors-bundle`.
**Phase 410 (P410-16):** Stale guild mesh peer eviction logs at **info** as `guild mesh stale peer evicted` with `peerRetryAttempt`, `lastPeerSeenAt`, `idleMs`, and `connAgeMs`. Interval sweep via `PEARCORD_GUILD_MESH_PEER_SWEEP_MS` (default 60s). Smoke: `npm run test:platform-guild-mesh-stale-peer-evict`.
**Phase 410 (P410-15):** Platform emits `guild mesh join coalesced` / `guild mesh join skipped (stale load)` at **debug** when duplicate `joinMesh` attempts collapse during guild open, peer retry, or startup/switch races. Smoke: `npm run test:platform-guild-mesh-join-coalesce`.
**v0.8.394 (Phase 431):** Dev-log clipboard/save JSONL `emojiCount` unchanged. **Emoji errors** filter unchanged. Guild mesh **peer retry** after open with zero peers (`guild mesh peer retry` debug spans). Smokes: `npm run test:phase431-emoji-stickers`, `npm run test:guild-mesh-peer-retry`. Agentctl: `npm run test:agentctl-phase431-emoji`.
+3 -2
View File
@@ -5,7 +5,7 @@ Focused roadmap of unfinished items extracted from `PLATFORM_ROADMAP_v0.1-v0.8.6
**Legend:** `[ ]` not started
**Legend:** `[SKIP]` skip for now
Unfinished items tracked: **339**
Unfinished items tracked: **338**
Skipped items tracked: **1**
---
@@ -41,7 +41,7 @@ Primary in-flight work. Move completed items to `[x]` and add a changelog line.
- [x] **P410-13 Networking:** Added automatic header “Mesh bounded” badge with live retry countdown + explanatory tooltip, backed by `guildSyncHealthRail` retry metadata (`retryAttempt`, `nextRetryAt`, `retryCountdownMs`).
- [x] **P410-14 Networking:** Added `_computeGuildMeshPeerRetryDelayMs` so mesh peer retries space by `lastPeerSeenAt`/`lastSuccessfulPeerContactAt` staleness (with RTT floor/cap) instead of fixed attempt-index cadence only.
- [x] **P410-15 Networking:** Added `_requestGuildMeshJoin` coalescing (stale `loadGen` skip, guild-switch/leave abort) plus guild-layer `_meshJoinInFlight` guard against concurrent `swarm.join` during startup/switch races.
- [ ] **P410-16 Networking:** Add stale peer eviction path with metrics (`peerRetryAttempt`, `lastPeerSeenAt`).
- [x] **P410-16 Networking:** Added stale guild mesh peer eviction (`_evictStaleGuildMeshPeers`, interval sweep) with health-rail metrics (`peerRetryAttempt`, `lastPeerSeenAt`, `stalePeersEvictedLast`/`Total`).
- [ ] **P410-17 Reliability:** Add channel-level consistency audit for pins/reactions/messages mismatch during view build.
- [ ] **P410-18 Reliability:** Add safety path when `activeChannelId` disappears mid-render (fallback without noisy errors).
- [ ] **P410-19 Reliability:** Add startup recovery branch for partial userPrefs writes with automatic repair backup.
@@ -511,6 +511,7 @@ For deferred items, use `[SKIP]` and include a brief reason inline.
## Changelog
- 2026-06-02 - Completed P410-16 by evicting idle guild mesh peers after configurable staleness, tracking per-peer `lastSeenAt`, and surfacing `peerRetryAttempt`/`lastPeerSeenAt`/eviction totals in `guildSyncHealthRail`; smoke: `npm run test:platform-guild-mesh-stale-peer-evict`.
- 2026-06-02 - Completed P410-15 by coalescing guild mesh joins at the platform layer (`_requestGuildMeshJoin`) and deduplicating in-flight `joinMesh` calls in `pearcord-guild`; smoke: `npm run test:platform-guild-mesh-join-coalesce`.
- 2026-06-02 - Completed P410-14 by spacing guild mesh peer retries from last successful peer contact (`lastPeerSeenAt`) with bounded min/max delays, `spacingSource` diagnostics, and targeted spacing smoke coverage.
- 2026-06-02 - Completed P410-13 by adding an automatic mesh-bounded-mode header badge with retry countdown + explanation tooltip, and exposing per-guild retry timing metadata in `guildSyncHealthRail`.