Repository navigation
id: design: serverless storage contract (from #5681) #5863
Description
Summary
Follow-on design ticket from #5681 — its decomposition sketch names this as a separate design, and the parent's acceptance requires these tickets to be filed and linked. Filed in the 2026-11-04 gap pass (WS-F) so the design work exists and can be prioritised on its own merits; implementation timing is a separate decision, possibly months out.
What this design must settle
The minimal ID storage interface both backends must satisfy: journal append/read, world state, indexes — the contract that makes the backend a choice instead of a fork.
Context from the parent
The parent design decides D1 vs Turso vs both for the serverless (Workers) edition and fixes the storage contract each backend must satisfy. The parent issue carries the surrounding decisions this ticket must not re-decide; where this ticket's answer would change a parent decision, record that explicitly rather than silently forking it.
Decision record expected
Close this design with a recorded decision (on this issue or in a doc/ record linked from it): the chosen shape, the alternatives rejected and why, and the invariants implementation must hold. If the design splits further, file the splits and link them here rather than growing this issue.
Relations
Parent: #5681. Programme: epic #2056. Filed by WS-F (2026-11-04 ID design gap & expansion pass).
Activity
developing-today commentedon Nov 5, 2026
CODE-1546
dezren39 commentedon Nov 5, 2026
🤖 Agent note · handed off
developing-today commentedon Nov 5, 2026
🤖 Agent note · handed off
idon Cloudflare Workers #5681) — handed off to the opencode claimant per execution-lane assignment (assigned_lane=opencode); this lane does not work task 10265 itself.80 remaining items
dezren39 commentedon Nov 6, 2026
🤖 Agent note · handed off
dezren39 commentedon Nov 8, 2026
agent-note:v1
event: picked_up
task: 10265 (repo-health-code-pilot; worker repo-worker-code; OpenChamber scheduled lane c29174f1-48e0-4b13-b4ff-9b73ab67e9ab)
state: claimed; resuming from saved handed_off checkpoint.
next: Revalidate issue #5863 and related work at current main, then record a scoped triage verdict or complete as already done.
dezren39 commentedon Nov 8, 2026
agent-note:v1
event: triaged
task: 10265 (repo-health-code-pilot; worker repo-worker-code; OpenChamber scheduled lane c29174f1-48e0-4b13-b4ff-9b73ab67e9ab)
verdict: #5863 remains actionable and OPEN. The current main search found no contract decision record or implementation for this issue.
evidence: Parent #5681 remains OPEN; its Nov 5 direction chooses both-with-roles and identifies #5863 as the natural first child. The open D1 journal spike PR #6350 is for #5864, not this issue, and explicitly states the #5863 storage contract remains open and the D1 schema/ordinal are provisional. No competing PR for #5863 was found.
scope/order: Design the minimum shared storage contract for journal append/read, world state, and indexes, with invariants and explicit backend-specific limits; do not reopen the parent platform choice. Settle this contract before or alongside the #5864/#5865 D1 and Turso fit work, then feed #5681 synthesis and #5867 backend-choice/migration. PR #6350 is Drew-authored on the separate #5864 spike; this lane did not touch it.
next: Write and link the decision record under #5863; update the #5864/#5865 spikes against that contract. No duplicate queue task was created because #5863 is already the scoped design follow-up and the queue packet schema has no design kind.