Compare commits
63
Commits
47f4e64f24
...
v1.5.0
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a80c9ebf02 | ||
|
|
b1082b52fe | ||
|
|
ac2f919bf5 | ||
|
|
90ef58a8cb | ||
|
|
06e1d24977 | ||
|
|
7ffc6d73b6 | ||
|
|
1860e88156 | ||
|
|
e0c69c1b77 | ||
|
|
c00db55f98 | ||
|
|
700b1030fc | ||
|
|
5f7027bd86 | ||
|
|
e29927bef7 | ||
|
|
06508be0e0 | ||
|
|
8f4eb24e77 | ||
|
|
6dfa2c8aa6 | ||
|
|
8b7d9bce81 | ||
|
|
da28885588 | ||
|
|
723c38d2e3 | ||
|
|
636a65dd05 | ||
|
|
a43134ad83 | ||
|
|
3eac73255f | ||
|
|
b84d353dcb | ||
|
|
f5810960a8 | ||
|
|
679c0b4858 | ||
|
|
efb73378e9 | ||
|
|
a8355d976b | ||
|
|
214ec46fed | ||
|
|
c332c195a9 | ||
|
|
c626cc9c1d | ||
|
|
a129e89aec | ||
|
|
2497d91cf7 | ||
|
|
9ecf504843 | ||
|
|
a2259df877 | ||
|
|
0c937e6f80 | ||
|
|
e8ce629e1b | ||
|
|
f9ddbb7e1a | ||
|
|
0a3c90cc74 | ||
|
|
08eb042ad7 | ||
|
|
75f8a2c675 | ||
|
|
4e8aa28fd6 | ||
|
|
028b629152 | ||
|
|
67cf2328c6 | ||
|
|
ced3d8dab4 | ||
|
|
8150cd689f | ||
|
|
c3445ad55d | ||
|
|
eebd6ca697 | ||
|
|
435be63ae0 | ||
|
|
f3d3e196d0 | ||
|
|
c3cf1dfc47 | ||
|
|
ab022c9b57 | ||
|
|
f1c4227375 | ||
|
|
ccb3459e4f | ||
|
|
ce941cad2d | ||
|
|
e4b30ad944 | ||
|
|
078a49d14e | ||
|
|
93ab0c0d79 | ||
|
|
9b7222dd4d | ||
|
|
b1a2eae48a | ||
|
|
2f9f236f13 | ||
|
|
ad4e8d7bd9 | ||
|
|
1c3503fed0 | ||
|
|
24460083ff | ||
|
|
3396c4949e |
No files matched your search
@@ -229,224 +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. The event_name check is
|
||||
# load-bearing: manual (workflow_dispatch) triggers - which exist to
|
||||
# run the paused snyk job - must NOT launch a paid review, which on
|
||||
# a dispatch event has no PR to post to.
|
||||
if: ${{ github.event_name == 'pull_request' && !github.event.pull_request.draft }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
with:
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Restore opencode binary
|
||||
id: opencode-cache
|
||||
# The installer writes to $HOME/.opencode/bin. Caching it saves the
|
||||
# ~4s download+extract per run - small next to the model call, but
|
||||
# free to keep. Key includes the pinned version, so bumping the
|
||||
# version below invalidates the cached binary automatically.
|
||||
# As above, a cache outage falls back to the installer.
|
||||
continue-on-error: true
|
||||
uses: actions/cache@v4.1.0
|
||||
with:
|
||||
path: ~/.opencode/bin
|
||||
key: opencode-v2.0.32-${{ runner.os }}
|
||||
|
||||
- name: Install opencode CLI
|
||||
if: steps.opencode-cache.outputs.cache-hit != 'true'
|
||||
run: curl -fsSL https://opencode.ai/v2/install | bash -s -- -v 2.0.32
|
||||
# v2 installer is required: the classic /install URL ships only
|
||||
# OpenCode 1.x (resolved to v1.19.3 on arm64), which cannot resolve
|
||||
# model variants like "#medium" and failed with ProviderModelNotFoundError.
|
||||
# Version pinned (-v 2.0.32) so a breaking v2 release cannot fail
|
||||
# the job mid-PR; bump deliberately, not automatically.
|
||||
|
||||
- name: Add opencode to PATH
|
||||
# The installer appends the directory to $GITHUB_PATH itself, but that
|
||||
# step is skipped on a cache hit. Add it unconditionally.
|
||||
run: echo "$HOME/.opencode/bin" >> "$GITHUB_PATH"
|
||||
|
||||
- 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/claude-haiku-5-5#medium: cheap ($0.10/$0.50 per M
|
||||
# tokens) and, unlike deepseek-v4.1-flash, it has a #medium
|
||||
# reasoning variant - flash only exposes low/high/max, so every
|
||||
# review there ran at maximum effort. #medium keeps the review
|
||||
# competent without paying for max reasoning on each push.
|
||||
# History: deepseek-v4-pro#max -> deepseek-v4.1-flash#max ->
|
||||
# haiku-5-5#medium (2026-10-20). The pro endpoint failed two
|
||||
# consecutive runs with "Upstream request failed: Endpoint is
|
||||
# unavailable" before the flash switch; that fallback is recorded
|
||||
# in OKF_Nuxt/open-questions.md. NOTE the provider prefix must be
|
||||
# "opencode-go", NOT "opencode" (Zen is a different, pay-per-call
|
||||
# provider and fails with 'Insufficient account funds').
|
||||
#
|
||||
# Auth is env-only: the CLI picks up OPENCODE_API_KEY from the
|
||||
# environment (verified headless). Deliberately NO opencode.json:
|
||||
# a config file in the checkout would hold the API key in
|
||||
# plaintext, readable by the agent - a malicious PR diff could
|
||||
# prompt-inject the agent into quoting the key in the review
|
||||
# comment (publicly visible). Env vars are invisible to file reads.
|
||||
# Permissions live in a global config OUTSIDE the checkout (no
|
||||
# secrets in it, so nothing can leak). OpenCode v2 schema: the
|
||||
# field is "permissions" (plural) - an ordered array of
|
||||
# {action, resource, effect}; "bash" was renamed "shell" in v2.
|
||||
# The singular v1 "permission" object is ignored by the v2 CLI
|
||||
# (verified empirically: shell commands executed despite deny).
|
||||
# Denying shell/edit/webfetch/websearch/external_directory means
|
||||
# no headless permission prompts can hang or kill the run, and
|
||||
# the reviewer physically cannot modify the repo or browse
|
||||
# attacker-controlled URLs.
|
||||
mkdir -p "$HOME/.config/opencode"
|
||||
printf '{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"permissions": [
|
||||
{ "action": "edit", "resource": "*", "effect": "deny" },
|
||||
{ "action": "shell", "resource": "*", "effect": "deny" },
|
||||
{ "action": "webfetch", "resource": "*", "effect": "deny" },
|
||||
{ "action": "websearch", "resource": "*", "effect": "deny" },
|
||||
{ "action": "external_directory", "resource": "*", "effect": "deny" }
|
||||
]
|
||||
}' > "$HOME/.config/opencode/opencode.json"
|
||||
# --print-logs: surface auth/provider errors in the CI log instead
|
||||
# of failing with an opaque exit code
|
||||
EXIT_CODE=0
|
||||
opencode run \
|
||||
--print-logs \
|
||||
--model opencode-go/claude-haiku-5-5#medium \
|
||||
"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=$?
|
||||
# always show the output - never swallow the error text
|
||||
cat /tmp/review.md
|
||||
# The posting gate is the OUTPUT CONTRACT, not the exit code:
|
||||
# a completed review always ends with a VERDICT line - error
|
||||
# dumps never do. opencode can exit 1 on benign tool denials
|
||||
# even after a full review, so a present verdict means post;
|
||||
# anything else means the review did not complete.
|
||||
# Anchored to the tail: the prompt itself contains VERDICT
|
||||
# lines, so scanning the whole file could pass on echoed
|
||||
# prompt text or injected quotes - only the last lines count.
|
||||
if tail -n 5 /tmp/review.md | grep -qE '^VERDICT: (APPROVE|REQUEST_CHANGES)'; then
|
||||
[ "$EXIT_CODE" -ne 0 ] && echo "::warning::opencode exited ${EXIT_CODE} but produced a valid verdict - posting review"
|
||||
echo "Review completed with verdict."
|
||||
else
|
||||
# fail closed: no verdict = no review. exit 1 unconditionally -
|
||||
# falling back to EXIT_CODE would exit 0 when opencode succeeded
|
||||
# but produced no review, and the job would go green.
|
||||
echo "::error::opencode produced no valid review (exit ${EXIT_CODE:-1}) - NOT posting this output as a review comment"
|
||||
exit 1
|
||||
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: |
|
||||
# re-verify the output contract here: never post anything that is
|
||||
# not a completed review, regardless of how the previous step ended
|
||||
if ! tail -n 5 /tmp/review.md | grep -qE '^VERDICT: (APPROVE|REQUEST_CHANGES)'; then
|
||||
echo "::error::no verdict in review output - nothing to post"
|
||||
exit 1
|
||||
fi
|
||||
# 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
|
||||
@@ -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
|
||||
@@ -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,6 +17,59 @@ 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:
|
||||
# One well-scoped token for all workflow API work (see
|
||||
|
||||
@@ -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
|
||||
@@ -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
|
||||
@@ -55,6 +55,12 @@ 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
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
{
|
||||
".": "1.0.0"
|
||||
".": "1.5.0"
|
||||
}
|
||||
+226
@@ -1,5 +1,231 @@
|
||||
# Changelog
|
||||
|
||||
## [1.5.0](https://git.noelsabia.dev/CV_Website/CV_Site_Nuxt/compare/v1.4.0...v1.5.0) (2026-10-31)
|
||||
|
||||
|
||||
### Features
|
||||
|
||||
* **ci:** replace opencode review with PR-Agent ([c626cc9](https://git.noelsabia.dev/CV_Website/CV_Site_Nuxt/commit/c626cc9c1dc7db94e645d33eab3c7c7b9a860438))
|
||||
|
||||
|
||||
### Bug Fixes
|
||||
|
||||
* **ci:** check out the repo before the release-please reconcile step ([90ef58a](https://git.noelsabia.dev/CV_Website/CV_Site_Nuxt/commit/90ef58a8cb8917d547947ae0046a56b8be882114))
|
||||
* **ci:** point changelog compare links at our Gitea ([a2259df](https://git.noelsabia.dev/CV_Website/CV_Site_Nuxt/commit/a2259df877615c34311a41c1a218ff4bea169d72))
|
||||
* **ci:** repair PR-Agent model routing ([a43134a](https://git.noelsabia.dev/CV_Website/CV_Site_Nuxt/commit/a43134ad83bece7670543e557f40407892dbf48e))
|
||||
* **ci:** validate the release tag and query pending PRs by label ([7ffc6d7](https://git.noelsabia.dev/CV_Website/CV_Site_Nuxt/commit/7ffc6d73b607d697a6086a6fe17d077ffc50d5c2))
|
||||
* **deps:** sync lockfile and pin patched seroval ([3eac732](https://git.noelsabia.dev/CV_Website/CV_Site_Nuxt/commit/3eac73255ff5f5b34233576fc8cbcfa97a50d3dc))
|
||||
* **deps:** unblock the dependency audit ([e0c69c1](https://git.noelsabia.dev/CV_Website/CV_Site_Nuxt/commit/e0c69c1b7727a65b240e5bcab91dad98cd80fdec))
|
||||
|
||||
## [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)
|
||||
|
||||
|
||||
|
||||
+2
-2
@@ -16,7 +16,7 @@
|
||||
# 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:d62f13676d530f7edf97782729df69713c8ccfe6631e7f62f9ccab65968719a8 AS build
|
||||
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
|
||||
@@ -38,7 +38,7 @@ COPY . .
|
||||
RUN pnpm build
|
||||
|
||||
|
||||
FROM node:26-slim@sha256:d62f13676d530f7edf97782729df69713c8ccfe6631e7f62f9ccab65968719a8
|
||||
FROM node:26-slim@sha256:18f03e4b532a63baf09809fe8349c2171807f1818cb6c5230fb12aecd5beda65
|
||||
|
||||
# pnpm is NOT installed in the runtime image: nothing here runs pnpm.
|
||||
ENV NODE_ENV=production \
|
||||
|
||||
+1
-1
@@ -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.
|
||||
|
||||
@@ -3,7 +3,7 @@ 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: draft
|
||||
status: deprecated
|
||||
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T16:05:00Z }
|
||||
verified: { by: human:noel, at: not yet }
|
||||
sources:
|
||||
@@ -15,6 +15,10 @@ sources:
|
||||
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,
|
||||
|
||||
@@ -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.
|
||||
@@ -1,13 +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.
|
||||
* [AI review setup](ai-review-setup.md) - Plan model, env-only auth against prompt injection, read-only agent, and the verdict line as the posting gate.
|
||||
* [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.
|
||||
@@ -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.
|
||||
@@ -26,8 +26,8 @@ Every pull request is checked by three layers, ordered by cost:
|
||||
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** (per PR push): opencode with a plan-covered model,
|
||||
verdict-based, posted as a PR comment.
|
||||
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
|
||||
@@ -45,15 +45,16 @@ already passed the deterministic gates.
|
||||
|
||||
# Caching
|
||||
|
||||
Two caches, both served by the runner's own cache server (no external
|
||||
service, entries stay on the home server):
|
||||
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.
|
||||
* **opencode binary**, keyed on the pinned CLI version (`~/.opencode/bin`).
|
||||
Small next to the model call, but it removes a network fetch per review.
|
||||
|
||||
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
|
||||
@@ -71,6 +72,10 @@ 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 |
|
||||
|
||||
@@ -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).
|
||||
@@ -16,6 +16,9 @@ sources:
|
||||
- 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
|
||||
@@ -48,10 +51,138 @@ feeds this machine is enforced locally by the commitizen pre-commit hook.
|
||||
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
|
||||
|
||||
* The first release PR end to end — needs at least one `feat:`/`fix:`
|
||||
commit on `main` after the workflow merge.
|
||||
* 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.
|
||||
@@ -62,3 +193,6 @@ feeds this machine is enforced locally by the commitizen pre-commit hook.
|
||||
`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.
|
||||
@@ -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.
|
||||
@@ -31,23 +31,32 @@ patched 7.1.6 was already in the tree via `postcss-nesting` and proved
|
||||
API-compatible through a full build. The override is removed when
|
||||
`tailwindcss` ships `>= 7.1.6` itself or the site moves to Tailwind v4.
|
||||
|
||||
Currently ignored (both verified against the advisory database and the npm
|
||||
registries on 2026-10-18 - the newest published versions are the vulnerable
|
||||
ones):
|
||||
Currently ignored (verified against the advisory database and the npm
|
||||
registries on 2026-10-31):
|
||||
|
||||
* `GHSA-86w9-cpqp-85rv` - node-forge <= 1.4.0, high. Path:
|
||||
`nuxt > @nuxt/nitro-server > nitropack > listhen > node-forge` - listhen
|
||||
generates dev certificates; build/dev-time only, not in the server bundle.
|
||||
* `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 ("2 ignored: 2 high") and the decision lives in a reviewable file.
|
||||
skipped ("1 ignored: 1 high") and the decision lives in a reviewable file.
|
||||
|
||||
# The pnpm 11 lesson
|
||||
|
||||
|
||||
+9
-1
@@ -11,6 +11,7 @@ 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.
|
||||
|
||||
@@ -19,10 +20,12 @@ config files — the configs say what, these documents say why.
|
||||
## 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.
|
||||
* [AI review setup](decisions/ai-review-setup.md) - Plan model, env-only auth against prompt injection, read-only agent, verdict line as the posting gate.
|
||||
* [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
|
||||
|
||||
@@ -33,6 +36,11 @@ config files — the configs say what, these documents say why.
|
||||
* [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
|
||||
|
||||
@@ -1,5 +1,67 @@
|
||||
# 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.
|
||||
@@ -7,6 +69,26 @@
|
||||
## 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).
|
||||
|
||||
|
||||
@@ -16,7 +16,8 @@ generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T12:41:52Z }
|
||||
| Whether these decisions stay in this bundle or fold into the sibling `OKF_CV_Website` bundle, which already describes the frontend at design level | after the production image exists | None. |
|
||||
| When and how often Snyk runs once re-enabled: weekly schedule, ready-for-review gate, or per-push | re-enabling the snyk job | Stay disabled. |
|
||||
| Whether the AI review job should gate merges (required status check on the verdict) or stay advisory | branch protection setup | Advisory. The review comment is information; blocking merges on an AI verdict is a policy choice, not a technical one. |
|
||||
| How the opencode CLI version in CI gets upgraded: manually bump the pinned 2.0.32, or automate when a new major appears | first review failure after an opencode release | Manual bump. Pinning exists so upgrades are decisions. |
|
||||
| ~~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. |
|
||||
|
||||
|
||||
@@ -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`.
|
||||
@@ -27,13 +27,6 @@
|
||||
font-display: swap;
|
||||
src: url('/fonts/jetbrains-mono-var.woff2') format('woff2');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'Material Symbols Outlined';
|
||||
font-style: normal;
|
||||
font-weight: 100 700;
|
||||
font-display: block;
|
||||
src: url('/fonts/material-symbols-outlined-var.woff2') format('woff2');
|
||||
}
|
||||
|
||||
@tailwind base;
|
||||
@tailwind components;
|
||||
@@ -50,20 +43,3 @@
|
||||
margin-bottom: 0 !important;
|
||||
}
|
||||
}
|
||||
|
||||
@layer components {
|
||||
.material-symbols-outlined {
|
||||
font-family: 'Material Symbols Outlined';
|
||||
font-weight: normal;
|
||||
font-style: normal;
|
||||
line-height: 1;
|
||||
letter-spacing: normal;
|
||||
text-transform: none;
|
||||
white-space: nowrap;
|
||||
word-wrap: normal;
|
||||
direction: ltr;
|
||||
display: inline-block;
|
||||
font-variation-settings: 'FILL' 0, 'wght' 400, 'GRAD' 0, 'opsz' 24;
|
||||
-webkit-font-smoothing: antialiased;
|
||||
}
|
||||
}
|
||||
@@ -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>
|
||||
@@ -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>
|
||||
@@ -1,9 +1,9 @@
|
||||
<template>
|
||||
<footer class="w-full bg-surface-container-lowest shadow-[0_-1px_12px_rgba(0,0,0,0.3)] py-6">
|
||||
<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>Served from my own server · k8s · Terraform · self-healing on purpose</span>
|
||||
<span>{{ $t('footer.servedFrom') }}</span>
|
||||
</div>
|
||||
<div class="flex items-center gap-3 font-status-badge text-status-badge text-outline">
|
||||
<a
|
||||
|
||||
@@ -3,7 +3,11 @@
|
||||
<div class="h-16 max-w-7xl mx-auto px-6 lg:px-12 flex items-center justify-between gap-6">
|
||||
<AppLogo />
|
||||
<AppNav />
|
||||
<AppQuickLinks />
|
||||
<div 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>
|
||||
@@ -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>
|
||||
@@ -1,62 +1,15 @@
|
||||
<script setup lang="ts">
|
||||
// 32x32 sprite: '.' = transparent, letters = palette colors.
|
||||
// Head spans half the width (narrow), hoodie fills the bottom as a bust.
|
||||
// Rows: hair (0-3), hairline/forehead (4-5), glasses (6-8), face (9-12),
|
||||
// neck (13), shoulders/chest (14-31, drawstrings on 18).
|
||||
const PALETTE: Record<string, string> = {
|
||||
H: '#4a2f1d', // hair
|
||||
S: '#f2cfa5', // skin
|
||||
F: '#101418', // glasses frame
|
||||
L: '#cfe3ff', // lens glass
|
||||
P: '#2e3a45', // pupils
|
||||
N: '#e0b58f', // nose shade
|
||||
M: '#c26e57', // smile
|
||||
h: '#12151a', // hoodie
|
||||
w: '#e8e8e8', // drawstrings
|
||||
}
|
||||
import { AVATAR_PALETTE, AVATAR_SPRITE } from '~/utils/avatar'
|
||||
|
||||
const SPRITE = [
|
||||
'..........HHHHHHHHHHHH..........',
|
||||
'.........HHHHHHHHHHHHHH.........',
|
||||
'........HHHHHHHHHHHHHHHH........',
|
||||
'........HHHHHHHHHHHHHHHH........',
|
||||
'........HHSSSSSSSSSSSSHH........',
|
||||
'........HSSSSSSSSSSSSSSH........',
|
||||
'........SFFFFFFFFFFFFFFS........',
|
||||
'........SFLPPLLFFLLPPLFS........',
|
||||
'........SFLLLLLFFLLLLLFS........',
|
||||
'........SSSSSSSSSSSSSSSS........',
|
||||
'........SSSSSSSNNSSSSSSS........',
|
||||
'........SSSSSSMMMMSSSSSS........',
|
||||
'..........SSSSSSSSSSSS..........',
|
||||
'.............SSSSSS.............',
|
||||
'..........hhhhhhhhhhhh..........',
|
||||
'.........hhhhhhhhhhhhhh.........',
|
||||
'........hhhhhhhhhhhhhhhh........',
|
||||
'.......hhhhhhhhhhhhhhhhhh.......',
|
||||
'......hhhhhhhhwhhwhhhhhhhh......',
|
||||
'....hhhhhhhhhhhhhhhhhhhhhhhh....',
|
||||
'...hhhhhhhhhhhhhhhhhhhhhhhhhh...',
|
||||
'..hhhhhhhhhhhhhhhhhhhhhhhhhhhh..',
|
||||
'.hhhhhhhhhhhhhhhhhhhhhhhhhhhhhh.',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
'hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh',
|
||||
]
|
||||
const palette: Record<string, string> = AVATAR_PALETTE
|
||||
|
||||
const flat = SPRITE
|
||||
const flat = AVATAR_SPRITE
|
||||
.flatMap((row) => [...row])
|
||||
.map((cell) => PALETTE[cell] ?? 'transparent')
|
||||
.map((cell) => palette[cell] ?? 'transparent')
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<NuxtLink to="/" class="group flex items-center gap-3">
|
||||
<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
|
||||
@@ -71,7 +24,7 @@ const flat = SPRITE
|
||||
<span class="font-headline-sm text-headline-sm tracking-tight text-on-surface font-medium">Noel Sabia</span>
|
||||
<span class="font-label-mono text-label-mono text-on-surface-variant tracking-wider uppercase text-[0.625rem]">Im using Arch btw</span>
|
||||
</div>
|
||||
</NuxtLink>
|
||||
</NuxtLinkLocale>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
|
||||
@@ -1,23 +1,22 @@
|
||||
<template>
|
||||
<nav class="hidden md:flex items-center gap-1.5">
|
||||
<NuxtLink
|
||||
<nav class="hidden lg:flex items-center gap-1.5">
|
||||
<NuxtLinkLocale
|
||||
to="/"
|
||||
aria-current="page"
|
||||
class="px-3 py-1.5 transition-colors bg-primary-container text-on-primary-container font-medium rounded font-body-sm text-body-sm"
|
||||
>
|
||||
Overview
|
||||
</NuxtLink>
|
||||
{{ $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"
|
||||
>
|
||||
Life Map
|
||||
{{ $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"
|
||||
>
|
||||
Dev View
|
||||
{{ $t('nav.devView') }}
|
||||
</a>
|
||||
</nav>
|
||||
</template>
|
||||
@@ -1,8 +1,8 @@
|
||||
<template>
|
||||
<div class="hidden sm:flex items-center gap-4 text-on-surface-variant font-label-mono text-label-mono">
|
||||
<a href="#" class="hover:text-on-surface transition-colors">PDF CV</a>
|
||||
<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">Contact</a>
|
||||
<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>
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
<template>
|
||||
<div class="flex min-h-screen flex-col">
|
||||
<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>
|
||||
@@ -1,5 +1,15 @@
|
||||
<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>
|
||||
|
||||
@@ -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',
|
||||
]
|
||||
@@ -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"
|
||||
}
|
||||
}
|
||||
@@ -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"
|
||||
}
|
||||
}
|
||||
@@ -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"
|
||||
}
|
||||
}
|
||||
@@ -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"
|
||||
}
|
||||
}
|
||||
@@ -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"
|
||||
}
|
||||
}
|
||||
+63
-1
@@ -1,9 +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', '@nuxtjs/tailwindcss'],
|
||||
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' }
|
||||
]
|
||||
}
|
||||
})
|
||||
+12
-3
@@ -1,8 +1,11 @@
|
||||
{
|
||||
"name": "nuxt-app",
|
||||
"version": "1.0.0",
|
||||
"version": "1.5.0",
|
||||
"type": "module",
|
||||
"private": true,
|
||||
"engines": {
|
||||
"node": "^22.22.3 || ^24.15.0 || >=26.0.0"
|
||||
},
|
||||
"scripts": {
|
||||
"build": "nuxt build",
|
||||
"dev": "nuxt dev",
|
||||
@@ -11,11 +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": {
|
||||
"@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.2",
|
||||
"nuxt": "^4.6.3",
|
||||
"vue": "^3.5.43",
|
||||
"vue-router": "^5.4.0"
|
||||
},
|
||||
|
||||
Generated
+2866
-387
File diff suppressed because it is too large.
Load diff
+30
-7
@@ -2,15 +2,21 @@ allowBuilds:
|
||||
esbuild: true
|
||||
unrs-resolver: true
|
||||
auditConfig:
|
||||
# Reviewed ignores for advisories with NO patched release (verified against
|
||||
# the advisory database and npm registries on 2026-10-18: node-forge 1.4.0
|
||||
# and braces 3.0.3 are the newest published versions). Both packages are
|
||||
# build-time-only paths under nitropack (listhen dev-cert generation,
|
||||
# globby file globbing) - not in the running server's bundle. Remove an
|
||||
# entry when a patched version ships.
|
||||
# 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-86w9-cpqp-85rv
|
||||
- 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).
|
||||
@@ -21,6 +27,22 @@ overrides:
|
||||
# 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'
|
||||
@@ -33,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 |
@@ -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.
@@ -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 |
@@ -1,2 +0,0 @@
|
||||
User-Agent: *
|
||||
Disallow:
|
||||
@@ -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",
|
||||
|
||||
@@ -0,0 +1,4 @@
|
||||
{
|
||||
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
|
||||
"automerge": true
|
||||
}
|
||||
@@ -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}`)
|
||||
@@ -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')}`)
|
||||
@@ -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)
|
||||
})
|
||||
@@ -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',
|
||||
}
|
||||
Reference in new issue
Block a user