3.4 KiB
Blockers Registry
Format: BLK-XXX | Date | Friction | Root cause | Solution | Status
BLK-001 | 2026-05-18 | pnpm not on PATH
pnpm command not found on shell start. Root: corepack shim broken on Node 20.20.0 (ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING). Fix: curl https://get.pnpm.io/install.sh → ~/.local/share/pnpm/bin/pnpm. Status: resolved.
BLK-002 | 2026-05-18 | Pathology DB empty — pending content review
40-60 equine entries needed; source-cited from Merck Vet Manual, IMAIOS, PubMed, EVJ, WikiVet, LCAO. Client osteo will review post-scaffold. Status: resolved 2026-05-21 — superseded by hierarchical v2.0 catalog, 26 zones / 792 nodes / 612 leaves / 41 vet-referral leaves authored by domain expert. Counts blow past original 40-60 target. Source citations not yet attached on every leaf (sources optional in schema) — content review still a client task but DB no longer empty.
BLK-003 | 2026-05-19 | Detail-popup zone clicks silently dropped
Friction: clicks on head detail SVG zones did nothing.
Root: EditorRoute.onZoneClick looked up id in main-SVG bones map only → detail ids (point-*) undefined → early return.
Fix: parse detail SVG on detail open, store detailBones, fallback lookup bones.get(id) ?? detailBones.get(id).
Status: resolved.
BLK-004 | 2026-05-19 | PDF text loop assumed one line per array entry
Friction: long zone string collided with following lines (pathologies, sévérité, commentaire).
Root: pdf-lib maxWidth wraps glyph drawing but caller advanced cursor by i * 14 based on block index — wrapped lines invisible to layout.
Fix: explicit wrapLines + per-line cursor advance + per-block gap.
Status: resolved.
BLK-005 | 2026-05-21 | Docker build crash — ERR_UNKNOWN_BUILTIN_MODULE node:sqlite
Friction: VPS docker compose up --build -d crashed on pnpm install (fresh cold build).
Root: node:20-alpine (Node 20.20.2) cannot load pnpm 11.x — pnpm 11 itself imports node:sqlite from ../store/index/lib/index.js, and node:sqlite is a Node 22.13+ built-in. Crash: ERR_UNKNOWN_BUILTIN_MODULE: node:sqlite. Local dev was deceptive — host runs Node 20 too, but pnpm install never ran on host (lockfile already resolved); pnpm run typecheck / pnpm run test only spawn child scripts and never load the store-index module.
Iterations:
corepack prepare pnpm@latest→ fails (resolves to current pnpm 11.x).corepack prepare pnpm@11.1.3→ still fails (entire pnpm 11.x line needs Node 22.13).corepack prepare pnpm@10.13.1→ works. Last major before the node:sqlite cache backend; reads lockfile v9 unchanged; already cached on dev host. Fix: Dockerfile:7 pinned topnpm@10.13.1. Status: resolved (commit990c8e7).
BLK-006 | 2026-10-08 | Docker socket permission denied → no local Supabase stack for Claude
Friction: supabase start → "permission denied … /var/run/docker.sock"; daemon up (docker info client OK), user not in docker group. No psql/postgres on host either.
Root: host group membership; needs sudo usermod -aG docker $USER + re-login (user runs, not Claude).
Workaround: PGlite harness (BDR-028) executes migrations + 81 pgTAP checks; CLI config parses (supabase start fails only at Docker inspect).
Status: open — real-stack run (pnpm db:start && pnpm db:test && pnpm db:types:check, manual curl script SUPABASE.md §8) pending user Docker access or CI runner.