openclaw/docs/reference
Peter Steinberger 135f934db6
refactor(transcripts): run stored lookups in the shared SQLite worker (#146547)
Related: #144592
Related: #147375
Related: #147246
Dependency: #151816

## What Problem This Solves

Stored transcript detail and note lookups return promises but still execute SQLite on the Gateway event loop.

## User Impact

Transcript identity, descriptor, note, summary, and utterance lookups execute in the shared SQLite worker. Existing selectors, content, ordering, limits, and error responses are preserved. No schema migration or configuration change is required.

Chronological list queries and streaming/export snapshots retain their current owners. Capture appends are a separate stacked change in #151760.

## Why This Change Was Made

Eleven typed commands call the existing read kernels through the canonical shared-state worker. Compound enumeration, matching, and library reads keep one deferred snapshot. First-use schema creation finishes before those reads, canonical close drains accepted work, and existing-only task inspection stays non-creating. Meeting fixtures stop producers before asynchronous database cleanup, and canonical test routing keeps worker consumers in their owning processes.

The composition preserves Doctor's device-token dispatch alongside all eleven transcript commands, shared transaction-settlement checks, plugin-reload ownership, and current test-routing changes. Chronological reads preserve their parent-timezone date function; exports preserve their snapshot lifetime.

Qualified dependency history from #151816 is incorporated through normal merge ancestry. It pins the deprecated message facade at its published exports, aligns three global surface limits with the resulting smaller counts, and carries the canonical catalog-materialization prerequisite with its strict 18-read assertion. The per-entry SDK compatibility limit remains unchanged. This does not claim that dependency PR #151816 has merged.

## Evidence

The current catalog carry passed a fresh normal production build in 319.083 seconds and all five real transcript/Doctor SQLite worker controls in 21.595 seconds. Fresh independent P2 review found no actionable issues. These checks cover the changed Gateway and shared-worker import closures. All 58 non-doc meeting feature files, including the combined Doctor/transcript dispatcher, remain byte-identical to `6b3c5acb8634`; storage docs only gain the qualified upstream task paragraph.

The SDK owner's strict catalog control and 25 archived-list/backfill controls are reused for matching owner inputs. The strict assertion retains three binding-authority checks and zero plugin-state worker operations while accounting for 18 SQLite reads after canonical materialization changes. The shared worker composition is separately covered by the five fresh controls above.

Retained compiled child CLI/Gateway proof belongs to the earlier captured-main `6c6dc44250` composition: the test body passed in 21.539 seconds under its unchanged 180-second bound, with 404.282 seconds for the supported wrapper and private-QA build. It checks canonical SQLite state, delegated missing-session cleanup while the isolated Gateway stays alive, transcript list/show/path commands, and exported bytes. This compiled scenario was not rerun on the latest catalog carry.

The preceding combined 62-file gate passed in 966.651 seconds, including production/test types, SDK/storage boundaries, formatting, lint, and three unused-export scans with zero findings. Six SDK facade tests and independent P2 review passed. The subsequent exact three SDK ratchet decreases passed all ten existing reporter tests, the canonical surface check, the changed-script gate, and fresh P2 review. Earlier reload and routing controls remain attributed to their qualified inputs.

CI at `6b3c5acb8634` completed with 140 successful jobs, 14 skipped, and one substantive failure plus its aggregate gate: the shared catalog benchmark expected 20 reads but the CI main composition performed 18. That matched the SDK owner's independently reproduced prerequisite issue. This carry includes its qualified canonical prerequisite and strict assertion correction; strict equality, authority-count, and zero-I/O checks remain intact, with unchanged deadlines. The new head requires its own hosted CI before landing.
2026-09-18 08:52:29 -07:00
..
database-schemas refactor(transcripts): run stored lookups in the shared SQLite worker (#146547) 2026-09-18 08:52:29 -07:00
full-release-validation fix(release): continue publication validation after child retries (#151469) 2026-09-18 00:47:43 -07:00
session-management-compaction fix(sessions): isolate fresh creation from archive retries (#148958) 2026-09-17 08:24:45 -07:00
templates feat(onboarding): offer four avatar choices during hatching (#146669) 2026-09-12 19:58:12 -07:00
test fix(test): retain Node for Node-owned tooling under Bun (#151772) 2026-09-18 07:53:41 -07:00
AGENTS.default.md docs: fix verified accuracy findings in channels, cli, nodes, and reference (#143950) 2026-09-10 18:58:15 +08:00
api-usage-costs.md docs: fix verified accuracy findings in channels, cli, nodes, and reference (#143950) 2026-09-10 18:58:15 +08:00
credits.md docs: fix and reciprocate cross-page links across install, help, reference, start, and web (#143773) 2026-09-10 15:35:25 +09:00
database-schemas.md docs: fix 20 link defects confirmed live in the verified backlog (#144133) 2026-09-11 03:48:10 +08:00
device-models.md feat(ios): render Mermaid diagrams in native chat (#135470) 2026-09-01 17:42:01 -07:00
full-release-validation.md docs(reference): split the full release validation guide by reader job (#142774) 2026-09-09 10:18:22 +08:00
memory-config.md fix(memory): honor bootstrap budget during promotion (#142545) 2026-09-13 18:42:01 -07:00
openclaw-ai.md perf: narrow model fetch diagnostic imports (#141488) 2026-09-07 12:59:58 -07:00
prompt-caching.md fix(agents): attribute prompt-cache drops to system prompt suffix churn (#150547) 2026-09-17 08:02:15 -07:00
pull-request-review-flow.md
release-performance-sweep.md
RELEASING.md fix(release): allow an explicit operator soak waiver for stable publication (#151880) 2026-09-18 08:17:11 -07:00
rich-output-protocol.md fix(media): preserve signed generation URLs across delivery retries (#118830) 2026-09-17 07:57:33 -07:00
rpc.md
secret-placeholder-conventions.md
secretref-credential-surface.md docs: close the small audit categories (generated, governance, link, split) (#144029) 2026-09-10 21:52:03 +08:00
secretref-user-supplied-credentials-matrix.json feat: add Team Reports plugin for GitHub and Discord activity reports (#139850) 2026-09-06 23:15:10 -07:00
session-management-compaction.md docs(reference): split the session management deep dive by reader job (#143082) 2026-09-09 21:03:41 +09:00
test.md docs(reference): split the testing reference by reader job (#141221) 2026-09-09 02:15:05 +08:00
token-use.md fix(usage): refresh model prices after catalog writes (#146113) 2026-09-12 09:40:57 -07:00
transcript-hygiene.md feat: refresh plugin tools within active agent conversations (#145648) 2026-09-12 03:53:24 -07:00