tasks updated

Author: subtleGradient

.tasks/backlog/TASK-048-crsql-mesh-protocol-schema-reuse.md

@@ -0,0 +1,45 @@
+# TASK-048: Global Mesh — Protocol schema reuse alignment
+
+## Status
+- [x] Planned
+- [ ] Assigned
+- [ ] In Progress
+- [ ] Blocked (reason: ...)
+- [ ] Complete
+
+## Priority
+high
+
+## Assigned To
+subagent (general)
+
+## Parent Docs / Cross-links
+- Spec rules: `effect-native/.specs/AGENTS.md`
+- Protocol Phase 1: `effect-native/.specs/crsql-mesh-protocol/instructions.md`
+- Protocol Phase 2: `effect-native/.specs/crsql-mesh-protocol/requirements.md`
+- Protocol Phase 3: `effect-native/.specs/crsql-mesh-protocol/design.md`
+- Protocol Phase 4: `effect-native/.specs/crsql-mesh-protocol/plan.md`
+- Gap backlog: `research/zig-cr/92-gap-backlog.md`
+
+## Description
+Align `@effect-native/crsql-mesh-protocol` implementation with Phase 2 requirement **FR-PROTO-001** (schema reuse): reuse schema definitions from `@effect-native/crsql/CrSqlSchema` instead of re-declaring near-identical schemas.
+
+This is about tightening the single-source-of-truth boundary at the DB/IO boundary.
+
+## Files to Modify
+- `effect-native/packages-native/crsql-mesh-protocol/src/Messages.ts`
+- `effect-native/packages-native/crsql-mesh-protocol/src/index.ts` (if exports change)
+- `effect-native/packages-native/crsql-mesh-protocol/test/*`
+
+## Acceptance Criteria
+- [ ] `SiteIdHex`, `VersionString`, `ChangeRowSerialized`, and any other shared schema types are imported/re-exported from `@effect-native/crsql/CrSqlSchema`.
+- [ ] No duplicate “copy” schemas remain in `crsql-mesh-protocol` for types that already exist in `@effect-native/crsql`.
+- [ ] Existing protocol encode/decode tests still pass.
+- [ ] Add/adjust tests (if needed) to prove the protocol uses the crsql schemas (not structurally-identical copies).
+
+## Progress Log
+### 2025-12-15
+- Task created during “Update tasks” reconciliation.
+
+## Completion Notes
+[fill in when done]

.tasks/backlog/TASK-049-crsql-mesh-engine-phase4.md

@@ -0,0 +1,55 @@
+# TASK-049: Global Mesh — Mesh engine Phase 4 completion
+
+## Status
+- [x] Planned
+- [ ] Assigned
+- [ ] In Progress
+- [ ] Blocked (reason: ...)
+- [ ] Complete
+
+## Priority
+high
+
+## Assigned To
+subagent (general)
+
+## Parent Docs / Cross-links
+- Spec rules: `effect-native/.specs/AGENTS.md`
+- Mesh Phase 1: `effect-native/.specs/crsql-mesh/instructions.md`
+- Mesh Phase 2: `effect-native/.specs/crsql-mesh/requirements.md`
+- Mesh Phase 3: `effect-native/.specs/crsql-mesh/design.md`
+- Mesh Phase 4: `effect-native/.specs/crsql-mesh/plan.md`
+- Protocol requirements: `effect-native/.specs/crsql-mesh-protocol/requirements.md`
+- Transport requirements: `effect-native/.specs/crsql-mesh-transport/requirements.md`
+- Gap backlog: `research/zig-cr/92-gap-backlog.md`
+
+## Description
+Complete the Phase 4 plan for `@effect-native/crsql-mesh` so it satisfies the Phase 2 requirements:
+
+- receive routing + protocol decode
+- per-peer periodic summary exchange
+- diff request/response loop
+- transactional apply via `crsql_changes`
+- in-memory version vector updates only after successful apply
+- progress observation surface
+
+Keep the scope within the `crsql-mesh` package (no new transport implementations beyond in-memory).
+
+## Files to Modify
+- `effect-native/packages-native/crsql-mesh/src/**`
+- `effect-native/packages-native/crsql-mesh/test/**`
+
+## Acceptance Criteria
+- [ ] `Mesh.run` runs fibers owned by scope (not `Effect.never`).
+- [ ] Invalid incoming messages are dropped with typed `ProtocolError` handling.
+- [ ] Two peers converge using `InMemoryTransport` and a real CR-SQLite DB integration test (or a clearly-scoped interim harness if real DB is not yet available in CI).
+- [ ] Version vector updates only after successful transactional apply.
+- [ ] `observeProgress` emits after apply-driven db_version advances.
+- [ ] `pnpm -C effect-native vitest packages-native/crsql-mesh` passes.
+
+## Progress Log
+### 2025-12-15
+- Task created during “Update tasks” reconciliation.
+
+## Completion Notes
+[fill in when done]

.tasks/backlog/TASK-050-crsql-mesh-runtime-node-phase4.md

@@ -0,0 +1,50 @@
+# TASK-050: Global Mesh — Node runtime Phase 4 completion
+
+## Status
+- [x] Planned
+- [ ] Assigned
+- [ ] In Progress
+- [ ] Blocked (reason: ...)
+- [ ] Complete
+
+## Priority
+high
+
+## Assigned To
+subagent (general)
+
+## Parent Docs / Cross-links
+- Spec rules: `effect-native/.specs/AGENTS.md`
+- Runtime Phase 1: `effect-native/.specs/crsql-mesh-runtime/instructions.md`
+- Runtime Phase 2: `effect-native/.specs/crsql-mesh-runtime/requirements.md`
+- Runtime Phase 3 (node): `effect-native/.specs/crsql-mesh-runtime/design.md`
+- Runtime Phase 4: `effect-native/.specs/crsql-mesh-runtime/plan.md`
+- Protocol requirements: `effect-native/.specs/crsql-mesh-protocol/requirements.md`
+- Gap backlog: `research/zig-cr/92-gap-backlog.md`
+
+## Description
+Complete the Phase 4 plan for `@effect-native/crsql-mesh-runtime-node`:
+
+- validate and prepare `databasePath`
+- open SQLite database at `databasePath`
+- load the CR-SQLite extension
+- ensure protocol layer init runs (fail-fast on `UnhexUnavailable`)
+- wire process lifecycle hooks (SIGINT/SIGTERM) for graceful shutdown within `shutdownTimeout`
+
+## Files to Modify
+- `effect-native/packages-native/crsql-mesh-runtime-node/src/**`
+- `effect-native/packages-native/crsql-mesh-runtime-node/test/**`
+
+## Acceptance Criteria
+- [ ] `NodeRuntimeLive` actually opens the database and loads CR-SQLite.
+- [ ] Protocol layer initialization happens during layer acquisition.
+- [ ] `UnhexUnavailable` fails runtime without fallback.
+- [ ] SIGINT/SIGTERM triggers bounded shutdown.
+- [ ] `pnpm -C effect-native vitest packages-native/crsql-mesh-runtime-node` passes.
+
+## Progress Log
+### 2025-12-15
+- Task created during “Update tasks” reconciliation.
+
+## Completion Notes
+[fill in when done]

.wishes/done/effect-native.md

@@ -13,12 +13,22 @@ we follow the spec-first workflow defined in effect-native/.specs/AGENTS.md
 let's start planning a set of new packages for all this stuff
 especially research/zig-cr/102-proposal-crsqlite-global-mesh.md
 
-Tracking:
-- Submodules + TS-work rule: [`.tasks/backlog/TASK-038-add-effect-native-submodules.md`](../.tasks/backlog/TASK-038-add-effect-native-submodules.md)
-- Global mesh package-map spec (Phase 1): [`.tasks/backlog/TASK-039-spec-global-mesh-package-map.md`](../.tasks/backlog/TASK-039-spec-global-mesh-package-map.md)
-- Protocol spec: [`.tasks/backlog/TASK-040-spec-crsql-mesh-protocol.md`](../.tasks/backlog/TASK-040-spec-crsql-mesh-protocol.md)
-- Core engine spec: [`.tasks/backlog/TASK-041-spec-crsql-mesh-core.md`](../.tasks/backlog/TASK-041-spec-crsql-mesh-core.md)
-- Transport interface spec: [`.tasks/backlog/TASK-042-spec-crsql-mesh-transport.md`](../.tasks/backlog/TASK-042-spec-crsql-mesh-transport.md)
-- `@effect-native/crsql` integration spec: [`.tasks/backlog/TASK-043-spec-crsql-mesh-integration.md`](../.tasks/backlog/TASK-043-spec-crsql-mesh-integration.md)
-- `@effect-native/libcrsql` changes spec: [`.tasks/backlog/TASK-044-spec-libcrsql-next.md`](../.tasks/backlog/TASK-044-spec-libcrsql-next.md)
-- Runtime adapters spec: [`.tasks/backlog/TASK-045-spec-crsql-mesh-runtime.md`](../.tasks/backlog/TASK-045-spec-crsql-mesh-runtime.md)
+---
+
+## Completed: 2025-12-15
+
+- Reference submodules added: `.refs/effect/`, `.refs/effect-smol/`
+- Work submodule added: `effect-native/`
+- Repo rule added: all TS work lives in `effect-native/` and follows `effect-native/.specs/AGENTS.md`
+- Global mesh planning/specs created under `effect-native/.specs/`
+
+Tracking (historical):
+- Submodules + TS-work rule: [`.tasks/done/TASK-038-add-effect-native-submodules.md`](../../.tasks/done/TASK-038-add-effect-native-submodules.md)
+- Global mesh package-map spec (Phase 1): [`.tasks/done/TASK-039-spec-global-mesh-package-map.md`](../../.tasks/done/TASK-039-spec-global-mesh-package-map.md)
+- Protocol spec: [`.tasks/done/TASK-040-spec-crsql-mesh-protocol.md`](../../.tasks/done/TASK-040-spec-crsql-mesh-protocol.md)
+- Core engine spec: [`.tasks/done/TASK-041-spec-crsql-mesh-core.md`](../../.tasks/done/TASK-041-spec-crsql-mesh-core.md)
+- Transport interface spec: [`.tasks/done/TASK-042-spec-crsql-mesh-transport.md`](../../.tasks/done/TASK-042-spec-crsql-mesh-transport.md)
+- `@effect-native/crsql` integration spec: [`.tasks/done/TASK-043-spec-crsql-mesh-integration.md`](../../.tasks/done/TASK-043-spec-crsql-mesh-integration.md)
+- `@effect-native/libcrsql` changes spec: [`.tasks/done/TASK-044-spec-libcrsql-next.md`](../../.tasks/done/TASK-044-spec-libcrsql-next.md)
+- Runtime adapters spec: [`.tasks/done/TASK-045-spec-crsql-mesh-runtime.md`](../../.tasks/done/TASK-045-spec-crsql-mesh-runtime.md)
+- Phase 2 requirements (node-first slice): [`.tasks/done/TASK-046-phase2-requirements-crsql-mesh.md`](../../.tasks/done/TASK-046-phase2-requirements-crsql-mesh.md)

.wishes/done/release-planning.md

@@ -21,6 +21,5 @@ e.g. nix, npm, ???
 - Docs: In-repo, near code (README.md updates, browser-dist/README.md)
 
 **Next engineering tasks identified:**
-- TASK-037: Publish browser package to npm beta
-- TASK-038: Set up Zig Linux CI builds
-- TASK-039: Create platform-specific npm packages
+- zig-sqlite upstream feedback capture: `.tasks/backlog/TASK-037-zig-sqlite-upstream-feedback-blocked.md`
+- Release engineering gaps: (create new `.tasks/backlog/` cards as needed; see `research/zig-cr/92-gap-backlog.md` Release section)

.wishes/start-here.md

@@ -11,13 +11,13 @@ If you’re asking “what’s left?” start here:
 
 ## Next parallel work (curated)
 
-- Mesh Phase 2 (approved by Tom):
-  - `.tasks/backlog/TASK-046-phase2-requirements-crsql-mesh.md`
-  - `.tasks/backlog/TASK-047-phase1-react-native-runtime-specs.md`
+- Global mesh (TS, Phase 4 implementation gaps):
+  - `.tasks/backlog/TASK-048-crsql-mesh-protocol-schema-reuse.md`
+  - `.tasks/backlog/TASK-049-crsql-mesh-engine-phase4.md`
+  - `.tasks/backlog/TASK-050-crsql-mesh-runtime-node-phase4.md`
 - Web phase 2 (TS, spec-gated):
   - `.tasks/backlog/TASK-031-web-service-worker-fallback.md`
   - `.tasks/backlog/TASK-032-web-reactive-subscriptions.md`
-- Mobile embedding guide (docs): `.tasks/backlog/TASK-033-mobile-static-embedding-guide.md`
 - Upstream feedback capture (blocked): `.tasks/backlog/TASK-037-zig-sqlite-upstream-feedback-blocked.md`
 
 ## Rules of the game (thing-golf)

research/zig-cr/92-gap-backlog.md

@@ -1,6 +1,6 @@
 # 92-gap-backlog
 
-> Last updated: 2025-12-14 (Round 30)
+> Last updated: 2025-12-15 (Round 31)
 
 ## Status
 
@@ -15,19 +15,20 @@ Pick disjoint tasks from `.tasks/backlog/`:
 - Web phase 2 (TS, blocked until Phase 2 specs exist for browser runtime)
   - Service Worker fallback: `.tasks/backlog/TASK-031-web-service-worker-fallback.md`
   - Reactive subscriptions: `.tasks/backlog/TASK-032-web-reactive-subscriptions.md`
-- Global mesh implementation (TS, ✅ Phase 4 complete, ready for Phase 5 integration)
-  - All 4 packages implemented: protocol, transport, mesh, runtime-node
-  - 69 tests passing across packages
+- Global mesh implementation (TS, Phase 4 plans exist; implementation gaps remain)
+  - Protocol schema reuse alignment: `.tasks/backlog/TASK-048-crsql-mesh-protocol-schema-reuse.md`
+  - Mesh engine Phase 4 completion: `.tasks/backlog/TASK-049-crsql-mesh-engine-phase4.md`
+  - Node runtime Phase 4 completion: `.tasks/backlog/TASK-050-crsql-mesh-runtime-node-phase4.md`
 - Upstream goodwill (blocked on Tom)
   - zig-sqlite feedback cards: `.tasks/backlog/TASK-037-zig-sqlite-upstream-feedback-blocked.md`
 
 ## Done (recent)
 
-- **Mesh Phase 4 implementation (all packages)**: 4 packages implemented with 69 tests (2025-12-14)
-  - `@effect-native/crsql-mesh-protocol` — message schemas, decode helpers, unhex() check
-  - `@effect-native/crsql-mesh-transport` — Transport tag, InMemoryTransport for tests
-  - `@effect-native/crsql-mesh` — Mesh service, receive routing, version vectors, apply pipeline
-  - `@effect-native/crsql-mesh-runtime-node` — Node runtime layer, config validation, lifecycle
+- **Mesh packages (Phase 4 scaffolding + partial implementation)** (2025-12-14)
+  - `@effect-native/crsql-mesh-transport` — Transport tag + deterministic InMemoryTransport (good)
+  - `@effect-native/crsql-mesh-protocol` — unhex() check wired, but schema reuse vs `@effect-native/crsql/CrSqlSchema` needs alignment
+  - `@effect-native/crsql-mesh` — internal modules exist + unit-style tests, but `Mesh.run` orchestration is not implemented yet
+  - `@effect-native/crsql-mesh-runtime-node` — config validation exists; DB open/extension load/lifecycle hooks not implemented yet
 - **Mesh Phase 2 requirements (node-first)**: `.tasks/done/TASK-046-phase2-requirements-crsql-mesh.md` (2025-12-14)
 - **Mesh Phase 3 designs + Phase 4 RGRTDD plans**: `effect-native/.specs/crsql-mesh/plan.md` (2025-12-15)
 - **Mesh protocol Phase 4 RGRTDD plan**: `effect-native/.specs/crsql-mesh-protocol/plan.md` (2025-12-15)
@@ -52,15 +53,21 @@ Source: `research/zig-cr/96-proposal-multitab-wasm-sqlite-crsqlite.md`
 
 Note: TS work is spec-gated under `effect-native/.specs/AGENTS.md`.
 
-### Global mesh (Phase 4 ✅ complete, Phase 5 next)
+### Global mesh (Phase 4 plans exist; implementation work is pending)
 
 Source: `research/zig-cr/102-proposal-crsqlite-global-mesh.md` and `effect-native/.specs/crsqlite-global-mesh-packages/instructions.md`
 
-- [x] `@effect-native/crsql-mesh` Phase 4 plan → implemented (2025-12-14)
-- [x] `@effect-native/crsql-mesh-protocol` Phase 4 plan → implemented (2025-12-14)
-- [x] `@effect-native/crsql-mesh-transport` Phase 4 plan → implemented (2025-12-14)
-- [x] `@effect-native/crsql-mesh-runtime-node` Phase 4 plan → implemented (2025-12-14)
-- [ ] Phase 5: Real SQLite integration tests + production transport implementations
+Spec artifacts:
+- [x] Phase 1 instructions: `.tasks/done/TASK-039-spec-global-mesh-package-map.md`
+- [x] Phase 2 requirements: `.tasks/done/TASK-046-phase2-requirements-crsql-mesh.md`
+- [x] Phase 3 designs: `effect-native/.specs/crsql-mesh*/design.md`
+- [x] Phase 4 plans: `effect-native/.specs/crsql-mesh*/plan.md`
+
+Implementation gaps tracked as tasks:
+- [ ] Protocol: ensure schema reuse from `@effect-native/crsql/CrSqlSchema` (FR-PROTO-001) → `.tasks/backlog/TASK-048-crsql-mesh-protocol-schema-reuse.md`
+- [ ] Mesh engine: implement anti-entropy loop + transactional apply per Phase 4 plan → `.tasks/backlog/TASK-049-crsql-mesh-engine-phase4.md`
+- [ ] Node runtime: implement DB open + CR-SQLite extension load + lifecycle hooks → `.tasks/backlog/TASK-050-crsql-mesh-runtime-node-phase4.md`
+- [ ] Phase 5: real SQLite integration + production transports (separate task once Phase 4 complete)
 
 ### Mobile static embedding docs