docs(okf): record CI/CD, AI review, release and secrets decisions
PR Check / Dockerfile lint (droast) (pull_request) Skipped
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 36s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / AI code review (opencode) (pull_request) Failing after 13s
PR Check / Dockerfile lint (droast) (pull_request) Skipped
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 36s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Successful in 9s
PR Check / AI code review (opencode) (pull_request) Failing after 13s
Four new decision documents covering the pipeline work: layering, AI review setup (provider prefix, v2 CLI, env-only auth, verdict gate), release engineering (release-please manifest mode), and the Snyk pause with the token scope policy. Index grouped, log extended, open questions updated.
This commit is contained in:
1 parent
c70f5d7963
commit
7bf649cba6
8 files changed
+302
-2
No files matched your search
@@ -4,13 +4,39 @@ okf_version: "0.2"
|
||||
|
||||
# Start here
|
||||
|
||||
This bundle explains the Nuxt repository: how it is developed, checked,
|
||||
released, and what was learned getting there. It is the "why" behind the
|
||||
config files — the configs say what, these documents say why.
|
||||
|
||||
* [Open questions](open-questions.md) - What is still undecided for the Nuxt site.
|
||||
* [Update log](log.md) - History of changes to this bundle.
|
||||
|
||||
# Decisions
|
||||
|
||||
## CI/CD and releases (2026-10-18)
|
||||
|
||||
* [PR pipeline layering](decisions/pr-pipeline-layering.md) - Three layers: pre-commit for cheap deterministic checks, Gitea Actions for thorough ones, AI review for judgment.
|
||||
* [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.
|
||||
* [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.
|
||||
|
||||
## Docker and development environment
|
||||
|
||||
* [Dev container shape](decisions/dev-container-shape.md) - The source is bind-mounted into a container that already holds the dependencies, and the dev server runs as the image's `node` user.
|
||||
* [Build layer order](decisions/build-layer-order.md) - Why the manifests are copied before the source, and what invalidates what.
|
||||
* [Build context filter](decisions/build-context-filter.md) - What `.dockerignore` may exclude, and the one thing it must never exclude.
|
||||
* [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.
|
||||
|
||||
# The one-paragraph history
|
||||
|
||||
The repository started as the Nuxt app shell. Docker development (dev
|
||||
container, layer order, context filter) came first, then a single day of
|
||||
CI/CD work built the PR pipeline layer by layer — lint, typecheck,
|
||||
secret scan, dependency audit, Dockerfile lint, AI review — fixing one
|
||||
real failure per layer as it appeared (wrong provider account, wrong
|
||||
CLI major version, arm64-hostile vendor images, a silently-skipping
|
||||
`hashFiles`, a prompt-injectable credential file), then wired releases
|
||||
via release-please and locked the message format with pre-commit hooks.
|
||||
The pipeline now fails loudly, posts only real reviews, and needs no
|
||||
human faith to operate.
|
||||
Reference in new issue
Block a user