Compare commits
15
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
71b73aacc8 | ||
|
|
9be62982a4 | ||
|
|
9b0f89ef38 | ||
|
|
db11806c03 | ||
|
|
9995fc75ed | ||
|
|
cd22fa01f7 | ||
|
|
15cf091ddf | ||
|
|
48a403e5ae | ||
|
|
7b5c97c84e | ||
|
|
7ea2fb7e17 | ||
|
|
b640bd2344 | ||
|
|
8d53daa4a6 | ||
|
|
dcb178a71a | ||
|
|
8402bb8c48 | ||
|
|
6c74e966db |
No files matched your search
@@ -3,6 +3,8 @@ name: PR Check
|
||||
on:
|
||||
pull_request:
|
||||
types: [opened, synchronize, reopened]
|
||||
# manual trigger: the only way the paused snyk job below can run
|
||||
workflow_dispatch:
|
||||
|
||||
concurrency:
|
||||
group: pr-check-${{ github.event.pull_request.number }}
|
||||
@@ -174,15 +176,17 @@ jobs:
|
||||
-print0 | xargs -0 -r droast --no-roast --min-severity warning
|
||||
|
||||
# ------------------------------------------------------- snyk security ----
|
||||
# DISABLED: Snyk free plan only includes ~100 test credits/month, which the
|
||||
# PAUSED: Snyk free plan only includes ~100 test credits/month, which the
|
||||
# pipeline would burn through quickly (2 tests per PR push).
|
||||
# To re-enable, delete the "if: false" line below. Consider also running
|
||||
# Paused the actionlint-clean way: the job only runs on manual
|
||||
# (workflow_dispatch) triggers, so pushes and PRs never burn credits.
|
||||
# To re-enable fully, delete the if: line below. Consider also running
|
||||
# this job only on PRs marked "ready for review" or on a weekly schedule
|
||||
# instead of on every push.
|
||||
snyk:
|
||||
name: Security scan (Snyk)
|
||||
runs-on: ubuntu-latest
|
||||
if: false
|
||||
if: github.event_name == 'workflow_dispatch'
|
||||
# snyk/snyk:node is amd64-only ("no matching manifest for linux/arm64"),
|
||||
# so install the CLI via npm in the multi-arch node image instead
|
||||
container: node:22-bookworm
|
||||
@@ -220,8 +224,11 @@ jobs:
|
||||
name: AI code review (opencode)
|
||||
runs-on: ubuntu-latest
|
||||
container: node:22-bookworm
|
||||
# Draft PRs don't get a (paid) review yet
|
||||
if: ${{ !github.event.pull_request.draft }}
|
||||
# Draft PRs don't get a (paid) review yet. The event_name check is
|
||||
# load-bearing: manual (workflow_dispatch) triggers - which exist to
|
||||
# run the paused snyk job - must NOT launch a paid review, which on
|
||||
# a dispatch event has no PR to post to.
|
||||
if: ${{ github.event_name == 'pull_request' && !github.event.pull_request.draft }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
with:
|
||||
@@ -251,11 +258,15 @@ jobs:
|
||||
env:
|
||||
OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
|
||||
run: |
|
||||
# opencode-go/deepseek-v4-pro#max: flagship reasoning model at
|
||||
# maximum thinking budget - included in the opencode-go $10 plan
|
||||
# (variants: high, max). NOTE the provider prefix must be
|
||||
# "opencode-go", NOT "opencode" (Zen is a different, pay-per-call
|
||||
# provider and fails with 'Insufficient account funds').
|
||||
# opencode-go/deepseek-v4.1-flash#max: switched from
|
||||
# deepseek-v4-pro#max on 2026-10-20 after two consecutive runs
|
||||
# failed with "Upstream request failed: Endpoint is unavailable"
|
||||
# (~10 min apart; the model is still listed active, the endpoint
|
||||
# just does not serve). This is the default recorded in
|
||||
# OKF_Nuxt/open-questions.md for exactly this case. NOTE the
|
||||
# provider prefix must be "opencode-go", NOT "opencode" (Zen is a
|
||||
# different, pay-per-call provider and fails with 'Insufficient
|
||||
# account funds').
|
||||
#
|
||||
# Auth is env-only: the CLI picks up OPENCODE_API_KEY from the
|
||||
# environment (verified headless). Deliberately NO opencode.json:
|
||||
@@ -289,7 +300,7 @@ jobs:
|
||||
EXIT_CODE=0
|
||||
opencode run \
|
||||
--print-logs \
|
||||
--model opencode-go/deepseek-v4-pro#max \
|
||||
--model opencode-go/deepseek-v4.1-flash#max \
|
||||
"You are a principal engineer performing a rigorous code review on a
|
||||
pull request. You have tool access: read repo files for context when
|
||||
the diff alone is ambiguous, but review ONLY code changed in this PR.
|
||||
|
||||
@@ -9,6 +9,10 @@ dist
|
||||
# Node dependencies
|
||||
node_modules
|
||||
|
||||
# pnpm store — created inside the repo when the container-side install
|
||||
# finds its node_modules on a different filesystem (the anonymous volume)
|
||||
.pnpm-store
|
||||
|
||||
# Logs
|
||||
logs
|
||||
*.log
|
||||
@@ -22,3 +26,6 @@ logs
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
|
||||
# self added
|
||||
.pnpm-store
|
||||
@@ -32,6 +32,9 @@ repos:
|
||||
- id: check-merge-conflict
|
||||
- id: check-added-large-files
|
||||
args: [--maxkb=1024]
|
||||
# Self-hosted variable fonts are multi-MB by design (page-weight is
|
||||
# a serving-layer concern, not a repo concern).
|
||||
exclude: \.woff2$
|
||||
- id: detect-private-key
|
||||
|
||||
# ------------------------------------------------ conventional commits ---
|
||||
|
||||
@@ -0,0 +1,89 @@
|
||||
---
|
||||
type: API Contract
|
||||
title: Backend endpoints the frontend needs
|
||||
description: The smallest set of endpoints the Nuxt site needs from the Go gateway, so the backend can be built from this list.
|
||||
tags: [api, backend, gateway, contract, frontend]
|
||||
status: proposal
|
||||
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-20T00:00:00Z }
|
||||
verified: { by: human:noel, at: not yet }
|
||||
sources:
|
||||
- id: ui-homepage
|
||||
resource: ../../Local_Development/design/homepage/code.html
|
||||
title: Homepage mockup (data the UI visibly shows)
|
||||
- id: gateway-design
|
||||
resource: ../../OKF_CV_Website/architecture/gateway.md
|
||||
title: Gateway architecture (sibling bundle, design level)
|
||||
---
|
||||
|
||||
# Decision
|
||||
|
||||
Nothing decided yet. This is the frontend's wish list: what the UI shows
|
||||
today and later, and the endpoint each dynamic piece needs. Keep it stupid
|
||||
simple: one endpoint per job, plain JSON, no endpoint for data the browser
|
||||
can compute itself.
|
||||
|
||||
# Endpoints
|
||||
|
||||
## 1. `GET /api/health` — footer status dot and `SYS_STABLE`
|
||||
|
||||
The footer shows a green dot and the text `SYS_STABLE`. The frontend needs
|
||||
one boolean-ish answer: is the system up right now.
|
||||
|
||||
```json
|
||||
{ "status": "stable" }
|
||||
```
|
||||
|
||||
* `status: "stable"` → dot green, text `SYS_STABLE`
|
||||
* anything else or non-200 → dot grey, text `SYS_DEGRADED`
|
||||
* The gateway computes this from the cluster (are the chapter pods running).
|
||||
* The frontend polls this (mockup says `watch --interval=5s`; 5-10 s is fine).
|
||||
|
||||
## 2. `GET /api/chapters` — terminal rows and their footer counters
|
||||
|
||||
The terminal lists one row per life chapter:
|
||||
`chapter=… status=… uptime=…% self_healed=…x`.
|
||||
|
||||
```json
|
||||
[
|
||||
{ "name": "prezero", "status": "active", "uptime": 99.98, "selfHealed": 14 },
|
||||
{ "name": "dreambit", "status": "active", "uptime": 99.95, "selfHealed": 8 },
|
||||
{ "name": "ongoing-studies", "status": "active", "uptime": 99.91, "selfHealed": 5 },
|
||||
{ "name": "42-school", "status": "finished", "uptime": 100.0, "graduated": 2023 },
|
||||
{ "name": "apprenticeship", "status": "finished", "uptime": 100.0, "certified": 2021 }
|
||||
]
|
||||
```
|
||||
|
||||
* One chapter = one row. `status` is `active` or `finished`.
|
||||
* Active chapters map to real workloads; finished ones are history entries.
|
||||
* "3 Systems Active", "2 Sealed Archetypes", "Cumulative Rebounds: 27"
|
||||
are **not** endpoints: count `status === "active"`, count the finished
|
||||
ones, sum `selfHealed` in the frontend.
|
||||
|
||||
## 3. `POST /api/fall/{chapter}` — the knockdown button (later route)
|
||||
|
||||
The core feature on the life-map page: a visitor presses "push", the
|
||||
chapter pod dies and recovers.
|
||||
|
||||
* Request: chapter name in the path, checked against an allowlist.
|
||||
* Response: `202` when the fall was triggered; recovery time arrives via
|
||||
the events channel below, not in this response.
|
||||
* Unauthenticated by design, but rate-limited and restricted to the
|
||||
gateway by NetworkPolicy (sibling bundle, trust boundaries).
|
||||
|
||||
## 4. `GET /api/events` — live stream (later route, when it hurts)
|
||||
|
||||
Dev View and live recovery times on the life map need push updates
|
||||
(SSE, per the sibling-bundle design). **Deliberately not in the first
|
||||
version:** polling `/api/health` and `/api/chapters` every few seconds is
|
||||
enough for the homepage; add SSE when the dev view is actually built.
|
||||
|
||||
# Not endpoints
|
||||
|
||||
* Hero content (name, quote, contact bar, CV button) — static frontend
|
||||
content. The copy buttons read from local clipboard, no server call.
|
||||
* Aggregated counters (see above) — computed in the browser.
|
||||
|
||||
# Related
|
||||
|
||||
* Design-level gateway behavior: `OKF_CV_Website/architecture/gateway.md`
|
||||
* Trust boundaries and the allowlist: `OKF_CV_Website/architecture/system.md`
|
||||
@@ -55,7 +55,8 @@ CMD ["pnpm", "run", "dev", "--", "--host", "0.0.0.0"]
|
||||
| Base image | `node:26-slim`, pinned by digest | The digest makes the build reproducible; the checked digest resolves to Node v26.12.0. |
|
||||
| pnpm | Installed explicitly, pinned to 11.26.0 | Neither `corepack` nor `pnpm` is present in the image. The pin matches the host version, so the same lockfile format is used on both sides. |
|
||||
| User | The image's `node` user, uid 1000 | The host uid is also 1000. Files the dev server writes into the mounted repo stay owned by Noel instead of becoming root-owned. This is not a security measure. |
|
||||
| `node_modules` | Anonymous volume at `/app/node_modules` | The bind mount replaces all of `/app`, which would otherwise hide the dependencies installed in the image. |
|
||||
| `node_modules` | Anonymous volume at `/app/node_modules` | The bind mount replaces all of `/app`, which would otherwise hide the dependencies installed in the image. The volume is a snapshot copied from the image when the container is first created; it never refreshes afterwards. |
|
||||
| Compose env | `CI: "true"` | pnpm 11 verifies dependency state before every `pnpm run` (`runDepsStatusCheck`). When the state is stale it wants to purge `node_modules`, and with no TTY under compose it aborts (`ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY`). CI mode replaces the prompt with a non-interactive reinstall per the mounted lockfile. |
|
||||
| Command | `pnpm run dev -- --host 0.0.0.0` | The dev server would otherwise listen on localhost inside the container and be unreachable from the host. The `--` passes the flag through pnpm to the `dev` script rather than letting pnpm interpret it. |
|
||||
|
||||
# Evidence
|
||||
@@ -67,6 +68,8 @@ CMD ["pnpm", "run", "dev", "--", "--host", "0.0.0.0"]
|
||||
| `docker run -v <repo>:/app -v /app/node_modules -p 13000:3000 cv-site-nuxt:dev` | `HTTP 200` from the host after 4 seconds; server reported "Ready in 2.02s". |
|
||||
| `ls -A /app/node_modules` inside that container | 9 entries (`nuxt`, `vue`, `vue-router`, `.pnpm`, …) — the anonymous volume is populated from the image rather than starting empty. |
|
||||
| Ownership of `.nuxt` on the host after that run | `noel:noel`, so the uid-1000 choice holds. |
|
||||
| `docker compose up` after the mounted manifests drifted from the volume's snapshot | Exit 1: `ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY` — pnpm's pre-run check found the drift, wanted to purge `node_modules`, and had no TTY to ask. |
|
||||
| `docker compose up -d --build -V` with `CI: "true"` in the compose file | Builds, renews the stale anonymous volume, server reports "Ready in 2.62s"; no pnpm prompt or abort. |
|
||||
|
||||
# Side effects on the host
|
||||
|
||||
@@ -78,8 +81,6 @@ already exists the ownership is left alone — a pre-created directory stays
|
||||
|
||||
# Not verified
|
||||
|
||||
* `docker compose up --build -V` as the remedy for a stale anonymous volume after
|
||||
a dependency change was not tested.
|
||||
* That a root-owned `node_modules` breaks a host-side `pnpm install` is inferred
|
||||
from the permissions, not measured.
|
||||
|
||||
|
||||
@@ -23,6 +23,14 @@ silenced but **reviewed and recorded**: `auditConfig.ignoreGhsas` in
|
||||
`pnpm-workspace.yaml`, each entry with the date and reason, removed when a
|
||||
patched version ships.
|
||||
|
||||
Advisories that DO have a patch take the upgrade route: the patched version
|
||||
is forced with `overrides` in `pnpm-workspace.yaml`. First use (2026-10-20):
|
||||
`postcss-selector-parser: 7.1.6` over the `6.1.4` that `tailwindcss` 3.4.19
|
||||
pins via `postcss-nested` 6.2.0 (GHSA-rj75-hqrm-r3gf, moderate) - the
|
||||
patched 7.1.6 was already in the tree via `postcss-nesting` and proved
|
||||
API-compatible through a full build. The override is removed when
|
||||
`tailwindcss` ships `>= 7.1.6` itself or the site moves to Tailwind v4.
|
||||
|
||||
Currently ignored (both verified against the advisory database and the npm
|
||||
registries on 2026-10-18 - the newest published versions are the vulnerable
|
||||
ones):
|
||||
|
||||
@@ -0,0 +1,75 @@
|
||||
---
|
||||
type: Future Updates
|
||||
title: Pipeline improvement backlog
|
||||
description: Five candidate improvements taken from Anthropic's code-review post, with effort estimates - plus what is deliberately not adopted.
|
||||
tags: [backlog, ci, ai, review, gitea-actions]
|
||||
status: proposal
|
||||
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-19T00:00:00Z }
|
||||
verified: { by: human:noel, at: not yet }
|
||||
sources:
|
||||
- id: anthropic-review-post
|
||||
resource: https://claude.dev/blog/solving-code-review-at-anthropic/
|
||||
title: How the Claude Code team does code review (Anthropic, 2026-10-15)
|
||||
- id: pr-checker
|
||||
resource: .gitea/workflows/pr-checker.yml
|
||||
title: PR Check workflow
|
||||
---
|
||||
|
||||
# Decision
|
||||
|
||||
Nothing decided yet. This file records candidate improvements for the PR
|
||||
pipeline so the analysis survives until they are picked up. Total effort if
|
||||
all are done: roughly half a day (3-6 h), all config/markdown work on the
|
||||
existing pipeline, no new infrastructure.
|
||||
|
||||
# Context
|
||||
|
||||
The existing three-layer pipeline (pre-commit, Gitea Actions, AI review)
|
||||
already matches the core of Anthropic's model: cost-ordered layers, blocking
|
||||
deterministic checks, severity-tagged findings, review-scope discipline
|
||||
(other jobs' findings are not repeated; docs-only diffs get one line), and
|
||||
fixing repeated findings at the source. The backlog below closes the gaps
|
||||
the post exposed; the machinery at their scale is deliberately skipped.
|
||||
|
||||
# Candidates
|
||||
|
||||
| # | Item | Effort | Complexity | Lands in |
|
||||
|---|---|---|---|---|
|
||||
| 1 | `pnpm build` CI job | ~30 min | Low | New job in the workflow, copied from the lint job block. Closes the biggest gap: nothing currently proves the app compiles or renders. Only unknown: build-time env/runtime config |
|
||||
| 2 | PR intent into the review | ~30 min | Low | Review job step: write `github.event.pull_request.title/body` to a file (node, as for the comment JSON), one prompt line. Reviewer then asks "does the change solve what it claims", like the post's reviewer |
|
||||
| 3 | No-repeat re-review | 1-2 h | Medium-low | Review job: fetch the previous review comment via the Gitea API (token scopes already sufficient) and pass it into the prompt as "already reported, do not repeat". Motivation: Anthropic measured that 59% of re-review findings were pre-existing code |
|
||||
| 4 | PR template | ~10 min | Trivial | `.gitea/PULL_REQUEST_TEMPLATE.md` with "How tested / Risk / How to revert" |
|
||||
| 5 | Reviewer eval set | 1-2 h | Low-medium | Note with 2-3 past PR diffs and their known findings; the reviewer prompt is rerun against them whenever prompt or model change. Seed exists: PR #5 findings in [AI review setup](decisions/ai-review-setup.md) and the failure-modes table in [PR pipeline layering](decisions/pr-pipeline-layering.md) |
|
||||
|
||||
# Order and cost notes
|
||||
|
||||
* Suggested order: 1 first (catches the most), then 2 and 3 together (both
|
||||
touch the review step), 4 and 5 whenever.
|
||||
* Items 2 and 3 cost a paid review per test run. Test them in one batch on a
|
||||
draft-to-ready PR, not iteratively, or the Go plan's usage window pays for
|
||||
the tuning.
|
||||
* Item 1 needs no review budget - it is a deterministic job.
|
||||
|
||||
# Deliberately not adopted
|
||||
|
||||
Scale-dependent machinery from the post; meaningless or wasteful for a
|
||||
single-author repository at a few PRs per week:
|
||||
|
||||
* Merge queue, feature flags, staged `latest`/`stable` channels - downtime
|
||||
is accepted for v1 anyway; the user is the only user.
|
||||
* Risk-tier classifiers, trusted-author lists, two-person approvals - the
|
||||
one-person equivalent: never let an agent-authored change to
|
||||
`.gitea/workflows/` merge unread (every pipeline regression so far lived
|
||||
there: the lost `chmod +x`, the empty `hashFiles`).
|
||||
* Multi-agent finding-voting (2-3x review cost) - verifying a BLOCKER
|
||||
manually before fixing achieves the same at solo scale, without touching
|
||||
the $3/5 h usage window.
|
||||
* Measuring human-approval metrics (approvals per PR, time waiting on a
|
||||
person) - there is no second reviewer to wait for.
|
||||
|
||||
# Revisit when
|
||||
|
||||
* An item is picked up - it moves from this backlog into its own decision
|
||||
file, and this file's table gets a "done" link like [open questions](open-questions.md).
|
||||
* A second repository reuses the pipeline (see [PR pipeline layering](decisions/pr-pipeline-layering.md))
|
||||
- then the skip-list above is re-judged for that repository's scale, not copied.
|
||||
@@ -9,6 +9,8 @@ released, and what was learned getting there. It is the "why" behind the
|
||||
config files — the configs say what, these documents say why.
|
||||
|
||||
* [Open questions](open-questions.md) - What is still undecided for the Nuxt site.
|
||||
* [Backend endpoints](backend-endpoints.md) - The smallest API the frontend needs from the Go gateway: health, chapters, knockdown, events.
|
||||
* [Future updates](future-updates.md) - Pipeline improvement backlog with effort estimates, not yet decided.
|
||||
* [Update log](log.md) - History of changes to this bundle.
|
||||
|
||||
# Decisions
|
||||
|
||||
@@ -1,5 +1,26 @@
|
||||
# Update Log
|
||||
|
||||
## 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 in `app.vue` (this PR's diff had dropped it with the NuxtWelcome swap), and the review job now requires `github.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's `postcss-selector-parser` 6.1.5 override suggestion - the 6.1.5 backport exists on npm, but the blocking audit still flags it (`<7.1.6` covers 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.full` token, 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) 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`.
|
||||
|
||||
@@ -17,7 +17,7 @@ generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T12:41:52Z }
|
||||
| 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 ($3 per 5 hours for DeepSeek V4 Pro) survive real review frequency, or the review model must move to `deepseek-v4.1-flash` ($80 window) | first quota-limited review | Switch to flash. |
|
||||
| ~~Whether the Go plan's per-model usage windows ($3 per 5 hours for DeepSeek V4 Pro) survive real review frequency, or the review model must move to `deepseek-v4.1-flash` ($80 window)~~ - **decided** (2026-10-20): review model is `opencode-go/deepseek-v4.1-flash#max`; the pro endpoint failed two consecutive review runs with `Upstream request failed: Endpoint is unavailable` (~10 min apart), so the recorded default was applied | 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
|
||||
|
||||
+4
-4
@@ -1,6 +1,6 @@
|
||||
<template>
|
||||
<div>
|
||||
<NuxtRouteAnnouncer />
|
||||
<NuxtWelcome />
|
||||
</div>
|
||||
<NuxtRouteAnnouncer />
|
||||
<NuxtLayout>
|
||||
<NuxtPage />
|
||||
</NuxtLayout>
|
||||
</template>
|
||||
@@ -0,0 +1,69 @@
|
||||
/* Self-hosted variable fonts (GDPR: no requests to Google CDNs) */
|
||||
@font-face {
|
||||
font-family: 'Newsreader';
|
||||
font-style: normal;
|
||||
font-weight: 200 800;
|
||||
font-display: swap;
|
||||
src: url('/fonts/newsreader-var.woff2') format('woff2');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'Newsreader';
|
||||
font-style: italic;
|
||||
font-weight: 200 800;
|
||||
font-display: swap;
|
||||
src: url('/fonts/newsreader-italic-var.woff2') format('woff2');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'Inter';
|
||||
font-style: normal;
|
||||
font-weight: 100 900;
|
||||
font-display: swap;
|
||||
src: url('/fonts/inter-var.woff2') format('woff2');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'JetBrains Mono';
|
||||
font-style: normal;
|
||||
font-weight: 100 800;
|
||||
font-display: swap;
|
||||
src: url('/fonts/jetbrains-mono-var.woff2') format('woff2');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'Material Symbols Outlined';
|
||||
font-style: normal;
|
||||
font-weight: 100 700;
|
||||
font-display: block;
|
||||
src: url('/fonts/material-symbols-outlined-var.woff2') format('woff2');
|
||||
}
|
||||
|
||||
@tailwind base;
|
||||
@tailwind components;
|
||||
@tailwind utilities;
|
||||
|
||||
@layer base {
|
||||
body {
|
||||
@apply bg-surface font-body-md text-on-surface antialiased overscroll-none selection:bg-primary-container selection:text-primary-fixed;
|
||||
}
|
||||
main > :first-child {
|
||||
margin-top: 0 !important;
|
||||
}
|
||||
main > :last-child {
|
||||
margin-bottom: 0 !important;
|
||||
}
|
||||
}
|
||||
|
||||
@layer components {
|
||||
.material-symbols-outlined {
|
||||
font-family: 'Material Symbols Outlined';
|
||||
font-weight: normal;
|
||||
font-style: normal;
|
||||
line-height: 1;
|
||||
letter-spacing: normal;
|
||||
text-transform: none;
|
||||
white-space: nowrap;
|
||||
word-wrap: normal;
|
||||
direction: ltr;
|
||||
display: inline-block;
|
||||
font-variation-settings: 'FILL' 0, 'wght' 400, 'GRAD' 0, 'opsz' 24;
|
||||
-webkit-font-smoothing: antialiased;
|
||||
}
|
||||
}
|
||||
Whitespace-only changes.
@@ -0,0 +1,20 @@
|
||||
<template>
|
||||
<footer class="w-full bg-surface-container-lowest shadow-[0_-1px_12px_rgba(0,0,0,0.3)] py-6">
|
||||
<div class="max-w-7xl mx-auto px-6 lg:px-12 flex flex-col sm:flex-row items-center justify-between gap-4">
|
||||
<div class="flex items-center gap-2.5 font-label-mono text-label-mono text-on-surface-variant">
|
||||
<span class="inline-block w-2 h-2 rounded-full bg-secondary shadow-[0_0_6px_#4ae176]" />
|
||||
<span>Served from my own server · k8s · Terraform · self-healing on purpose</span>
|
||||
</div>
|
||||
<div class="flex items-center gap-3 font-status-badge text-status-badge text-outline">
|
||||
<a
|
||||
href="https://www.google.com/maps?q=Heilbronn,+Germany"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
class="uppercase tracking-widest text-on-surface-variant/70 hover:text-on-surface transition-colors"
|
||||
>LOC // 49.1404° N, 9.2200° E</a>
|
||||
<span class="text-outline-variant">•</span>
|
||||
<span class="font-label-mono text-label-mono text-secondary-fixed-dim">SYS_STABLE</span>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
</template>
|
||||
@@ -0,0 +1,9 @@
|
||||
<template>
|
||||
<header class="fixed top-0 left-0 w-full z-50 bg-surface/85 backdrop-blur-md shadow-[0_1px_8px_rgba(0,0,0,0.25)]">
|
||||
<div class="h-16 max-w-7xl mx-auto px-6 lg:px-12 flex items-center justify-between gap-6">
|
||||
<AppLogo />
|
||||
<AppNav />
|
||||
<AppQuickLinks />
|
||||
</div>
|
||||
</header>
|
||||
</template>
|
||||
@@ -0,0 +1,111 @@
|
||||
<script setup lang="ts">
|
||||
// 32x32 sprite: '.' = transparent, letters = palette colors.
|
||||
// Head spans half the width (narrow), hoodie fills the bottom as a bust.
|
||||
// Rows: hair (0-3), hairline/forehead (4-5), glasses (6-8), face (9-12),
|
||||
// neck (13), shoulders/chest (14-31, drawstrings on 18).
|
||||
const PALETTE: Record<string, string> = {
|
||||
H: '#4a2f1d', // hair
|
||||
S: '#f2cfa5', // skin
|
||||
F: '#101418', // glasses frame
|
||||
L: '#cfe3ff', // lens glass
|
||||
P: '#2e3a45', // pupils
|
||||
N: '#e0b58f', // nose shade
|
||||
M: '#c26e57', // smile
|
||||
h: '#12151a', // hoodie
|
||||
w: '#e8e8e8', // drawstrings
|
||||
}
|
||||
|
||||
const SPRITE = [
|
||||
'..........HHHHHHHHHHHH..........',
|
||||
'.........HHHHHHHHHHHHHH.........',
|
||||
'........HHHHHHHHHHHHHHHH........',
|
||||
'........HHHHHHHHHHHHHHHH........',
|
||||
'........HHSSSSSSSSSSSSHH........',
|
||||
'........HSSSSSSSSSSSSSSH........',
|
||||
'........SFFFFFFFFFFFFFFS........',
|
||||
'........SFLPPLLFFLLPPLFS........',
|
||||
'........SFLLLLLFFLLLLLFS........',
|
||||
'........SSSSSSSSSSSSSSSS........',
|
||||
'........SSSSSSSNNSSSSSSS........',
|
||||
'........SSSSSSMMMMSSSSSS........',
|
||||
'..........SSSSSSSSSSSS..........',
|
||||
'.............SSSSSS.............',
|
||||
'..........hhhhhhhhhhhh..........',
|
||||
'.........hhhhhhhhhhhhhh.........',
|
||||
'........hhhhhhhhhhhhhhhh........',
|
||||
'.......hhhhhhhhhhhhhhhhhh.......',
|
||||
'......hhhhhhhhwhhwhhhhhhhh......',
|
||||
'....hhhhhhhhhhhhhhhhhhhhhhhh....',
|
||||
'...hhhhhhhhhhhhhhhhhhhhhhhhhh...',
|
||||
'..hhhhhhhhhhhhhhhhhhhhhhhhhhhh..',
|
||||
'.hhhhhhhhhhhhhhhhhhhhhhhhhhhhhh.',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
]
|
||||
|
||||
const flat = SPRITE
|
||||
.flatMap((row) => [...row])
|
||||
.map((cell) => PALETTE[cell] ?? 'transparent')
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<NuxtLink to="/" class="group flex items-center gap-3">
|
||||
<span class="flex items-center justify-center w-8 h-8 rounded bg-surface-container-high transition-colors">
|
||||
<span class="pixel-avatar" aria-hidden="true">
|
||||
<span
|
||||
v-for="(color, i) in flat"
|
||||
:key="i"
|
||||
class="pixel"
|
||||
:style="{ backgroundColor: color }"
|
||||
/>
|
||||
</span>
|
||||
</span>
|
||||
<div class="flex flex-col">
|
||||
<span class="font-headline-sm text-headline-sm tracking-tight text-on-surface font-medium">Noel Sabia</span>
|
||||
<span class="font-label-mono text-label-mono text-on-surface-variant tracking-wider uppercase text-[0.625rem]">Im using Arch btw</span>
|
||||
</div>
|
||||
</NuxtLink>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.pixel-avatar {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(32, 1px);
|
||||
width: 32px;
|
||||
height: 32px;
|
||||
transform-origin: bottom center;
|
||||
}
|
||||
|
||||
/* Breathing only while the logo link is hovered. */
|
||||
.group:hover .pixel-avatar {
|
||||
animation: breathe 3s ease-in-out infinite;
|
||||
}
|
||||
|
||||
.pixel {
|
||||
width: 1px;
|
||||
height: 1px;
|
||||
}
|
||||
|
||||
@keyframes breathe {
|
||||
0%,
|
||||
100% {
|
||||
transform: scale(1);
|
||||
}
|
||||
50% {
|
||||
transform: scale(1.06);
|
||||
}
|
||||
}
|
||||
|
||||
@media (prefers-reduced-motion: reduce) {
|
||||
.group:hover .pixel-avatar {
|
||||
animation: none;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
@@ -0,0 +1,23 @@
|
||||
<template>
|
||||
<nav class="hidden md:flex items-center gap-1.5">
|
||||
<NuxtLink
|
||||
to="/"
|
||||
aria-current="page"
|
||||
class="px-3 py-1.5 transition-colors bg-primary-container text-on-primary-container font-medium rounded font-body-sm text-body-sm"
|
||||
>
|
||||
Overview
|
||||
</NuxtLink>
|
||||
<a
|
||||
href="#"
|
||||
class="px-3 py-1.5 text-on-surface-variant hover:text-on-surface hover:bg-surface-container-high transition-colors font-body-sm text-body-sm"
|
||||
>
|
||||
Life Map
|
||||
</a>
|
||||
<a
|
||||
href="#"
|
||||
class="px-3 py-1.5 text-on-surface-variant hover:text-on-surface hover:bg-surface-container-high transition-colors font-body-sm text-body-sm"
|
||||
>
|
||||
Dev View
|
||||
</a>
|
||||
</nav>
|
||||
</template>
|
||||
@@ -0,0 +1,9 @@
|
||||
<template>
|
||||
<div class="hidden sm:flex items-center gap-4 text-on-surface-variant font-label-mono text-label-mono">
|
||||
<a href="#" class="hover:text-on-surface transition-colors">PDF CV</a>
|
||||
<span class="text-outline-variant text-[0.625rem]">/</span>
|
||||
<a href="#" class="hover:text-on-surface transition-colors">Contact</a>
|
||||
<span class="text-outline-variant text-[0.625rem]">/</span>
|
||||
<a href="https://github.com/NoelSabia" rel="noopener noreferrer" target="_blank" class="hover:text-on-surface transition-colors">GitHub</a>
|
||||
</div>
|
||||
</template>
|
||||
Whitespace-only changes.
Whitespace-only changes.
@@ -0,0 +1,9 @@
|
||||
<template>
|
||||
<div class="flex min-h-screen flex-col">
|
||||
<AppHeader />
|
||||
<main class="w-full flex-1 pt-16 bg-surface">
|
||||
<slot />
|
||||
</main>
|
||||
<AppFooter />
|
||||
</div>
|
||||
</template>
|
||||
Whitespace-only changes.
Whitespace-only changes.
@@ -0,0 +1,3 @@
|
||||
<template>
|
||||
<div />
|
||||
</template>
|
||||
Whitespace-only changes.
Whitespace-only changes.
+4
-1
@@ -2,5 +2,8 @@
|
||||
export default defineNuxtConfig({
|
||||
compatibilityDate: '2025-07-15',
|
||||
devtools: { enabled: true },
|
||||
modules: ['@nuxt/eslint']
|
||||
modules: ['@nuxt/eslint', '@nuxtjs/tailwindcss'],
|
||||
tailwindcss: {
|
||||
cssPath: '~/assets/css/main.css'
|
||||
}
|
||||
})
|
||||
@@ -14,6 +14,7 @@
|
||||
"typecheck": "nuxt typecheck"
|
||||
},
|
||||
"dependencies": {
|
||||
"@nuxtjs/tailwindcss": "6.14.0",
|
||||
"nuxt": "^4.6.2",
|
||||
"vue": "^3.5.43",
|
||||
"vue-router": "^5.4.0"
|
||||
|
||||
Generated
+987
File diff suppressed because it is too large.
Load diff
@@ -11,6 +11,16 @@ auditConfig:
|
||||
ignoreGhsas:
|
||||
- GHSA-86w9-cpqp-85rv
|
||||
- GHSA-vfj7-8cjw-p6xm
|
||||
overrides:
|
||||
# Fixable advisories get the patched version forced here, not an ignore
|
||||
# (audit policy: upgrade when a patch exists).
|
||||
# GHSA-rj75-hqrm-r3gf (moderate, 2026-10-20): postcss-selector-parser
|
||||
# < 7.1.6 parses some flat selector lists in quadratic time. tailwindcss
|
||||
# 3.4.19 still pins 6.1.4 via postcss-nested 6.2.0; the patched 7.1.6 is
|
||||
# already in the tree via postcss-nesting and is API-compatible. Remove
|
||||
# the override when tailwindcss ships >= 7.1.6 itself (or the site moves
|
||||
# to Tailwind v4).
|
||||
postcss-selector-parser: 7.1.6
|
||||
minimumReleaseAgeExclude:
|
||||
- '@rollup/rollup-darwin-x64@4.64.8'
|
||||
- '@rollup/rollup-freebsd-arm64@4.64.8'
|
||||
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,103 @@
|
||||
/** @type {import('tailwindcss').Config} */
|
||||
export default {
|
||||
darkMode: 'class',
|
||||
theme: {
|
||||
extend: {
|
||||
colors: {
|
||||
'on-tertiary-fixed-variant': '#653e00',
|
||||
'inverse-surface': '#d3e4ff',
|
||||
'tertiary-fixed-dim': '#ffb95f',
|
||||
background: '#031428',
|
||||
'secondary-container': '#00b954',
|
||||
'primary-container': '#1a3d64',
|
||||
'primary-fixed': '#d3e3ff',
|
||||
primary: '#a9c9f7',
|
||||
'surface-container-low': '#0b1c30',
|
||||
'surface-bright': '#2a3a4f',
|
||||
'on-primary': '#0a3158',
|
||||
'on-primary-fixed': '#001c38',
|
||||
'secondary-fixed-dim': '#4ae176',
|
||||
'inverse-on-surface': '#213146',
|
||||
tertiary: '#ffb95f',
|
||||
'inverse-primary': '#406089',
|
||||
'secondary-fixed': '#6bff8f',
|
||||
surface: '#031428',
|
||||
'surface-container-high': '#1b2b3f',
|
||||
'surface-variant': '#26364b',
|
||||
'surface-container-lowest': '#000f22',
|
||||
'on-tertiary-fixed': '#2a1700',
|
||||
'primary-fixed-dim': '#a9c9f7',
|
||||
'on-tertiary-container': '#e79400',
|
||||
'outline-variant': '#43474e',
|
||||
'on-surface': '#d3e4ff',
|
||||
'on-background': '#d3e4ff',
|
||||
'tertiary-fixed': '#ffddb8',
|
||||
'on-secondary': '#003915',
|
||||
'surface-dim': '#031428',
|
||||
'on-secondary-fixed': '#002109',
|
||||
'on-primary-container': '#89a8d5',
|
||||
'on-secondary-fixed-variant': '#005321',
|
||||
outline: '#8d9199',
|
||||
error: '#ffb4ab',
|
||||
'tertiary-container': '#563400',
|
||||
'surface-container-highest': '#26364b',
|
||||
'on-surface-variant': '#c3c6cf',
|
||||
'on-error': '#690005',
|
||||
'on-tertiary': '#472a00',
|
||||
'error-container': '#93000a',
|
||||
'on-error-container': '#ffdad6',
|
||||
'on-primary-fixed-variant': '#274870',
|
||||
'surface-container': '#102034',
|
||||
'on-secondary-container': '#004119',
|
||||
secondary: '#4ae176',
|
||||
'surface-tint': '#a9c9f7',
|
||||
},
|
||||
borderRadius: {
|
||||
DEFAULT: '0.125rem',
|
||||
lg: '0.25rem',
|
||||
xl: '0.5rem',
|
||||
full: '0.75rem',
|
||||
},
|
||||
spacing: {
|
||||
'space-lg': '1.5rem',
|
||||
'gutter-mobile': '1rem',
|
||||
'space-xl': '2.5rem',
|
||||
'margin-mobile': '1.25rem',
|
||||
'space-2xl': '4rem',
|
||||
'space-xs': '0.25rem',
|
||||
'space-sm': '0.5rem',
|
||||
'space-md': '1rem',
|
||||
gutter: '1.5rem',
|
||||
margin: '4rem',
|
||||
},
|
||||
fontFamily: {
|
||||
'status-badge': ['JetBrains Mono'],
|
||||
'mono-code': ['JetBrains Mono'],
|
||||
'body-lg': ['Inter'],
|
||||
'headline-lg': ['Newsreader'],
|
||||
'body-sm': ['Inter'],
|
||||
'display-mobile': ['Newsreader'],
|
||||
'body-md': ['Inter'],
|
||||
'headline-md': ['Newsreader'],
|
||||
'label-mono': ['JetBrains Mono'],
|
||||
'headline-sm': ['Inter'],
|
||||
display: ['Newsreader'],
|
||||
'headline-lg-mobile': ['Newsreader'],
|
||||
},
|
||||
fontSize: {
|
||||
'status-badge': ['0.6875rem', { lineHeight: '0.875rem', letterSpacing: '0.05em', fontWeight: '600' }],
|
||||
'mono-code': ['0.875rem', { lineHeight: '1.375rem', fontWeight: '400' }],
|
||||
'body-lg': ['1.125rem', { lineHeight: '1.75rem', fontWeight: '400' }],
|
||||
'headline-lg': ['2.5rem', { lineHeight: '3rem', letterSpacing: '-0.015em', fontWeight: '400' }],
|
||||
'body-sm': ['0.8125rem', { lineHeight: '1.25rem', fontWeight: '400' }],
|
||||
'display-mobile': ['2.25rem', { lineHeight: '2.75rem', letterSpacing: '-0.015em', fontWeight: '400' }],
|
||||
'body-md': ['0.9375rem', { lineHeight: '1.5rem', fontWeight: '400' }],
|
||||
'headline-md': ['1.75rem', { lineHeight: '2.25rem', letterSpacing: '-0.01em', fontWeight: '400' }],
|
||||
'label-mono': ['0.75rem', { lineHeight: '1rem', letterSpacing: '0.04em', fontWeight: '500' }],
|
||||
'headline-sm': ['1.125rem', { lineHeight: '1.5rem', letterSpacing: '-0.005em', fontWeight: '600' }],
|
||||
display: ['3.5rem', { lineHeight: '4rem', letterSpacing: '-0.02em', fontWeight: '400' }],
|
||||
'headline-lg-mobile': ['1.75rem', { lineHeight: '2.25rem', letterSpacing: '-0.01em', fontWeight: '400' }],
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
Reference in new issue
Block a user