Files
CV_Site_Nuxt/OKF_Nuxt/open-questions.md
T
Noel Sabia fa8fafb7ef
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m42s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Successful in 45s
ci: use cheaper review model and cache pipeline installs
- review model: opencode-go/claude-haiku-5-5#medium instead of
  deepseek-v4.1-flash#max; flash has no medium variant
- merge lint and typecheck into one job with a single pnpm install
- cache the pnpm store and opencode binary via actions/cache@v4.1.0,
  keyed on a sha256 of the lockfile (hashFiles is empty on this runner)
- update the decision records and log
2026-10-20 20:56:52 +02:00

3.6 KiB

type, title, description, tags, status, generated
type title description tags status generated
Open Questions Open questions Decisions still to make for the Nuxt site, with what needs each answer.
decision
open
draft
by at
opencode-go/glm-5.3-flash 2026-10-18T12:41:52Z
Question Needed by Default if nobody decides
Shape of the production image - decided: runnable Node server, see production image done —
How the compose service mounts the source: the whole repository plus a volume for node_modules, or only the directories that get edited finishing Local_Development/docker-compose.yml None. The compose file is not yet valid.
Which pnpm version the production image pins writing the production image decided: 11.26.0, same as dev (production image) done
How the gateway serves the site now that the production image is an SSR Node server (proxy to the server, instead of embedding static files) updating the sibling OKF_CV_Website decision static-nuxt-in-gateway Proxy to the server.
Whether these decisions stay in this bundle or fold into the sibling OKF_CV_Website bundle, which already describes the frontend at design level after the production image exists None.
When and how often Snyk runs once re-enabled: weekly schedule, ready-for-review gate, or per-push re-enabling the snyk job Stay disabled.
Whether the AI review job should gate merges (required status check on the verdict) or stay advisory branch protection setup Advisory. The review comment is information; blocking merges on an AI verdict is a policy choice, not a technical one.
How the opencode CLI version in CI gets upgraded: manually bump the pinned 2.0.32, or automate when a new major appears first review failure after an opencode release Manual bump. Pinning exists so upgrades are decisions.
Whether the Go plan's per-model usage windows survive real review frequency, and which model the review should use - decided (2026-10-20): review model is opencode-go/claude-haiku-5-5#medium in pr-checker.yml. Cheap per token, and it has a real #medium effort level; deepseek-v4.1-flash only exposes low/high/max, so it always paid for maximum reasoning. The earlier pro -> flash switch (two consecutive Endpoint is unavailable failures) is in the log done —
Removing the two reviewed audit ignores when node-forge or braces ship patched releases next dependency update round Watch for new releases.

The mount trade-off, in detail

Measured on the whole-repository mount:

  • An anonymous volume is created once. After a dependency change the stale contents persist unless the volume is renewed, and the renewal command has not been tested.
  • Docker creates an empty, root-owned node_modules directory in the repository on the first run, unless that directory already exists.

The alternative — mounting only the directories that get edited — removes the volume, the renewal step and the root-owned directory entirely, and keeps .nuxt inside the container rather than in the working tree. It costs one compose line per top-level directory, so a new directory silently fails to appear in the container until the compose file is updated.

Related

The Nuxt frontend is described at design level in OKF_CV_Website, in architecture/frontend.md and decisions/static-nuxt-in-gateway.md. Those documents state that the site is generated to static files and embedded in the gateway image, which is an input to the production-image question above.