- Decision
- ADR-254
- Date
- 2026-11-18
- Status
- AcceptedAccepted (owner, 2026-11-18: the owner chose W-7, W-8 with
NOTICE, and the remaining page checks, allowed the registry and OSV requests and the download of the four SBOM schema files, and asked for the browser pane of the Claude app instead of Playwright). (4) and (5) are calls of the agent; the owner may overrule them. - Mentions
- ADR-253
- Mentioned by
- ADR-255, ADR-268
Shown as written
This entry has 6 columns where the log has seven, because a cell holds the separator of the table or a column is missing. The cells follow in their order, under the label of their place.
1Decision
Extend the publication scripts to site/ and record the first checks of the nine pages of oblivios.org (gates W-7, W-8 and B-6 of the public launch design).
(1) tools/docs/build-public-docs.py copies every tracked file of site/ unchanged, scans the text files with the existing forbidden-detail scan, and now publishes docs/architecture/site-engineering-notes.md, which site/README.md links; its self-test covers a text file, a binary and a forbidden email. security@oblivios.org is an allowed address of the scan (the decision log names it as the rejected option of ADR-253).
(2) tools/sbom/build-sbom.py reads site/package-lock.json of the snapshot and lists each of its 380 registry packages as a component with licence, SHA-512 integrity, scope (dev and optional packages are marked), dependency edges resolved as npm resolves them, and the OSV advisories; the new evidence comes from tools/sbom/fetch-npm-evidence.py (evidence/npm.json, evidence/osv-npm.json).
A file of site/ with an extension or name that no rule lists fails the build, and so does a foreign copyright or licence tag in a script, page or style sheet of site/. (3) site/NOTICE is written by build-sbom.py --site-notice and the build fails when it differs from the npm components (B-6).
(4) The licence terms for npm are the allowed terms of the Rust policy plus OFL-1.1 (the two fonts, owner answer 4 of ADR-253), BlueOak-1.0.0 and Python-2.0; a package outside them fails the build unless the lockfile marks it optional. (5) zod-to-ts 1.2.0 states no licence in the registry; its own LICENSE file is MIT and npm_licences in inputs.json records that with the file's SHA-256 (site-engineering-notes.md).
(6) The checks of the pages are in site-engineering-notes.md: no overflow, no layout shift and one origin on 27 loads (9 pages at 390, 798 and 1920 px), the open menu at 390 px.
2Why and evidence
Done and read on 2026-11-18: both self-tests; a snapshot of 15 documents, 14 scripts, 1 data file and 57 files of site/ with a clean scan (fetch-npm-evidence.py is published with the other evidence scripts); build-sbom.py on that snapshot (1,238 components, 1,551 files, 380 npm components, 27 vulnerabilities, 20 of them npm) and its --check run, both documents valid against the CycloneDX 1.6 and SPDX 2.3 schemas; five mutation runs (an unexplained file, a shortened NOTICE, a changed integrity, a foreign copyright in a script, a package with no evidence), each failing with its own message; the snapshot copy of site/ builds and passes check-build.mjs with a copy of node_modules.
Findings, not assessed in any record: OSV lists 19 advisories for Astro 5.18.2 (13), sharp 0.34.5 (3), esbuild 0.27.7, zod 3.25.76 and picomatch; the 13 of Astro are fixed only in Astro 6 and 7, which need Node 22 (ADR-253), so the Node pin and the advisories are linked. Fourteen optional @img/sharp* packages carry LGPL-3.0-or-later and are not in the output (passthroughImageService()).
Not done: the regeneration of the snapshot and of sbom/ in oblivios-docs (they do not cover site/ until it is run and committed there); the nine pages by eye at 390, 798 and 1920 px and in the light scheme; the capture of requests in a clean browser profile (W-4, V-3); Safari and Firefox; the Vercel project (W-3); the claim review (C-1); oblivios.dev.
3Last cell
The owner rejects the licence terms of (4) or the MIT of (5); an assessment of the Astro advisories finds one that applies to a static build; the SBOM check fails on a snapshot that the script itself made.
Read from docs/governance/decision-log.md, entry ADR-254.