# C0PY

**Canonical SIAX engine for evidence-driven web product capture, digital-twin specification, reconstruction and verification.**

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

```bash
pnpm install
pnpm --filter @siax/c0py-api dev
pnpm --filter @siax/c0py-web dev
```

## Canonical architecture

```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
```

## Repo structure

```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 | 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. Vercel is supported as a reconstruction preview adapter. See [`DEPLOY.md`](DEPLOY.md).