Ingestion: evidence-bound entities/relations for add_note and add_event

[aurexav]

Summary

Extend ingestion (add_note, add_event) to produce evidence-bound entities and relations.

Problem

Graph schema alone is not useful until ingestion can deterministically and safely populate it.

In Scope

• Extend deterministic add_note payload for explicit entity/relation input.
• Extend add_event extraction contract for entity/relation output.
• Validate evidence binding, scope, and policy constraints before persistence.
• Persist graph writes through existing audit/version paths.

Out of Scope

• Graph-aware ranking changes.
• Cross-project relation linking.

Deliverables

• API contract updates.
• Extraction contract updates.
• Validation and persistence logic.
• Test coverage for accept/reject/update flows.

Acceptance Criteria

• add_note supports explicit entity/relation writes.
• add_event can extract and persist supported relations.
• Invalid relations are rejected with reason codes and field paths.
• Conflicting updates follow deterministic rules.

Dependencies

• Graph Memory: canonical entity/fact temporal schema in Postgres #48

Implementation Checklist

• Request/response schema changes.
• Extractor output schema changes.
• Validation and reason-code mapping.
• Audit/version plumbing.
• Integration tests for valid and invalid cases.

Done When

• Both ingestion paths can create graph facts with the same trust boundaries as notes.

[aurexav]

PR #65 opened: evidence-bound entities/relations ingestion for add_note + add_event, with graph persistence + field_path surfacing on structured rejects.

Highlights

• Adds structured.entities + structured.relations (evidence-bound)
• Persists to graph_* tables with conflict-safe upsert + evidence attachment
• Acceptance tests + spec doc updates

Verification

• cargo make fmt-rust-check
• cargo make lint
• cargo make test-rust
• cargo make test-integration (via .env)
• cargo make e2e (with ELF_QDRANT_HTTP_URL=http://127.0.0.1:51889)

[aurexav]

Merged to main at commit 3238168.

What shipped

• add_note accepts evidence-bound structured.entities and structured.relations and persists to graph tables.
• add_event extractor output supports the same; graph writes are persisted (no writes on dry_run).
• Strict evidence binding for relation subject/predicate/object; structured rejects include optional field_path.
• Graph fact upsert uses conflict-safe upsert so duplicates attach evidence without aborting the transaction.

Verification (on the merged commit):

• cargo make fmt-rust-check
• cargo make lint
• cargo make test-rust
• cargo make test-integration (via .env)
• cargo make e2e (with ELF_QDRANT_HTTP_URL=http://127.0.0.1:51889)