Architecture reference
This is the place every Cephalon doc points to when it says “see the canonical contract”. The pages here are intentionally dense — they’re meant to be the authoritative reference, not a tutorial.
What lives here
Section titled “What lives here”| Page | What it documents |
|---|---|
| Runtime contracts | Every /engine/* route, every snapshot.* key, every runtime catalog interface. |
| Conformance matrix | Per-package status row across every public surface. |
| Maturity audit | The current M0–M4 label for every shipped package. |
Coming soon (currently mirrored from engine source docs)
Section titled “Coming soon (currently mirrored from engine source docs)”The pages below are planned for 0.2.0-preview. Each currently points at the engine-source-doc mirror that has the canonical material.
| Planned page | Current source-doc mirror |
|---|---|
| Transport surface (REST / JSON-RPC / gRPC / GraphQL / SSE / WebSocket typed contracts) | Technology → Hosts |
CDC capture (ICdcCaptureContributor, freshness/lag/publication status) | Source → components / data-debezium |
| Identity contract (principal model, scope/role decisions, claim contracts) | Technology → Identity + Configuration → Identity |
| Tenancy contract (tenant context, resolution policy, governance) | Technology → Multi-tenancy + Configuration → Tenancy |
| Design patterns (canonical internal patterns) | Source → Architecture patterns research |
| REST endpoint authoring strategy | Technology → Hosts (transport sections) |
| .NET ecosystem reference (pinned-version inventory) | Source → .NET ecosystem reference |
| Package discovery (assembly scanning + module-discovery rules) | Contributing → Module authoring |
Source-doc snapshots
Section titled “Source-doc snapshots”Every page here is mirrored to the versioned source so you can compare against the engine release: