Skip to main content

Source Authority and Ingestion Contracts

What This Concept Is​

This lesson teaches you to define who owns each source, what may be indexed, and how changes and revocations enter the pipeline. Treat the retrieval system as a chain of versioned transformations, not a black-box vector database. Every output must be traceable to an authorized source, configuration, index version, and evaluation result.

Why It Matters Here​

Retrieval-augmented systems fail in distinct layers. Ingestion may omit structure, retrieval may miss evidence, ranking may bury it, context assembly may truncate it, and generation may contradict it. Separating these mechanisms makes failures measurable and repairable.

Concrete Example​

You will ingest product policies only from approved repositories while rejecting copied drafts. Freeze the query set, record versions and latency, inspect individual failures, and compare against a simpler lexical or no-transformation baseline under identical conditions.

Common Confusion / Misconception​

A dangerous shortcut is assuming reachable content is authorized and suitable for retrieval. A plausible answer is not proof that the system retrieved current, authorized, entailing evidence. Evaluate each layer independently before interpreting end-to-end output.

How To Use It​

  1. State the source, query, and freshness contracts.
  2. Create a small inspectable baseline.
  3. Version transformations and indexes.
  4. Measure retrieval before generation.
  5. Trace failures to their first incorrect stage.
  6. Test update and deletion propagation.
  7. Record a fallback for absent or conflicting evidence.

Check Yourself​

  1. Which artifact proves source authority and version?
  2. What metric isolates this stage from generation?
  3. Which adversarial query is most likely to break the assumption?
  4. How will an urgent correction or deletion propagate?

Mini Drill or Application​

Build the smallest runnable test of this mechanism with ten representative queries and two hard negatives each. Inject one stale, duplicated, or unauthorized source. Detect it from trace evidence, repair the pipeline, and preserve the before/after results and rejected alternative.

Read This Only If Stuck​