NeuNuc Core
The local-first runtime: 6-stage kernel, doctrine rules, consent ledger, two-person publication gate, and SQLite + JSONL persistence.
Ecosystem Explainer · 2026-11-13
How the whole NeuNuc system fits together.
One governed core, replaceable edge surfaces, and a strict boundary between what belongs to you locally and what is ever published.
01 · Components
Three parts. Zero duplicate state.
Every surface reads and writes through one canonical contract instead of inventing its own database or authority model.
Memory & Recovery Layer
Canonical objects, relationships, provenance, and tamper-evident event history so work survives tool crashes and context switches.
Operator Surfaces
Baremetal web console and native desktop/CLI adapters for granting consent, inspecting ledgers, and dispatching requests.
02 · End-to-End Flow
Every action follows one governed path.
Nothing executes silently, and a failed step can never be recorded as a success.
1. Input & Attribution (A01)
Requests enter with an explicit channel, accountable actor, and schema-validated payload. Unattributed requests are refused at the edge.
ingest
2. Context Routing & Object Matching
Deterministic routing maps intent to a registered capability and matches or creates a canonical object in the durable Store.
route
3. Fail-Closed Consent & Authority Gate (D07 / A06)
Execution halts unless active, unrevoked consent for the subject and scope is on record. Authority cannot be silently delegated.
gate
4. Governed Execution & Deterministic Failure
Capabilities run inside declared limits. Missing objects or policy violations raise deterministic errors without phantom writes.
execute
5. Hash-Chained Ledger & SQLite Persistence
Every decision appends to a tamper-evident JSONL chain and SQLite Store. Torn or tampered records halt startup on re-entry.
persist
6. Two-Person Publication Gate (A03)
Internal records never leak to public surfaces. Public assets require proposal, distinct-reviewer attestation, and automated field stripping.
publish
03 · Architecture Gate
Framework independence by design.
UI frameworks, cloud hosts, and AI providers sit at the edge behind thin adapters. You can swap any surface without touching canonical data.
Public Site (neunuc.com)Pure HTML + CSS (<15 KB), zero trackers, zero runtime state
Edge ConsolePure HTML/CSS/JS talking JSON over HTTP to your gateway
Local CoreRuns offline on your hardware with SQLite + JSONL receipts
Ready to inspect the core?
Run the local neunuc-core HTTP gateway or SQLite Store vertical slice directly on your own machine.