External integration contracts
CA-A1 architecture record. Updated: 2026-10-05. Conceptual seams only — no adapters are designed or coded here. Each seam is a CA-CONTRACT-* defined against capabilities, not vendors.
Contract IDs
| Contract | Seam | Candidate implementations | Status |
|---|---|---|---|
| CA-CONTRACT-SEL-001 | Selection engine execution | sortition-algorithms (adapt), OpenDLP (integrate), Panelot (service, unresolved) | defined (SELECTION-ENGINE-ADAPTER.md) |
| CA-CONTRACT-PART-001 | Mass public participation | Decidim, CONSUL | defined below |
| CA-CONTRACT-DELIB-001 | Async member deliberation | Loomio | defined below |
| CA-CONTRACT-INPUT-001 | Mass open-ended input | Polis | defined below |
| CA-CONTRACT-CAPTURE-001 | Transcription/synthesis of sessions | Dembrane Echo (licence-conditional) | defined below |
| CA-CONTRACT-ID-001 | Identity / verification | external IdP / census services | sketch only |
| CA-CONTRACT-OFF-001 | Offline/manual fallback | institutional process | defined below |
CA-CONTRACT-PART-001 — participation platform seam
- Role: public participation envelope around an assembly — proposals, meetings, public questions, result publication.
- Flow: public objects live external; Cicada holds
ExternalChannelrecord + importedAgendaItemorigins +EvidenceItemsubmissions + publishedResponse/Commitmentmirrors. - Provenance: imports carry
{system, external_id, fetched_at, digest}; channel bias label attached (open public participation ≠ representative input). - Boundary: external participation never produces canonical membership, decision or recommendation objects.
CA-CONTRACT-DELIB-001 — async deliberation seam
- Role: between-session member discussion and voting (threads, polls).
- Flow: DeliberationRecord cites external thread; DecisionEvent may cite an external poll as its provenance — the canonical decision record is still ours (question/method/electorate/result).
- Boundary: external poll mechanics ≠ decision method declaration; the canonical record declares method, the seam evidences it.
CA-CONTRACT-INPUT-001 — mass input seam
- Role: open-ended public input feeding the evidence/agenda layer (statements, votes, clusters).
- Flow: channel record + imported summaries as EvidenceItems with
submission_channel: mass-inputand bias label; analytics are inputs, never decisions. - Boundary: no participant identity crosses; only aggregate/artefact level.
CA-CONTRACT-CAPTURE-001 — capture/synthesis seam
- Role: session audio → transcription → synthesis → report (in-person multilingual capture).
- Flow: DeliberationRecords cite external artefacts; every synthesis carries
ai_artefact=trueand advisory labelling (CA-REQ-084). - Boundary: AI-generated synthesis never appears as authoritative record; licence (BSL) gates adoption.
CA-CONTRACT-ID-001 — identity seam (sketch)
- Role: authentication of operators/members; optional verification for public-vote channels.
- Flow: external identity assertion → internal person/membership reference.
- Boundary: identity provider verifies access; it never establishes eligibility (CA-OBJ-004) or authority (CA-OBJ-030).
CA-CONTRACT-OFF-001 — offline/manual seam
- Role: paper/postal/phone/in-person equivalents (see ACCESSIBILITY-OFFLINE).
- Flow: offline acts are recorded as canonical events by authorised operators;
provenancecites the physical artefact/witness. - Boundary: the canonical record shape is identical whether the act happened online or on paper — offline is not a degraded path.
Common seam rules
- All seams produce canonical events; external systems are channels and tools, not the record.
- Every seam citation carries digest + fetch timestamp.
- Seam failure degrades to the offline/manual path — the institution must remain operable.
- Seams are removable — an institution using zero external systems exercises only OFF-001.