Research / architecture

Current research

CA-A1 — selection engine adapter contract

Type: architecture Updated: 2026-10-05 Scale: cross-jurisdictional Path: ../architecture/SELECTION-ENGINE-ADAPTER.md

architectureselectioncontract

Sources: SRC-0144SRC-0145SRC-0152

Selection engine adapter contract

CA-A1 architecture record. Updated: 2026-10-05. Vendor-neutral conceptual contract CA-CONTRACT-SEL-001. OpenDLP / sortition-algorithms are candidate implementations (CA-R3); this phase does not code the adapter.

Invocation

executeSelection(specRef, specDigest, poolRef, poolDigest,
                 seedArtefact, algorithmId, algorithmVersion) → SelectionResult | SelectionError

Inputs

FieldMeaning
specRefSelectionSpecification id + version (authorised/locked)
specDigestdigest of the spec payload actually supplied
poolRef + poolDigestanonymised respondent pool — IDs + permitted attributes only
seedArtefactentropy record produced by ceremony layer (public draw, committed randomness, etc.)
algorithmId + algorithmVersionengine + exact version — recorded in run metadata

Outputs

FieldMeaning
selectedIdsordered/unordered per spec policy
reserveOrderranked reserves within exhaustion rules
metricsquota fulfilment / optimisation objective values where available
runMetadatatimestamps, iterations, engine version, config actually used
reproArtefactsinput digest, output digest, full parameter echo — sufficient for independent re-run
errorsstructured failures (infeasible quotas, undersupplied strata, bad fields)

Behavioural contract

Candidate mapping (evidence)

Contract elementsortition-algorithmsOpenDLPPanelot
strata/quotas inputcategory matrix + targetstarget CSVhosted form
seed handlingcaller-suppliedengine-internal (undocumented)opaque
outputselected + metricsrun records + reportCSV panel
repro artefactsdeterministic re-runDB records (no export bundle)none public
reservesremaining poolfirst-class replacement runshosted

Gap visible: nobody emits a portable witness bundle — the adapter output packaging is Cicada’s.

Sources