Initial hypothesis ("pnpm@latest pulled a newer 11.4+ with new Node
floor") was wrong. Investigation after the second VPS crash showed
the whole pnpm 11.0+ line imports node:sqlite from its store-index
module. Local dev was misleading because pnpm install never re-ran
on the Node 20 host (lockfile already resolved, child scripts don't
load the store module).
Updates:
- BLK-005: replace single-fix line with iteration log
(@latest → @11.1.3 → @10.13.1, last one resolved).
- LRN-022: rewrite headline + body to reflect pnpm 11 ↔ Node 22.13
coupling, not just pnpm 11.4. Add pnpm/Node compat matrix.
- journal 2026-05-21: append v2 fix entry referencing commit 990c8e7.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
52 lines
2.7 KiB
Markdown
52 lines
2.7 KiB
Markdown
# 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:
|
|
1. `corepack prepare pnpm@latest` → fails (resolves to current pnpm 11.x).
|
|
2. `corepack prepare pnpm@11.1.3` → still fails (entire pnpm 11.x line needs Node 22.13).
|
|
3. `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 to `pnpm@10.13.1`.
|
|
Status: resolved (commit 990c8e7).
|