73 lines
3.0 KiB
Markdown
73 lines
3.0 KiB
Markdown
# 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).
|