Generates the nginx rules for prerendered pages

Pages now map to their html file, other forms get one redirect, unknown URLs
get a real 404 and responses are compressed. A browser-free test suite runs the
rules against a real nginx, in CI only so far.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-01 03:00:07 +01:00
co-authored by Claude Opus 5.5
parent 4f32042410
commit 33334b889d
16 changed files with 1389 additions and 36 deletions
@@ -0,0 +1,36 @@
# Baseline checks: hosting and targets (Step 1, CP0)
- Commit: `4f32042410a8163b19c2296f99bd85c9ced79538` (branch `feature/prerendering`)
- Date: 2026-11-01
- Node: v24.16.0; pnpm: 12.11.2
- `git status --short`: empty (clean tree; no untracked files reported)
## Command results
| Command | Result | Counts and details |
|---|---|---|
| `pnpm lint` | pass (exit 0) | ESLint: no issues found |
| `pnpm format:check` | pass (exit 0) | All matched files use Prettier code style |
| `pnpm test` | pass (exit 0) | 130 test files passed (130); 1277 tests passed (1277). Coverage thresholds met: statements 96.12%, branches 94.62%, functions 97.27%, lines 96.59%. fast-check seed: `1618276745` |
| `pnpm build && pnpm e2e` | pass (exit 0) | e2e: 9 test files passed (9); 214 tests passed (214); duration 207.73 s. Build completed before the e2e run started (`&&`) |
Logs: `C:\Users\Bryan\AppData\Local\Temp\claude\k--Development-SlpSoftware-Projects-AndreaSlopFotografie\bb0a550e-5427-462f-b99b-f9db012a172a\scratchpad\b0-test.log` (test run), `C:\Users\Bryan\AppData\Local\Temp\claude\k--Development-SlpSoftware-Projects-AndreaSlopFotografie\bb0a550e-5427-462f-b99b-f9db012a172a\tasks\bbl6g4opx.output` (build and e2e).
## Tool availability
- nginx available locally: **no**. `Get-Command nginx` and `where.exe nginx` found nothing; `C:\nginx\nginx.exe` absent; `C:\Users\Bryan\scoop\apps\nginx\current\nginx.exe` absent; `NGINX_BIN` is empty.
- scoop: present; `scoop list` shows only `php 8.5.9`.
- lftp: **no** (`Get-Command lftp` found nothing).
- bash: **yes** (GNU bash 5.2.37, msys; `C:\Users\Bryan\AppData\Local\Microsoft\WindowsApps\bash.exe`).
- curl: **yes** (curl 8.12.1 from Git Bash; `C:\WINDOWS\system32\curl.exe` 8.21.0 also present).
- podman: machine `podman-machine-default` (wsl) listed, not started (`podman machine list` only, read-only).
## Checksums (SHA-256)
- `web/lighthouserc.cjs`: `717c80a2aee64ba534b01bbffcd90b6dceba6fd666dd24fb13d8d4db182bee43`
- `web/lighthouserc.desktop.cjs`: `f13d993389babd384177a0a1c601547b356d894ae97ac12177b09229a5318e04`
## State at the end of Step 1
- No server or browser left running; port 4173 is free.
- Files written by this step: `aidlc-docs/features/prerendering/construction/hosting-and-targets/code/verification-log.md` (V1 to V14 rows, V6 WITHDRAWN) and this file.
@@ -0,0 +1,22 @@
# Verification log: hosting and targets (unit 3)
Source of the points: `construction/hosting-and-targets/infrastructure-design/infrastructure-design.md` § 12. Settled-in step: § 3.2 of the code generation plan.
Status values: OK, BLOCKED, DEVIATION, WITHDRAWN, OPEN.
| V# | Point | Step | Outcome | Evidence | Status |
|---|---|---|---|---|---|
| V1 | The generated nginx file loads in a real nginx (`nginx -t`) as an `http`-level include without any other directive from the Pi; `map` before `server` works in `conf.d`. Every directive is checked against the nginx 1.30 documentation (the Pi runs 1.30.6; CI has 1.24) | 3 (documentation), 6 (real nginx) | Documentation part OK; real-nginx part OPEN (no nginx locally; waits for the CI run) | Checked against nginx.org docs on 2026-11-01: map (context http only; exact string beats regex, first regex in file order wins; ~* case-insensitive; no default gives empty), if/return/rewrite (server, location; rewrite permanent = 301, original args appended unless replacement ends in ?), try_files (server, location), error_page (http, server, location; without = keeps the status), internal (location), absolute_redirect (http, server, location; since 1.11.8, default on), autoindex (http, server, location; default off), gzip/gzip_vary/gzip_proxied/gzip_http_version/gzip_comp_level/gzip_min_length/gzip_types (http, server, location; text/html always compressed). The generated file puts map at http level (conf.d include) and all others in server or location. NOT documented by nginx.org: escaping of the rewrite replacement (BR-HST-06 relies on it; settled only by the real nginx test on //evil.example/ and /evil.example/); the safety of if with only return comes from the nginx wiki, not the page. | OPEN |
| V2 | Server-level `if ... return 301` and `rewrite ... permanent` responses carry all five headers and `Cache-Control` with real nginx; `absolute_redirect off` gives a relative `Location`; `/` works without an `index` directive | 6, 16 | | | open |
| V3 | `/soorten-fotoshoots` (file) and `/soorten-fotoshoots/` (directory) behave as in section 3.1 on nginx and preview; `/assets` and `/assets/` as well | 6, 8, 16 | | | open |
| V4 | `/404` and `/404.html` give 404 with the page and the five headers on nginx; `error_page` keeps the status; HEAD works | 6, 16 | | | open |
| V5 | A HTTP/1.0 request with `Accept-Encoding: gzip` to the generated block gets `Content-Encoding: gzip` for `.html`, `.js`, `.css`, `.svg`, `.json`, `.xml` (all sizes above 256 bytes) and not for `.woff2`/images | 6, 16 | | | open |
| V6 | Withdrawn for this unit (IIS needs a host). The checks move to the "Before go-live" list, U1 to U6 | WITHDRAWN (no host) | | | WITHDRAWN |
| V7 | `previewServer.ts`: the new `resolveRequest` contract (redirect result, query handling, `--audit-route`); unit 1 tests for BR-SRV-07 are updated (the "interim" rules become final); `pageFiles.ts` stays the single path to file mapping | 7, 8 | | | open |
| V8 | The 301 is followed by Chrome with the query string intact for `?pakket=` and `?shoot=` links, and the hydrated page has 1 title (extend the existing "URL die de server niet kent en de router wel" e2e) | 17 | | | open |
| V9 | One Lighthouse run of the 404 page on the preview audit route, and (as comparison) `/404.html` with `ignoreStatusCode`; record best-practices for both, then keep the simpler passing option (O2) | 23 (measurement-final.md) | | | open |
| V10 | lftp: dry run against a `file:` target proves that pass 1 skips all nested `*.html` and `web.config`, pass 2 uploads them, pass 3 deletes only stale files | 14 | | | open |
| V11 | `verify-deployment.sh` fails against a copy of the old nginx config (home page for `/over-mij`) and passes against the new one | 13 | | | open |
| V12 | CI: the `lighthouse` job (or a new `server-rules` job) installs nginx, `pnpm e2e` includes `serverRules.e2e.ts`, and the job fails if nginx is missing | 5, 16 | CI step added (lighthouse job): apt-get install nginx lftp, service nginx stop, nginx -v; Browsertests step has CI=true; serverRules.e2e.ts fails with "nginx ontbreekt in CI (BR-HST-24)" when nginx is missing. Gate proven locally with CI=true and no nginx (1 failed, as intended) and without CI (skip line, exit 0). The real CI run is still to come. | e2e/serverRules.e2e.ts; .gitea/workflows/continuous_integration.yaml; CI run pending | OPEN |
| V13 | `lighthouserc.cjs`: the exception table is empty on delivery unless an owner decision exists; P-HST-11 passes; `pnpm lighthouse` still starts the preview with `--audit-route` and `Local` appears for `startServerReadyPattern` | 11, 12 | | | open |
| V14 | The generated header comment fits the Pi: install path `/etc/nginx/conf.d/andreaslop-test.conf` (included from `nginx.conf:38`), no `sites-enabled`, no global `nginx.conf` change; the file works for a first install and for an update of an existing file | 3 | Header comment rewritten: install path /etc/nginx/conf.d/andreaslop-test.conf, included in http {} from nginx.conf, no sites-enabled, no global nginx.conf change, own gzip block because the Pi has none, works behind an HTTP/1.0 proxy, 444 from 00-default.conf for an unknown host (old WordPress remark removed), server_name and root adaptable, no default_server. The same file serves a first install and an update (it replaces the existing file in place). | Generated deploy/nginx/andreaslop-test.conf (lines 1-12); equals nginxTestConf() (serverConfig.test.ts sync test green) | OK |
@@ -78,6 +78,8 @@ The proxy Pi handles TLS through certbot and forwards `test.andreaslop.nl` to `1
| `proxy_cache` | An old SPA `index.html` could stay cached for `/over-mij` |
| `proxy_redirect` | Could change the relative 301s |
**Checked by the owner on 2026-11-01, reported through the Pi-Main session: no change needed on the proxy Pi.** The server block has `proxy_pass http://192.168.1.103` with Host, X-Forwarded-Proto, X-Forwarded-For and X-Real-IP, and no `proxy_http_version` (so HTTP/1.0 upstream), no change to `Accept-Encoding`, no `proxy_intercept_errors` and no `add_header`. At http level there is no gzip, `proxy_cache`, `add_header` or `proxy_buffering`. So `gzip_http_version 1.0` must stay in the new block, all headers and the 404 page come from the hosting Pi, and no cache holds old pages. `http2 on;` in the 443 block is an optional, separate improvement, out of scope for this feature.
The proxy passes an already compressed response through unchanged. If the owner wants gzip for all sites, WordPress included, the proxy Pi is the place for that, and this block can keep its own.
## Points for the generated config