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

docs: Phase 553 search depth complete, Phase 554 planned (v0.8.516)

Browse Source 
Mark P553 roadmap items done; add Phase 554 messaging depth section and
changelog for search panel splits and test bundle.

Co-authored-by: Cursor <[email protected]>
This commit is contained in:
Raven Scott
2026-05-24 14:00:01 -04:00
co-authored by Cursor
parent 8fc9f93330
commit a9ce733f22
3 changed files with 123 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTCTL.md
+9
View File
@@ -244,6 +244,15 @@ PEARCORD_SKIP_MESH_ROUNDTRIP=1 npm run test:agentctl-phase516-contacts
Extends `test:contacts` + `test:block-contacts` + `test:friend-presence` with split contacts guild-loading compositor (`syncContactsPanelsDuringGuildLoading`), platform `contacts.request`/`accept`/`decline` span metadata, dev-log **contacts-errors** filter + clipboard contacts meta, `#composer-contacts-hint`, `lastFriendRowId`, and Phase 515 DMs regression. Agentctl: `test:contacts` headless roundtrip. Extends `test:contacts` + `test:block-contacts` + `test:friend-presence` with split contacts guild-loading compositor (`syncContactsPanelsDuringGuildLoading`), platform `contacts.request`/`accept`/`decline` span metadata, dev-log **contacts-errors** filter + clipboard contacts meta, `#composer-contacts-hint`, `lastFriendRowId`, and Phase 515 DMs regression. Agentctl: `test:contacts` headless roundtrip.
**Search depth (v0.8.516):** Primary Phase 553 verification — combined bundle:
```bash
npm run test:phase553-search
PEARCORD_SKIP_MESH_ROUNDTRIP=1 npm run test:agentctl-phase553-search
```
Extends `test:phase552-compliance` regression with split search field/scope/mesh/highlight/results panels; `#search-panel-live`; platform `searchSpanKind`/`remainingResultCapacity`; clipboard `searchFieldBusy`/`searchScopeSelectBusy`/`searchFilterChipsBusy`; ui-flow composer focus after cleared `update-search`; agentctl `searchGuildMessages` refreshView. Agentctl: chains `test:agentctl-phase519-search` + `smoke-agentctl-search-phase553`.
**Compliance depth (v0.8.515):** Primary Phase 552 verification — combined bundle: **Compliance depth (v0.8.515):** Primary Phase 552 verification — combined bundle:
```bash ```bash
PLATFORM_ROADMAP.md
+112 -52
View File
@@ -14112,62 +14112,121 @@ Fix guild switching, session boot gating, and theme/prefs application before mic
--- ---
### Phase 553 — Search depth (v0.8.516) ### Phase 553 — Search depth (v0.8.516) ✅
| ID | Item | Status | | ID | Item | Status |
|----|------|--------| |----|------|--------|
| P553-1 | Search: guild message search roundtrip re-verify | [ ] | | P553-1 | Search: guild message search roundtrip re-verify | [x] |
| P553-2 | Search: DM search roundtrip re-verify | [ ] | | P553-2 | Search: DM search roundtrip re-verify | [x] |
| P553-3 | Search: pinned search roundtrip re-verify | [ ] | | P553-3 | Search: pinned search roundtrip re-verify | [x] |
| P553-4 | UI: split search guild-loading compositor extend | [ ] | | P553-4 | UI: split search guild-loading compositor extend | [x] |
| P553-5 | UI: search field panel guild-loading guard extend | [ ] | | P553-5 | UI: search field panel guild-loading guard extend | [x] |
| P553-6 | UI: search results panel guild-loading guard extend | [ ] | | P553-6 | UI: search results panel guild-loading guard extend | [x] |
| P553-7 | UI: search scope panel guild-loading guard extend | [ ] | | P553-7 | UI: search scope panel guild-loading guard extend | [x] |
| P553-8 | Platform: `search.messages` span metadata extend | [ ] | | P553-8 | Platform: `search.messages` span metadata extend | [x] |
| P553-9 | Platform: `search.dms` span metadata extend | [ ] | | P553-9 | Platform: `search.dms` span metadata extend | [x] |
| P553-10 | Platform: `search.pins` span metadata extend | [ ] | | P553-10 | Platform: `search.pins` span metadata extend | [x] |
| P553-11 | Logging: dev-log **search-errors** filter tighten | [ ] | | P553-11 | Logging: dev-log **search-errors** filter tighten | [x] |
| P553-12 | Logging: dev-log clipboard search meta extend | [ ] | | P553-12 | Logging: dev-log clipboard search meta extend | [x] |
| P553-13 | Agentctl: guild search headless re-verify | [ ] | | P553-13 | Agentctl: guild search headless re-verify | [x] |
| P553-14 | Agentctl: combined phase553 search bundle | [ ] | | P553-14 | Agentctl: combined phase553 search bundle | [x] |
| P553-15 | Smoke: search-panels-guild-loading-extend-553 | [ ] | | P553-15 | Smoke: search-panels-guild-loading-extend-553 | [x] |
| P553-16 | Smoke: dev-log-search-errors-tighten-extend-553 | [ ] | | P553-16 | Smoke: dev-log-search-errors-tighten-extend-553 | [x] |
| P553-17 | Smoke: dev-log-clipboard-search-meta-extend-553 | [ ] | | P553-17 | Smoke: dev-log-clipboard-search-meta-extend-553 | [x] |
| P553-18 | UI: composer search hint extend | [ ] | | P553-18 | UI: composer search hint extend | [x] |
| P553-19 | UI: search hit aria-current polish | [ ] | | P553-19 | UI: search hit aria-current polish | [x] |
| P553-20 | UI: search filter chips re-verify | [ ] | | P553-20 | UI: search filter chips re-verify | [x] |
| P553-21 | UI: search scope select re-verify | [ ] | | P553-21 | UI: search scope select re-verify | [x] |
| P553-22 | UI: composer autofocus after search clear re-verify | [ ] | | P553-22 | UI: composer autofocus after search clear re-verify | [x] |
| P553-23 | Search: typeahead debounce re-verify | [ ] | | P553-23 | Search: typeahead debounce re-verify | [x] |
| P553-24 | Search: Alt+Backspace typeahead re-verify | [ ] | | P553-24 | Search: Alt+Backspace typeahead re-verify | [x] |
| P553-25 | Search: empty state copy re-verify | [ ] | | P553-25 | Search: empty state copy re-verify | [x] |
| P553-26 | Search: cross-guild scope re-verify | [ ] | | P553-26 | Search: cross-guild scope re-verify | [x] |
| P553-27 | Docs: `SEARCH.md` refresh | [ ] | | P553-27 | Docs: `SEARCH.md` refresh | [x] |
| P553-28 | Docs: `AGENTCTL.md` phase 553 bundle | [ ] | | P553-28 | Docs: `AGENTCTL.md` phase 553 bundle | [x] |
| P553-29 | Regression: compliance phase 552 smokes still pass | [ ] | | P553-29 | Regression: compliance phase 552 smokes still pass | [x] |
| P553-30 | Regression: moderation phase 551 smokes still pass | [ ] | | P553-30 | Regression: moderation phase 551 smokes still pass | [x] |
| P553-31 | Boot: session ready gate | [ ] | | P553-31 | Boot: session ready gate | [x] |
| P553-32 | Boot: pear run gate | [ ] | | P553-32 | Boot: pear run gate | [x] |
| P553-33 | Module: `pearcord-search` README accuracy | [ ] | | P553-33 | Module: `pearcord-search` README accuracy | [x] |
| P553-34 | Module: `pearcord-platform` README search section | [ ] | | P553-34 | Module: `pearcord-platform` README search section | [x] |
| P553-35 | Smoke: platform-search-span-metadata-extend-553 | [ ] | | P553-35 | Smoke: platform-search-span-metadata-extend-553 | [x] |
| P553-36 | Smoke: platform-search-dm-span-metadata-extend-553 | [ ] | | P553-36 | Smoke: platform-search-dm-span-metadata-extend-553 | [x] |
| P553-37 | Mesh: search gossip roundtrip re-verify | [ ] | | P553-37 | Mesh: search gossip roundtrip re-verify | [x] |
| P553-38 | UI: search panel aria-busy polish | [ ] | | P553-38 | UI: search panel aria-busy polish | [x] |
| P553-39 | UI: search live region re-verify | [ ] | | P553-39 | UI: search live region re-verify | [x] |
| P553-40 | UI: companion search defer re-verify | [ ] | | P553-40 | UI: companion search defer re-verify | [x] |
| P553-41 | UI: dev-log clipboard search scope meta extend | [ ] | | P553-41 | UI: dev-log clipboard search scope meta extend | [x] |
| P553-42 | UI: search keyboard nav re-verify | [ ] | | P553-42 | UI: search keyboard nav re-verify | [x] |
| P553-43 | UI: search result jump re-verify | [ ] | | P553-43 | UI: search result jump re-verify | [x] |
| P553-44 | UI: search P2P fanout re-verify | [ ] | | P553-44 | UI: search P2P fanout re-verify | [x] |
| P553-45 | UI: inbox search cross-link re-verify | [ ] | | P553-45 | UI: inbox search cross-link re-verify | [x] |
| P553-46 | UI: channel search re-verify | [ ] | | P553-46 | UI: channel search re-verify | [x] |
| P553-47 | UI: forum search re-verify | [ ] | | P553-47 | UI: forum search re-verify | [x] |
| P553-48 | UI: search min query hint re-verify | [ ] | | P553-48 | UI: search min query hint re-verify | [x] |
| P553-49 | UI: search composer autofocus re-verify | [ ] | | P553-49 | UI: search composer autofocus re-verify | [x] |
| P553-50 | Phase 554 messaging depth (v0.8.517) | [ ] | | P553-50 | Phase 554 messaging depth (v0.8.517) | [x] |
**Next:** P553-1–P553-49. **Next:** ~~Phase 553~~ (complete). Split search field/scope/mesh/highlight/results panels; `#search-panel-live`; platform `searchSpanKind` (`search.messages`/`search.dms`/`search.pins`), `remainingResultCapacity`; clipboard `searchFieldBusy`/`searchScopeSelectBusy`/`searchFilterChipsBusy`; ui-flow composer focus after cleared `update-search`; agentctl `searchGuildMessages` refreshView; bundle `npm run test:phase553-search`. Phase 554 planned (50 items).
---
### Phase 554 — Messaging depth (v0.8.517)
| ID | Item | Status |
|----|------|--------|
| P554-1 | Messaging: send message roundtrip re-verify | [ ] |
| P554-2 | Messaging: edit message roundtrip re-verify | [ ] |
| P554-3 | Messaging: delete message roundtrip re-verify | [ ] |
| P554-4 | UI: split messaging guild-loading compositor extend | [ ] |
| P554-5 | UI: message list panel guild-loading guard extend | [ ] |
| P554-6 | UI: composer panel guild-loading guard extend | [ ] |
| P554-7 | UI: thread reply panel guild-loading guard extend | [ ] |
| P554-8 | Platform: `message.send` span metadata extend | [ ] |
| P554-9 | Platform: `message.edit` span metadata extend | [ ] |
| P554-10 | Platform: `message.delete` span metadata extend | [ ] |
| P554-11 | Logging: dev-log **message-errors** filter tighten | [ ] |
| P554-12 | Logging: dev-log clipboard messaging meta extend | [ ] |
| P554-13 | Agentctl: send message headless re-verify | [ ] |
| P554-14 | Agentctl: combined phase554 messaging bundle | [ ] |
| P554-15 | Smoke: messaging-panels-guild-loading-extend-554 | [ ] |
| P554-16 | Smoke: dev-log-message-errors-tighten-extend-554 | [ ] |
| P554-17 | Smoke: dev-log-clipboard-messaging-meta-extend-554 | [ ] |
| P554-18 | UI: composer messaging hint extend | [ ] |
| P554-19 | UI: message row aria-current polish | [ ] |
| P554-20 | UI: reply bar re-verify | [ ] |
| P554-21 | UI: slowmode badge re-verify | [ ] |
| P554-22 | UI: composer autofocus after send re-verify | [ ] |
| P554-23 | Messaging: draft persistence re-verify | [ ] |
| P554-24 | Messaging: mention autocomplete re-verify | [ ] |
| P554-25 | Messaging: markdown preview re-verify | [ ] |
| P554-26 | Messaging: cross-channel jump re-verify | [ ] |
| P554-27 | Docs: `MESSAGING.md` refresh | [ ] |
| P554-28 | Docs: `AGENTCTL.md` phase 554 bundle | [ ] |
| P554-29 | Regression: search phase 553 smokes still pass | [ ] |
| P554-30 | Regression: compliance phase 552 smokes still pass | [ ] |
| P554-31 | Boot: session ready gate | [ ] |
| P554-32 | Boot: pear run gate | [ ] |
| P554-33 | Module: `pearcord-message` README accuracy | [ ] |
| P554-34 | Module: `pearcord-platform` README messaging section | [ ] |
| P554-35 | Smoke: platform-message-span-metadata-extend-554 | [ ] |
| P554-36 | Smoke: platform-message-edit-span-metadata-extend-554 | [ ] |
| P554-37 | Mesh: message gossip roundtrip re-verify | [ ] |
| P554-38 | UI: messaging panel aria-busy polish | [ ] |
| P554-39 | UI: message list live region re-verify | [ ] |
| P554-40 | UI: companion messaging defer re-verify | [ ] |
| P554-41 | UI: dev-log clipboard draft meta extend | [ ] |
| P554-42 | UI: char count re-verify | [ ] |
| P554-43 | UI: upload progress re-verify | [ ] |
| P554-44 | UI: messaging P2P fanout re-verify | [ ] |
| P554-45 | UI: announcement cross-post hint re-verify | [ ] |
| P554-46 | UI: thread starter re-verify | [ ] |
| P554-47 | UI: forum post reply re-verify | [ ] |
| P554-48 | UI: DM encryption hint re-verify | [ ] |
| P554-49 | UI: composer Enter send re-verify | [ ] |
| P554-50 | Phase 555 reactions depth (v0.8.518) | [ ] |
**Next:** P554-1–P554-49.
--- ---
@@ -15618,6 +15677,7 @@ Absorbed into Phase 273 (P273-5–P273-8, P273-11–P273-12). See Phase 274 for
- **2026-05-24** — v0.8.479: Phase 516 — split contacts guild-loading compositor; `contacts.request`/`accept`/`decline` span metadata; dev-log contacts-errors filter + clipboard contacts meta; bundle `test:phase516-contacts`. Phase 517 planned. - **2026-05-24** — v0.8.479: Phase 516 — split contacts guild-loading compositor; `contacts.request`/`accept`/`decline` span metadata; dev-log contacts-errors filter + clipboard contacts meta; bundle `test:phase516-contacts`. Phase 517 planned.
- **2026-05-24** — v0.8.478: Phase 515 — split DMs guild-loading compositor; `dm.open`/`dm.send`/`dm.group.create` span metadata; dev-log dm-errors filter tighten + clipboard DM meta; bundle `test:phase515-dms`. Phase 516 planned. - **2026-05-24** — v0.8.478: Phase 515 — split DMs guild-loading compositor; `dm.open`/`dm.send`/`dm.group.create` span metadata; dev-log dm-errors filter tighten + clipboard DM meta; bundle `test:phase515-dms`. Phase 516 planned.
- **2026-05-24** — v0.8.477: Phase 514 — split invites guild-loading compositor; `guild.invite`/`invite.join`/`invite.revoke` span metadata; dev-log invite-errors filter + clipboard meta; bundle `test:phase514-invites`. Phase 515 planned. - **2026-05-24** — v0.8.477: Phase 514 — split invites guild-loading compositor; `guild.invite`/`invite.join`/`invite.revoke` span metadata; dev-log invite-errors filter + clipboard meta; bundle `test:phase514-invites`. Phase 515 planned.
- **2026-05-24** — v0.8.516: Phase 553 — split search field/scope/mesh/highlight/results panels; `#search-panel-live`; platform `searchSpanKind`/`remainingResultCapacity`; clipboard `searchFieldBusy`/`searchScopeSelectBusy`; ui-flow composer focus after cleared `update-search`; agentctl `searchGuildMessages` refreshView; bundle `npm run test:phase553-search`. Phase 554 planned (50 items).
- **2026-05-24** — v0.8.515: Phase 552 — split compliance export/archive/schedule panels; `.compliance-panel-live`/`.compliance-modal-live`; platform `auditEntryCount`/`exportLimit`/`meshPushed`; clipboard `complianceAuditFilterChipsBusy`/`complianceExportButtonsBusy`; ui-flow composer focus after `run-audit-export-now`/`sync-audit-export-csv`; bundle `npm run test:phase552-compliance`. Phase 553 planned (50 items). - **2026-05-24** — v0.8.515: Phase 552 — split compliance export/archive/schedule panels; `.compliance-panel-live`/`.compliance-modal-live`; platform `auditEntryCount`/`exportLimit`/`meshPushed`; clipboard `complianceAuditFilterChipsBusy`/`complianceExportButtonsBusy`; ui-flow composer focus after `run-audit-export-now`/`sync-audit-export-csv`; bundle `npm run test:phase552-compliance`. Phase 553 planned (50 items).
- **2026-05-24** — v0.8.514: Phase 551 — split automod toggles/fields/actions + ban/member moderation panels; `.moderation-panel-live`/`.moderation-modal-live`; platform `memberCount`/`activeTimeoutCount`/`keywordCount`; clipboard `moderationAutomodTogglesBusy`/`moderationTimeoutModalBusy`/`moderationBanListChromeBusy`; bundle `npm run test:phase551-moderation`. Phase 552 planned (50 items). - **2026-05-24** — v0.8.514: Phase 551 — split automod toggles/fields/actions + ban/member moderation panels; `.moderation-panel-live`/`.moderation-modal-live`; platform `memberCount`/`activeTimeoutCount`/`keywordCount`; clipboard `moderationAutomodTogglesBusy`/`moderationTimeoutModalBusy`/`moderationBanListChromeBusy`; bundle `npm run test:phase551-moderation`. Phase 552 planned (50 items).
- **2026-05-24** — v0.8.513: Phase 550 — split role list chrome/items + channel perm panels; `.roles-panel-live`/`.roles-modal-live`; platform `customRoleCount` on update/delete, `channelOverwriteCount`/`remainingOverwriteCount`; clipboard `rolesListChromeBusy`/`rolesChannelPermControlsBusy`/`rolesCreateEditorBusy`; ui-flow composer focus after delete/reorder role; bundle `npm run test:phase550-roles`. Phase 551 planned (50 items). - **2026-05-24** — v0.8.513: Phase 550 — split role list chrome/items + channel perm panels; `.roles-panel-live`/`.roles-modal-live`; platform `customRoleCount` on update/delete, `channelOverwriteCount`/`remainingOverwriteCount`; clipboard `rolesListChromeBusy`/`rolesChannelPermControlsBusy`/`rolesCreateEditorBusy`; ui-flow composer focus after delete/reorder role; bundle `npm run test:phase550-roles`. Phase 551 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. Pearcord supports local message search without a central search index. All queries run against the local HyperDB / JSON store.
**v0.8.516 (Phase 553):** Third search depth pass — split `syncSearchFieldPanelDuringGuildLoading`, `syncSearchScopePanelDuringGuildLoading`, `syncSearchMeshFilterPanelDuringGuildLoading`, `syncSearchHighlightFilterPanelDuringGuildLoading`, `syncSearchResultsPanelDuringGuildLoading`; `#search-panel-live` live region; platform `searchSpanKind` (`search.messages`/`search.dms`/`search.pins`), `remainingResultCapacity`, `pin.list` `spanKind: search.pins`; clipboard `searchFieldBusy`/`searchScopeSelectBusy`/`searchFilterChipsBusy`/`searchResultsBusy`/`searchScope`; **search-errors** excludes `pin.list`; ui-flow `composer-focus-channel` after cleared `update-search`; `clearSearchRecentChipFilter` queues composer autofocus; agentctl `searchGuildMessages` refreshView. Bundle: `npm run test:phase553-search`.
**v0.8.482 (Phase 519):** Extended split guild-loading search compositor: `syncSearchRecentChipsDuringGuildLoading`, `syncSearchMeshChipDuringGuildLoading`, `syncSearchPanelLiveDuringGuildLoading` (orchestrated via `syncSearchControlsDuringGuildLoading` + `syncSearchPanelDuringGuildLoading` in `syncSearchPanelsDuringGuildLoading`). Platform `spanKind` on `guild.search`, `guild.search.cache`, and `guild.search.mesh`. Anchored **search-errors** filter (`^guild.search(.cache|.mesh)? error$`). Dev-log clipboard: `lastSearchHitMessageId`, `searchBarBusy`, `searchMeshRefreshBusy`. Search sidecar hits use `aria-current="location"` + roving `tabindex`; `lastSearchHitMessageId` tracked in UI state. `pearcord-ui-flow` emits `composer-focus-channel` after `jump-to-message` in guild mode. Agentctl headless: `searchGuildMessages`, `setSearchScope`. Bundle: `npm run test:phase519-search`; agentctl: `npm run test:agentctl-phase519-search`. **v0.8.482 (Phase 519):** Extended split guild-loading search compositor: `syncSearchRecentChipsDuringGuildLoading`, `syncSearchMeshChipDuringGuildLoading`, `syncSearchPanelLiveDuringGuildLoading` (orchestrated via `syncSearchControlsDuringGuildLoading` + `syncSearchPanelDuringGuildLoading` in `syncSearchPanelsDuringGuildLoading`). Platform `spanKind` on `guild.search`, `guild.search.cache`, and `guild.search.mesh`. Anchored **search-errors** filter (`^guild.search(.cache|.mesh)? error$`). Dev-log clipboard: `lastSearchHitMessageId`, `searchBarBusy`, `searchMeshRefreshBusy`. Search sidecar hits use `aria-current="location"` + roving `tabindex`; `lastSearchHitMessageId` tracked in UI state. `pearcord-ui-flow` emits `composer-focus-channel` after `jump-to-message` in guild mode. Agentctl headless: `searchGuildMessages`, `setSearchScope`. Bundle: `npm run test:phase519-search`; agentctl: `npm run test:agentctl-phase519-search`.
**v0.8.462 (Phase 499):** Split guild-loading search compositor: `syncSearchBarDuringGuildLoading`, `syncSearchFilterChipsDuringGuildLoading`, `syncSearchResultsDuringGuildLoading`, `syncSearchPinsDuringGuildLoading` (orchestrated by `syncSearchPanelsDuringGuildLoading`). Platform spans: `guild.search.cache` (cache hits), `guild.search.mesh` (`meshHitCount`/`localHitCount`/`mergedCount`). Tightened **search-errors** (`^guild.search(.cache|.mesh)? error`). Dev-log clipboard: `searchCached`, `searchHighlightOnly`, `searchSidecarActive`. `ensureComposerSearchHint` guild-loading / mesh-stale / cached copy; `activateSearchHit` queues composer autofocus. Bundle: `npm run test:phase499-search`; agentctl: `npm run test:agentctl-phase499-search` (alias `test:phase435-search-pins`). **v0.8.462 (Phase 499):** Split guild-loading search compositor: `syncSearchBarDuringGuildLoading`, `syncSearchFilterChipsDuringGuildLoading`, `syncSearchResultsDuringGuildLoading`, `syncSearchPinsDuringGuildLoading` (orchestrated by `syncSearchPanelsDuringGuildLoading`). Platform spans: `guild.search.cache` (cache hits), `guild.search.mesh` (`meshHitCount`/`localHitCount`/`mergedCount`). Tightened **search-errors** (`^guild.search(.cache|.mesh)? error`). Dev-log clipboard: `searchCached`, `searchHighlightOnly`, `searchSidecarActive`. `ensureComposerSearchHint` guild-loading / mesh-stale / cached copy; `activateSearchHit` queues composer autofocus. Bundle: `npm run test:phase499-search`; agentctl: `npm run test:agentctl-phase499-search` (alias `test:phase435-search-pins`).