This document defines the canonical artifact graph and governance rules for Victus.
Artifact-specific implementation details live in the owning repositories. This file acts as the central contract hub and links to repository-local contract documents mirrored under repos/.
Paper
-> StructuredBlock
-> ExperimentMap
-> CanonicalEvidence
-> Embedding
-> Retrieval
-> Agent Reasoning
-> User Answer
| Class | Purpose |
|---|---|
| Source Artifact | External or original input accepted by Victus |
| Intermediate Artifact | Internal transformation product |
| Contract Artifact | Stable artifact shared across repositories |
| Product Artifact | User-facing or API-facing output |
| Artifact | Class | Stability | Canonical owner | Repository-local details |
|---|---|---|---|---|
| Paper | Contract Artifact | active foundation | victus-docs |
Paper |
| StructuredBlock | Contract Artifact | active foundation | victus-docs |
StructuredBlock |
| ExperimentMap | Contract Artifact | draft | victus-docs |
ExperimentMap |
| CanonicalEvidence | Contract Artifact | draft | victus-docs |
CanonicalEvidence |
| Embedding | Contract Artifact | stable shared artifact | victus-docs |
RAG Contracts |
| Retrieval | Contract Artifact | stable shared artifact | victus-docs |
RAG Contracts |
| User Answer | Product Artifact | stable output concept | victus-docs |
pending |
StructuredBlock replaces legacy Section Block terminology.CanonicalEvidence replaces the previous Claim contract concept.Claim as a system contract.paper.md, paper.processed.json, and paper.final.json are operationalpaper.final.json may be a repository-local implementation ofStructuredBlock[].Correct:
id: VICTUS-ARTIFACT-CANONICAL-EVIDENCE
version: 1
Avoid:
VICTUS-ARTIFACT-CANONICAL-EVIDENCE-V1
Canonical artifact contracts live in victus-docs/docs/contracts/.
Implementation details live in the owning repositories.
Breaking artifact changes require:
| Repository | Contract document | Contract scope |
|---|---|---|
victus-processing |
Processing Contracts | processing artifacts, paths, identities, stage handoffs |
victus-processing |
Processing Data Layout | local runtime artifact layout and stage outputs |
victus-rag |
RAG Contracts | embedded Parquet inputs, Qdrant payloads, retrieval results, BEIR/evaluation artifacts |
The User Answer artifact does not yet have a repository-local contract mirror.