Open-source layer

Civic Logos Reasoning Ledger

An open protocol and reference implementation for public claims, contributions, AI-reader notes, human review decisions, and visible revision history.

Grant-facing scope

This page is the public anchor for NLnet-facing review of the proposed open-source layer. It describes the reusable ledger scope, planned deliverables, and current prototype evidence without treating the specification, license, or reference implementation as finished.

Public-record milestone

Civic Logos has completed its first founder-maintainer public-record revision. The next milestone is the first outside public contribution.

Count wording is intentionally split: the healthcare ledger currently has 1 formal RevisionEvent, while visible revision-trace updates may include supporting narrative checkpoints.

V2 status

V2 candidate intake is active.

  • AI may create pre-ledger candidate records.
  • Candidate records are not public contributions.
  • Promotion requires human review.
  • RevisionEvents still require the existing public review path.

/ask does not change public counts, does not create RevisionEvents, and does not change synthesis.

Physics Foundations read-only asks are now supported from the existing public topic. They remain read-only unless the user explicitly contributes a candidate.

Public-record audit

The first revision proved the ledger loop can move a card without faking public uptake.

  • Origin was labeled as founder-maintainer, not outside public submission.
  • AI-reader notes were recorded as advisory structure.
  • Human review decided incorporation.
  • The visible synthesis changed only after review.
  • The revision trace preserved the before/after state.
Next public test

The first outside contribution is still the next milestone.

Prototype examples and founder-maintainer records stay labeled separately. The public runway now asks a stranger to make one useful objection, evidence source, correction, implementation concern, or economic assumption challenge.

What it is

A versioned public reasoning record.

The ledger is for claims that should not disappear into feeds. It keeps the current synthesis, the pressure against it, the evidence attached to it, and the human decisions that explain why the record changed or did not change.

Current status

Visible prototype, protocol v0.1 in progress.

Prototype ledger concepts are visible in the healthcare card now, and protocol v0.1 is being formalized in the repository through specs, schemas, fixtures, and conformance cases. A reference implementation is the next phase; the open-source release is planned, not presented as complete.

Core objects

The ledger is made of inspectable records, not feed posts.

RoomRecord
TopicRecord
ClaimRecord
SynthesisSnapshot
ContributionRecord
EvidenceObject
ObjectionRecord
AssumptionRecord
OpenQuestionRecord
AIReaderNote
HumanReviewDecision
AppealRecord
AttachmentTarget
RevisionEvent
MetricScore
AuditEvent
ActorRecord
Core workflow

AI can assist the record, but human review moves it.

  1. 01

    Contribution enters

  2. 02

    classified into a lane

  3. 03

    AI-reader notes are attached

  4. 04

    human review decides placement

  5. 05

    record attaches to claim, evidence, objection, assumption, or open question

  6. 06

    synthesis changes only if warranted

  7. 07

    before/after revision trace is preserved

Why open source

Reusable public reasoning infrastructure.

Other civic-tech projects, newsrooms, public comment systems, research groups, and institutions should be able to reuse the ledger without adopting the entire Civic Logos product.

civic-tech projectsnewsroomspublic comment systemsresearch groupsinstitutions
Licensing plan

Libre/open release intent.

Grant-funded ledger code and documentation are intended to be released under recognized libre/open licenses. A final license should be named only after it is chosen.

Planned deliverables

A specification plus a working reference path.

open specification
TypeScript/Postgres reference implementation
API routes
minimal review UI
test fixtures
documentation
example healthcare ledger integration