External read contract for tools reading from Rango (LangChain, LlamaIndex)

[antonygiomarxdev]

Objective

Ship a conformance test kit (mock adapter + golden fixtures) so any vector or graph adapter can certify compatibility with the capability contract.

Roadmap Mapping

• Phase: phase:5-advanced-retrieval
• Milestone: v0.3.0

Scope

In scope:

• Trait conformance harness
• Golden vectors and queries
• README explaining adapter author flow

Out of scope:

• Certification logo program

Acceptance Criteria

• cargo test runs the conformance harness against a mock adapter
• Golden fixtures committed
• README documents the adapter author flow

Test Plan

• Harness exercises mock adapter
• CI job runs the harness

[antonygiomarxdev]

Scope update: Revised for v0.3.0. Instead of an adapter conformance kit for external vector stores, this issue now covers the external read contract — documenting how tools like LangChain, LlamaIndex, or custom agents read from Rango without embedding logic in the core. Rango provides canonical documents. External tools handle their own retrieval strategy.