Technical architecture appendix
Decision, Semantic and Formula Architecture
Civic Ledger currently has access to TypeSafe Jev for integration and prototyping. The architecture described here is under active implementation planning; individual production workflows should be labelled operational only once connected and tested.
This appendix describes intended roles and conceptual models. It does not claim that the current website runs these decision systems or that a connected production workflow has been verified.
TypeSafe Jev / RLCD
The intended role is bounded decision-making: source classification, entity matching, relationship classification, relevance, confidence, contradiction detection and routing.
Each decision needs a defined question, attributable inputs and an inspectable result. The system must preserve uncertainty rather than expand a narrow classification into an unsupported civic judgment.
Word Wheels
Semantic decomposition makes vague statements testable. “Council supports growth” must be broken into specific questions:
- Which council?
- What kind of growth?
- Which instrument or decision?
- Which geographic or institutional scope?
- Which timeframe?
- Under which conditions?
Those distinctions determine what evidence could support the claim and where it remains ambiguous.
Void Node
The architecture reserves a place for ambiguous, contradictory, insufficient and unresolved information. These states are useful outcomes, not failures to be hidden behind a forced answer.
Light Mathematics Protocol
The planned role is transparent, versioned rules for evidence composition, confidence, source coverage, mission thresholds, sampling conditions, privacy thresholds, correction logic and standing-instruction conditions.
The purpose is to make those rules inspectable and reproducible for a defined question. An output should identify the applicable rule version, inputs and limits. The methodology must not generate generalized citizen reputation scores.
Observed State: government as recorded
Go(t)
This represents government as observed at time t: its structure, authority and attributable public activity. Source history and correction rules remain part of the record.
Prototype State: a defined transformation
Gp(t) = T(Go(t), Δ)
The transformation T applies proposed improvements Δ to the observed baseline. The result is an experimental model, not a replacement for the observed evidence.
Never rewrite the Observed State to make it look like the Prototype State. Preserve both, with the transformation and its assumptions visible.
Adoption creates a new observed fact
Gp → Official adoption → New Observed State
If a government later adopts a prototype feature through applicable lawful processes, that official action becomes a new event in the Observed State. The prototype itself does not enact the change.
This separation is the conceptual foundation of Parallel Republic experimentation: model a difference, demonstrate it and preserve the distinction between a proposal and an official act.