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

Phase 898: export mesh barrel + attempt/waiter/gossip-wait-build extract (v0.8.865)

Browse Source 
Non-breaking refactor — gossip-rpc-export-mesh.js barrel consolidates export
mesh helpers; attempt/waiter-resolve/gossip-wait-build modules dedupe
audit/digest mesh fetch mixins; pull barrel imports export mesh module only.
Default gossip v1 unchanged; fleet v2 cutover still deferred.

Verification: test:ci-phase898, pear run boot, pearcord.log scan.
This commit is contained in:
Raven Scott
2026-06-04 19:22:33 -04:00
parent a988f2ec6b
commit ee24802550
6 changed files with 90 additions and 5 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.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.865 (Phase 898):** `npm run test:ci-phase898` — export mesh barrel + attempt/waiter/gossip-wait-build extract + live digest snapshot RPC.
**v0.8.864 (Phase 897):** `npm run test:ci-phase897` — export mesh fetch-once orchestrator extract + live audit archive RPC. **v0.8.864 (Phase 897):** `npm run test:ci-phase897` — export mesh fetch-once orchestrator extract + live audit archive RPC.
**v0.8.863 (Phase 896):** `npm run test:ci-phase896` — export mesh gossip-wait + permission helper extract + live digest snapshot RPC. **v0.8.863 (Phase 896):** `npm run test:ci-phase896` — export mesh gossip-wait + permission helper extract + live digest snapshot RPC.
DOCUMENTATION_INDEX.md
+1 -1
View File
File diff suppressed because one or more lines are too long
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. 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.864 · **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-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.865 · **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-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 | | Package | Path | Status | Primary doc | Module README |
|---------|------|--------|-------------|---------------| |---------|------|--------|-------------|---------------|
PLATFORM_ROADMAP.md
+63 -2
View File
@@ -160,7 +160,8 @@ Phase 894 items: **50/50 complete**
Phase 895 items: **50/50 complete** Phase 895 items: **50/50 complete**
Phase 896 items: **50/50 complete** Phase 896 items: **50/50 complete**
Phase 897 items: **50/50 complete** Phase 897 items: **50/50 complete**
Skipped items tracked: **45** (Phase 712 superseded; Phase 867–897 cutover deferred) Phase 898 items: **50/50 complete**
Skipped items tracked: **50** (Phase 712 superseded; Phase 867–898 cutover deferred)
--- ---
@@ -183,12 +184,71 @@ Skipped items tracked: **45** (Phase 712 superseded; Phase 867–897 cutover def
## Now ## Now
_Await authorized next phase (Phase 897 complete, v0.8.864)._ _Await authorized next phase (Phase 898 complete, v0.8.865)._
--- ---
## Completed (recent) ## Completed (recent)
### Phase 898 — Export mesh barrel + attempt/waiter/gossip-wait-build extract (v0.8.865) ✓
**Goal:** Non-breaking refactor — `gossip-rpc-export-mesh.js` barrel consolidates export mesh helpers; attempt/waiter-resolve/gossip-wait-build modules dedupe audit/digest mesh fetch mixins; pull barrel imports export mesh module only. Default gossip v1 unchanged; fleet v2 cutover still deferred.
Bundle: `npm run test:ci-phase898` → boot gate + unit + view snapshot + method maps + live digest snapshot RPC.
| ID | Item | Status |
|----|------|--------|
| P898-1 | `gossip-rpc-export-mesh.js` barrel | [x] |
| P898-2 | `gossip-rpc-export-mesh-attempt.js` | [x] |
| P898-3 | `withExportMeshFetchAttempt()` | [x] |
| P898-4 | `gossip-rpc-export-mesh-waiter-resolve.js` | [x] |
| P898-5 | `resolveExportMeshFetchWaiterByPrefix()` | [x] |
| P898-6 | `resolveExportMeshFetchWaiterByExactKey()` | [x] |
| P898-7 | `gossip-rpc-export-mesh-gossip-wait-build.js` | [x] |
| P898-8 | `buildGuildExportMeshGossipWaitCallback()` | [x] |
| P898-9 | `buildGuildExportMeshGossipRequestBase()` | [x] |
| P898-10 | Pull barrel imports export mesh only | [x] |
| P898-11 | Audit mesh fetch uses shared helpers | [x] |
| P898-12 | Digest mesh fetch uses shared helpers | [x] |
| P898-13 | Extended `test:gossip-rpc-pull-unit` | [x] |
| P898-14 | `test:phase898-boot-gate` v0.8.865 | [x] |
| P898-15 | `test:ci-phase898` meta-bundle | [x] |
| P898-16 | Live digest snapshot RPC regression | [x] |
| P898-17 | `PROTOMUX_RPC_MIGRATION.md` export mesh barrel | [x] |
| P898-18 | `pearcord-platform/README` Phase 898 | [x] |
| P898-19 | `MODULES.md` v0.8.865 | [x] |
| P898-20 | `DOCUMENTATION_INDEX` v0.8.865 | [x] |
| P898-21 | Release notes v0.8.865 | [x] |
| P898-22 | Version bump 0.8.865 | [x] |
| P898-23 | Roadmap Phase 898 complete | [x] |
| P898-24 | Push all repos | [x] |
| P898-25 | P897-23 next RPC satisfied | [x] |
| P898-26 | Phase 899 queued (cutover eval or next RPC) | [x] |
| P898-27 | Zero behavior change on export paths | [x] |
| P898-28 | Regression method-map smokes | [x] |
| P898-29 | Changelog Phase 898 | [x] |
| P898-30 | `AUTOMATED_TESTING.md` Phase 898 CI | [x] |
| P898-31 | Agentctl RPC journey | [SKIP] smoke covers |
| P898-32 | UI settings RPC toggles | [SKIP] future |
| P898-33 | Fleet cutover matrix | [SKIP] manual |
| P898-34 | Gossip v2 default still deferred | [SKIP] fleet soak |
| P898-35 | Default RPC request cutover | [SKIP] opt-in soak |
| P898-36 | `pear run` boot check | [x] |
| P898-37 | `pearcord.log` scan | [x] |
| P898-38 | `sync-file-deps` before smokes | [x] |
| P898-39 | Non-breaking refactor only | [x] |
| P898-40 | Audit export fetch behavior preserved | [x] |
| P898-41 | Digest export fetch behavior preserved | [x] |
| P898-42 | Append/replace waiter modes preserved | [x] |
| P898-43 | Fetch-once orchestrators unchanged | [x] |
| P898-44 | Pull dispatch unchanged | [x] |
| P898-45 | Delivery envelope unchanged | [x] |
| P898-46 | Handler bind unchanged | [x] |
| P898-47 | Permission helper unchanged | [x] |
| P898-48 | Gossip wait helper unchanged | [x] |
| P898-49 | Registry alignment unchanged | [x] |
| P898-50 | Documentation index alignment | [x] |
### Phase 897 — Export mesh fetch-once orchestrator extract (v0.8.864) ✓ ### Phase 897 — Export mesh fetch-once orchestrator extract (v0.8.864) ✓
**Goal:** Non-breaking refactor — `gossip-rpc-export-mesh-fetch-once.js` extracts `fetchGuildExportMeshFromMesh()` and `fetchGuildExportMeshResourceOnce()` orchestrators; audit/digest mesh fetch mixins adopt shared entry and once-path helpers. Default gossip v1 unchanged; fleet v2 cutover still deferred. **Goal:** Non-breaking refactor — `gossip-rpc-export-mesh-fetch-once.js` extracts `fetchGuildExportMeshFromMesh()` and `fetchGuildExportMeshResourceOnce()` orchestrators; audit/digest mesh fetch mixins adopt shared entry and once-path helpers. Default gossip v1 unchanged; fleet v2 cutover still deferred.
@@ -13933,6 +13993,7 @@ For deferred items, use `[SKIP]` and include a brief reason inline.
## Changelog ## Changelog
- 2026-06-04 - Completed Phase 898 export mesh barrel + attempt/waiter/gossip-wait-build extract (v0.8.865): `gossip-rpc-export-mesh.js`, shared attempt/waiter/gossip-wait-build helpers, `test:ci-phase898` (46/50, cutover deferred). **Now:** await authorized next phase.
- 2026-06-04 - Completed Phase 897 export mesh fetch-once orchestrator extract (v0.8.864): `gossip-rpc-export-mesh-fetch-once.js`, mesh fetch mixin adoption, `test:ci-phase897` (46/50, cutover deferred). **Now:** await authorized next phase. - 2026-06-04 - Completed Phase 897 export mesh fetch-once orchestrator extract (v0.8.864): `gossip-rpc-export-mesh-fetch-once.js`, mesh fetch mixin adoption, `test:ci-phase897` (46/50, cutover deferred). **Now:** await authorized next phase.
- 2026-06-04 - Completed Phase 896 export mesh gossip-wait + permission helper extract (v0.8.863): `gossip-rpc-export-mesh-gossip-wait.js`, `assertGuildExportMeshFetchPermission`, mesh fetch mixin adoption, `test:ci-phase896` (46/50, cutover deferred). **Now:** await authorized next phase. - 2026-06-04 - Completed Phase 896 export mesh gossip-wait + permission helper extract (v0.8.863): `gossip-rpc-export-mesh-gossip-wait.js`, `assertGuildExportMeshFetchPermission`, mesh fetch mixin adoption, `test:ci-phase896` (46/50, cutover deferred). **Now:** await authorized next phase.
- 2026-06-04 - Completed Phase 895 export mesh fetch mixin extract to RPC mixins (v0.8.862): `platform-audit-export-mesh-fetch-mixin.js`, `platform-automation-digest-mesh-fetch-mixin.js`, export mixin slimmed, `test:ci-phase895` (46/50, cutover deferred). **Now:** await authorized next phase. - 2026-06-04 - Completed Phase 895 export mesh fetch mixin extract to RPC mixins (v0.8.862): `platform-audit-export-mesh-fetch-mixin.js`, `platform-automation-digest-mesh-fetch-mixin.js`, export mixin slimmed, `test:ci-phase895` (46/50, cutover deferred). **Now:** await authorized next phase.
PROTOMUX_RPC_MIGRATION.md
+15 -1
View File
@@ -102,8 +102,22 @@ Smoke: `npm run test:rpc-wire-view-snapshot`.
| `gossip-rpc-export-mesh-retry.js` | Shared retry/backoff + permission gate for export mesh fetch (Phase 894/896) | | `gossip-rpc-export-mesh-retry.js` | Shared retry/backoff + permission gate for export mesh fetch (Phase 894/896) |
| `gossip-rpc-export-mesh-gossip-wait.js` | Shared gossip waiter/timeout orchestrator (Phase 896) | | `gossip-rpc-export-mesh-gossip-wait.js` | Shared gossip waiter/timeout orchestrator (Phase 896) |
| `gossip-rpc-export-mesh-fetch-once.js` | Export mesh entry + once-path orchestrators (Phase 897) | | `gossip-rpc-export-mesh-fetch-once.js` | Export mesh entry + once-path orchestrators (Phase 897) |
| `gossip-rpc-export-mesh.js` | Barrel for all export mesh RPC helpers (Phase 898) |
| `gossip-rpc-export-mesh-attempt.js` | Shared fetchAttempt helpers (Phase 898) |
| `gossip-rpc-export-mesh-waiter-resolve.js` | Prefix/exact waiter resolve helpers (Phase 898) |
| `gossip-rpc-export-mesh-gossip-wait-build.js` | Gossip wait callback + request base builders (Phase 898) |
Smoke: `npm run test:ci-phase897`. Smoke: `npm run test:ci-phase898`.
## Export mesh barrel + attempt/waiter/gossip-wait-build extract (v0.8.865+, Phase 898)
`gossip-rpc-export-mesh.js` consolidates export mesh modules; `gossip-rpc-pull.js` imports the barrel only.
`withExportMeshFetchAttempt()` / `exportMeshFetchAttemptNumber()` — shared fetchAttempt counter for export mesh paths.
`resolveExportMeshFetchWaiterByPrefix()` / `resolveExportMeshFetchWaiterByExactKey()` — audit archive vs digest snapshot waiter resolve.
`buildGuildExportMeshGossipWaitCallback()` / `buildGuildExportMeshGossipRequestBase()` — dedupe gossip wait config in mesh fetch mixins.
## Export mesh fetch-once orchestrator extract (v0.8.864+, Phase 897) ## Export mesh fetch-once orchestrator extract (v0.8.864+, Phase 897)
release_notes/RELEASE_v0.8.865.md
+8
View File
@@ -0,0 +1,8 @@
# Release v0.8.865 — Phase 898
Non-breaking refactor: `gossip-rpc-export-mesh.js` barrel consolidates export mesh helpers; attempt/waiter-resolve/gossip-wait-build modules dedupe audit/digest mesh fetch mixins. Default gossip v1 unchanged; fleet v2 cutover still deferred.
- `gossip-rpc-export-mesh.js` — barrel for all export mesh RPC helpers (Phase 894–898)
- `withExportMeshFetchAttempt()` / waiter resolve / `buildGuildExportMeshGossipWaitCallback()`
- Audit/digest mesh fetch mixins adopt shared helpers; pull barrel imports export mesh module only
- CI: `npm run test:ci-phase898` (live digest snapshot RPC)