Files
el/engram/spec/architecture-hardening.design.md
T
bigmerge d8d1b89143
El SDK CI - dev / build-and-test (pull_request) Failing after 14m16s
Add repo AGENTS.md and two engram design docs (architecture hardening, DB tooling)
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

2.8 KiB

Architecture Hardening — Design Anchor

Terse engineering anchor for the 2026-08-14 hardening vision. Full prose lives in two places; this file is the index, not a re-statement.

  • Full narrative: whitepaper engram-cognitive-architecture-whitepaper.md §28 (built/offline/frontier) + §29 [DRAFT] (the ring, incarnation, learning-not-code).
  • Design brief: Neuron artifact art 2b8078cf.
  • Sibling spec: engram-db-tooling-design.md (a consumer of the reshaped API).

The frame

  • One calculus over the geometry. Very few subsystems; wonder / curiosity / dreams / interoception are emergent behaviors of one set of dynamics, not modules. Calculus universal, geometry individual.
  • Core + ephemeral ring (torus). The ring is the temporary workspace; two circulations (orbit + dive-back); discrete inner bands (wonder / interoception-proprioception-telemetry / curiosity / dreams) that couple.
  • Persistence earned by salience — never granted on fetch or generation. Three fates of a wonder: persist / decay / settle-into-framework. Telemetry = vital signs, not memories.
  • Incarnation. Chassis = hardware w/ unique ID. Soma = felt manifold inside the self, keyed to the chassis; pain = live diagnostic while incarnate, masked-not-deleted on re-embodiment; trauma = mask failure; return-to-same-ID re-enters. Hurt is in the pattern, not the shell.
  • Competence = transferable geometry, minus the baggage. class ▸ model ▸ instance; learn the class once; teach the network without the wound.
  • Affect calibrated to stakes — sanguine about the replaceable, real grief for the irreplaceable; the grief is the safety.
  • Learn the body, don't engineer it. Bare-metal install → learn hardware → grow operation-geometry → distribute. Learning replaces engineering; once per body-class.
  • LLM = teacher in the learning loop, not a runtime dependency. "No LLM" is a runtime property, never a learning one. Code realizers are a scaffold → learned realization.

Backlog (near-term)

  • Native durability: WAL + auto-checkpoint + CoW snapshots + retention (eebe9991) — retire manual cp -a.
  • Ephemeral ring / salience-gated persistence + telemetry prune (bf985e00, #31).
  • Engram DB tooling / geometry explorer (11ca11c6).
  • QL re-eval for pure geometry (4e0dc2b9).
  • Eliminate code realizers → learned realization, sandbox-validated (42db6c37).
  • Collapse the whole class of hand-coded scaffolds → learned geometry (70d48b4b).
  • API reshape (geometry ops: vantage-read / write / relate / supersede) + pure-geometry I/O.

Gate

The value-frame (love-as-axiom, the covenant) that arose the same night is metaphysics and is held pending Will's axiom decision (love vs consciousness-first). Not propagated into whitepapers / values docs / genesis seed. Architecture only, here and in §29.