PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m5s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Successful in 8s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Successful in 48s
Applied the findings that held up against the code: - strict vMAJOR.MINOR.PATCH guard; v[0-9]* accepted v1, v1-foo and prereleases, all valid registry tags - latest now follows the newest release, so replaying an older tag cannot drag it backwards; skipped with a warning if the tag list is unavailable - smoke test starts the built image and requires 2xx on / before pushing - timeout-minutes: 20 on the job, so a hung build cannot hold the capacity-1 runner indefinitely - the decision doc records the socket's blast radius: root-equivalent, runner-wide, only on a label PR jobs cannot use Rejected with evidence: the .dockerignore leak (.env*, *.pem, .git are excluded) and the Docker client/daemon API mismatch (20.10.24 client against a 29.9.2 daemon builds over the socket).
12 KiB
12 KiB
Update Log
2026-10-24 (release publishes an image)
- Creation: publish-image.yml - a
vX.Y.Ztag push buildsDockerfileon the arm64 runner and pushesregistry.noelsabia.dev/cv_website/nuxtas the version andsha-<12>, pluslatestwhen that tag is the newest release. Main pushes deliberately do not build: the registry holds releases, not commits. The job uses the runner's own Docker daemon (client only in thenode:22-bookwormcontainer), so the act_runner needscontainer.docker_host: automount; the first step fails with that cause if it is missing. That socket is root-equivalent, so it may only sit on a label PR jobs cannot use - recorded under the trust boundary in Publishing images to the own registry. Repo secrets:REGISTRY_USERNAME,REGISTRY_PASSWORD. - Review follow-up (PR #19, 1 BLOCKER + 4 WARN + 2 NIT): applied the strict
vMAJOR.MINOR.PATCHcheck, the newest-release rule forlatest, a smoke test that starts the image and requires 2xx on/, andtimeout-minutes: 20. Rejected with evidence: the.dockerignoreleak (.env*,*.pem,.gitare excluded) and the Docker-client/daemon API mismatch (20.10.24 client against a 29.9.2 daemon built successfully over the socket).
2026-10-23 (PR #16 review checked, three findings applied)
- Update: pr-checker.yml - the review prompt now states that
pnpm-lock.yamlis excluded from.pr-review-diff.patchon purpose. The reviewer read the exclusion as an uncommitted lockfile and raised a false BLOCKER; the lockfile is in the PR and matchespackage.json. - Fix:
scripts/generate-favicon.mjs-BACKGROUND = nullnow writes alpha 0 instead of opaque black, matching the transparency the comment promises. The committed icons are unchanged (regenerated byte-identical). - Update: deleted
public/_robots.txt- unreferenced leftover from the rename;@nuxtjs/seowritesrobots.txtitself.
2026-10-23 (Nuxt SEO configured, static OG card)
- Decision: Recorded SEO stack and site metadata -
@nuxtjs/seo6.0.1 registered;siteandschemaOrg.identity(Person) readsite.config.mjs; canonical, sitemap, robots and social tags need no per-page setup.ogImage: falseandskewProtection: falsebecause the card is a committed PNG and the site deploys as static files. - Update:
public/og-image.png(1200x630) andog-image.alt.txtgenerated from the pixel avatar and the site metadata bypnpm og-image(scripts/generate-og-image.mjs; needswoff2_decompress+rsvg-convert, output committed). SEO Utils emitsog:image,twitter:imageand their dimensions/alt automatically. - Detail:
app/pages/index.vuesets the title toNoel Sabia — <role>andtwitter:card: summary_large_image;useHead({ titleTemplate: '%s' })removes the| Noel Sabiasuffix SEO Utils would add.theme-coloris#031428. - Detail:
engines.nodeis^22.22.3 || ^24.15.0 || >=26.0.0, the floor@nuxtjs/seo6 enforces. Verifiednuxt buildandnuxt generate: canonical ishttps://noelsabia.dev/, sitemap has one URL, robots allows crawling and names the sitemap, schema graph carries the Person node, and all SEO assets return 200.
2026-10-23 (generated pixel favicon)
- Update:
public/favicon.svgandpublic/favicon.icoare generated from the header's pixel avatar bypnpm favicon(scripts/generate-favicon.mjs). No image library: the ICO is an uncompressed 32bpp BMP in a one-image ICO container (4.2 kB) and the SVG merges same-coloured cells into per-row runs (3.7 kB); a 256px render of both matches. - Update:
app/utils/avatar.jsnow holds the palette and the 32x32 sprite as the single source, imported byAppLogo.vueand by the generator (plain JS, so Node can import it without a loader).app.head.linkdeclares the SVG first and the ICO as the32x32fallback. - Detail: the icon keeps the header chip colour
#1b2b3fas its background so the portrait stays readable on a dark tab bar;BACKGROUND = nullin the generator makes it transparent.
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.