Grant-facing scopeThis 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 milestoneCivic 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 statusV2 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 auditThe 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 testThe 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 isA 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 statusVisible 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.
RoomRecordTopicRecordClaimRecordSynthesisSnapshotContributionRecordEvidenceObjectObjectionRecordAssumptionRecordOpenQuestionRecordAIReaderNoteHumanReviewDecisionAppealRecordAttachmentTargetRevisionEventMetricScoreAuditEventActorRecordCore workflow
AI can assist the record, but human review moves it.
- 01
Contribution enters
- 02
classified into a lane
- 03
AI-reader notes are attached
- 04
human review decides placement
- 05
record attaches to claim, evidence, objection, assumption, or open question
- 06
synthesis changes only if warranted
- 07
before/after revision trace is preserved
Why open sourceReusable 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 planLibre/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 specificationTypeScript/Postgres reference implementationAPI routesminimal review UItest fixturesdocumentationexample healthcare ledger integration Related links
Inspect the live prototype and public-facing paths.