will.anderson 65dd2cf097
Neuron Soul CI / build (pull_request) Failing after 4m9s
Neuron Soul CI / deploy (pull_request) Has been skipped
docs: record the correspondence corrections — grounding, faculties, wonder, consolidation
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.
2026-08-16 13:31:27 -05:00

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 + *.elh at the repo root plus cli/, council/, connectd/, mcp-proxy/, mcp-wrapper/ — edit here.
  • Artifacts (do not hand-edit): dist/soul.c (generated single-TU amalgam — regenerate via the recipe in AGENTS.md, then tools/soulc-stamp.sh --write) and the dist/neuron binary it compiles to.
  • Release: git tag neuron-vX.Y.Z on this repo. No releases/ folders.

See org policy: docs/CODE-VS-ARTIFACT.md.

S
Description
Neuron - the canonical CGI substrate. Real soul.el lives here.
Readme
15 MiB
Languages
Emacs Lisp 68.6%
Python 15.5%
Shell 14.6%
HTML 0.6%
Go Template 0.4%
Other 0.3%