docs: 0048 live-DB evidence (runs are e2e artifacts — purge recommended) + 0049 read-models proposal #125
chad
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "glen/docs-read-models"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Two doc commits — no code, no behavior. Both need your approval to proceed to implementation.
1.
docs/0048amended with live-DB evidence (query run read-only on bee): 12machine_runstotal, all created 2026-10-10 (the day the writers were deleted), 7 completed / 5 cancelled, and the titles are e2e-test artifacts — "tabs or spaces?", "is a haiku 17 syllables?", "name one prime". There is no work product in those tables. This changes the doc's framing: options A (keep rendering) and B (backfill transcript) were both priced against "keep history browsable," but the data says nothing is worth browsing. New option C — purge: one migration deletes the 12 run conversations, drops both tables, and deletes every read path from the residue list (/r, redirect,hrefForarm, glyph,runUnread,db/machines.ts) — residue to zero, per the 0032 precedent. Recommendation: C (B only if the one real conversation's words matter to you).2.
docs/0049— read models out ofdb/(new draft): the four view-shape type groups (attention, sidebar shapes fromorganize,search,sandbox-view) move tolib/read-models/; queries and invariants stay indb/and re-import the types. An eslintno-restricted-importsoverride then makes "components never import db" checkable instead of remembered. ~29 import sites, zero runtime change.Your merge of this PR = approval of both docs; the implementation PRs follow separately (0048-C first if you agree with the purge call — say so in the merge or comments if you'd rather have B).
Read-only query on bee: 12 machine_runs, all 2026-10-10 (the day the writers were deleted), 7 completed / 5 cancelled, titles are test noise ("tabs or spaces?", "is a haiku 17 syllables?"). Both option A and B were priced against keeping history browsable; the data says there is nothing worth browsing. Adds option C (purge, per the 0032 precedent) as the recommendation.Draft, not yet approved. The four view-shape type groups in db/{attention,organize,search,sandbox-view}.ts move to lib/read-models/ (queries and invariants stay in db/); an eslint no-restricted-imports override then makes the component boundary checkable instead of remembered. 29 import sites, zero behavior change.