diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 0000000..29cf004 --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,5 @@ +{ + "name": "c0py", + "image": "mcr.microsoft.com/devcontainers/javascript-node:22", + "postCreateCommand": "pnpm install --frozen-lockfile" +} diff --git a/.gitea/CODEOWNERS b/.gitea/CODEOWNERS new file mode 100644 index 0000000..5e5c794 --- /dev/null +++ b/.gitea/CODEOWNERS @@ -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 diff --git a/.gitea/workflows/security.yml b/.gitea/workflows/security.yml new file mode 100644 index 0000000..846f5ae --- /dev/null +++ b/.gitea/workflows/security.yml @@ -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 diff --git a/.npmrc b/.npmrc new file mode 100644 index 0000000..c277fc0 --- /dev/null +++ b/.npmrc @@ -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 diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..4851266 --- /dev/null +++ b/CHANGELOG.md @@ -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). diff --git a/compose.dev.yaml b/compose.dev.yaml new file mode 100644 index 0000000..2816ace --- /dev/null +++ b/compose.dev.yaml @@ -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: {} diff --git a/docs/architecture/ARCHITECTURE.md b/docs/architecture/ARCHITECTURE.md new file mode 100644 index 0000000..b471ef2 --- /dev/null +++ b/docs/architecture/ARCHITECTURE.md @@ -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. diff --git a/docs/compliance/SCAFFOLD-TODO.md b/docs/compliance/SCAFFOLD-TODO.md new file mode 100644 index 0000000..26c65ac --- /dev/null +++ b/docs/compliance/SCAFFOLD-TODO.md @@ -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`._ diff --git a/docs/runbook/backup-restore.md b/docs/runbook/backup-restore.md new file mode 100644 index 0000000..9ea3aef --- /dev/null +++ b/docs/runbook/backup-restore.md @@ -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`._ diff --git a/docs/runbook/deploy.md b/docs/runbook/deploy.md new file mode 100644 index 0000000..19a7d40 --- /dev/null +++ b/docs/runbook/deploy.md @@ -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`._ diff --git a/docs/runbook/incident.md b/docs/runbook/incident.md new file mode 100644 index 0000000..5cb2a0c --- /dev/null +++ b/docs/runbook/incident.md @@ -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`._ diff --git a/docs/runbook/oncall.md b/docs/runbook/oncall.md new file mode 100644 index 0000000..bcfac90 --- /dev/null +++ b/docs/runbook/oncall.md @@ -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`._ diff --git a/prompts/000-INDEX.md b/prompts/000-INDEX.md new file mode 100644 index 0000000..62cc588 --- /dev/null +++ b/prompts/000-INDEX.md @@ -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-.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`._