65dd2cf09713b42998b8f5d7a383484798cca104
The architecture docs describe four things the design spec has since ruled out, and each one is a supervisor invented for something that should be a property of the substrate: grounding modelled as a subsystem rather than as the edge weight it already is; faculties modelled as parameters of a read when abduce is a write; wonder materialized as a maintained manifest when it is the boundary of the structure; and consolidation implemented eleven times behind tickers when a brain has no cron job. Left standing rather than deleted, per the repo's own supersession discipline — the trail of how the understanding matured is the point. Each stale passage is marked inline and points at a new 06 §12 that transcribes the corrections and records the measured consolidation inventory. Authority: foundation/el, branch design/correspondence-and-censorship, lang/spec/correspondence-and-censorship.md.
Merge pull request 'Tools + agentic loop on the OpenAI wire — plus two pre-existing bugs that silently break chat' (#122) from feat/soul-openai-tools-v2 into main
neuron
The canonical CGI substrate: the soul (the running agent), the engram (its memory
graph), and the MCP proxy/wrapper that expose it. See AGENTS.md for detail, including
the audit-verified local build/regenerate recipe and known local-build gotchas.
Quick local build
# 1. dist/soul.c must match current .el sources — this refuses otherwise:
bash tools/build-soul-from-dist.sh dist/neuron
# 2. If it refuses (stale amalgam), regenerate first — see AGENTS.md's
# "Build / regenerate dist/soul.c" section for the full, gotcha-laden recipe.
For a full local dev stack (soul + engram + mcp-wrapper + mcp-proxy, wired into Claude
Code) see neuron-dev-setup/README.md instead — this repo alone only builds the soul.
Code vs. Artifact
- Authored source:
*.el+*.elhat the repo root pluscli/,council/,connectd/,mcp-proxy/,mcp-wrapper/— edit here. - Artifacts (do not hand-edit):
dist/soul.c(generated single-TU amalgam — regenerate via the recipe inAGENTS.md, thentools/soulc-stamp.sh --write) and thedist/neuronbinary it compiles to. - Release: git tag
neuron-vX.Y.Zon this repo. Noreleases/folders.
See org policy: docs/CODE-VS-ARTIFACT.md.
Languages
Emacs Lisp
68.6%
Python
15.5%
Shell
14.6%
HTML
0.6%
Go Template
0.4%
Other
0.3%