interlock-escrow 1.2.0__tar.gz → 1.3.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.2.0 → interlock_escrow-1.3.0}/CHANGELOG.md +74 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/PKG-INFO +107 -1
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/README.md +106 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/ESCROW_SPEC.md +38 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/pyproject.toml +7 -1
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/__init__.py +24 -1
- interlock_escrow-1.3.0/src/interlock/checker_packs.py +179 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/cli.py +62 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/config.py +337 -10
- interlock_escrow-1.3.0/src/interlock/control.py +135 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/daemon.py +2 -1
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/engine.py +99 -2
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/exceptions.py +20 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/git_substrate.py +10 -91
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/invariants.py +53 -6
- interlock_escrow-1.3.0/src/interlock/kubernetes.py +1465 -0
- interlock_escrow-1.3.0/src/interlock/planbound.py +127 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/postgres.py +5 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/runtime.py +11 -1
- interlock_escrow-1.3.0/src/interlock/sensors.py +382 -0
- interlock_escrow-1.3.0/src/interlock/sim/__init__.py +10 -0
- interlock_escrow-1.3.0/src/interlock/sim/kubernetes.py +690 -0
- interlock_escrow-1.3.0/src/interlock/sim/terraform.py +307 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/substrate.py +5 -0
- interlock_escrow-1.3.0/src/interlock/terraform.py +813 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/types.py +160 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/wiring.py +64 -0
- interlock_escrow-1.3.0/tests/test_checker_packs.py +141 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_config.py +4 -1
- interlock_escrow-1.3.0/tests/test_config_plan_bound.py +224 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_git_substrate.py +4 -1
- interlock_escrow-1.3.0/tests/test_kubernetes.py +1093 -0
- interlock_escrow-1.3.0/tests/test_planbound.py +72 -0
- interlock_escrow-1.3.0/tests/test_sensors.py +349 -0
- interlock_escrow-1.3.0/tests/test_terraform.py +567 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/.github/workflows/ci.yml +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/.github/workflows/release.yml +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/.gitignore +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/.python-version +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/LICENSE +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/SECURITY.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/demo/customer_acceptance_suite.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/demo.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/CUSTOMER_ACCEPTANCE_MATRIX.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/EPIC3_DESIGN.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/EPIC4_DESIGN.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/EPIC5_DESIGN.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/EPIC6_DESIGN.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/EPIC7_DESIGN.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/EPIC8_DESIGN.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/EPIC9_DESIGN.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/docs/OUTBOX_DESIGN.md +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/scripts/live_gauntlet.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/scripts/live_stress_test.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/scripts/metrics_overhead.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/scripts/security_audit.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/adapters.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/adjudication.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/anchor.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/attestations.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/builder.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/cascade.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/chain.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/cluster.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/compaction.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/deliveries.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/extension.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/feedback.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/inbox.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/inbox_sql.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/inbox_store.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/keys.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/mcp.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/meters.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/operators.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/outbound.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/outbound_checks.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/outbox_sql.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/outbox_store.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/py.typed +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/receipts.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/reconcile.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/records.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/recovery.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/relay.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/repair.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/sampling.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/sendgrid.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/settlement.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/signers.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/sqlite_outbox.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/stripe.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/supervisor.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/telemetry.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/trace.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/vacuum.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/src/interlock/windows.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/__init__.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/checker_digests.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/children.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/conftest.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/crash_child.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/daemon_app.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/fakekms.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/fakepg.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/fakesendgrid.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/fakesink.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/fakestripe.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/inbox_child.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/inbox_env.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/operator_child.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/outbox_env.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/outbox_v2.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/outbox_v3.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/outbox_v4.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/pgbouncer/pgbouncer.ini +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/pgbouncer/userlist.txt +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/plans.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/relay_child.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/schemas.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/settle_child.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/settling.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/sqlite_outbox_v3.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/sqlite_outbox_v4.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/sqlite_stage_child.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_acceptance_suite.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_agreement.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_anchor.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_attestations.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_cascades.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_checker_records.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_cluster.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_cluster_daemon.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_core_guarantees.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_crash_consistency.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_daemon.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_deliveries.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_engine.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_ergonomics.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_extension.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_fact_agreement.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_feedback.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_horizontal.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_inbox.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_inbox_cli.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_inbox_crash.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_inbox_engine.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_inbox_vendors.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_instrumentation.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_keys.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_live_sinks.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_metrics.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_operator_crash.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_operators.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_outbound.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_outbound_checks.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_outbox_postgres.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_pg_upgrade.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_pool.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_postgres.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_readme_snippets.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_reconcile.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_records.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_recovery.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_relay.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_relay_crash.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_repair.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_runtime.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_sampling.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_security_audit.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_sendgrid.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_settlement.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_settlement_crash.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_shared_transaction.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_signers.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_soak.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_sqlite_outbox.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_sqlite_stage_crash.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_stripe.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_supervisor.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_takeover.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_tamper_evidence.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_trace.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_typed_config.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_upgrade_v5.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_vacuum.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_vacuum_crash.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_vacuum_inbox.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/test_windows.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/tests/vacuum_child.py +0 -0
- {interlock_escrow-1.2.0 → interlock_escrow-1.3.0}/uv.lock +0 -0
|
@@ -9,6 +9,80 @@ Releases before 0.1.2 are described by their tags and commit history.
|
|
|
9
9
|
|
|
10
10
|
## [Unreleased]
|
|
11
11
|
|
|
12
|
+
## [1.3.0] - 2026-10-31
|
|
13
|
+
|
|
14
|
+
Plan-bound substrates, sensor facts, and pinned checker packs.
|
|
15
|
+
|
|
16
|
+
Kubernetes and Terraform as substrates, staged class P: what was measured is the plan that
|
|
17
|
+
is applied, on the state measured, with an undo written down first. Upgrades from 1.2.0 in
|
|
18
|
+
place, and requires nothing new: every plan, diff, verdict, schema, checker and receipt
|
|
19
|
+
hash a configuration that uses none of what follows wrote before is unchanged.
|
|
20
|
+
|
|
21
|
+
### Added
|
|
22
|
+
|
|
23
|
+
- **The `apply` effect kind** (`EffectKind.APPLY`): an effect in the substrate's own
|
|
24
|
+
statement language, a manifest or an input, never SQL. What it does is never read from
|
|
25
|
+
its kind: the substrate measures it, and the checkers judge the measured diff. SQLite and
|
|
26
|
+
PostgreSQL refuse it at admission.
|
|
27
|
+
- **Plan-bound substrates** (`interlock.planbound`, `SubstrateCapabilities.plan_bound`).
|
|
28
|
+
A substrate that cannot roll back writes the before images of what it will change to an
|
|
29
|
+
undo journal before the first write; the engine names the undo's SHA-256 in the stage's
|
|
30
|
+
`COMMIT_INTENT`. A commit that fails part way is put back from the undo and recorded
|
|
31
|
+
`COMPENSATED` (`CompensatedError`); one whose undo fails too stays open for recovery,
|
|
32
|
+
which reads each object's stage marker: all written is `COMMITTED`, none is `ABORTED`,
|
|
33
|
+
part is put back and `COMPENSATED`. An object that is neither as written nor as it was
|
|
34
|
+
is left for an operator. Every receipt says `coverage.measurement = "plan-bound"`.
|
|
35
|
+
- **`KubernetesSubstrate`** (`interlock.kubernetes`, `substrate = "kubernetes"`). Each
|
|
36
|
+
kind (`KubeKind`) is a table; each object a row keyed `<namespace>/<name>`, its tenant
|
|
37
|
+
the namespace, its columns paths or products of quantities (`vcpu` = replicas x CPU
|
|
38
|
+
request), and a `fingerprint` of the whole object. An effect reads the object live, with
|
|
39
|
+
its `resourceVersion`, changes it as its statement says (`scale`, `set`, `merge-patch`,
|
|
40
|
+
`apply`, `delete`, `expect-version`), and sends it with `?dryRun=All`: the after image is
|
|
41
|
+
the API server's, with every mutating webhook and default applied. A webhook declaring
|
|
42
|
+
side effects makes the API server refuse the dry run, and the stage with it. A change to
|
|
43
|
+
an immutable field is refused, or, on a kind marked `replace_on_immutable` (a GitOps
|
|
44
|
+
`Replace=true` sync), measured as a deletion and a creation, which `NoDelete` sees. The
|
|
45
|
+
commit writes each object on the version measured (`409 Conflict` fails closed), with
|
|
46
|
+
the `interlock.io/stage-id` annotation, and checks that it landed as measured. A control
|
|
47
|
+
database holds the outbox, the inbox and the windows, redone after a crash as Git's is.
|
|
48
|
+
- **`TerraformSubstrate`** (`interlock.terraform`, `substrate = "terraform"`, for
|
|
49
|
+
Terraform or OpenTofu). Effects `set` input variables; the stage runs `plan -out` and
|
|
50
|
+
reads `show -json`: each `resource_changes` entry is a row of its type's table
|
|
51
|
+
(`TfResource`), a replacement a deletion and an insertion, and a resource of an
|
|
52
|
+
unobserved type a row of `resources`. An observed attribute known only after the apply
|
|
53
|
+
is an `UnknownValue`. The commit checks the state's `serial` and `lineage` and applies
|
|
54
|
+
the saved plan (a stale one is a conflict, never compensated); the stage's id reaches
|
|
55
|
+
the state as the `interlock_stage_id` output. A partial apply is followed by an apply of
|
|
56
|
+
the previous inputs.
|
|
57
|
+
- **Loopback stand-ins** (`interlock.sim`): a Kubernetes API server with admission
|
|
58
|
+
webhooks called over HTTP (`AdmissionReview`), dry runs, `resourceVersion`
|
|
59
|
+
preconditions, immutable fields, bearer tokens, an `audit.k8s.io` log and injected
|
|
60
|
+
faults; and a `terraform` command over a local model, in the real plan JSON format. CI
|
|
61
|
+
and `fiduciary demo` stage class P with no cloud credentials.
|
|
62
|
+
- **Sensor facts** (`interlock.sensors`). An analyzer (a policy engine, a scanner, a test
|
|
63
|
+
run) runs beside the stage on the diff it measured, and signs a `SensorFact`: its
|
|
64
|
+
verdict, its findings and its report's digest, bound to the diff's `measured_hash()`.
|
|
65
|
+
`EscrowEngine(sensors=...)` runs each (`CommandSensor`, its own process holding its own
|
|
66
|
+
key; `FunctionSensor`, in process) and attaches the facts; the pure
|
|
67
|
+
`SensorAttestation(sensor, keys)` checker requires a clean one, signed by a pinned key,
|
|
68
|
+
about this very diff. `[sensors.<name>]` in `interlock.toml`.
|
|
69
|
+
- **Pinned checker packs** (`interlock.checker_packs`): a module naming `PACK_VERSION`
|
|
70
|
+
and `CHECKERS`, loaded only if the code installed matches the digest pinned
|
|
71
|
+
(`load_pack(PackPin(module, version, digest))`); missing, another version and tampered
|
|
72
|
+
are refused by name.
|
|
73
|
+
- **`TruncationGuard(acknowledged_unknown=...)`** refuses a value known only after the
|
|
74
|
+
apply unless its `<table>.<column>` is acknowledged. Its digest is unchanged when unused.
|
|
75
|
+
- **A receipt names the commit a substrate made** when the substrate names it only at
|
|
76
|
+
commit: a Git substrate's receipts now carry the commit's id, so a code host's audit log
|
|
77
|
+
of pushes reconciles against them.
|
|
78
|
+
- `interlock check` and `install` describe a plan-bound substrate; `reconcile-effects`
|
|
79
|
+
points to the system's own audit log instead.
|
|
80
|
+
|
|
81
|
+
### Changed
|
|
82
|
+
|
|
83
|
+
- `interlock.control` holds the control database's redo, which the Git substrate now
|
|
84
|
+
shares with the Kubernetes substrate.
|
|
85
|
+
|
|
12
86
|
## [1.2.0] - 2026-10-31
|
|
13
87
|
|
|
14
88
|
Any partition, any unit, any sink, and honest receipts. Upgrades from 1.1.0 in place.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: interlock-escrow
|
|
3
|
-
Version: 1.
|
|
3
|
+
Version: 1.3.0
|
|
4
4
|
Summary: A reference monitor for agent side effects: stage, measure, adjudicate, commit.
|
|
5
5
|
Author-email: Edward Gu <ygu0929@uchicago.edu>
|
|
6
6
|
License-Expression: Apache-2.0
|
|
@@ -1283,6 +1283,112 @@ holds the commit.
|
|
|
1283
1283
|
- A commit that a force-push later removes from the branch reads as not committed to
|
|
1284
1284
|
recovery, unless a control database recorded it. Reconciliation names the rewrite.
|
|
1285
1285
|
|
|
1286
|
+
## Kubernetes and Terraform: plan-bound
|
|
1287
|
+
|
|
1288
|
+
A cluster and a Terraform configuration cannot be staged in a transaction and rolled back.
|
|
1289
|
+
They can be measured exactly, though, and the change applied on the condition that nothing
|
|
1290
|
+
moved. Interlock calls that *plan-bound*: what was measured is the plan that is applied, on
|
|
1291
|
+
the state it was measured on, and a partial failure is put back from an undo written down
|
|
1292
|
+
before the first write. Every receipt of such a plan says `coverage.measurement =
|
|
1293
|
+
"plan-bound"`, never `transactional`.
|
|
1294
|
+
|
|
1295
|
+
`KubernetesSubstrate` measures with the API server's own dry run:
|
|
1296
|
+
|
|
1297
|
+
- **Stage.** Each effect reads its object live, with its `resourceVersion`, and changes it as
|
|
1298
|
+
its statement says: `scale`, `set` (one field), `merge-patch`, `apply` (a whole manifest),
|
|
1299
|
+
`delete`, or `expect-version` (pin the version approvers saw).
|
|
1300
|
+
- **Measure.** The changed object goes to the API server with `?dryRun=All`. Defaults, every
|
|
1301
|
+
mutating admission webhook and every validating one run as on a real write, and what comes
|
|
1302
|
+
back is the after image. A webhook that turns 6 replicas into 60 is measured as 60. A
|
|
1303
|
+
webhook declaring side effects makes the API server refuse the dry run, so a change whose
|
|
1304
|
+
admission cannot be measured never stages.
|
|
1305
|
+
- **Forced replacements.** A change to an immutable field is refused, or, on a kind marked
|
|
1306
|
+
`replace_on_immutable` (a GitOps sync with `Replace=true`), measured as the deletion and
|
|
1307
|
+
creation the sync would do. `NoDelete` sees the deletion.
|
|
1308
|
+
- **Commit.** Each object is written on the version measured, with the annotation
|
|
1309
|
+
`interlock.io/stage-id`. If anything wrote it since, the API server answers
|
|
1310
|
+
`409 Conflict` and nothing is applied. An object that lands other than measured, or a
|
|
1311
|
+
write that fails part way, is put back from the undo, and the stage is `COMPENSATED`.
|
|
1312
|
+
|
|
1313
|
+
<!-- readme-test: skip reason="needs a cluster; tests/test_kubernetes.py makes the same calls on interlock.sim.kubernetes" -->
|
|
1314
|
+
```python
|
|
1315
|
+
from interlock import BlastRadius, EscrowEngine, KubeKind, KubernetesSubstrate, NoDelete
|
|
1316
|
+
|
|
1317
|
+
cluster = KubernetesSubstrate(
|
|
1318
|
+
"https://10.0.0.1:6443",
|
|
1319
|
+
token=open("/var/run/secrets/remediator/token").read().strip(),
|
|
1320
|
+
ca_file="/var/run/secrets/remediator/ca.crt",
|
|
1321
|
+
namespaces=["prod-east"],
|
|
1322
|
+
journal="/var/lib/interlock/undo",
|
|
1323
|
+
kinds=[
|
|
1324
|
+
KubeKind(
|
|
1325
|
+
"deployments",
|
|
1326
|
+
"deployments",
|
|
1327
|
+
"Deployment",
|
|
1328
|
+
group="apps",
|
|
1329
|
+
columns={
|
|
1330
|
+
"replicas": "spec.replicas",
|
|
1331
|
+
"vcpu": "spec.replicas * spec.template.spec.containers.0.resources.requests.cpu",
|
|
1332
|
+
},
|
|
1333
|
+
),
|
|
1334
|
+
KubeKind(
|
|
1335
|
+
"statefulsets",
|
|
1336
|
+
"statefulsets",
|
|
1337
|
+
"StatefulSet",
|
|
1338
|
+
group="apps",
|
|
1339
|
+
columns={"storage": "spec.volumeClaimTemplates.0.spec.resources.requests.storage"},
|
|
1340
|
+
replace_on_immutable=True,
|
|
1341
|
+
),
|
|
1342
|
+
],
|
|
1343
|
+
)
|
|
1344
|
+
engine = EscrowEngine(cluster, checkers=[BlastRadius(20), NoDelete(())])
|
|
1345
|
+
```
|
|
1346
|
+
|
|
1347
|
+
`TerraformSubstrate` (Terraform or OpenTofu) measures with a saved plan. Effects `set` input
|
|
1348
|
+
variables; the stage runs `plan -out` and reads `show -json`. Each entry of
|
|
1349
|
+
`resource_changes` is a row of its resource type's table (`TfResource`): a replacement is a
|
|
1350
|
+
deletion and an insertion, and a resource of a type no table names is measured in
|
|
1351
|
+
`resources`. An observed attribute the provider knows only after the apply is an
|
|
1352
|
+
`UnknownValue`, which `TruncationGuard` refuses unless that column is acknowledged
|
|
1353
|
+
(`TruncationGuard(acknowledged_unknown={"db_instances.endpoint"})`). The commit checks the
|
|
1354
|
+
state's `serial` and `lineage` and applies exactly the saved plan; the stage's id reaches the
|
|
1355
|
+
state as the `interlock_stage_id` output, which the configuration declares.
|
|
1356
|
+
|
|
1357
|
+
Both are configured in `interlock.toml` (`substrate = "kubernetes"` with `[kubernetes]` and
|
|
1358
|
+
`[[kubernetes.kinds]]`, `substrate = "terraform"` with `[terraform]` and
|
|
1359
|
+
`[[terraform.resources]]`). `interlock.sim` has a loopback API server, with webhooks called
|
|
1360
|
+
over HTTP and an audit log, and a stand-in `terraform` command: CI stages class P with no
|
|
1361
|
+
cloud credentials.
|
|
1362
|
+
|
|
1363
|
+
### Sensor facts: an analyzer's word on the exact diff
|
|
1364
|
+
|
|
1365
|
+
A checker is a pure function of the plan and the diff, so it cannot call a policy engine, a
|
|
1366
|
+
scanner or a test suite. A *sensor* can. The engine shows each measured diff to its sensors
|
|
1367
|
+
(`EscrowEngine(sensors=...)`), and each signs a `SensorFact` with its own key: its verdict,
|
|
1368
|
+
its findings, the digest of its report, and the hash of the diff it read. The pure
|
|
1369
|
+
`SensorAttestation` checker then requires a clean fact from a key the policy pins. A fact
|
|
1370
|
+
about another diff, or one signed by another key, is no fact.
|
|
1371
|
+
|
|
1372
|
+
<!-- readme-test: skip reason="needs an analyzer command; tests/test_sensors.py runs one" -->
|
|
1373
|
+
```python
|
|
1374
|
+
from interlock import CommandSensor, EscrowEngine, SensorAttestation
|
|
1375
|
+
|
|
1376
|
+
policy = CommandSensor("policy-check", ["policy-check", "--key", "/etc/policy-check/key"])
|
|
1377
|
+
engine = EscrowEngine(
|
|
1378
|
+
cluster,
|
|
1379
|
+
checkers=[SensorAttestation("policy-check", ["ed25519:3b6a27bc..."])],
|
|
1380
|
+
sensors=[policy],
|
|
1381
|
+
)
|
|
1382
|
+
```
|
|
1383
|
+
|
|
1384
|
+
### Pinned checker packs
|
|
1385
|
+
|
|
1386
|
+
A domain whose invariant cannot be composed from the built-in checkers ships a pack: a
|
|
1387
|
+
module naming `PACK_VERSION` and `CHECKERS`. `load_pack(PackPin(module, version, digest))`
|
|
1388
|
+
loads it only if the code installed is exactly the code pinned (the digest covers every file
|
|
1389
|
+
of the package), and says which it is otherwise: not installed, another version, or
|
|
1390
|
+
tampered.
|
|
1391
|
+
|
|
1286
1392
|
## Outbound requests: the transactional outbox
|
|
1287
1393
|
|
|
1288
1394
|
An email, a refund through a payment API, a webhook: a plan often has to call something
|
|
@@ -1255,6 +1255,112 @@ holds the commit.
|
|
|
1255
1255
|
- A commit that a force-push later removes from the branch reads as not committed to
|
|
1256
1256
|
recovery, unless a control database recorded it. Reconciliation names the rewrite.
|
|
1257
1257
|
|
|
1258
|
+
## Kubernetes and Terraform: plan-bound
|
|
1259
|
+
|
|
1260
|
+
A cluster and a Terraform configuration cannot be staged in a transaction and rolled back.
|
|
1261
|
+
They can be measured exactly, though, and the change applied on the condition that nothing
|
|
1262
|
+
moved. Interlock calls that *plan-bound*: what was measured is the plan that is applied, on
|
|
1263
|
+
the state it was measured on, and a partial failure is put back from an undo written down
|
|
1264
|
+
before the first write. Every receipt of such a plan says `coverage.measurement =
|
|
1265
|
+
"plan-bound"`, never `transactional`.
|
|
1266
|
+
|
|
1267
|
+
`KubernetesSubstrate` measures with the API server's own dry run:
|
|
1268
|
+
|
|
1269
|
+
- **Stage.** Each effect reads its object live, with its `resourceVersion`, and changes it as
|
|
1270
|
+
its statement says: `scale`, `set` (one field), `merge-patch`, `apply` (a whole manifest),
|
|
1271
|
+
`delete`, or `expect-version` (pin the version approvers saw).
|
|
1272
|
+
- **Measure.** The changed object goes to the API server with `?dryRun=All`. Defaults, every
|
|
1273
|
+
mutating admission webhook and every validating one run as on a real write, and what comes
|
|
1274
|
+
back is the after image. A webhook that turns 6 replicas into 60 is measured as 60. A
|
|
1275
|
+
webhook declaring side effects makes the API server refuse the dry run, so a change whose
|
|
1276
|
+
admission cannot be measured never stages.
|
|
1277
|
+
- **Forced replacements.** A change to an immutable field is refused, or, on a kind marked
|
|
1278
|
+
`replace_on_immutable` (a GitOps sync with `Replace=true`), measured as the deletion and
|
|
1279
|
+
creation the sync would do. `NoDelete` sees the deletion.
|
|
1280
|
+
- **Commit.** Each object is written on the version measured, with the annotation
|
|
1281
|
+
`interlock.io/stage-id`. If anything wrote it since, the API server answers
|
|
1282
|
+
`409 Conflict` and nothing is applied. An object that lands other than measured, or a
|
|
1283
|
+
write that fails part way, is put back from the undo, and the stage is `COMPENSATED`.
|
|
1284
|
+
|
|
1285
|
+
<!-- readme-test: skip reason="needs a cluster; tests/test_kubernetes.py makes the same calls on interlock.sim.kubernetes" -->
|
|
1286
|
+
```python
|
|
1287
|
+
from interlock import BlastRadius, EscrowEngine, KubeKind, KubernetesSubstrate, NoDelete
|
|
1288
|
+
|
|
1289
|
+
cluster = KubernetesSubstrate(
|
|
1290
|
+
"https://10.0.0.1:6443",
|
|
1291
|
+
token=open("/var/run/secrets/remediator/token").read().strip(),
|
|
1292
|
+
ca_file="/var/run/secrets/remediator/ca.crt",
|
|
1293
|
+
namespaces=["prod-east"],
|
|
1294
|
+
journal="/var/lib/interlock/undo",
|
|
1295
|
+
kinds=[
|
|
1296
|
+
KubeKind(
|
|
1297
|
+
"deployments",
|
|
1298
|
+
"deployments",
|
|
1299
|
+
"Deployment",
|
|
1300
|
+
group="apps",
|
|
1301
|
+
columns={
|
|
1302
|
+
"replicas": "spec.replicas",
|
|
1303
|
+
"vcpu": "spec.replicas * spec.template.spec.containers.0.resources.requests.cpu",
|
|
1304
|
+
},
|
|
1305
|
+
),
|
|
1306
|
+
KubeKind(
|
|
1307
|
+
"statefulsets",
|
|
1308
|
+
"statefulsets",
|
|
1309
|
+
"StatefulSet",
|
|
1310
|
+
group="apps",
|
|
1311
|
+
columns={"storage": "spec.volumeClaimTemplates.0.spec.resources.requests.storage"},
|
|
1312
|
+
replace_on_immutable=True,
|
|
1313
|
+
),
|
|
1314
|
+
],
|
|
1315
|
+
)
|
|
1316
|
+
engine = EscrowEngine(cluster, checkers=[BlastRadius(20), NoDelete(())])
|
|
1317
|
+
```
|
|
1318
|
+
|
|
1319
|
+
`TerraformSubstrate` (Terraform or OpenTofu) measures with a saved plan. Effects `set` input
|
|
1320
|
+
variables; the stage runs `plan -out` and reads `show -json`. Each entry of
|
|
1321
|
+
`resource_changes` is a row of its resource type's table (`TfResource`): a replacement is a
|
|
1322
|
+
deletion and an insertion, and a resource of a type no table names is measured in
|
|
1323
|
+
`resources`. An observed attribute the provider knows only after the apply is an
|
|
1324
|
+
`UnknownValue`, which `TruncationGuard` refuses unless that column is acknowledged
|
|
1325
|
+
(`TruncationGuard(acknowledged_unknown={"db_instances.endpoint"})`). The commit checks the
|
|
1326
|
+
state's `serial` and `lineage` and applies exactly the saved plan; the stage's id reaches the
|
|
1327
|
+
state as the `interlock_stage_id` output, which the configuration declares.
|
|
1328
|
+
|
|
1329
|
+
Both are configured in `interlock.toml` (`substrate = "kubernetes"` with `[kubernetes]` and
|
|
1330
|
+
`[[kubernetes.kinds]]`, `substrate = "terraform"` with `[terraform]` and
|
|
1331
|
+
`[[terraform.resources]]`). `interlock.sim` has a loopback API server, with webhooks called
|
|
1332
|
+
over HTTP and an audit log, and a stand-in `terraform` command: CI stages class P with no
|
|
1333
|
+
cloud credentials.
|
|
1334
|
+
|
|
1335
|
+
### Sensor facts: an analyzer's word on the exact diff
|
|
1336
|
+
|
|
1337
|
+
A checker is a pure function of the plan and the diff, so it cannot call a policy engine, a
|
|
1338
|
+
scanner or a test suite. A *sensor* can. The engine shows each measured diff to its sensors
|
|
1339
|
+
(`EscrowEngine(sensors=...)`), and each signs a `SensorFact` with its own key: its verdict,
|
|
1340
|
+
its findings, the digest of its report, and the hash of the diff it read. The pure
|
|
1341
|
+
`SensorAttestation` checker then requires a clean fact from a key the policy pins. A fact
|
|
1342
|
+
about another diff, or one signed by another key, is no fact.
|
|
1343
|
+
|
|
1344
|
+
<!-- readme-test: skip reason="needs an analyzer command; tests/test_sensors.py runs one" -->
|
|
1345
|
+
```python
|
|
1346
|
+
from interlock import CommandSensor, EscrowEngine, SensorAttestation
|
|
1347
|
+
|
|
1348
|
+
policy = CommandSensor("policy-check", ["policy-check", "--key", "/etc/policy-check/key"])
|
|
1349
|
+
engine = EscrowEngine(
|
|
1350
|
+
cluster,
|
|
1351
|
+
checkers=[SensorAttestation("policy-check", ["ed25519:3b6a27bc..."])],
|
|
1352
|
+
sensors=[policy],
|
|
1353
|
+
)
|
|
1354
|
+
```
|
|
1355
|
+
|
|
1356
|
+
### Pinned checker packs
|
|
1357
|
+
|
|
1358
|
+
A domain whose invariant cannot be composed from the built-in checkers ships a pack: a
|
|
1359
|
+
module naming `PACK_VERSION` and `CHECKERS`. `load_pack(PackPin(module, version, digest))`
|
|
1360
|
+
loads it only if the code installed is exactly the code pinned (the digest covers every file
|
|
1361
|
+
of the package), and says which it is otherwise: not installed, another version, or
|
|
1362
|
+
tampered.
|
|
1363
|
+
|
|
1258
1364
|
## Outbound requests: the transactional outbox
|
|
1259
1365
|
|
|
1260
1366
|
An email, a refund through a payment API, a webhook: a plan often has to call something
|
|
@@ -955,6 +955,36 @@ technical one. It means v1 gives a hard guarantee on transactional SQL and an
|
|
|
955
955
|
explicitly weaker, at-least-once, compensation-backed guarantee everywhere else,
|
|
956
956
|
rather than a uniform guarantee that is quietly false at the edges.
|
|
957
957
|
|
|
958
|
+
## 4.5 Plan-bound substrates (added in 1.3.0)
|
|
959
|
+
|
|
960
|
+
A Kubernetes cluster and a Terraform configuration are neither a transaction nor
|
|
961
|
+
an email. They cannot roll back, but they can be measured exactly and written on
|
|
962
|
+
a condition: a `resourceVersion`, a state serial. Interlock stages them as
|
|
963
|
+
*plan-bound* (class P): what was measured is the plan that is applied, on the
|
|
964
|
+
state it was measured on.
|
|
965
|
+
|
|
966
|
+
- **E4-6.** A plan-bound substrate MUST measure with the system's own planner:
|
|
967
|
+
the API server's dry run, admission included; Terraform's saved plan. A change
|
|
968
|
+
the planner cannot measure (a webhook declaring side effects, refused a dry
|
|
969
|
+
run) MUST NOT stage. A value the planner cannot know before the apply MUST be
|
|
970
|
+
named in the diff (`UnknownValue`), and is refused unless acknowledged.
|
|
971
|
+
- **E4-7.** The commit MUST apply exactly what was measured, conditional on the
|
|
972
|
+
state measured, and MUST fail closed, applying nothing, when the state moved.
|
|
973
|
+
- **E4-8.** The undo (the before image of every object the commit will write,
|
|
974
|
+
or the inputs before the plan) MUST be written durably **before** the first
|
|
975
|
+
write, and its digest named in the stage's `COMMIT_INTENT` (the undo before
|
|
976
|
+
the do, as E4-3). A partial apply MUST be put back from it and recorded
|
|
977
|
+
`COMPENSATED`; one that cannot be put back MUST leave the intent open.
|
|
978
|
+
- **E4-9.** Every object written MUST carry the stage's marker, which recovery
|
|
979
|
+
reads, and which the system's own audit log echoes. Recovery MUST NOT read an
|
|
980
|
+
object that is neither as written nor as it was as either.
|
|
981
|
+
- **E4-10.** Every receipt of a plan-bound stage MUST say
|
|
982
|
+
`coverage.measurement = "plan-bound"` (ARC1 1.3).
|
|
983
|
+
|
|
984
|
+
An undo restores configuration, not data: a database a forced replacement
|
|
985
|
+
destroyed comes back empty. That is why a replacement is measured as the
|
|
986
|
+
deletion it is, and refused by `NoDelete` before anything is applied.
|
|
987
|
+
|
|
958
988
|
---
|
|
959
989
|
|
|
960
990
|
# 5. Architecture of `interlock` 0.5.0
|
|
@@ -1203,6 +1233,11 @@ written; **partial** says what is missing; **unimplemented** is stated plainly.
|
|
|
1203
1233
|
| E4-3: the undo written down before the do | Implemented | The compensation is part of the request, hashed into the plan at admission and committed in its outbox row | `test_outbound`, `test_operators` |
|
|
1204
1234
|
| E4-4: compensations in reverse topological order | Implemented | `Operator.compensate` | `test_operators` |
|
|
1205
1235
|
| E4-5: a stale compensation is a decision | Implemented | Past its original's deadline, only with `late=True`, signed | `test_operators` |
|
|
1236
|
+
| E4-6: measured by the system's own planner; the unmeasurable never stages | Implemented (1.3.0) | `KubernetesSubstrate` (`?dryRun=All`; a side-effecting webhook refuses the stage), `TerraformSubstrate` (`plan -out`, `show -json`; `UnknownValue`, `TruncationGuard(acknowledged_unknown=)`) | `test_kubernetes`, `test_terraform` |
|
|
1237
|
+
| E4-7: applied as measured, on the state measured | Implemented (1.3.0) | `resourceVersion` on every write (`409` fails closed), a landing checked against its measure; the state's serial and lineage checked, the saved plan applied, a stale plan a conflict | `test_kubernetes`, `test_terraform` |
|
|
1238
|
+
| E4-8: the undo written down first; a partial apply put back | Implemented (1.3.0) | `planbound.UndoJournal`, `; undo <sha256>` in `COMMIT_INTENT`, `CompensatedError`, `RecordType.COMPENSATED` | `test_kubernetes`, `test_terraform` |
|
|
1239
|
+
| E4-9: a marker on every object, read by recovery | Implemented (1.3.0) | `interlock.io/stage-id`; the `interlock_stage_id` output; `resolve_intent`, `compensated` | `test_kubernetes`, `test_terraform` |
|
|
1240
|
+
| E4-10: plan-bound receipts | Implemented (1.3.0) | `SubstrateCapabilities(measurement="plan-bound", plan_bound=True)` | `test_kubernetes` |
|
|
1206
1241
|
|
|
1207
1242
|
## Beyond sections 1 to 4
|
|
1208
1243
|
|
|
@@ -1226,6 +1261,9 @@ written; **partial** says what is missing; **unimplemented** is stated plainly.
|
|
|
1226
1261
|
| No sensitive value in a hash: canaries through the daemon on both stores, every hash input recorded, every column crawled | `scripts/security_audit.py` | `test_security_audit` |
|
|
1227
1262
|
| Several daemons on one database (PostgreSQL): a node's lock held for its life and refused to a second process; one node leading each role at a time; a node gone losing its locks, its roles and its leases as the database ends its session, and its other sessions as the nodes that survive fence it; each node settling its own plans; every session that holds what others wait for bounded; recovery waiting out a predecessor's transactions | `cluster`, `supervisor`, `daemon`, `outbox_sql`, `settlement`, `wiring` | `test_cluster`, `test_takeover`, `test_cluster_daemon`, `test_settlement`, `test_inbox`, `test_engine`, the soak (a node killed, a node frozen) |
|
|
1228
1263
|
| Checked repair, refusal feedback, budgeted recovery, extension quotes | `repair`, `feedback`, `recovery`, `extension` | `test_repair`, `test_feedback`, `test_recovery`, `test_extension` |
|
|
1264
|
+
| Sensor facts (1.3.0): analyzers sign facts bound to the measured diff's hash; a pure checker requires a clean one under a pinned key | `sensors` | `test_sensors` |
|
|
1265
|
+
| Pinned checker packs (1.3.0): a pack's code loaded only as pinned by module, version and digest | `checker_packs` | `test_checker_packs` |
|
|
1266
|
+
| Loopback stand-ins (1.3.0): a Kubernetes API server with admission webhooks and an audit log; a `terraform` command | `sim.kubernetes`, `sim.terraform` | `test_kubernetes`, `test_terraform` |
|
|
1229
1267
|
|
|
1230
1268
|
## Partial
|
|
1231
1269
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "interlock-escrow"
|
|
3
|
-
version = "1.
|
|
3
|
+
version = "1.3.0"
|
|
4
4
|
description = "A reference monitor for agent side effects: stage, measure, adjudicate, commit."
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
requires-python = ">=3.11"
|
|
@@ -94,12 +94,18 @@ ignore = ["S101"]
|
|
|
94
94
|
# secrets they make up, which name nothing real (S105, S106).
|
|
95
95
|
"tests/**/*.py" = ["S101", "S105", "S106", "S608"]
|
|
96
96
|
"tests/test_git_substrate.py" = ["S101", "S105", "S106", "S603", "S607", "S608"]
|
|
97
|
+
# The plan-bound substrates' tests run the stand-in commands and call the
|
|
98
|
+
# loopback API server they start themselves (1.3.0).
|
|
99
|
+
"tests/test_terraform.py" = ["S101", "S105", "S106", "S603", "S607", "S608"]
|
|
100
|
+
"tests/test_kubernetes.py" = ["S101", "S105", "S106", "S310", "S608"]
|
|
97
101
|
# The capture triggers interpolate table and column names because SQL has no
|
|
98
102
|
# parameter binding for identifiers in DDL. Every identifier is validated by
|
|
99
103
|
# substrate._assert_identifier at TableSpec construction and comes from
|
|
100
104
|
# operator configuration, never from the agent.
|
|
101
105
|
"src/interlock/substrate.py" = ["S608"]
|
|
102
106
|
"src/interlock/git_substrate.py" = ["S608"]
|
|
107
|
+
# A control stage's redo: its own module-constant table names, every value bound.
|
|
108
|
+
"src/interlock/control.py" = ["S608"]
|
|
103
109
|
# The same, for the PostgreSQL install DDL and catalog queries: identifiers are
|
|
104
110
|
# validated TableSpec names, and the rest is constant SQL joined together.
|
|
105
111
|
"src/interlock/postgres.py" = ["S608"]
|
|
@@ -50,6 +50,7 @@ from interlock.anchor import AnchorPoint, LedgerAnchor
|
|
|
50
50
|
from interlock.builder import PlanBuilder, new_effect_id, new_plan_id
|
|
51
51
|
from interlock.cascade import CascadeReport
|
|
52
52
|
from interlock.chain import EscrowChain, EscrowRecord, RecordType
|
|
53
|
+
from interlock.checker_packs import CheckerPack, CheckerPackError, PackPin, load_pack, pack_digest
|
|
53
54
|
from interlock.daemon import Application, build_supervisor, load_application
|
|
54
55
|
from interlock.deliveries import verify_delivery_log
|
|
55
56
|
from interlock.engine import EscrowEngine, StageResult
|
|
@@ -60,6 +61,7 @@ from interlock.exceptions import (
|
|
|
60
61
|
ChainInUseError,
|
|
61
62
|
CommitUnsettledError,
|
|
62
63
|
CompactionRefusedError,
|
|
64
|
+
CompensatedError,
|
|
63
65
|
CyclicPlanError,
|
|
64
66
|
ExtensionError,
|
|
65
67
|
ForbiddenStatementError,
|
|
@@ -116,6 +118,7 @@ from interlock.invariants import (
|
|
|
116
118
|
TruncationGuard,
|
|
117
119
|
default_checkers,
|
|
118
120
|
)
|
|
121
|
+
from interlock.kubernetes import KubeKind, KubernetesSubstrate
|
|
119
122
|
from interlock.mcp import McpAdapter, StdioServer, mcp_sink
|
|
120
123
|
from interlock.meters import Meter, MeterCheck
|
|
121
124
|
from interlock.outbound import OperationSpec, SinkRegistry, SinkSpec, register_sink_kind
|
|
@@ -151,6 +154,7 @@ from interlock.relay import (
|
|
|
151
154
|
)
|
|
152
155
|
from interlock.repair import DroppedEffect, Repair, RepairFeedback
|
|
153
156
|
from interlock.runtime import EscrowRuntime
|
|
157
|
+
from interlock.sensors import CommandSensor, FunctionSensor, SensorAttestation, sign_fact
|
|
154
158
|
from interlock.settlement import SettlementReport, Settler, verify_settlements
|
|
155
159
|
from interlock.signers import AwsKmsSigner, HttpRemoteSigner, RemoteSigner
|
|
156
160
|
from interlock.substrate import ShadowSubstrate, SqliteSubstrate, TableSpec
|
|
@@ -167,6 +171,7 @@ from interlock.supervisor import (
|
|
|
167
171
|
VacuumService,
|
|
168
172
|
)
|
|
169
173
|
from interlock.telemetry import Metrics
|
|
174
|
+
from interlock.terraform import TerraformSubstrate, TfResource
|
|
170
175
|
from interlock.trace import child_traceparent, new_traceparent, parse_traceparent
|
|
171
176
|
from interlock.types import (
|
|
172
177
|
Compensation,
|
|
@@ -180,8 +185,10 @@ from interlock.types import (
|
|
|
180
185
|
OutboundRequest,
|
|
181
186
|
PlanId,
|
|
182
187
|
RowDelta,
|
|
188
|
+
SensorFact,
|
|
183
189
|
Severity,
|
|
184
190
|
StageState,
|
|
191
|
+
UnknownValue,
|
|
185
192
|
Verdict,
|
|
186
193
|
WindowMeasure,
|
|
187
194
|
)
|
|
@@ -195,7 +202,7 @@ from interlock.windows import (
|
|
|
195
202
|
RowSum,
|
|
196
203
|
)
|
|
197
204
|
|
|
198
|
-
__version__ = "1.
|
|
205
|
+
__version__ = "1.3.0"
|
|
199
206
|
|
|
200
207
|
__all__ = [
|
|
201
208
|
"AdmissionError",
|
|
@@ -211,9 +218,13 @@ __all__ = [
|
|
|
211
218
|
"ChainInUseError",
|
|
212
219
|
"ChainIntegrityError",
|
|
213
220
|
"Channel",
|
|
221
|
+
"CheckerPack",
|
|
222
|
+
"CheckerPackError",
|
|
214
223
|
"ColumnValueGuard",
|
|
224
|
+
"CommandSensor",
|
|
215
225
|
"CommitUnsettledError",
|
|
216
226
|
"CompactionRefusedError",
|
|
227
|
+
"CompensatedError",
|
|
217
228
|
"Compensation",
|
|
218
229
|
"ConstraintFeedback",
|
|
219
230
|
"CrossEffectAgreement",
|
|
@@ -238,6 +249,7 @@ __all__ = [
|
|
|
238
249
|
"ExtensionRequest",
|
|
239
250
|
"FactAgreement",
|
|
240
251
|
"ForbiddenStatementError",
|
|
252
|
+
"FunctionSensor",
|
|
241
253
|
"HttpAdapter",
|
|
242
254
|
"HttpRemoteSigner",
|
|
243
255
|
"InboundFact",
|
|
@@ -250,6 +262,8 @@ __all__ = [
|
|
|
250
262
|
"InterlockSupervisor",
|
|
251
263
|
"InvariantChecker",
|
|
252
264
|
"InvariantViolation",
|
|
265
|
+
"KubeKind",
|
|
266
|
+
"KubernetesSubstrate",
|
|
253
267
|
"LedgerAnchor",
|
|
254
268
|
"LedgerBreaker",
|
|
255
269
|
"LedgerUnverifiedError",
|
|
@@ -269,6 +283,7 @@ __all__ = [
|
|
|
269
283
|
"OutboundRequest",
|
|
270
284
|
"OutboundRequestError",
|
|
271
285
|
"OutboundTenantIsolation",
|
|
286
|
+
"PackPin",
|
|
272
287
|
"PayloadAmountCap",
|
|
273
288
|
"PlanBuilder",
|
|
274
289
|
"PlanError",
|
|
@@ -303,6 +318,8 @@ __all__ = [
|
|
|
303
318
|
"RowSum",
|
|
304
319
|
"Rung",
|
|
305
320
|
"ScopeHaltedError",
|
|
321
|
+
"SensorAttestation",
|
|
322
|
+
"SensorFact",
|
|
306
323
|
"Service",
|
|
307
324
|
"ServiceStatus",
|
|
308
325
|
"SettlementReport",
|
|
@@ -331,11 +348,14 @@ __all__ = [
|
|
|
331
348
|
"TableSpec",
|
|
332
349
|
"TenantDrawdownGuard",
|
|
333
350
|
"TenantIsolation",
|
|
351
|
+
"TerraformSubstrate",
|
|
352
|
+
"TfResource",
|
|
334
353
|
"ToolRevokedError",
|
|
335
354
|
"Trip",
|
|
336
355
|
"TripKind",
|
|
337
356
|
"TruncationGuard",
|
|
338
357
|
"UncompensatableEffectError",
|
|
358
|
+
"UnknownValue",
|
|
339
359
|
"Vacuum",
|
|
340
360
|
"VacuumReport",
|
|
341
361
|
"VacuumService",
|
|
@@ -347,14 +367,17 @@ __all__ = [
|
|
|
347
367
|
"child_traceparent",
|
|
348
368
|
"default_checkers",
|
|
349
369
|
"load_application",
|
|
370
|
+
"load_pack",
|
|
350
371
|
"mcp_sink",
|
|
351
372
|
"new_effect_id",
|
|
352
373
|
"new_plan_id",
|
|
353
374
|
"new_traceparent",
|
|
375
|
+
"pack_digest",
|
|
354
376
|
"parse_traceparent",
|
|
355
377
|
"register_sink_kind",
|
|
356
378
|
"register_source_kind",
|
|
357
379
|
"retry_delay",
|
|
380
|
+
"sign_fact",
|
|
358
381
|
"verify_archive",
|
|
359
382
|
"verify_delivery_log",
|
|
360
383
|
"verify_fact",
|