From 053b524fa4895ccac67d05e05a5a122b25700165 Mon Sep 17 00:00:00 2001
From: Simon Axelsson <simon@siax.io>
Date: Wed, 16 Sep 2026 15:35:11 +0200
Subject: [PATCH] docs: redefine c0py as canonical reconstruction engine

---
 README.md | 70 +++++++++++++++++++++++++++++++++++++++++--------------
 1 file changed, 52 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index 92c5c7a..c64bd0a 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
 # C0PY
 
-**Verktyg för att skapa fullständigt register över en hemsida ut alla aspekter.**
+**Canonical SIAX engine for evidence-driven web product capture, digital-twin specification, reconstruction and verification.**
 
-C0PY konsumerar en webbadress och producerar ett komplett register: sida-för-sida innehåll, struktur, prestanda, säkerhet, SEO, metadata och mer. Allt lagras som en tillförlitlig, återläsbar sammanställning.
+C0PY consumes an authorized web target and produces a versioned Evidence Graph / Canonical IR covering routes, DOM/runtime state, styles, assets, responsive behavior, interactions, workflows, network contracts, motion, accessibility and product topology. Reconstruction builders consume frozen C0PY specs; they never become the source of truth.
 
 ## Snabbkommandon
 
@@ -12,27 +12,61 @@ pnpm --filter @siax/c0py-api dev
 pnpm --filter @siax/c0py-web dev
 ```
 
-## Arkitektur
+## Canonical architecture
 
-```
-apps/api/          → Fastify/Next.js API — /v1/c0py/* endpoints
-apps/web/          → Next.js UI — registerhantering, dashboard, visualisering
-packages/c0py-core → crawling, registry-uppbyggnad, analysmotor
-packages/config    → Zod-validerad env-laddare
-packages/types     → delade TypeScript-typer
-docs/spec/         → Digital Twin Spec (webbplats-analys och reproduktion)
+```text
+Source product
+  -> discovery
+  -> Playwright/CDP deterministic capture
+  -> semantic workflow exploration adapters
+  -> Evidence Graph / Canonical IR
+  -> frozen reconstruction specs
+  -> v0 / Lovable / Codex / generic builders
+  -> preview deployment
+  -> multidimensional QA
+  -> typed repair loop
 ```
 
-## Konsumerade kapabiliteter
+## Repo structure
 
-| Kapabilitet | Syfte | Status |
+```text
+apps/api/          -> Fastify/API surface
+apps/web/          -> Next.js console and visualisation
+packages/c0py-core -> discovery, capture orchestration, evidence/provenance, product model, verification
+packages/config    -> validated runtime configuration
+packages/types     -> canonical shared IR/contracts
+docs/spec/         -> full Digital Twin Specification
+docs/MASTERPLAN.md -> canonical execution plan
+docs/STANDARDS.md  -> mandatory engineering/evidence rules
+docs/AUTOMATIONS.md -> autonomous pipeline contracts
+```
+
+## Capability adoption
+
+External technologies are classified as `CORE`, `DEPENDENCY`, `CHERRY_PICK`, `ADAPTER`, `REIMPLEMENT`, `REFERENCE_ONLY` or `DROP`. See [`docs/UPSTREAM-CAPABILITY-MATRIX.md`](docs/UPSTREAM-CAPABILITY-MATRIX.md).
+
+Primary integrations include Playwright/CDP, Crawlee-compatible crawl orchestration, rrweb, Browser Use/Browser Harness adapters, deterministic pixel/style verification, optional Spector.js WebGL forensics, and isolated archival adapters. Builders include v0, Lovable, Codex and generic agents.
+
+## Operating modes
+
+- `clone` — maximize observed fidelity; synthetic facts are prohibited.
+- `adapt` — preserve approved semantics while transforming design/technology.
+- `blend` — combine explicitly selected capabilities/patterns with complete provenance.
+
+## Quality
+
+C0PY does not use one visual score as a release verdict. It verifies a fidelity vector across geometry, typography, colors, assets, responsive states, routes, interactions, workflows, network contracts, motion, accessibility, runtime errors and production build health.
+
+## SIAX platform capabilities
+
+| Capability | Purpose | Status |
 |---|---|---|
-| CL0UD | Autentisering, RBAC, tenant | live |
-| AUD0 | Regeleveranshändelser | (ej live) |
-| ST0RE | Objektlagring av registerdata | (ej live) |
-| INF0 | Innehållsanalys | (ej live) |
-| N0D | Asynkrone crawling-jobb | (ej live) |
+| CL0UD | Authentication, RBAC, tenant | live |
+| AUD0 | Audit/event delivery | planned integration |
+| ST0RE | Evidence/object storage | planned integration |
+| INF0 | AI/semantic analysis | planned integration |
+| N0D | Async capture/reconstruction jobs | planned integration |
 
 ## Deploy
 
-SIAX Cloud via Coolify. Se [`DEPLOY.md`](DEPLOY.md).
+SIAX Cloud via Coolify. Vercel is supported as a reconstruction preview adapter. See [`DEPLOY.md`](DEPLOY.md).