Preserve same-document multi-chunk evidence with evidenceKey identity, per-document caps, retrieve-k/return-n split, and a dense KnowledgeSearchPort. Archives Delivery 1 OpenSpec change as the foundation for hybrid retrieval.
1.2 KiB
1.2 KiB
rag-log-projections Delta (RAG portion)
MODIFIED Requirements
Requirement: RAG projection SHALL expose bounded document evidence only
The RAG adapter SHALL accept the logical query request, execute the existing knowledge tool through ToolBoundary, and project only RagToolResult fields. Context packs, retrieval traces, rerank traces, scores, hit reasons, domains, messages and full document bodies SHALL NOT appear in the Agent result. Projected evidence identity SHALL be chunk-scoped when chunk identity is available, allowing multiple excerpts from one logical source document.
Scenario: Project only bounded RAG evidence
- WHEN the adapter receives a logical query and the knowledge backend returns a result
- THEN it invokes through ToolBoundary and exposes only the bounded
RagToolResultevidence fields, excluding retrieval internals and full document bodies
Scenario: Multiple chunks from one source may project
- WHEN the backend returns multiple evidence blocks with the same source and different chunk-scoped identities
- AND projection budgets allow them
- THEN the projected evidence list SHALL include more than one item for that source
- AND each item SHALL have a distinct
document_id