Contracts define stable, explicit system boundaries across the Victus ecosystem.
This Map of Content routes contract readers to the current contract nodes.
Canonical cross-repository contracts live only in victus-docs.
Repositories do not copy canonical contracts. They subscribe to contracts through
repo-local victus.contracts.yml files using contract_id@version.
Implementation details belong in repository-local documentation owned by the
relevant repository.
repos/** is read-only synchronized context, not the source of canonical
contracts inside victus-docs.
Wiki.js is a read-only rendered view, not a source of truth.
| Document | Purpose |
|---|---|
| Contract Registry | Canonical contract registry entrypoint |
| Contracts Registry | Canonical contract registry |
| Contract Subscriptions | Repository contract subscription registry |
| Contract Subscription Model | Governance model for explicit repository subscriptions |
| Contract Change Process | Governance process for patch, minor, and major contract changes |
| Scientific Contracts | Scientific contract flow and compatibility decisions |
| Paper | Canonical scientific publication identity contract |
| StructuredBlock | Canonical preserved source context unit |
| PaperClassification | Draft paper-level evidence routing classification |
| ExperimentMap | Draft result-centered block grouping artifact |
| CanonicalEvidence | Draft canonical scientific result contract |
| ArtifactManifest | Draft physical artifact manifest and lineage record |
| PipelineRun | Draft canonical pipeline execution record |
| PipelineEvent | Draft append-only pipeline event record |
| Processing Contracts | Operational processing registry and pipeline execution contracts |
| Artifact Contract Hub | Canonical artifact graph and governance |
| Repository Documentation Contract | Documentation expectations for ecosystem repositories |
Some contract areas are listed as planned or pending until the relevant decision and owner-specific details are documented.
Contracts should:
Breaking contract changes require an ADR and updates to affected contract documents.
Do not create real domain contracts until the domain contract has an owner,
subscription need, and approved design.
StructuredBlock replaces legacy Section Block terminology.
CanonicalEvidence replaces the previous Claim contract concept; Victus does
not define Claim as a system contract.