semantica-agi /semantica:change
Track what changed. Usage: /semantica:change <task> [args]
Two distinct mechanisms cover this, and they are not interchangeable:
Question Tool "What did the graph look like on date X?" ContextGraph.state_at()"What changed between ontology versions?" change_management.VersionManager
graph-at <timestamp> — point-in-time graph state
import os
from semantica.context import ContextGraph
graph = ContextGraph()
graph.load_from_file(os.path.expanduser("~/.semantica/kg.json")) # load_from_file does not expand ~
snapshot = graph.state_at("2026-06-01") # str | int | float | datetime
Diff two moments by comparing node IDs — state_at()["nodes"] is a list of
dicts (unhashable), so compare the id fields, not the dicts themselves:
before = graph.state_at("2026-06-01")
after = graph.state_at("2026-09-01")
before_ids = {n["id"] for n in before["nodes"]}
after_ids = {n["id"] for n in after["nodes"]}
added = after_ids - before_ids
For richer temporal work (scrubbing, evolution, temporal patterns) use
/semantica:temporal, which wraps the same layer.
node-history <node_id> — who touched this node
Node-level history is provenance, not change management:
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)
history = pm.revision_history(node_id)
log = pm.audit_log(since="2026-01-01")
versions / diff <v1> <v2> — ontology versioning
from semantica.change_management import VersionManager
vm = VersionManager()
vm.create_version("1.1.0", ontology)
vm.list_versions()
vm.get_latest_version()
delta = vm.compare_versions("1.0.0", "1.1.0")
delta = vm.diff_ontologies(base_ontology, target_ontology)
migrated = vm.migrate_ontology("1.0.0", "1.1.0", ontology)
TemporalVersionManager and OntologyVersionManager are also exported for
time-scoped and ontology-specific variants.