++

Author: subtleGradient

.tasks/backlog/TASK-047-phase1-react-native-runtime-specs.md

@@ -2,10 +2,10 @@
 
 ## Status
 - [x] Planned
-- [ ] Assigned
-- [ ] In Progress
+- [x] Assigned
+- [x] In Progress
 - [ ] Blocked (reason: ...)
-- [ ] Complete
+- [x] Complete
 
 ## Priority
 low
@@ -32,13 +32,26 @@ Important: this is a guide + validation harness, not a full RN integration.
 - `research/zig-cr/92-gap-backlog.md` (status notes)
 
 ## Acceptance Criteria
-- [ ] Clear steps for building a static archive for target platforms.
-- [ ] Explicit note about why dynamic extension loading often fails on mobile.
-- [ ] A minimal "hello" validation strategy described (even if not runnable in CI).
+- [x] Clear steps for building a static archive for target platforms.
+- [x] Explicit note about why dynamic extension loading often fails on mobile.
+- [x] A minimal "hello" validation strategy described (even if not runnable in CI).
 
 ## Progress Log
 ### 2025-12-14
 - Task created during gap review; not yet started
+- Task completed: created comprehensive mobile static embedding guide
 
 ## Completion Notes
-[fill in when done]
+**Completed: 2025-12-14**
+
+Created `research/zig-cr/104-mobile-static-embedding-guide.md` covering:
+- Why static embedding is required (dynamic loading blocked on iOS, limited on Android)
+- Zig build commands for all iOS and Android targets
+- iOS integration: XCFramework creation, Swift/ObjC init code examples
+- Android integration: CMake setup, JNI wrapper, Kotlin examples
+- Validation strategy: symbol checks, minimal "hello" test apps, integration checklist
+- Common issues and troubleshooting
+
+Also updated:
+- `zig/README.md`: added link to guide, removed "packaging guides" from limitations
+- `research/zig-cr/92-gap-backlog.md`: marked mobile embedding docs as done

…ASK-033-mobile-static-embedding-guide.md …ASK-033-mobile-static-embedding-guide.md.tasks/backlog/TASK-033-mobile-static-embedding-guide.md renamed to .tasks/done/TASK-033-mobile-static-embedding-guide.md .tasks/backlog/TASK-033-mobile-static-embedding-guide.md renamed to .tasks/done/TASK-033-mobile-static-embedding-guide.md

@@ -2,10 +2,10 @@
 
 ## Status
 - [x] Planned
-- [ ] Assigned
-- [ ] In Progress
+- [x] Assigned
+- [x] In Progress
 - [ ] Blocked (reason: ...)
-- [ ] Complete
+- [x] Complete
 
 ## Priority
 high
@@ -41,15 +41,33 @@ STOP after Phase 2 docs (do not design or implement).
 - `effect-native/.specs/crsql-mesh-runtime/requirements.md`
 
 ## Acceptance Criteria
-- [ ] All requirements use EARS notation.
-- [ ] Requirements reference reuse of `@effect-native/crsql` schemas (no duplicate serialization types).
-- [ ] `unhex()` requirement is explicit and includes fail-fast behavior (`UnhexUnavailable`).
-- [ ] Node runtime requirements explicitly depend on `@effect/platform` capabilities.
-- [ ] Each requirements.md has a short “Out of Scope” section aligned with Phase 1.
+- [x] All requirements use EARS notation.
+- [x] Requirements reference reuse of `@effect-native/crsql` schemas (no duplicate serialization types).
+- [x] `unhex()` requirement is explicit and includes fail-fast behavior (`UnhexUnavailable`).
+- [x] Node runtime requirements explicitly depend on `@effect/platform` capabilities.
+- [x] Each requirements.md has a short "Out of Scope" section aligned with Phase 1.
 
 ## Progress Log
 ### 2025-12-15
 - Task created from Tom-approved Phase 2 gate
 
+### 2025-12-14
+- Completed Phase 2 requirements for all four packages
+
 ## Completion Notes
-[fill in when done]
+**Date:** 2025-12-14
+
+**Summary:** Created Phase 2 `requirements.md` files for the node-first crsql-mesh slice using EARS notation.
+
+**Files Created:**
+1. `effect-native/.specs/crsql-mesh-protocol/requirements.md` - 7 FRs covering schema reuse, unhex() check, message types
+2. `effect-native/.specs/crsql-mesh-transport/requirements.md` - 7 FRs covering interface, in-memory transport, lifecycle
+3. `effect-native/.specs/crsql-mesh/requirements.md` - 12 FRs covering anti-entropy loop, version vectors, change pull/apply
+4. `effect-native/.specs/crsql-mesh-runtime/requirements.md` - 9 FRs covering Node runtime with @effect/platform
+
+**Key Decisions Encoded:**
+- Schema reuse from `@effect-native/crsql/CrSqlSchema` (no duplicate types)
+- `unhex()` fail-fast with `UnhexUnavailable` (FR-PROTO-002)
+- Node runtime depends on `@effect/platform` (FR-NODE-001)
+- InMemoryTransport for testing two-peer sync (FR-TRANS-002)
+- Bun support folded into Node runtime (FR-NODE-009)

…SK-046-phase2-requirements-crsql-mesh.md …SK-046-phase2-requirements-crsql-mesh.md.tasks/backlog/TASK-046-phase2-requirements-crsql-mesh.md renamed to .tasks/done/TASK-046-phase2-requirements-crsql-mesh.md .tasks/backlog/TASK-046-phase2-requirements-crsql-mesh.md renamed to .tasks/done/TASK-046-phase2-requirements-crsql-mesh.md

@@ -0,0 +1,63 @@
+# TASK-047: Phase 1 instructions — React Native runtime packages
+
+## Status
+- [x] Planned
+- [x] Assigned
+- [x] In Progress
+- [ ] Blocked (reason: ...)
+- [x] Complete
+
+## Priority
+medium
+
+## Assigned To
+subagent (general)
+
+## Parent Docs / Cross-links
+- Tom notes: `.wishes/done/tom-review-crsql-mesh-instructions.md`
+- Package map: `effect-native/.specs/crsqlite-global-mesh-packages/instructions.md` (RN package names)
+- Spec-first rules: `effect-native/.specs/AGENTS.md`
+
+## Description
+Create Phase 1 `instructions.md` for React Native runtime packages:
+
+- `@effect-native/crsql-mesh-runtime-react-native-op-sqlite`
+- `@effect-native/crsql-mesh-runtime-react-native-expo-sqlite`
+
+Keep it thing-golf small: intent + out-of-scope only.
+No requirements/design/implementation.
+
+STOP after Phase 1 docs.
+
+## Files to Create
+- `effect-native/.specs/crsql-mesh-runtime-react-native-op-sqlite/instructions.md`
+- `effect-native/.specs/crsql-mesh-runtime-react-native-expo-sqlite/instructions.md`
+
+## Acceptance Criteria
+- [x] Each instructions.md follows Phase 1 rules.
+- [x] Each doc explicitly states extension-loading assumptions (native vs wasm).
+- [x] Each doc explicitly excludes Electron.
+
+## Progress Log
+### 2025-12-15
+- Task created from Tom request
+
+### 2025-12-14
+- Created `effect-native/.specs/crsql-mesh-runtime-react-native-op-sqlite/instructions.md`
+- Created `effect-native/.specs/crsql-mesh-runtime-react-native-expo-sqlite/instructions.md`
+
+## Completion Notes
+**Date:** 2025-12-14
+
+**Summary:** Created Phase 1 `instructions.md` files for both React Native runtime packages.
+
+**Files created:**
+- `effect-native/.specs/crsql-mesh-runtime-react-native-op-sqlite/instructions.md`
+- `effect-native/.specs/crsql-mesh-runtime-react-native-expo-sqlite/instructions.md`
+
+**Key decisions documented:**
+- Both packages use **native extension loading** (not WASM) — `.dylib` on iOS, `.so` on Android
+- Both packages explicitly exclude Electron
+- op-sqlite package targets general React Native apps
+- expo-sqlite package requires Expo SDK 54+ for `loadExtensionAsync()` support
+- Cross-app sync, background scheduling, and battery-aware sync are deferred to future work