Capability Map¶
bijux-canon-runtime turns lower-layer outputs into governed runs by applying
manifest authority, execution policy, verification arbitration, causal
recording, persistence, and replay acceptance. Its capabilities concern who
may do what under which retained evidence.
flowchart LR
manifest["manifest + tenant + policy"]
resolve["dataset + dependencies + plan"]
execute["mode-specific execution"]
verify["verification + arbitration"]
freeze["finalized causal trace"]
persist["DuckDB + artifact payloads"]
replay["verdict + semantic diff"]
manifest --> resolve --> execute --> verify --> freeze --> persist --> replay
Authority and execution capabilities¶
| Capability | Owning area | Produced evidence |
|---|---|---|
| Manifest authority | contracts/, model/flows/ |
flow, tenant, agents, dependencies, gates, determinism, replay policy |
| Dataset admission | dataset contracts and planning | exact descriptor, deprecation decision, dataset identity |
| Dependency resolution | application planner | normalized ordered steps and immutable plan hash |
| Environment capture | observability capture and classification | environment, package, resolver, and policy fingerprints |
| Mode selection | preparation and execution policy | plan, dry-run, live, observe, or unsafe semantics |
| Authority-bearing context | runtime/context.py, core/authority.py |
permitted effects, tenant, budgets, store identity |
| Lower-layer execution | step, retrieval, reasoning, and agent executors | correlated outputs, errors, evidence, claims, tool calls |
| Budget enforcement | runtime budget and entropy models | resource and entropy use, exhaustion, refusal or warning |
Verification, persistence, and replay capabilities¶
| Capability | Owning area | Produced evidence |
|---|---|---|
| Causal recording | trace recorder and event causality | ordered events, hashes, causal tags, checkpoints |
| Verification | verifier orchestration and rules | per-engine findings, violated rules, targets, costs |
| Arbitration | verification arbitration | policy fingerprint, participating engines, final decision |
| Trace finalization | execution lifecycle finalizer | immutable trace, certifiability, termination state |
| Incremental persistence | migration-owned DuckDB store | runs, steps, events, tools, artifacts, evidence, claims, entropy |
| Resume | lifecycle preparation and state tracker | restored indices and state after the last completed checkpoint |
| Artifact lineage | artifact contracts and store | immutable identity, hash, producer, parentage, tenant, scope |
| Replay analysis | replay support and observability analysis | envelope comparison, semantic diff, acceptability verdict |
| Drift analysis | correlation, invariants, comparative analysis | earliest structural, temporal, dataset, policy, or content divergence |
Mode capability boundary¶
Plan mode resolves authority without allocating a run. Dry run exercises the recording and persistence path with simulated effects. Live mode requires verification coverage. Observe mode governs evidence supplied by an external execution. Unsafe mode records reduced guarantees and remains distinguishable from live authority.
| Mode | May invoke configured effects | Required authority/evidence | Claim supported |
|---|---|---|---|
| plan | no | valid manifest, dataset, policy declarations and dependency resolution | an immutable plan can be resolved; no run or effect claim |
| dry-run | simulated only | execution store plus declared simulation behavior | recording/persistence path under simulation, not live integrations |
| observe | no control over host effects | host-supplied events plus applicable verification policy | governance of the events actually supplied, not omitted activity |
| live | yes, through configured integrations | store, policy, budgets, adapter authority, effect receipts and verification | governed execution for the recorded integrations and rules |
| unsafe | effects under explicitly reduced guarantees | store and visible relaxed-policy declaration | retained execution evidence that is not equivalent to governed live work |
Mode is part of the result identity. A successful plan cannot be promoted to a run, a dry-run trace cannot certify live permissions, and an unsafe result cannot be relabelled after execution.
Composition capability is currently bounded¶
Runtime contains planning, execution, verification, persistence, recovery and replay machinery, but capability also depends on the callable integration seam:
| Composition | Current status | Evidence-backed interpretation |
|---|---|---|
| manifest admission and plan resolution | implemented | can be exercised without lower-package live calls |
| runtime behavior with injected executor seams | implemented and package-tested | establishes runtime authority, failure, verification and replay semantics |
| canonical package-root live composition | not currently demonstrated | required retrieve, enforce_contract, reason and run callables are not all exported by canonical roots |
| HTTP flow run and replay | contract validation with 501 response |
versioned schema/error compatibility, not remote execution |
The compatibility packages delegate to the same canonical roots and therefore do not supply missing adapters. A supported end-to-end live claim requires explicit typed adapters and an installed-package test that resolves and executes them without substituting seam-specific callables.
Interface availability¶
Python and CLI provide governed execution and read-side inspection. HTTP
provides implemented liveness and storage readiness; versioned flow run and
replay requests validate contracts but currently return 501 Not Implemented.
Schema presence is compatibility evidence, not remote execution capability.
Runtime cannot undo external effects, reconstruct omitted host events, or make a passing verification rule set equivalent to factual truth. See Invariants for authority laws and Known limitations for execution, determinism, verification, persistence, and deployment boundaries.