- decisions/icons-via-nuxt-icon.md: local collection, mode svg, serverBundle collections empty, scanned client bundle; 3 icons, 1.23 kB - linked from the bundle index and the decisions index, logged
8.3 KiB
8.3 KiB
Update Log
2026-10-23 (icons from Nuxt Icon, icon webfont removed)
- Decision: Recorded Icons via Nuxt Icon - all icons come from
@nuxt/iconwith@iconify-json/material-symbolsinstalled locally,mode: 'svg',serverBundle: { collections: [] },clientBundle: { scan: true }. Deletedpublic/fonts/material-symbols-outlined-var.woff2(3.9 MiB), its@font-faceand the.material-symbols-outlinedclass inapp/assets/css/main.css. Build reports 3 icons, 1.23 kB; SSR HTML carries the inline<svg>. - Update: The module's defaults would have called
api.iconify.designat runtime (mode: css,fallbackToApi: true), which the local collection avoids;serverBundle: 'auto'would have bundled the whole set as an 8 MB server chunk.
2026-10-20 (cheaper review model, cached installs, merged checks)
- Update: pr-checker.yml - the review model is now
opencode-go/claude-haiku-5-5#medium: cheap per token and, unlikedeepseek-v4.1-flash, it has a real#mediumeffort level (flash exposes only low/high/max). ESLint and typecheck are merged into onechecksjob with a singlepnpm install, and the pnpm store plus the opencode binary are restored withactions/cache@v4.1.0(v1 cache API, so it also works on a v1-only runner). Cache keys are built fromsha256sum pnpm-lock.yaml, the pnpm store layout (v11) and the opencode version in shell steps, becausehashFiles()evaluates empty in this act runner. See AI review setup and PR pipeline layering.
2026-10-20 (first flash review validated, two findings applied)
- Update: PR #14 review (flash model,
VERDICT: APPROVE) was fact-checked finding by finding. Applied:<NuxtRouteAnnouncer />restored inapp.vue(this PR's diff had dropped it with the NuxtWelcome swap), and the review job now requiresgithub.event_name == 'pull_request'(manual dispatch - the new snyk trigger - would otherwise launch a paid review with no PR to post to). Rejected with evidence: the reviewer'spostcss-selector-parser6.1.5 override suggestion - the 6.1.5 backport exists on npm, but the blocking audit still flags it (<7.1.6covers 6.x), verified empirically; 7.1.6 stays. Deferred as design decisions: mobile nav, aria-current via NuxtLink, sprite-to-SVG, font fallback stacks,borderRadius.fulltoken, the fall-endpoint budget in the API contract.
2026-10-20 (snyk pause made actionlint-clean)
- Update: pr-checker.yml - the paused snyk job's
if: false(flagged by actionlint as a constant condition once this PR touched the workflow file) becameif: github.event_name == 'workflow_dispatch'plus aworkflow_dispatch:trigger. Same pause semantics (snyk paused) - pushes/PRs burn no credits; the job is now runnable manually instead of dead code.
2026-10-20 (review model switched to flash after endpoint outage)
- Update: open questions - the review-model question is decided:
opencode-go/deepseek-v4.1-flash#maxin pr-checker.yml. Thedeepseek-v4-pro#maxendpoint answered two consecutive runs withUpstream request failed: Endpoint is unavailable(runs 67 and 68 on PR #14, ~10 min apart, model still listed active) - the recorded default ("switch to flash") was applied.
2026-10-20 (blocking audit catches the tailwind dep, first override)
- Update: vulnerability audit policy - the first PR run after adding
@nuxtjs/tailwindcssfailed the blocking audit on GHSA-rj75-hqrm-r3gf (moderate:postcss-selector-parser< 7.1.6, quadratic flat-selector parsing, pulled in bytailwindcss3.4.19 →postcss-nested6.2.0). Fixed per policy with the firstoverridesentry inpnpm-workspace.yaml, pinning 7.1.6 (already in the tree viapostcss-nesting, build verified, audit green except the two reviewed highs). Same run: AI review job failed transiently (Upstream request failed: Endpoint is unavailableonopencode-go/deepseek-v4-pro#max; the model is still listed active, so retry on next push - the model-switch question stays open in open questions).
2026-10-20 (frontend API contract)
- Creation: Added backend endpoints - the smallest endpoint set the UI needs:
GET /api/health(footer dot,SYS_STABLE),GET /api/chapters(terminal rows; counters computed client-side), and the laterPOST /api/fall/{chapter}and SSEGET /api/events, with polling-first as the deliberately simple start.
2026-10-19 (pipeline improvement backlog)
- Creation: Added future updates - five candidate improvements from Anthropic's code-review post (build job, PR intent input, no-repeat re-review, PR template, reviewer eval set), with effort estimates, batching advice for the review budget, and the list of scale-dependent machinery deliberately not adopted.
2026-10-19 (stale anonymous volume aborts pnpm)
- Update: Dev container shape — the anonymous-volume remedy
docker compose up --build -Vmoved from "not verified" to evidence (build, volume renewal, server ready in 2.62s). New failure mode recorded: after the mounted manifests drift from the volume's snapshot, pnpm 11's pre-run check wants to purgenode_modulesand aborts without a TTY (ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY). Fix:CI: "true"in the compose service.
2026-10-18 (evening — release PR unblocked)
- Decision: Recorded the production image shape - multi-stage, digest-pinned
node:26-slim, non-root, healthchecked runnable Node server. Built and served locally: HTTP 200, uid 1000, healthcheck healthy. This decides the question that had keptDockerfileempty (and failing the droast job withDF071). - Decision: Recorded the vulnerability audit policy - blocking audit with two reviewed ignores (
node-forge,braces: no patched release exists; both build-time-only paths under nitropack). Learned en route: pnpm 11 ignores thepnpmfield inpackage.json- settings live inpnpm-workspace.yaml. - Update: Added both decisions to the decisions index.
2026-10-18 (later — CI/CD and releases)
- Creation: Recorded the PR pipeline layering — three layers (pre-commit, Gitea Actions, AI review), the cost rule that assigns checks to layers, and the failure modes the pipeline was designed against.
- Creation: Recorded the AI review setup: the
opencode-goprovider prefix (the wrong one failed every run with "Insufficient account funds"), the v2 installer (v1 cannot resolve model variants), env-only auth after the prompt-injection finding, the read-only permission set, and the verdict line as the posting gate. - Creation: Recorded release engineering: release-please in manifest mode, plain
v-tags, theversionfield requirement, and why conventional commits are enforced at commit time. - Creation: Recorded Snyk paused and secrets policy: quota-paused job kept in the workflow, and the
write:issuescope requirement for all workflow tokens (learned from a 403 that named its missing scope). - Update: Rewrote index to group Docker-era and CI-era decisions and added a one-paragraph history.
2026-10-18
- Creation: Established the Nuxt bundle index and the decisions index.
- Decision: Recorded the dev container shape — source bind-mounted, dependencies in the image, run as the image's
nodeuser. - Decision: Recorded build layer order and the build context filter, including the measured failure when a
COPYtarget is excluded. - Decision: Recorded the repository and compose layout and the mockup layout.
- Creation: Added open questions, including the shape of the production image.