algovoi-keystone-sqlalchemy 0.2.0

Bind SQLAlchemy ORM operations to the AlgoVoi keystone -- each persisted change gets a content-addressed execution_ref (keystone-only edition, Apache-2.0)

algovoi-keystone-sqlalchemy

Bind SQLAlchemy ORM operations to the AlgoVoi keystone -- each persisted change (insert / update / delete) gets a content-addressed execution_ref. Open, keystone-only edition, Apache-2.0. Byte-compatible with algovoi-execution-ref.

from sqlalchemy.orm import Session
from algovoi_keystone_sqlalchemy import bind_session

s = Session(engine)
bind_session(s, decision_ref="sha256:...")      # registers an after_flush listener
s.add(Order(id=1)); s.flush()
s.info["keystone_executions"]   # [{operation:"insert", table:"orders", execution_ref, ...}]

Or standalone: orm_execution_ref(decision_ref=..., operation="insert", table="orders", outcome="COMMITTED", executed_at_ms=...). SQLAlchemy is an optional dependency, imported only by bind_session.

A failed operation is recorded with outcome FAILED; tamper_detected(...) recomputes any binding offline.

Keystone-only edition

The open edition binds and verifies each operation. The signed, hash-linked chain of operations (PQC + CCC ingest) is the commercial tier.

License

Apache-2.0. Copyright AlgoVoi.