Skip to main content

Verification strategy

Coverage is diagnostic; release confidence comes from matching each risk to the layer capable of proving it.

Claim/riskEvidenceLocal commandRemote gate
Validation, state, errorsGo/Python unit and table testsmake test test-pythonCI
Concurrency/cancellationRace-enabled package suitemake racescheduled/release
Bounded parser/state robustnessconfig/snapshot, request, DNS/URL/prefix, envelope/frame, S3 XML, and receipt-record fuzz targetsmake fuzz-smokescheduled fuzz workflow
Protocol compatibilityVersioned manifest and cross-repository consumersmake conformancecompatibility
Public dependency graphEmpty private-module settings and exact tagsmake clean-room-checkCI
Package directiongo list direct-import allowlist and pin assertionsmake dependency-checkCI
Secret residueTracked-tree credential pattern scanmake security-checkCI
Default/admin/receipt deploymentnamespaced isolated Compose startup, request, profile operation, and teardownmake profile-smoke PROFILE=default|admin|receiptsscheduled/release
HA deploymenttwo-worker scale check, Control loss, Redis degradation/recovery, and graceful worker loss in a namespaced stackmake ha-smokescheduled/release
Maintained exampleslive curl, CLI, Go, and Python calls against a namespaced stackmake examples-livescheduled/release
Documentation contractsDocusaurus build, links, and source-surface coveragemake docs-websiteCI
Supply chainGo/npm license inventory, npm audit, govulncheck, CodeQL, dependency review, intended image-content assertions, and OCI scanmake license-check npm-audit image-content-check plus security workflowSecurity
Published artifactschecksum/attestation/signature plus pull-by-digest request smokerelease procedurerelease workflow

Preserve logs, Compose state summaries, and sanitized failure artifacts. Never preserve request URLs, headers, bodies, tokens, or signed receipt URLs. Fuzz targets must be bounded and seeded by conformance fixtures or prior failures; parsers, URLs/headers, DNS, envelopes, object metadata, receipt records, and frame sequences are priority surfaces.