cairnquire/notes/problems.md

Implementation Problems Log

2026-04-28

• go-libsql is the active official Go binding, but it requires CGO and precompiled native libraries. That weakens the "same source -> same binary hash" goal until the exact build environment is locked down.
• The embedded-replica connector in go-libsql rejects an empty primary URL. The foundation therefore uses the local file: libsql driver path when no primary is configured, and reserves embedded-replica setup for later sync work.
• Docker verification is currently blocked by the local environment because the daemon socket at /Users/tim/.orbstack/run/docker.sock was not reachable during docker build.