Spec: Agentic Source Orchestrator v3 (Synthesis Intelligence)
Agentic Source Orchestrator v3 extends the orchestration layer with a Synthesis Intelligence Model. It defines the protocols for knowledge quality, evidence reliability, conflict resolution, and draft promotion.
1. The Vault-as-Compiler Thesis
Synthesis is viewed as a compilation process where raw source material is "compiled" into permanent knowledge.
- Source Material (Sidecar): Raw object files (unprocessed text).
- Synthesis Draft: Linked but untested code (claims with evidence).
- Permanent Note: Shipped module (verified knowledge).
2. Epistemic Risk Model
Claims are classified into risk tiers to govern their promotion path:
- T0 — Fabrication: Unsupported claim. Reject.
- T1 — Weak Evidence: Tangential support. Requires human review.
- T2 — Inference Unmarked: Valid but unlabeled inference. Annotate & promote.
- T3 — Stale Evidence: Supporting chunks exceed freshness threshold. Staleness stamp.
- T4 — Conflict: Contradicts existing permanent notes. Trigger resolution protocol.
- T5 — Verified: High-similarity, fresh, authoritative support. Auto-promote eligible.
3. Conflict Resolution Protocol
Mandatory detection and resolution of contradictions between incoming claims and existing knowledge.
- Update: If new evidence is more authoritative and fresher.
- Narrow: If new evidence identifies a specific case or limit to a general claim.
- Parallel: If both claims are valid under different conditions.
- Arbitrate: Escalate to human if the agent cannot resolve.
4. Synthesis Quality Rubric
A draft is ready for promotion only if it meets these criteria:
- Evidence Coverage: Every non-trivial claim has a cited chunk ID.
- Inference Labeling: All derivations are explicitly marked.
- Atomic Scope: Covers exactly one concept (per YANP).
- Wikilink Integrity: All internal references resolve to existing stems.
- Scope Statement: Opens with a single sentence defining the concept boundary.
5. Implementation Sequence
- Epistemic Tier Classifier: Standalone function for
promote_synthesis_candidate. - Conflict Detection: Keyword-based cross-referencing of existing notes.
- Decomposition Check: Pre-drafting assessment of result set diversity.
- Provenance Writer: Automatic generation of
provenanceblocks in note frontmatter.