PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 36s
PR Check / Typecheck (pull_request) Successful in 44s
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 5m12s
39 lines
5.8 KiB
Markdown
39 lines
5.8 KiB
Markdown
# Update Log
|
|
|
|
## 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) became `if: github.event_name == 'workflow_dispatch'` plus a `workflow_dispatch:` trigger. Same pause semantics ([snyk paused](decisions/snyk-paused-and-secrets-policy.md)) - 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](open-questions.md) - the review-model question is decided: `opencode-go/deepseek-v4.1-flash#max` in [pr-checker.yml](../.gitea/workflows/pr-checker.yml). The `deepseek-v4-pro#max` endpoint answered two consecutive runs with `Upstream 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](decisions/vulnerability-audit-policy.md) - the first PR run after adding `@nuxtjs/tailwindcss` failed the blocking audit on GHSA-rj75-hqrm-r3gf (moderate: `postcss-selector-parser` < 7.1.6, quadratic flat-selector parsing, pulled in by `tailwindcss` 3.4.19 → `postcss-nested` 6.2.0). Fixed per policy with the first `overrides` entry in `pnpm-workspace.yaml`, pinning 7.1.6 (already in the tree via `postcss-nesting`, build verified, audit green except the two reviewed highs). Same run: AI review job failed transiently (`Upstream request failed: Endpoint is unavailable` on `opencode-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](open-questions.md)).
|
|
|
|
## 2026-10-20 (frontend API contract)
|
|
* **Creation**: Added [backend endpoints](backend-endpoints.md) - 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 later `POST /api/fall/{chapter}` and SSE `GET /api/events`, with polling-first as the deliberately simple start.
|
|
|
|
## 2026-10-19 (pipeline improvement backlog)
|
|
* **Creation**: Added [future updates](future-updates.md) - 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](decisions/dev-container-shape.md) — the anonymous-volume remedy `docker compose up --build -V` moved 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 purge `node_modules` and 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](decisions/production-image.md) - 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 kept `Dockerfile` empty (and failing the droast job with `DF071`).
|
|
* **Decision**: Recorded the [vulnerability audit policy](decisions/vulnerability-audit-policy.md) - 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 the `pnpm` field in `package.json` - settings live in `pnpm-workspace.yaml`.
|
|
* **Update**: Added both decisions to the [decisions index](decisions/index.md).
|
|
|
|
## 2026-10-18 (later — CI/CD and releases)
|
|
* **Creation**: Recorded the [PR pipeline layering](decisions/pr-pipeline-layering.md) — 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](decisions/ai-review-setup.md): the `opencode-go` provider 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](decisions/release-engineering.md): release-please in manifest mode, plain `v`-tags, the `version` field requirement, and why conventional commits are enforced at commit time.
|
|
* **Creation**: Recorded [Snyk paused and secrets policy](decisions/snyk-paused-and-secrets-policy.md): quota-paused job kept in the workflow, and the `write:issue` scope requirement for all workflow tokens (learned from a 403 that named its missing scope).
|
|
* **Update**: Rewrote [index](/index.md) to group Docker-era and CI-era decisions and added a one-paragraph history.
|
|
|
|
## 2026-10-18
|
|
* **Creation**: Established the Nuxt bundle [index](/index.md) and the [decisions](/decisions/index.md) index.
|
|
* **Decision**: Recorded the [dev container shape](/decisions/dev-container-shape.md) — source bind-mounted, dependencies in the image, run as the image's `node` user.
|
|
* **Decision**: Recorded [build layer order](/decisions/build-layer-order.md) and the [build context filter](/decisions/build-context-filter.md), including the measured failure when a `COPY` target is excluded.
|
|
* **Decision**: Recorded the [repository and compose layout](/decisions/repo-and-compose-layout.md) and the [mockup layout](/decisions/mockup-layout.md).
|
|
* **Creation**: Added [open questions](/open-questions.md), including the shape of the production image.
|