Crate ci_engine 

Local CI check executor harvested from HeddleCo/treadle.

Structs

AttemptRecord

Operational record for one flake-retry attempt.

CacheKey

Addresses a cached check result.

CheckResult

One check’s verdict body and operational sidecars.

CommandOutcome

Captured outcome of one external runtime command.

DockerProvider

Docker-CLI provider. Local CLI does not select this automatically.

ExecutionContext

Facts about the exact state/tree being evaluated.

FakeProvider

A recording command runner with configurable docker run failure.

FsResultCache

Directory-backed cache. Entries are JSON files named by the entry digest.

HermeticEnv

Builder for the exact environment both executed and recorded in repro.

MemoryResultCache

Process-local cache used by tests and as a seed/hit fixture.

NoopProvider

Provider for local mode: no implicit container runtime.

PreparedCaches

Prepared cache slots for one check.

ProcGroupRegistry

Concurrency-safe set of process-group ids.

RealCommandRunner

Real external-command boundary used by DockerProvider.

ResultCacheEntry

A portable cached check result, bound to env, inputs, and check identity.

RunControls

Additive execution controls.

RunOptions

Stable options for an executor invocation.

RunningServices

Provider handles for services started for one check.

SpotCheckDivergence

Details of a fail-closed spot-check disagreement.

Enums

Disposition

Terminal process disposition before output classification.

ResultCacheError

Errors from cache I/O or a fail-closed spot-check disagreement.

ServiceError

Service provisioning failure.

SpotCheck

Policy for re-running a sampled fraction of cache hits.

Constants

BASE_ALLOWLIST

Host variables needed to locate ordinary POSIX/Rust tooling.

CACHE_ENV_PREFIX

Prefix for every cache-directory environment variable.

EXCERPT_CAP_BYTES

Maximum bytes stored in a verdict failure excerpt.

GIT_IDENTITY_EMAIL

Deterministic Git author/committer email.

GIT_IDENTITY_NAME

Deterministic Git author/committer name.

RESULT_CACHE_SCHEMA_VERSION

Schema version of ResultCacheEntry. Bump when the bytes change.

Traits

CommandRunner

Boundary around external container-runtime commands.

ResultCache

Lookup and seed a content-addressed result cache.

ServiceProvider

Service lifecycle provider used by the executor.

Functions

classify

Classify a process result. Disposition always wins over captured text.

evidence_digest

Domain-separated BLAKE3 of captured check output.

extract_excerpt

Extract the last causal-looking region and cap it without splitting UTF-8.

prepare_caches

Create declared cache slots under cache_root. A failed cache creation degrades to a cold build.

run_checks

Run every check with default controls.

run_checks_with

Run checks with explicit trigger/cache/environment controls.

strip_ansi

Remove CSI, OSC, two-byte escape sequences, and stray controls. Newlines and tabs are preserved.