++

Author: subtleGradient

.wishes/blocked-on-tom/tom-review-crsql-mesh-instructions.md

@@ -25,24 +25,22 @@ Context proposals:
 ## Decisions (please answer each checkbox)
 
 ### A) Name alignment (reduces chaos)
-- [ ] **Package name**: pick one canonical name for the core engine: `@effect-native/crsql-mesh` vs `@effect-native/crsql-mesh-core` (some docs currently use both).
+- [x] **Package name**: pick one canonical name for the core engine: `@effect-native/crsql-mesh`
 
 ### B) Smallest “first ship” package set (reduces burden)
 Pick the smallest set of NEW packages we implement first (no bikeshedding, just pick):
-- [ ] Option 1 (smallest): protocol + transport interface + core engine
-- [ ] Option 2 (practical web-first): Option 1 + browser runtime adapter
-- [ ] Option 3 (practical node-first): Option 1 + node runtime adapter
+- [x] Option 3 (practical node-first): Option 1 + node runtime adapter
 
 ### C) Runtime split decisions (reduces control-freak knobs)
-- [ ] Bun: separate `@effect-native/crsql-mesh-runtime-bun` package, or fold into `...-runtime-node`
-- [ ] Electron: separate `...-runtime-electron`, or explicitly defer
+- Bun: separate `@effect-native/crsql-mesh-runtime-bun` package? fold into `...-runtime-node` with @effect/package-{node,but,browser} as possible; add a -bun specific package only if necessary
+- No Electron. I don't like Electron. I refuse to support it
 
 ### D) `@effect-native/crsql` boundary (reduces future betrayals)
 Where do the “db primitives” stop and “sync orchestration” start?
-- [ ] Confirm the split: `@effect-native/crsql` owns typed change rows + pull/apply helpers; mesh package owns version vectors + anti-entropy loop.
+- Confirm the split: `@effect-native/crsql` owns typed change rows + pull/apply helpers; mesh package owns version vectors + anti-entropy loop.
 
 ### E) Approval gate
-- [ ] Approved to proceed to **Phase 2 (requirements.md)** for the chosen packages under `effect-native/.specs/AGENTS.md`.
+- Approved to proceed to **Phase 2 (requirements.md)** for the chosen packages under `effect-native/.specs/AGENTS.md`.
 
 ## Notes
 
@@ -55,3 +53,23 @@ Thing-golf bias:
 
 - Move this file to `.wishes/done/` and add a short “Decisions” summary.
 - Then we’ll generate Phase 2 `requirements.md` for exactly the packages you approved.
+
+
+---
+
+From Tom:
+
+- updated effect-native/.specs/crsqlite-global-mesh-packages/instructions.md with
+  - package names for new react-native packages
+
+- effect-native/.specs/crsql-mesh/instructions.md approved
+
+- TODO: Agent, update effect-native/.specs/crsql-mesh-protocol/instructions.md to reference the existing effect-native/packages-native/crsql/ that already includes a lot of stuff that makes serialization/de-serialization much simpler and cleaner. Pay particular attention to effect-native/packages-native/crsql/src/CrSqlSchema.ts and its effect-native/packages-native/crsql/test/
+
+Product decision: rely on SQLite's unhex() (available in sqlite >= 3.50.2).
+If unhex() is missing or disabled in the host, we fail fast with UnhexUnavailable rather than adding feature-detection fallbacks.
+NOTE: verifying unhex() presence as early as possible in layer creation so that it'll be easier to know when there's a configuration issue
+
+- TODO(Agent): add specs for react-native packages
+
+- @effect-native/crsql-mesh-runtime-node should rely on @effect/platform

.wishes/blocked-on-tom/scratchpad.md .wishes/scratchpad.md.wishes/blocked-on-tom/scratchpad.md renamed to .wishes/scratchpad.md

@@ -0,0 +1,7 @@
+our wasm build doesn't support loadable extensions
+so let's bake in a few extensions that I particularly like
+
+- our new zig-based cr-sqlite (naturally)
+- https://github.com/asg017/sqlite-vec
+- full text search
+- BJSON

.wishes/wasm-extras.md

@@ -0,0 +1,7 @@
+// Folder-specific settings
+//
+// For a full list of overridable settings, and general information on folder-specific settings,
+// see the documentation: https://zed.dev/docs/configuring-zed#settings-files
+{
+  "file_scan_exclusions": [".git","dist",".refs/bun/*/*",".refs/**/*.c"]
+}