lucas1114/rag-contract

rag-contract is a fixed-corpus question-answering service whose contract emphasizes attributable answers, explicit refusal states, measured retrieval quality, versioned indexes, and enforced budgets. The request path runs through the HTTP surface and Service, which acquires one index, retrieves passages, drafts claims, and grounds them into an answer. Separate evaluation and gate paths check retrieval, answer behavior, index freshness, and thresholds. Edges reflect excerpts, SOURCE INDEX references, or README statements; unsampled details are omitted where wiring cannot be verified.