Contextfulv0.23.0

Docs / Specification

contract assurance · 80-formal.md · 81-engineering.md · 82-consumer.md · 83-gate.md · guide · card

Assurance — card

Generated by contextful-spec state from the contract’s files and spec/terms/assurance.toml; not authored.

Operations

OperationCoversClausesProved
modelThe Lean policy package and the Lean protocol state machine, their pins, and the definitions theorems and checks range over.270
proveThe theorem inventory: layer composition, placement, the evidence floor, the proof targets over the authority mapping, and the mediation relation over statement execution.211
audit-assumptionsThe assumption allowlist, the transitive footprint audit over the elaborated environment, the inventory and the report.140
recheckRebuilding and re-auditing from pinned source in a credential-free environment.40
scope-claimThe sentence the assurance claim is allowed to be: named decisions, named specifications and trusted dependencies.40
differential-testThe executable reference models, the case generators, the minimized counterexample corpus and the command running them.270
structure-treeOne home per capability, the one enforcement decision module, adapters, mirror annotations and derived-artifact checks.100
testAssertion construction, guard validation, suite placement, test-first and acceptance tests, and the connector test kit.160
buildTarget directories, the engine-linked invocation, linked query functions, build targets, release artifacts and the dependency allowlist.220
evaluateThe read-path quality harness: case format, deterministic metrics and floors, judged dimensions, the reader and the judge.400
baselineHolding a run against committed baselines and absolute floors, intervals, golden custody and case generation.270
backtestHistorical evaluations, called backtests: bounded cases, model-knowledge controls, label intervals and splits, execution metadata, planted leaks and replayable trajectories. Financial return-series and execution profiles are consumer-selected applications of this flow (domain-neutral).210
forecastProbability forecasts over consumer-declared outcomes: freeze instant, settlement, lead time, imputation, coverage, reference baselines and separate scoring tracks. Reference baselines belong to an explicitly selected profile (domain-neutral).90
consumerArtifact compatibility: source-independent execution, required capabilities, scenario evidence, storage profiles and release distribution.190
automateTyped subcommands over compiled binaries, and the boundary shell keeps.60
gateStage order, secrets of record, the crate-graph, row-token, egress and dependency rules, the formal stage, build jobs, free disk, footprint budgets and surface checks.440
measureThe target ledger: each tracked target, the clause it serves, how it is measured and its record per commit.200
releaseThe release tag’s version, the refusals guarding it, the signed annotated tag contextful-ci tag creates, and the local packaging the operator runs from it.120
deploy-appsThe one GitHub Actions workflow, its trigger, permission and credential shape, and contextful-ci deploy cloudflare, the command it and an operator run to ship one Cloudflare app.150

Error cases

ErrorWhenClause
FormalPackageDependencyThe Lean package manifest declares an external library.assurance.model.declared-dependency
ProofToolchainDriftThe resolved toolchain release string differs from the pinned one.assurance.model.toolchain-drift
UnmodelledConstructorA placement category the manifest admits has no case in the model’s inductive.assurance.model.unmodelled-constructor
ProtocolInvariantViolatedA state the bounded check reaches breaks a protocol invariant.assurance.model.protocol-check
JournalInvariantViolatedA state the journal check reaches breaks a journal property.assurance.model.journal-check
CommutationClaimedOrder-independence asserted over stages whose order the composition theorem fixes.assurance.prove.commutation-claim
ZoneInclusionSampledInclusion decided by evaluating a fixed set of example values.assurance.prove.sampled-inclusion
ProofTargetUnboundA proof target named in the claim with no authenticated query path bound to it.assurance.prove.unbound-target
TheoremWithoutNegativeSpaceA theorem published with no statement of what it leaves open.assurance.prove.no-negative-space
MediationClaimedFromCompositionA filter-composition theorem offered as a mediation theorem.assurance.prove.mediation-from-composition
AssumptionOutsideAllowlistA constant’s footprint reaches an assumption absent from the allowlist.assurance.audit-assumptions.assumption-outside-allowlist
ProofHoleAssumptionA footprint contains the hole assumption.assurance.audit-assumptions.hole-assumption
NativeEvaluationAssumptionA footprint contains a per-declaration native-evaluation assumption.assurance.audit-assumptions.native-evaluation-assumption
TheoremConstantMissingA required constant is absent from the elaborated environment.assurance.audit-assumptions.missing-constant
TheoremStatementDriftA required constant’s elaborated statement differs from its expected text.assurance.audit-assumptions.statement-drift
RecheckEnvironmentCredentialedThe recheck environment exposes a credential.assurance.recheck.credential-free
RecheckReportMismatchThe recheck’s per-constant statement or assumption set differs from the first phase’s.assurance.recheck.report-mismatch
ClaimBeyondNamedDecisionsThe assurance claim asserts an object wider than its named decisions.assurance.scope-claim.beyond-named-decisions
TrustedDependencyUnnamedThe claim rests on a component absent from its trusted-dependency list.assurance.scope-claim.unnamed-dependency
ReferenceVocabularyDriftThe reference binary and the harness list different operations.assurance.differential-test.reference-vocabulary
ReferenceModelDriftThe reference model and the engine’s decision function disagree on a case.assurance.differential-test.disagreement
CounterexampleDiscardedA run reported a disagreement and wrote no corpus entry.assurance.differential-test.discarded-counterexample
ProtocolConformanceDriftThe protocol model and the Rust store disagree on the state after a step.assurance.differential-test.protocol-drift
ProtocolVocabularyDriftThe protocol model and the harness list different step kinds.assurance.differential-test.protocol-vocabulary
JournalConformanceDriftThe journal model and a journal adapter disagree on the state after a step.assurance.differential-test.journal-drift
MergeConformanceDriftThe merge model and the store’s merge disagree on a key’s outcome.assurance.differential-test.merge-drift
CapabilityDuplicatedA second implementation of an engine capability, or a hand-written copy of an engine constant.assurance.structure-tree.duplicated-capability
CapabilityHomeUnresolvedA capability registry entry resolving to no home or symbol in the tree.assurance.structure-tree.capability-registry
BoundConstantDriftA bound constant whose value differs from its registry entry, or that its named file does not define.assurance.structure-tree.bound-constant
MirrorUnresolvedA mirrors annotation naming no clause of the lock file.assurance.structure-tree.mirror-unresolved
VacuousAssertionAn exclusion assertion evaluated over an empty collection.assurance.test.vacuous-exclusion
TestNotFirstA source change carrying no test that fails against the base commit’s source.assurance.test.test-first
TestFirstBaseUnrunnableA test-first run at base stopped by the machine or the base workspace, not by the tests.assurance.test.base-unrunnable
AcceptanceLinksEngineThe acceptance package depending on a workspace package.assurance.test.acceptance-surface
ExtensionAutoloadRefusedA read path loading a query-engine extension into a statically linked binary.assurance.build.runtime-extension-load
ImageBinaryMismatchA release image binary of another ELF machine than its target, or naming a dynamic interpreter.assurance.build.image-binary-mismatch
PackageLicenceMissingA workspace package whose manifest declares no licence, or one other than Apache-2.0.assurance.build.licence-field
DependencyAllowlistViolationA profile graph reaching a backtracking regular-expression engine or a parser with its depth limit off.assurance.build.dependency-allowlist
EvalCorpusUnlabeledAn evaluation corpus with no policy labels and no explicit local zone.assurance.evaluate.unlabeled-corpus
EvalSemanticCacheUnverifiedA semantic cache input changed, unhashed, symbolically linked, or a second table.assurance.evaluate.semantic-cache
EvalSemanticInputRejectedA semantic vector, held-out file, development split or configuration that fails verification.assurance.evaluate.semantic-inputs
BaselinePathUnresolvedA baseline entry naming no report field, under-sampled, or malformed.assurance.baseline.unresolvable-path
BaselineRunStampMismatchA baseline run block differing from the run’s configuration.assurance.baseline.run-stamp-drift
GoldenSetIngestedA golden set reaching the store it measures.assurance.baseline.answer-key-in-the-store
GoldenRedactionFailedA generated golden the write-time redaction pass cannot clear.assurance.baseline.generated-redaction
PublicCorpusDigestMismatchFetched public benchmark bytes whose SHA-256 digest differs from the fetch manifest’s.assurance.baseline.public-corpora
TraceExportOutOfPerimeterA hosted trace endpoint configured for a run touching a deployed store.assurance.baseline.trace-export
EvalLabelIntervalMissingA bounded case declaring no label interval.assurance.backtest.label-interval
EvalExecutionUndeclaredA backtest report stamping no declared execution component.assurance.backtest.execution-component
EvalCaseResolvedBeforeFreezeA backtest forecast case resolved before its freeze instant.assurance.forecast.resolved-before-freeze
ConformanceAlreadyRunningAnother suite holds a live admission lease on the bound D1 database.assurance.consumer.d1-admission
ConformanceBindingAbsentA native full release cell holds no D1 binding, so its cloudflare-d1 pass does not run.assurance.consumer.d1-absent
ShellCheckFailedA shell file in the tree that the shell linter rejects.assurance.automate.unchecked-shell
StagePredecessorMissingA selected stage reading an unselected predecessor’s absent output.assurance.gate.stage-subset
SecretPlaintextA tracked dotenv key holding a value other than dotenvx ciphertext, or a tracked private-key file.assurance.gate.secret-ciphertext
SecretScopeMissingA tracked dotenv key with no comment above it stating what it grants.assurance.gate.secret-scope
SurfaceCheckFailedA TypeScript surface whose typecheck, unit tests or framework build failed.assurance.gate.surface-check-failed
CrateGraphViolationA run-path crate reaching a read-path crate outside the three crossing crates.assurance.gate.crate-graph
EnforceUnmediatedPathA row-returning path reaching stored rows outside a registered relation.assurance.gate.row-token
DenyListDriftA deny.toml entry missing for, or absent from, the profile-wide dependency refusals.assurance.gate.deny-list
UnconfiguredEgressAn outbound call a default configuration reaches without operator configuration.assurance.gate.unconfigured-egress
EnforceInterpolatedSubjectClaimA subject claim formatted into SQL text in a runtime crate.assurance.gate.interpolated-claim
BuildDiskPreconditionA gate stage beginning below the free-disk floor.assurance.gate.free-disk
FootprintBudgetExceededA profile artifact over its budget, or carrying an extra dynamic dependency.assurance.gate.footprint-exceeded
MeasureEntryUnresolvedA ledger entry naming no clause, method or metric path.assurance.measure.unresolved-entry
MeasureRecordMissingA gate-tier method finishing without writing its record.assurance.measure.record
MeasureSeedMismatchA record carrying another seed than its ledger entry declares.assurance.measure.seed-mismatch
MeasureThresholdLoosenedA gate-tier target loosened since the base revision without a new cost note.assurance.measure.threshold-cost
TagStoreFormatUnreadA store format constant whose major or minor does not parse as an integer.assurance.release.store-format
TagManifestFormatUnreadA bucket manifest format constant that does not parse as an integer.assurance.release.manifest-format
TagTreeDirtyA tag requested over a working tree or index differing from HEAD.assurance.release.dirty-tree
TagOffDefaultBranchA tag requested on a commit the default branch does not reach.assurance.release.off-branch
TagVersionRegressedA computed version below the highest existing version tag.assurance.release.version-regressed
TagFormatBreakPatchA store format major change under the highest existing tag’s minor version.assurance.release.format-break-patch
TagWorkspaceVersionMismatchA workspace package version absent or differing from the computed tag version.assurance.release.workspace-version
TagGateFailedA gate stage failing on the commit a tag names.assurance.release.gate-failed
ReleaseTagVersionMismatchA release build over a version tag that differs from the workspace package version.assurance.release.release-tag-version
DeployWorkflowRefusedA workflow file other than the deploy workflow, or a deploy workflow outside its fixed shape.assurance.deploy-apps.workflow-refused
DeployCredentialsAbsentA deploy started without the Cloudflare API token or account identifier in its environment.assurance.deploy-apps.credentials-absent
DeployUnhealthyA deployed app answering outside its expected status set, or not at all.assurance.deploy-apps.health

Bounds

BoundValueBasisClause
assurance-formal-build-artifacts2048 KiBchosenassurance.model.build-cost
assurance-formal-build-time60 schosenassurance.model.build-cost
assurance-assumption-allowlist2 entrieschosenassurance.audit-assumptions.allowlist
assurance-recheck-wall-time600 schosenassurance.recheck.wall-time
assurance-counterexample-corpus256 entrieschosenassurance.differential-test.corpus-entries
assurance-differential-budget300 schosenassurance.differential-test.run-budget
assurance-test-first-base-run300 schosenassurance.test.base-run-bound
assurance-precision-floor60 percentchosenassurance.evaluate.precision-floor
assurance-forbidden-row-rate0 percentchosenassurance.evaluate.forbidden-row-rate
assurance-duplicate-row-rate0 percentchosenassurance.evaluate.duplicate-row-rate
assurance-in-window-rate95 percentchosenassurance.evaluate.in-window-rate
assurance-default-dead-band2 percentchosenassurance.baseline.default-dead-band
assurance-rank-dead-band3 percentchosenassurance.baseline.rank-quality-dead-band
assurance-gated-mean-cases30 caseschosenassurance.baseline.unresolvable-path
assurance-bootstrap-resamples1000 resampleschosenassurance.baseline.interval
assurance-interval-level95 percentchosenassurance.baseline.interval
assurance-forecast-coverage95 percentchosenassurance.forecast.coverage-floor
assurance-d1-admission-lease120 schosenassurance.consumer.d1-admission
assurance-shell-lines5 lineschosenassurance.automate.typed-subcommand
assurance-cli-shard-wall-clock9 minchosenassurance.gate.cli-shard-map
assurance-job-memory3 GiBchosenassurance.gate.parallel-jobs
assurance-stage-free-disk2 GiBchosenassurance.gate.free-disk
assurance-edge-compressed50 MiBchosenassurance.gate.edge-budget
assurance-full-compressed150 MiBchosenassurance.gate.full-budget
assurance-control-compressed60 MiBchosenassurance.gate.control-budget
assurance-timing-iterations200 repeatschosenassurance.measure.timing-iterations
assurance-timing-batches5 repeatschosenassurance.measure.timing-batches
assurance-trend-band25 percentchosenassurance.measure.trend-band
assurance-deploy-job-timeout90 minchosenassurance.deploy-apps.job-timeout
assurance-deploy-builder-job-memory1536 MiBchosenassurance.deploy-apps.builder-jobs

Decisions

SectionCited by
A-assurance#assurance-claims-carryassurance.prove.commutation-claim, assurance.prove.sampled-inclusion, assurance.prove.unbound-target, assurance.prove.no-negative-space, assurance.audit-assumptions.assumption-outside-allowlist, assurance.audit-assumptions.hole-assumption, assurance.audit-assumptions.native-evaluation-assumption, assurance.audit-assumptions.missing-constant, assurance.audit-assumptions.statement-drift, assurance.audit-assumptions.allowlist-admission, assurance.recheck.credential-free, assurance.scope-claim.beyond-named-decisions, assurance.scope-claim.unnamed-dependency
A-assurance#backtests-estimate-leakageassurance.backtest.cutoff-slice, assurance.backtest.fill-instant, assurance.backtest.execution-component, assurance.forecast.tracks-separate
A-assurance#case-s-judgeassurance.backtest.cutoff-slice, assurance.backtest.leak-score
A-assurance#columnar-read-statementassurance.build.linked-query-functions, assurance.build.runtime-extension-load
A-assurance#consumer-compatibility-bindsassurance.consumer.suite, assurance.consumer.requirements, assurance.consumer.d1-profile, assurance.consumer.d1-release
A-assurance#decision-module-compilesassurance.differential-test.harness, assurance.differential-test.builds, assurance.differential-test.disagreement, assurance.structure-tree.decision-module
A-assurance#differentially-tested-referenceassurance.differential-test.discarded-counterexample
A-assurance#duplicated-capabilities-matchassurance.structure-tree.capability-registry, assurance.structure-tree.cross-language
A-assurance#edge-profile-shipsassurance.build.wasi-probe, assurance.build.release-artifact
A-assurance#evaluation-data-followsassurance.evaluate.policy-labels, assurance.evaluate.unlabeled-corpus, assurance.baseline.golden-custody, assurance.baseline.answer-key-in-the-store, assurance.baseline.generated-redaction, assurance.baseline.trace-export
A-assurance#executed-reference-provedassurance.differential-test.reference-model
A-assurance#feature-runs-formalassurance.gate.nightly-tier
A-assurance#gate-repair-evidenceassurance.test.base-evidence, assurance.build.checkout-artifacts, assurance.build.runtime-checkout
A-assurance#generated-artifacts-provecorpus.render.generated, assurance.structure-tree.derivation-check
A-assurance#mediation-ranges-overassurance.prove.restriction-preservation, assurance.prove.mediation-relation
A-assurance#model-specifies-profileassurance.model.declared-dependency, assurance.model.unmodelled-constructor
A-assurance#profile-graphs-answerassurance.gate.dependency-deny, assurance.gate.deny-profile-graph
A-assurance#protocol-package-holdsassurance.model.journal-model, assurance.model.merge-model, assurance.model.fold-model, assurance.differential-test.journal-harness, assurance.differential-test.journal-drift, assurance.differential-test.merge-drift, assurance.differential-test.fold-harness
A-assurance#pull-request-runsassurance.gate.affected-parts, assurance.gate.affected-every, assurance.gate.affected-spec, assurance.gate.affected-surfaces, assurance.gate.affected-formal
A-assurance#source-change-carriescorpus.state.theorem-beside-test, corpus.state.acceptance, corpus.state.acceptance-first, assurance.test.test-first, assurance.test.acceptance-surface
A-assurance#stage-subset-runsassurance.gate.stage-sequence, assurance.gate.stage-subset
A-assurance#store-format-majorassurance.release.version, assurance.release.store-format, assurance.release.manifest-format, assurance.release.version-regressed, assurance.release.format-break-patch
A-assurance#store-protocol-modelledassurance.model.package, assurance.model.toolchain-drift, assurance.model.protocol-package, assurance.model.protocol-model, assurance.model.protocol-safety, assurance.differential-test.protocol-harness, assurance.differential-test.protocol-drift
A-assurance#tracked-targets-gateassurance.measure.trend-direction, assurance.measure.trend-baseline, assurance.measure.history
A-assurance#version-tag-namesassurance.release.annotated, assurance.release.off-branch, assurance.release.workspace-version, assurance.release.gate-failed
A-assurance#windows-release-supportassurance.build.targets, assurance.build.windows-target
A-assurance#workspace-fits-stageassurance.gate.workspace-parts, assurance.gate.cli-shard-map