Examples

Every script below lives in examples/ in the repository and is independently runnable — each connects to a temporary SQLite database, runs, prints what it's doing, and cleans up after itself.

uv sync
uv run python examples/quickstart.py
uv run python examples/governance_and_review.py
uv run python examples/bitemporal_queries.py
uv run python examples/writing_a_plugin.py
uv run python examples/hybrid_search.py

Script	Demonstrates	Tutorial
quickstart.py	Connecting, schema, principals, entities, literal/ref assertions, provenance	Getting Started
governance_and_review.py	AI-vs-human proposal paths, request_changes → resubmit → accept, contradiction routing	Governance & Review
bitemporal_queries.py	time_varying supersession, an injected FixedClock, as_of(t) time-travel	Bitemporal Queries
writing_a_plugin.py	Registering & calling a real reference plugin through the process-isolated sandbox	Writing a Plugin
hybrid_search.py	.semantic(), symbolic .where() intersection, .min_confidence()	Hybrid Search

These same scripts are run in CI (ci.yml's "Tests" job) against every push to main, so they stay accurate as the API evolves — if one of them breaks, that's a CI failure, not a stale doc.