Repository navigation
id: design: local-dev parity for the serverless edition (from #5681) #5866
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
Wrangler/Miniflare vs local sqld, fixtures, and the offline developer workflow for serverless storage.
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-1549
dezren39 commentedon Nov 5, 2026
🤖 Agent note · picked up
idon Cloudflare Workers #5681) — direct execution lane; confirming scope against the parent, then routing.dezren39 commentedon Nov 5, 2026
🤖 Agent note · triage verdict (task 10268, lane code-g, 2026-11-05)
Verdict: issue #5866 is live, well-scoped, and sits in a complete decomposition — with one real sequencing dependency, recorded below. No defect, no duplicate.
Verified fresh this run:
idon Cloudflare Workers #5681 (serverless edition storage — D1 vs Turso vs both) is OPEN; its decomposition is fully filed and all siblings are OPEN: id: design: serverless storage contract (from #5681) #5863 storage contract, id: design: D1 journal fit (design + spike) (from #5681) #5864 D1 journal fit, id: design: Turso/libSQL journal fit (design + spike) (from #5681) #5865 Turso/libSQL journal fit, id: design: backend choice & migration (from #5681) #5867 backend choice & migration, id: design: cost & limits guardrails (serverless storage) (from #5681) #5868 cost & limits guardrails, id: design: backup, recovery & exit for serverless storage (from #5681) #5869 backup/recovery/exit.idon Cloudflare Workers #5681 itself is stillqueue/queued— its D1-vs-Turso-vs-both decision is not yet recorded, and id: design: backend choice & migration (from #5681) #5867 (backend choice & migration) is the sibling that lands it. The backend-specific half of id: design: local-dev parity for the serverless edition (from #5681) #5866 (Miniflare/D1-local vs sqld) cannot settle before that choice; the backend-agnostic half — fixtures and the offline workflow shape against id: design: serverless storage contract (from #5681) #5863's storage contract — can proceed now. The design should be written in that order rather than guessing the backend.idon Cloudflare Workers #5681 explicitly, per the instruction already on the issue.Routing: no follow-up queue task enqueued — the decomposition tickets are the follow-on work and already exist as open issues. Nothing needs Drew for the design to proceed in the order above.
Issue #5866 stays open for the design work itself.
developing-today commentedon Nov 8, 2026
agent-note:v1 agent=repo-worker-code state=done task=12353 lane=code-f at=2026-11-08T04:56:00Z
🤖 Agent note · triage complete
Verdict: REAL AND CURRENT (verified fresh 2026-11-08, REST reads — the user-token GraphQL limit was already exceeded)
held,user/owned,do-not-merge,do-not-auto-editabsent). Parent design(id): serverless edition storage — D1 vs Turso vs both foridon Cloudflare Workers #5681 is OPEN (status/triaged) and currently claimed/in-progress by another worker; programme epic epic: ID platform expansion — apps, comms, currency, hosting, boards (2026-10-28 directive, LIST 6–15) #2056.idon Cloudflare Workers #5681/id: design: backend choice & migration (from #5681) #5867 backend choice lands; the backend-agnostic half — fixtures and the offline workflow shape against id: design: serverless storage contract (from #5681) #5863's storage contract — can proceed now.Conversion: fix packet enqueued as task 12836 (dedupe
repo-health:v1:fix:developing-today/code:issue:5866, kind small_fix) scoped to producing and landing that decision record, with the sequencing written into its acceptance. Per the triage doctrine, this triage completion does NOT close issue #5866 — it returns to the queue for real work, and closes only via the landed decision record (merged PR with a closing keyword) or an explicit verified closure.14 remaining items
doc: local-dev parity decision record for the serverless edition (#5866…
dezren39 commentedon Nov 8, 2026
🤖 Agent note · done
idon Cloudflare Workers #5681 (both verified OPEN and undecided 2026-11-08); the record fixes the decision rule for each outcome and the resume condition, so the remainder is mechanical once issue id: design: backend choice & migration (from #5681) #5867 lands.dezren39 commentedon Nov 8, 2026
🤖 Agent note · correction
idon Cloudflare Workers #5681. Reopening issue id: design: local-dev parity for the serverless edition (from #5681) #5866 and removing the status:done label so the remainder stays visible; the backend-agnostic record itself is landed and done via PR doc: local-dev parity decision record for the serverless edition (#5866) #7588 (merge commit 8f16bcc).