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

docs(v0.8.82): Phase 118 complete, Phase 119 planned

Browse Source 
Update PLATFORM_ROADMAP, PEARCORD_PARITY, GUILD_SYNC, DELIVERY_RECEIPTS,
DIGEST_RELAY_PLUGIN, and AUTOMATED_TESTING for onboarding audit CSV E2E,
bare-tcp webhook mock, audit signature badge, and scheduled CSV mesh push.

Co-authored-by: Cursor <[email protected]>
This commit is contained in:
Raven Scott
2026-05-22 07:32:21 -04:00
co-authored by Cursor
parent fb7dfb8936
commit 9c1a349436
6 changed files with 33 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AUTOMATED_TESTING.md
+4
View File
@@ -134,6 +134,10 @@ Pearcord validates itself without manual QA.
| `npm run test:digest-smtp-handoff-worker` | SMTP handoff worker template (`DIGEST_SMTP_HANDOFF_WORKER_SMOKE_OK`) |
| `npm run test:digest-webhook-post-live` | Mock HTTP webhook POST (`DIGEST_WEBHOOK_POST_LIVE_SMOKE_OK`) |
| `npm run test:audit-export-csv-download` | Signed audit CSV download export (`AUDIT_EXPORT_CSV_DOWNLOAD_SMOKE_OK`) |
| `npm run test:onboarding-mesh-audit-csv` | Onboarding join + audit CSV mesh (`ONBOARDING_MESH_AUDIT_CSV_SMOKE_OK`) |
| `npm run test:digest-webhook-post-tcp` | TCP mock HTTP webhook POST (`DIGEST_WEBHOOK_POST_TCP_SMOKE_OK`) |
| `npm run test:audit-export-csv-signature-badge` | View audit CSV signature meta (`AUDIT_EXPORT_CSV_SIGNATURE_BADGE_SMOKE_OK`) |
| `npm run test:audit-export-schedule-csv-mesh` | Scheduled export CSV mesh push (`AUDIT_EXPORT_SCHEDULE_CSV_MESH_SMOKE_OK`) |
| `npm run test:worker-stage` | Pear stage dry-run includes worker entry |
| `npm run test:worker-release` | Optional Pear key release dry-run (`WORKER_RELEASE_OK` or skip) |
| `npm run test:automation-export` | Automation manifest export/import (`AUTOMATION_EXPORT_SMOKE_OK`) |
DELIVERY_RECEIPTS.md
+2
View File
@@ -186,6 +186,8 @@ Retention: max 8 archives per guild, 30-day prune. `appendAuditExportArchive` me
**v0.8.81:** `pushAuditExportCsvToMesh` gossips signed audit CSV via `AUDIT_EXPORT_CSV_SYNC`. `dryRunSmtpRelayHandoff` in digest-relay-plugin for manifest-only SMTP bridges.
**v0.8.82:** Audit export schedule adds `pushSignedCsvToMesh` (default true) and `lastCsvMeshPushAt`. Scheduled runs call `pushAuditExportCsvToMesh` after JSON snapshot gossip.
**v0.8.72:** `@pearcord/automation-digest-notify-prefs` + per-user digest mute. `computeArchivePeerHealthScore` (0–100) on archive fetch peers. `buildAutomationHealthDashboard` merges schedules, mesh health, worker hint, and delivery metrics.
**v0.8.73:** `buildDigestRelayHandoff` P2P email relay stub (no SMTP). Inbox channel routing via `digestInboxChannelId`. Notify prefs extended with relay toggle.
DIGEST_RELAY_PLUGIN.md
+4
View File
@@ -103,3 +103,7 @@ Template `digest-smtp-handoff` logs manifest fields on `automation-hook-digest-r
## Mock webhook POST smoke (v0.8.81)
`postWebhookRelayPost` accepts `opts.fetch` for test doubles. See `scripts/lib/mock-webhook-fetch.cjs` and `test:digest-webhook-post-live`.
## TCP mock HTTP server (v0.8.82)
`scripts/lib/mock-webhook-tcp-server.cjs` binds `bare-tcp` on `127.0.0.1:0` and returns HTTP 200 to POST. Smoke: `test:digest-webhook-post-tcp`.
GUILD_SYNC.md
+2
View File
@@ -67,6 +67,8 @@ When a member joins a guild over an invite, they may have **no local message his
**v0.8.81:** Live audit CSV mesh push via RPC `AUDIT_EXPORT_CSV_SYNC` (76) and `pushAuditExportCsvToMesh`. Audit modal **Download CSV** uses signed export without clipboard.
**v0.8.82:** Onboarding mesh join smoke verifies audit CSV ingest after invite. `auditExportSchedule.pushSignedCsvToMesh` syncs on `GUILD_SYNC`. View exposes `auditExportCsvMeta` for audit modal HMAC badge.
## When sync is sent
| Trigger | Who pushes |
PEARCORD_PARITY.md
+2
View File
@@ -156,6 +156,8 @@ Phases **0–2** and **4** are largely complete; **3** (live audio) and **5** (n
**Next tranches (Phase 106+):** Automation digest snapshot mesh body gossip · archive peer last-seen · publish announce + matrix E2E.
**v0.8.82 (Phase 118):** Onboarding mesh audit CSV E2E, bare-tcp webhook POST smoke, audit CSV signature badge UI, scheduled audit CSV mesh push.
**v0.8.81 (Phase 117):** Audit CSV mesh gossip push, SMTP handoff worker, live mock webhook POST smoke, audit modal CSV download.
**v0.8.80 (Phase 116):** Headless webhook POST worker, signed audit CSV bundle, hook failure CSV mesh gossip push, per-guild SMTP relay manifest UI.
PLATFORM_ROADMAP.md
+19 -6
View File
@@ -307,16 +307,29 @@ When completing work, change `[ ]` → `[x]` and add a one-line note under **Cha
---
### Phase 118 — Onboarding & relay E2E (planned)
### Phase 119 — Parity & onboarding depth (planned)
| ID | Item | Status |
|----|------|--------|
| P118-1 | Onboarding mesh invite E2E with audit CSV ingest | [ ] |
| P118-2 | TCP mock webhook server smoke (bare-tcp listener) | [ ] |
| P118-3 | Audit modal signed CSV copy + signature badge | [ ] |
| P118-4 | Scheduled audit export pushes signed CSV to mesh | [ ] |
| P119-1 | Full onboarding UI IPC smoke with audit CSV badge refresh | [ ] |
| P119-2 | Guest GUILD_SYNC audit CSV ingest without simulateGossip | [ ] |
| P119-3 | Automation health dashboard CSV mesh last-push timestamp | [ ] |
| P119-4 | Discord-style audit log export filter persistence | [ ] |
**Next:** Onboarding E2E · scheduled CSV mesh push.
**Next:** Onboarding UI smoke · live GUILD_SYNC CSV ingest.
---
### Phase 118 — Onboarding & relay E2E (v0.8.82)
| ID | Item | Status |
|----|------|--------|
| P118-1 | Onboarding mesh invite E2E with audit CSV ingest | [x] |
| P118-2 | TCP mock webhook server smoke (bare-tcp listener) | [x] |
| P118-3 | Audit modal signed CSV copy + signature badge | [x] |
| P118-4 | Scheduled audit export pushes signed CSV to mesh | [x] |
**Next:** ~~Onboarding audit CSV · TCP webhook mock · CSV badge · scheduled CSV mesh~~ (Phase 118).
---