semantica-agi /semantica:provenance
Lineage and audit trails. Usage: /semantica:provenance <task> [args]
lineage <entity_id> [--depth N]
import os
from semantica.provenance import ProvenanceManager
db_path = os.path.expanduser("~/.semantica/prov.db") # storage_path is passed to
os.makedirs(os.path.dirname(db_path), exist_ok=True) # sqlite3.connect() unexpanded
pm = ProvenanceManager(storage_path=db_path) # SQLite, or omit for in-memory
chain = pm.lineage(entity_id, depth=3)
full = pm.get_lineage(entity_id) # complete ancestry
down = pm.get_descendants(entity_id) # what this entity influenced
sources <entity_id>
srcs = pm.get_all_sources(entity_id) # every source that contributed
prov = pm.get_provenance(entity_id) # the raw PROV entry
hist = pm.revision_history(entity_id)
audit [--since <iso-date>] [--format table|json]
log = pm.audit_log(since="2026-01-01", format="table")
between = pm.query_recorded_between(start, end)
stats = pm.get_statistics()
export [--format turtle|json-ld|xml]
W3C PROV-O export — this is the regulator-facing artifact.
rdf = pm.export_prov(format="turtle", base_uri="https://example.org/prov/")
invalidate <entity_id> <agent_id> [--reason ...]
Mark an entity superseded without deleting history.
pm.invalidate(entity_id, agent_id, reason="source retracted")
check [--strict]
report = pm.check(strict=False) # integrity check over the provenance store