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

docs: Phase 483 complete, Phase 484 threads planned (v0.8.446)

Browse Source 
Co-authored-by: Cursor <[email protected]>
This commit is contained in:
Raven Scott
2026-05-24 06:06:23 -04:00
co-authored by Cursor
parent ca267030d5
commit 15b0a71232
5 changed files with 127 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTCTL.md
+9
View File
@@ -226,6 +226,15 @@ PEARCORD_SKIP_MESH_ROUNDTRIP=1 npm run test:agentctl-phase474-webhooks
Extends Phase 448 webhooks/integrations bundle with `syncWebhooksPanelsDuringGuildLoading` (integrations panel, webhook/slash rows, bot install, automation hooks), `#composer-webhooks-hint`, platform webhook/slash span metadata (`webhookName`/`deleted`/`contentLength`/`hasUsername`/`firstName`), dev-log clipboard `guildWebhookCount`, tightened **webhook-errors**/**slash-errors** filters, and Phase 473 roles regression. Agentctl re-runs Phase 448 webhooks (`test:agentctl-phase448-webhooks-integrations` alias).
**Search depth (v0.8.446):** Primary Phase 483 verification — combined bundle:
```bash
npm run test:phase483-search
PEARCORD_SKIP_MESH_ROUNDTRIP=1 npm run test:agentctl-phase483-search
```
Extends Phase 470 search/pins bundle with `syncSearchControlsDuringGuildLoading`, `ensureComposerSearchHint`, `setSearchResultRowsCurrent`, platform `guild.search` `includeMesh`/`queryLen`, `pin.list` span, clipboard search meta extend, anchored search/pin error filters, search jump live region, and Phase 482 messaging regression. Agentctl re-runs Phase 470 (`test:agentctl-phase470-search` alias).
**Messaging depth (v0.8.445):** Primary Phase 482 verification — combined bundle:
```bash
LOGGING.md
+2
View File
@@ -143,6 +143,8 @@ If logs show slow `guild.open` / `session.startup` spans (>2s, logged as `WARN`)
**v0.8.425 (Phase 462):** `automod.evaluate` span on live message send (`guildId`, `channelId`, `ok`/`reason`). Dev-log **moderation-errors** tightened to `ban.member|kick.member|timeout.member`; new **automod-errors** filter for `automod.setConfig|automod.evaluate`. UI `syncModerationPanelsDuringGuildLoading`. Bundle: `npm run test:phase462-moderation-automod`; agentctl: `npm run test:agentctl-phase462-moderation`.
**v0.8.446 (Phase 483):** `guild.search` `includeMesh`/`queryLen`; `pin.list` `pinCount`. Clipboard `searchHighlightOnly`, `searchSidecarActive`, `searchRecentChipCount`, `pinnedModalOpen`. Anchored search/pin error filters. Bundle: `npm run test:phase483-search`.
**v0.8.445 (Phase 482):** `message.send` `hasAttachment`/`hasSticker`; `message.edit` `contentChanged`; `message.delete` `wasOwn`. Clipboard `reactionPickerOpen`, `slowmodeActive`. Bundle: `npm run test:phase482-messaging`.
**v0.8.444 (Phase 481):** `attachment.stage` `byteLength`/`isImage`; `attachment.read` `fromLocal`; `embed.resolve` `urlLen`. Dev-log **attachment-errors** and **embed-errors** filters anchored. Clipboard `attachmentUploadActive`, `stagingAtCap`, `maxStagedAttachments`. Bundle: `npm run test:phase481-attachments`.
MARKDOWN_AND_PINS.md
+2
View File
@@ -46,6 +46,8 @@ Content is HTML-escaped before formatting. Used in `ui/app.js` for message bodie
- Gossip: `RPC.MESSAGE_PIN` (10)
- UI: pinned bar above messages; **Pins** opens modal list with jump-to-pin; message toolbar **Pin** / **Unpin** (`data-pin` / `data-unpin`); channel header shows pinned count
**v0.8.446 (Phase 483):** Platform `pin.list` span on `_channelPins` with `pinCount`; dev-log **pin-errors** filter includes `pin.list error`. Bundle: `npm run test:phase483-search`.
**v0.8.433 (Phase 470):** `syncSearchPanelsDuringGuildLoading` disables pinned bar rows (`.pinned-item`, `.pinned-more-btn`) and open pins modal rows during guild loading; platform `pin.message`/`pin.unpin` span `end` includes `messageId` + `pinCount`. Composer `#composer-search-hint` shows scope/hit/mesh context. Bundle: `npm run test:phase470-search-pins`; agentctl: `npm run test:agentctl-phase470-search`.
**v0.8.417 (Phase 454):** Pin modal list ArrowUp/Down roving (`ensurePinModalListArrowRoving`); platform `pin.message`/`pin.unpin` spans include `guildId`. Pins header button disabled during guild loading via `syncSearchPanelDuringGuildLoading`. Bundle: `npm run test:phase454-search-pins`.
PLATFORM_ROADMAP.md
+112 -52
View File
@@ -9982,62 +9982,121 @@ Fix guild switching, session boot gating, and theme/prefs application before mic
---
### Phase 483 — Search depth (v0.8.446)
### Phase 483 — Search depth (v0.8.446) ✅
| ID | Item | Status |
|----|------|--------|
| P483-1 | Search: channel scope roundtrip re-verify | [ ] |
| P483-2 | Search: guild scope roundtrip re-verify | [ ] |
| P483-3 | Search: mesh include toggle re-verify | [ ] |
| P483-4 | UI: `syncSearchPanelsDuringGuildLoading` wrapper extend | [ ] |
| P483-5 | UI: search modal guild-loading guard extend | [ ] |
| P483-6 | UI: search results list guild-loading guard extend | [ ] |
| P483-7 | UI: pin panel search filter re-verify | [ ] |
| P483-8 | Platform: `search.query` span metadata extend | [ ] |
| P483-9 | Platform: `search.mesh` span metadata extend | [ ] |
| P483-10 | Platform: `pin.list` span metadata extend | [ ] |
| P483-11 | Logging: dev-log **search-errors** filter tighten | [ ] |
| P483-12 | Logging: dev-log **pin-errors** filter tighten | [ ] |
| P483-13 | Logging: dev-log clipboard search meta extend | [ ] |
| P483-14 | Agentctl: search headless re-verify | [ ] |
| P483-15 | Agentctl: pin jump headless re-verify | [ ] |
| P483-16 | Agentctl: combined phase483 search bundle | [ ] |
| P483-17 | Smoke: search-panels-guild-loading-extend | [ ] |
| P483-18 | Smoke: dev-log-search-errors-tighten-extend | [ ] |
| P483-19 | Smoke: dev-log-clipboard-search-meta-extend | [ ] |
| P483-20 | UI: composer search hint extend | [ ] |
| P483-21 | UI: search empty-state hints polish | [ ] |
| P483-22 | UI: search result aria-current polish | [ ] |
| P483-23 | UI: search keyboard roving re-verify | [ ] |
| P483-24 | UI: mesh stale badge re-verify | [ ] |
| P483-25 | UI: search scope chips aria-pressed re-verify | [ ] |
| P483-26 | UI: composer autofocus after search jump re-verify | [ ] |
| P483-27 | UI: search include-mesh toggle re-verify | [ ] |
| P483-28 | Permissions: search read gate re-verify | [ ] |
| P483-29 | Docs: `SEARCH.md` refresh | [ ] |
| P483-30 | Docs: `PINS.md` refresh | [ ] |
| P483-31 | Docs: `AGENTCTL.md` phase 483 bundle | [ ] |
| P483-32 | Regression: messaging phase 482 smokes still pass | [ ] |
| P483-33 | Regression: attachments phase 481 smokes still pass | [ ] |
| P483-34 | Boot: session ready gate | [ ] |
| P483-35 | Boot: pear run gate | [ ] |
| P483-36 | Module: `pearcord-search` README accuracy | [ ] |
| P483-37 | Module: `pearcord-platform` README search section | [ ] |
| P483-38 | Smoke: platform-search-span-metadata-extend | [ ] |
| P483-39 | Smoke: platform-pin-span-metadata-extend | [ ] |
| P483-40 | Mesh: search gossip roundtrip re-verify | [ ] |
| P483-41 | Mesh: search cache invalidation re-verify | [ ] |
| P483-42 | UI: search modal aria-busy polish | [ ] |
| P483-43 | UI: search permission toast re-verify | [ ] |
| P483-44 | UI: pinned search filter re-verify | [ ] |
| P483-45 | UI: companion search defer re-verify | [ ] |
| P483-46 | UI: dev-log clipboard search mesh meta extend | [ ] |
| P483-47 | UI: search hit highlight re-verify | [ ] |
| P483-48 | UI: audit search entries re-verify | [ ] |
| P483-49 | UI: recent search chips re-verify | [ ] |
| P483-50 | Phase 484 threads depth (v0.8.447) | [ ] |
| P483-1 | Search: channel scope roundtrip re-verify | [x] |
| P483-2 | Search: guild scope roundtrip re-verify | [x] |
| P483-3 | Search: mesh include toggle re-verify | [x] |
| P483-4 | UI: `syncSearchPanelsDuringGuildLoading` wrapper extend | [x] |
| P483-5 | UI: search modal guild-loading guard extend | [x] |
| P483-6 | UI: search results list guild-loading guard extend | [x] |
| P483-7 | UI: pin panel search filter re-verify | [x] |
| P483-8 | Platform: `search.query` span metadata extend | [x] |
| P483-9 | Platform: `search.mesh` span metadata extend | [x] |
| P483-10 | Platform: `pin.list` span metadata extend | [x] |
| P483-11 | Logging: dev-log **search-errors** filter tighten | [x] |
| P483-12 | Logging: dev-log **pin-errors** filter tighten | [x] |
| P483-13 | Logging: dev-log clipboard search meta extend | [x] |
| P483-14 | Agentctl: search headless re-verify | [x] |
| P483-15 | Agentctl: pin jump headless re-verify | [x] |
| P483-16 | Agentctl: combined phase483 search bundle | [x] |
| P483-17 | Smoke: search-panels-guild-loading-extend | [x] |
| P483-18 | Smoke: dev-log-search-errors-tighten-extend | [x] |
| P483-19 | Smoke: dev-log-clipboard-search-meta-extend | [x] |
| P483-20 | UI: composer search hint extend | [x] |
| P483-21 | UI: search empty-state hints polish | [x] |
| P483-22 | UI: search result aria-current polish | [x] |
| P483-23 | UI: search keyboard roving re-verify | [x] |
| P483-24 | UI: mesh stale badge re-verify | [x] |
| P483-25 | UI: search scope chips aria-pressed re-verify | [x] |
| P483-26 | UI: composer autofocus after search jump re-verify | [x] |
| P483-27 | UI: search include-mesh toggle re-verify | [x] |
| P483-28 | Permissions: search read gate re-verify | [x] |
| P483-29 | Docs: `SEARCH.md` refresh | [x] |
| P483-30 | Docs: `PINS.md` refresh | [x] |
| P483-31 | Docs: `AGENTCTL.md` phase 483 bundle | [x] |
| P483-32 | Regression: messaging phase 482 smokes still pass | [x] |
| P483-33 | Regression: attachments phase 481 smokes still pass | [x] |
| P483-34 | Boot: session ready gate | [x] |
| P483-35 | Boot: pear run gate | [x] |
| P483-36 | Module: `pearcord-search` README accuracy | [x] |
| P483-37 | Module: `pearcord-platform` README search section | [x] |
| P483-38 | Smoke: platform-search-span-metadata-extend | [x] |
| P483-39 | Smoke: platform-pin-span-metadata-extend | [x] |
| P483-40 | Mesh: search gossip roundtrip re-verify | [x] |
| P483-41 | Mesh: search cache invalidation re-verify | [x] |
| P483-42 | UI: search modal aria-busy polish | [x] |
| P483-43 | UI: search permission toast re-verify | [x] |
| P483-44 | UI: pinned search filter re-verify | [x] |
| P483-45 | UI: companion search defer re-verify | [x] |
| P483-46 | UI: dev-log clipboard search mesh meta extend | [x] |
| P483-47 | UI: search hit highlight re-verify | [x] |
| P483-48 | UI: audit search entries re-verify | [x] |
| P483-49 | UI: recent search chips re-verify | [x] |
| P483-50 | Phase 484 threads depth (v0.8.447) | [x] |
**Next:** P483-1–P483-49.
**Next:** ~~Phase 483~~ (complete). `syncSearchControlsDuringGuildLoading`; message list search-loading aria-label; `ensureComposerSearchHint`; `setSearchResultRowsCurrent`; platform `guild.search` `includeMesh`/`queryLen`; `pin.list` span; clipboard `searchHighlightOnly`/`searchSidecarActive`/`searchRecentChipCount`/`pinnedModalOpen`; search jump live region; bundle `test:phase483-search`. Phase 484 planned (50 items).
---
### Phase 484 — Threads depth (v0.8.447)
| ID | Item | Status |
|----|------|--------|
| P484-1 | Threads: create from message roundtrip re-verify | [ ] |
| P484-2 | Threads: archive/unarchive roundtrip re-verify | [ ] |
| P484-3 | Threads: mark read roundtrip re-verify | [ ] |
| P484-4 | UI: `syncThreadsPanelsDuringGuildLoading` wrapper extend | [ ] |
| P484-5 | UI: thread list guild-loading guard extend | [ ] |
| P484-6 | UI: thread sidebar guild-loading guard extend | [ ] |
| P484-7 | UI: forum post list guild-loading guard extend | [ ] |
| P484-8 | Platform: `thread.create` span metadata extend | [ ] |
| P484-9 | Platform: `thread.archive` span metadata extend | [ ] |
| P484-10 | Platform: `thread.read` span metadata extend | [ ] |
| P484-11 | Logging: dev-log **thread-errors** filter tighten | [ ] |
| P484-12 | Logging: dev-log **forum-errors** filter tighten | [ ] |
| P484-13 | Logging: dev-log clipboard thread meta extend | [ ] |
| P484-14 | Agentctl: thread create headless re-verify | [ ] |
| P484-15 | Agentctl: forum select headless re-verify | [ ] |
| P484-16 | Agentctl: combined phase484 threads bundle | [ ] |
| P484-17 | Smoke: threads-panels-guild-loading-extend | [ ] |
| P484-18 | Smoke: dev-log-thread-errors-tighten-extend | [ ] |
| P484-19 | Smoke: dev-log-clipboard-thread-meta-extend | [ ] |
| P484-20 | UI: composer thread hint extend | [ ] |
| P484-21 | UI: thread empty-state hints polish | [ ] |
| P484-22 | UI: thread row aria-current polish | [ ] |
| P484-23 | UI: thread keyboard roving re-verify | [ ] |
| P484-24 | UI: forum tag filter re-verify | [ ] |
| P484-25 | UI: thread unread badge re-verify | [ ] |
| P484-26 | UI: composer autofocus after thread jump re-verify | [ ] |
| P484-27 | UI: thread parent channel select re-verify | [ ] |
| P484-28 | Permissions: create-public-thread toast re-verify | [ ] |
| P484-29 | Docs: `THREADS.md` refresh | [ ] |
| P484-30 | Docs: `FORUMS.md` refresh | [ ] |
| P484-31 | Docs: `AGENTCTL.md` phase 484 bundle | [ ] |
| P484-32 | Regression: search phase 483 smokes still pass | [ ] |
| P484-33 | Regression: messaging phase 482 smokes still pass | [ ] |
| P484-34 | Boot: session ready gate | [ ] |
| P484-35 | Boot: pear run gate | [ ] |
| P484-36 | Module: `pearcord-thread` README accuracy | [ ] |
| P484-37 | Module: `pearcord-platform` README threads section | [ ] |
| P484-38 | Smoke: platform-thread-span-metadata-extend | [ ] |
| P484-39 | Smoke: platform-forum-span-metadata-extend | [ ] |
| P484-40 | Mesh: thread gossip roundtrip re-verify | [ ] |
| P484-41 | Mesh: forum post gossip roundtrip re-verify | [ ] |
| P484-42 | UI: threads panel aria-busy polish | [ ] |
| P484-43 | UI: thread permission toast re-verify | [ ] |
| P484-44 | UI: forum search stale badge re-verify | [ ] |
| P484-45 | UI: companion thread defer re-verify | [ ] |
| P484-46 | UI: dev-log clipboard forum meta extend | [ ] |
| P484-47 | UI: thread read live region re-verify | [ ] |
| P484-48 | UI: audit thread entries re-verify | [ ] |
| P484-49 | UI: slowmode in threads re-verify | [ ] |
| P484-50 | Phase 485 roles depth (v0.8.448) | [ ] |
**Next:** P484-1–P484-49.
---
@@ -11483,6 +11542,7 @@ Absorbed into Phase 273 (P273-5–P273-8, P273-11–P273-12). See Phase 274 for
### Changelog
- **2026-05-24** — v0.8.446: Phase 483 — `syncSearchControlsDuringGuildLoading`; `ensureComposerSearchHint`; `setSearchResultRowsCurrent`; platform `guild.search` `includeMesh`/`queryLen`; `pin.list` span; clipboard search meta extend; search jump live region; bundle `test:phase483-search`. Phase 484 planned (50 items).
- **2026-05-24** — v0.8.445: Phase 482 — `syncComposerControlsDuringGuildLoading`; `ensureComposerMessagingHint`; `setPinnedRowsCurrent`; platform message/reaction span metadata; clipboard `reactionPickerOpen`/`slowmodeActive`; message jump live region; bundle `test:phase482-messaging`. Phase 483 planned (50 items).
- **2026-05-24** — v0.8.444: Phase 481 — composed attachment guild-loading guards; platform `attachment.stage`/`attachment.read`/`embed.resolve` span metadata; anchored attachment/embed dev-log filters; clipboard staging meta; `ensureComposerAttachHint`; upload queue `aria-busy`; bundle `test:phase481-attachments`. Phase 482 planned (50 items).
- **2026-05-24** — v0.8.443: Phase 480 — composed voice guild-loading guards; platform `voice.join`/`voice.leave`/`screen.start`/`screen.stop` span metadata; anchored **voice-errors** filter; clipboard voice/stage meta; `ensureComposerVoiceHint`; `setVoiceRosterSelfCurrent`; voice bar activity aria-label; bundle `test:phase480-voice`. Phase 481 planned (50 items).
SEARCH.md
+2
View File
@@ -2,6 +2,8 @@
Pearcord supports local message search without a central search index. All queries run against the local HyperDB / JSON store.
**v0.8.446 (Phase 483):** `syncSearchControlsDuringGuildLoading` splits search input/toggles from results panel; message list `aria-label` during guild load search context; `ensureComposerSearchHint` guild-loading copy; `setSearchResultRowsCurrent` on `.search-sidecar-hit`; platform `guild.search` span `end` adds `includeMesh`/`queryLen`; `pin.list` span with `pinCount`. Dev-log clipboard: `searchHighlightOnly`, `searchSidecarActive`, `searchRecentChipCount`, `pinnedModalOpen`. Anchored **search-errors** (`^guild.search error`) and **pin-errors** (`^pin.(message|unpin|list) error`). Bundle: `npm run test:phase483-search`.
**v0.8.433 (Phase 470):** `syncSearchPanelsDuringGuildLoading` wrapper (wired from `syncGuildLoadingOverlay`) extends guild-loading guards to mesh toggle, refresh, highlight-only, recent chips, pinned button/bar rows, pins modal rows, search sidecar hits, and `#search-mesh-hint` (`aria-hidden` while loading); `syncComposerSearchHint` (`#composer-search-hint`) surfaces active scope, hit counts, and mesh status. Platform `guild.search` span `end` adds `meshHitCount`/`localHitCount`/`mesh`; `pin.message`/`pin.unpin` add `messageId`/`pinCount`. Dev-log clipboard: `searchIncludeMesh`, `searchMeshHitCount`, `searchLocalHitCount`. Bundle: `npm run test:phase470-search-pins`; agentctl: `npm run test:agentctl-phase470-search` (+7 smokes).
**v0.8.417 (Phase 454):** Platform `guild.search` and `pin.message`/`pin.unpin` spans include `guildId` on start/end (`endSearchSpan` helper). `syncSearchPanelDuringGuildLoading` disables mesh toggle, refresh, highlight-only, recent chips, pinned button, and sidecar hits during guild load (wired from `syncGuildLoadingOverlay`). Search scope `<select>` ArrowLeft/Right cycles visible options; search sidecar hits and pin modal rows support ArrowUp/Down list roving. Bundle: `npm run test:phase454-search-pins`; agentctl: `npm run test:agentctl-phase454-search`.