neuron-technologies/neuron

Fork 0

Files

T

will.anderson 5bd9fbe9cd

Neuron Soul CI / build (pull_request) Successful in 3m42s

Details

Neuron Soul CI / deploy (pull_request) Has been skipped

Details

fix(build): close real local-build gaps found in a hands-on build/run audit

Three verified, currently-live problems, each closed with real evidence
(full trace kept in Neuron memory, tags neuron-technologies/neuron,build-audit):

1. dist/soul.c was stale relative to main's own chat.el (11 commits / 459
   lines behind, missing PR #122's OpenAI-tools + agentic-loop work and its
   two "silently break chat" fixes). tools/soulc-stamp.sh --check confirmed
   it; tools/build-soul-from-dist.sh correctly refused to build (exit 9).
   Regenerated and re-stamped. No runnable regen script existed anywhere
   upstream — added tools/regenerate-soul-amalgam.sh, which reproduces the
   committed amalgam's exact symbol set (byte-for-byte content match, modulo
   the genuinely new PR #122 functions) and is documented end-to-end in
   AGENTS.md, including three real elc/elb toolchain gotchas found and
   root-caused along the way (stale .elh caches silently truncating builds;
   elb cannot produce this repo's single-TU amalgam; elc silently drops the
   first function(s) after a comment block in a flat-concatenated compile).

2. tools/build-soul-from-dist.sh failed to link on macOS (`ld: library 'ssl'
   not found` — Homebrew's openssl@3 is keg-only) and was missing -lssl
   -lcrypto entirely, drifted from CI's own working recipe. Fixed: adds
   -L$(brew --prefix openssl@3)/lib on Darwin, matches CI's link line.
   Verified: dist/neuron now builds and boots clean on a throwaway
   port/HOME (never touched the live :7770/:8742).

3. Untracked committed *.elh compiler-header caches (elc/elb prefer a stale
   cached header over recompiling its source, silently, with no error —
   this is what caused an under-resolved 251-2541-function amalgam multiple
   times during this audit before the cause was found). Removed from git,
   gitignored going forward.

Also: AGENTS.md and README.md existed on disk but were never committed
(git log on both returned nothing) and documented the pre-collapse ~90-tool
MCP surface as current. Committed corrected versions reflecting the live
9-op surface (read/write/relate/supersede/think/attend/assert/ground/learn,
merged in #153) and the audit-verified build recipe/port topology.

Added connectd/ — a minimal local-dev stub for the neuron-connectd MCP
sidecar. routes.el/chat.el call 127.0.0.1:7771 for it right now on every
soul boot and agentic turn per a real, detailed 2026-06-13 spec
(mcp-connectors-adoption-spec.md); the sidecar itself was never built.
Meanwhile :7771 is a live three-way collision (axon's unbuilt-Rust default,
this connectd contract, and council — the anti-confabulation service
actually running there in prod, which live-answers both other things'
requests with unrelated 404s instead of a clean bridge-down signal). This
stub only implements the documented contract as "zero connectors
configured" for local-dev correctness; it does not attempt OAuth or a real
MCP client — that is a real, separate product decision. See
connectd/README.md for the full trace and the open question left for Will.

2026-08-15 17:54:30 -05:00

1.2 KiB

Raw Blame History

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.

1.2 KiB Raw Blame History

neuron

Quick local build

Code vs. Artifact

1.2 KiB

Raw Blame History