Skip to content

docs(sdd): localfirst-infra-v1 PRD + SDD artifacts - #11

Merged
kattsushi merged 1 commit into
masterfrom
chore/localfirst-infra-v1-sdd
May 22, 2026
Merged

kattsushi merged 1 commit into
masterfrom
chore/localfirst-infra-v1-sdd

Conversation

@kattsushi

Copy link
Copy Markdown
Owner

Goal

Land the PRD + SDD phase artifacts for localfirst-infra-v1 so implementation can proceed in chained PRs with clear scope, requirements, design, and task breakdown.

What’s in this PR

  • PRD: docs/prd/localfirst-infra-v1.md
  • SDD artifacts:
    • openspec/changes/localfirst-infra-v1/proposal.md
    • openspec/changes/localfirst-infra-v1/spec.md
    • openspec/changes/localfirst-infra-v1/design.md
    • openspec/changes/localfirst-infra-v1/tasks.md

Key decisions captured

  • Local-first/client-first, Effect-first foundation slice; Notes is a placeholder bounded context.
  • Chrome/Chromium first.
  • SQLite OPFS in Worker via @effect/sql-sqlite-wasm as reversible spike.
  • effect-qb beta as reversible spike; don’t couple upper layers.
  • LocalDb is infra-only behind repositories.
  • Presentation state uses Effect Atom + Solid integration.
  • Migration authoring DX (Nx generator vs effect-qb CLI vs hybrid) is pending spike results.

Review path

  1. Read PRD first.
  2. Validate spec scenarios are verifiable.
  3. Confirm design matches repo conventions.
  4. Confirm tasks + 5-PR chain forecast look reasonable.

Non-goals (this PR)

  • No implementation code.

Next PRs (planned)

  • PR 2: Spikes + decisions (Worker/OPFS/WASM, effect-qb viability, migration DX decision)
  • PR 3: localfirst-db core (contract + in-memory + migrations)
  • PR 4: localfirst-db browser adapter (Worker + OPFS + BroadcastChannel)
  • PR 5: notes bounded context core
  • PR 6: notes presentation + app wiring + boundary enforcement + verification

@kattsushi
kattsushi merged commit 2509b51 into master May 22, 2026
4 of 6 checks passed
@kattsushi
kattsushi deleted the chore/localfirst-infra-v1-sdd branch May 22, 2026 22:30

This branch was successfully deployed

1 active deployment
preview — 0934b9a4 Deployed May 22, 2026 by kattsushi via Destroy preview #15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant