interlock-escrow 1.0.4__tar.gz → 1.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/.github/workflows/ci.yml +2 -2
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/CHANGELOG.md +114 -0
- interlock_escrow-1.0.4/README.md → interlock_escrow-1.2.0/PKG-INFO +283 -5
- interlock_escrow-1.0.4/PKG-INFO → interlock_escrow-1.2.0/README.md +255 -33
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/pyproject.toml +7 -5
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/__init__.py +21 -3
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/adjudication.py +3 -1
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/builder.py +9 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/cli.py +63 -4
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/config.py +229 -17
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/engine.py +138 -5
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/exceptions.py +13 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/feedback.py +190 -28
- interlock_escrow-1.2.0/src/interlock/git_substrate.py +1720 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/inbox.py +127 -11
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/invariants.py +291 -94
- interlock_escrow-1.2.0/src/interlock/mcp.py +390 -0
- interlock_escrow-1.2.0/src/interlock/meters.py +274 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/outbound.py +125 -18
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/outbound_checks.py +30 -7
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/outbox_sql.py +16 -2
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/postgres.py +41 -11
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/receipts.py +74 -12
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/repair.py +3 -1
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/sqlite_outbox.py +117 -50
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/substrate.py +96 -12
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/types.py +89 -10
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/windows.py +75 -27
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/wiring.py +41 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/checker_digests.py +11 -1
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_agreement.py +49 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_checker_records.py +3 -1
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_config.py +1 -1
- interlock_escrow-1.2.0/tests/test_git_substrate.py +1371 -0
- interlock_escrow-1.2.0/tests/test_horizontal.py +1057 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_outbox_postgres.py +6 -2
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/uv.lock +8 -8
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/.github/workflows/release.yml +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/.gitignore +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/.python-version +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/LICENSE +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/SECURITY.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/demo/customer_acceptance_suite.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/demo.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/CUSTOMER_ACCEPTANCE_MATRIX.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/EPIC3_DESIGN.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/EPIC4_DESIGN.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/EPIC5_DESIGN.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/EPIC6_DESIGN.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/EPIC7_DESIGN.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/EPIC8_DESIGN.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/EPIC9_DESIGN.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/ESCROW_SPEC.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/docs/OUTBOX_DESIGN.md +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/scripts/live_gauntlet.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/scripts/live_stress_test.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/scripts/metrics_overhead.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/scripts/security_audit.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/adapters.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/anchor.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/attestations.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/cascade.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/chain.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/cluster.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/compaction.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/daemon.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/deliveries.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/extension.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/inbox_sql.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/inbox_store.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/keys.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/operators.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/outbox_store.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/py.typed +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/reconcile.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/records.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/recovery.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/relay.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/runtime.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/sampling.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/sendgrid.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/settlement.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/signers.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/stripe.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/supervisor.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/telemetry.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/trace.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/src/interlock/vacuum.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/__init__.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/children.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/conftest.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/crash_child.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/daemon_app.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/fakekms.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/fakepg.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/fakesendgrid.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/fakesink.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/fakestripe.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/inbox_child.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/inbox_env.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/operator_child.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/outbox_env.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/outbox_v2.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/outbox_v3.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/outbox_v4.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/pgbouncer/pgbouncer.ini +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/pgbouncer/userlist.txt +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/plans.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/relay_child.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/schemas.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/settle_child.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/settling.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/sqlite_outbox_v3.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/sqlite_outbox_v4.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/sqlite_stage_child.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_acceptance_suite.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_anchor.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_attestations.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_cascades.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_cluster.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_cluster_daemon.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_core_guarantees.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_crash_consistency.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_daemon.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_deliveries.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_engine.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_ergonomics.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_extension.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_fact_agreement.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_feedback.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_inbox.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_inbox_cli.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_inbox_crash.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_inbox_engine.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_inbox_vendors.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_instrumentation.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_keys.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_live_sinks.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_metrics.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_operator_crash.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_operators.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_outbound.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_outbound_checks.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_pg_upgrade.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_pool.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_postgres.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_readme_snippets.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_reconcile.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_records.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_recovery.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_relay.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_relay_crash.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_repair.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_runtime.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_sampling.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_security_audit.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_sendgrid.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_settlement.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_settlement_crash.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_shared_transaction.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_signers.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_soak.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_sqlite_outbox.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_sqlite_stage_crash.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_stripe.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_supervisor.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_takeover.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_tamper_evidence.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_trace.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_typed_config.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_upgrade_v5.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_vacuum.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_vacuum_crash.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_vacuum_inbox.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/test_windows.py +0 -0
- {interlock_escrow-1.0.4 → interlock_escrow-1.2.0}/tests/vacuum_child.py +0 -0
|
@@ -154,7 +154,7 @@ jobs:
|
|
|
154
154
|
|
|
155
155
|
# A path source resolves only when agentgov happens to sit next to the
|
|
156
156
|
# checkout, so a third party's clone never builds. agentgov comes from
|
|
157
|
-
# PyPI (interlock-agentgov>=1.
|
|
157
|
+
# PyPI (interlock-agentgov>=1.1.0): clone into a directory with no
|
|
158
158
|
# sibling checkout and resolve from scratch, from the lockfile.
|
|
159
159
|
#
|
|
160
160
|
# Gates `git clone` + `uv sync`. The standalone wheel is gated below.
|
|
@@ -200,7 +200,7 @@ jobs:
|
|
|
200
200
|
name = [n for n in z.namelist() if n.endswith('METADATA')][0]
|
|
201
201
|
meta = z.read(name).decode()
|
|
202
202
|
requires = [l.split(': ', 1)[1] for l in meta.splitlines() if l.startswith('Requires-Dist: interlock-agentgov')]
|
|
203
|
-
assert 'interlock-agentgov>=1.
|
|
203
|
+
assert 'interlock-agentgov>=1.1.0' in requires, requires
|
|
204
204
|
assert not any(' @ ' in r for r in requires), requires # no direct reference
|
|
205
205
|
print('wheel metadata requires', requires)
|
|
206
206
|
"
|
|
@@ -9,6 +9,120 @@ Releases before 0.1.2 are described by their tags and commit history.
|
|
|
9
9
|
|
|
10
10
|
## [Unreleased]
|
|
11
11
|
|
|
12
|
+
## [1.2.0] - 2026-10-31
|
|
13
|
+
|
|
14
|
+
Any partition, any unit, any sink, and honest receipts. Upgrades from 1.1.0 in place.
|
|
15
|
+
Requires `interlock-agentgov>=1.1.0`, for units and ARC1 1.3. A configuration that uses
|
|
16
|
+
none of what follows keeps every plan, diff, verdict and schema hash, every checker's
|
|
17
|
+
configuration digest, and every sink's configuration hash it had: each new field enters a
|
|
18
|
+
hash only when it is set.
|
|
19
|
+
|
|
20
|
+
### Added
|
|
21
|
+
|
|
22
|
+
- **Partition dimensions beyond the tenant.** `TableSpec(partitions={"patient":
|
|
23
|
+
"patient_id"})` (a `"tenant"` entry is the `tenant_column`; `[[tables]] partitions` in
|
|
24
|
+
`interlock.toml`) labels every captured row in each dimension: `RowDelta.partitions`,
|
|
25
|
+
`EffectDiff.partition_ids(dimension)`, `partition_column_totals`. An effect declares its
|
|
26
|
+
own labels (`Effect.partitions`, `PlanBuilder.insert(..., partitions=...)`).
|
|
27
|
+
`TenantIsolation(dimension="patient")` (named `partition_isolation:patient`) holds a plan
|
|
28
|
+
to one patient's chart while another instance holds it to one facility, with `declared`
|
|
29
|
+
as before; a rate window keeps each label's history with `per = "partition:patient"` (a
|
|
30
|
+
request counts toward the label its effect declares). Feedback names only the labels the
|
|
31
|
+
plan itself declares in that dimension.
|
|
32
|
+
- **Value guards both ways.** `ColumnValueGuard(max_rise_fraction=...)` and
|
|
33
|
+
`TenantDrawdownGuard(max_rise_fraction=..., dimension=...)` refuse a rise, a dose read in
|
|
34
|
+
micrograms for milligrams, a replica surge, as well as a fall; either bound or both. A
|
|
35
|
+
guard with a rise bound, or another dimension, reports totals at their own precision
|
|
36
|
+
(`0.125`, not `0.13`), and one configured as before reports as before, so its verdicts
|
|
37
|
+
are unchanged. Feedback: `value_rise`.
|
|
38
|
+
- **One agreement over several operations.** `CrossEffectAgreement(..., also=(...))` holds a
|
|
39
|
+
quantity to its rows whichever of the sink's operations carries it: a medication order,
|
|
40
|
+
and the same order on a held Schedule II operation. Its name joins the operations with
|
|
41
|
+
`|`. A rule without `also` keeps its name, its messages and its checker digest.
|
|
42
|
+
- **Caps by any unit.** `PayloadAmountCap(maximum={"mg": "5"}, unit_field="unit")`:
|
|
43
|
+
`unit_field` reads a request's unit as `currency_field` reads its currency.
|
|
44
|
+
- **Meters** (`interlock.meters`, `EscrowEngine(meters=...)`): what plans consume in a
|
|
45
|
+
unit (`mme`, `vcpu`, seats), conserved in an AgentGov ledger of that unit. Each plan holds
|
|
46
|
+
the meter's `per_plan` before it stages (an envelope with less refuses it there, quietly:
|
|
47
|
+
`MeterExhaustedError`, no breaker trip), is checked by `MeterCheck`, and settles what its
|
|
48
|
+
diff measured when it commits; a refused plan's hold is released, and recovery settles a
|
|
49
|
+
committed plan's hold whole. The receipt names each quantity and the transaction that
|
|
50
|
+
settled it.
|
|
51
|
+
- **Honest receipts.** `SubstrateCapabilities.measurement` declares a driver's class, and
|
|
52
|
+
every receipt carries it (ARC1 1.3 `coverage.measurement`): `transactional` on SQLite,
|
|
53
|
+
PostgreSQL and Git, and `request-only` for a plan whose only effect is the requests it
|
|
54
|
+
commits, which then names its sinks in `cost.served_by`. `ReceiptIssuer(tenants=
|
|
55
|
+
"declared")` names only the tenants a plan's effects declare and counts the rest (ARC1
|
|
56
|
+
1.3 `summary.other_tenants`), so a receipt handed to one tenant names no other.
|
|
57
|
+
- **Holding an operation for a warrant.** `OperationSpec(hold=True)` (`hold = true` on a
|
|
58
|
+
`[[sinks.operations]]` entry, of any sink, typed ones too): every request of it enters
|
|
59
|
+
the outbox held, with a `held` row in its delivery log written in the stage's own
|
|
60
|
+
transaction, even with its scope's breaker closed, and is delivered only once an
|
|
61
|
+
operator, or a warrant, releases it. Both outboxes mirror it (a `held` column on the sink
|
|
62
|
+
registry, added in place); the sink's configuration hash covers it only when set.
|
|
63
|
+
- **MCP tools as a sink** (`interlock.mcp`, `type = "mcp"`): one operation per tool of an
|
|
64
|
+
upstream MCP server, with the schema the operator pins; a request is one `tools/call`.
|
|
65
|
+
At most once, always (`idempotency = "none"`, `unknown_outcome = "dead-letter"`, and no
|
|
66
|
+
other). `McpAdapter` takes any transport; `StdioServer` runs the server as the relay's
|
|
67
|
+
child (`[[relay.endpoints]] command = [...]`, `tools` where a tool's name is no
|
|
68
|
+
operation's). `mcp_sink` builds one in code.
|
|
69
|
+
- **Sink and source kinds of a package's own.** `register_sink_kind` (or the
|
|
70
|
+
`interlock.sinks` entry point) adds a typed sink kind following the contract
|
|
71
|
+
`interlock.stripe` and `interlock.mcp` follow, `relay_adapter` included, so a FHIR server
|
|
72
|
+
or ServiceNow is configured from `interlock.toml`; `register_source_kind` (or
|
|
73
|
+
`interlock.sources`) adds an inbox source that signs its own way. A database's mirror
|
|
74
|
+
records such a kind as `http`, whose rules are none of its own; the configuration hash
|
|
75
|
+
beside it names the kind.
|
|
76
|
+
|
|
77
|
+
## [1.1.0] - 2026-10-30
|
|
78
|
+
|
|
79
|
+
### Added
|
|
80
|
+
|
|
81
|
+
- **`GitSubstrate` (`interlock.git_substrate`): a transactional substrate over a Git
|
|
82
|
+
branch.** A stage is a worktree of its own at the branch's head. Effects are statements
|
|
83
|
+
in the substrate's own language (`write`, `replace`, `delete`, `mode`, `patch`,
|
|
84
|
+
`expect-head`), with `:name` parameters. The repository's hooks run after each effect,
|
|
85
|
+
with a scrubbed environment and a timeout, and a plan may not write a hook's sources.
|
|
86
|
+
- **The Git diff.** It is `git diff-index` of the staged worktree against the base. Each
|
|
87
|
+
path is one row: its class (`PathClass`, configurable globs) is the table, its owner is
|
|
88
|
+
the partition, and it records `blob_sha`, `mode`, line counts and `secret_markers`.
|
|
89
|
+
Every built-in checker reads it unchanged.
|
|
90
|
+
- **The Git commit.** It is `git update-ref <branch> <new> <base>`, a compare-and-swap. A
|
|
91
|
+
push that lands while a stage is open commits nothing. The marker is the commit's
|
|
92
|
+
`Interlock-Stage` trailer, read by `resolve_intent`.
|
|
93
|
+
- **Repairs on Git.** Savepoints are trees, so repair searches run on Git.
|
|
94
|
+
- **`reconcile_git`.** It names every commit on the branch that no stage made, and
|
|
95
|
+
force-pushes.
|
|
96
|
+
- **A control database for a Git stage** (`GitSubstrate(control=...)`). The outbox, the
|
|
97
|
+
inbox and rate windows' history are written in a SQLite stage under the same stage id.
|
|
98
|
+
The branch moves inside that transaction, after a redo record of it is on disk, so a
|
|
99
|
+
crash between the two commits is finished by recovery or by the next stage.
|
|
100
|
+
- **A Git substrate in `interlock.toml`.** `substrate = "git"` with a `[git]` section
|
|
101
|
+
(repository, branch, workspace, owners, `[[git.classes]]`, `[[git.hooks]]`, stage root,
|
|
102
|
+
author, size limits), and `database` naming the SQLite control database. Its tables are
|
|
103
|
+
its path classes. `interlock install` sets up the control database and reads the
|
|
104
|
+
repository, `interlock check` prints the branch's head, `interlock reconcile-effects
|
|
105
|
+
--since <commit>` reconciles the branch, and `open_substrate`, `EscrowRuntime.from_config`
|
|
106
|
+
and the daemon's engines stage on it. A Git stage's default bound is 120 seconds.
|
|
107
|
+
- **`SqliteSubstrate` gains what a control database needs.** `applied_elsewhere()` and
|
|
108
|
+
`path`, and private `_open` and `_commit` beneath `open` and `commit`, whose signatures
|
|
109
|
+
are unchanged.
|
|
110
|
+
|
|
111
|
+
### Changed
|
|
112
|
+
|
|
113
|
+
- **On Git, the agent is told about files, not rows.** Agent feedback carries the
|
|
114
|
+
substrate that measured the plan. On a repository it says files, path classes, owners
|
|
115
|
+
and "the branch moved", where SQL says rows, tables, tenants and "another writer holds
|
|
116
|
+
the rows". A live model refused for a code generator's 36 files read the SQL wording,
|
|
117
|
+
reasoned that the file must be backed by a database, and asked. Every other
|
|
118
|
+
substrate's feedback is unchanged, byte for byte.
|
|
119
|
+
|
|
120
|
+
No wire format changes. ILOK1 records, ARC1 receipts and every verdict and hash are what
|
|
121
|
+
they were; a Git stage's records and receipts are the same documents with other table
|
|
122
|
+
names in them.
|
|
123
|
+
|
|
124
|
+
## [1.0.4] - 2026-10-25
|
|
125
|
+
|
|
12
126
|
### Fixed
|
|
13
127
|
|
|
14
128
|
- **`ColumnValueGuard` and `TenantDrawdownGuard` count each row once.** A column total
|
|
@@ -1,3 +1,31 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: interlock-escrow
|
|
3
|
+
Version: 1.2.0
|
|
4
|
+
Summary: A reference monitor for agent side effects: stage, measure, adjudicate, commit.
|
|
5
|
+
Author-email: Edward Gu <ygu0929@uchicago.edu>
|
|
6
|
+
License-Expression: Apache-2.0
|
|
7
|
+
License-File: LICENSE
|
|
8
|
+
Keywords: agents,audit,escrow,llm,prompt-injection,reference-monitor,zero-trust
|
|
9
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
10
|
+
Classifier: Intended Audience :: Developers
|
|
11
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
12
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
13
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
15
|
+
Classifier: Topic :: Security
|
|
16
|
+
Classifier: Typing :: Typed
|
|
17
|
+
Requires-Python: >=3.11
|
|
18
|
+
Requires-Dist: interlock-agentgov>=1.1.0
|
|
19
|
+
Provides-Extra: kms-aws
|
|
20
|
+
Requires-Dist: interlock-agentgov[kms-aws]>=1.1.0; extra == 'kms-aws'
|
|
21
|
+
Provides-Extra: otel
|
|
22
|
+
Requires-Dist: interlock-agentgov[otel]>=1.1.0; extra == 'otel'
|
|
23
|
+
Provides-Extra: postgres
|
|
24
|
+
Requires-Dist: psycopg[binary]>=3.2; extra == 'postgres'
|
|
25
|
+
Provides-Extra: sign
|
|
26
|
+
Requires-Dist: interlock-agentgov[sign]>=1.1.0; extra == 'sign'
|
|
27
|
+
Description-Content-Type: text/markdown
|
|
28
|
+
|
|
1
29
|
# Interlock
|
|
2
30
|
|
|
3
31
|
**A reference monitor for agent side effects.** An agent proposes a plan. It holds no
|
|
@@ -268,9 +296,9 @@ blocking violation: fail closed.
|
|
|
268
296
|
| Checker | Bounds |
|
|
269
297
|
|---|---|
|
|
270
298
|
| `BlastRadius` | captured mutations in one plan |
|
|
271
|
-
| `TenantIsolation` | distinct tenants one plan may span; with `declared=True`, the tenants its effects declare |
|
|
272
|
-
| `ColumnValueGuard` | fall in a column total, table-wide |
|
|
273
|
-
| `TenantDrawdownGuard` | fall in a column total, **per tenant
|
|
299
|
+
| `TenantIsolation` | distinct tenants one plan may span; with `declared=True`, the tenants its effects declare; with `dimension=`, any other partition (a patient, an account) |
|
|
300
|
+
| `ColumnValueGuard` | fall, or rise, in a column total, table-wide |
|
|
301
|
+
| `TenantDrawdownGuard` | fall, or rise, in a column total, **per tenant**, or per any other partition |
|
|
274
302
|
| `NoDelete` | deletions outside granted tables |
|
|
275
303
|
| `NoSchemaChange` | effects declared as DDL |
|
|
276
304
|
| `TruncationGuard` | a diff that hit the row cap |
|
|
@@ -278,7 +306,7 @@ blocking violation: fail closed.
|
|
|
278
306
|
| `CrossEffectAgreement` | an outbound request against the rows it rides with ([outbox](#outbound-requests-the-transactional-outbox)) |
|
|
279
307
|
| `SinkAllowlist` | the sinks and operations a plan may call |
|
|
280
308
|
| `OutboundCount` | the requests one plan may enqueue, in all or per sink |
|
|
281
|
-
| `PayloadAmountCap` | a payload amount, per request, per tenant or per plan, per currency |
|
|
309
|
+
| `PayloadAmountCap` | a payload amount, per request, per tenant or per plan, per currency or any unit |
|
|
282
310
|
| `RecipientAllowlist` | where a request may send: email domains and addresses, https hosts, per tenant |
|
|
283
311
|
| `OutboundTenantIsolation` | the tenants one plan's requests may span |
|
|
284
312
|
| `FactAgreement` | a write against the inbound fact it must follow ([inbox](#inbound-facts-the-zero-trust-inbox)) |
|
|
@@ -298,6 +326,36 @@ wiped. Grouping by tenant first is the only way to see it.
|
|
|
298
326
|
Column totals are `Decimal`, computed through `Decimal(str(value))`, so a
|
|
299
327
|
guard permitting a 30% drawdown does not admit 30.000000000000004%.
|
|
300
328
|
|
|
329
|
+
### Partitions beyond the tenant, and guards that watch a rise
|
|
330
|
+
|
|
331
|
+
A hospital partitions by facility *and* by patient; a cloud by account and environment. A
|
|
332
|
+
table can name more dimensions than its tenant, each a column read back out of the
|
|
333
|
+
captured row, and a plan can be held to one label of each at once:
|
|
334
|
+
|
|
335
|
+
```python
|
|
336
|
+
from interlock import ColumnValueGuard, TableSpec, TenantDrawdownGuard, TenantIsolation
|
|
337
|
+
|
|
338
|
+
orders = TableSpec(
|
|
339
|
+
"med_orders",
|
|
340
|
+
columns=["id", "facility_id", "patient_id", "drug", "mme_per_day", "status"],
|
|
341
|
+
partitions={"tenant": "facility_id", "patient": "patient_id"},
|
|
342
|
+
)
|
|
343
|
+
checkers = [
|
|
344
|
+
TenantIsolation(1, declared=True), # one facility
|
|
345
|
+
TenantIsolation(1, declared=True, dimension="patient"), # and one patient's chart
|
|
346
|
+
ColumnValueGuard("med_orders", "mme_per_day", max_rise_fraction=0),
|
|
347
|
+
TenantDrawdownGuard("med_orders", "mme_per_day", max_rise_fraction=0.5, dimension="patient"),
|
|
348
|
+
]
|
|
349
|
+
```
|
|
350
|
+
|
|
351
|
+
An effect declares its labels (`PlanBuilder.update(..., tenant_id="f-1",
|
|
352
|
+
partitions={"patient": "p-1182"})`), and the agent is told only the ones it declared. Outside
|
|
353
|
+
finance the dangerous direction is often up: a dose, a replica count, a role grant. A guard
|
|
354
|
+
can bound a rise as well as a fall, and one with a rise bound reports the totals at their
|
|
355
|
+
own precision, `0.125` rather than `0.13`. A guard configured as before reports, and
|
|
356
|
+
decides, exactly as before. A rate window can keep each patient's history too:
|
|
357
|
+
`per="partition:patient"`.
|
|
358
|
+
|
|
301
359
|
Every threshold in `default_checkers` is an uncalibrated placeholder. Measure
|
|
302
360
|
your own diffs and set the limits from the measurement.
|
|
303
361
|
|
|
@@ -534,6 +592,33 @@ history. The agent is told which window refused it, never what the window holds:
|
|
|
534
592
|
`[[windows]]` in `interlock.toml` configures them, checked against `[[sinks]]` and
|
|
535
593
|
`[[tables]]`, for `EscrowEngine(windows=config.windows)`.
|
|
536
594
|
|
|
595
|
+
### Meters: conserving a unit across plans
|
|
596
|
+
|
|
597
|
+
A window bounds what plans add up to over a span. A meter conserves it the way AgentGov
|
|
598
|
+
conserves money: a dose in morphine milligram equivalents, capacity in vCPUs, seats, held
|
|
599
|
+
in an AgentGov ledger of that unit, whose envelopes are delegated down a tree of scopes.
|
|
600
|
+
Five agents working one envelope cannot each spend what is left of it:
|
|
601
|
+
|
|
602
|
+
<!-- readme-test: skip reason="continues the partitions example, with a clinical database" -->
|
|
603
|
+
```python
|
|
604
|
+
from agentgov import BudgetManager, Unit
|
|
605
|
+
from interlock import EscrowEngine, Meter, RowSum, SqliteSubstrate
|
|
606
|
+
|
|
607
|
+
mme = BudgetManager.open_sqlite("mme.db", unit=Unit("mme"))
|
|
608
|
+
engine = EscrowEngine(
|
|
609
|
+
SqliteSubstrate("ward.db", tables=[orders]),
|
|
610
|
+
checkers=checkers,
|
|
611
|
+
meters=[Meter(mme, RowSum("med_orders", "mme_per_day"), per_plan="90")],
|
|
612
|
+
)
|
|
613
|
+
```
|
|
614
|
+
|
|
615
|
+
Each plan holds `per_plan` on its scope before it stages, and is refused there, quietly
|
|
616
|
+
and with nothing staged, when the envelope has less. It is checked against `per_plan`, and
|
|
617
|
+
when it commits it settles what its diff measured; the rest of the hold comes back. A
|
|
618
|
+
refused plan's hold is released, and recovery settles a committed plan's hold whole, which
|
|
619
|
+
never under-counts. Its receipt names what it consumed and the transaction that settled
|
|
620
|
+
it.
|
|
621
|
+
|
|
537
622
|
## AgentGov integration
|
|
538
623
|
|
|
539
624
|
Interlock imports [`agentgov`](https://github.com/crimsondevil0929/agentgov) as a
|
|
@@ -723,12 +808,19 @@ What goes into one:
|
|
|
723
808
|
change, from which one row can be disclosed later without the rest; and a hash of the
|
|
724
809
|
observed schema, foreign keys included.
|
|
725
810
|
- **Coverage:** the observed tables, and every gap in words: an acknowledged cascade, a
|
|
726
|
-
substrate that did not read the foreign keys or does not refuse unobserved tables.
|
|
811
|
+
substrate that did not read the foreign keys or does not refuse unobserved tables. And
|
|
812
|
+
how strongly the effect was measured, when it was measured short of a transaction: a
|
|
813
|
+
plan whose only effect is the requests it commits says only the request was measured.
|
|
727
814
|
- **Decision:** the verdict hash, each checker with a digest of its configuration, the
|
|
728
815
|
issuer's policy epoch, and, for a repair, the refused plan's receipt as `repair_of`.
|
|
729
816
|
- **Cost:** the AgentGov transaction that settled the plan. The receipt is issued last,
|
|
730
817
|
after the reverse anchor, so agentgov's verifier can check the cost against the ledger.
|
|
731
818
|
|
|
819
|
+
A product that serves many tenants from one store can hand each tenant its own receipts:
|
|
820
|
+
`ReceiptIssuer(log, tenants="declared")` names only the tenants a plan declares, and
|
|
821
|
+
counts any others its diff reached, so a refused plan still says how far it went without
|
|
822
|
+
saying into whose rows.
|
|
823
|
+
|
|
732
824
|
The receipt and the escrow chain name each other: the stage's terminal record carries
|
|
733
825
|
the receipt id, and the receipt's `anchors.escrow` names that record by sequence and
|
|
734
826
|
hash. A receipt that cannot be issued after a commit is logged, not raised; the effects
|
|
@@ -1042,6 +1134,155 @@ role may call that writes elsewhere, an extension such as `dblink` that opens an
|
|
|
1042
1134
|
connection, and large objects. Do not grant them to the stage role. Requires PostgreSQL 14
|
|
1043
1135
|
or later; CI runs 16.
|
|
1044
1136
|
|
|
1137
|
+
## Git: the same guarantee on a branch
|
|
1138
|
+
|
|
1139
|
+
`GitSubstrate` stages a plan on a Git branch with the guarantee the SQL substrates give:
|
|
1140
|
+
what was measured is exactly what committed, or nothing committed. It needs only the `git`
|
|
1141
|
+
command.
|
|
1142
|
+
|
|
1143
|
+
- **Stage.** Each plan gets a worktree of its own at the branch's head, its *base*.
|
|
1144
|
+
- **Apply.** Effects edit files there. The repository's hooks run after each effect, the way
|
|
1145
|
+
triggers run after a statement: a code generator, a formatter, a lockfile refresh.
|
|
1146
|
+
- **Measure.** Git diffs everything in the worktree against the base. A file a hook wrote is
|
|
1147
|
+
measured exactly like a file the plan wrote.
|
|
1148
|
+
- **Commit.** The commit is `git update-ref <branch> <new> <base>`, a compare-and-swap. If
|
|
1149
|
+
anything moved the branch while the plan was staged (a push, a merge, another stage), the
|
|
1150
|
+
branch stays where it is and nothing commits.
|
|
1151
|
+
|
|
1152
|
+
<!-- readme-test: skip reason="needs a bare Git repository; tests/test_git_substrate.py makes the same calls on one" -->
|
|
1153
|
+
```python
|
|
1154
|
+
from interlock import BlastRadius, EscrowEngine, NoDelete, PlanBuilder, TableAllowlist
|
|
1155
|
+
from interlock.git_substrate import GitHook, GitSubstrate
|
|
1156
|
+
|
|
1157
|
+
repo = GitSubstrate(
|
|
1158
|
+
"/srv/git/billing-service.git",
|
|
1159
|
+
branch="main",
|
|
1160
|
+
hooks=[
|
|
1161
|
+
GitHook(
|
|
1162
|
+
"codegen",
|
|
1163
|
+
("python", "tools/codegen.py"),
|
|
1164
|
+
when=("src/billing/api/schema.json",),
|
|
1165
|
+
sources=("tools/codegen.py",),
|
|
1166
|
+
)
|
|
1167
|
+
],
|
|
1168
|
+
)
|
|
1169
|
+
engine = EscrowEngine(
|
|
1170
|
+
repo,
|
|
1171
|
+
checkers=[
|
|
1172
|
+
BlastRadius(12),
|
|
1173
|
+
TableAllowlist(["src", "tests", "docs"]),
|
|
1174
|
+
NoDelete(),
|
|
1175
|
+
],
|
|
1176
|
+
)
|
|
1177
|
+
plan = (
|
|
1178
|
+
PlanBuilder("repo-agent")
|
|
1179
|
+
.update(
|
|
1180
|
+
table="src",
|
|
1181
|
+
statement="replace :path :old :new",
|
|
1182
|
+
stated_rows=1,
|
|
1183
|
+
parameters={"path": "src/billing/invoice.py", "old": "x * 1", "new": "round(x, 2)"},
|
|
1184
|
+
)
|
|
1185
|
+
.build()
|
|
1186
|
+
)
|
|
1187
|
+
engine.execute(plan)
|
|
1188
|
+
```
|
|
1189
|
+
|
|
1190
|
+
Or configure it in `interlock.toml`, as SQLite and PostgreSQL are. `database` then names
|
|
1191
|
+
the control database, a SQLite file for the outbox, the inbox and window history (see
|
|
1192
|
+
below). `interlock install` sets it up, `interlock check` reads the branch's head through
|
|
1193
|
+
the substrate, and `EscrowRuntime.from_config`, the daemon and Fiduciary's service all stage
|
|
1194
|
+
on the repository:
|
|
1195
|
+
|
|
1196
|
+
```toml
|
|
1197
|
+
substrate = "git"
|
|
1198
|
+
database = "control.db"
|
|
1199
|
+
|
|
1200
|
+
[git]
|
|
1201
|
+
repository = "billing-service.git" # relative to this file
|
|
1202
|
+
branch = "main"
|
|
1203
|
+
workspace = "billing-service"
|
|
1204
|
+
|
|
1205
|
+
[[git.hooks]]
|
|
1206
|
+
name = "codegen"
|
|
1207
|
+
argv = ["python", "tools/codegen.py"]
|
|
1208
|
+
when = ["src/billing/api/schema.json"]
|
|
1209
|
+
sources = ["tools/codegen.py"]
|
|
1210
|
+
```
|
|
1211
|
+
|
|
1212
|
+
The tables are the path classes, so a Git configuration lists no `[[tables]]`. A
|
|
1213
|
+
`[[windows]]` `row_sum` names a class and a column, such as `src` and `lines_added`. Give
|
|
1214
|
+
`[[git.classes]]` to replace the default classes. `interlock reconcile-effects --since
|
|
1215
|
+
<commit>` reconciles the branch.
|
|
1216
|
+
|
|
1217
|
+
**What the checkers see.** Each changed path is one measured row:
|
|
1218
|
+
|
|
1219
|
+
- the *table* is the path's class: `workflows` (`.github/workflows/**`), `governance`
|
|
1220
|
+
(`CODEOWNERS`, `SECURITY.md`, `LICENSE`), `infra`, `deps` (`pyproject.toml`, `uv.lock`,
|
|
1221
|
+
`package-lock.json` and their kin), `tests`, `src`, `docs`, and `other` for any path no
|
|
1222
|
+
rule names. The globs are configurable (`PathClass`).
|
|
1223
|
+
- the *primary key* is the path;
|
|
1224
|
+
- the *partition* is the repository, or the owner a rule names for the path.
|
|
1225
|
+
|
|
1226
|
+
Each row records `path`, `blob_sha`, `mode`, `lines_added`, `lines_deleted`, `net_lines`
|
|
1227
|
+
and `secret_markers`. The last is how many credential-shaped strings the change adds: cloud
|
|
1228
|
+
and package-registry tokens, private keys, a CI workflow reading a secret, and long
|
|
1229
|
+
high-entropy strings. Only the count is kept, never the text.
|
|
1230
|
+
|
|
1231
|
+
So every built-in checker works unchanged:
|
|
1232
|
+
|
|
1233
|
+
- `TableAllowlist` keeps a plan out of workflow files;
|
|
1234
|
+
- `NoDelete` refuses a deleted test;
|
|
1235
|
+
- `BlastRadius` and `StatedFootprint` catch the 35 files a code generator rewrote after a
|
|
1236
|
+
one-line edit;
|
|
1237
|
+
- `FactAgreement` holds a dependency change to CI's signed result for exactly the bytes
|
|
1238
|
+
being written.
|
|
1239
|
+
|
|
1240
|
+
**Statements.** A statement is one operation, with `:parameters` or `'quoted'` literals.
|
|
1241
|
+
That means a tool binding can pin it the way it pins SQL:
|
|
1242
|
+
|
|
1243
|
+
| Statement | Does |
|
|
1244
|
+
|---|---|
|
|
1245
|
+
| `write :path :text` | creates or replaces a file |
|
|
1246
|
+
| `replace :path :old :new` | replaces the one occurrence of `old` (it fails on none, or on more than one) |
|
|
1247
|
+
| `delete :path` | removes a file |
|
|
1248
|
+
| `mode :path :mode` | sets `100644` or `100755` |
|
|
1249
|
+
| `patch :diff` | applies a unified diff (no renames, links or submodules) |
|
|
1250
|
+
| `expect-head :commit` | refuses unless the branch is at that commit |
|
|
1251
|
+
|
|
1252
|
+
`expect-head` pins a plan to the commit its approvers reviewed. A warrant over such a plan
|
|
1253
|
+
commits onto that exact commit or not at all.
|
|
1254
|
+
|
|
1255
|
+
A path is refused if it is absolute, has a `..` component, reaches into `.git`, or passes
|
|
1256
|
+
through a symbolic link. A plan may not write a file a hook runs (`GitHook.sources`).
|
|
1257
|
+
|
|
1258
|
+
**Recovery and reconciliation.**
|
|
1259
|
+
|
|
1260
|
+
- Each commit carries the trailer `Interlock-Stage: <stage id>`. `resolve_intent` reads the
|
|
1261
|
+
branch's history for it, so a crash between the commit intent and its record is settled
|
|
1262
|
+
exactly.
|
|
1263
|
+
- Savepoints are trees, so `EscrowEngine.repair` searches sub-plans on Git as it does on
|
|
1264
|
+
SQL.
|
|
1265
|
+
- `reconcile_git(substrate, records, since=...)` names every commit on the branch that no
|
|
1266
|
+
stage made, and a force-push that rewrote the branch.
|
|
1267
|
+
|
|
1268
|
+
**The control database.** Rate windows, the outbox and the inbox need a transactional home
|
|
1269
|
+
that Git does not have. Pass `control=` a SQLite file that `interlock install` set up. A
|
|
1270
|
+
stage then writes its requests, the facts it consumes and its window history there, and
|
|
1271
|
+
the branch moves inside that transaction, just before it commits. A redo record is written
|
|
1272
|
+
to disk before the branch moves. If the process dies between the two commits, the next
|
|
1273
|
+
stage or `EscrowEngine.recover()` finishes the database's half, exactly when the branch
|
|
1274
|
+
holds the commit.
|
|
1275
|
+
|
|
1276
|
+
**Limits.**
|
|
1277
|
+
|
|
1278
|
+
- A hook is operator code. It runs in the stage's worktree, with a timeout and a scrubbed
|
|
1279
|
+
environment (no variable of the process reaches it but `PATH`), and it can reach anything
|
|
1280
|
+
the process can.
|
|
1281
|
+
- Point the substrate at a bare repository, or at a branch no worktree has checked out.
|
|
1282
|
+
Moving a checked-out branch would leave that worktree behind, so the substrate refuses.
|
|
1283
|
+
- A commit that a force-push later removes from the branch reads as not committed to
|
|
1284
|
+
recovery, unless a control database recorded it. Reconciliation names the rewrite.
|
|
1285
|
+
|
|
1045
1286
|
## Outbound requests: the transactional outbox
|
|
1046
1287
|
|
|
1047
1288
|
An email, a refund through a payment API, a webhook: a plan often has to call something
|
|
@@ -1271,6 +1512,43 @@ secret_env = "SENDGRID_API_KEY"
|
|
|
1271
1512
|
- `tests/test_relay_crash.py` drives both through the relay's kill matrix, on both stores:
|
|
1272
1513
|
a charge is made once and an email is never sent twice.
|
|
1273
1514
|
|
|
1515
|
+
### MCP tools, and holding an operation for a warrant
|
|
1516
|
+
|
|
1517
|
+
An MCP tool that writes, behind a sink of type `mcp`, is governed like any request: the
|
|
1518
|
+
plan is measured and judged, the call is committed to the outbox, and the relay makes it
|
|
1519
|
+
as one `tools/call`. MCP has no idempotency key, so an `mcp` sink is always at most once:
|
|
1520
|
+
a call whose outcome is unknown is never made again, and goes to an operator. Some
|
|
1521
|
+
operations should never run on an agent's word alone. Mark them `hold = true`, on any
|
|
1522
|
+
sink, and every request of them enters the outbox held, even with the breaker closed,
|
|
1523
|
+
until an operator or a warrant releases it:
|
|
1524
|
+
|
|
1525
|
+
```toml
|
|
1526
|
+
[[sinks]]
|
|
1527
|
+
name = "crm"
|
|
1528
|
+
type = "mcp"
|
|
1529
|
+
|
|
1530
|
+
[[sinks.operations]]
|
|
1531
|
+
name = "close_ticket"
|
|
1532
|
+
schema = "schemas/close_ticket.json" # the input schema you pin, not the server's of the day
|
|
1533
|
+
hold = true
|
|
1534
|
+
|
|
1535
|
+
[[relay.endpoints]]
|
|
1536
|
+
sink = "crm"
|
|
1537
|
+
command = ["crm-mcp-server", "--stdio"]
|
|
1538
|
+
```
|
|
1539
|
+
|
|
1540
|
+
The receipt of a plan whose only effect is such a request says so: it was measured only
|
|
1541
|
+
as the request, and names the sink that carries its effect.
|
|
1542
|
+
|
|
1543
|
+
### Sinks and sources of your own
|
|
1544
|
+
|
|
1545
|
+
A FHIR server, ServiceNow or a cloud's API can be a typed sink of its own, configured from
|
|
1546
|
+
`interlock.toml` like Stripe: a package registers its kind with `register_sink_kind`, or
|
|
1547
|
+
under the `interlock.sinks` entry point, following the contract `interlock.stripe` and
|
|
1548
|
+
`interlock.mcp` follow (its operations or none, its idempotency, its payload rules, and its
|
|
1549
|
+
relay adapter). A vendor whose webhooks sign their own way is an inbox source kind,
|
|
1550
|
+
through `register_source_kind` or `interlock.sources`.
|
|
1551
|
+
|
|
1274
1552
|
### On SQLite
|
|
1275
1553
|
|
|
1276
1554
|
The outbox, the relay and every operator command work on a SQLite file as they do on
|