Compare commits

...
Author SHA1 Message Date
Noel Sabia 90ef58a8cb fix(ci): check out the repo before the release-please reconcile step
PR Check / Lint + typecheck (pull_request) Canceled after 54s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
The release-please job never had a checkout because the action clones into its own temp directory. The new reconcile step runs a file from the workspace, so the first post-merge run failed with MODULE_NOT_FOUND for scripts/reconcile-release-please.mjs. Add actions/checkout@v4 before the label/reconcile steps; the action still uses its own temp clone for the release branch.
2026-10-31 20:15:09 +01:00
Noel 06e1d24977 Merge pull request 'fix(ci): reconcile stale release-please state before the action' (#33) from fix/release_please_tags into main
release-please / release-please (push) Failing after 2s
Reviewed-on: #33
2026-10-31 19:09:29 +00:00
Noel Sabia 7ffc6d73b6 fix(ci): validate the release tag and query pending PRs by label
PR Check / Lint + typecheck (pull_request) Successful in 1m8s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Successful in 8s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
Both PR-Agent findings were confirmed. A tag at the merge commit now counts only when it is exactly v<manifest version>; foreign CI or annotation tags are logged and ignored. Pending release PRs are fetched through the autorelease: pending label filter instead of paging every closed PR, so a concurrent close cannot shift a page and hide one.

Also fail loudly on a merged PR without merge_commit_sha or a manifest without a version, instead of producing vundefined.

Rebased on main after the separate audit fix (e0c69c1); the dependency overrides and lockfile changes from the earlier local commit were dropped. Verified on the rebased tree: lint, typecheck, build, the exact audit command, actionlint and a live dry run.
2026-10-31 20:05:40 +01:00
Noel 1860e88156 Merge pull request 'docs: record that the registry is Gitea's built-in container registry' (#32) from feat/docs_registrys into main
release-please / release-please (push) Successful in 14s
Reviewed-on: #32
2026-10-31 19:03:07 +00:00
Noel Sabia e0c69c1b77 fix(deps): unblock the dependency audit
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m7s
PR Check / Dependency audit (pull_request) Successful in 8s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
Bump nuxt to 4.6.3 and override node-forge 1.4.1 and glob 14.0.2.
minimatch stays a reviewed ignore: its patch drops makeRe, which
eslint-plugin-import-x imports.

Verified locally: lint, typecheck, build, and the exact audit command.
2026-10-31 19:57:38 +01:00
Noel Sabia c00db55f98 Merge remote-tracking branch 'origin/main' into feat/docs_registrys
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m6s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
# Conflicts:
#	OKF_Nuxt/log.md
2026-10-31 19:51:00 +01:00
Noel Sabia 700b1030fc docs: use Gitea's own registry on git.noelsabia.dev
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Failing after 1m17s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 7s
PR Check / AI code review (opencode) (pull_request) Failing after 14s
PR Check / Dependency audit (pull_request) Failing after 10s
The registry endpoint is the Gitea hostname itself, not a separate
registry.noelsabia.dev host. Point IMAGE, docker login and the v2
manifests check at git.noelsabia.dev and record the correction.
2026-10-31 19:05:57 +01:00
Noel Sabia 5f7027bd86 docs: record that the registry is Gitea's built-in container registry
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Failing after 13s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Failing after 22s
PR Check / Dependency audit (pull_request) Failing after 9s
Verified by logging in to registry.noelsabia.dev and pushing by hand.
The registry is Gitea's own, not a separately deployed component, so
there is nothing to stand up or reinvent.
2026-10-31 18:56:56 +01:00
Noel e29927bef7 Merge pull request 'chore(deps): update dependency @iconify-json/material-symbols to v1.2.97' (#30) from renovate/iconify-json-material-symbols-1.x-lockfile into main
release-please / release-please (push) Successful in 5s
2026-10-31 04:02:27 +00:00
Noel 06508be0e0 chore(deps): update dependency @iconify-json/material-symbols to v1.2.97
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m13s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 7s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
2026-10-31 04:02:25 +00:00
Noel 8f4eb24e77 Merge pull request 'feat(ci): replace opencode review with PR-Agent' (#28) from feat/pr-agent into main
release-please / release-please (push) Successful in 5s
Reviewed-on: #28
2026-10-30 20:59:30 +00:00
Noel 6dfa2c8aa6 Merge branch 'main' into feat/pr-agent
PR Check / Lint + typecheck (pull_request) Successful in 1m11s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dockerfile lint (droast) (pull_request) Successful in 4s
2026-10-30 20:40:02 +00:00
Noel 8b7d9bce81 Merge pull request 'ci(renovate): authenticate github.com release note lookups' (#29) from fix/renovate-release-notes into main
release-please / release-please (push) Successful in 5s
Reviewed-on: #29
2026-10-30 20:39:49 +00:00
Noel Sabia da28885588 refactor(deploy): run PR-Agent inside the Gitea compose stack
PR Check / Lint + typecheck (pull_request) Canceled after 22s
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
Move the service and its env file into the Gitea stack, remove the separate deploy directory and the unused /opt operator-access scripts, and keep the operational guide in OKF_Nuxt/pr-agent.md.
2026-10-30 21:39:31 +01:00
Noel Sabia 723c38d2e3 ci(renovate): authenticate github.com release note lookups
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / AI code review (opencode) (pull_request) Failing after 13s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Lint + typecheck (pull_request) Failing after 21s
Renovate fetches changelogs and release notes from github.com. Anonymous
requests are rate-limited, so the first run skipped them and printed the
"no github.com credentials" warning in the PR body.

RENOVATE_GITHUB_COM_TOKEN now comes from a repository secret. It is
independent of RENOVATE_TOKEN: any github.com account with read-only
access is enough, and no scopes are needed for public repositories.
2026-10-30 21:35:25 +01:00
Noel Sabia 636a65dd05 docs(pr-agent): record the first successful review
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Successful in 8s
PR Check / Lint + typecheck (pull_request) Successful in 1m10s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
The key is wired into the live server .env; glm-5.3-flash returned OK and /review on PR #28 posted a PR Reviewer Guide.
2026-10-30 21:28:05 +01:00
Noel Sabia a43134ad83 fix(ci): repair PR-Agent model routing
PR Check / Lint + typecheck (pull_request) Successful in 1m8s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 7s
PR Check / Dependency audit (pull_request) Successful in 8s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Security scan (Snyk) (pull_request) Skipped
OpenCode Go rejects requests without x-opencode-session, and LiteLLM needs the openai/ prefix on the fallback model. Supply the header through LITELLM__EXTRA_HEADERS, keep the prefixed fallback, and stop auto-running /improve so a PR gets one review plus /describe.
2026-10-30 21:14:15 +01:00
Noel Sabia 3eac73255f fix(deps): sync lockfile and pin patched seroval
The merge of main updated package.json to @nuxt/icon 2.6.2 without the lockfile, so frozen installs aborted. Regenerate the lockfile and force seroval 1.6.11 for GHSA-f86p-h4j2-7qgj and GHSA-9wx9-5pv9-3349.
2026-10-30 21:14:12 +01:00
Noel Sabia b84d353dcb docs(pr-agent): document the OpenCode Go session header
PR Check / Lint + typecheck (pull_request) Failing after 23s
PR Check / Dependency audit (pull_request) Failing after 10s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dockerfile lint (droast) (pull_request) Successful in 4s
2026-10-30 21:11:19 +01:00
Noel Sabia f5810960a8 chore(deploy): add least-privilege PR-Agent operator access
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Lint + typecheck (pull_request) Failing after 19s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Security scan (Snyk) (pull_request) Skipped
2026-10-30 21:09:19 +01:00
Noel 679c0b4858 Merge branch 'main' into feat/pr-agent
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Failing after 20s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
2026-10-30 20:05:32 +00:00
Noel efb73378e9 Merge pull request 'chore(deps): update dependency @nuxt/icon to v2.6.2' (#27) from renovate/nuxt-icon-2.x into main
release-please / release-please (push) Successful in 4s
2026-10-30 20:01:55 +00:00
Noel a8355d976b chore(deps): update dependency @nuxt/icon to v2.6.2
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / AI code review (opencode) (pull_request) Failing after 12s
PR Check / Security scan (Snyk) (pull_request) Skipped
renovate/artifacts Artifact file update failure
PR Check / Lint + typecheck (pull_request) Failing after 22s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 4s
2026-10-30 20:01:53 +00:00
Noel 214ec46fed Merge pull request 'chore(deps): update node:26-slim docker digest to 18f03e4' (#26) from renovate/node-26-slim into main
release-please / release-please (push) Successful in 4s
2026-10-30 20:01:50 +00:00
Noel c332c195a9 chore(deps): update node:26-slim docker digest to 18f03e4
PR Check / Lint + typecheck (pull_request) Successful in 1m12s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / AI code review (opencode) (pull_request) Failing after 15s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
2026-10-30 20:01:48 +00:00
Noel Sabia c626cc9c1d feat(ci): replace opencode review with PR-Agent
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Canceled after 45s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / Dependency audit (pull_request) Canceled after 0s
Run PR-Agent as a pinned webhook server on the Gitea Docker network and review on PR open plus slash commands. The per-PR opencode installer and verdict-posting step are removed.

The server-side .env stays outside the repository; deploy/pr-agent/ holds the compose definition and operator notes.
2026-10-30 21:00:53 +01:00
Noel a129e89aec Merge pull request 'ci(renovate): enable Renovate on Gitea with automerge' (#25) from feat/add_renovate into main
release-please / release-please (push) Successful in 5s
Reviewed-on: #25
2026-10-30 19:51:32 +00:00
Noel Sabia 2497d91cf7 ci(renovate): enable Renovate on Gitea with automerge
PR Check / Lint + typecheck (pull_request) Successful in 1m11s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / AI code review (opencode) (pull_request) Successful in 32s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 6s
Gitea has no hosted Renovate, so the repository runs the official image
from a scheduled Gitea Actions workflow. The platform settings stay in the
workflow environment because Renovate accepts them only in the self-hosted
config, not in renovate.json.

renovate.json keeps the repository config minimal: schema plus
automerge=true, which also covers major updates. The bot account and the
RENOVATE_TOKEN secret are the remaining manual steps.
2026-10-30 20:33:09 +01:00
Noel 9ecf504843 Merge pull request 'fix(ci): point changelog compare links at our Gitea' (#24) from fix/release-baseline into main
release-please / release-please (push) Successful in 8s
Reviewed-on: #24
2026-10-27 14:00:12 +00:00
Noel Sabia a2259df877 fix(ci): point changelog compare links at our Gitea
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m10s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 6s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / AI code review (opencode) (pull_request) Successful in 22s
PR Check / Dependency audit (pull_request) Successful in 9s
The generated CHANGELOG linked every release to
github.com/CV_Website/CV_Site_Nuxt, a host this repository does not live
on. release-please takes the compare host from the configuration, so it
is set now.

The decision record also gains the real reason no tag was ever created:
Gitea rewrites a merged PR's head.ref to refs/pull/<n>/head once the head
branch is deleted, and the Gitea build parses that field as the release
branch. BranchName.parse then fails and the release is dropped with a
logged error while the run still exits 0. The repository deleted every
merged branch; that default is off now, and the versions the manifest
already consumed have to be tagged by hand.
2026-10-27 12:20:28 +01:00
Noel 0c937e6f80 Merge pull request 'chore: release main' (#22) from release-please--branches--main into main
release-please / release-please (push) Successful in 7s
Publish image / Build and push image (push) Canceled after 0s
Reviewed-on: #22
2026-10-27 11:12:15 +00:00
Gitea Actions [Bot] e8ce629e1b chore: release main
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Lint + typecheck (pull_request) Successful in 1m10s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / AI code review (opencode) (pull_request) Successful in 19s
PR Check / Security scan (Snyk) (pull_request) Skipped
2026-10-27 11:07:55 +00:00
Noel f9ddbb7e1a Merge pull request 'fix(ci): create the release-please labels before the action runs' (#23) from fix/release_please into main
release-please / release-please (push) Successful in 9s
Reviewed-on: #23
2026-10-27 11:07:45 +00:00
Noel Sabia 0a3c90cc74 fix(ci): create the release-please labels before the action runs
PR Check / Lint + typecheck (pull_request) Successful in 1m11s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / AI code review (opencode) (pull_request) Successful in 38s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 4s
release-please finds merged release PRs by the 'autorelease: pending'
label. Gitea resolves label names with GetLabelIDsInRepoByNames, a SQL IN
filter that silently drops unknown names, so on a repository without the
labels the PR is created unlabeled and every run finds zero merged release
PRs: no tag, no release, and the next release PR instead - with a green
run each time. That is what happened to #20 and #21.

The workflow now ensures both labels exist (idempotent: list, create the
missing ones) and gained workflow_dispatch so a missed release can be
replayed.
2026-10-24 20:21:50 +02:00
Noel 08eb042ad7 Merge pull request 'chore: release main' (#21) from release-please--branches--main into main
release-please / release-please (push) Successful in 10s
Reviewed-on: #21
2026-10-24 17:54:44 +00:00
Gitea Actions [Bot] 75f8a2c675 chore: release main
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 / Lint + typecheck (pull_request) Successful in 1m6s
PR Check / AI code review (opencode) (pull_request) Successful in 22s
PR Check / Security scan (Snyk) (pull_request) Skipped
2026-10-24 17:51:22 +00:00
Noel 4e8aa28fd6 Merge pull request 'chore: release main' (#20) from release-please--branches--main into main
release-please / release-please (push) Successful in 10s
Reviewed-on: #20
2026-10-24 17:51:09 +00:00
Gitea Actions [Bot] 028b629152 chore: release main
PR Check / Lint + typecheck (pull_request) Successful in 1m5s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / AI code review (opencode) (pull_request) Successful in 18s
2026-10-24 17:34:48 +00:00
Noel 67cf2328c6 Merge pull request 'chore: release main' (#12) from release-please--branches--main into main
release-please / release-please (push) Successful in 11s
Reviewed-on: #12
2026-10-24 17:34:26 +00:00
Gitea Actions [Bot] ced3d8dab4 chore: release main
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / Lint + typecheck (pull_request) Canceled after 34s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
2026-10-24 17:34:00 +00:00
Noel 8150cd689f Merge pull request 'ci: publish image to the own registry on release tag' (#19) from feat/registry into main
release-please / release-please (push) Successful in 33s
Reviewed-on: #19
2026-10-24 17:33:25 +00:00
Noel Sabia c3445ad55d Merge remote-tracking branch 'origin/main' into feat/registry
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Successful in 49s
PR Check / Lint + typecheck (pull_request) Successful in 1m8s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Successful in 8s
# Conflicts:
#	OKF_Nuxt/log.md
2026-10-24 19:30:38 +02:00
Noel Sabia eebd6ca697 fix(ci): publish on a dedicated runner label, immutable version tags
PR Check / AI code review (opencode) (pull_request) Successful in 48s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Lint + typecheck (pull_request) Successful in 1m6s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
The review's blocker was real: runs-on: ubuntu-latest is the label
pr-checker.yml uses, and the job needs a runner-wide Docker socket, so the
only working configuration violated the trust boundary in the decision
doc. The job now runs on a dedicated 'publish' label that only a second
act_runner registration (docker_host: automount) may carry.

Version tags are now immutable: before building, the registry v2 API is
asked for manifests/<version> and 200 aborts the run. docker manifest
inspect cannot do this job - the pinned Debian 20.10 client fails on OCI
indexes for existing and missing tags alike (measured).

Also: the smoke test requires a rendered body (10 kB floor) on top of the
2xx, .github/actionlint.yaml declares the custom label, and the actionlint
hook passes that config explicitly because this repo keeps workflows in
.gitea/workflows, where actionlint does not auto-discover it.
2026-10-24 19:24:47 +02:00
Noel Sabia 435be63ae0 fix(ci): harden the release publish workflow after the PR review
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 / AI code review (opencode) (pull_request) Successful in 48s
PR Check / Dependency audit (pull_request) Successful in 8s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
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).
2026-10-24 19:15:55 +02:00
Noel Sabia f3d3e196d0 Merge remote-tracking branch 'origin/main' into feat/registry
# Conflicts:
#	OKF_Nuxt/log.md
2026-10-24 19:13:41 +02:00
Noel Sabia c3cf1dfc47 ci: publish image to the own registry on release tag
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m16s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Successful in 10s
PR Check / AI code review (opencode) (pull_request) Successful in 41s
Build Dockerfile on every v* tag push (created by release-please when the
release PR merges) and push registry.noelsabia.dev/cv_website/nuxt as the
version, sha-<12> and latest. Main pushes do not build: the registry holds
releases, not commits.

The job runs in node:22-bookworm and needs only the Docker client, so the
act_runner must expose its host socket (container.docker_host: automount);
a preflight step fails with that cause when it does not.
2026-10-24 19:02:54 +02:00
Noel ab022c9b57 Merge pull request 'feat: index.vue' (#18) from feat/index.vue into main
release-please / release-please (push) Successful in 8s
Reviewed-on: #18
2026-10-23 21:10:18 +00:00
Noel Sabia f1c4227375 Merge remote-tracking branch 'origin/main' into feat/index.vue
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Lint + typecheck (pull_request) Successful in 1m4s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Successful in 42s
PR Check / Security scan (Snyk) (pull_request) Skipped
2026-10-23 23:05:59 +02:00
Noel Sabia ccb3459e4f Merge origin/main into feat/index.vue
Conflicts:
- app/pages/index.vue: kept main's SEO setup (SITE, useSeoMeta,
  titleTemplate) alongside the branch's chapters import.
- OKF_Nuxt/log.md: both sides prepended entries; kept the profile and
  metrics entries above main's PR #16, SEO, favicon and icon entries.

Also takes main's @nuxtjs/seo and @nuxt/icon setup, favicon/OG assets,
site.config.mjs and the CI review changes. lint, typecheck and build pass
after a frozen-lockfile install.
2026-10-23 22:55:30 +02:00
Noel Sabia 47f4e64f24 feat(ui): simplify terminal and contact bar on mobile
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Lint + typecheck (pull_request) Successful in 52s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 6s
PR Check / AI code review (opencode) (pull_request) Successful in 47s
Below lg the chapter rows show only the context badge and the status, so
the terminal no longer needs 760px on a phone; the desktop grid is
unchanged. The contact bar stacks the email full width and puts LinkedIn
and the location side by side.

Contact values truncate instead of forcing the bar wider. Also fixes the
"someone we pull" typo in the third feature card and lets the hero quote
use the wider column.
2026-10-23 22:51:29 +02:00
Noel ce941cad2d Merge pull request 'feat(i18n): add five locales and a header language switcher' (#17) from feat/language_support into main
release-please / release-please (push) Successful in 8s
Reviewed-on: #17
2026-10-23 20:40:17 +00:00
Noel Sabia e4b30ad944 fix(i18n): keep root links in the active locale and fix switcher a11y
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m7s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / AI code review (opencode) (pull_request) Successful in 55s
AppNav, AppLogo and AppBottomNav used NuxtLink to "/", which resolves to the English root under prefix_except_default; they now use NuxtLinkLocale and drop the hardcoded aria-current. Bottom-nav labels go through $t as well. The switcher's accessible name now contains the visible locale code, aria-haspopup is gone in favour of a plain disclosure with aria-controls, and Escape returns focus to the trigger.
2026-10-23 22:34:09 +02:00
Noel Sabia 9a4d79a050 feat(ui): update homepage copy and import LinkedIn profile
Contact bar: Gmail, Heilbronn and a LinkedIn link; the phone chip is
removed. Hero: System Architect / Programmer, new pill and quote.
Feature cards: humility, learning and helpfulness instead of the
infrastructure copy.

Terminal: six chapters from the LinkedIn export (PreZero active;
Defifort, Alignerr, Outlier, freelance and 42 finished), each with a
context label. Rows use a fixed grid so names, context badges, status,
uptime and outcome line up vertically; the title bar has red/yellow/green
traffic lights and the footer pluralises its counters (1/5/14).

OKF: new profile data document for the export and chapter mapping;
backend endpoint examples and totals match the real rows.
2026-10-23 22:26:11 +02:00
Noel Sabia 078a49d14e Merge remote-tracking branch 'origin/main' into feat/language_support
PR Check / AI code review (opencode) (pull_request) Successful in 39s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m8s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Successful in 9s
Resolved: nuxt.config modules now carry @nuxt/icon and @nuxtjs/seo alongside @nuxtjs/i18n; package.json keeps both dependency sets; pnpm-lock.yaml regenerated. Also set i18n.baseUrl from site.config.mjs so sitemap alternates and future hreflang links are absolute.
2026-10-23 22:12:15 +02:00
Noel Sabia 93ab0c0d79 feat(i18n): add five locales and a header language switcher
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / AI code review (opencode) (pull_request) Successful in 42s
PR Check / Lint + typecheck (pull_request) Successful in 58s
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 6s
Locale files in i18n/locales for en, de, es, it and pl; English stays at / and the others are prefixed. One flag dropdown after the GitHub link on desktop, logo plus the language button on phones. Nav, quick links and footer strings go through $t, and the footer line drops "self-healing on purpose".
2026-10-23 22:00:34 +02:00
Noel 9b7222dd4d Merge pull request 'feat: rootpage' (#16) from feat/rootpage into main
release-please / release-please (push) Successful in 8s
Reviewed-on: #16
2026-10-23 19:53:14 +00:00
Noel Sabia b1a2eae48a chore: drop the unused public/_robots.txt
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Successful in 1m3s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 4s
PR Check / AI code review (opencode) (pull_request) Successful in 55s
@nuxtjs/seo writes robots.txt; the renamed copy was only reachable at
/_robots.txt and referenced nowhere.
2026-10-23 21:50:17 +02:00
Noel Sabia 2f9f236f13 fix(favicon): keep the ICO transparent when BACKGROUND is null
The documented null option fell through to opaque black: the BGRA writer
defaulted to #000000 and hardcoded alpha 0xff.
2026-10-23 21:50:17 +02:00
Noel Sabia ad4e8d7bd9 fix(ci): tell the reviewer the lockfile is excluded on purpose
The diff filter drops pnpm-lock.yaml to keep the patch small; the model read
that as an uncommitted lockfile and raised a BLOCKER on PR #16. Say so in the
prompt instead of widening the diff.
2026-10-23 21:50:17 +02:00
Noel Sabia 26739731ed feat(ui): build homepage hero, terminal and feature cards
Compose pages/index.vue from the desktop homepage mockup: decorative
backdrop scoped to the hero but not clipped at its bottom edge, hero with
status pill, quote and contact chips with copy buttons, terminal panel fed
by a chapter array with derived counters, and the three feature cards.

Split into app/components/home/ (auto-imported with the Home* prefix) and
keep the chapter data in app/data/chapters.ts so GET /api/chapters can
replace the mockup values later.
2026-10-23 21:22:02 +02:00
Noel Sabia 1c3503fed0 feat: pixel favicon and complete SEO metadata
PR Check / AI code review (opencode) (pull_request) Successful in 1m11s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Successful in 7s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Lint + typecheck (pull_request) Successful in 1m6s
- generate favicon.ico and favicon.svg from the header avatar; the sprite
  moves to app/utils/avatar.js so component and generators share one source
- register @nuxtjs/seo with site and Person schema.org data from
  site.config.mjs; canonical, robots, sitemap and llms.txt follow the routes
- title "Noel Sabia — <role>", summary_large_image, and no duplicate
  "| Noel Sabia" suffix from SEO Utils
- add a committed 1200x630 OG card generated by pnpm og-image; the dynamic
  OG renderer and skew protection stay off for the static deployment
- pin the Node version @nuxtjs/seo 6 requires and document the setup in the
  OKF bundle
2026-10-23 20:37:32 +02:00
Noel Sabia 24460083ff docs(okf): record the Nuxt Icon decision
- 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
2026-10-23 20:11:15 +02:00
Noel Sabia 3396c4949e feat(ui): mobile bottom nav on Nuxt Icon, footer hidden on phones
- AppBottomNav: fixed bar below md with Overview, Life Map and Dev View
- default.vue mounts it and carries pb-16 md:pb-0 so the footer stays clear
- AppFooter is hidden below md, where the bar takes over
- icons come from @nuxt/icon (mode svg, scanned client bundle) with the
  Material Symbols collection installed locally, replacing the webfont
- deletes the 3.9 MiB Material Symbols woff2 and its @font-face
2026-10-23 20:10:52 +02:00
Noel db04d441c9 Merge pull request 'ci: use cheaper review model and cache pipeline installs' (#15) from feat/upgrade-ci-cd-pipeline into main
release-please / release-please (push) Successful in 7s
Reviewed-on: #15
2026-10-20 19:05:35 +00:00
Noel Sabia fa8fafb7ef ci: use cheaper review model and cache pipeline installs
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / AI code review (opencode) (pull_request) Successful in 45s
PR Check / Lint + typecheck (pull_request) Successful in 1m42s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
- 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
Noel 71b73aacc8 Merge pull request 'feat: default.vue started' (#14) from feat/default.vue_started into main
release-please / release-please (push) Successful in 7s
Reviewed-on: #14
2026-10-20 18:47:34 +00:00
Noel Sabia 9be62982a4 fix(ci): gate the ai review to pull_request events, restore route announcer
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / ESLint (pull_request) Canceled after 27s
PR Check / Typecheck (pull_request) Canceled after 0s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
2026-10-20 20:46:43 +02:00
Noel Sabia 9b0f89ef38 fix(ci): switch review model to deepseek-v4.1-flash, pause snyk via workflow_dispatch
PR Check / Typecheck (pull_request) Successful in 44s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Successful in 5m12s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / ESLint (pull_request) Successful in 36s
2026-10-20 20:36:54 +02:00
Noel Sabia db11806c03 docs(okf): record the dependency-audit fix and transient review outage
PR Check / Typecheck (pull_request) Successful in 42s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / AI code review (opencode) (pull_request) Failing after 1m38s
PR Check / ESLint (pull_request) Successful in 36s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 6s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
2026-10-20 20:30:20 +02:00
Noel Sabia 9995fc75ed fix(deps): force patched postcss-selector-parser 7.1.6 (GHSA-rj75-hqrm-r3gf) 2026-10-20 20:30:18 +02:00
Noel Sabia cd22fa01f7 chore: remove empty scaffold directories 2026-10-20 20:26:28 +02:00
Noel Sabia 15cf091ddf docs(okf): add frontend API contract for the gateway
PR Check / ESLint (pull_request) Successful in 38s
PR Check / Typecheck (pull_request) Successful in 44s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / AI code review (opencode) (pull_request) Failing after 1m36s
2026-10-20 20:20:32 +02:00
Noel Sabia 48a403e5ae chore: drop .gitkeep from scaffolded directories 2026-10-20 20:20:31 +02:00
Noel Sabia 7b5c97c84e feat(ui): pixel-art breathing logo and external links 2026-10-20 20:20:28 +02:00
Noel Sabia 7ea2fb7e17 chore: ignore the .pnpm-store directory 2026-10-19 20:20:04 +02:00
Noel Sabia b640bd2344 docs(okf): add future-updates backlog for the review pipeline 2026-10-19 20:20:02 +02:00
Noel Sabia 8d53daa4a6 feat(ui): homepage shell with tailwind theme, self-hosted fonts, layout and header components 2026-10-19 20:19:57 +02:00
Noel Sabia dcb178a71a chore(pre-commit): exclude woff2 from the large-file check 2026-10-19 20:19:53 +02:00
Noel Sabia 8402bb8c48 chore: ignore the pnpm store dropped by container-side reinstalls 2026-10-19 19:16:31 +02:00
Noel Sabia 6c74e966db docs(okf): record the stale-volume pnpm purge abort and its verified fix 2026-10-19 19:16:13 +02:00
Noel 9c25132c3c Merge pull request 'chore(app): scaffold default Nuxt app/ folder structure' (#13) from feat/nuxt_setup into main
release-please / release-please (push) Successful in 6s
Reviewed-on: #13
2026-10-19 17:12:07 +00:00
Noel Sabia c491fd1879 chore(app): scaffold default Nuxt app/ folder structure
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Canceled after 6s
PR Check / Typecheck (pull_request) Canceled after 0s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
2026-10-19 19:11:30 +02:00
Noel 14a991ecec Merge pull request 'fix: unblock the release PR - real production image, reviewed audit ignores' (#11) from fix/action_fails_fix into main
release-please / release-please (push) Successful in 6s
Reviewed-on: #11
2026-10-18 19:26:17 +00:00
Noel f5ed820abf Merge branch 'main' into fix/action_fails_fix
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Typecheck (pull_request) Successful in 39s
PR Check / Dockerfile lint (droast) (pull_request) Successful in 5s
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / AI code review (opencode) (pull_request) Successful in 4m22s
PR Check / Dependency audit (pull_request) Successful in 8s
2026-10-18 19:17:46 +00:00
Noel 695a64a529 Merge pull request 'chore: release main' (#10) from release-please--branches--main into main
release-please / release-please (push) Successful in 8s
Reviewed-on: #10
2026-10-18 19:17:09 +00:00
Noel Sabia f32ad07648 fix: unblock the release PR - real production image, reviewed audit ignores
PR Check / Typecheck (pull_request) Canceled after 0s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Canceled after 28s
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
The release PR (chore: release main) failed two checks, both verified
locally before pushing:

- droast: the empty production Dockerfile failed DF071 (no
  instructions). The new Dockerfile is a runnable Node server (SSR):
  multi-stage, manifests-first layers, digest-pinned node:26-slim (same
  digest as the dev container), non-root uid 1000, node-fetch
  HEALTHCHECK. Measured: docker build succeeds in-image, container
  serves HTTP 200 and reports healthy; droast reports 0 errors.
- audit: two high advisories with NO patched release anywhere
  (node-forge <=1.4.0 and braces <=3.0.3 are the newest npm versions;
  both build-time-only paths under nitropack). Recorded as
  auditConfig.ignoreGhsas in pnpm-workspace.yaml with the reason and
  removal condition - the audit output still names what it skipped.
  pnpm 11 ignores the pnpm field in package.json (caught locally via
  the WARN before pushing); settings live in pnpm-workspace.yaml.

OKF_Nuxt: recorded the production-image and audit-policy decisions,
updated log, indexes and open questions.
2026-10-18 21:14:12 +02:00
Gitea Actions [Bot] 89cdad7aad chore: release main
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 4s
PR Check / AI code review (opencode) (pull_request) Successful in 21s
PR Check / ESLint (pull_request) Successful in 36s
PR Check / Typecheck (pull_request) Successful in 40s
2026-10-18 18:54:00 +00:00
Noel 0e5ddda59d Merge pull request 'fix(ci): give release-please git credentials for the release-branch push' (#9) from fix/release-please-git-credentials into main
release-please / release-please (push) Successful in 6s
Reviewed-on: #9
2026-10-18 18:53:54 +00:00
Noel Sabia a27bbbb2ab fix(ci): give release-please git credentials for the release-branch push
PR Check / Dockerfile lint (droast) (pull_request) Failing after 4s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / AI code review (opencode) (pull_request) Successful in 28s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Typecheck (pull_request) Successful in 38s
The 401 in run 89 was the final isomorphic-git push inside
code-suggester's createPullRequest, not an API call: tree, commit and
local ref update all ran through the token-authenticated octokit API,
then 'git push' used the git-username/git-password inputs - unset in
our workflow, so the push was anonymous. The remote branch
release-please--branches--main still sat at an old commit, proving the
push never landed. Pass the account name and the same token.
2026-10-18 19:41:33 +02:00
Noel 23b8918670 Merge pull request 'fix(ci): point release-please at PR_GITEA_TOKEN (write scopes)' (#8) from fix/release-please-token into main
release-please / release-please (push) Failing after 5s
Reviewed-on: #8
2026-10-18 17:26:54 +00:00
Noel f18278b65b Merge branch 'main' into fix/release-please-token
PR Check / Typecheck (pull_request) Canceled after 0s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Canceled after 0s
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
2026-10-18 17:26:40 +00:00
Noel 033697256a Merge pull request 'docs(okf): record CI/CD, AI review, release and secrets decisions' (#7) from feat/update_okf into main
release-please / release-please (push) Canceled after 0s
Reviewed-on: #7
2026-10-18 17:26:22 +00:00
Noel 1827dbc4b9 Merge branch 'main' into feat/update_okf
PR Check / ESLint (pull_request) Successful in 38s
PR Check / Typecheck (pull_request) Canceled after 26s
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
2026-10-18 17:26:15 +00:00
Noel f13fc7668c Merge pull request 'chore: add pre-commit guardrails' (#6) from feat/pre-commit-hooks into main
release-please / release-please (push) Failing after 4s
Reviewed-on: #6
2026-10-18 17:25:59 +00:00
Noel Sabia 81d658a871 fix: pass staged filenames to the eslint pre-commit hook
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / Typecheck (pull_request) Canceled after 15s
Validated from review comment 82 on this PR: the 'bash -c' wrapper
consumed the first staged filename as $0 and the command never
referenced $@, so eslint received zero file arguments and linted the
whole repo - --fix silently rewrote unstaged files and WIP lint errors
blocked unrelated commits. The entry now receives filenames directly
from pre-commit (empirically verified with an arg probe); documented
the re-stage loop for --fix and dropped the redundant 'types: [file]'
filter.
2026-10-18 19:25:06 +02:00
Noel Sabia e1192a2014 fix(ci): point release-please at PR_GITEA_TOKEN (write scopes)
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / AI code review (opencode) (pull_request) Successful in 1m23s
The dedicated RELEASE_PLEASE_TOKEN_CV_SITE_NUXT secret authenticated for
reads but threw when creating the release PR (exit 1, releases_created
false, no PR created): it lacks write:repository / write:issue. Use the
proven PR_GITEA_TOKEN instead, per the one-well-scoped-token policy in
OKF_Nuxt/decisions/snyk-paused-and-secrets-policy.md.
2026-10-18 18:28:41 +02:00
Noel 166dd7bffc Merge branch 'main' into feat/update_okf
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 4s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Typecheck (pull_request) Successful in 39s
PR Check / AI code review (opencode) (pull_request) Successful in 25s
PR Check / ESLint (pull_request) Successful in 36s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
2026-10-18 16:25:34 +00:00
Noel 8fa8eb63b2 Merge branch 'main' into feat/pre-commit-hooks
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
PR Check / AI code review (opencode) (pull_request) Successful in 1m19s
2026-10-18 16:25:25 +00:00
Noel 93e6af36d7 Merge pull request 'fix(ci): use opencode-go plan model for AI review' (#5) from fix/ai_pr_review into main
release-please / release-please (push) Failing after 4s
Reviewed-on: #5
2026-10-18 16:24:57 +00:00
Noel Sabia 3e68e630df fix(ci): close the fail-open gate, enforce read-only sandbox
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Typecheck (pull_request) Canceled after 21s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
PR Check / Dependency audit (pull_request) Canceled after 0s
Findings validated from review comments 71 and 75:

- [BLOCKER] the no-verdict branch exited \${EXIT_CODE:-1} which is 0
  when opencode succeeded without a verdict - job went green and the
  post step published non-review output. The else branch now exits 1
  unconditionally, the verdict is anchored to the last five lines (the
  prompt itself contains VERDICT lines), and the post step re-verifies
  the contract before posting.
- [BLOCKER] the v1 'permission' object is ignored by the opencode v2
  CLI - shell commands executed in both review runs despite deny. The
  config now uses the v2 'permissions' array with 'shell' as the
  action name, denying edit/shell/webfetch/websearch/external_directory.
- hygiene: droast linting prunes node_modules, audit comment names the
  exact key to re-add, shell blocks verified with sh -n.
2026-10-18 18:24:06 +02:00
Noel Sabia 7bf649cba6 docs(okf): record CI/CD, AI review, release and secrets decisions
PR Check / Dockerfile lint (droast) (pull_request) Skipped
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 36s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Failing after 13s
Four new decision documents covering the pipeline work: layering,
AI review setup (provider prefix, v2 CLI, env-only auth, verdict
gate), release engineering (release-please manifest mode), and the
Snyk pause with the token scope policy. Index grouped, log extended,
open questions updated.
2026-10-18 18:19:59 +02:00
Noel Sabia cefdb34d7e feat: merged main into this branch
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / AI code review (opencode) (pull_request) Successful in 4m41s
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
2026-10-18 18:11:34 +02:00
Noel Sabia bb0ab03a97 docs: add OKF_Nuxt decision records and log
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / AI code review (opencode) (pull_request) Canceled after 16s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
2026-10-18 18:09:45 +02:00
Noel Sabia 9987d6b8e4 chore: add release-please configuration (from release_please_advanced)
- release-please-config.json: node release type, root package,
  plain v-tags, default versioning
- .release-please-manifest.json: track current version (1.0.0)
- package.json: add version field required by the node release type
- release-please.yml: use the config/manifest files
2026-10-18 18:09:45 +02:00
Noel Sabia a3e6aef901 fix(ci): apply review findings round two
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 36s
PR Check / Typecheck (pull_request) Successful in 39s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
PR Check / AI code review (opencode) (pull_request) Successful in 4m17s
- droast: chmod +x was lost in the checksum rewrite (would have
  failed with exit 126); checksums now pinned in the workflow
  instead of trust-on-first-use
- permission config migrated to the OpenCode v2 schema (permissions
  array, bash renamed shell, websearch and external_directory denied)
- posting gate is now the output contract (verdict line present)
  instead of the exit code: opencode can exit 1 on benign tool
  denials after a completed review
- find -print -quit instead of piping into head (SIGPIPE, exit 141)
- audit comment now says to re-add continue-on-error
2026-10-18 18:01:13 +02:00
Noel Sabia 85f488a94d fix(ci): address AI review findings (credentials, supply chain)
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 33s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Failing after 3m9s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 4s
- [BLOCKER] remove opencode.json from the checkout: it held the API
  key in plaintext, readable by the review agent, and a malicious PR
  diff could prompt-inject the agent into quoting it in the publicly
  visible review comment. Env-only auth (verified headless). The
  permission config moves to $HOME/.config/opencode - outside the
  checkout and secret-free.
- [WARN] verify the droast binary against the publisher's
  sha256sums.txt of the same pinned release
- [WARN] pin the opencode v2 installer to 2.0.32

Findings validated with the validate-pr-review skill; findings 4/5
are moot with the blocker fix.
2026-10-18 17:54:06 +02:00
Noel Sabia f8d128705f fix(ci): deny write tools, never swallow review errors
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 34s
PR Check / Typecheck (pull_request) Successful in 37s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 4s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / AI code review (opencode) (pull_request) Successful in 3m9s
- deny edit/bash/webfetch in the generated opencode.json: headless
  permission prompts are the most likely cause of the review agent
  working silently for minutes and then dying; denying write tools
  also makes the reviewer provably read-only
- capture the exit code without triggering 'set -e' ('|| EXIT_CODE=$?')
  so the captured output is always printed before failing - the
  previous version aborted before 'cat' and produced silent failures
2026-10-18 17:34:17 +02:00
Noel Sabia 783c9ccda3 fix(ci): install opencode v2 for the review job
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Typecheck (pull_request) Successful in 37s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 4s
PR Check / AI code review (opencode) (pull_request) Failing after 2m43s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / ESLint (pull_request) Successful in 34s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
The classic installer (opencode.ai/install) ships only OpenCode 1.x
- v1.19.3 on arm64 - which cannot resolve model variants and failed
with ProviderModelNotFoundError for deepseek-v4-pro#max. Use the v2
installer (currently v2.0.32, same version as local dev); verified
working in a fresh arm64 container with key-only auth.
2026-10-18 17:18:54 +02:00
Noel Sabia cf6f209ebf fix(ci): make droast job actually run
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Typecheck (pull_request) Successful in 37s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
PR Check / AI code review (opencode) (pull_request) Failing after 12s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
The dockerfile-lint job skipped on every PR despite Dockerfiles
existing: the act runner's hashFiles() evaluation returned empty.
Replace it with an explicit file-discovery step. Also run the droast
binary in node:22-bookworm (arch-aware install) instead of the
vendor image, which ships no node and would fail actions/checkout
with exit 127 - same failure mode as the gitleaks image.
2026-10-18 17:11:31 +02:00
Noel Sabia 5f1d64db90 ci: bind opencode API key explicitly via opencode.json
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Dockerfile lint (droast) (pull_request) Skipped
PR Check / Typecheck (pull_request) Successful in 37s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Dependency audit (pull_request) Failing after 9s
PR Check / ESLint (pull_request) Successful in 35s
PR Check / AI code review (opencode) (pull_request) Failing after 11s
The headless CI container has no stored credentials, so auth depends
entirely on the injected key. Generate an opencode.json at runtime
that binds OPENCODE_API_KEY to the opencode-go provider explicitly,
removing any dependence on env-var-to-provider mapping behavior.
2026-10-18 17:08:46 +02:00
Noel Sabia a6761fae9a ci: make dependency audit blocking, log opencode errors
PR Check / ESLint (pull_request) Successful in 34s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / Dockerfile lint (droast) (pull_request) Skipped
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Typecheck (pull_request) Successful in 37s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / AI code review (opencode) (pull_request) Failing after 13s
- audit no longer runs with continue-on-error: a failed audit must
  turn the pipeline red, not pass silently
- opencode review runs with --print-logs so auth and provider errors
  (e.g. invalid API key vs missing Go subscription) appear in the job
  log instead of an opaque exit 1
2026-10-18 17:04:15 +02:00
Noel Sabia 8f36f14720 fix: remove leftover merge conflict marker from pr-checker.yml
PR Check / Dockerfile lint (droast) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 6s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Typecheck (pull_request) Successful in 37s
PR Check / Dependency audit (pull_request) Successful in 8s
PR Check / AI code review (opencode) (pull_request) Failing after 11s
2026-10-18 16:58:10 +02:00
Noel Sabia 066bcec47c merge: resolve pr-checker.yml in favour of opencode-go plan model
pr-checker.yml (push) Invalid workflow file
main changed the review model to the default thinking budget; keep
opencode-go/deepseek-v4-pro#max (plan-included, max effort) which
supersedes both earlier variants.
2026-10-18 16:57:46 +02:00
Noel Sabia 8b6bcb6d70 fix(ci): use opencode-go plan model for AI review
PR Check / Dockerfile lint (droast) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 34s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / AI code review (opencode) (pull_request) Failing after 13s
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Successful in 8s
The 'opencode' provider prefix points at OpenCode Zen (pay-per-call,
no funds), which failed every review run with 'Insufficient account
funds'. The opencode-go $10 plan covers deepseek-v4-pro with high
and max variants - use opencode-go/deepseek-v4-pro#max.
2026-10-18 16:53:16 +02:00
76 changed files with 7867 additions and 574 deletions

No files matched your search

+91 -172
View File
@@ -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 }}
@@ -15,9 +17,13 @@ env:
APP_DIR: .
jobs:
# ---------------------------------------------------------------- lint ----
lint:
name: ESLint
# ------------------------------------------------------ lint + typecheck --
# One job, not two: both checks use the same image, the same lockfile and
# the same install, so splitting them doubled the install work (and, on the
# 2 vCPU runner, the CPU contention). They still report as separate steps,
# so a failure says which check failed.
checks:
name: Lint + typecheck
runs-on: ubuntu-latest
container: node:22-bookworm
steps:
@@ -30,6 +36,32 @@ jobs:
# missing or empty")
version: 11
- name: Resolve pnpm store and lockfile hash
id: pnpm
working-directory: ${{ env.APP_DIR }}
run: |
# hashFiles() evaluates empty in this act runner, so the cache key
# is built from a real sha256 in a shell step instead. The store
# directory's own name is the layout version (store/v11 here), so
# it is in the key: a store from another pnpm major is unusable.
store="$(pnpm store path --silent)"
echo "store=$store" >> "$GITHUB_OUTPUT"
echo "layout=$(basename "$store")" >> "$GITHUB_OUTPUT"
echo "lockfile=$(sha256sum pnpm-lock.yaml | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
- name: Restore pnpm store
# v4.1.x, not v4.2+: the runner's cache server may only speak the v1
# API (Gitea runner 2.x). v4.1 works on both v1-only and v3 runners.
# A cache outage must not turn into a red PR: install still works
# without the store, just slower.
continue-on-error: true
uses: actions/cache@v4.1.0
with:
path: ${{ steps.pnpm.outputs.store }}
key: pnpm-store-${{ runner.os }}-${{ steps.pnpm.outputs.layout }}-${{ steps.pnpm.outputs.lockfile }}
restore-keys: |
pnpm-store-${{ runner.os }}-${{ steps.pnpm.outputs.layout }}-
- name: Install dependencies
working-directory: ${{ env.APP_DIR }}
run: pnpm install --frozen-lockfile
@@ -38,25 +70,6 @@ jobs:
working-directory: ${{ env.APP_DIR }}
run: pnpm lint
# ------------------------------------------------------------ typecheck ---
typecheck:
name: Typecheck
runs-on: ubuntu-latest
container: node:22-bookworm
steps:
- uses: actions/checkout@v4
- uses: pnpm/action-setup@v4
with:
# match the pnpm major version used locally (v11.x) - older pnpm
# rejects our config-only pnpm-workspace.yaml ("packages field
# missing or empty")
version: 11
- name: Install dependencies
working-directory: ${{ env.APP_DIR }}
run: pnpm install --frozen-lockfile
- name: Typecheck (vue-tsc)
working-directory: ${{ env.APP_DIR }}
run: pnpm typecheck
@@ -109,35 +122,82 @@ jobs:
- name: Audit dependencies for known vulnerabilities
working-directory: ${{ env.APP_DIR }}
run: pnpm audit --prod --audit-level moderate
continue-on-error: true # advisory: does not block the PR by default
# blocks the PR on vulnerabilities - re-add `continue-on-error: true`
# here only if a CVE fix is genuinely blocked upstream, never to
# make a red pipeline green
# ------------------------------------------------------- dockerfile lint --
dockerfile-lint:
name: Dockerfile lint (droast)
runs-on: ubuntu-latest
container:
image: immanuwell/droast:1.7.0
# skips until the repo contains a Dockerfile
if: ${{ hashFiles('**/Dockerfile', '**/Dockerfile.*', '**/Containerfile') != '' }}
# droast's own container image ships no node (actions/checkout would
# fail with exit 127 - same as the gitleaks image), so run the droast
# binary in the multi-arch node image instead
container: node:22-bookworm
steps:
- uses: actions/checkout@v4
- name: Install droast
run: |
case "$(uname -m)" in
x86_64) DROAST_ASSET=droast-linux-x86_64; DROAST_SHA=cadb963a040ba2e68641af764f794e5d4fb3371bb9b92255fa5027060b08ea6e ;;
aarch64) DROAST_ASSET=droast-linux-arm64; DROAST_SHA=0800e80d11f668615fc87750f58809b56bedca83ec6d8a539daa56f42da64bc3 ;;
*) echo "unsupported arch: $(uname -m)" && exit 1 ;;
esac
curl -fsSL -o /usr/local/bin/droast \
"https://github.com/immanuwell/dockerfile-roast/releases/download/1.7.0/${DROAST_ASSET}"
# verify against the pinned hash checked into this workflow
# (fetching the checksum from the same release as the binary
# would be trust-on-first-use and prove nothing)
echo "${DROAST_SHA} /usr/local/bin/droast" | sha256sum -c -
chmod +x /usr/local/bin/droast
droast --version
- name: Discover Dockerfiles
id: discover
# shell check instead of hashFiles: the act runner's hashFiles
# evaluation returned empty and silently skipped the job even when
# Dockerfiles existed
run: |
# Discovery: -print -quit instead of `| head -n 1` - head can
# SIGPIPE find (exit 141) when multiple Dockerfiles match
found="$(find . \
-path ./.git -prune -o -path ./node_modules -prune -o \
-type f \( -iname 'Dockerfile*' -o -iname '*dockerfile' -o -iname 'Containerfile*' \) \
-print -quit)"
if [ -n "$found" ]; then
echo "found=true" >> "$GITHUB_OUTPUT"
echo "Dockerfile found: $found"
else
echo "found=false" >> "$GITHUB_OUTPUT"
echo "No Dockerfile in repo - nothing to lint"
fi
- name: Lint Dockerfile(s)
if: ${{ steps.discover.outputs.found == 'true' }}
run: |
# --no-roast = technical output for CI; --min-severity warning so
# info-level findings don't block the PR
droast --no-roast --min-severity warning .
# lint exactly the tree the discovery step sees: prune node_modules
# and .git so vendored Dockerfiles in dependencies cannot produce
# findings on third-party code
find . \
-path ./.git -prune -o -path ./node_modules -prune -o \
-type f \( -iname 'Dockerfile*' -o -iname '*dockerfile' -o -iname 'Containerfile*' \) \
-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
@@ -169,144 +229,3 @@ jobs:
# Dockerfile/base image checks are covered by the droast job
snyk code test \
--severity-threshold=high
# -------------------------------------------------------- ai code review --
review:
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 }}
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Install opencode CLI
run: curl -fsSL https://opencode.ai/install | bash
env:
# pin the version for reproducible CI, e.g. v1.0.0
OPENCODE_VERSION: latest
- name: Get PR diff
run: |
# lockfile changes bloat the diff (175KB here) and are pointless to
# review - pnpm audit already covers dependencies. Excluding the
# lockfile also keeps the diff small enough to hand to the model.
# The diff goes to a file IN the workspace so the agent can read it
# with its file tools (passing 190KB as a CLI argument fails with
# "Argument list too long", MAX_ARG_STRLEN is 128KiB).
git diff --merge-base "origin/${{ github.base_ref }}" \
-- . ':(exclude)pnpm-lock.yaml' > .pr-review-diff.patch
wc -c .pr-review-diff.patch
- name: Run opencode review
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').
# Output is redirected (not piped through tee): if opencode fails,
# the job must fail here so the error log is never posted as a
# "review" comment.
opencode run \
--model opencode-go/deepseek-v4-pro#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.
The full PR diff is in the file .pr-review-diff.patch in the repo
root. Read it first with your file tools.
## Project context
- Stack: Nuxt 4 (Vue 3, TypeScript) SSR web app in the repo root.
Backend/API services are being added in Golang.
- Deployment target: a personal production CV website.
- Already covered by other CI jobs, do NOT repeat their findings:
ESLint (style), vue-tsc (types), gitleaks (secrets in git history),
pnpm audit (dependency CVEs), droast (Dockerfile lint).
- Your job is everything those tools CANNOT see: logic, security,
architecture, correctness.
## Nuxt / Vue / TypeScript focus
- SSR pitfalls: window/document/localStorage access without
<ClientOnly> or process.client guards; hydration mismatch risks
(Date.now(), Math.random(), locale formatting in render path).
- useAsyncData/useFetch: missing or colliding keys, duplicate
requests between server and client, wrong caching/refresh setup.
- Reactivity bugs: destructuring reactive objects losing reactivity,
missing await on async setup, watch on getters vs refs.
- Security: v-html with unsanitized data, user input flowing into
meta/URLs, open redirects, missing validation in /server/api and
Nitro route handlers, auth checks on both page and API level.
- Config hygiene: server-only runtime config (no NUXT_PUBLIC_
prefix) leaking secrets into the client bundle.
## Golang focus (when Go code is in the diff)
- Errors: unchecked errors, errors discarded, wrapping with %w,
sentinel vs typed errors, panic in library code.
- Concurrency: goroutine leaks (missing context cancellation),
data races (shared state without mutex/channel), WaitGroup
misuse, defer in loops.
- Resources: unclosed response bodies/files/rows, missing
timeouts on http.Client, unbounded buffering.
- Correctness: slice aliasing surprises, copy vs reference
semantics, nil map writes, integer truncation.
## Cross-cutting
- API contract mismatches between Nuxt frontend and Go backends
(field names, nullability, status codes, date formats).
- Missing authorization checks on new endpoints or pages.
- Secrets/credentials ending up in logs or client-visible output.
- Performance on the critical render path (heavy components,
unoptimized images, blocking Nitro middleware).
## Output format (strict)
Review the diff in .pr-review-diff.patch. For every finding:
[BLOCKER] file:line - what and why + concrete fix suggestion
[WARN] file:line - what and why + concrete fix suggestion
[NIT] file:line - optional improvement
BLOCKER = must fix before merge (security, data loss, broken
behavior). WARN = should fix soon. NIT = optional.
If a finding cannot be localized to a file, prefix [BLOCKER-GENERAL].
No compliments, no summaries of what the diff does, no style nits.
Keep it under 400 words unless there are more than 10 findings.
If the diff contains no reviewable code (docs/config only), say so
in one line.
End your response with a final verdict line, exactly one of:
VERDICT: APPROVE (no BLOCKER findings)
VERDICT: REQUEST_CHANGES (at least one BLOCKER)" \
> /tmp/review.md 2>&1
EXIT_CODE=$?
cat /tmp/review.md
if [ $EXIT_CODE -ne 0 ]; then
echo "::error::opencode review failed (exit ${EXIT_CODE}) - NOT posting this output as a review comment"
exit $EXIT_CODE
fi
- name: Post review as PR comment
continue-on-error: true # token missing/expired must not fail the build
env:
GITEA_TOKEN: ${{ secrets.PR_GITEA_TOKEN }}
PR_NUMBER: ${{ github.event.pull_request.number }}
REPO: ${{ github.repository }}
# Gitea sets GITHUB_API_URL, e.g. https://gitea.example.com/api/v1
run: |
# jq is not in the node image - use node for JSON encoding
BODY=$(node -e 'process.stdout.write(JSON.stringify(require("fs").readFileSync("/tmp/review.md","utf8")))')
HTTP_CODE=$(curl -s -o /tmp/comment-response.json -w "%{http_code}" \
-X POST \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
-d "{\"body\": ${BODY}}" \
"${GITHUB_API_URL}/repos/${REPO}/issues/${PR_NUMBER}/comments")
echo "POST status: ${HTTP_CODE}"
cat /tmp/comment-response.json
case "$HTTP_CODE" in
200|201) echo "Review comment posted." ;;
*) echo "::error::Failed to post review comment (HTTP ${HTTP_CODE}) - check PR_GITEA_TOKEN scope and expiry" ;;
esac
+230
View File
@@ -0,0 +1,230 @@
name: Publish image
# Fires on the version tag release-please creates when the release PR is
# merged (vX.Y.Z, plain tags - see OKF_Nuxt/decisions/release-engineering.md).
# A push to main does NOT build: an image tag always maps to a released
# version, so what runs in the cluster is traceable to a release, not to an
# arbitrary commit.
on:
push:
tags:
- 'v*'
# The runner has capacity 1, so releases already serialize. This keeps a
# manual re-run from racing a fresh release on the same tags.
concurrency:
group: publish-image
cancel-in-progress: false
env:
# Registry host + repository path. The path segment is the Gitea
# organisation, so k3s pulls git.noelsabia.dev/cv_website/nuxt:<tag>.
IMAGE: git.noelsabia.dev/cv_website/nuxt
APP_DIR: .
jobs:
publish:
name: Build and push image
# Dedicated label, NOT ubuntu-latest: this job needs the host Docker
# socket, and `docker_host` is a runner-wide setting. Sharing a label
# with pr-checker.yml would hand PR code (from a branch) a root-
# equivalent socket on the host that also runs Gitea and k3s.
# Register a second act_runner with `--labels publish:docker://node:22-bookworm`
# and `container.docker_host: automount` in its config, before the first
# tag: an unmatched label leaves the job queued indefinitely.
runs-on: publish
# A hung build would hold the capacity-1 runner and, through it, every
# other job on this server. Gitea's instance default is not a contract.
timeout-minutes: 20
# Same base image as the other jobs. The build runs on the runner's
# Docker daemon (not in a nested daemon), so this container only needs
# the CLI - see OKF_Nuxt/decisions/registry-publishing.md.
container: node:22-bookworm
steps:
- uses: actions/checkout@v4
- name: Install Docker CLI
# Debian's docker.io, not a curl-piped binary from GitHub: apt is a
# signed channel, and bookworm ships an arm64 build. Only the client
# is needed; the daemon lives on the host.
run: |
apt-get update
apt-get install -y --no-install-recommends docker.io
docker --version
- name: Check daemon access
# Fail here, with the cause, instead of halfway through a build.
# An unreachable daemon means the runner was started without the
# host socket mounted: set `docker_host: automount` in the
# act_runner config and restart the service.
#
# The socket is root-equivalent on the host, and automount is a
# runner-wide setting - it applies to every job on that runner,
# including PR jobs. Only enable it on a runner label that
# PR-triggered jobs cannot use; see the trust boundary in
# OKF_Nuxt/decisions/registry-publishing.md.
run: |
echo "DOCKER_HOST=${DOCKER_HOST:-<unset - the default socket path>}"
if ! docker info > /dev/null 2>&1; then
echo "::error::no Docker daemon reachable from this job - the act_runner needs the host Docker socket (docker_host: automount)"
exit 1
fi
- name: Resolve version and tags
id: version
run: |
# GITHUB_REF_NAME is the tag on a tag push. The git fallback keeps
# this working if a runner version does not set it.
version="${GITHUB_REF_NAME:-$(git describe --tags --exact-match HEAD)}"
# Strict semver, not a `v[0-9]*` prefix match: that would accept
# `v1`, `v1-anything` and prereleases, all valid registry tags.
if ! printf '%s' "$version" | grep -qE '^v[0-9]+\.[0-9]+\.[0-9]+$'; then
echo "::error::expected a vMAJOR.MINOR.PATCH tag, got '${version}'"
exit 1
fi
sha="$(git rev-parse --short=12 HEAD)"
# `latest` follows the newest release, not the newest build. A
# re-run of an older tag (Gitea can replay any run) must not drag
# `latest` backwards, while a re-run of the newest tag may set it:
# that release had not produced an image yet.
# A tag comparison needs the other tags, which a depth-1 tag
# checkout does not have. If the fetch fails, skip `latest` and
# say so - a wrong tag is worse than a missing one.
if git fetch --tags --force --quiet origin 2>/dev/null; then
newest="$(git tag -l | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -n 1)"
if [ "$version" = "$newest" ]; then
latest=true
else
latest=false
echo "::warning::${version} is not the newest release (${newest}) - not moving :latest"
fi
else
latest=false
echo "::warning::could not list tags - not moving :latest"
fi
# Short SHA tag alongside the version: OKF_CV_Website/architecture/
# delivery.md asks for SHA-tagged images so every deploy is
# traceable to a commit even after a tag is moved.
{
echo "version=${version}"
echo "sha=${sha}"
echo "latest=${latest}"
} >> "$GITHUB_OUTPUT"
echo "Building ${version} from ${sha} (latest: ${latest})"
- name: Log in to the registry
env:
REGISTRY_USERNAME: ${{ secrets.REGISTRY_USERNAME }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
run: |
# Missing secrets must fail loudly: an anonymous `docker push`
# would answer 401 with a message most people misread as a
# missing repository.
[ -n "$REGISTRY_USERNAME" ] || { echo "::error::secret REGISTRY_USERNAME is empty"; exit 1; }
[ -n "$REGISTRY_PASSWORD" ] || { echo "::error::secret REGISTRY_PASSWORD is empty"; exit 1; }
printf '%s' "$REGISTRY_PASSWORD" \
| docker login git.noelsabia.dev -u "$REGISTRY_USERNAME" --password-stdin
- name: Refuse to overwrite a published version
env:
REGISTRY_USERNAME: ${{ secrets.REGISTRY_USERNAME }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
VERSION: ${{ steps.version.outputs.version }}
run: |
# A version tag is immutable once published. Gitea can replay any
# run, and `docker push` would silently replace :vX.Y.Z with a
# rebuilt image, so the release would change content after the
# fact. A missing tag (first attempt, or a run that failed before
# pushing) is fine - nothing was published.
#
# Registry v2 API instead of `docker manifest inspect`: the
# Debian 20.10 client fails that command on OCI indexes with
# "unsupported manifest media type and no default available",
# for existing and missing tags alike.
url="https://git.noelsabia.dev/v2/cv_website/nuxt/manifests/${VERSION}"
code=$(curl -s -o /dev/null -w '%{http_code}' \
-u "${REGISTRY_USERNAME}:${REGISTRY_PASSWORD}" \
-H 'Accept: application/vnd.docker.distribution.manifest.v2+json' \
-H 'Accept: application/vnd.oci.image.index.v1+json' \
-H 'Accept: application/vnd.oci.image.manifest.v1+json' \
"$url")
echo "GET /v2/cv_website/nuxt/manifests/${VERSION}: HTTP ${code}"
case "$code" in
200) echo "::error::${VERSION} is already published and version tags are immutable - delete that tag in the registry deliberately to replace it"; exit 1 ;;
404) echo "${VERSION} is not published yet - continuing" ;;
401|403) echo "::error::registry rejected the credentials (HTTP ${code}) - check REGISTRY_USERNAME/REGISTRY_PASSWORD"; exit 1 ;;
*) echo "::error::unexpected answer from the registry (HTTP ${code})"; exit 1 ;;
esac
- name: Build image
env:
VERSION: ${{ steps.version.outputs.version }}
SHA: ${{ steps.version.outputs.sha }}
run: |
# --platform is explicit so a build on the wrong architecture fails
# instead of silently producing an amd64 image the arm64 node
# cannot run. Native here, no QEMU involved.
docker build \
--platform linux/arm64 \
--label "org.opencontainers.image.version=${VERSION}" \
--label "org.opencontainers.image.revision=${SHA}" \
-t "${IMAGE}:${VERSION}" \
-t "${IMAGE}:sha-${SHA}" \
"${APP_DIR}"
- name: Smoke-test the image
env:
VERSION: ${{ steps.version.outputs.version }}
run: |
# Start the real server inside the built image and require a 2xx
# with a real SSR body, not an empty shell. Cheaper than
# publishing a broken release, and the only step that proves the
# Nitro output actually runs. Done inside the container because
# the app's port is not reachable from this job container - the
# daemon publishes on the host, not here.
#
# The size floor is deliberately loose: the rendered homepage was
# 97 kB on 2026-10-24, so 10 kB catches "200 but nothing rendered"
# without failing on a future copy change.
docker run --rm "${IMAGE}:${VERSION}" sh -c '
node .output/server/index.mjs &
server=$!
i=0
while [ "$i" -lt 30 ]; do
if out=$(node -e "fetch(\"http://127.0.0.1:3000/\").then(async r => { const body = await r.text(); if (!r.ok || body.length < 10000) process.exit(1); console.log(r.status + \" \" + body.length + \" bytes\") }).catch(() => process.exit(1))" 2>/dev/null); then
echo "homepage rendered after ${i}s: HTTP ${out}"
kill "$server"
exit 0
fi
i=$((i + 1))
sleep 1
done
echo "no 2xx homepage with a rendered body within 30s"
kill "$server"
exit 1
'
- name: Tag latest
if: steps.version.outputs.latest == 'true'
env:
VERSION: ${{ steps.version.outputs.version }}
run: docker tag "${IMAGE}:${VERSION}" "${IMAGE}:latest"
- name: Push image
env:
VERSION: ${{ steps.version.outputs.version }}
SHA: ${{ steps.version.outputs.sha }}
LATEST: ${{ steps.version.outputs.latest }}
run: |
# Explicit per tag, not `--all-tags`: --all-tags would also push
# stale local tags left on the shared daemon by earlier runs.
docker push "${IMAGE}:${VERSION}"
docker push "${IMAGE}:sha-${SHA}"
if [ "$LATEST" = "true" ]; then
docker push "${IMAGE}:latest"
echo "Pushed ${IMAGE}:${VERSION}, :sha-${SHA}, :latest"
else
echo "Pushed ${IMAGE}:${VERSION}, :sha-${SHA} (:latest untouched)"
fi
+74 -1
View File
@@ -2,6 +2,10 @@ on:
push:
branches:
- main
# Manual trigger so a missed release can be replayed without waiting for
# the next push. The job is idempotent: it tags only merged release PRs
# that carry the pending label.
workflow_dispatch:
permissions:
contents: write
@@ -13,8 +17,77 @@ jobs:
release-please:
runs-on: ubuntu-latest
steps:
# The reconcile step below runs a file from this repository. The
# release-please action clones into its own temp directory and does not
# check the workspace out, so without this step the job fails with
# "Cannot find module .../scripts/reconcile-release-please.mjs".
- uses: actions/checkout@v4
# release-please marks its release PR with `autorelease: pending` and
# later finds the merged PR by that label. Gitea's label API resolves
# names and *silently ignores unknown ones* (GetLabelIDsInRepoByNames
# filters by name in SQL), so on a repository without these labels the
# PR is created unlabeled, the release phase finds no merged release PR
# and creates no tag - while the run still reports success. That is the
# bug this step prevents: make the labels exist first, every run.
- name: Ensure release-please labels exist
env:
GITEA_TOKEN: ${{ secrets.PR_GITEA_TOKEN }}
run: |
set -eu
existing="$(curl -sS -H "Authorization: token ${GITEA_TOKEN}" \
"${GITHUB_API_URL}/repos/${GITHUB_REPOSITORY}/labels?limit=50")"
for name in "autorelease: pending" "autorelease: tagged"; do
if printf '%s' "$existing" | grep -qF "\"name\":\"${name}\""; then
echo "label exists: ${name}"
continue
fi
code="$(curl -sS -o /tmp/label.json -w '%{http_code}' -X POST \
-H "Authorization: token ${GITEA_TOKEN}" \
-H 'Content-Type: application/json' \
-d "{\"name\":\"${name}\",\"color\":\"ededed\",\"description\":\"release-please state\"}" \
"${GITHUB_API_URL}/repos/${GITHUB_REPOSITORY}/labels")"
if [ "$code" != "201" ]; then
echo "::error::could not create label '${name}' (HTTP ${code})"
cat /tmp/label.json
exit 1
fi
echo "created label: ${name}"
done
# The label fix above is not retroactive. PR #22 was merged with
# `autorelease: pending` but its head branch had already been deleted,
# so the action reports `Bad branch name: refs/pull/22/head`, creates no
# tag and leaves the label behind. Every later run then aborts with
# "There are untagged, merged release PRs outstanding" and never opens a
# new release PR - green, no tags. This step reconciles that state before
# the action runs: mark a pending PR tagged when its tag already exists,
# or recreate the tag when the head branch is gone and release-please
# therefore cannot. See scripts/reconcile-release-please.mjs and
# OKF_Nuxt/decisions/release-engineering.md.
- name: Reconcile stale release-please state
env:
GITEA_TOKEN: ${{ secrets.PR_GITEA_TOKEN }}
run: node scripts/reconcile-release-please.mjs
- uses: joaquinjsb/gitea-release-please-action@v4
with:
token: ${{ secrets.RELEASE_PLEASE_TOKEN_CV_SITE_NUXT }}
# One well-scoped token for all workflow API work (see
# OKF_Nuxt/decisions/snyk-paused-and-secrets-policy.md). The
# dedicated RELEASE_PLEASE_TOKEN_CV_SITE_NUXT secret failed with
# exit 1: reads worked (createReleases completed) but creating
# the release PR threw - the token lacked the write:repository /
# write:issue scopes. PR_GITEA_TOKEN has both and is proven by
# the AI-review comment posting.
token: ${{ secrets.PR_GITEA_TOKEN }}
# The PR-creation path (code-suggester) pushes the release branch
# with isomorphic-git using these git credentials - NOT the token
# input (octokit reads use the token; the final `git push` uses
# git-username/git-password). Unset, the push is anonymous and
# fails "HTTP Error: 401 Unauthorized" after the branch commit is
# already built. Gitea git-over-HTTPS auth: account name +
# token as password.
git-username: Noel
git-password: ${{ secrets.PR_GITEA_TOKEN }}
config-file: release-please-config.json
manifest-file: .release-please-manifest.json
+47
View File
@@ -0,0 +1,47 @@
name: Renovate
# Renovate is not hosted for Gitea, so this repository runs it itself.
# The bot opens dependency PRs through the API; the PR pipeline checks them
# (a branch protection rule should require those checks before automerge).
#
# Manual setup: create a bot account with its full name and email set, give
# it write access to this repository, and store a token with
# repository read/write, issue read/write, user read and organization read
# as the RENOVATE_TOKEN Actions secret. Release notes also need a github.com
# token (any account, read-only, no scopes for public repositories) as the
# RENOVATE_GITHUB_COM_TOKEN secret.
on:
schedule:
# Daily at 04:00 UTC. Gitea only schedules workflows that exist on the
# default branch.
- cron: "0 4 * * *"
workflow_dispatch:
concurrency:
group: renovate
cancel-in-progress: false
jobs:
renovate:
name: Run Renovate
runs-on: ubuntu-latest
timeout-minutes: 30
# Pinned and multi-arch (the runner is arm64). The image installs the
# Node-based toolchain it needs on demand.
container: renovate/renovate:44.198.2
steps:
- name: Run Renovate
env:
RENOVATE_PLATFORM: gitea
# API root, not the web root. Renovate reads renovate.json from the
# default branch through this endpoint.
RENOVATE_ENDPOINT: https://git.noelsabia.dev/api/v1
RENOVATE_TOKEN: ${{ secrets.RENOVATE_TOKEN }}
# github.com is only used to fetch release notes and other public
# metadata. Anonymous requests are rate-limited, which is why the
# PR body warned that release notes were skipped.
RENOVATE_GITHUB_COM_TOKEN: ${{ secrets.RENOVATE_GITHUB_COM_TOKEN }}
# This workflow lives in the repository it updates, so scope the bot
# to it instead of every repository its account can see.
RENOVATE_REPOSITORIES: CV_Website/CV_Site_Nuxt
run: renovate
+9
View File
@@ -0,0 +1,9 @@
# actionlint configuration.
#
# `publish` is the label of the second act_runner registration (the one with
# the host Docker socket). actionlint only knows GitHub's hosted labels, so
# custom self-hosted labels have to be declared here or every workflow using
# them fails the lint hook.
self-hosted-runner:
labels:
- publish
+7
View File
@@ -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
+19 -3
View File
@@ -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 ---
@@ -52,18 +55,31 @@ repos:
hooks:
- id: actionlint
files: \.gitea/workflows/.*\.ya?ml$
# actionlint only auto-loads its config when the file is
# .github/actionlint.yaml *and* it recognises a project root by
# .github/workflows, which this repo does not have (it uses
# .gitea/workflows). Pass the config explicitly, or the custom
# `publish` runner label is reported as unknown.
args: [-config-file, .github/actionlint.yaml]
# --------------------------------------------------------- ESLint (Nuxt) -
# Local hook: needs `pnpm install` to have run in this repo. --fix makes
# it a helper; only staged files are linted (fast).
# it a helper; only staged files are linted (fast). When --fix rewrites
# a staged file, pre-commit aborts the commit ("files were modified") -
# re-stage and commit again; that re-stage loop is the standard price
# of a fixer hook.
- repo: local
hooks:
- id: eslint
name: eslint --fix (staged files)
entry: bash -c 'pnpm exec eslint --fix'
# no shell wrapper: pre-commit appends the staged filenames to the
# entry itself. A 'bash -c' wrapper would eat the first filename
# as $0 and eslint would get no file arguments at all (linting the
# whole repo instead - review finding on this PR, empirically
# verified).
entry: pnpm exec eslint --fix
language: system
files: \.(vue|ts|js|mjs|cjs)$
types: [file]
# When Go services arrive, add:
# - repo: https://github.com/dnephin/pre-commit-golang
+1 -1
View File
@@ -1,3 +1,3 @@
{
".": "0.0.0"
".": "1.4.0"
}
+245
View File
@@ -0,0 +1,245 @@
# Changelog
## [1.4.0](https://github.com/CV_Website/CV_Site_Nuxt/compare/v1.3.0...v1.4.0) (2026-10-27)
### Features
* add nuxt application shell ([5caa345](https://github.com/CV_Website/CV_Site_Nuxt/commit/5caa3457aa8f97dfca94059b15f8330e97bfb041))
* added dockerignore, a development docker image and a qa/prod docker image ([1a78935](https://github.com/CV_Website/CV_Site_Nuxt/commit/1a78935c23ef2c756912d9f561a69569c2f45d2f))
* extend ESLint config with default rule set ([e4ea5c3](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4ea5c3e7c74c4d2c700ced71372da13e031eb6c))
* **i18n:** add five locales and a header language switcher ([93ab0c0](https://github.com/CV_Website/CV_Site_Nuxt/commit/93ab0c0d79ac3de8f551d919798027f27bb819a8))
* merged main into this branch ([cefdb34](https://github.com/CV_Website/CV_Site_Nuxt/commit/cefdb34d7ec33a176714388a4a0805177e8c4216))
* pixel favicon and complete SEO metadata ([1c3503f](https://github.com/CV_Website/CV_Site_Nuxt/commit/1c3503fed0e6a385fcc98c5cfdcad605cf33e4be))
* set up ESLint and typecheck with @nuxt/eslint ([4e2a03e](https://github.com/CV_Website/CV_Site_Nuxt/commit/4e2a03eab88495cbfa9db861919189da0c4b2889))
* **ui:** build homepage hero, terminal and feature cards ([2673973](https://github.com/CV_Website/CV_Site_Nuxt/commit/26739731ed9e130c65d4530e067d82f17bc0534c))
* **ui:** homepage shell with tailwind theme, self-hosted fonts, layout and header components ([8d53daa](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d53daa4a6e4e9530ccad5c1ae25052e4a811849))
* **ui:** mobile bottom nav on Nuxt Icon, footer hidden on phones ([3396c49](https://github.com/CV_Website/CV_Site_Nuxt/commit/3396c4949ec6f1a16957b6e004cae176126ad5f4))
* **ui:** pixel-art breathing logo and external links ([7b5c97c](https://github.com/CV_Website/CV_Site_Nuxt/commit/7b5c97c84eab5f214c9e84ac79bd6e08642defa1))
* **ui:** simplify terminal and contact bar on mobile ([47f4e64](https://github.com/CV_Website/CV_Site_Nuxt/commit/47f4e64f24c08e2d5b1e13c6f0bd938877b1d0c4))
* **ui:** update homepage copy and import LinkedIn profile ([9a4d79a](https://github.com/CV_Website/CV_Site_Nuxt/commit/9a4d79a050c8d3a0d8bd43f9d473337b07c218b6))
### Bug Fixes
* **ci:** address AI review findings (credentials, supply chain) ([85f488a](https://github.com/CV_Website/CV_Site_Nuxt/commit/85f488a94dd8796ea5f11c292edddd32e21398cd))
* **ci:** apply review findings round two ([a3e6aef](https://github.com/CV_Website/CV_Site_Nuxt/commit/a3e6aef901086f5f8b416e2aa7d29596517f9550))
* **ci:** close the fail-open gate, enforce read-only sandbox ([3e68e63](https://github.com/CV_Website/CV_Site_Nuxt/commit/3e68e630dff92a7abd791b7a8808eb682f37a060))
* **ci:** create the release-please labels before the action runs ([0a3c90c](https://github.com/CV_Website/CV_Site_Nuxt/commit/0a3c90cc7489b7657a9a142fb2b6248ae0738a63))
* **ci:** deny write tools, never swallow review errors ([f8d1287](https://github.com/CV_Website/CV_Site_Nuxt/commit/f8d128705faa9493202cf724ae0a451d4dc6d1e5))
* **ci:** gate the ai review to pull_request events, restore route announcer ([9be6298](https://github.com/CV_Website/CV_Site_Nuxt/commit/9be62982a4a2494351006463ae71bd99f4e49fe4))
* **ci:** give release-please git credentials for the release-branch push ([a27bbbb](https://github.com/CV_Website/CV_Site_Nuxt/commit/a27bbbb2abf0fa8ddedd20c05bba2128e88faa3a))
* **ci:** hand review diff to agent as file, not argv ([16b9291](https://github.com/CV_Website/CV_Site_Nuxt/commit/16b9291a5111b93d6e7da244f821589fa3432d87))
* **ci:** harden the release publish workflow after the PR review ([435be63](https://github.com/CV_Website/CV_Site_Nuxt/commit/435be63ae0bd0fdac49e83f9ef5a21e9182efa16))
* **ci:** install opencode v2 for the review job ([783c9cc](https://github.com/CV_Website/CV_Site_Nuxt/commit/783c9ccda369fe5ec05ea5085488998de125045c))
* **ci:** JSON-encode review with node instead of jq ([a061fad](https://github.com/CV_Website/CV_Site_Nuxt/commit/a061fad9b1933414faa7e6a26bd3182c0ce6c9d7))
* **ci:** make droast job actually run ([cf6f209](https://github.com/CV_Website/CV_Site_Nuxt/commit/cf6f209ebf03c3a4faf4e32971ba036d60ddb36b))
* **ci:** pass --all-projects to snyk test ([7197f75](https://github.com/CV_Website/CV_Site_Nuxt/commit/7197f757a6447cf29a11f60914d89939bd647040))
* **ci:** pick gitleaks binary by CPU architecture ([88dadd5](https://github.com/CV_Website/CV_Site_Nuxt/commit/88dadd584627e963b4dee719768644626e343488))
* **ci:** point release-please at PR_GITEA_TOKEN (write scopes) ([e1192a2](https://github.com/CV_Website/CV_Site_Nuxt/commit/e1192a2014da8acfea37c5319f0b612f9f5a392e))
* **ci:** publish on a dedicated runner label, immutable version tags ([eebd6ca](https://github.com/CV_Website/CV_Site_Nuxt/commit/eebd6ca69782f4e77b598078397c4e84881ce98d))
* **ci:** pull gitleaks from GHCR and pin version ([ce9c090](https://github.com/CV_Website/CV_Site_Nuxt/commit/ce9c090a150e448919205f9386ff61bfe77dfdb9))
* **ci:** run app jobs from repo root ([bb13f1a](https://github.com/CV_Website/CV_Site_Nuxt/commit/bb13f1a187d482b9bb55dafa303356114ece42ae))
* **ci:** run gitleaks as binary in node image ([779cf20](https://github.com/CV_Website/CV_Site_Nuxt/commit/779cf20f45ec8db009065197140067a531649401))
* **ci:** run Snyk CLI via npm on arm64 runner ([8d2a000](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d2a00062e6381cbba9bdb703b210c8eb2201d92))
* **ci:** switch review model to deepseek-v4.1-flash, pause snyk via workflow_dispatch ([9b0f89e](https://github.com/CV_Website/CV_Site_Nuxt/commit/9b0f89ef38c189905869567be513dbf72e694b2d))
* **ci:** tell the reviewer the lockfile is excluded on purpose ([ad4e8d7](https://github.com/CV_Website/CV_Site_Nuxt/commit/ad4e8d7bd9e394d6c9f1b157f6cc71b28e62dcaa))
* **ci:** use opencode-go plan model for AI review ([8b6bcb6](https://github.com/CV_Website/CV_Site_Nuxt/commit/8b6bcb6d70d123dda551f08ef2c05dc3d50733f2))
* **ci:** use pnpm 11 in runner ([ecd0192](https://github.com/CV_Website/CV_Site_Nuxt/commit/ecd0192466f8d72b9f8532e32b1aea63ff9dd640))
* **deps:** force patched postcss-selector-parser 7.1.6 (GHSA-rj75-hqrm-r3gf) ([9995fc7](https://github.com/CV_Website/CV_Site_Nuxt/commit/9995fc75ed521ab54af59498dab7afa33f01ac23))
* **favicon:** keep the ICO transparent when BACKGROUND is null ([2f9f236](https://github.com/CV_Website/CV_Site_Nuxt/commit/2f9f236f13b318216784606901d008c8522bc65f))
* **i18n:** keep root links in the active locale and fix switcher a11y ([e4b30ad](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4b30ad9447e6117686a73b7b66a627d258a510d))
* pass staged filenames to the eslint pre-commit hook ([81d658a](https://github.com/CV_Website/CV_Site_Nuxt/commit/81d658a87105434835016ae20b24ef3cb7617d86))
* remove leftover merge conflict marker from pr-checker.yml ([8f36f14](https://github.com/CV_Website/CV_Site_Nuxt/commit/8f36f14720a4826fe4b4cebdf591994fa0961ae3))
* unblock the release PR - real production image, reviewed audit ignores ([f32ad07](https://github.com/CV_Website/CV_Site_Nuxt/commit/f32ad076486127a1132b754eb8258105754355bb))
## [1.3.0](https://github.com/CV_Website/CV_Site_Nuxt/compare/v1.2.0...v1.3.0) (2026-10-24)
### Features
* add nuxt application shell ([5caa345](https://github.com/CV_Website/CV_Site_Nuxt/commit/5caa3457aa8f97dfca94059b15f8330e97bfb041))
* added dockerignore, a development docker image and a qa/prod docker image ([1a78935](https://github.com/CV_Website/CV_Site_Nuxt/commit/1a78935c23ef2c756912d9f561a69569c2f45d2f))
* extend ESLint config with default rule set ([e4ea5c3](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4ea5c3e7c74c4d2c700ced71372da13e031eb6c))
* **i18n:** add five locales and a header language switcher ([93ab0c0](https://github.com/CV_Website/CV_Site_Nuxt/commit/93ab0c0d79ac3de8f551d919798027f27bb819a8))
* merged main into this branch ([cefdb34](https://github.com/CV_Website/CV_Site_Nuxt/commit/cefdb34d7ec33a176714388a4a0805177e8c4216))
* pixel favicon and complete SEO metadata ([1c3503f](https://github.com/CV_Website/CV_Site_Nuxt/commit/1c3503fed0e6a385fcc98c5cfdcad605cf33e4be))
* set up ESLint and typecheck with @nuxt/eslint ([4e2a03e](https://github.com/CV_Website/CV_Site_Nuxt/commit/4e2a03eab88495cbfa9db861919189da0c4b2889))
* **ui:** build homepage hero, terminal and feature cards ([2673973](https://github.com/CV_Website/CV_Site_Nuxt/commit/26739731ed9e130c65d4530e067d82f17bc0534c))
* **ui:** homepage shell with tailwind theme, self-hosted fonts, layout and header components ([8d53daa](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d53daa4a6e4e9530ccad5c1ae25052e4a811849))
* **ui:** mobile bottom nav on Nuxt Icon, footer hidden on phones ([3396c49](https://github.com/CV_Website/CV_Site_Nuxt/commit/3396c4949ec6f1a16957b6e004cae176126ad5f4))
* **ui:** pixel-art breathing logo and external links ([7b5c97c](https://github.com/CV_Website/CV_Site_Nuxt/commit/7b5c97c84eab5f214c9e84ac79bd6e08642defa1))
* **ui:** simplify terminal and contact bar on mobile ([47f4e64](https://github.com/CV_Website/CV_Site_Nuxt/commit/47f4e64f24c08e2d5b1e13c6f0bd938877b1d0c4))
* **ui:** update homepage copy and import LinkedIn profile ([9a4d79a](https://github.com/CV_Website/CV_Site_Nuxt/commit/9a4d79a050c8d3a0d8bd43f9d473337b07c218b6))
### Bug Fixes
* **ci:** address AI review findings (credentials, supply chain) ([85f488a](https://github.com/CV_Website/CV_Site_Nuxt/commit/85f488a94dd8796ea5f11c292edddd32e21398cd))
* **ci:** apply review findings round two ([a3e6aef](https://github.com/CV_Website/CV_Site_Nuxt/commit/a3e6aef901086f5f8b416e2aa7d29596517f9550))
* **ci:** close the fail-open gate, enforce read-only sandbox ([3e68e63](https://github.com/CV_Website/CV_Site_Nuxt/commit/3e68e630dff92a7abd791b7a8808eb682f37a060))
* **ci:** deny write tools, never swallow review errors ([f8d1287](https://github.com/CV_Website/CV_Site_Nuxt/commit/f8d128705faa9493202cf724ae0a451d4dc6d1e5))
* **ci:** gate the ai review to pull_request events, restore route announcer ([9be6298](https://github.com/CV_Website/CV_Site_Nuxt/commit/9be62982a4a2494351006463ae71bd99f4e49fe4))
* **ci:** give release-please git credentials for the release-branch push ([a27bbbb](https://github.com/CV_Website/CV_Site_Nuxt/commit/a27bbbb2abf0fa8ddedd20c05bba2128e88faa3a))
* **ci:** hand review diff to agent as file, not argv ([16b9291](https://github.com/CV_Website/CV_Site_Nuxt/commit/16b9291a5111b93d6e7da244f821589fa3432d87))
* **ci:** harden the release publish workflow after the PR review ([435be63](https://github.com/CV_Website/CV_Site_Nuxt/commit/435be63ae0bd0fdac49e83f9ef5a21e9182efa16))
* **ci:** install opencode v2 for the review job ([783c9cc](https://github.com/CV_Website/CV_Site_Nuxt/commit/783c9ccda369fe5ec05ea5085488998de125045c))
* **ci:** JSON-encode review with node instead of jq ([a061fad](https://github.com/CV_Website/CV_Site_Nuxt/commit/a061fad9b1933414faa7e6a26bd3182c0ce6c9d7))
* **ci:** make droast job actually run ([cf6f209](https://github.com/CV_Website/CV_Site_Nuxt/commit/cf6f209ebf03c3a4faf4e32971ba036d60ddb36b))
* **ci:** pass --all-projects to snyk test ([7197f75](https://github.com/CV_Website/CV_Site_Nuxt/commit/7197f757a6447cf29a11f60914d89939bd647040))
* **ci:** pick gitleaks binary by CPU architecture ([88dadd5](https://github.com/CV_Website/CV_Site_Nuxt/commit/88dadd584627e963b4dee719768644626e343488))
* **ci:** point release-please at PR_GITEA_TOKEN (write scopes) ([e1192a2](https://github.com/CV_Website/CV_Site_Nuxt/commit/e1192a2014da8acfea37c5319f0b612f9f5a392e))
* **ci:** publish on a dedicated runner label, immutable version tags ([eebd6ca](https://github.com/CV_Website/CV_Site_Nuxt/commit/eebd6ca69782f4e77b598078397c4e84881ce98d))
* **ci:** pull gitleaks from GHCR and pin version ([ce9c090](https://github.com/CV_Website/CV_Site_Nuxt/commit/ce9c090a150e448919205f9386ff61bfe77dfdb9))
* **ci:** run app jobs from repo root ([bb13f1a](https://github.com/CV_Website/CV_Site_Nuxt/commit/bb13f1a187d482b9bb55dafa303356114ece42ae))
* **ci:** run gitleaks as binary in node image ([779cf20](https://github.com/CV_Website/CV_Site_Nuxt/commit/779cf20f45ec8db009065197140067a531649401))
* **ci:** run Snyk CLI via npm on arm64 runner ([8d2a000](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d2a00062e6381cbba9bdb703b210c8eb2201d92))
* **ci:** switch review model to deepseek-v4.1-flash, pause snyk via workflow_dispatch ([9b0f89e](https://github.com/CV_Website/CV_Site_Nuxt/commit/9b0f89ef38c189905869567be513dbf72e694b2d))
* **ci:** tell the reviewer the lockfile is excluded on purpose ([ad4e8d7](https://github.com/CV_Website/CV_Site_Nuxt/commit/ad4e8d7bd9e394d6c9f1b157f6cc71b28e62dcaa))
* **ci:** use opencode-go plan model for AI review ([8b6bcb6](https://github.com/CV_Website/CV_Site_Nuxt/commit/8b6bcb6d70d123dda551f08ef2c05dc3d50733f2))
* **ci:** use pnpm 11 in runner ([ecd0192](https://github.com/CV_Website/CV_Site_Nuxt/commit/ecd0192466f8d72b9f8532e32b1aea63ff9dd640))
* **deps:** force patched postcss-selector-parser 7.1.6 (GHSA-rj75-hqrm-r3gf) ([9995fc7](https://github.com/CV_Website/CV_Site_Nuxt/commit/9995fc75ed521ab54af59498dab7afa33f01ac23))
* **favicon:** keep the ICO transparent when BACKGROUND is null ([2f9f236](https://github.com/CV_Website/CV_Site_Nuxt/commit/2f9f236f13b318216784606901d008c8522bc65f))
* **i18n:** keep root links in the active locale and fix switcher a11y ([e4b30ad](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4b30ad9447e6117686a73b7b66a627d258a510d))
* pass staged filenames to the eslint pre-commit hook ([81d658a](https://github.com/CV_Website/CV_Site_Nuxt/commit/81d658a87105434835016ae20b24ef3cb7617d86))
* remove leftover merge conflict marker from pr-checker.yml ([8f36f14](https://github.com/CV_Website/CV_Site_Nuxt/commit/8f36f14720a4826fe4b4cebdf591994fa0961ae3))
* unblock the release PR - real production image, reviewed audit ignores ([f32ad07](https://github.com/CV_Website/CV_Site_Nuxt/commit/f32ad076486127a1132b754eb8258105754355bb))
## [1.2.0](https://github.com/CV_Website/CV_Site_Nuxt/compare/v1.1.0...v1.2.0) (2026-10-24)
### Features
* add nuxt application shell ([5caa345](https://github.com/CV_Website/CV_Site_Nuxt/commit/5caa3457aa8f97dfca94059b15f8330e97bfb041))
* added dockerignore, a development docker image and a qa/prod docker image ([1a78935](https://github.com/CV_Website/CV_Site_Nuxt/commit/1a78935c23ef2c756912d9f561a69569c2f45d2f))
* extend ESLint config with default rule set ([e4ea5c3](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4ea5c3e7c74c4d2c700ced71372da13e031eb6c))
* **i18n:** add five locales and a header language switcher ([93ab0c0](https://github.com/CV_Website/CV_Site_Nuxt/commit/93ab0c0d79ac3de8f551d919798027f27bb819a8))
* merged main into this branch ([cefdb34](https://github.com/CV_Website/CV_Site_Nuxt/commit/cefdb34d7ec33a176714388a4a0805177e8c4216))
* pixel favicon and complete SEO metadata ([1c3503f](https://github.com/CV_Website/CV_Site_Nuxt/commit/1c3503fed0e6a385fcc98c5cfdcad605cf33e4be))
* set up ESLint and typecheck with @nuxt/eslint ([4e2a03e](https://github.com/CV_Website/CV_Site_Nuxt/commit/4e2a03eab88495cbfa9db861919189da0c4b2889))
* **ui:** build homepage hero, terminal and feature cards ([2673973](https://github.com/CV_Website/CV_Site_Nuxt/commit/26739731ed9e130c65d4530e067d82f17bc0534c))
* **ui:** homepage shell with tailwind theme, self-hosted fonts, layout and header components ([8d53daa](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d53daa4a6e4e9530ccad5c1ae25052e4a811849))
* **ui:** mobile bottom nav on Nuxt Icon, footer hidden on phones ([3396c49](https://github.com/CV_Website/CV_Site_Nuxt/commit/3396c4949ec6f1a16957b6e004cae176126ad5f4))
* **ui:** pixel-art breathing logo and external links ([7b5c97c](https://github.com/CV_Website/CV_Site_Nuxt/commit/7b5c97c84eab5f214c9e84ac79bd6e08642defa1))
* **ui:** simplify terminal and contact bar on mobile ([47f4e64](https://github.com/CV_Website/CV_Site_Nuxt/commit/47f4e64f24c08e2d5b1e13c6f0bd938877b1d0c4))
* **ui:** update homepage copy and import LinkedIn profile ([9a4d79a](https://github.com/CV_Website/CV_Site_Nuxt/commit/9a4d79a050c8d3a0d8bd43f9d473337b07c218b6))
### Bug Fixes
* **ci:** address AI review findings (credentials, supply chain) ([85f488a](https://github.com/CV_Website/CV_Site_Nuxt/commit/85f488a94dd8796ea5f11c292edddd32e21398cd))
* **ci:** apply review findings round two ([a3e6aef](https://github.com/CV_Website/CV_Site_Nuxt/commit/a3e6aef901086f5f8b416e2aa7d29596517f9550))
* **ci:** close the fail-open gate, enforce read-only sandbox ([3e68e63](https://github.com/CV_Website/CV_Site_Nuxt/commit/3e68e630dff92a7abd791b7a8808eb682f37a060))
* **ci:** deny write tools, never swallow review errors ([f8d1287](https://github.com/CV_Website/CV_Site_Nuxt/commit/f8d128705faa9493202cf724ae0a451d4dc6d1e5))
* **ci:** gate the ai review to pull_request events, restore route announcer ([9be6298](https://github.com/CV_Website/CV_Site_Nuxt/commit/9be62982a4a2494351006463ae71bd99f4e49fe4))
* **ci:** give release-please git credentials for the release-branch push ([a27bbbb](https://github.com/CV_Website/CV_Site_Nuxt/commit/a27bbbb2abf0fa8ddedd20c05bba2128e88faa3a))
* **ci:** hand review diff to agent as file, not argv ([16b9291](https://github.com/CV_Website/CV_Site_Nuxt/commit/16b9291a5111b93d6e7da244f821589fa3432d87))
* **ci:** harden the release publish workflow after the PR review ([435be63](https://github.com/CV_Website/CV_Site_Nuxt/commit/435be63ae0bd0fdac49e83f9ef5a21e9182efa16))
* **ci:** install opencode v2 for the review job ([783c9cc](https://github.com/CV_Website/CV_Site_Nuxt/commit/783c9ccda369fe5ec05ea5085488998de125045c))
* **ci:** JSON-encode review with node instead of jq ([a061fad](https://github.com/CV_Website/CV_Site_Nuxt/commit/a061fad9b1933414faa7e6a26bd3182c0ce6c9d7))
* **ci:** make droast job actually run ([cf6f209](https://github.com/CV_Website/CV_Site_Nuxt/commit/cf6f209ebf03c3a4faf4e32971ba036d60ddb36b))
* **ci:** pass --all-projects to snyk test ([7197f75](https://github.com/CV_Website/CV_Site_Nuxt/commit/7197f757a6447cf29a11f60914d89939bd647040))
* **ci:** pick gitleaks binary by CPU architecture ([88dadd5](https://github.com/CV_Website/CV_Site_Nuxt/commit/88dadd584627e963b4dee719768644626e343488))
* **ci:** point release-please at PR_GITEA_TOKEN (write scopes) ([e1192a2](https://github.com/CV_Website/CV_Site_Nuxt/commit/e1192a2014da8acfea37c5319f0b612f9f5a392e))
* **ci:** publish on a dedicated runner label, immutable version tags ([eebd6ca](https://github.com/CV_Website/CV_Site_Nuxt/commit/eebd6ca69782f4e77b598078397c4e84881ce98d))
* **ci:** pull gitleaks from GHCR and pin version ([ce9c090](https://github.com/CV_Website/CV_Site_Nuxt/commit/ce9c090a150e448919205f9386ff61bfe77dfdb9))
* **ci:** run app jobs from repo root ([bb13f1a](https://github.com/CV_Website/CV_Site_Nuxt/commit/bb13f1a187d482b9bb55dafa303356114ece42ae))
* **ci:** run gitleaks as binary in node image ([779cf20](https://github.com/CV_Website/CV_Site_Nuxt/commit/779cf20f45ec8db009065197140067a531649401))
* **ci:** run Snyk CLI via npm on arm64 runner ([8d2a000](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d2a00062e6381cbba9bdb703b210c8eb2201d92))
* **ci:** switch review model to deepseek-v4.1-flash, pause snyk via workflow_dispatch ([9b0f89e](https://github.com/CV_Website/CV_Site_Nuxt/commit/9b0f89ef38c189905869567be513dbf72e694b2d))
* **ci:** tell the reviewer the lockfile is excluded on purpose ([ad4e8d7](https://github.com/CV_Website/CV_Site_Nuxt/commit/ad4e8d7bd9e394d6c9f1b157f6cc71b28e62dcaa))
* **ci:** use opencode-go plan model for AI review ([8b6bcb6](https://github.com/CV_Website/CV_Site_Nuxt/commit/8b6bcb6d70d123dda551f08ef2c05dc3d50733f2))
* **ci:** use pnpm 11 in runner ([ecd0192](https://github.com/CV_Website/CV_Site_Nuxt/commit/ecd0192466f8d72b9f8532e32b1aea63ff9dd640))
* **deps:** force patched postcss-selector-parser 7.1.6 (GHSA-rj75-hqrm-r3gf) ([9995fc7](https://github.com/CV_Website/CV_Site_Nuxt/commit/9995fc75ed521ab54af59498dab7afa33f01ac23))
* **favicon:** keep the ICO transparent when BACKGROUND is null ([2f9f236](https://github.com/CV_Website/CV_Site_Nuxt/commit/2f9f236f13b318216784606901d008c8522bc65f))
* **i18n:** keep root links in the active locale and fix switcher a11y ([e4b30ad](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4b30ad9447e6117686a73b7b66a627d258a510d))
* pass staged filenames to the eslint pre-commit hook ([81d658a](https://github.com/CV_Website/CV_Site_Nuxt/commit/81d658a87105434835016ae20b24ef3cb7617d86))
* remove leftover merge conflict marker from pr-checker.yml ([8f36f14](https://github.com/CV_Website/CV_Site_Nuxt/commit/8f36f14720a4826fe4b4cebdf591994fa0961ae3))
* unblock the release PR - real production image, reviewed audit ignores ([f32ad07](https://github.com/CV_Website/CV_Site_Nuxt/commit/f32ad076486127a1132b754eb8258105754355bb))
## [1.1.0](https://github.com/CV_Website/CV_Site_Nuxt/compare/v1.0.0...v1.1.0) (2026-10-24)
### Features
* add nuxt application shell ([5caa345](https://github.com/CV_Website/CV_Site_Nuxt/commit/5caa3457aa8f97dfca94059b15f8330e97bfb041))
* added dockerignore, a development docker image and a qa/prod docker image ([1a78935](https://github.com/CV_Website/CV_Site_Nuxt/commit/1a78935c23ef2c756912d9f561a69569c2f45d2f))
* extend ESLint config with default rule set ([e4ea5c3](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4ea5c3e7c74c4d2c700ced71372da13e031eb6c))
* **i18n:** add five locales and a header language switcher ([93ab0c0](https://github.com/CV_Website/CV_Site_Nuxt/commit/93ab0c0d79ac3de8f551d919798027f27bb819a8))
* merged main into this branch ([cefdb34](https://github.com/CV_Website/CV_Site_Nuxt/commit/cefdb34d7ec33a176714388a4a0805177e8c4216))
* pixel favicon and complete SEO metadata ([1c3503f](https://github.com/CV_Website/CV_Site_Nuxt/commit/1c3503fed0e6a385fcc98c5cfdcad605cf33e4be))
* set up ESLint and typecheck with @nuxt/eslint ([4e2a03e](https://github.com/CV_Website/CV_Site_Nuxt/commit/4e2a03eab88495cbfa9db861919189da0c4b2889))
* **ui:** build homepage hero, terminal and feature cards ([2673973](https://github.com/CV_Website/CV_Site_Nuxt/commit/26739731ed9e130c65d4530e067d82f17bc0534c))
* **ui:** homepage shell with tailwind theme, self-hosted fonts, layout and header components ([8d53daa](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d53daa4a6e4e9530ccad5c1ae25052e4a811849))
* **ui:** mobile bottom nav on Nuxt Icon, footer hidden on phones ([3396c49](https://github.com/CV_Website/CV_Site_Nuxt/commit/3396c4949ec6f1a16957b6e004cae176126ad5f4))
* **ui:** pixel-art breathing logo and external links ([7b5c97c](https://github.com/CV_Website/CV_Site_Nuxt/commit/7b5c97c84eab5f214c9e84ac79bd6e08642defa1))
* **ui:** simplify terminal and contact bar on mobile ([47f4e64](https://github.com/CV_Website/CV_Site_Nuxt/commit/47f4e64f24c08e2d5b1e13c6f0bd938877b1d0c4))
* **ui:** update homepage copy and import LinkedIn profile ([9a4d79a](https://github.com/CV_Website/CV_Site_Nuxt/commit/9a4d79a050c8d3a0d8bd43f9d473337b07c218b6))
### Bug Fixes
* **ci:** address AI review findings (credentials, supply chain) ([85f488a](https://github.com/CV_Website/CV_Site_Nuxt/commit/85f488a94dd8796ea5f11c292edddd32e21398cd))
* **ci:** apply review findings round two ([a3e6aef](https://github.com/CV_Website/CV_Site_Nuxt/commit/a3e6aef901086f5f8b416e2aa7d29596517f9550))
* **ci:** close the fail-open gate, enforce read-only sandbox ([3e68e63](https://github.com/CV_Website/CV_Site_Nuxt/commit/3e68e630dff92a7abd791b7a8808eb682f37a060))
* **ci:** deny write tools, never swallow review errors ([f8d1287](https://github.com/CV_Website/CV_Site_Nuxt/commit/f8d128705faa9493202cf724ae0a451d4dc6d1e5))
* **ci:** gate the ai review to pull_request events, restore route announcer ([9be6298](https://github.com/CV_Website/CV_Site_Nuxt/commit/9be62982a4a2494351006463ae71bd99f4e49fe4))
* **ci:** give release-please git credentials for the release-branch push ([a27bbbb](https://github.com/CV_Website/CV_Site_Nuxt/commit/a27bbbb2abf0fa8ddedd20c05bba2128e88faa3a))
* **ci:** hand review diff to agent as file, not argv ([16b9291](https://github.com/CV_Website/CV_Site_Nuxt/commit/16b9291a5111b93d6e7da244f821589fa3432d87))
* **ci:** harden the release publish workflow after the PR review ([435be63](https://github.com/CV_Website/CV_Site_Nuxt/commit/435be63ae0bd0fdac49e83f9ef5a21e9182efa16))
* **ci:** install opencode v2 for the review job ([783c9cc](https://github.com/CV_Website/CV_Site_Nuxt/commit/783c9ccda369fe5ec05ea5085488998de125045c))
* **ci:** JSON-encode review with node instead of jq ([a061fad](https://github.com/CV_Website/CV_Site_Nuxt/commit/a061fad9b1933414faa7e6a26bd3182c0ce6c9d7))
* **ci:** make droast job actually run ([cf6f209](https://github.com/CV_Website/CV_Site_Nuxt/commit/cf6f209ebf03c3a4faf4e32971ba036d60ddb36b))
* **ci:** pass --all-projects to snyk test ([7197f75](https://github.com/CV_Website/CV_Site_Nuxt/commit/7197f757a6447cf29a11f60914d89939bd647040))
* **ci:** pick gitleaks binary by CPU architecture ([88dadd5](https://github.com/CV_Website/CV_Site_Nuxt/commit/88dadd584627e963b4dee719768644626e343488))
* **ci:** point release-please at PR_GITEA_TOKEN (write scopes) ([e1192a2](https://github.com/CV_Website/CV_Site_Nuxt/commit/e1192a2014da8acfea37c5319f0b612f9f5a392e))
* **ci:** publish on a dedicated runner label, immutable version tags ([eebd6ca](https://github.com/CV_Website/CV_Site_Nuxt/commit/eebd6ca69782f4e77b598078397c4e84881ce98d))
* **ci:** pull gitleaks from GHCR and pin version ([ce9c090](https://github.com/CV_Website/CV_Site_Nuxt/commit/ce9c090a150e448919205f9386ff61bfe77dfdb9))
* **ci:** run app jobs from repo root ([bb13f1a](https://github.com/CV_Website/CV_Site_Nuxt/commit/bb13f1a187d482b9bb55dafa303356114ece42ae))
* **ci:** run gitleaks as binary in node image ([779cf20](https://github.com/CV_Website/CV_Site_Nuxt/commit/779cf20f45ec8db009065197140067a531649401))
* **ci:** run Snyk CLI via npm on arm64 runner ([8d2a000](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d2a00062e6381cbba9bdb703b210c8eb2201d92))
* **ci:** switch review model to deepseek-v4.1-flash, pause snyk via workflow_dispatch ([9b0f89e](https://github.com/CV_Website/CV_Site_Nuxt/commit/9b0f89ef38c189905869567be513dbf72e694b2d))
* **ci:** tell the reviewer the lockfile is excluded on purpose ([ad4e8d7](https://github.com/CV_Website/CV_Site_Nuxt/commit/ad4e8d7bd9e394d6c9f1b157f6cc71b28e62dcaa))
* **ci:** use opencode-go plan model for AI review ([8b6bcb6](https://github.com/CV_Website/CV_Site_Nuxt/commit/8b6bcb6d70d123dda551f08ef2c05dc3d50733f2))
* **ci:** use pnpm 11 in runner ([ecd0192](https://github.com/CV_Website/CV_Site_Nuxt/commit/ecd0192466f8d72b9f8532e32b1aea63ff9dd640))
* **deps:** force patched postcss-selector-parser 7.1.6 (GHSA-rj75-hqrm-r3gf) ([9995fc7](https://github.com/CV_Website/CV_Site_Nuxt/commit/9995fc75ed521ab54af59498dab7afa33f01ac23))
* **favicon:** keep the ICO transparent when BACKGROUND is null ([2f9f236](https://github.com/CV_Website/CV_Site_Nuxt/commit/2f9f236f13b318216784606901d008c8522bc65f))
* **i18n:** keep root links in the active locale and fix switcher a11y ([e4b30ad](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4b30ad9447e6117686a73b7b66a627d258a510d))
* pass staged filenames to the eslint pre-commit hook ([81d658a](https://github.com/CV_Website/CV_Site_Nuxt/commit/81d658a87105434835016ae20b24ef3cb7617d86))
* remove leftover merge conflict marker from pr-checker.yml ([8f36f14](https://github.com/CV_Website/CV_Site_Nuxt/commit/8f36f14720a4826fe4b4cebdf591994fa0961ae3))
* unblock the release PR - real production image, reviewed audit ignores ([f32ad07](https://github.com/CV_Website/CV_Site_Nuxt/commit/f32ad076486127a1132b754eb8258105754355bb))
## 1.0.0 (2026-10-18)
### Features
* add nuxt application shell ([5caa345](https://github.com/CV_Website/CV_Site_Nuxt/commit/5caa3457aa8f97dfca94059b15f8330e97bfb041))
* added dockerignore, a development docker image and a qa/prod docker image ([1a78935](https://github.com/CV_Website/CV_Site_Nuxt/commit/1a78935c23ef2c756912d9f561a69569c2f45d2f))
* extend ESLint config with default rule set ([e4ea5c3](https://github.com/CV_Website/CV_Site_Nuxt/commit/e4ea5c3e7c74c4d2c700ced71372da13e031eb6c))
* merged main into this branch ([cefdb34](https://github.com/CV_Website/CV_Site_Nuxt/commit/cefdb34d7ec33a176714388a4a0805177e8c4216))
* set up ESLint and typecheck with @nuxt/eslint ([4e2a03e](https://github.com/CV_Website/CV_Site_Nuxt/commit/4e2a03eab88495cbfa9db861919189da0c4b2889))
### Bug Fixes
* **ci:** address AI review findings (credentials, supply chain) ([85f488a](https://github.com/CV_Website/CV_Site_Nuxt/commit/85f488a94dd8796ea5f11c292edddd32e21398cd))
* **ci:** apply review findings round two ([a3e6aef](https://github.com/CV_Website/CV_Site_Nuxt/commit/a3e6aef901086f5f8b416e2aa7d29596517f9550))
* **ci:** close the fail-open gate, enforce read-only sandbox ([3e68e63](https://github.com/CV_Website/CV_Site_Nuxt/commit/3e68e630dff92a7abd791b7a8808eb682f37a060))
* **ci:** deny write tools, never swallow review errors ([f8d1287](https://github.com/CV_Website/CV_Site_Nuxt/commit/f8d128705faa9493202cf724ae0a451d4dc6d1e5))
* **ci:** give release-please git credentials for the release-branch push ([a27bbbb](https://github.com/CV_Website/CV_Site_Nuxt/commit/a27bbbb2abf0fa8ddedd20c05bba2128e88faa3a))
* **ci:** hand review diff to agent as file, not argv ([16b9291](https://github.com/CV_Website/CV_Site_Nuxt/commit/16b9291a5111b93d6e7da244f821589fa3432d87))
* **ci:** install opencode v2 for the review job ([783c9cc](https://github.com/CV_Website/CV_Site_Nuxt/commit/783c9ccda369fe5ec05ea5085488998de125045c))
* **ci:** JSON-encode review with node instead of jq ([a061fad](https://github.com/CV_Website/CV_Site_Nuxt/commit/a061fad9b1933414faa7e6a26bd3182c0ce6c9d7))
* **ci:** make droast job actually run ([cf6f209](https://github.com/CV_Website/CV_Site_Nuxt/commit/cf6f209ebf03c3a4faf4e32971ba036d60ddb36b))
* **ci:** pass --all-projects to snyk test ([7197f75](https://github.com/CV_Website/CV_Site_Nuxt/commit/7197f757a6447cf29a11f60914d89939bd647040))
* **ci:** pick gitleaks binary by CPU architecture ([88dadd5](https://github.com/CV_Website/CV_Site_Nuxt/commit/88dadd584627e963b4dee719768644626e343488))
* **ci:** point release-please at PR_GITEA_TOKEN (write scopes) ([e1192a2](https://github.com/CV_Website/CV_Site_Nuxt/commit/e1192a2014da8acfea37c5319f0b612f9f5a392e))
* **ci:** pull gitleaks from GHCR and pin version ([ce9c090](https://github.com/CV_Website/CV_Site_Nuxt/commit/ce9c090a150e448919205f9386ff61bfe77dfdb9))
* **ci:** run app jobs from repo root ([bb13f1a](https://github.com/CV_Website/CV_Site_Nuxt/commit/bb13f1a187d482b9bb55dafa303356114ece42ae))
* **ci:** run gitleaks as binary in node image ([779cf20](https://github.com/CV_Website/CV_Site_Nuxt/commit/779cf20f45ec8db009065197140067a531649401))
* **ci:** run Snyk CLI via npm on arm64 runner ([8d2a000](https://github.com/CV_Website/CV_Site_Nuxt/commit/8d2a00062e6381cbba9bdb703b210c8eb2201d92))
* **ci:** use opencode-go plan model for AI review ([8b6bcb6](https://github.com/CV_Website/CV_Site_Nuxt/commit/8b6bcb6d70d123dda551f08ef2c05dc3d50733f2))
* **ci:** use pnpm 11 in runner ([ecd0192](https://github.com/CV_Website/CV_Site_Nuxt/commit/ecd0192466f8d72b9f8532e32b1aea63ff9dd640))
* pass staged filenames to the eslint pre-commit hook ([81d658a](https://github.com/CV_Website/CV_Site_Nuxt/commit/81d658a87105434835016ae20b24ef3cb7617d86))
* remove leftover merge conflict marker from pr-checker.yml ([8f36f14](https://github.com/CV_Website/CV_Site_Nuxt/commit/8f36f14720a4826fe4b4cebdf591994fa0961ae3))
+63
View File
@@ -0,0 +1,63 @@
# Production image for the Nuxt CV site.
#
# Shape: a runnable Node server (SSR). `nuxt build` emits a self-contained
# Nitro server (.output/server/index.mjs plus its traced dependencies and
# .output/public), so the runtime stage needs no dependency installation.
# This answers the open question in OKF_Nuxt/open-questions.md; the gateway
# proxies to this server instead of embedding static files (see
# OKF_Nuxt/decisions/production-image.md).
#
# Layer order follows OKF_Nuxt/decisions/build-layer-order.md: manifests
# before source, so dependency changes invalidate everything but source-only
# edits invalidate almost nothing.
#
# Base image is digest-pinned to the same node:26-slim digest as the dev
# container (OKF_Nuxt/decisions/dev-container-shape.md) - verified for the
# runner's arm64 and this workstation's x86_64.
# syntax: no BuildKit-only features used, so the default frontend suffices.
FROM node:26-slim@sha256:18f03e4b532a63baf09809fe8349c2171807f1818cb6c5230fb12aecd5beda65 AS build
# pnpm pinned to the same version as CI (pr-checker.yml pins major 11) and
# the local toolchain (11.26.0). Installed via npm from the node image - no
# corepack, which current node images no longer bundle.
RUN npm install -g pnpm@11.26.0
WORKDIR /app
# Manifests first: their layer only invalidates when dependencies change.
# --ignore-scripts skips the `nuxt prepare` postinstall (the source is not
# copied yet); `nuxt build` prepares what it needs itself. Native binaries
# (esbuild, unrs-resolver) come from platform-specific optional packages,
# not install scripts, so skipping scripts is safe here.
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
RUN pnpm install --frozen-lockfile --ignore-scripts
# Source last: the expensive layers above stay cached on source-only edits.
COPY . .
RUN pnpm build
FROM node:26-slim@sha256:18f03e4b532a63baf09809fe8349c2171807f1818cb6c5230fb12aecd5beda65
# pnpm is NOT installed in the runtime image: nothing here runs pnpm.
ENV NODE_ENV=production \
HOST=0.0.0.0 \
PORT=3000
WORKDIR /app
# Nitro's traced output includes .output/server/node_modules - the only
# thing the server needs. Runs as the image's non-root `node` user.
COPY --from=build --chown=node:node /app/.output ./.output
USER node
EXPOSE 3000
# node has no curl/wget in slim; use node's own fetch. The root path is
# served by the app itself, so a 2xx means the server is genuinely up.
HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
CMD node -e "fetch('http://127.0.0.1:3000/').then(r => process.exit(r.ok ? 0 : 1)).catch(() => process.exit(1))"
CMD ["node", ".output/server/index.mjs"]
+1 -1
View File
@@ -1,4 +1,4 @@
FROM node:26-slim@sha256:d62f13676d530f7edf97782729df69713c8ccfe6631e7f62f9ccab65968719a8
FROM node:26-slim@sha256:18f03e4b532a63baf09809fe8349c2171807f1818cb6c5230fb12aecd5beda65
# Node no longer bundles pnpm (corepack and pnpm are both absent from this
# image), so install it. First instruction, so later changes reuse the layer.
+131
View File
@@ -0,0 +1,131 @@
---
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)
- id: profile-export
resource: https://www.linkedin.com/in/noel-sabia-9738a4339/
title: LinkedIn profile (exported to Profile.pdf, 2026-10-23)
---
# 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` — the chapter rows
The terminal lists one row per life chapter:
`chapter=… status=… uptime=…% self_healed=…x`.
```json
[
{ "name": "prezero", "context": "Enterprise", "status": "active", "uptime": 99.98, "selfHealed": 14 },
{ "name": "defifort", "context": "Web3 startup", "status": "finished", "uptime": 100.0, "outcome": { "label": "completed", "value": "2025" } },
{ "name": "alignerr", "context": "AI Developer", "status": "finished", "uptime": 100.0, "outcome": { "label": "completed", "value": "2025" } },
{ "name": "outlier", "context": "AI Developer", "status": "finished", "uptime": 100.0, "outcome": { "label": "completed", "value": "2024" } },
{ "name": "freelance", "context": "Freelance", "status": "finished", "uptime": 100.0, "outcome": { "label": "completed", "value": "2024" } },
{ "name": "42-school", "context": "Education", "status": "finished", "uptime": 100.0, "outcome": { "label": "graduated", "value": "2024" } }
]
```
* One chapter = one row. `status` is `active` or `finished`.
* `context` is a short display label (`Enterprise`, `Web3 startup`,
`AI Developer`, `Freelance`, `Education`), not a status and not an
endpoint.
* Active chapters map to real workloads; finished ones are history entries.
* The terminal footer totals come from `GET /api/metrics` below, not
from counting this response in the browser.
## 3. `GET /api/metrics` — the terminal's numbers in one response
The homepage terminal shows one row per chapter and a footer with three
totals. Today the chapter list lives in `app/data/chapters.ts` (from
`Profile.pdf`), while `uptime` and `rebounds` are still mock values. The
gateway must own all of it once it exists, because uptime and recovery
counts are measurements, not copy.
```json
{
"chapters": [
{ "name": "prezero", "context": "Enterprise", "status": "active", "uptime": 99.98, "selfHealed": 14 },
{ "name": "42-school", "context": "Education", "status": "finished", "uptime": 100.0, "outcome": { "label": "graduated", "value": "2024" } }
],
"totals": { "active": 1, "sealed": 5, "rebounds": 14 }
}
```
The array above is abridged; the totals describe all six rows.
* `chapters` uses the same row shape as `/api/chapters`. The page maps
the response into the existing `Chapter` type in one place, so
`HomeChapterRow` does not know where the data came from.
* `totals.active`, `totals.sealed` and `totals.rebounds` are computed by
the gateway from the same rows the response carries. The footer must
not recompute them client-side, or the rows and the footer can
disagree after a partial update.
* `totals.sealed` counts chapters with `status: "finished"`;
`totals.rebounds` is the sum of `selfHealed`.
* Finished chapters carry `outcome` (`graduated`, `certified`, …)
instead of `selfHealed`.
* Poll it on the same 5-10 s interval as `/api/health`; the SSE stream
below replaces both later.
## 4. `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).
## 5. `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/metrics` 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.
* Per-row presentation (the `chapter=…` labels, colours, the
`self_healed=Nx` suffix) — the browser formats the numbers the API
returns; there is no endpoint per field.
# Related
* Design-level gateway behavior: `OKF_CV_Website/architecture/gateway.md`
* Trust boundaries and the allowlist: `OKF_CV_Website/architecture/system.md`
+86
View File
@@ -0,0 +1,86 @@
---
type: Decision
title: AI code review setup
description: The review job runs opencode with a cheap medium-effort opencode-go model, env-only auth, a read-only permission set, and posts only reviews that end with a verdict line.
tags: [decision, ci, ai, opencode, security]
status: deprecated
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T16:05:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: pr-checker
resource: .gitea/workflows/pr-checker.yml
title: PR Check workflow, review job
- id: go-plan
resource: https://opencode.ai/v2/docs/console/go/
title: OpenCode Go plan documentation
---
> Superseded by [PR-Agent for Gitea reviews](pr-agent.md) on 2026-10-30.
> The opencode job was removed from `pr-checker.yml`; this document remains
> as the record of the earlier setup and the failures it fixed.
# Decision
The review job installs opencode v2 from the dedicated v2 installer,
authenticates with `OPENCODE_API_KEY` from the environment only, runs
`opencode-go/claude-haiku-5-5#medium` (covered by the Go plan subscription,
no per-token cost), denies `edit`/`shell`/`webfetch`/`websearch` via a
global permission config written outside the checkout, and posts the
review as a PR comment only if the output ends with a `VERDICT:` line.
# Why each piece
| Piece | Why |
|---|---|
| Provider prefix `opencode-go`, not `opencode` | `opencode` is the pay-per-call Console gateway; the Go plan lives under its own provider id. The wrong prefix failed every run with "Insufficient account funds". |
| Model `claude-haiku-5-5#medium` | Cheap per token and cheap in the usage window, with a real `#medium` reasoning level. `deepseek-v4.1-flash` only exposes low/high/max, so its reviews always paid for the maximum effort. |
| The v2 installer (`/v2/install`) | The classic installer ships OpenCode 1.x (v1.19.3 on arm64), which cannot resolve model variants and failed with `ProviderModelNotFoundError` for `#max`. |
| Env-only auth, no `opencode.json` in the checkout | A config file in the workspace holds the API key in plaintext where the review agent can read it; a malicious PR diff could prompt-inject the agent into quoting the key in the publicly visible review comment. Environment variables are invisible to file reads. |
| Deny write tools via a global config outside the checkout | Headless runs cannot answer permission prompts; denials prevent both hangs and repo modification. The config file itself holds no secret, so its location leaks nothing. |
| Verdict line as the posting gate | `opencode` can exit non-zero after a fully completed review (observed: benign permission denials). A completed review always ends with a verdict line; error dumps never do. The verdict, not the exit code, decides whether a comment is posted. |
| `--print-logs` | Provider and auth errors otherwise die inside the captured output file, invisible in the job log. |
| Diff passed as a file, lockfile excluded | The diff as a CLI argument exceeded `MAX_ARG_STRLEN` (128 KiB per argument; the diff was 190 KB, mostly `pnpm-lock.yaml`). The agent reads `.pr-review-diff.patch` with its file tools. |
# The review prompt
The prompt names the stack (Nuxt 4 frontend, Go backends to come), lists
what the other CI jobs already catch so the model does not repeat them,
and focuses on SSR/hydration pitfalls, reactivity bugs, injection and
authz gaps, runtime-config leaks, and Go error/concurrency hygiene. It
prescribes the output format (`[BLOCKER]/[WARN]/[NIT] file:line`) and
derives the verdict from the findings, so the gate and the prompt agree.
# Evidence
* First real review on PR #5 (2026-10-18): produced five findings,
including a genuine regression in the workflow itself (a lost
`chmod +x` on the droast binary), verified upstream release assets and
the v2 permission schema live, and returned `VERDICT: REQUEST_CHANGES`.
* Fresh-container replica test (node:22-bookworm, key-only auth)
reproduced the CI failure exactly, then confirmed the v2 + `#max` fix
before it was pushed.
* Model history: `deepseek-v4-pro#max` was replaced by
`deepseek-v4.1-flash#max` after two consecutive endpoint outages, then
by `claude-haiku-5-5#medium` (2026-10-20) to stop paying maximum
reasoning effort on every review. The flash model had no `#medium`
variant to fall back to.
# Not verified
* Whether `#medium` still resolves after a future CLI upgrade — the
variant list comes from the model catalog, not a contract.
* Whether the smaller model still catches the same class of findings as
the first flash review. The PR #14 findings are the baseline; re-run
the eval on the next few PRs.
* Long-run behaviour of Go plan usage windows under real review
frequency, now that the model is cheaper.
# Revisit when
* A PR review fails again with a new error class — check the provider
prefix, the CLI version, and the usage limits first; they caused every
failure so far.
* A flash-tier model gains a `#medium` variant and beats the current
model on the PR #14 eval set — the present pick is a cost/quality
compromise, not a permanent one.
* Go Plus or pay-as-you-go balance becomes relevant.
+4 -3
View File
@@ -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.
+76
View File
@@ -0,0 +1,76 @@
---
type: Decision
title: Icons via Nuxt Icon
description: Every icon comes from @nuxt/icon with the Material Symbols collection installed locally; the self-hosted icon webfont, its @font-face and its CSS class are gone.
tags: [decision, ui, icons, nuxt, payload]
status: stable
generated: { by: opencode-go/deepseek-v4.1-flash, at: 2026-10-23T00:00:00Z }
verified: { by: human:noel, at: 2026-10-23T00:00:00Z }
sources:
- id: config
resource: nuxt.config.ts
title: Icon module registration and options
- id: consumer
resource: app/components/AppBottomNav.vue
title: First and only icon consumer so far
- id: package
resource: package.json
title: "@nuxt/icon and @iconify-json/material-symbols"
---
# Decision
Icons come exclusively from `@nuxt/icon`. The icon set is Material Symbols,
installed as a local collection (`@iconify-json/material-symbols`), and names are
written in full inside components:
```vue
<Icon name="material-symbols:badge" aria-hidden="true" class="text-[22px]" />
```
The previously self-hosted Material Symbols webfont is deleted:
`public/fonts/material-symbols-outlined-var.woff2`, its `@font-face` in
`app/assets/css/main.css`, and the `.material-symbols-outlined` class.
# Why
* **One icon system.** The nav rendered webfont glyphs by text content while
everything else in the app is Tailwind utilities; a ligature typo silently
produced a blank box.
* **Payload.** The font was 3.9 MiB for three glyphs. The bundled icon data for
the same three is 1.23 kB.
* **Self-hosting.** The module's defaults are not local: `mode: "css"`, provider
`server`, `iconifyApiEndpoint: https://api.iconify.design` and
`fallbackToApi: true`. Without an installed collection the site would call a
third-party CDN at runtime, which is the same problem the self-hosted text
fonts were chosen to avoid.
# Configuration
| Option | Value | Effect |
|---|---|---|
| `mode` | `'svg'` | The icon is an inline `<svg>` in the SSR HTML, so it survives with JavaScript disabled. CSS mode would have fetched icon data on the client and painted after hydration. |
| `serverBundle` | `{ collections: [] }` | `'auto'` bundles every installed collection server-side; with only `material-symbols` installed that was an 8 MB `icons.mjs`. Empty means no server-side icon data at all. |
| `clientBundle` | `{ scan: true }` | Bundles only the icons named in source. The build reports `Nuxt Icon client bundle consist of 3 icons with 1.23KB(uncompressed) in size`. |
# Consequences
* Sizing is `text-[…]` on the `<svg>`: the component renders `width="1em"
height="1em"`, so font-size is the icon size.
* Adding another Material Symbols icon is a code change only — the scanner picks
the name up and the next build bundles it.
* A different icon set means `pnpm add @iconify-json/<set>` plus new names; no
other configuration changes.
* Decorative icons carry `aria-hidden="true"`, because every icon sits next to a
text label.
# Not verified
* That the bars look right at 22px on a real phone — checked in the SSR HTML and
the build output only.
# Revisit when
* A second icon set is wanted (two collections, two packages, no config change).
* Many icons push the client bundle up: the alternative is `mode: 'css'`, which
ships class names and fetches icon data once instead of inline SVG per icon.
+10
View File
@@ -1,7 +1,17 @@
# Decisions
* [PR pipeline layering](pr-pipeline-layering.md) - What runs pre-commit, what runs in Gitea Actions, what the AI review does, and the cost rule that decides.
* [PR-Agent for Gitea reviews](pr-agent.md) - A pinned webhook server replaces the per-PR opencode job; internal-only, scoped bot, OpenCode Go model.
* [AI review setup (opencode)](ai-review-setup.md) - Superseded 2026-10-30; kept for the env-only auth and verdict-gate reasoning.
* [Vulnerability audit policy](vulnerability-audit-policy.md) - Blocking audit, reviewed ignore-list for unfixable advisories, and the pnpm-11 settings home.
* [Release engineering](release-engineering.md) - release-please in manifest mode, conventional commits as input, message format enforced at commit time.
* [Snyk paused and secrets policy](snyk-paused-and-secrets-policy.md) - Why the job is skipped rather than deleted, and the token scopes every workflow secret needs.
* [Publishing images to the own registry](registry-publishing.md) - A release tag builds and pushes to git.noelsabia.dev; main pushes do not build.
* [Dev container shape](dev-container-shape.md) - The source is bind-mounted into a container that already holds the dependencies, and the dev server runs as the image's `node` user.
* [Build layer order](build-layer-order.md) - Why the manifests are copied before the source, and what invalidates what.
* [Build context filter](build-context-filter.md) - What `.dockerignore` may exclude, and the one thing it must never exclude.
* [Production image shape](production-image.md) - Multi-stage, digest-pinned, non-root runnable Node server; measured build and serve.
* [Repository and compose layout](repo-and-compose-layout.md) - The Dockerfiles live with the app; the stack is assembled in `Local_Development`.
* [Mockup layout](mockup-layout.md) - One `DESIGN.md` per screen, with the screenshot and the source embedded.
* [Icons via Nuxt Icon](icons-via-nuxt-icon.md) - Every icon comes from `@nuxt/icon` with the Material Symbols collection installed locally; the 3.9 MiB icon webfont is gone and three icons cost 1.23 kB.
* [SEO stack and site metadata](seo-and-metadata.md) - One `site.config.mjs` feeds canonical URLs, sitemap, robots, schema.org and the static OG card; the dynamic OG renderer and skew protection stay off.
+119
View File
@@ -0,0 +1,119 @@
---
type: Decision
title: PR-Agent for Gitea reviews
description: A pinned PR-Agent service inside the Gitea compose stack reviews pull requests through a scoped Gitea bot user, replacing the per-PR opencode job.
tags: [decision, ci, ai, gitea, pr-agent, security]
status: draft
generated: { by: opencode-go/deepseek-v4.1-flash, at: 2026-10-30T20:00:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: gitea-compose
resource: /home/noel/self-hosted/gitea/docker-compose.yml
title: Gitea compose stack, pr-agent service
- id: operations
resource: OKF_Nuxt/pr-agent.md
title: PR-Agent operations and configuration
- id: pr-checker
resource: .gitea/workflows/pr-checker.yml
title: PR Check workflow, opencode job removed
- id: install
resource: https://docs.pr-agent.ai/installation/gitea/
title: PR-Agent Gitea installation
- id: images
resource: https://hub.docker.com/r/pragent/pr-agent
title: Published gitea_app image tags
- id: gitea-egress
resource: https://docs.gitea.com/administration/config-cheat-sheet#webhook
title: Gitea webhook egress allowlist
---
# Decision
PR-Agent runs as `pragent/pr-agent:0.49.0-gitea_app` in a long-lived
container on `server0`, as the `pr-agent` service in the Gitea compose
stack. It attaches to the existing `gitea_gitea` Docker network and
publishes no ports. Gitea delivers pull-request and comment events to
`http://pr-agent:3000/api/v1/gitea_webhooks`; the bot user `pr-agent`
posts the result with a scoped personal access token. The service
definition lives in `/home/noel/self-hosted/gitea/docker-compose.yml`; the
operator guide is [PR-Agent operations](../pr-agent.md).
The opencode review job is removed from `pr-checker.yml`. PR-Agent runs
`/describe` and `/review` on pull request open/reopen and answers slash
commands in the conversation. Push-triggered re-review is disabled, so a
PR is reviewed once when it opens, not on every push.
The model is OpenCode Go's OpenAI-compatible endpoint:
```text
model openai/glm-5.3-flash
fallback openai/glm-5.3
api base https://opencode.ai/inference/go/openai/v1
```
`CONFIG__CUSTOM_MODEL_MAX_TOKENS=128000` supplies the context limit the
model table does not know; PR-Agent's default `config.max_model_tokens`
still caps the review budget at 32000.
OpenCode Go requires an `x-opencode-session` header. PR-Agent sends the
stable id `pr-agent` through `LITELLM__EXTRA_HEADERS`; without it the
provider rejects the request before it reaches the model.
# Why
* One container replaces a per-PR CLI install, binary cache and prompt
wrapper. The review path is then the same code for every PR.
* PR-Agent owns the Gitea webhook and comment plumbing, including the slash
commands (`/review`, `/improve`, `/ask`) the repository previously had no
way to trigger.
* The webhook endpoint stays on the Docker network. Nothing new is exposed
to the internet, and comment links still use the public Gitea URL.
* The image tag is pinned. A new PR-Agent release is a deliberate change,
not a rollout underneath the repository.
# Gitea configuration
* Bot user `pr-agent` is a collaborator with write permission on
`CV_Website/CV_Site_Nuxt`. The token scopes are `read:repository`,
`write:issue` and `read:user`. Gitea has no comment-only collaborator
role, so write is the narrowest role that can post comments and labels.
* `[webhook] ALLOWED_HOST_LIST = private:3000` is required: Gitea's default
lax egress policy allows public targets but refuses private ones, and the
webhook target is a Docker-network address. The API is reached at
`http://gitea:3000`; `GITEA__WEB_URL=https://git.noelsabia.dev` keeps
published links on the public host.
* The webhook sends `push`, `issues`, `pull_request` and `issue_comment`
events. Only the last two change behaviour today; `push` is kept because
PR-Agent may handle push commands in a later configuration.
* Auto commands are `/describe` and `/review`. `/improve` stays available
on demand; the default auto list would add a second model call and a
second comment to every PR.
* Secrets live only in `/home/noel/self-hosted/gitea/pr-agent.env` (mode
600) on `server0`. The repository contains the decision and the operator
guide, never the token, webhook secret or model key.
# Evidence
* 2026-10-30: a direct `glm-5.3-flash` call through the handler returned
`OK`, and `/review` on PR #28 posted a PR Reviewer Guide through the Gitea
comment API. The key is set only in `gitea/pr-agent.env`.
# Not verified
* Whether the model finds the same class of issues as the opencode prompt on
larger diffs. The first review found none; `glm-5.3` remains the fallback.
* Whether two gunicorn workers and the 1 GB memory limit hold under
concurrent reviews. The host has roughly 2.5 GB available with Gitea and
its runner idle.
* Whether the default review prompt is specific enough for this repository.
A `.pr_agent.toml` with project instructions is deliberately absent until
a real review shows what it misses.
# Revisit when
* The first review fails, returns unstructured output, or misses the kind
of finding the opencode prompt used to catch.
* A newer `gitea_app` image tag is worth taking; bump the tag in the Gitea
compose file and run `docker compose up -d pr-agent` from that directory.
* Review volume makes the container's memory limit tight, or Gitea adds a
role that can comment without push access.
@@ -0,0 +1,97 @@
---
type: Decision
title: PR pipeline layering
description: Three layers - pre-commit hooks for cheap deterministic checks, Gitea Actions for thorough checks, an AI reviewer for judgment - and the rule that decides what runs where.
tags: [decision, ci, gitea-actions, pre-commit, security]
status: draft
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T16:05:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: pr-checker
resource: .gitea/workflows/pr-checker.yml
title: PR Check workflow
- id: pre-commit
resource: .pre-commit-config.yaml
title: Pre-commit guardrails
---
# Decision
Every pull request is checked by three layers, ordered by cost:
1. **Pre-commit hooks** (local, seconds, deterministic): gitleaks, file
hygiene, conventional-commit check, actionlint, eslint --fix on staged
files. A commit that fails here never exists.
2. **Gitea Actions** (per PR push, minutes): ESLint + vue-tsc typecheck
in one job (one install, cached pnpm store), gitleaks over full
history, pnpm audit (blocking), droast Dockerfile lint, Snyk
(currently disabled).
3. **AI code review** (on PR open, or on a slash command): the PR-Agent
webhook server, posted as a PR comment.
The split rule: anything that finishes in seconds and auto-fixes goes in
pre-commit; anything slow, network-bound or quota-bound goes in CI; anything
that produces judgment rather than a pass/fail is the AI review. Nothing
slow lives in pre-commit — one slow hook gets bypassed with `--no-verify`
once and is dead weight forever.
# Why
Each layer catches what the previous one cannot. Pre-commit sees the commit
before it exists; CI sees the whole PR on a clean machine; the AI review
sees intent, contracts and cross-file consequences that no linter can. The
ordering also protects the budget: the AI review only runs for code that
already passed the deterministic gates.
# Caching
One cache, served by the runner's own cache server (no external service,
entries stay on the home server):
* **pnpm store**, keyed on the store layout version (v11) and a `sha256sum`
of `pnpm-lock.yaml`. Installs hardlink from the store instead of
downloading tarballs again. The key is built in a shell step because
`hashFiles()` evaluates empty in this act runner.
The opencode binary cache is gone with the opencode job. PR-Agent is a
long-running container on `server0`, so a review no longer downloads a CLI.
Lint and typecheck also share one job: same image, same lockfile, same
install. Splitting them duplicated the install and made both compete for
the runner's two vCPUs. A future `pnpm build` job reuses the same store
cache key.
# What the pipeline bought us in practice
Recorded so the reasoning survives: during the first week the pipeline
caught leaked secrets in history (gitleaks), a review model configured
against the wrong provider account, a Dockerfile-lint job that silently
never ran (`hashFiles` evaluating empty in the act runner), a review that
completed but exited non-zero, and an attacker-relevant credential
exposure in the review setup — each fixed where it was cheapest.
# Failure modes deliberately designed against
The opencode-specific rows are historical since the review moved to
[PR-Agent](pr-agent.md); they are kept because the failure classes still
apply to any review implementation.
| Failure seen | Guard now in place |
|---|---|
| Error logs posted as review comments | Posting gate is the output contract (a `VERDICT:` line), not the exit code |
| Vendor container images without arm64 manifests | Binaries installed arch-aware in `node:22-bookworm`, never vendor CI images |
| `hashFiles()` silently empty in the act runner | File discovery via `find` and cache keys via `sha256sum`, both in shell steps - never workflow expressions |
| Silent advisory failures | `continue-on-error` removed everywhere; a failed check is red |
| Supply-chain (curl-piped binaries) | Pinned versions, checksums pinned in the workflow |
# Not verified
* That the Snyk job still works when re-enabled — it was disabled while
the free quota was the binding constraint.
* That the pipeline behaves on Gitea runner versions other than v0.6.1.
# Revisit when
* A second repository needs the same pipeline (extract a reusable
workflow include).
* The Go plan's usage limits are hit by review traffic.
+57
View File
@@ -0,0 +1,57 @@
---
type: Decision
title: Production image shape
description: The production Dockerfile is a runnable Node server for the SSR app - multi-stage, digest-pinned base, non-root, healthchecked.
tags: [decision, docker, nuxt, production]
status: stable
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T19:10:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: dockerfile
resource: Dockerfile
title: Production Dockerfile
- id: droast
resource: .gitea/workflows/pr-checker.yml
title: Dockerfile lint job (droast)
---
# Decision
`Dockerfile` builds the production image as a **runnable Node server**:
* Stage `build`: manifests first, `pnpm install --frozen-lockfile
--ignore-scripts`, then the full source, then `pnpm build` - Nitro emits a
self-contained `.output/server/index.mjs` with its traced dependencies.
* Stage runtime: only `.output` is copied (chowned to `node`), the process
runs as the image's non-root `node` user, the base image is the same
digest-pinned `node:26-slim` as the dev container, and a `HEALTHCHECK`
(node's own fetch, no curl in slim) polls the root path.
This answers the previously open question "runnable Node server, or static
files embedded in the gateway". The static-in-gateway plan recorded in the
sibling `OKF_CV_Website` bundle predates the SSR reality of this repository:
the gateway must now **proxy to this server** instead of embedding
`.output/public/`. That sibling decision needs updating; the compose wiring
is still open.
# Why `--ignore-scripts`
The `postinstall` script (`nuxt prepare`) runs before the source is copied
and would fail. `nuxt build` prepares everything it needs itself. Native
binaries (esbuild, unrs-resolver) come from platform-specific optional
packages, not install scripts, so skipping scripts loses nothing.
# Verified (measured, 2026-10-18)
* `docker build` on x86_64: full build succeeds in-image ("Build complete").
* `docker run`: HTTP 200 on `/` (28 KB page), process runs as
`uid=1000(node)`, healthcheck reports `healthy`.
* droast 1.7.0 (sha-verified): 0 errors; one accepted DF007 warning on
`COPY . .` - that line *is* the source-last layer design.
* arm64 correctness rests on the multi-arch digest pin (proven in CI for
the dev container); the image build itself has only run on x86_64.
# Revisit when
* The gateway/compose stack is assembled (proxy target, port, network).
* A `go` preset or full-static `nuxt generate` becomes preferable.
+194
View File
@@ -0,0 +1,194 @@
---
type: Decision
title: Publishing images to the own registry
description: A release tag builds the production image and pushes it to git.noelsabia.dev, because that is the only way Kubernetes can pull it.
tags: [decision, ci, docker, registry, gitea-actions]
status: draft
generated: { by: opencode-go/deepseek-v4.1-flash, at: 2026-10-24T00:00:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: workflow
resource: .gitea/workflows/publish-image.yml
title: Publish image workflow
- id: dockerfile
resource: Dockerfile
title: Production Dockerfile
- id: k8s
resource: ../OKF_CV_Website/architecture/delivery.md
title: Sibling bundle - image tags and registry pull
---
# Decision
**The registry is Gitea's own, served on the Gitea host.** Gitea ships a
built-in container registry per owner/organisation
([docs.gitea.com - container](https://docs.gitea.com/usage/packages/container/)).
The endpoint is the Gitea hostname itself - `git.noelsabia.dev` - and the
`/cv_website/` path segment is the Gitea organisation; images live under
the package of the repository that pushed them:
```
docker login git.noelsabia.dev
git.noelsabia.dev/cv_website/nuxt:<tag>
```
There is nothing to stand up and nothing to reinvent: no separate
Registry/Harbor deployment, no extra hostname, no extra certificate.
TLS and auth are the ones Gitea already serves. The publishing workflow
exists only to automate pushes to this built-in registry.
**Corrected 2026-10-31:** `registry.noelsabia.dev` was a separate
hostname set up before this was known. It is not needed and is being
removed on the server side; this repository now uses
`git.noelsabia.dev` everywhere. Any leftover `registry.noelsabia.dev`
reference is a bug.
`.gitea/workflows/publish-image.yml` builds `Dockerfile` and pushes the
result to the own registry:
```
git.noelsabia.dev/cv_website/nuxt:v1.2.3
git.noelsabia.dev/cv_website/nuxt:sha-<12-char-sha>
git.noelsabia.dev/cv_website/nuxt:latest # newest release only
```
**Trigger is the release tag, not the main push.** release-please creates
`vX.Y.Z` when the release PR is merged ([release
engineering](release-engineering.md)); that tag push is the build. A main
push would otherwise publish commits that no release describes, and
`latest` would move on work in progress.
# Why not build on every main push
* The registry is the deployment channel. Every image in it should answer
"which release is this", and a tagged commit does.
* The runner has capacity 1 and shares 2 vCPU / 4 GB with Gitea and k3s
(`OKF_CV_Website/architecture/server-budget.md`). A Nuxt image build can
take over 1 GB; running it more often than a release buys nothing.
* The PR checks already gate the code that becomes a release. A tag build
is not the first time the tree is built - a failing build here is a
packaging failure, not a surprise.
# Why docker-outside-of-docker
The job runs in `node:22-bookworm`, like every other job in this
repository, and only needs the Docker client: `docker build` sends the
build context over the socket, so the daemon never reads the container's
filesystem. That requires the act_runner to mount its host socket:
```yaml
# act_runner config.yaml
container:
docker_host: automount
```
Without it the `Check daemon access` step fails first with a named cause
instead of a mid-build error. The alternative - a privileged `docker:dind`
sidecar - needs privileged mode and a second daemon per release; not worth
it on this server.
## Trust boundary (the cost of the socket)
A mounted Docker socket is **root-equivalent on the host**: any job that
has it can run `docker run -v /:/host` and read or write anything, which on
this machine means Gitea's data, k3s, and the CV itself. `docker_host` is a
**runner-wide** setting, so enabling it gives the socket to every job on
that runner, including PR jobs whose code comes from a branch.
Therefore the rule: **the socket only ever goes on a runner label that
PR-triggered jobs do not use.**
The workflow follows it by scheduling onto a dedicated label:
```yaml
runs-on: publish # NOT ubuntu-latest, which pr-checker.yml uses
```
That label only exists once a second act_runner registration is configured
with `container.docker_host: automount` and, for example,
`--labels publish:docker://node:22-bookworm`. Until then the job queues
without starting, and `timeout-minutes` does not apply to a job that never
starts - register the runner before the first release tag.
Not acceptable: adding `automount` to the shared `ubuntu-latest` runner.
That hands PR code a root-equivalent socket on the host that also runs
Gitea and k3s. If it is ever the only option, treat it as an accepted risk
and record it here rather than letting the workflow imply it.
# Why `--platform linux/arm64`
The runner and the node are the same arm64 machine, so the build is native
(no QEMU, no crossed dependencies). Stating the platform makes a build on
another architecture fail instead of publishing an image the node cannot
run.
# Secrets
| Gitea secret | Use |
|---|---|
| `REGISTRY_USERNAME` | basic-auth user for `docker login git.noelsabia.dev` |
| `REGISTRY_PASSWORD` | basic-auth password (or token) for the same login |
Both are repo secrets. The login uses `--password-stdin` so the value never
appears in the process list or the log.
# Before the first release tag
1. Repo secrets `REGISTRY_USERNAME` and `REGISTRY_PASSWORD` exist.
2. A runner with the `publish` label exists and its config has
`container.docker_host: automount`. Without the label the job queues
forever; without the socket it fails at `Check daemon access`.
3. `pr-checker.yml` still runs on a label whose runner has no socket.
4. Namespace `cv` has an `imagePullSecret` for the same credentials.
5. `git.noelsabia.dev` answers over HTTPS.
# Guards in the workflow
| Guard | Why |
|---|---|
| Strict `^vMAJOR.MINOR.PATCH$` check | A `v[0-9]*` prefix match accepts `v1`, `v1-anything` and `v1.2.3-rc1`, all of which are valid registry tags and would publish silently |
| `latest` only when the built tag is the highest `vX.Y.Z` in the repository | Gitea can replay any run. Without the comparison, re-running `v1.2.0` after `v1.3.0` drags `latest` backwards. A re-run of the newest tag still moves it - that release had not produced an image yet. If the tag list cannot be fetched, `latest` is skipped with a warning rather than guessed |
| A published version tag is never overwritten | Before building, the registry's v2 API is asked for `manifests/<version>`: `200` aborts the run, `404` continues. A replay of a released tag fails instead of silently replacing published content. `docker manifest inspect` is deliberately *not* used - the Debian 20.10 client fails it on OCI indexes with `unsupported manifest media type and no default available`, for existing and missing tags alike |
| Smoke test before any push | The image is started and must answer 2xx with at least 10 kB of rendered HTML on `/` (the real page is ~97 kB), so "200 but nothing rendered" fails too. Port publishing is not usable here: the daemon binds on the host, not in the job container |
| `timeout-minutes: 20` | A hung build would hold the capacity-1 runner and every job queued behind it |
| `.github/actionlint.yaml` | Declares the custom `publish` label, otherwise the lint hook reports it as unknown. The hook passes the file with `-config-file`, because actionlint only auto-loads it when it recognises a `.github/workflows` project |
# Costs and consequences
* **Registry storage grows** by one image per release in three tags. The
three tags share layers, so the extra cost is mostly the tag, not the
bytes.
* **Images accumulate on the runner's daemon** (`sha-`, version and
`latest` tags). Pruning is not part of this change; add a
`docker image prune` policy when the disk usage actually matters.
* **`latest` is a convenience, not a pin.** Manifests should reference the
version or SHA tag so a release rollback is a manifest edit.
* **k3s needs pull credentials**: an `imagePullSecret` in the namespace for
the same basic-auth pair, or `/etc/rancher/k3s/registries.yaml` if the
registry is ever plain HTTP. Not part of this workflow.
# Not verified
* That the runner has the host socket mounted (`docker_host: automount`) -
the workflow's first step answers this on the first release.
* That the arm64 build succeeds: `Dockerfile` has been built on x86_64
only ([production image](production-image.md)).
* That the smoke test passes on arm64. The same script was run against an
x86_64 build of the merged tree and answered 2xx; the arm64 run is the
first release.
* That `git.noelsabia.dev` is reachable over HTTPS from the runner.
A plain-HTTP endpoint fails `docker login` with `server gave HTTP
response to HTTPS client` and needs `insecure-registries` on the daemon
plus `registries.yaml` on k3s.
* Whether Gitea runs a `pull_request` workflow from a fork without
maintainer approval on this instance. That answer decides how severe the
socket risk above really is.
# Revisit when
* A second image (the Go gateway or chapter service) needs publishing -
then the workflow grows a matrix instead of being copied.
* Deploys should follow automatically: the release workflow gains a
`kubectl set image` step, or manifests start referencing the SHA tag.
* Multi-arch becomes necessary (a laptop or a CI host of the other
architecture pulls the image).
+198
View File
@@ -0,0 +1,198 @@
---
type: Decision
title: Release engineering
description: Releases are produced by release-please in manifest mode, driven by conventional commits, with the message format enforced at commit time by commitizen.
tags: [decision, release, release-please, ci]
status: draft
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T16:05:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: config
resource: release-please-config.json
title: release-please configuration
- id: manifest
resource: .release-please-manifest.json
title: release-please manifest
- id: workflow
resource: .gitea/workflows/release-please.yml
title: release-please workflow
- id: reconcile
resource: scripts/reconcile-release-please.mjs
title: release-please state reconciliation
---
# Decision
On every push to `main`, release-please (manifest mode) collects
conventional commits, derives the next version, and opens a release PR
that bumps `package.json`, updates `CHANGELOG.md` and moves the manifest
forward. Merging that PR creates the release. The message format that
feeds this machine is enforced locally by the commitizen pre-commit hook.
# Why
* **Manifest mode** (config JSON + manifest JSON) over inline
`release-type` in the workflow: the configuration becomes part of the
repository, reviewable in PRs, instead of buried in workflow YAML.
* **Plain tags** (`v1.0.0`, `include-component-in-tag: false`):
single-package repository; component-prefixed tags would be noise.
* **A `version` field in `package.json`**: the `node` release type reads
it; without the field the release machinery cannot track anything.
* **Enforcement at commit time**: a non-conventional message is not an
error release-please reports — it just silently produces no release.
Commitizen turns that silent failure into a blocked commit.
# How a release happens, end to end
1. Work lands on branches as conventional commits (`feat:`, `fix:`,
`chore:`, …), enforced by the local hook.
2. Merge to `main` → release-please opens/updates a release PR
(`chore(main): release …`).
3. Merge the release PR → version bumped, changelog written, tag
`vX.Y.Z` created.
# The label is load-bearing (2026-10-24)
Steps 2 and 3 are connected by a label, not by the merge alone:
* release-please creates the release PR with `autorelease: pending`;
* on the next run it lists merged PRs and keeps only those carrying that
label; those are the releases it tags.
Gitea resolves label **names** in `POST /issues/{index}/labels` with
`GetLabelIDsInRepoByNames`, which is a SQL `IN` filter: names that do not
exist are dropped **without an error**. A repository with no labels
therefore accepts the call, returns 200, and attaches nothing.
That is exactly what happened here: PRs #20 and #21 were merged as release
PRs with no label at all, so every run found zero merged release PRs,
created zero tags, and opened the next release PR instead — while reporting
success. Three release PRs, no tags.
The workflow now creates both labels (`autorelease: pending`,
`autorelease: tagged`) before the action runs. Idempotent: it reads the
label list and creates only what is missing.
# The head branch must survive the merge (2026-10-27)
The label fix was necessary but not sufficient. PR #22 carried
`autorelease: pending` when it was merged, and the run after it still
created no tag. From its log (task 475):
```
❯ Found pull request #22: 'chore: release main'
✖ Bad branch name: refs/pull/22/head
⚠ Expected 1 releases, only found 0
```
Gitea rewrites a merged PR's `head.ref` to `refs/pull/<n>/head` once the
head branch is deleted; the branch name survives only in `head.label`.
The Gitea build of release-please reads `head.ref`
(`BranchName.parse(mergedPullRequest.headBranchName)`, bundled at
`dist/index.js:15288`) and abandons the release when it is not a release
branch. GitHub keeps the branch name there, which is why the plugin's
assumption holds on GitHub and not here.
The repository deleted the head branch of every merged PR
(`default_delete_branch_after_merge: true`). It is `false` now, and a
release PR must be merged with its branch kept. The mechanism was
confirmed by comparison, not inference: while `fix/release_please` still
existed, PR #23 reported `head.ref = fix/release_please`; every PR whose
branch was gone reported `refs/pull/<n>/head`.
# A pending label outlives the branch and blocks every later release (2026-10-31)
Flipping `default_delete_branch_after_merge` to `false` only protects
branches deleted *after* the change. PR #22's branch was already gone, so
its `head.ref` stayed `refs/pull/22/head` and its `autorelease: pending`
label stayed attached. Run 143 (task 475, 2026-10-27, the run immediately
after #22 merged) shows the full deadlock:
```
❯ Found pull request #22: 'chore: release main'
✖ Bad branch name: refs/pull/22/head
...
✔ Building candidate release pull request for path: .
❯ Found pull request #22: 'chore: release main'
⚠ There are untagged, merged release PRs outstanding - aborting
::set-output:: prs_created=false
::set-output:: releases_created=false
```
The first block fails the tagging phase. The second finds the same
still-pending PR and aborts the propose phase, so no new release PR is
even opened. Every later run (145, 148, 151, 153, 162, 164, 167) has the
same shape. The hand-created `v1.4.0` tag restores the baseline (`found:
v1.4.0`) but does not clear the label, so it does not break the
deadlock. This is the current reason the pipeline is still healthy-looking
and tagless.
The workflow now reconciles that state before the action runs
(`scripts/reconcile-release-please.mjs`):
* merged + `autorelease: pending` + a tag already at the merge commit ->
replace the label with `autorelease: tagged`;
* merged + `autorelease: pending` + head branch gone + no tag -> create
the tag from the version recorded in the manifest at the merge commit
(the exact tag release-please would have made), then swap the label;
* merged + `autorelease: pending` + head branch still present -> leave
it; release-please tags it in the same run.
The step is idempotent and runs on every push to `main` and every manual
dispatch, so a deleted branch cannot silently poison the release pipeline
again. #20 and #21 are not labelled pending, so they do not block; their
tags remain the one-time manual recovery in the table below.
Two details keep the reconciliation from suppressing a real release:
* pending PRs are fetched through the `autorelease: pending` label filter,
not by paging every closed PR, so concurrent PR closes cannot shift a
page and hide one;
* a tag at the merge commit counts only when its name is exactly
`v<manifest version>`. A CI or annotation tag on the same commit is
logged and ignored, and the release tag is still created.
# Recovering the versions that never got a tag
The label alone cannot recover them — #20, #21 and #22 all lost their head
branch, so release-please skips them for the reason above. Creating those
tags is a one-time manual step:
| Version | Merge commit |
|---|---|
| `v1.1.0` | `67cf232` (#12) |
| `v1.2.0` | `4e8aa28` (#20) |
| `v1.3.0` | `08eb042` (#21) |
| `v1.4.0` | `0c937e6` (#22) |
`v1.0.0` is the bootstrap changelog entry from the configuration commit
`c89747e` (2026-10-18); no release PR produced it.
The manifest moved to 1.4.0 without any tag existing, so until a tag is
present release-please has no baseline: it reported "No latest release
found for path: ., component: , but a previous version (1.4.0) was
specified in the manifest" and would compute the next release from the
whole history.
# Not verified
* That the release phase tags correctly once the head branch survives a
merge. The next release cycle proves it.
* That the reconcile step's tag-creation fallback works with a live
token. Only the tag-already-exists path was exercised, in dry-run,
against the live PR #22. The fallback is written from the same Gitea
API shapes (`POST /tags`, `PUT /issues/{index}/labels`) the rest of the
workflow uses.
* That `RELEASE_PLEASE_TOKEN_CV_SITE_NUXT` carries the `write:issue`
scope the same way `PR_GITEA_TOKEN` needed it; the previous failure
was an immediate API rejection consistent with a scope problem.
# Revisit when
* A second package appears in the repository (then
`include-component-in-tag` and `separate-pull-requests` matter).
* A release must trigger a deploy — the workflow gains a step after
`release_created` is set.
* The label step breaks: if Gitea ever starts rejecting unknown label
names, the `Ensure release-please labels exist` step will fail loudly
instead of silently, which is the point.
+98
View File
@@ -0,0 +1,98 @@
---
type: Decision
title: SEO stack and site metadata
description: @nuxtjs/seo owns canonical URLs, sitemap, robots, schema.org and social tags; metadata lives in one ESM file, the OG card is a committed PNG, and the dynamic OG renderer and skew protection stay off.
tags: [decision, seo, metadata, nuxt, static]
status: stable
generated: { by: opencode-go/deepseek-v4.1-flash, at: 2026-10-23T00:00:00Z }
verified: { by: human:noel, at: 2026-10-23T00:00:00Z }
sources:
- id: config
resource: nuxt.config.ts
title: site, schemaOrg, ogImage and skewProtection options
- id: metadata
resource: site.config.mjs
title: Single source for URL, name, role, description, locale, email, GitHub
- id: page
resource: app/pages/index.vue
title: Page title and Twitter card type
- id: generator
resource: scripts/generate-og-image.mjs
title: OG card generator
- id: package
resource: package.json
title: "@nuxtjs/seo, Node engines, og-image script"
---
# Decision
`@nuxtjs/seo` 6.0.1 is registered as one module; it brings sitemap, robots,
OG Image, schema.org, link checker, SEO Utils, site config, AI Ready and skew
protection. The site's own values live in `site.config.mjs`:
```js
export const SITE = {
url: 'https://noelsabia.dev',
name: 'Noel Sabia',
role: 'Programmer, AI Assisted Coder, Arch user',
description: '…',
locale: 'en',
email: 'noel@noelsabia.dev',
github: 'https://github.com/NoelSabia',
}
```
`nuxt.config.ts` maps that into `site` (URL, name, description, locale) and
`schemaOrg.identity` (`Person`, with `jobTitle`, `email`, `sameAs: [GitHub]`).
`app/pages/index.vue` sets the title to `<name> — <role>` and
`twitter:card: summary_large_image`; `useHead({ titleTemplate: '%s' })` stops
SEO Utils from appending `| Noel Sabia` to the title it already contains.
# Why a static OG card
`public/og-image.png` (1200×630) is generated from the same pixel avatar as the
favicon, plus the name and role. It is committed. `ogImage: false` disables the
dynamic module, so no Takumi/Satori renderer, native binary or runtime image
route is added; SEO Utils still emits `og:image`, `twitter:image`, their
`width`/`height`/`type` tags, and the alt text from `og-image.alt.txt`.
Regenerate with `pnpm og-image`. That script needs `woff2_decompress` and
`rsvg-convert` on the machine because librsvg cannot read the self-hosted woff2
files; the output is committed, so builds and deploys need neither tool.
# Other settings
| Option | Value | Reason |
|---|---|---|
| `skewProtection` | `false` | The site ships as static files inside the gateway image; there are no old chunks to keep and the CI starts from a clean checkout, so the cache would be empty. Avoids an extra service worker. |
| `engines.node` | `^22.22.3 \|\| ^24.15.0 \|\| >=26.0.0` | `@nuxtjs/seo` 6 refuses to boot on older Node. Docker uses `node:26-slim`; CI uses `node:22-bookworm`, which tracks the latest 22.x. |
Robots, sitemap and AI Ready keep their defaults: `robots.txt` allows all
crawlers and appends `Sitemap: https://noelsabia.dev/sitemap.xml`;
`sitemap.xml` is generated from the routes (only `/` today); `/llms.txt`,
`/llms-full.txt` and Markdown versions of pages are produced by AI Ready.
# Consequences
* `site.url` is the canonical origin. Every environment serves the production
URLs; a staging deploy must set `NUXT_SITE_ENV=staging` so robots and the
`X-Robots-Tag` header block indexing.
* Adding a page needs no SEO config: canonical, OG basics and sitemap entry
follow the route. Give it a title with `useSeoMeta` and the default
`| Noel Sabia` suffix returns unless it sets `titleTemplate` too.
* `nuxt generate` writes `robots.txt`, `sitemap.xml`, `llms.txt`, the Markdown
pages and the static OG card into `.output/public`.
# Not verified
* How the card looks in a real LinkedIn, X or WhatsApp preview; the PNG was
checked locally at full size.
* Crawling in Google Search Console — the domain is not live yet.
# Revisit when
* There are several pages and one shared card is no longer enough: enable
Takumi with `npx nuxt-og-image enable takumi` and replace `ogImage: false`
with a template.
* German is actually translated: add `@nuxtjs/i18n` instead of listing `de` in
`defaultLocale`, which must stay a single language tag.
@@ -0,0 +1,51 @@
---
type: Decision
title: Snyk paused, quotas and secrets policy
description: The Snyk job stays in the workflow but is disabled via `if: false` - the free plan quota was the binding constraint - and every Gitea token secret must carry the write:issue scope.
tags: [decision, security, ci, snyk]
status: draft
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T16:05:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: pr-checker
resource: .gitea/workflows/pr-checker.yml
title: PR Check workflow, snyk job
---
# Decision
1. The Snyk job remains in `pr-checker.yml` with `if: false` — skipped,
not deleted. All the arm64/npm-CLI engineering is preserved for the
day it is re-enabled.
2. When re-enabled, it should not run on every push; a schedule or a
ready-for-review gate fits the quota better.
3. Gitea API tokens used by workflow secrets must have `issue`
read+write **and** `repository` read+write, and must not be
public-only. One well-scoped token serves both the AI review comment
posting and release-please.
# Why
* The Snyk free plan grants a small monthly test budget; the pipeline
would burn two tests per PR push. The job failed on its first runs for
two independent reasons (an amd64-only container image, then the
workspace-detection error) before the quota question even arose — the
pause is about quota, the fixes are about portability.
* The `write:issue` scope was discovered the hard way: posting a PR
comment goes through Gitea's issues API, and a token with only
`write:repository` fails with HTTP 403 naming the missing scope. The
error text is the diagnostic — the comment-posting step now prints
status code and response body on failure instead of `curl -sf`
silence.
# Not verified
* Whether the current `RELEASE_PLEASE_TOKEN_CV_SITE_NUXT` value carries
the correct scopes — its failure signature suggested it did not.
# Revisit when
* The quota constraint changes (paid tier, or a schedule-based scan
makes the budget predictable).
* Gitea adds fine-grained token scopes that separate "comment on PR"
from "write issues".
@@ -0,0 +1,75 @@
---
type: Decision
title: Vulnerability audit policy
description: The dependency audit blocks the pipeline, with an explicit reviewed ignore-list for advisories that have no patched release - the list lives in pnpm-workspace.yaml, because pnpm 11 no longer reads the pnpm field in package.json.
tags: [decision, security, ci, audit, pnpm]
status: draft
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T19:10:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: workspace
resource: pnpm-workspace.yaml
title: auditConfig.ignoreGhsas
- id: audit-job
resource: .gitea/workflows/pr-checker.yml
title: Dependency audit job
---
# Decision
`pnpm audit --prod --audit-level moderate` stays **blocking** (no
`continue-on-error`). Advisories that cannot be fixed by upgrading are not
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 (verified against the advisory database and the npm
registries on 2026-10-31):
* `GHSA-vfj7-8cjw-p6xm` - braces <= 3.0.3, high. Path:
`nitropack > globby > micromatch > braces` - globbing during build, no
attacker-controlled patterns at runtime.
* `GHSA-g3hv-75wg-m249` - minimatch < 11.0.1, moderate. The patch
(11.0.1) dropped the `makeRe` export that `eslint-plugin-import-x`
imports, so forcing it breaks `pnpm lint` with "does not provide an
export named 'makeRe'"; it also breaks ESLint's config loader. All
affected paths are build/lint-time (Nitro, i18n, ESLint via
vite-plugin-checker), never in the running server.
The 2026-10-31 round also upgraded `nuxt` 4.6.2 -> 4.6.3 (fixes the Nuxt
dot-segment, dev-server and appSecret advisories) and added overrides for
`node-forge: 1.4.1` (the old node-forge ignore, `GHSA-86w9-cpqp-85rv`,
is gone - a patch now exists) and `glob: 14.0.2` for
`GHSA-3g3m-2fjr-6pw4` (scoped to `>=9.0.0 <=14.0.1` so
tailwind-config-viewer keeps glob 7).
# Why
A red job that can never go green trains everyone to ignore red - the same
silent-failure outcome "nothing fails silently" exists to prevent. The
ignore list is the opposite of silence: the audit still names what it
skipped ("1 ignored: 1 high") and the decision lives in a reviewable file.
# The pnpm 11 lesson
The first attempt put `auditConfig` under the `pnpm` field in
`package.json`. pnpm 11 warned and **ignored it** - settings moved to
`pnpm-workspace.yaml` (same reason the config-only workspace file needed
pnpm 11 in the first place). The warning was caught locally before pushing
by running the exact CI command.
# Revisit when
* A patched version ships for either package - remove the entry.
* A new advisory appears with a real patch - fix it by upgrading; the audit
gate does the enforcement.
* Snyk is re-enabled (its SAST/DAST scope is different; see
[snyk-paused-and-secrets-policy](snyk-paused-and-secrets-policy.md)).
+75
View File
@@ -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.
+39
View File
@@ -4,13 +4,52 @@ okf_version: "0.2"
# Start here
This bundle explains the Nuxt repository: how it is developed, checked,
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, metrics, knockdown, events.
* [Profile data](profile.md) - The LinkedIn export behind the terminal chapters, what is real vs mock, and how to refresh it.
* [PR-Agent operations](pr-agent.md) - The Gitea-side review service: configuration, commands, logs and model.
* [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
## CI/CD and releases (2026-10-18)
* [PR pipeline layering](decisions/pr-pipeline-layering.md) - Three layers: pre-commit for cheap deterministic checks, Gitea Actions for thorough ones, AI review for judgment.
* [PR-Agent for Gitea reviews](decisions/pr-agent.md) - A pinned review service inside the Gitea compose stack replaces the per-PR opencode job; internal-only, scoped bot, OpenCode Go model.
* [AI review setup (opencode)](decisions/ai-review-setup.md) - Superseded 2026-10-30; kept for the env-only auth and verdict-gate reasoning.
* [Vulnerability audit policy](decisions/vulnerability-audit-policy.md) - Blocking audit; reviewed ignore-list for unfixable advisories in pnpm-workspace.yaml.
* [Release engineering](decisions/release-engineering.md) - release-please in manifest mode; conventional commits enforced at commit time.
* [Snyk paused and secrets policy](decisions/snyk-paused-and-secrets-policy.md) - Quota-paused job kept in place; `write:issue` scope required on every workflow token.
* [Publishing images to the own registry](decisions/registry-publishing.md) - A release tag builds the image and pushes it to git.noelsabia.dev; the runner socket it needs is root-equivalent and belongs on a separate label.
## Docker and development environment
* [Dev container shape](decisions/dev-container-shape.md) - The source is bind-mounted into a container that already holds the dependencies, and the dev server runs as the image's `node` user.
* [Build layer order](decisions/build-layer-order.md) - Why the manifests are copied before the source, and what invalidates what.
* [Build context filter](decisions/build-context-filter.md) - What `.dockerignore` may exclude, and the one thing it must never exclude.
* [Production image shape](decisions/production-image.md) - Multi-stage, digest-pinned, non-root runnable Node server - measured build and serve.
* [Repository and compose layout](decisions/repo-and-compose-layout.md) - The Dockerfiles live with the app; the stack is assembled in `Local_Development`.
* [Mockup layout](decisions/mockup-layout.md) - One `DESIGN.md` per screen, with the screenshot and the source embedded.
## UI and icons (2026-10-23)
* [Icons via Nuxt Icon](decisions/icons-via-nuxt-icon.md) - Icons come only from `@nuxt/icon` with a locally installed Material Symbols collection; inline SVG for SSR, scanned client bundle, and no icon webfont.
* [SEO stack and site metadata](decisions/seo-and-metadata.md) - `@nuxtjs/seo` with one metadata file, a `Person` identity, a committed 1200x630 OG card, and no dynamic OG renderer or skew protection.
# The one-paragraph history
The repository started as the Nuxt app shell. Docker development (dev
container, layer order, context filter) came first, then a single day of
CI/CD work built the PR pipeline layer by layer — lint, typecheck,
secret scan, dependency audit, Dockerfile lint, AI review — fixing one
real failure per layer as it appeared (wrong provider account, wrong
CLI major version, arm64-hostile vendor images, a silently-skipping
`hashFiles`, a prompt-injectable credential file), then wired releases
via release-please and locked the message format with pre-commit hooks.
The pipeline now fails loudly, posts only real reviews, and needs no
human faith to operate.
+125
View File
@@ -1,5 +1,130 @@
# Update Log
## 2026-10-31 (release-please reconcile step needs a checkout)
* **Fix**: [release-please.yml](../.gitea/workflows/release-please.yml) - added `actions/checkout@v4` before the reconcile step. The job had no checkout because the release-please action clones the repository into its own temp directory; the new step runs `scripts/reconcile-release-please.mjs` from the workspace, so the first post-merge run failed with `Cannot find module '/workspace/CV_Website/CV_Site_Nuxt/scripts/reconcile-release-please.mjs'` (task 571). The checkout supplies the file; the action still uses its own temp clone for the release branch.
## 2026-10-31 (PR #33 second review: release tag validated, pending PRs queried by label)
* **Fix**: [reconcile-release-please.mjs](../scripts/reconcile-release-please.mjs) - both PR-Agent findings were confirmed. A tag at the merge commit now counts only when it is exactly `v<manifest version>`; a foreign CI/annotation tag is logged and ignored. Pending release PRs are fetched through the `autorelease: pending` label filter instead of paging every closed PR, so a concurrent close cannot shift a page and hide one.
* **Guard**: a merged PR without `merge_commit_sha`, or a manifest without a version, now fails loudly instead of producing `vundefined`.
* **Verified locally**: dry-run against the live repo still matches #22 to `v1.4.0`; `pnpm lint`, `pnpm typecheck`, `pnpm build` and `pnpm audit --prod --audit-level moderate` pass on the rebased tree.
* **Known issue**: PR-Agent's `/describe` posts `Failed to update PR description`; the bot token has `write:issue` but not the PR-edit scope. Recorded with the fix in [PR-Agent operations](pr-agent.md).
## 2026-10-31 (registry host corrected: Gitea's built-in registry on git.noelsabia.dev)
* **Correction**: `registry.noelsabia.dev` is gone from the documentation and the workflow. Gitea's built-in container registry is served on the Gitea hostname itself, so the image is **`git.noelsabia.dev/cv_website/nuxt:<tag>`** ([docs.gitea.com/usage/packages/container](https://docs.gitea.com/usage/packages/container/)). `registry.noelsabia.dev` was a separate hostname set up before that was known; the server-side setup is being reverted. No separate registry, no extra hostname, no extra certificate - Gitea already provides this by default.
* **Update**: [publish-image.yml](../.gitea/workflows/publish-image.yml) - `IMAGE`, `docker login` and the v2 `manifests/<version>` immutability check all point at `git.noelsabia.dev`. [Publishing images to the own registry](decisions/registry-publishing.md) records the corrected host and the reason.
## 2026-10-31 (registry confirmed: Gitea's built-in container registry)
* **Confirmation**: Logged in and pushed by hand - push access works. The registry is **Gitea's built-in container registry** ([docs.gitea.com/usage/packages/container](https://docs.gitea.com/usage/packages/container/)), not a separately deployed component: it is served on the Gitea host, and the `/cv_website/` path segment is the organisation namespace. This is the default - no Registry/Harbor to stand up, nothing to reinvent. Host corrected in the entry above; see [Publishing images to the own registry](decisions/registry-publishing.md).
## 2026-10-30 (PR-Agent moved into the Gitea compose stack)
* **Refactor**: the `pr-agent` service now lives in `/home/noel/self-hosted/gitea/docker-compose.yml` with `/home/noel/self-hosted/gitea/pr-agent.env`. The separate `/home/noel/self-hosted/pr-agent` stack and the unused `/opt` operator-access scripts were removed; the service is managed with the Gitea stack.
* **Docs**: the operator README moved to [PR-Agent operations](pr-agent.md). The decision, index and update log point at the new topology.
* **Evidence**: after the move, the container is healthy, a signed webhook from the Gitea container returns 200, and a direct `glm-5.3-flash` call returns `OK`.
## 2026-10-30 (PR #28: lockfile and PR-Agent routing repaired)
* **Fix**: `pnpm-lock.yaml` - merging `main` left the lockfile at `@nuxt/icon` 2.6.0 while `package.json` asked for 2.6.2, so `pnpm install --frozen-lockfile` aborted in CI. The lockfile now resolves 2.6.2.
* **Fix**: `pnpm-workspace.yaml` - `seroval` 1.6.9 was the two moderate audit findings (GHSA-f86p-h4j2-7qgj, GHSA-9wx9-5pv9-3349). The patched 1.6.11 is forced through `overrides`; the blocking audit now reports only two low-severity advisories and passes the moderate gate.
* **Fix**: PR-Agent model routing - OpenCode Go rejects requests without `x-opencode-session`; `LITELLM__EXTRA_HEADERS` now supplies it, and the fallback keeps the `openai/` prefix. Auto commands are `/describe` and `/review`; `/improve` is on demand. A dummy-key call reaches the provider's auth check instead of failing on the missing header.
* **Evidence**: the key was wired into the live `.env`; a direct `glm-5.3-flash` call returned `OK`, and `/review` on PR #28 posted a PR Reviewer Guide (no findings). The failed-review comment was removed.
* **State**: the key is set only in `gitea/pr-agent.env`; the first `/review` posted on PR #28 with no findings.
## 2026-10-30 (PR-Agent replaces the opencode review job)
* **Decision**: [PR-Agent for Gitea reviews](decisions/pr-agent.md) - a pinned `pragent/pr-agent:0.49.0-gitea_app` container on `server0` reviews PRs through the Gitea bot user `pr-agent`; the endpoint stays on the `gitea_gitea` Docker network.
* **Update**: [pr-checker.yml](../.gitea/workflows/pr-checker.yml) - removed the `review` job, the opencode installer and the verdict-posting step. PR-Agent now runs `/describe` and `/review` on PR open/reopen and answers slash commands.
* **Creation**: `deploy/pr-agent/` (later removed; the service now lives in the Gitea compose stack) - compose service, example environment and operator README. The real `.env` lived only at `/home/noel/self-hosted/pr-agent/.env` (mode 600) on `server0`.
* **State**: the container is running and the webhook signature path is verified. Gitea gained `[webhook] ALLOWED_HOST_LIST = private:3000` (one restart, healthy) and the repository has a signed webhook. The OpenCode Go API key was still missing at commit time, so no model call or real review has run yet.
## 2026-10-31 (audit green again: nuxt 4.6.3 and dependency overrides)
* **Fix**: `pnpm audit --prod --audit-level moderate` failed on every branch (#30, #31, #33 and this PR) - new advisories plus a Nuxt patch release. `nuxt` 4.6.2 -> **4.6.3** clears GHSA-9v7c-q64q-vv33 (dot-segment middleware bypass), GHSA-3xf4-9g3c-4h4w and GHSA-x287-wcfc-q46c (dev-server file read/runtime config).
* **Fix**: [pnpm-workspace.yaml](../pnpm-workspace.yaml) - overrides for `node-forge: 1.4.1` (the old GHSA-86w9-cpqp-85rv ignore is removed - a patch exists now) and `glob@>=9.0.0 <=14.0.1: 14.0.2` (GHSA-3g3m-2fjr-6pw4; glob 7 is kept for tailwind-config-viewer).
* **Decision**: minimatch GHSA-g3hv-75wg-m249 stays a reviewed ignore. Its patch (11.0.1) dropped `makeRe`, which `eslint-plugin-import-x` imports - forcing it makes `pnpm lint` fail with "does not provide an export named 'makeRe'" (measured). All affected paths are build/lint-time. See [Vulnerability audit policy](decisions/vulnerability-audit-policy.md).
* **Verified locally**: `pnpm lint`, `pnpm typecheck`, `pnpm build` and the exact audit command all pass on the merged tree.
## 2026-10-27 (release-please still never tagged: the deleted head branch)
* **Fix**: [release-please-config.json](../release-please-config.json) gained `"changelog-host": "https://git.noelsabia.dev"` - the changelog compare links were generated against `github.com/CV_Website/CV_Site_Nuxt`, a host this repository does not live on. Root cause of the missing tags: **Gitea rewrites `head.ref` to `refs/pull/<n>/head` when the merged PR's branch is deleted**, and release-please parses that field as the release branch, so `BranchName.parse` fails and the release is dropped - silently, exit code 0. Evidence: run 143 (task 475) logs `✖ Bad branch name: refs/pull/22/head` right after `Found pull request #22`, then `Expected 1 releases, only found 0`; #22 did carry `autorelease: pending`. The repository deleted every merged branch (`default_delete_branch_after_merge: true`); it is `false` now. Four versions (1.1.0-1.4.0) were consumed by the manifest with no tag ever created, so the release baseline has to be restored by hand. See [Release engineering](decisions/release-engineering.md).
## 2026-10-24 (release-please never tagged: the missing labels)
* **Fix**: [release-please.yml](../.gitea/workflows/release-please.yml) - the workflow now creates `autorelease: pending` and `autorelease: tagged` before the action runs, and gained `workflow_dispatch` so a missed release can be replayed. Root cause: release-please finds merged release PRs **by label**, and Gitea resolves label names with `GetLabelIDsInRepoByNames`, a SQL `IN` filter that silently drops unknown names. The repository had no labels at all, so PRs #20 and #21 were merged unlabeled, every run found zero merged release PRs, created zero tags and opened the next release PR instead - reporting success each time. Evidence: run 137 green, 0 tags, 0 releases, `labels: []` on #20/#21/#22, and the repo's label list empty. See [Release engineering](decisions/release-engineering.md).
## 2026-10-24 (release publishes an image)
* **Creation**: [publish-image.yml](../.gitea/workflows/publish-image.yml) - a `vX.Y.Z` tag push builds `Dockerfile` on the arm64 runner and pushes `git.noelsabia.dev/cv_website/nuxt` as the version and `sha-<12>`, plus `latest` when 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 the `node:22-bookworm` container), so the act_runner needs `container.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](decisions/registry-publishing.md). Repo secrets: `REGISTRY_USERNAME`, `REGISTRY_PASSWORD`.
* **Review follow-up** (PR #19, 1 BLOCKER + 4 WARN + 2 NIT): applied the strict `vMAJOR.MINOR.PATCH` check, the newest-release rule for `latest`, a smoke test that starts the image and requires 2xx on `/`, and `timeout-minutes: 20`. 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 built successfully over the socket).
* **Second review follow-up** (PR #19): the job now runs on the dedicated `publish` label instead of `ubuntu-latest`, so the host socket it needs can never be shared with PR jobs - the earlier version required a runner configuration its own trust boundary forbade. Added the immutability guard (registry v2 `manifests/<version>`: `200` aborts, `404` continues) after measuring that `docker manifest inspect` fails on OCI indexes with the pinned 20.10 client; the smoke test now also requires a rendered body (10 kB floor) rather than a bare 2xx. `.github/actionlint.yaml` declares the custom label, and the hook passes it with `-config-file` because this repo keeps workflows in `.gitea/`.
## 2026-10-23 (profile data in the terminal)
* **Creation**: [Profile data](profile.md) - imported the LinkedIn export `Profile.pdf` into `app/data/chapters.ts`: PreZero active; Defifort, Alignerr, Outlier, freelance and 42 finished. Each row carries a context label (Enterprise, Web3 startup, AI Developer, Freelance, Education). The terminal now shows 1 active / 5 sealed / 14 rebounds; the export has no entry for `dreambit`, `ongoing-studies` or `apprenticeship`, so those rows are gone. `uptime` and `rebounds` remain mock.
* **Update**: [backend endpoints](backend-endpoints.md) - examples and totals now match the real six-chapter list; the source frontmatter points at the export.
## 2026-10-23 (homepage metrics contract)
* **Update**: [backend endpoints](backend-endpoints.md) - added `GET /api/metrics`: the chapter rows plus the terminal footer totals (`active`, `sealed`, `rebounds`) in one response. The homepage terminal is meant to show measurements, not mockup copy, so the gateway should own them; `/api/chapters` stays the row list for the life map. The old note that the counters are computed in the browser is gone.
## 2026-10-23 (PR #16 review checked, three findings applied)
* **Update**: [pr-checker.yml](../.gitea/workflows/pr-checker.yml) - the review prompt now states that `pnpm-lock.yaml` is excluded from `.pr-review-diff.patch` on purpose. The reviewer read the exclusion as an uncommitted lockfile and raised a false BLOCKER; the lockfile is in the PR and matches `package.json`.
* **Fix**: `scripts/generate-favicon.mjs` - `BACKGROUND = null` now 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/seo` writes `robots.txt` itself.
## 2026-10-23 (Nuxt SEO configured, static OG card)
* **Decision**: Recorded [SEO stack and site metadata](decisions/seo-and-metadata.md) - `@nuxtjs/seo` 6.0.1 registered; `site` and `schemaOrg.identity` (Person) read `site.config.mjs`; canonical, sitemap, robots and social tags need no per-page setup. `ogImage: false` and `skewProtection: false` because the card is a committed PNG and the site deploys as static files.
* **Update**: `public/og-image.png` (1200x630) and `og-image.alt.txt` generated from the pixel avatar and the site metadata by `pnpm og-image` (`scripts/generate-og-image.mjs`; needs `woff2_decompress` + `rsvg-convert`, output committed). SEO Utils emits `og:image`, `twitter:image` and their dimensions/alt automatically.
* **Detail**: `app/pages/index.vue` sets the title to `Noel Sabia — <role>` and `twitter:card: summary_large_image`; `useHead({ titleTemplate: '%s' })` removes the `| Noel Sabia` suffix SEO Utils would add. `theme-color` is `#031428`.
* **Detail**: `engines.node` is `^22.22.3 || ^24.15.0 || >=26.0.0`, the floor `@nuxtjs/seo` 6 enforces. Verified `nuxt build` and `nuxt generate`: canonical is `https://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.svg` and `public/favicon.ico` are generated from the header's pixel avatar by `pnpm 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.js` now holds the palette and the 32x32 sprite as the single source, imported by `AppLogo.vue` and by the generator (plain JS, so Node can import it without a loader). `app.head.link` declares the SVG first and the ICO as the `32x32` fallback.
* **Detail**: the icon keeps the header chip colour `#1b2b3f` as its background so the portrait stays readable on a dark tab bar; `BACKGROUND = null` in the generator makes it transparent.
## 2026-10-23 (icons from Nuxt Icon, icon webfont removed)
* **Decision**: Recorded [Icons via Nuxt Icon](decisions/icons-via-nuxt-icon.md) - all icons come from `@nuxt/icon` with `@iconify-json/material-symbols` installed locally, `mode: 'svg'`, `serverBundle: { collections: [] }`, `clientBundle: { scan: true }`. Deleted `public/fonts/material-symbols-outlined-var.woff2` (3.9 MiB), its `@font-face` and the `.material-symbols-outlined` class in `app/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.design` at 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](../.gitea/workflows/pr-checker.yml) - the review model is now `opencode-go/claude-haiku-5-5#medium`: cheap per token and, unlike `deepseek-v4.1-flash`, it has a real `#medium` effort level (flash exposes only low/high/max). ESLint and typecheck are merged into one `checks` job with a single `pnpm install`, and the pnpm store plus the opencode binary are restored with `actions/cache@v4.1.0` (v1 cache API, so it also works on a v1-only runner). Cache keys are built from `sha256sum pnpm-lock.yaml`, the pnpm store layout (`v11`) and the opencode version in shell steps, because `hashFiles()` evaluates empty in this act runner. See [AI review setup](decisions/ai-review-setup.md) and [PR pipeline layering](decisions/pr-pipeline-layering.md).
## 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`.
* **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.
+10 -3
View File
@@ -4,15 +4,22 @@ title: Open questions
description: Decisions still to make for the Nuxt site, with what needs each answer.
tags: [decision, open]
status: draft
generated: { by: opencode/deepseek-v4.1-flash, at: 2026-10-18T12:41:52Z }
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T12:41:52Z }
---
| Question | Needed by | Default if nobody decides |
|---|---|---|
| Shape of the production image: a runnable Node server, or static `.output/public/` files for the gateway to embed | the next Dockerfile step | None. The empty `Dockerfile` stays empty. |
| ~~Shape of the production image~~ - **decided**: runnable Node server, see [production image](decisions/production-image.md) | 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 | The same as dev, 11.26.0. |
| Which pnpm version the production image pins | ~~writing the production image~~ **decided**: 11.26.0, same as dev ([production image](decisions/production-image.md)) | 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~~ - **closed** (2026-10-30): the opencode job was removed; the review path is a pinned PR-Agent container. See [PR-Agent for Gitea reviews](decisions/pr-agent.md) | done | — |
| Whether `glm-5.3-flash` through PR-Agent produces acceptable reviews on this repository | first PR after the OpenCode Go key is set | Keep it; `glm-5.3` is the configured fallback. |
| ~~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](../.gitea/workflows/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](../log.md) | 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
+133
View File
@@ -0,0 +1,133 @@
---
type: Reference
title: PR-Agent operations
description: The Gitea-side pull-request review service, its configuration in the Gitea compose stack, and the commands it answers.
tags: [pr-agent, gitea, operations, ci, ai]
status: draft
generated: { by: opencode-go/deepseek-v4.1-flash, at: 2026-10-30T20:40:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: gitea-compose
resource: /home/noel/self-hosted/gitea/docker-compose.yml
title: Gitea compose stack, pr-agent service
- id: install
resource: https://docs.pr-agent.ai/installation/gitea/
title: PR-Agent Gitea installation
- id: gitea-egress
resource: https://docs.gitea.com/administration/config-cheat-sheet#webhook
title: Gitea webhook egress allowlist
---
# What runs
PR-Agent is the `pr-agent` service inside the Gitea compose stack on
`server0`. It listens on the internal `gitea_gitea` network at
`http://pr-agent:3000`; no port is published. Gitea calls its signed
webhook at `/api/v1/gitea_webhooks`, and the bot user `pr-agent` posts the
results.
| Piece | Value |
|---|---|
| Service | `pr-agent` in `/home/noel/self-hosted/gitea/docker-compose.yml` |
| Image | `pragent/pr-agent:0.49.0-gitea_app` |
| Config | `/home/noel/self-hosted/gitea/pr-agent.env` (mode 600) |
| Logs | `cd /home/noel/self-hosted/gitea && docker compose logs -f pr-agent` |
| Restart | `cd /home/noel/self-hosted/gitea && docker compose up -d pr-agent` |
| Upgrade | bump the image tag in the compose file, then restart the service |
The service is managed with the same access as the rest of the Gitea
stack. The earlier plan for a separate `/opt/pr-agent` stack and a
restricted `agent` account was not applied; those scripts were removed when
the service moved into this stack. Hardening the Gitea stack's operator
access is a separate change.
# Gitea side
1. Bot user `pr-agent` is a collaborator with write permission on
`CV_Website/CV_Site_Nuxt`. Its personal access token is scoped to
`read:repository`, `write:issue` and `read:user`.
2. The repository webhook sends `push`, `issues`, `pull_request` and
`issue_comment` events, with JSON content type and the shared secret.
3. Gitea's `[webhook] ALLOWED_HOST_LIST` includes `private:3000`. Without
it, Gitea's default egress policy refuses deliveries to the Docker
network.
# Known issue: "Failed to update PR description"
On PR #33 (2026-10-31) `/describe` posted `Failed to update PR description`
before the reviewer guide. Comments work because the bot token has
`write:issue`; editing the PR body is a repository-route write and needs
`write:repository` as well. Add that scope to the `pr-agent` token and
restart the service, or remove `/describe` from `GITEA__PR_COMMANDS` if the
description update is not wanted. The review comment is still posted; this
affects only the description sync.
# Commands
| Trigger | What runs |
|---|---|
| PR opened or reopened | `/describe` and `/review` automatically |
| New push to an open PR | nothing; comment `/review` or `/review -i` |
| Comment `/review`, `/improve`, `/ask` | that command |
`/review -i` reviews only the commits added since the previous review.
`/improve` stays on demand; adding it to the auto list would make a second
model call and a second comment on every PR. Draft PRs are not skipped.
# Configuration
`pr-agent.env` holds the deployment values. The repository never contains
the token, webhook secret, or API key:
```ini
CONFIG__GIT_PROVIDER=gitea
GITEA__URL=http://gitea:3000
GITEA__WEB_URL=https://git.noelsabia.dev
GITEA__PERSONAL_ACCESS_TOKEN=...
GITEA__WEBHOOK_SECRET=...
CONFIG__MODEL=openai/glm-5.3-flash
CONFIG__FALLBACK_MODELS=["openai/glm-5.3"]
CONFIG__CUSTOM_MODEL_MAX_TOKENS=128000
OPENAI__API_BASE=https://opencode.ai/inference/go/openai/v1
OPENAI__KEY=...
LITELLM__EXTRA_HEADERS={"x-opencode-session":"pr-agent"}
GITEA__PR_COMMANDS=["/describe","/review"]
```
OpenCode Go requires the `x-opencode-session` header. The fallback keeps
the `openai/` prefix; a bare `glm-5.3` is treated by LiteLLM as a
provider-less model. `CONFIG__CUSTOM_MODEL_MAX_TOKENS` supplies the context
limit; the effective review budget is capped by PR-Agent's default
`max_model_tokens` of 32000.
The compose service:
```yaml
pr-agent:
image: pragent/pr-agent:0.49.0-gitea_app
container_name: pr-agent
restart: unless-stopped
env_file:
- ./pr-agent.env
environment:
PORT: "3000"
GUNICORN_WORKERS: "2"
mem_limit: 1g
networks:
- gitea
healthcheck:
test: ["CMD", "python", "-c", "import socket; socket.create_connection(('127.0.0.1', 3000), 3).close()"]
interval: 30s
timeout: 5s
retries: 3
start_period: 30s
```
# Checks
A signed webhook from the Gitea container returns 200, and a direct
`glm-5.3-flash` call returns a completion. A `403` in the Gitea webhook
delivery log means the secret does not match or `ALLOWED_HOST_LIST` is
missing; a `401` from PR-Agent means the signature and secret disagree.
On a model failure, check `docker compose logs pr-agent` and confirm
`OPENAI__KEY` is set in `pr-agent.env`.
+82
View File
@@ -0,0 +1,82 @@
---
type: Data Source
title: Profile data behind the homepage
description: The LinkedIn export used for the terminal chapters, what is real and what is still mock, and how to refresh it.
tags: [profile, linkedin, chapters, data]
status: draft
generated: { by: opencode-go/deepseek-v4.1-flash, at: 2026-10-23T00:00:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: linkedin-profile
resource: https://www.linkedin.com/in/noel-sabia-9738a4339/
title: LinkedIn profile (exported to Profile.pdf, 2026-10-23)
---
# Decision
The homepage terminal is driven by `app/data/chapters.ts`. The chapter
names, statuses and outcome years in that file come from the LinkedIn
export `Profile.pdf`; the telemetry values (`uptime`, `rebounds`) are
still mock numbers until `GET /api/metrics` exists.
# Profile facts the site uses
* Name: Noel Sabia
* Location: Heilbronn, Baden-Württemberg, Germany
* Email: noel.sabia.05@gmail.com
* LinkedIn: <https://www.linkedin.com/in/noel-sabia-9738a4339/>
* Current headline: Working for Schwarz Group
* Current role: PreZero Deutschland, Full Stack Developer (September 2025 – present)
* Education: 42 Heilbronn (2023 – 2025)
The hero's `System Architect · Programmer` line, the pill and the quote
are positioning copy chosen by Noel, not LinkedIn fields. The three
cards are soft skills, also not from the export.
# Chapter mapping
| Chapter | Context | Export entry | Terminal status | Terminal detail |
|---|---|---|---|---|
| `prezero` | Enterprise | PreZero Deutschland, Full Stack Developer, 09/2025 – present | active | `self_healed=14x` (mock) |
| `defifort` | Web3 startup | Defifort, Software Developer, 04/2025 – 07/2025 | finished | `completed=2025` |
| `alignerr` | AI Developer | Alignerr, AI Trainer, 10/2024 – 03/2025 | finished | `completed=2025` |
| `outlier` | AI Developer | Outlier, Remote Coding Expert / Freelance Writer, 03/2024 – 09/2024 | finished | `completed=2024` |
| `freelance` | Freelance | Freelance Software Engineer, 06/2023 – 03/2024 | finished | `completed=2024` |
| `42-school` | Education | 42 Heilbronn, 2023 – 2025 | finished | `graduated=2024` |
The `context` labels are Noel's wording for the terminal, not fields in
the export.
The terminal derives its footer from this list: **1 active**, **5 sealed**,
**14 rebounds**. The rebound count is the mock value on `prezero`; the
finished rows carry no rebound number.
The export has no entry for `dreambit`, `ongoing-studies` or
`apprenticeship`, so those rows were removed from the terminal. It also
has no entry before 2023; if the apprenticeship belongs on the life map,
add it back deliberately instead of restoring the mockup text.
# 42 graduation year
The export's education range is **2023 – 2025**. The terminal shows
`graduated=2024` because Noel stated 2024 explicitly. If the export is
right, change the value in `app/data/chapters.ts` to `2025`; this is the
one open discrepancy in the mapping.
# Not imported
The export also contains the summary, the per-role descriptions, top
skills (Docker, Python, Go), languages (German native, English
professional) and the ETHGlobal Prague 3rd place. The homepage does not
show them yet; the life map and the CV can reuse them later.
# Refresh
1. Download a fresh `Profile.pdf` from LinkedIn (More → Save to PDF).
2. Update the table above and `app/data/chapters.ts`; keep the chapter
handles stable so the life-map links do not break.
3. Replace `uptime` and `rebounds` with `GET /api/metrics` when the
gateway exists; the chapter list then comes from the same endpoint.
The PDF export is not committed; only the derived chapter data belongs
in the repository.
+4 -4
View File
@@ -1,6 +1,6 @@
<template>
<div>
<NuxtRouteAnnouncer />
<NuxtWelcome />
</div>
<NuxtRouteAnnouncer />
<NuxtLayout>
<NuxtPage />
</NuxtLayout>
</template>
+45
View File
@@ -0,0 +1,45 @@
/* 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');
}
@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;
}
}
+30
View File
@@ -0,0 +1,30 @@
<template>
<nav
aria-label="Mobile"
class="fixed bottom-0 left-0 w-full z-50 flex md:hidden bg-surface-container-low/90 backdrop-blur-xl shadow-[0_-1px_12px_rgba(0,0,0,0.3)]"
>
<div class="w-full h-16 px-space-xs flex items-center justify-around">
<NuxtLinkLocale
to="/"
class="w-16 h-12 flex flex-col items-center justify-center text-primary font-semibold transition-colors"
>
<Icon name="material-symbols:badge" aria-hidden="true" class="text-[22px]" />
<span class="font-label-mono text-label-mono">{{ $t('nav.overview') }}</span>
</NuxtLinkLocale>
<a
href="#"
class="w-16 h-12 flex flex-col items-center justify-center text-on-surface-variant hover:text-primary transition-colors"
>
<Icon name="material-symbols:timeline" aria-hidden="true" class="text-[22px]" />
<span class="font-label-mono text-label-mono">{{ $t('nav.lifeMap') }}</span>
</a>
<a
href="#"
class="w-16 h-12 flex flex-col items-center justify-center text-on-surface-variant hover:text-primary transition-colors"
>
<Icon name="material-symbols:code" aria-hidden="true" class="text-[22px]" />
<span class="font-label-mono text-label-mono">{{ $t('nav.devView') }}</span>
</a>
</div>
</nav>
</template>
+33
View File
@@ -0,0 +1,33 @@
<script setup lang="ts">
defineProps<{ code: 'en' | 'de' | 'es' | 'it' | 'pl' }>()
</script>
<template>
<svg v-if="code === 'en'" viewBox="0 0 24 16" class="h-full w-full" aria-hidden="true">
<rect width="24" height="16" fill="#012169" />
<path d="M0 0 24 16 M24 0 0 16" stroke="#fff" stroke-width="3.2" />
<path d="M0 0 24 16 M24 0 0 16" stroke="#c8102e" stroke-width="1.6" />
<rect x="10.4" width="3.2" height="16" fill="#fff" />
<rect y="6.4" width="24" height="3.2" fill="#fff" />
<rect x="11" width="2" height="16" fill="#c8102e" />
<rect y="7" width="24" height="2" fill="#c8102e" />
</svg>
<svg v-else-if="code === 'de'" viewBox="0 0 24 16" class="h-full w-full" aria-hidden="true">
<rect width="24" height="5.334" fill="#000" />
<rect y="5.334" width="24" height="5.333" fill="#dd0000" />
<rect y="10.667" width="24" height="5.333" fill="#ffce00" />
</svg>
<svg v-else-if="code === 'es'" viewBox="0 0 24 16" class="h-full w-full" aria-hidden="true">
<rect width="24" height="16" fill="#aa151b" />
<rect y="4" width="24" height="8" fill="#f1bf00" />
</svg>
<svg v-else-if="code === 'it'" viewBox="0 0 24 16" class="h-full w-full" aria-hidden="true">
<rect width="8" height="16" fill="#008c45" />
<rect x="8" width="8" height="16" fill="#f4f5f0" />
<rect x="16" width="8" height="16" fill="#cd212a" />
</svg>
<svg v-else viewBox="0 0 24 16" class="h-full w-full" aria-hidden="true">
<rect width="24" height="8" fill="#fff" />
<rect y="8" width="24" height="8" fill="#dc143c" />
</svg>
</template>
+20
View File
@@ -0,0 +1,20 @@
<template>
<footer class="hidden md:block 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>{{ $t('footer.servedFrom') }}</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>
+13
View File
@@ -0,0 +1,13 @@
<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 />
<div class="flex items-center gap-4">
<AppQuickLinks />
<span class="hidden sm:inline text-[0.625rem] text-outline-variant" aria-hidden="true">/</span>
<AppLanguageSwitcher />
</div>
</div>
</header>
</template>
+84
View File
@@ -0,0 +1,84 @@
<script setup lang="ts">
const { locales, locale, setLocale, t } = useI18n()
const open = ref(false)
const root = ref<HTMLElement | null>(null)
const trigger = ref<HTMLButtonElement | null>(null)
const menuId = useId()
// The accessible name has to contain the visible text (WCAG 2.5.3).
const triggerLabel = computed(() => `${t('switcher.label')}: ${locale.value.toUpperCase()}`)
function closeOnOutside(event: MouseEvent) {
if (!root.value?.contains(event.target as Node)) {
open.value = false
}
}
function closeOnEscape(event: KeyboardEvent) {
if (event.key === 'Escape' && open.value) {
open.value = false
// Focus would otherwise stay on a list item that just left the DOM.
trigger.value?.focus()
}
}
onMounted(() => {
document.addEventListener('click', closeOnOutside)
document.addEventListener('keydown', closeOnEscape)
})
onBeforeUnmount(() => {
document.removeEventListener('click', closeOnOutside)
document.removeEventListener('keydown', closeOnEscape)
})
async function choose(code: Parameters<typeof setLocale>[0]) {
open.value = false
await setLocale(code)
}
</script>
<template>
<div ref="root" class="relative flex shrink-0 items-center font-label-mono text-label-mono">
<button
ref="trigger"
type="button"
class="flex items-center gap-1.5 uppercase tracking-wider text-on-surface-variant transition-colors hover:text-on-surface"
:aria-expanded="open"
:aria-controls="menuId"
:aria-label="triggerLabel"
@click="open = !open"
>
<span class="h-3.5 w-5 overflow-hidden rounded-[2px]">
<AppFlag :code="locale" />
</span>
<span>{{ locale }}</span>
<span aria-hidden="true" class="text-[0.625rem] text-on-surface-variant">▼</span>
</button>
<ul
v-if="open"
:id="menuId"
class="absolute right-0 top-full z-10 mt-2 min-w-48 rounded-lg border border-outline-variant/30 bg-surface-container-high p-1 shadow-lg"
>
<li v-for="language in locales" :key="language.code">
<button
type="button"
class="flex w-full items-center gap-3 rounded px-3 py-2 text-left transition-colors"
:class="locale === language.code
? 'bg-surface-variant text-on-surface'
: 'text-on-surface-variant hover:bg-surface-variant hover:text-on-surface'"
:aria-current="locale === language.code ? 'true' : undefined"
@click="choose(language.code)"
>
<span class="h-3.5 w-5 shrink-0 overflow-hidden rounded-[2px]">
<AppFlag :code="language.code" />
</span>
<span class="flex-1">{{ language.name }}</span>
<span class="uppercase tracking-wider">{{ language.code }}</span>
</button>
</li>
</ul>
</div>
</template>
+64
View File
@@ -0,0 +1,64 @@
<script setup lang="ts">
import { AVATAR_PALETTE, AVATAR_SPRITE } from '~/utils/avatar'
const palette: Record<string, string> = AVATAR_PALETTE
const flat = AVATAR_SPRITE
.flatMap((row) => [...row])
.map((cell) => palette[cell] ?? 'transparent')
</script>
<template>
<NuxtLinkLocale 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>
</NuxtLinkLocale>
</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>
+22
View File
@@ -0,0 +1,22 @@
<template>
<nav class="hidden lg:flex items-center gap-1.5">
<NuxtLinkLocale
to="/"
class="px-3 py-1.5 transition-colors bg-primary-container text-on-primary-container font-medium rounded font-body-sm text-body-sm"
>
{{ $t('nav.overview') }}
</NuxtLinkLocale>
<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"
>
{{ $t('nav.lifeMap') }}
</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"
>
{{ $t('nav.devView') }}
</a>
</nav>
</template>
+9
View File
@@ -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">{{ $t('quickLinks.pdfCv') }}</a>
<span class="text-outline-variant text-[0.625rem]">/</span>
<a href="#" class="hover:text-on-surface transition-colors">{{ $t('quickLinks.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>
+47
View File
@@ -0,0 +1,47 @@
<script setup lang="ts">
import type { Chapter } from '~/data/chapters'
const props = defineProps<{ chapter: Chapter }>()
const isActive = computed(() => props.chapter.status === 'active')
// Active rows report recoveries; finished rows report what sealed them.
const detail = computed(() => (isActive.value
? { label: 'self_healed', value: `${props.chapter.rebounds ?? 0}x` }
: props.chapter.outcome))
</script>
<template>
<div
class="grid grid-cols-2 items-center gap-4 rounded px-3 py-2 transition-colors hover:bg-surface-container-lowest lg:min-w-[760px] lg:grid-cols-[10rem_7rem_8.5rem_7.5rem_8.5rem] lg:justify-between lg:py-1.5"
:class="isActive ? 'bg-surface-container-lowest/60' : 'bg-surface-container-lowest/40'"
>
<span
class="hidden whitespace-nowrap font-medium lg:block"
:class="isActive ? 'text-primary-fixed-dim' : 'text-outline'"
>chapter=<span :class="isActive ? 'text-on-surface' : 'text-on-surface-variant'">{{ chapter.name }}</span></span>
<span class="w-fit rounded bg-surface-container-highest/80 px-2 py-1 font-label-mono text-[0.6875rem] uppercase tracking-wider text-on-surface-variant/80 lg:w-full lg:px-1.5 lg:py-0.5 lg:text-center lg:text-[0.625rem]">
{{ chapter.context }}
</span>
<span
v-if="isActive"
class="flex items-center gap-1.5 justify-self-end font-semibold text-secondary lg:justify-self-start"
>
<span class="h-1.5 w-1.5 rounded-full bg-secondary" />
status=active
</span>
<span v-else class="justify-self-end font-medium text-outline lg:justify-self-start">status=finished</span>
<span
class="hidden font-status-badge text-status-badge lg:block"
:class="isActive ? 'text-on-surface-variant' : 'text-on-surface-variant/70'"
>uptime={{ chapter.uptime }}</span>
<span
v-if="detail"
class="hidden font-label-mono text-label-mono lg:block"
:class="isActive ? 'text-tertiary' : 'text-primary-fixed-dim'"
>{{ detail.label }}={{ detail.value }}</span>
</div>
</template>
+23
View File
@@ -0,0 +1,23 @@
<template>
<div class="mb-10 w-full max-w-3xl">
<div class="grid grid-cols-2 gap-2 rounded-xl bg-surface-container/90 p-2 font-label-mono text-label-mono text-on-surface shadow-md backdrop-blur-md sm:grid-cols-[1fr_auto_auto] sm:items-center sm:p-2.5">
<HomeContactItem
icon="mail"
value="noel.sabia.05@gmail.com"
copy-value="noel.sabia.05@gmail.com"
class="col-span-2 min-w-0 sm:col-span-1 sm:min-w-[220px]"
/>
<HomeContactItem
icon="link"
value="LinkedIn"
href="https://www.linkedin.com/in/noel-sabia-9738a4339/"
class="min-w-0"
/>
<HomeContactItem
icon="near_me"
value="Heilbronn, Germany"
class="min-w-0"
/>
</div>
</div>
</template>
+70
View File
@@ -0,0 +1,70 @@
<script setup lang="ts">
const props = defineProps<{
icon: string
value: string
/** Omit for a plain chip (no copy button). */
copyValue?: string
/** Renders the chip as an external link instead of a copy chip. */
href?: string
}>()
const isLink = computed(() => Boolean(props.href))
const copied = ref(false)
let resetTimer: ReturnType<typeof setTimeout> | undefined
async function copy() {
if (!props.copyValue) return
try {
await navigator.clipboard.writeText(props.copyValue)
copied.value = true
clearTimeout(resetTimer)
resetTimer = setTimeout(() => {
copied.value = false
}, 1800)
} catch {
// Clipboard permission denied: leave the label on COPY.
}
}
onBeforeUnmount(() => clearTimeout(resetTimer))
</script>
<template>
<component
:is="isLink ? 'a' : 'div'"
:href="isLink ? href : undefined"
:target="isLink ? '_blank' : undefined"
:rel="isLink ? 'noopener noreferrer' : undefined"
:aria-label="isLink ? `Open ${value} in a new tab` : undefined"
class="flex items-center gap-2 rounded-lg bg-surface-container-low/70 px-3 py-2"
:class="isLink
? 'group justify-between gap-3 transition-colors hover:bg-surface-container-high'
: copyValue
? 'justify-between transition-colors hover:bg-surface-container-high'
: 'justify-center font-body-sm text-body-sm text-on-surface-variant'"
>
<div class="flex min-w-0 items-center gap-2.5">
<span class="material-symbols-outlined text-[1.125rem] text-outline">{{ icon }}</span>
<span
v-if="copyValue || isLink"
class="truncate font-body-sm text-body-sm text-on-surface"
:class="copyValue && !isLink ? 'select-all' : ''"
>{{ value }}</span>
<span v-else class="truncate text-on-surface">{{ value }}</span>
</div>
<button
v-if="copyValue && !isLink"
type="button"
class="flex items-center gap-1 rounded bg-surface-variant px-2 py-1 text-[0.625rem] font-semibold tracking-wider text-on-surface-variant transition-colors hover:text-on-surface active:scale-95"
:aria-label="`Copy ${value}`"
@click="copy"
>
<span>{{ copied ? 'COPIED' : 'COPY' }}</span>
</button>
<span
v-else-if="isLink"
class="material-symbols-outlined text-[0.875rem] text-outline transition-colors group-hover:text-on-surface"
>open_in_new</span>
</component>
</template>
+18
View File
@@ -0,0 +1,18 @@
<script setup lang="ts">
defineProps<{
icon: string
title: string
description: string
iconClass: string
}>()
</script>
<template>
<div class="rounded-xl bg-surface-container p-6 shadow-sm transition-colors hover:bg-surface-container-high">
<div class="mb-4 flex h-10 w-10 items-center justify-center rounded-lg bg-surface-container-highest" :class="iconClass">
<span class="material-symbols-outlined text-[1.5rem]">{{ icon }}</span>
</div>
<h3 class="mb-2 font-headline-sm text-headline-sm text-on-surface">{{ title }}</h3>
<p class="font-body-sm text-body-sm leading-relaxed text-on-surface-variant">{{ description }}</p>
</div>
</template>
+34
View File
@@ -0,0 +1,34 @@
<script setup lang="ts">
const features = [
{
icon: 'self_improvement',
iconClass: 'text-primary',
title: 'Humble by Default',
description: 'Strong opinions, loosely held. I treat being wrong as information, not a defeat and I admit it quickly.',
},
{
icon: 'school',
iconClass: 'text-secondary',
title: 'Learning by Doing',
description: 'New stack, new domain, new failure mode: I read, prototype, ask questions, and repeat until it makes sense.',
},
{
icon: 'handshake',
iconClass: 'text-tertiary',
title: 'Helpful as a Feature',
description: 'Good systems and good teams get better when we pull each other up. I try to be that person.',
},
]
</script>
<template>
<section class="relative mx-auto mb-20 w-full max-w-5xl px-6 sm:px-8">
<div class="grid grid-cols-1 gap-4 md:grid-cols-3">
<HomeFeatureCard
v-for="feature in features"
:key="feature.title"
v-bind="feature"
/>
</div>
</section>
</template>
+42
View File
@@ -0,0 +1,42 @@
<template>
<div class="relative mx-auto flex max-w-5xl flex-col items-center px-6 pb-20 pt-16 text-center sm:px-8 sm:pt-24 lg:px-12">
<div class="mb-8 inline-flex items-center gap-2.5 rounded-full bg-surface-container-high/80 px-3 py-1.5 font-label-mono text-label-mono text-on-surface-variant shadow-sm backdrop-blur-md">
<span class="relative inline-flex h-2 w-2">
<span class="absolute inline-flex h-full w-full animate-ping rounded-full bg-secondary opacity-75" />
<span class="relative inline-flex h-2 w-2 rounded-full bg-secondary shadow-[0_0_8px_#4ae176]" />
</span>
<span class="uppercase tracking-widest text-on-surface">SYS_ARCHITECT // HEILBRONN</span>
</div>
<h1 class="mb-4 font-display text-display tracking-tight text-on-surface selection:bg-primary selection:text-on-primary">
Noel Sabia
</h1>
<p class="mb-6 font-label-mono text-mono-code uppercase tracking-wider text-primary-fixed-dim">
System Architect <span class="mx-1.5 text-outline-variant">·</span> Programmer
</p>
<p class="mx-auto mb-12 max-w-4xl font-headline-md text-headline-md italic leading-relaxed text-on-surface-variant">
&ldquo;Falling down is human. Getting up is the standard I hold myself to.&rdquo;
</p>
<HomeContactBar />
<div class="flex flex-wrap items-center justify-center gap-4">
<a
href="#"
class="inline-flex items-center gap-2.5 rounded-lg bg-on-surface px-6 py-3 font-label-mono text-label-mono font-semibold text-surface shadow-lg transition-all hover:bg-inverse-surface hover:shadow-xl active:scale-[0.98]"
>
<span class="material-symbols-outlined text-[1.25rem]">arrow_downward</span>
<span>Download CV (PDF)</span>
</a>
<a
href="#system-terminal"
class="inline-flex items-center gap-2 rounded-lg bg-surface-container-high px-5 py-3 font-label-mono text-label-mono text-on-surface shadow-sm transition-colors hover:bg-surface-variant"
>
<span>See the life map</span>
<span class="material-symbols-outlined text-[1rem]">south</span>
</a>
</div>
</div>
</template>
+62
View File
@@ -0,0 +1,62 @@
<script setup lang="ts">
import type { Chapter } from '~/data/chapters'
const props = defineProps<{ chapters: Chapter[] }>()
const activeCount = computed(() => props.chapters.filter((chapter) => chapter.status === 'active').length)
const sealedCount = computed(() => props.chapters.length - activeCount.value)
const rebounds = computed(() => props.chapters.reduce((total, chapter) => total + (chapter.rebounds ?? 0), 0))
</script>
<template>
<section id="system-terminal" class="relative mx-auto mb-24 w-full max-w-4xl px-6 sm:px-8">
<div class="overflow-hidden rounded-xl bg-surface-container-low shadow-2xl">
<div class="flex items-center justify-between bg-surface-container-lowest px-4 py-2.5">
<div class="flex items-center gap-2">
<span class="inline-block h-3 w-3 rounded-full bg-[#ff5f57]" />
<span class="inline-block h-3 w-3 rounded-full bg-[#febc2e]" />
<span class="inline-block h-3 w-3 rounded-full bg-[#28c840]" />
</div>
<div class="flex items-center gap-1.5 font-label-mono text-[0.6875rem] tracking-wide text-on-surface-variant/80">
<span class="material-symbols-outlined text-[0.875rem] text-primary">terminal</span>
<span>cv --runtime=active</span>
</div>
<div class="flex items-center gap-1.5 font-status-badge text-[0.625rem] text-secondary">
<span class="inline-block h-1.5 w-1.5 rounded-full bg-secondary" />
<span>LIVE</span>
</div>
</div>
<div class="flex flex-col gap-3 overflow-x-auto bg-surface-container-low p-5 font-mono-code text-mono-code text-on-surface sm:p-7">
<div class="mb-1 select-none text-xs tracking-wider text-on-surface-variant/60">
# Resilience telemetry: autonomous remediation logs
</div>
<HomeChapterRow v-for="chapter in chapters" :key="chapter.name" :chapter="chapter" />
<div class="flex items-center gap-2 pt-3 font-label-mono text-sm text-primary">
<span class="text-secondary">$</span>
<span>watch --interval=5s ./chaos_reconcile.sh</span>
<span class="ml-0.5 inline-block h-4 w-2.5 animate-pulse bg-primary" />
</div>
</div>
<div class="flex flex-wrap items-center justify-between gap-3 bg-surface-container px-5 py-3 font-label-mono text-xs text-on-surface-variant">
<div class="flex items-center gap-4">
<span class="flex items-center gap-1.5">
<span class="h-2 w-2 rounded-full bg-secondary" />
{{ activeCount }} {{ activeCount === 1 ? 'System' : 'Systems' }} Active
</span>
<span class="flex items-center gap-1.5">
<span class="h-2 w-2 rounded-full bg-outline" />
{{ sealedCount }} Sealed {{ sealedCount === 1 ? 'Archetype' : 'Archetypes' }}
</span>
</div>
<div class="flex items-center gap-1.5 text-on-tertiary-container">
<span class="material-symbols-outlined text-[0.875rem]">sync_problem</span>
<span>Cumulative Rebounds: {{ rebounds }} events</span>
</div>
</div>
</div>
</section>
</template>
+27
View File
@@ -0,0 +1,27 @@
export interface ChapterOutcome {
label: string
value: string
}
export interface Chapter {
name: string
/** Short context label shown next to the chapter name. */
context: string
status: 'active' | 'finished'
uptime: string
/** Active chapters: how often the workload recovered on its own. */
rebounds?: number
/** Finished chapters: what closed the chapter and when. */
outcome?: ChapterOutcome
}
// Chapter list from Profile.pdf (LinkedIn export, 2026-10-23).
// uptime and rebounds are mock telemetry; replaced by GET /api/metrics.
export const chapters: Chapter[] = [
{ name: 'prezero', context: 'Enterprise', status: 'active', uptime: '99.98%', rebounds: 14 },
{ name: 'defifort', context: 'Web3 startup', status: 'finished', uptime: '100.0%', outcome: { label: 'completed', value: '2025' } },
{ name: 'alignerr', context: 'AI Developer', status: 'finished', uptime: '100.0%', outcome: { label: 'completed', value: '2025' } },
{ name: 'outlier', context: 'AI Developer', status: 'finished', uptime: '100.0%', outcome: { label: 'completed', value: '2024' } },
{ name: 'freelance', context: 'Freelance', status: 'finished', uptime: '100.0%', outcome: { label: 'completed', value: '2024' } },
{ name: '42-school', context: 'Education', status: 'finished', uptime: '100.0%', outcome: { label: 'graduated', value: '2024' } },
]
+10
View File
@@ -0,0 +1,10 @@
<template>
<div class="flex min-h-screen flex-col pb-16 md:pb-0">
<AppHeader />
<main class="w-full flex-1 pt-16 bg-surface">
<slot />
</main>
<AppFooter />
<AppBottomNav />
</div>
</template>
+33
View File
@@ -0,0 +1,33 @@
<script setup lang="ts">
import { SITE } from '~~/site.config.mjs'
import { chapters } from '~/data/chapters'
// The description and Open Graph basics come from `site` in nuxt.config.ts;
// the page title adds the role so search results are not just a name.
useSeoMeta({
title: `${SITE.name} — ${SITE.role}`,
twitterCard: 'summary_large_image'
})
// SEO Utils would append "| Noel Sabia" to every title by default.
useHead({ titleTemplate: '%s' })
</script>
<template>
<div class="relative flex w-full flex-col overflow-hidden">
<!-- Backdrop is measured against the hero, as in the mockup, so the two circles stay
close together. It is not clipped at the hero's bottom edge, which lets the
terminal sit on top of the lower circle. Horizontal clipping lives on the root. -->
<div class="relative w-full">
<div class="pointer-events-none absolute inset-0">
<div class="absolute -top-40 left-1/2 h-[32rem] w-[48rem] -translate-x-1/2 bg-gradient-to-b from-primary-container/20 via-surface-container-high/10 to-transparent opacity-70 blur-3xl" />
<div class="absolute left-1/4 top-1/3 h-96 w-96 rounded-full bg-primary/5 blur-3xl" />
<div class="absolute right-1/4 top-2/3 h-80 w-80 rounded-full bg-secondary/5 blur-3xl" />
</div>
<HomeHeroSection />
</div>
<HomeTerminalPanel :chapters="chapters" />
<HomeFeatureCards />
</div>
</template>
+55
View File
@@ -0,0 +1,55 @@
// Single source for the pixel avatar: the header logo and the generated
// favicon both read this file. `scripts/generate-favicon.mjs` imports it
// with plain Node, so it must stay dependency-free JavaScript.
//
// 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).
export const AVATAR_PALETTE = {
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
}
export const AVATAR_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',
]
+17
View File
@@ -0,0 +1,17 @@
{
"nav": {
"overview": "Übersicht",
"lifeMap": "Lebenskarte",
"devView": "Dev-Ansicht"
},
"quickLinks": {
"pdfCv": "Lebenslauf (PDF)",
"contact": "Kontakt"
},
"footer": {
"servedFrom": "Betrieben auf meinem eigenen Server · k8s · Terraform"
},
"switcher": {
"label": "Sprache"
}
}
+17
View File
@@ -0,0 +1,17 @@
{
"nav": {
"overview": "Overview",
"lifeMap": "Life Map",
"devView": "Dev View"
},
"quickLinks": {
"pdfCv": "PDF CV",
"contact": "Contact"
},
"footer": {
"servedFrom": "Served from my own server · k8s · Terraform"
},
"switcher": {
"label": "Language"
}
}
+17
View File
@@ -0,0 +1,17 @@
{
"nav": {
"overview": "Resumen",
"lifeMap": "Mapa de vida",
"devView": "Vista dev"
},
"quickLinks": {
"pdfCv": "CV en PDF",
"contact": "Contacto"
},
"footer": {
"servedFrom": "Servido desde mi propio servidor · k8s · Terraform"
},
"switcher": {
"label": "Idioma"
}
}
+17
View File
@@ -0,0 +1,17 @@
{
"nav": {
"overview": "Panoramica",
"lifeMap": "Mappa della vita",
"devView": "Vista dev"
},
"quickLinks": {
"pdfCv": "CV in PDF",
"contact": "Contatti"
},
"footer": {
"servedFrom": "Servito dal mio server · k8s · Terraform"
},
"switcher": {
"label": "Lingua"
}
}
+17
View File
@@ -0,0 +1,17 @@
{
"nav": {
"overview": "Przegląd",
"lifeMap": "Mapa życia",
"devView": "Widok dev"
},
"quickLinks": {
"pdfCv": "CV w PDF",
"contact": "Kontakt"
},
"footer": {
"servedFrom": "Hostowane na moim serwerze · k8s · Terraform"
},
"switcher": {
"label": "Język"
}
}
+66 -1
View File
@@ -1,6 +1,71 @@
// https://nuxt.com/docs/api/configuration/nuxt-config
import { SITE } from './site.config.mjs'
export default defineNuxtConfig({
compatibilityDate: '2025-07-15',
devtools: { enabled: true },
modules: ['@nuxt/eslint']
modules: ['@nuxt/eslint', '@nuxtjs/tailwindcss', '@nuxt/icon/module', '@nuxtjs/seo', '@nuxtjs/i18n'],
// Shared by sitemap, robots, canonical URLs, Open Graph and schema.org.
site: {
url: SITE.url,
name: SITE.name,
description: SITE.description,
defaultLocale: SITE.locale,
},
// The social card is a static file (`public/og-image.png`, generated by
// `pnpm og-image`), so the dynamic renderer and its native dependency stay
// out of the build. SEO Utils still emits the og:image and twitter:image tags.
ogImage: false,
// The site is shipped as static files inside the gateway image, so there are
// no old chunk files to keep alive and no CI cache to restore them from.
skewProtection: false,
// A CV is about a person, so the site identity is a Person node; this links
// the auto-generated WebSite/WebPage graph to that person.
schemaOrg: {
identity: {
type: 'Person',
name: SITE.name,
url: SITE.url,
description: SITE.description,
jobTitle: SITE.role,
email: SITE.email,
sameAs: [SITE.github],
},
},
icon: {
// Inline SVG instead of the CSS/mask mode, so icons exist in the SSR HTML
// and survive with JavaScript disabled.
mode: 'svg',
// Only bundle the icons the source actually names, not the whole set.
serverBundle: { collections: [] },
clientBundle: { scan: true }
},
app: {
head: {
link: [
// Generated from app/utils/avatar.js by `pnpm favicon`.
{ rel: 'icon', type: 'image/svg+xml', href: '/favicon.svg' },
{ rel: 'icon', type: 'image/x-icon', href: '/favicon.ico', sizes: '32x32' }
],
meta: [
// Matches the page background, so mobile browser chrome blends in.
{ name: 'theme-color', content: '#031428' }
]
}
},
tailwindcss: {
cssPath: '~/assets/css/main.css'
},
i18n: {
// Absolute URLs for hreflang and the per-locale sitemaps.
baseUrl: SITE.url,
defaultLocale: 'en',
locales: [
{ code: 'en', language: 'en', name: 'English', file: 'en.json' },
{ code: 'de', language: 'de', name: 'Deutsch', file: 'de.json' },
{ code: 'es', language: 'es', name: 'Español', file: 'es.json' },
{ code: 'it', language: 'it', name: 'Italiano', file: 'it.json' },
{ code: 'pl', language: 'pl', name: 'Polski', file: 'pl.json' }
]
}
})
+13 -3
View File
@@ -1,8 +1,11 @@
{
"name": "nuxt-app",
"version": "1.0.0",
"version": "1.4.0",
"type": "module",
"private": true,
"engines": {
"node": "^22.22.3 || ^24.15.0 || >=26.0.0"
},
"scripts": {
"build": "nuxt build",
"dev": "nuxt dev",
@@ -11,10 +14,17 @@
"postinstall": "nuxt prepare",
"lint": "eslint .",
"lint:fix": "eslint . --fix",
"typecheck": "nuxt typecheck"
"typecheck": "nuxt typecheck",
"favicon": "node scripts/generate-favicon.mjs",
"og-image": "node scripts/generate-og-image.mjs"
},
"dependencies": {
"nuxt": "^4.6.2",
"@iconify-json/material-symbols": "^1.2.95",
"@nuxt/icon": "2.6.2",
"@nuxtjs/i18n": "10.6.0",
"@nuxtjs/seo": "6.0.1",
"@nuxtjs/tailwindcss": "6.14.0",
"nuxt": "^4.6.3",
"vue": "^3.5.43",
"vue-router": "^5.4.0"
},
+3846 -380
View File
File diff suppressed because it is too large. Load diff
+43
View File
@@ -1,6 +1,48 @@
allowBuilds:
esbuild: true
unrs-resolver: true
auditConfig:
# Reviewed ignores for advisories with NO patched release, or whose patch
# is incompatible with a consumer in this tree. braces is unfixable
# (3.0.3 is still newest); minimatch's patch (11.0.1) breaks ESLint -
# both are build-time-only paths. node-forge was removed from this list
# on 2026-10-31 when 1.4.1 shipped and is now forced through `overrides`.
# Remove an entry when a compatible patched version ships.
ignoreGhsas:
- GHSA-vfj7-8cjw-p6xm
# GHSA-g3hv-75wg-m249 (minimatch DoS): the patched 11.0.1 dropped the
# `makeRe` export that eslint-plugin-import-x imports, so `pnpm lint`
# fails with "does not provide an export named 'makeRe'"; forcing it
# also breaks ESLint's config loader. Affected paths are build/lint
# only (Nitro, i18n, ESLint via vite-plugin-checker), never in the
# server bundle.
- GHSA-g3hv-75wg-m249
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
# GHSA-f86p-h4j2-7qgj and GHSA-9wx9-5pv9-3349 (moderate, 2026-10-30):
# seroval < 1.6.11 allows code/script injection through serialized output.
# Nuxt's vite-builder still resolves 1.6.9; the patched 1.6.11 is the
# smallest version that clears both advisories. Remove this when Nuxt ships
# a vite-builder that resolves >= 1.6.11 itself.
seroval: 1.6.11
# GHSA-g3hv-75wg-m249 (moderate, 2026-10-31): minimatch < 11.0.1 has a
# globparts amplification DoS. Deliberately NOT overridden - see the
# auditConfig ignore note above.
# GHSA-3g3m-2fjr-6pw4 (moderate, 2026-10-31): glob 9.0.0-14.0.1 bypasses
# AbortSignal cancellation. Patched in 14.0.2; the range keeps glob 7 for
# tailwind-config-viewer.
"glob@>=9.0.0 <=14.0.1": 14.0.2
# node-forge 1.4.1 shipped (2026-10-31) and clears every node-forge
# advisory that was previously ignored - no ignore needed anymore.
node-forge: 1.4.1
minimumReleaseAgeExclude:
- '@rollup/rollup-darwin-x64@4.64.8'
- '@rollup/rollup-freebsd-arm64@4.64.8'
@@ -13,3 +55,4 @@ minimumReleaseAgeExclude:
- '@rollup/rollup-openbsd-x64@4.64.8'
- '@rollup/rollup-openharmony-arm64@4.64.8'
- '@rollup/rollup-win32-ia32-msvc@4.64.8'
- '@nuxt/icon@2.6.0'
Binary file not shown.

Before

Width:  |  Height:  |  Size: 4.2 KiB

After

Width:  |  Height:  |  Size: 4.2 KiB

+65
View File
@@ -0,0 +1,65 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" width="32" height="32" shape-rendering="crispEdges">
<rect width="32" height="32" fill="#1b2b3f"/>
<rect x="10" y="0" width="12" height="1" fill="#4a2f1d"/>
<rect x="9" y="1" width="14" height="1" fill="#4a2f1d"/>
<rect x="8" y="2" width="16" height="1" fill="#4a2f1d"/>
<rect x="8" y="3" width="16" height="1" fill="#4a2f1d"/>
<rect x="8" y="4" width="2" height="1" fill="#4a2f1d"/>
<rect x="10" y="4" width="12" height="1" fill="#f2cfa5"/>
<rect x="22" y="4" width="2" height="1" fill="#4a2f1d"/>
<rect x="8" y="5" width="1" height="1" fill="#4a2f1d"/>
<rect x="9" y="5" width="14" height="1" fill="#f2cfa5"/>
<rect x="23" y="5" width="1" height="1" fill="#4a2f1d"/>
<rect x="8" y="6" width="1" height="1" fill="#f2cfa5"/>
<rect x="9" y="6" width="14" height="1" fill="#101418"/>
<rect x="23" y="6" width="1" height="1" fill="#f2cfa5"/>
<rect x="8" y="7" width="1" height="1" fill="#f2cfa5"/>
<rect x="9" y="7" width="1" height="1" fill="#101418"/>
<rect x="10" y="7" width="1" height="1" fill="#cfe3ff"/>
<rect x="11" y="7" width="2" height="1" fill="#2e3a45"/>
<rect x="13" y="7" width="2" height="1" fill="#cfe3ff"/>
<rect x="15" y="7" width="2" height="1" fill="#101418"/>
<rect x="17" y="7" width="2" height="1" fill="#cfe3ff"/>
<rect x="19" y="7" width="2" height="1" fill="#2e3a45"/>
<rect x="21" y="7" width="1" height="1" fill="#cfe3ff"/>
<rect x="22" y="7" width="1" height="1" fill="#101418"/>
<rect x="23" y="7" width="1" height="1" fill="#f2cfa5"/>
<rect x="8" y="8" width="1" height="1" fill="#f2cfa5"/>
<rect x="9" y="8" width="1" height="1" fill="#101418"/>
<rect x="10" y="8" width="5" height="1" fill="#cfe3ff"/>
<rect x="15" y="8" width="2" height="1" fill="#101418"/>
<rect x="17" y="8" width="5" height="1" fill="#cfe3ff"/>
<rect x="22" y="8" width="1" height="1" fill="#101418"/>
<rect x="23" y="8" width="1" height="1" fill="#f2cfa5"/>
<rect x="8" y="9" width="16" height="1" fill="#f2cfa5"/>
<rect x="8" y="10" width="7" height="1" fill="#f2cfa5"/>
<rect x="15" y="10" width="2" height="1" fill="#e0b58f"/>
<rect x="17" y="10" width="7" height="1" fill="#f2cfa5"/>
<rect x="8" y="11" width="6" height="1" fill="#f2cfa5"/>
<rect x="14" y="11" width="4" height="1" fill="#c26e57"/>
<rect x="18" y="11" width="6" height="1" fill="#f2cfa5"/>
<rect x="10" y="12" width="12" height="1" fill="#f2cfa5"/>
<rect x="13" y="13" width="6" height="1" fill="#f2cfa5"/>
<rect x="10" y="14" width="12" height="1" fill="#12151a"/>
<rect x="9" y="15" width="14" height="1" fill="#12151a"/>
<rect x="8" y="16" width="16" height="1" fill="#12151a"/>
<rect x="7" y="17" width="18" height="1" fill="#12151a"/>
<rect x="6" y="18" width="8" height="1" fill="#12151a"/>
<rect x="14" y="18" width="1" height="1" fill="#e8e8e8"/>
<rect x="15" y="18" width="2" height="1" fill="#12151a"/>
<rect x="17" y="18" width="1" height="1" fill="#e8e8e8"/>
<rect x="18" y="18" width="8" height="1" fill="#12151a"/>
<rect x="4" y="19" width="24" height="1" fill="#12151a"/>
<rect x="3" y="20" width="26" height="1" fill="#12151a"/>
<rect x="2" y="21" width="28" height="1" fill="#12151a"/>
<rect x="1" y="22" width="30" height="1" fill="#12151a"/>
<rect x="0" y="23" width="32" height="1" fill="#12151a"/>
<rect x="0" y="24" width="32" height="1" fill="#12151a"/>
<rect x="0" y="25" width="32" height="1" fill="#12151a"/>
<rect x="0" y="26" width="32" height="1" fill="#12151a"/>
<rect x="0" y="27" width="32" height="1" fill="#12151a"/>
<rect x="0" y="28" width="32" height="1" fill="#12151a"/>
<rect x="0" y="29" width="32" height="1" fill="#12151a"/>
<rect x="0" y="30" width="32" height="1" fill="#12151a"/>
<rect x="0" y="31" width="32" height="1" fill="#12151a"/>
</svg>

After

Width:  |  Height:  |  Size: 3.6 KiB

Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
+1
View File
@@ -0,0 +1 @@
Noel Sabia — Programmer, AI Assisted Coder, Arch user. Pixel portrait next to the CV title, with the line "Every chapter runs as a real Kubernetes workload — knock it down and watch it recover."
Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

-2
View File
@@ -1,2 +0,0 @@
User-Agent: *
Disallow:
+1
View File
@@ -3,6 +3,7 @@
"release-type": "node",
"include-component-in-tag": false,
"separate-pull-requests": false,
"changelog-host": "https://git.noelsabia.dev",
"packages": {
".": {
"package-name": "CV_Site_Frontend",
+4
View File
@@ -0,0 +1,4 @@
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"automerge": true
}
+110
View File
@@ -0,0 +1,110 @@
// Generates public/favicon.svg and public/favicon.ico from the pixel avatar in
// app/utils/avatar.js, so the sprite exists once. Run with `pnpm favicon`.
//
// No image library: the sprite is 32x32 cells, so the ICO is written as an
// uncompressed 32bpp BMP inside a one-image ICO container (4.2 kB), and the SVG
// merges each run of same-coloured cells per row into one rect.
import { mkdirSync, writeFileSync } from 'node:fs'
import { join } from 'node:path'
import { AVATAR_PALETTE, AVATAR_SPRITE } from '../app/utils/avatar.js'
const SIZE = 32
// Same chip colour the logo sits on in the header, so the portrait stays
// readable on a dark browser tab bar. Set to null for a transparent icon.
const BACKGROUND = '#1b2b3f'
const OUT_DIR = join(import.meta.dirname, '..', 'public')
const hex = (value) => {
const n = Number.parseInt(value.slice(1), 16)
return [n >> 16 & 0xff, n >> 8 & 0xff, n & 0xff]
}
const colorAt = (x, y) => {
const cell = AVATAR_SPRITE[y]?.[x] ?? '.'
return AVATAR_PALETTE[cell] ?? BACKGROUND
}
// --- SVG -------------------------------------------------------------------
const svg = () => {
const rects = []
for (let y = 0; y < SIZE; y++) {
let x = 0
while (x < SIZE) {
const color = colorAt(x, y)
let run = 1
while (x + run < SIZE && colorAt(x + run, y) === color) run++
if (color && color !== BACKGROUND) rects.push(`<rect x="${x}" y="${y}" width="${run}" height="1" fill="${color}"/>`)
x += run
}
}
const background = BACKGROUND
? `<rect width="${SIZE}" height="${SIZE}" fill="${BACKGROUND}"/>`
: ''
return [
`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${SIZE} ${SIZE}" width="${SIZE}" height="${SIZE}" shape-rendering="crispEdges">`,
...(background ? [background] : []),
...rects,
'</svg>',
// Keep the trailing newline: the end-of-file-fixer pre-commit hook wants it.
'',
].join('\n')
}
// --- ICO -------------------------------------------------------------------
const ico = () => {
const xorSize = SIZE * SIZE * 4
const maskRow = Math.ceil(SIZE / 32) * 4
const maskSize = maskRow * SIZE
const bitmap = Buffer.alloc(40 + xorSize + maskSize)
bitmap.writeUInt32LE(40, 0) // BITMAPINFOHEADER size
bitmap.writeInt32LE(SIZE, 4) // width
bitmap.writeInt32LE(SIZE * 2, 8) // height: XOR image + AND mask
bitmap.writeUInt16LE(1, 12) // planes
bitmap.writeUInt16LE(32, 14) // bits per pixel
bitmap.writeUInt32LE(xorSize + maskSize, 20) // image size
// XOR bitmap: bottom-up rows of BGRA. With a null BACKGROUND the pixel stays
// zeroed and alpha 0, which is how a 32bpp ICO carries transparency.
let offset = 40
for (let y = SIZE - 1; y >= 0; y--) {
for (let x = 0; x < SIZE; x++) {
const color = colorAt(x, y)
const [r, g, b] = color ? hex(color) : [0, 0, 0]
bitmap[offset++] = b
bitmap[offset++] = g
bitmap[offset++] = r
bitmap[offset++] = color ? 0xff : 0
}
}
// AND mask stays zeroed: 32bpp readers use the alpha channel instead.
const header = Buffer.alloc(6)
header.writeUInt16LE(0, 0) // reserved
header.writeUInt16LE(1, 2) // type: icon
header.writeUInt16LE(1, 4) // image count
const entry = Buffer.alloc(16)
entry[0] = SIZE // width
entry[1] = SIZE // height
entry[2] = 0 // palette colours
entry[3] = 0 // reserved
entry.writeUInt16LE(1, 4) // planes
entry.writeUInt16LE(32, 6) // bits per pixel
entry.writeUInt32LE(bitmap.length, 8)
entry.writeUInt32LE(header.length + entry.length, 12)
return Buffer.concat([header, entry, bitmap])
}
// --- write -----------------------------------------------------------------
mkdirSync(OUT_DIR, { recursive: true })
const svgFile = join(OUT_DIR, 'favicon.svg')
const icoFile = join(OUT_DIR, 'favicon.ico')
writeFileSync(svgFile, svg())
writeFileSync(icoFile, ico())
console.log(`wrote ${svgFile} and ${icoFile}`)
+117
View File
@@ -0,0 +1,117 @@
// Generates public/og-image.png (1200x630) and its alt text from the site
// metadata and the pixel avatar. Run with `pnpm og-image`.
//
// Needs two system tools that the rest of the project does not:
// woff2_decompress (font/woff2) - turns the self-hosted woff2 files into
// TTF, because librsvg cannot read woff2
// rsvg-convert (librsvg) - rasterizes the SVG card
// The generated PNG is committed, so neither tool is needed to build or deploy.
import { execFileSync } from 'node:child_process'
import { copyFileSync, mkdirSync, writeFileSync } from 'node:fs'
import { join } from 'node:path'
import { SITE } from '../site.config.mjs'
import { AVATAR_PALETTE, AVATAR_SPRITE } from '../app/utils/avatar.js'
const WIDTH = 1200
const HEIGHT = 630
const ROOT = join(import.meta.dirname, '..')
const OUT_DIR = join(ROOT, 'public')
const FONT_DIR = join(ROOT, 'node_modules', '.cache', 'og-image-fonts')
// Brand fonts, normalised name -> file in public/fonts.
const FONTS = [
['Inter', 'inter-var.woff2'],
['JetBrains Mono', 'jetbrains-mono-var.woff2'],
// The variable Newsreader file carries its optical-size name.
['Newsreader 16pt', 'newsreader-var.woff2'],
]
// --- fonts -----------------------------------------------------------------
const prepareFonts = () => {
mkdirSync(FONT_DIR, { recursive: true })
for (const [, file] of FONTS) {
copyFileSync(join(ROOT, 'public', 'fonts', file), join(FONT_DIR, file))
execFileSync('woff2_decompress', [join(FONT_DIR, file)], { stdio: 'ignore' })
}
const conf = join(FONT_DIR, 'fonts.conf')
writeFileSync(conf, `<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
<dir>${FONT_DIR}</dir>
<cachedir>${join(FONT_DIR, 'cache')}</cachedir>
</fontconfig>
`)
return conf
}
// --- card ------------------------------------------------------------------
const avatar = () => {
const scale = 8
const x = 88
const y = (HEIGHT - 32 * scale) / 2
const cells = []
for (let row = 0; row < 32; row++) {
for (let col = 0; col < 32; col++) {
const color = AVATAR_PALETTE[AVATAR_SPRITE[row][col]]
if (!color) continue
cells.push(
`<rect x="${col}" y="${row}" width="1" height="1" fill="${color}"/>`,
)
}
}
return [
// Chip, the same surface the avatar sits on in the header.
`<rect x="${x}" y="${y}" width="${32 * scale}" height="${32 * scale}" fill="#1b2b3f"/>`,
`<rect x="${x}" y="${y}" width="${32 * scale}" height="${32 * scale}" fill="none" stroke="#2a3a4f" stroke-width="1"/>`,
`<g transform="translate(${x} ${y}) scale(${scale})" shape-rendering="crispEdges">`,
...cells,
'</g>',
].join('\n')
}
const card = () => {
const textX = 400
const textRight = WIDTH - 88
const mono = `font-family="'JetBrains Mono', monospace"`
const sans = `font-family="'Inter', sans-serif"`
const serif = `font-family="'Newsreader 16pt', serif"`
return `<svg xmlns="http://www.w3.org/2000/svg" width="${WIDTH}" height="${HEIGHT}" viewBox="0 0 ${WIDTH} ${HEIGHT}">
<rect width="${WIDTH}" height="${HEIGHT}" fill="#031428"/>
<rect x="24" y="24" width="${WIDTH - 48}" height="${HEIGHT - 48}" fill="none" stroke="#1b2b3f" stroke-width="1"/>
${avatar()}
<circle cx="${textX + 5}" cy="194" r="5" fill="#4ae176"/>
<text x="${textX + 22}" y="200" ${mono} font-size="16" letter-spacing="3" fill="#a9c9f7">SYS_ORCHESTRATOR // RESILIENCE LABS</text>
<text x="${textX}" y="312" ${serif} font-size="88" fill="#d3e4ff">${SITE.name}</text>
<text x="${textX}" y="362" ${sans} font-size="27" fill="#c3c6cf">${SITE.role}</text>
<line x1="${textX}" y1="400" x2="${textRight}" y2="400" stroke="#1b2b3f" stroke-width="1"/>
<text x="${textX}" y="446" ${sans} font-size="21" fill="#8d9199">Every chapter runs as a real Kubernetes workload —</text>
<text x="${textX}" y="478" ${sans} font-size="21" fill="#8d9199">knock it down and watch it recover.</text>
<circle cx="${textX + 5}" cy="552" r="5" fill="#4ae176"/>
<text x="${textX + 22}" y="558" ${mono} font-size="18" fill="#c3c6cf">noelsabia.dev</text>
<text x="${textRight}" y="558" ${mono} font-size="14" letter-spacing="2" fill="#8d9199" text-anchor="end">CV // ${new Date().getUTCFullYear()}</text>
</svg>
`
}
// --- write -----------------------------------------------------------------
const fontsConf = prepareFonts()
const svgFile = join(FONT_DIR, 'og-image.svg')
const pngFile = join(OUT_DIR, 'og-image.png')
writeFileSync(svgFile, card())
execFileSync(
'rsvg-convert',
['-w', String(WIDTH), '-h', String(HEIGHT), svgFile, '-o', pngFile],
{ env: { ...process.env, FONTCONFIG_FILE: fontsConf }, stdio: 'inherit' },
)
writeFileSync(
join(OUT_DIR, 'og-image.alt.txt'),
`${SITE.name} — ${SITE.role}. Pixel portrait next to the CV title, with the line "Every chapter runs as a real Kubernetes workload — knock it down and watch it recover."\n`,
)
console.log(`wrote ${pngFile} and ${join(OUT_DIR, 'og-image.alt.txt')}`)
+205
View File
@@ -0,0 +1,205 @@
// Repairs the release-please state that its Gitea fork cannot recover from.
//
// Why this exists (evidence in OKF_Nuxt/decisions/release-engineering.md):
//
// Gitea rewrites a merged PR's `head.ref` to `refs/pull/<n>/head` when the
// head branch is deleted. The fork parses that field as the release branch,
// logs `Bad branch name`, creates no tag - and still exits successfully.
// The merged PR keeps `autorelease: pending`, so every later run aborts with
// `There are untagged, merged release PRs outstanding` and opens no new
// release PR. That is a permanent deadlock, not a transient failure.
//
// This script runs before the action and reconciles the state:
//
// * a merged pending PR whose merge commit already has the expected
// `v<manifest version>` tag -> swap `autorelease: pending` for
// `autorelease: tagged` (the release exists, only the label is stale);
// * a merged pending PR whose head branch is gone and has no expected tag
// -> create the tag from the version recorded in the manifest at that
// merge commit. This is exactly the tag release-please would have made if
// the branch had survived; without it the PR blocks every future release;
// * a merged pending PR whose head branch still exists -> leave it alone,
// release-please tags it in the same run.
//
// Pending PRs are looked up by the label itself, not by paging through every
// closed PR: the set is tiny (normally zero or one) and cannot race with PRs
// closing while the pages are being read.
//
// Run locally against the public API with:
// DRY_RUN=1 node scripts/reconcile-release-please.mjs
// Reads work unauthenticated for a public repository; writes are skipped.
const API_URL = process.env.GITHUB_API_URL
const REPOSITORY = process.env.GITHUB_REPOSITORY
const TOKEN = process.env.GITEA_TOKEN
const DRY_RUN = process.env.DRY_RUN === '1' || process.argv.includes('--dry-run')
const PENDING = 'autorelease: pending'
const TAGGED = 'autorelease: tagged'
const MANIFEST = '.release-please-manifest.json'
if (!API_URL || !REPOSITORY) {
console.error('::error::GITHUB_API_URL and GITHUB_REPOSITORY must be set')
process.exit(1)
}
if (!TOKEN && !DRY_RUN) {
console.error('::error::GITEA_TOKEN is required (or set DRY_RUN=1)')
process.exit(1)
}
const repoUrl = `${API_URL}/repos/${REPOSITORY}`
const api = async (path, init = {}) => {
const response = await fetch(`${repoUrl}${path}`, {
...init,
headers: {
Accept: 'application/json',
...(TOKEN ? { Authorization: `token ${TOKEN}` } : {}),
...(init.headers ?? {}),
},
})
const body = await response.text()
if (!response.ok) {
throw new Error(`${init.method ?? 'GET'} ${path} -> HTTP ${response.status}: ${body.slice(0, 300)}`)
}
return body ? JSON.parse(body) : null
}
// Gitea caps page size at 50. The label-filtered issue list is normally one
// page; loop anyway so a backlog of stale pending PRs is still reconciled.
const listAll = async (path, params = {}) => {
const items = []
for (let page = 1; ; page++) {
const query = new URLSearchParams({ ...params, limit: '50', page: String(page) })
const batch = await api(`${path}?${query}`)
items.push(...batch)
if (batch.length < 50) return items
}
}
const replaceLabels = async (number, labels) => {
if (DRY_RUN) {
console.log(`[dry-run] #${number}: labels -> ${labels.join(', ')}`)
return
}
await api(`/issues/${number}/labels`, {
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ labels }),
})
}
const createTag = async (name, sha) => {
if (DRY_RUN) {
console.log(`[dry-run] create tag ${name} at ${sha}`)
return
}
await api('/tags', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ tag_name: name, target: sha, message: `Release ${name}` }),
})
}
const versionAt = async (sha) => {
const file = await api(`/contents/${MANIFEST}?ref=${sha}`)
if (!file?.content) throw new Error(`no manifest content at ${sha}`)
const manifest = JSON.parse(Buffer.from(file.content, 'base64').toString('utf8'))
// Single-package repository: the root path is ".". Keep a fallback so a
// future second package cannot silently produce `vundefined`.
const version = manifest['.'] ?? Object.values(manifest)[0]
if (!version) throw new Error(`manifest at ${sha} has no version`)
return version
}
const run = async () => {
// One tag can point at the merge commit for a non-release reason (CI
// tooling, a manual annotation). Only the `v<manifest version>` tag proves
// the release exists; every other tag at that commit is ignored.
const tags = await listAll('/tags')
const tagsAtSha = new Map()
const tagSha = new Map()
for (const tag of tags) {
const sha = tag.commit?.sha
if (!sha) continue
if (!tagsAtSha.has(sha)) tagsAtSha.set(sha, [])
tagsAtSha.get(sha).push(tag.name)
tagSha.set(tag.name, sha)
}
const pendingIssues = await listAll('/issues', {
state: 'closed',
type: 'pulls',
labels: PENDING,
})
if (pendingIssues.length === 0) {
console.log('No merged release PR is pending - nothing to reconcile.')
return
}
const failures = []
const versionCache = new Map()
for (const issue of pendingIssues) {
const pull = await api(`/pulls/${issue.number}`)
if (!pull.merged_at) continue
const mergeSha = pull.merge_commit_sha
if (!mergeSha) {
failures.push(`#${pull.number}: merged PR has no merge_commit_sha`)
continue
}
const headRef = pull.head?.ref ?? ''
const branchGone = headRef.startsWith('refs/pull/') || headRef === ''
const labels = (pull.labels ?? []).map(label => label.name)
if (!versionCache.has(mergeSha)) versionCache.set(mergeSha, await versionAt(mergeSha))
const expectedTag = `v${versionCache.get(mergeSha)}`
const tagsHere = tagsAtSha.get(mergeSha) ?? []
if (tagsHere.includes(expectedTag)) {
console.log(`#${pull.number}: ${expectedTag} already points at merge commit ${mergeSha} - marking as tagged`)
const next = labels.filter(name => name !== PENDING)
if (!next.includes(TAGGED)) next.push(TAGGED)
await replaceLabels(pull.number, next)
continue
}
if (tagsHere.length > 0) {
console.log(`#${pull.number}: ignoring non-release tag(s) at merge commit: ${tagsHere.join(', ')}`)
}
if (!branchGone) {
console.log(`#${pull.number}: head branch ${headRef} still exists - leaving it for release-please to tag`)
continue
}
// The branch is gone and the expected tag is missing, so release-please
// will never get past `Bad branch name` for this PR. Recreate the tag it
// should have made, using the version the merged release PR wrote into the
// manifest.
try {
if (tagSha.has(expectedTag)) {
throw new Error(`${expectedTag} already exists at ${tagSha.get(expectedTag)}, not at merge commit ${mergeSha}; refusing to move a release tag`)
}
console.log(`#${pull.number}: head branch is gone (${headRef}) - creating ${expectedTag} at ${mergeSha}`)
await createTag(expectedTag, mergeSha)
const next = labels.filter(name => name !== PENDING)
if (!next.includes(TAGGED)) next.push(TAGGED)
await replaceLabels(pull.number, next)
}
catch (error) {
failures.push(`#${pull.number}: ${error.message}`)
}
}
if (failures.length > 0) {
for (const failure of failures) console.error(`::error::${failure}`)
console.error('::error::release-please state is unrecoverable automatically; repair the PR/tag by hand before the next release')
process.exit(1)
}
}
run().catch((error) => {
console.error(`::error::${error.message}`)
process.exit(1)
})
+16
View File
@@ -0,0 +1,16 @@
// Single source for the site metadata that Nuxt SEO, schema.org and the
// generated OG card all read. Plain ESM so `nuxt.config.ts` and the scripts in
// `scripts/` can import it without a loader.
export const SITE = {
url: 'https://noelsabia.dev',
name: 'Noel Sabia',
role: 'Programmer, AI Assisted Coder, Arch user',
description:
'Interactive CV of Noel Sabia, infrastructure and AI engineer: every chapter runs as a Kubernetes workload you can knock down and watch recover.',
// One language tag: `defaultLocale` ends up in <html lang> and og:locale.
// German needs @nuxtjs/i18n and a real translation before it can be listed.
locale: 'en',
email: 'noel@noelsabia.dev',
github: 'https://github.com/NoelSabia',
}
+103
View File
@@ -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' }],
},
},
},
}