Search: graph relation context and explain integration

[aurexav]

Summary

Expose graph relation context in search and explain outputs without breaking current retrieval behavior.

Notes

• Shipped in 35c9fe6 (2026-02-19).
• relation_context is evidence-bound and bounded (configurable), and is omitted unless enabled.

Problem

Even with graph facts stored, users cannot benefit unless retrieval surfaces relation context and provenance.

In Scope

• Add relation_context to search and explain payloads.
• Resolve graph context under existing tenant/project/agent scope rules.
• Keep ranking unchanged by default.
• Add feature flag for optional graph-aware ranking experiments.

Out of Scope

• Mandatory graph-based ranking.
• Unbounded traversal over large neighborhoods.

Deliverables

• API response extensions.
• Explain payload extensions.
• Trace persistence updates for graph provenance.
• Compatibility tests for clients without graph fields.

Acceptance Criteria

• Search returns bounded graph context when available.
• Explain identifies which relations influenced context.
• Existing clients remain compatible when graph context is absent.
• Trace rows persist graph context provenance.

Dependencies

• Graph Memory: canonical entity/fact temporal schema in Postgres #48
• Ingestion: evidence-bound entities/relations for add_note and add_event #49

Implementation Checklist

• Response schema updates.
• Graph context resolver with bounds.
• Explain integration.
• Feature flag wiring.
• Backward-compatibility tests.

Done When

• Graph memory becomes visible and inspectable during retrieval.

[aurexav]

Shipped in 35c9fe6.

What changed

• SearchExplain now optionally includes relation_context (evidence-bound graph facts) in both search responses and persisted trace items.
• Added config gating + bounds under [search.graph_context].
• Added acceptance coverage that exercises fact bounding and evidence truncation.

Verification

• cargo make checks
• set -a && source .env && set +a && cargo make test-integration
• set -a && source .env && set +a && ELF_QDRANT_HTTP_URL=http://127.0.0.1:51889 cargo make e2e

GA

• Triggered by push to main.

[aurexav]

Follow-up (2026-02-19): GA Language Checks failed due to vibe-style v0.1.13 tightening import rules; fixed by switching #[derive(sqlx::FromRow)] -> #[derive(FromRow)] with use sqlx::FromRow; + applying nightly rustfmt.

Verification:

• cargo vstyle curate --workspace --all-features (with vibe-style v0.1.13) ✅
• cargo make lint ✅
• set -a && source .env && set +a && cargo make test-integration ✅
• set -a && source .env && set +a && ELF_QDRANT_HTTP_URL=http://127.0.0.1:51889 cargo make e2e ✅