From 202110ddd2df0670c7ed87d0a9f2302380ff9540 Mon Sep 17 00:00:00 2001 From: Bastien Chanot Date: Thu, 21 May 2026 06:07:28 +0200 Subject: [PATCH] =?UTF-8?q?chore(memory):=20capitalize=20zoosteo=20rename?= =?UTF-8?q?=20+=20Docker=20pnpm=20pin=20=E2=80=94=20BLK-005,=20LRN-022,=20?= =?UTF-8?q?journal?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - BLK-005: VPS Docker build crash on pnpm@latest pulling pnpm >=11.4 needing Node 22.13 (node:sqlite import) against node:20-alpine image. Resolved by pinning pnpm@11.1.3. - LRN-022: never use floating pnpm@latest (or any unpinned upstream tag) in Dockerfiles — pnpm minor bumps can silently raise Node floor. Fix paths: pin exact + mirror in packageManager field; audit CI too. - journal 2026-05-21: two lines for the rename commit and the Docker pin commit. Co-Authored-By: Claude Opus 4.7 (1M context) --- .claude/memory/blockers.md | 9 +++++++++ .claude/memory/journal.md | 2 ++ .claude/memory/learnings.md | 12 ++++++++++++ 3 files changed, 23 insertions(+) diff --git a/.claude/memory/blockers.md b/.claude/memory/blockers.md index 401f5cc8..51a6f1d9 100644 --- a/.claude/memory/blockers.md +++ b/.claude/memory/blockers.md @@ -36,3 +36,12 @@ Friction: long zone string collided with following lines (pathologies, sévérit 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: Dockerfile:7 `corepack prepare pnpm@latest --activate` re-resolved to pnpm >=11.4. pnpm >=11.4 imports `node:sqlite` (Node 22.13+ only). Image `node:20-alpine` (Node 20.20.2) → `ERR_UNKNOWN_BUILTIN_MODULE: node:sqlite` at install start. Local dev unaffected — corepack cached older pnpm 11.1.3. +Fix: pin `pnpm@11.1.3` in Dockerfile:7 (matches host, lockfile v9 stays valid). +Status: resolved (commit 7dccde7). diff --git a/.claude/memory/journal.md b/.claude/memory/journal.md index 9615b3d5..cda7c4e9 100644 --- a/.claude/memory/journal.md +++ b/.claude/memory/journal.md @@ -75,6 +75,8 @@ User dropped catalog v1.2→v2.0 in place. pathologies.json now schema_version " - TODO Phase C item 1 "Author full horse.json" → done. B4 still has scope_disclaimer footer decision open. - NEXT: B4 disclaimer footer call + C QA + Scaleway deploy. - hotfix(pdf): PDF export crashed `WinAnsi cannot encode "⚠"` on any obs carrying a requires_vet_referral leaf — StandardFonts.Helvetica is WinAnsi-only. Swapped `⚠ ` PDF marker → `(!) ` (UI keeps ⚠). Regression test added on `widthOfTextAtSize` + prefixed label. LRN-021, EVAL-003 captured. 155/155 green. Follow-up: migrate PDF body to embedded TTF (Inter/Fraunces per CLAUDE.md spec) so future non-Latin-1 glyphs work. +- chore: rename project `osteo-report` → `zoosteo` (Gitea repo moved). 15 files: repo URLs (CHANGELOG, DEPLOY, package.json), brand strings (env.ts DEFAULTS, entrypoint.sh fallbacks, i18n fr/en, pdf attachment metadata, index.html title, Brand test, scaffold banner, README/CLAUDE/CHANGELOG/ADDING-A-SPECIES headings), example URL osteo.example.com → zoosteo.fr in DEPLOY.md. PDF FILENAME `osteo-report.json` + startsWith contract preserved. 155/155 tests green. Commit 7dd4f63 + push. +- fix(docker): pin `pnpm@11.1.3` in Dockerfile:7. `corepack prepare pnpm@latest` re-resolved to pnpm >=11.4 on VPS cold build, which needs Node 22.13 → `ERR_UNKNOWN_BUILTIN_MODULE: node:sqlite` on Node 20 image. Commit 7dccde7 + push. BLK-005 + LRN-022 captured. --- diff --git a/.claude/memory/learnings.md b/.claude/memory/learnings.md index 311786a2..ff6fdf34 100644 --- a/.claude/memory/learnings.md +++ b/.claude/memory/learnings.md @@ -171,3 +171,15 @@ Fix paths: Catalog JSON went v1.2→v2.0 (semantic breaking change per author doc), but `findings.ts` Zod schema declared `requires_vet_referral` boolean + `description_fr` optional from B0 day-one. Result: v2.0 file dropped in, parses clean, 154/154 tests stay green, no schema edit, no consumer rewrite. Picker + PDF already keyed on boolean (no textual `description_fr.includes('vétérinaire')` fallback ever existed in our code), so the v2.0 "removed redundant text" change is a no-op at consumption site. Lesson: when authoring a Zod schema for external content, mark anything that "might or might not" appear as `.optional()` + make booleans authoritative early. The schema then forms a stable contract that absorbs author-side simplifications without code churn. Apply: any data contract sourced from non-engineering authors (clinical, legal, marketing). Decouple presence-of-field from semantic-of-field; let the boolean drive logic, let text be display-only ornamentation. + +--- + +## LRN-022 | 2026-05-21 | Never floating `pnpm@latest` (or any unpinned tag) in Dockerfile — silent Node-version drift + +`corepack prepare pnpm@latest --activate` re-resolves at every cold build. pnpm minor bumps can raise required Node floor without warning: pnpm 11.4 added `node:sqlite` import → Node 22.13+ required. Image stayed on `node:20-alpine` → `ERR_UNKNOWN_BUILTIN_MODULE: node:sqlite` at install start. Works on dev host because corepack caches older pnpm (11.1.3); breaks on fresh VPS cold build that re-resolves `@latest`. Same trap for any unpinned upstream ref: `node:lts`, `:alpine`, `nginx:alpine`, GitHub Actions `uses: foo@v1` (prefer SHA). +Fix paths: +- Pin exact in Dockerfile: `corepack prepare pnpm@ --activate`. +- Mirror in `package.json`: `"packageManager": "pnpm@X.Y.Z"` — host + Docker stay synced via corepack. +- Bump base image deliberately when pnpm major bump is intentional, never as side effect of `@latest`. +**Why:** Floating tag = drift bomb between cached dev + fresh prod resolve. CI passes today, prod breaks tomorrow on same Dockerfile, no commit changed. +**How to apply:** Audit every Dockerfile + docker-compose + CI `uses:` for floating refs before first prod deploy. Lockfile pins app deps; Dockerfile + workflow files must pin toolchain.