chore: adopt SIAX Golden Standard docs and configuration
CI (SIAX Cloud) / sonar (pull_request) Skipped
CI (SIAX Cloud) / security (pull_request) Successful in 22s
Component conformance / Component conformance (blocking) (pull_request) Failing after 40s
security / scan (push) Failing after 32s
Component conformance / Component conformance (blocking) (push) Failing after 38s
CI (SIAX Cloud) / quality (pull_request) Successful in 1m39s
CI (SIAX Cloud) / contracts (pull_request) Successful in 1m40s
CI (SIAX Cloud) / quality (push) Successful in 3m14s
CI (SIAX Cloud) / security (push) Successful in 1m34s
CI (SIAX Cloud) / contracts (push) Successful in 25s
CI (SIAX Cloud) / sonar (push) Skipped
security / scan (pull_request) Failing after 3m18s

Genererade standardartefakter ur repots egna filer (AR-1). DOC-07 lämnas avsiktligt röd tills en riktig restore är bevisad.
This commit is contained in:
2026-11-10 16:14:12 +01:00
parent e407d44482
commit e1ce3afa3f
13 changed files with 444 additions and 0 deletions
+5
View File
@@ -0,0 +1,5 @@
{
"name": "c0py",
"image": "mcr.microsoft.com/devcontainers/javascript-node:22",
"postCreateCommand": "pnpm install --frozen-lockfile"
}
+11
View File
@@ -0,0 +1,11 @@
# CI-14 — CODEOWNERS bor i .gitea/, aldrig i .github/ (SEC-25).
# Granskning krävs särskilt för kontrakt, deploy och migrationer.
* @sax3l
/contracts/ @sax3l
/deploy/ @sax3l
/.gitea/ @sax3l
/siax.repo.json @sax3l
/siax.config.json @sax3l
# TODO: lägg till migrationskatalogen när den finns, t.ex.
# /packages/db/migrations/ @sax3l
+53
View File
@@ -0,0 +1,53 @@
name: security
# CI-10 — gitleaks, Semgrep, OSV-Scanner, Trivy. Körs på PR, på push mot main
# och nattligt. Scannrarna körs som containrar för att inte kräva att runnern
# har verktygen installerade (samma mönster som siax-standards egen security.yml).
#
# FÄLLA (verifierad i siax-standards egen CI-utredning): ett stegnamn som
# innehåller ": " (kolon + mellanslag) får Giteas YAML-parser att TYST kasta
# bort hela workflowen — den dispatcheras aldrig och syns inte som fel.
# Håll därför alla `name:`-rader på steg i ren ASCII utan kolon-mellanslag.
#
# TODO (CI-10, ej wired av scaffolden): licenskontroll kräver ett policybeslut
# om vilka licenser som är tillåtna — lägg till steget när listan finns.
on:
push: { branches: [main] }
pull_request: {}
schedule:
- cron: "17 2 * * *"
permissions: { contents: read }
concurrency:
group: security-${{ github.ref }}
cancel-in-progress: true
jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with: { fetch-depth: 0 }
# gitleaks over worktree and history (REPO-15, SEC-01)
- name: gitleaks secret scan
run: |
docker run --rm -v "$PWD:/repo" -w /repo \
zricethezav/gitleaks:latest detect --source /repo --no-banner --exit-code 1
# Trivy filsystem, blockerar på HIGH och CRITICAL (SUP-*)
- name: Trivy filesystem scan
run: |
docker run --rm -v "$PWD:/repo" -w /repo \
aquasec/trivy:latest fs --scanners vuln,secret,misconfig \
--severity HIGH,CRITICAL --exit-code 1 --no-progress /repo
# Kända sårbarheter i lockfilen
- name: OSV Scanner
run: |
docker run --rm -v "$PWD:/repo" -w /repo \
ghcr.io/google/osv-scanner:latest scan source --recursive /repo
# Statisk kodanalys, felallvarlighet bryter bygget
- name: Semgrep code scan
run: |
docker run --rm -v "$PWD:/src" -w /src \
semgrep/semgrep:latest semgrep scan --config=p/ci --error --quiet
+4
View File
@@ -0,0 +1,4 @@
@siax:registry=https://git.siax.io/api/packages/siax/npm/
//git.siax.io/api/packages/siax/npm/:_authToken=${NODE_AUTH_TOKEN}
engine-strict=true
fund=false
+95
View File
@@ -0,0 +1,95 @@
# Ändringslogg — c0py
Alla väsentliga ändringar dokumenteras här. Filen är genererad ur repots
git-historik av `siax-scaffold` (DOC-11) och ska uppdateras när historiken
ändras; den ska aldrig handredigeras med påståenden som inte finns i git.
Formatet följer [Keep a Changelog](https://keepachangelog.com/sv/1.1.0/).
## [Unreleased]
Nästa version. Nya poster läggs överst när de mergas.
## 2026-11-10
- fix(build): Dockerfile.web klonar repot själv (Coolify dockerfile-app saknar källkodskontext) (`e9ea420`)
- docs(status): standardiserad STATUS.md (mekaniskt verifierad) (`c0b6dc7`)
- docs(agents): SIAX Agent Execution Policy i AGENTS.md (#2) (`2c44559`)
## 2026-11-09
- docs(production): standardiserad produktionsberedskap och gap-analys (`0d75a82`)
- ci: add blocking component conformance gate (`97605a3`)
- chore(manifest): remove superseded v2 manifest (replaced by siax.repo.v3.json) (`2037688`)
- feat(manifest): migrate siax.repo.json (v2) to siax.repo.v3.json (`5f6102e`)
## 2026-11-08
- fix(manifest): migrate to valid siax.repo.v3 (estate+repo facts) (`59f933b`)
## 2026-11-06
- chore(design): add the canonical design-conformance manifest (`9724ef1`)
## 2026-09-30
- fix(deps): patch HIGH advisories in postcss (CVE-2026-45623, CVE-2026-73646) (`1258903`)
## 2026-09-29
- fix(deploy): siax.deployment- + siax.environment-post (prod) — krävs av PROD-DEPLOYMENT/PROD-RUNTIME-MISMATCH-gaterna (`20aa9b5`)
- fix(manifest): reliability.provenRestore=true — styrkt av automatiserad restore-drill 2026-09-29 (re-c0py-2026-09-29) (`da5b99a`)
## 2026-09-28
- chore(ci): koppla in SonarQube-analys mot självhostad sonar.siax.io (`ea5fdca`)
## 2026-09-27
- ci(workflows): add job timeout-minutes and concurrency guard (`d362852`)
## 2026-09-21
- chore(backup): initial backup-policy post (RW-002 automat) — källa: flottloggar (`c0a10bc`)
## 2026-09-16
- fix(capture): a11y evidence via ariaSnapshot (page.accessibility removed in playwright >=1.5x) (`8e0e222`)
- fix(config): CL0UD_BASE_URL optional (disabled state until CL0UD machine surface exists) (`aacbf3c`)
- feat(api): CL0UD capability probe + a11y/HAR evidence + worker scale toggle (`f6ff139`)
- docs(deploy): scan worker + AUD0 wire + env contract (`b8d1aca`)
- fix(capture): run page.evaluate as plain string (tsx/esbuild __name helpers break in browser context) (`1e74c69`)
- feat(api): deterministic scan worker + AUD0 wire + tenant binding (`12f6a65`)
- docs(deploy): migration procedure + live endpoint contract (`3b98b9f`)
- feat(api): Postgres persistence for registries + scans (owner-scoped, fail-closed) (`9482a97`)
- docs(deploy): apex sidestep live (DNS-only + web domain), introspection env contract (`949e4ec`)
- feat(api): real Zitadel token introspection (fail-closed) + expected-audience enforcement (`4950507`)
- docs: CI jobs + manual-deploy doctrine in AGENTS.md (`dac7905`)
- chore(ci): remove broken Coolify auto-deploy (git-buildpack broken for monorepo, manual deploy per DEPLOY.md) (`29ee393`)
- test(core): add fidelity gate coverage (`e26398c`)
- feat(core): export reconstruction and fidelity contracts (`cfa9a05`)
- feat(core): add deterministic fidelity release gate (`52f5146`)
- feat(core): add reconstruction pipeline contracts (`762b778`)
- ci: enforce canonical architecture contracts (`ac797d3`)
- ci: wire canonical architecture validation (`cfac4cc`)
- ci: add canonical architecture policy validator (`3687e87`)
- test(core): validate upstream provenance policy (`35f1a3c`)
- docs: align agent rules with canonical reconstruction architecture (`be94228`)
- docs: redefine c0py as canonical reconstruction engine (`053b524`)
- feat(core): export provenance validation (`56e4b69`)
- feat(core): add upstream provenance registry validation (`b885a16`)
- feat(types): add canonical evidence and reconstruction contracts (`1e3abaf`)
- docs: define c0py autonomous execution workflows (`4a88f74`)
- docs: define c0py engineering and evidence standards (`982c7b1`)
- docs: add upstream capability adoption matrix (`8e44be0`)
- docs: establish canonical c0py reconstruction masterplan (`b7430f1`)
- docs: production deployment facts, DNS/TLS pattern, Coolify gotchas (`5522b3b`)
- fix: move web Dockerfile to repo root (Coolify build context = dockerfile dir) (`0840daf`)
- feat: add web Dockerfile for Next.js Coolify deploy (`16f4a5a`)
- docs: update AGENTS.md with deployment findings (`bc36298`)
- fix: add fail-closed preHandler auth check (`db3509a`)
- fix: tsx symlink after pnpm install for workspace devDeps (`64ff905`)
---
Genererad: 2026-11-10. Underlag: `git log --no-merges` (senaste 50 commits).
+10
View File
@@ -0,0 +1,10 @@
# DX-02 — lokala beroenden för C0PY.
#
# TODO: deklarera repots FAKTISKA lokala beroenden (databas, cache, objektlager,
# meddelandebuss …) så att DX-01 håller: ett kommando ska resa allt lokalt, utan
# åtkomst till produktion.
#
# Tomt värde nedan betyder "repot har inga lokala beroenden". Scaffolden kan
# inte veta om det är sant — den lämnar det tomt i stället för att hitta på
# tjänster som ingen kör.
services: {}
+72
View File
@@ -0,0 +1,72 @@
# Arkitektur — C0PY
> **Status:** automatisk första version, genererad av `siax-scaffold` ur repots
> faktiska filer. Den beskriver vad som finns, inte vad som är bestämt. Läs
> igenom, rätta och fyll i avsnitten som är markerade TODO innan dokumentet
> betraktas som en arkitekturbeskrivning (ARK-serien).
Senast verifierad mot kod: 2026-11-10
## 1. Översikt
| Fält | Värde |
| --- | --- |
| Repo | `c0py` |
| Körtid | node |
| Ramverk | okänd |
| Paketnamn | `c0py` |
| Domäner i `siax.config.json` | inga |
C0PY — canonical SIAX web product capture, digital twin, reconstruction and verification engine.
## 2. Komponenter
Toppnivåkataloger som innehåller kod eller konfiguration (härledda ur filträdet):
| Katalog | Roll |
| --- | --- |
| `apps//` | TODO: beskriv katalogens roll (apps/) |
| `packages//` | TODO: beskriv katalogens roll (packages/) |
| `scripts//` | TODO: beskriv katalogens roll (scripts/) |
| `docs//` | TODO: beskriv katalogens roll (docs/) |
Undermoduler som är deklarerade i `children[]`:
| Sökväg | Syfte |
| --- | --- |
| — | Inga undermoduler (apps/, packages/, services/) finns. |
## 3. Startpunkter
| Fil | Typ |
| --- | --- |
| — | Ingen startpunkt hittades i `package.json`, `pyproject.toml` eller `Dockerfile`. |
## 4. Språk och filfördelning
| Ändelse | Omfattning |
| --- | --- |
| .ts | 45 filer |
| .tsx | 2 filer |
| .js | 1 filer |
| .mjs | 1 filer |
## 5. Dataflöde
TODO: beskriv hur data rör sig genom repot: inkommande anrop/jobb → lagring → utdata, och vilka externa system som anropas. Scaffolden kan inte härleda detta ur filerna.
## 6. Gränser och beroenden
TODO: lista vilka SIAX-komponenter repot äger respektive konsumerar (REUSE FIRST), samt vilka kontrakt som är stabila utåt. Se `siax.repo.json` → `consumes`/`consumedBy`.
## 7. Drift och miljöer
Miljöer enligt `siax.config.json`: `preview`, `production`.
TODO: verifiera mot faktisk nod och `docker ps` (GOV-06). Ett dokument får inte påstå drift som inte är mätt.
## 8. Källhänvisning
- Genererad: 2026-11-10 av `siax-scaffold` (scaffold 2026-11-10).
- Underlag: filträdet, `package.json`/`pyproject.toml`, `Dockerfile`, `siax.repo.json`.
- Ändringslogg: se `CHANGELOG.md` och git-historiken.
+42
View File
@@ -0,0 +1,42 @@
# SCAFFOLD-TODO — vad som är härlett och vad som måste verifieras
**Genererad:** 2026-11-10 av `siax-scaffold` (siax-standard,
`packages/scaffold`) mot Golden Standard v2.0.
Den här filen finns för att en mall inte får låtsas veta saker. Varje rad nedan
är antingen **härledd ur repot** (källan står i kolumn 3) eller ett
**konservativt defaultvärde** som en människa måste bekräfta. Radera raden när
den är verifierad — filen ska till slut kunna tas bort helt.
## Härledda värden i `siax.repo.json`
| Fält | Värde | Härlett ur |
|---|---|---|
| `repo` | `C0PY` | `git remote.origin.url` (VERSALER per REPO-08) |
| `codeowners` | `["@sax3l"]` | default (organisationens ägare) |
| `category` | `platform` | DEFAULT — ej härledbart |
| `subcategory` | `TODO: fyll i underkategori (t.ex. compute-os, saas-ersättare)` | TODO-markör |
| `operationalState` | `degraded` | driftsartefakter finns (Dockerfile + siax.config.json) — EJ VERIFIERAT driftläge |
| `domains` | `2 st` | `siax.config.json` → environments[].domain |
| `children` | `5 st` | faktiska kataloger under apps/, packages/, services/ |
| `packageName` | `c0py` | `package.json` → name |
## Måste verifieras av människa
- [ ] Bekräfta `codeowners` — scaffolden defaultade till `@sax3l` (CI-14).
- [ ] Verifiera `category` i `siax.repo.json` mot den kanoniska taxonomin och CL0UD APP_REGISTRY (GOV-01/REPO-05). Scaffolden defaultade till `platform` — den kan inte veta.
- [ ] Fyll i `subcategory` i `siax.repo.json` (REPO-04).
- [ ] Rätta `operationalState` mot verkligheten (`docker ps` på noden, GOV-06). Scaffolden satte `degraded` eftersom driftsartefakter finns men driftläget inte går att mäta från filsystemet — det är det konservativa valet som HÅLLER REPO-06/CD-01/API-01 aktiva i doctorn i stället för att tysta dem.
- [ ] Fyll i `purpose` och `registrar` för varje domän i `siax.repo.json` (NET-01).
- [ ] Beskriv varje post i `children[]` — sökvägarna är härledda ur filträdet, syftet är inte (ARK-11).
- [ ] Kör återställningen skarpt och skriv in datumet i `docs/runbook/backup-restore.md` (DOC-07).
## Kontroller som scaffolden AVSIKTLIGT lämnar röda
- **DOC-07** — `docs/runbook/backup-restore.md` saknar datum för bevisad restore. Scaffolden skriver aldrig in ett datum: kontrollen letar efter ett datum, och ett genererat sådant skulle göra den grön utan att någon återställning ägt rum. Kör återställningen, skriv in datumet.
---
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
+36
View File
@@ -0,0 +1,36 @@
# Backup & restore
## Vad som säkerhetskopieras
TODO: lista varje tillstånd repot äger — databas, volymer, objektlager,
hemligheter. Sådant som inte står här är inte säkerhetskopierat.
| Tillstånd | Var | Frekvens | Retention |
|---|---|---|---|
| TODO | TODO | TODO | TODO |
## Återställning — steg
1. TODO: exakt kommando för att hämta senaste dumpen.
2. TODO: exakt kommando för att läsa in den.
3. TODO: hur du verifierar att data faktiskt är tillbaka (räkna rader, anropa
en endpoint) — inte bara att kommandot gav exit 0.
## Senast bevisad restore
**EJ BEVISAD.**
TODO: kör återställningen skarpt mot en tom miljö och skriv in datumet här på
formen ÅÅÅÅ-MM-DD tillsammans med vem som körde den och vad som verifierades.
> Detta fält är avsiktligt tomt. `siax-scaffold` skriver ALDRIG in ett datum
> här: DOC-07 letar efter ett datum, och ett genererat datum skulle göra
> kontrollen grön utan att någon återställning ägt rum. Kontrollen ska förbli
> röd tills påståendet är sant.
**RTO/RPO:** TODO: mät, gissa inte.
---
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
+35
View File
@@ -0,0 +1,35 @@
# Deploy
Härlett ur `siax.config.json` (REPO-06):
| Fält | Värde |
|---|---|
| framework | `node` |
| build | `TODO` |
| start | `TODO` |
| port | `3000` |
| healthcheck | `TODO` |
| domän (preview) | `TODO` |
| domän (production) | `c0py.siax.io` |
## Steg
1. TODO: hur en ändring når drift (börvärde i estatet: merge till `main` →
`.gitea/workflows/cd.yml` → Coolify-webhook på den nod repot bor på).
Skriv det som FAKTISKT sker — inte det som borde ske (DOC-19).
2. TODO: hur du verifierar att den nya versionen kör (healthcheck-URL, exakt
`curl`-kommando och förväntat svar).
3. TODO: rollback — exakt kommando/knapp och hur lång tid det tar (CD-*).
## Förutsättningar
- Hemligheter hämtas från Infisical, aldrig ur repot (AR-6, SEC-01).
- TODO: vilka env-nycklar som måste finnas innan deploy.
**Runbooken ska vara körbar av någon som inte byggt systemet (DOC-06).**
Så länge något `TODO` står kvar är den inte det.
---
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
+35
View File
@@ -0,0 +1,35 @@
# Incident
## 1. Bekräfta
TODO: exakt kommando/URL som visar om tjänsten lever (healthcheck, `docker ps`
på noden, dashboard). Ett incidentsvar börjar alltid med en mätning.
## 2. Klassa
| Läge | Innebörd | Åtgärd |
|---|---|---|
| Nere | ingen trafik betjänas | eskalera direkt, se `oncall.md` |
| Degraderad | fel/latens över SLO | TODO: tröskelvärden ur `docs/slo.md` (OBS-10) |
| Kosmetiskt | ingen kundpåverkan | ärende, inte incident |
## 3. Vanliga orsaker (fylls på efter varje incident)
- TODO: känd felkälla 1 — symptom, kommando som bekräftar, åtgärd.
- TODO: känd felkälla 2.
## 4. Återställ
1. TODO: rollback enligt `deploy.md`.
2. TODO: om data är påverkad — följ `backup-restore.md` (och notera att
återställningen då faktiskt är bevisad, DOC-07).
## 5. Efterarbete
Postmortem i `docs/incidents/` — orsak, tidslinje, vad som saknades i
mätningen, vilken kontroll som skulle ha fångat det. Aldrig skuld på person.
---
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
+21
View File
@@ -0,0 +1,21 @@
# Oncall
**Jour:** TODO: vem som svarar, på vilken kanal, inom vilken tid. Står här
"ingen jour" ska det vara ett medvetet beslut — inte en glömska.
**Eskalering:** TODO: namn + kontaktväg. Sista instans i estatet: Simon
(goat@siax.io).
**Innan du väcker någon:**
1. Kör bekräftelsesteget i `incident.md` §1.
2. Kolla om det finns en känd orsak i `incident.md` §3.
3. TODO: länk till dashboard/larm (OBS-06/OBS-08).
**Larmvägar:** TODO: vilka larm som faktiskt är kopplade. Ett larm som ingen
tar emot är inget larm.
---
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
+25
View File
@@ -0,0 +1,25 @@
# Prompt-index — C0PY
| # | Prompt | Status | Beroende |
|---|---|---|---|
| — | _inga numrerade prompts ännu_ | — | — |
## Öppet, ännu inte brutet till numrerade prompts
Punkterna nedan hittades av `siax-scaffold` när mallarna lades in. Var och en
ska bli en egen `NNN-<slug>.md` enligt mallen i DEL 5.5 av standarden, med
maskinellt verifierbara acceptanskriterier och kontroll-ID (AGENT-03).
- Bekräfta `codeowners` — scaffolden defaultade till `@sax3l` (CI-14).
- Verifiera `category` i `siax.repo.json` mot den kanoniska taxonomin och CL0UD APP_REGISTRY (GOV-01/REPO-05). Scaffolden defaultade till `platform` — den kan inte veta.
- Fyll i `subcategory` i `siax.repo.json` (REPO-04).
- Rätta `operationalState` mot verkligheten (`docker ps` på noden, GOV-06). Scaffolden satte `degraded` eftersom driftsartefakter finns men driftläget inte går att mäta från filsystemet — det är det konservativa valet som HÅLLER REPO-06/CD-01/API-01 aktiva i doctorn i stället för att tysta dem.
- Fyll i `purpose` och `registrar` för varje domän i `siax.repo.json` (NET-01).
- Beskriv varje post i `children[]` — sökvägarna är härledda ur filträdet, syftet är inte (ARK-11).
Fullständig lista med härledda värden som måste verifieras: `docs/compliance/SCAFFOLD-TODO.md`.
---
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._