Add Relationship Evidence and improve Core documentation

[sparkplug604]

Summary

This PR adds Relationship Evidence to Praxis Core and updates the surrounding documentation so the feature is easier to understand, test, and extend.

Relationship Evidence gives Praxis a user-facing path for extracting source-backed relationships from captured knowledge, reviewing conflicts, promoting accepted relationships, and querying relationship evidence later.

What changed

• Adds the praxis relationship-evidence CLI command.
• Adds the praxis.relationship_evidence package for extraction, review, promotion, querying, storage, and service-level coordination.
• Adds a default business ontology and rule-based relationship patterns.
• Adds review routing for relationship conflicts, including one-to-one cardinality conflicts.
• Adds tests for extraction, promotion, review, querying, comparison, and the CLI flow.
• Adds a Stack Overflow developer survey demo dataset for Core docs and demos.
• Updates Core docs around Relationship Evidence, entity-aware evidence, conflicts, adapter boundaries, knowledge flows, and how Praxis connects RAG, skills, and live data.

Why it matters

Praxis already captured sources, chunks, entities, conflicts, and evidence. This adds a clearer layer for turning that evidence into inspectable relationships without treating extracted relationships as automatically true.

Validation

• Full local test suite passed: 66 tests.

Review focus

• Whether the Relationship Evidence terminology feels clear.
• Whether the CLI shape is understandable.
• Whether the docs explain the feature without overclaiming production readiness.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
praxis	Error		Jun 17, 2026 8:29am