nsbx + cognitive architecture design + engram self-review series #113

Merged

will.anderson merged 2 commits from feat/neuron-sandbox into dev

2026-08-15 19:59:11 +00:00

Author	SHA1	Message	Date
bigmerge	d8d1b89143	Add repo AGENTS.md and two engram design docs (architecture hardening, DB tooling) El SDK CI - dev / build-and-test (pull_request) Failing after 14m16s Details AGENTS.md: root-level guide to the repo — which of the 8 el_runtime.c copies is the one canonical, authored source (lang/releases/v1.0.0-20260501, despite the misleading 'releases/' name) vs. lagging forks/build artifacts, build commands, and session protocol. engram/spec/architecture-hardening.design.md: terse engineering anchor for the 2026-08-14 hardening vision (one calculus over the geometry, core + ephemeral ring, persistence earned by salience, incarnation model) — indexes the fuller whitepaper + Neuron artifact 2b8078cf rather than restating them. engram/spec/engram-db-tooling-design.md: high-level design for engram DB tooling (geometry-native browse/query/ops surface over the existing vantage-read/write/relate/supersede API). Deliberately leaves out of this commit: the uncommitted el_runtime.c/h + codegen.el float-arithmetic-codegen diff in this worktree, which appears to overlap with (or supersede) the fix already preserved via PR #104 — needs manual reconciliation rather than a second competing PR. Also leaves out lang/.promote-backup-floatfix/ (a local backup snapshot, confirms that float-fix work is mid-promotion here), assorted .DS_Store files, engram/dist/engram.* backup binaries, and lang/dist backup binaries — none of it source.	2026-08-15 14:29:59 -05:00
bigmerge	05e5d3c402	self-review 2026-08-15: consolidate the strongest Hebbian candidate, not the lowest-hash one The link-formation scan walked candidate slots ascending and stopped at ENGRAM_HEBB_LINK_PER_CALL (2). Slot index is a hash of the node id pair, so whenever more than two candidates cleared LINK_MIN in the same call, the two consolidated were the two with the lowest hash and a stronger association waited - indefinitely, since the scan restarts from slot 0 every call while the leader decays at ENGRAM_HEBB_DECAY. Measured 08-13..08-15: hebb_cand_max peaked at 0.4963, 3.3x LINK_MIN, during a ~14h stretch of continuous qualification at the 2/call cap. Same defect the 2026-08-02 review named and fixed for breakthrough weights (index order is not a cognitive criterion), never carried across to the one path that writes permanent structure - and there is no pruning path, so growth is one-way. Selection pressure matters most where the result is irreversible. No-op when <=2 candidates qualify; picks the best when more do.	2026-08-15 08:44:37 -05:00

Author

SHA1

Message

Date

bigmerge

d8d1b89143

Add repo AGENTS.md and two engram design docs (architecture hardening, DB tooling)

El SDK CI - dev / build-and-test (pull_request) Failing after 14m16s

Details

AGENTS.md: root-level guide to the repo — which of the 8 el_runtime.c
copies is the one canonical, authored source (lang/releases/v1.0.0-20260501,
despite the misleading 'releases/' name) vs. lagging forks/build artifacts,
build commands, and session protocol.

engram/spec/architecture-hardening.design.md: terse engineering anchor for
the 2026-08-14 hardening vision (one calculus over the geometry, core +
ephemeral ring, persistence earned by salience, incarnation model) —
indexes the fuller whitepaper + Neuron artifact 2b8078cf rather than
restating them.

engram/spec/engram-db-tooling-design.md: high-level design for engram DB
tooling (geometry-native browse/query/ops surface over the existing
vantage-read/write/relate/supersede API).

Deliberately leaves out of this commit: the uncommitted el_runtime.c/h +
codegen.el float-arithmetic-codegen diff in this worktree, which appears
to overlap with (or supersede) the fix already preserved via PR #104 —
needs manual reconciliation rather than a second competing PR. Also
leaves out lang/.promote-backup-floatfix/ (a local backup snapshot,
confirms that float-fix work is mid-promotion here), assorted .DS_Store
files, engram/dist/engram.* backup binaries, and lang/dist backup
binaries — none of it source.

2026-08-15 14:29:59 -05:00

bigmerge

05e5d3c402

self-review 2026-08-15: consolidate the strongest Hebbian candidate, not the lowest-hash one

The link-formation scan walked candidate slots ascending and stopped at
ENGRAM_HEBB_LINK_PER_CALL (2). Slot index is a hash of the node id pair, so
whenever more than two candidates cleared LINK_MIN in the same call, the two
consolidated were the two with the lowest hash and a stronger association
waited - indefinitely, since the scan restarts from slot 0 every call while
the leader decays at ENGRAM_HEBB_DECAY.

Measured 08-13..08-15: hebb_cand_max peaked at 0.4963, 3.3x LINK_MIN, during
a ~14h stretch of continuous qualification at the 2/call cap.

Same defect the 2026-08-02 review named and fixed for breakthrough weights
(index order is not a cognitive criterion), never carried across to the one
path that writes permanent structure - and there is no pruning path, so
growth is one-way. Selection pressure matters most where the result is
irreversible.

No-op when <=2 candidates qualify; picks the best when more do.

2026-08-15 08:44:37 -05:00

nsbx + cognitive architecture design + engram self-review series #113

2 Commits