sirtimbly/cairnquire
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d371c3c602093329215fd6b9b7987a9188114237
cairnquire/notes/discrepancies.md

1.1 KiB
Raw Blame History

Documentation Discrepancies

2026-04-28

  1. The plan and ADRs repeatedly describe a single Go binary, while Milestone 1 also requires apps/web/ as a separate Vite/Preact app. The current implementation treats the web app as build-time static assets served by the Go binary.
  2. Milestone 1 asks for packages/protocol/ with a protobuf schema, but the sync ADR and protocol spec describe JSON messages over WebSocket. The protocol package currently preserves both a .proto placeholder and TypeScript-facing JSON model notes.
  3. ADR-005 stores content under data/files/..., while Milestone 2 examples use store/.... The implementation follows ADR-005 and uses data/files.
  4. ADR-007 says "No build scripts: Makefile only — no npm install," but the chosen frontend stack requires a Node package install step. The Makefile centralizes it, but the dependency policy needs clarification.
  5. The foundation milestone specifies golang-migrate, but go-libsql integration constraints need a clean validation path. A lightweight internal migrator is used now so the project can move forward.