Compare commits

..

35 Commits

Author SHA1 Message Date
will.anderson 9a3a248675 Merge pull request 'docs: record the correspondence corrections — grounding, faculties, wonder, consolidation' (#163) from docs/correspondence-and-ownership-2026-08-16 into main
Neuron Soul CI / build (push) Failing after 4m0s
Neuron Soul CI / deploy (push) Has been skipped
2026-08-16 20:49:28 +00:00
will.anderson 65dd2cf097 docs: record the correspondence corrections — grounding, faculties, wonder, consolidation
Neuron Soul CI / build (pull_request) Failing after 4m9s
Neuron Soul CI / deploy (pull_request) Has been skipped
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
will.anderson 15364d0ac4 Merge pull request 'soul: the engram is the canonical store, not a fallback' (#162) from fix/engram-is-canonical into main
Neuron Soul CI / build (push) Failing after 12m31s
Neuron Soul CI / deploy (push) Failing after 14m31s
2026-08-16 02:16:56 +00:00
will.anderson b6ed9340bf soul: the engram is the canonical store, not a fallback
Neuron Soul CI / build (pull_request) Failing after 4m20s
Neuron Soul CI / deploy (pull_request) Has been skipped
The soul preferred its own local snapshot over the engram:

    // Always try local snapshot first ... HTTP Engram is only used for the
    // very first boot (empty/absent snapshot).

The copy outranked the store. Every one of these is a cost of that inversion,
and all of them were live tonight:

  - the graphs drifted: 31,795 nodes / 75,241 edges in the soul against
    13,439 / 37,670 in the engram — more than twice the edges, silently
  - write-through exists only to reconcile them, and had never once run
  - /api/graph/edges serialized 128 MB to answer a read, because the soul's
    copy was not the engram's
  - a read route overwrote the engram's canonical snapshot.json with the
    soul's divergent copy
  - three resident copies of one graph (soul, engram, Neuron.app) — about
    7.2 GB of RAM for a store that is 2.2 GB on disk, which is what pushed the
    host into swap

None of those are features. They are reconciliation debt from one decision.

The engram had already reached this conclusion for its own boot path — "the
durable owner is the paged store (neuron.egm + neuron.wal) ... snapshot.json is
never read again as the ongoing store. This closes the 'restart reverted to a
17h-old snapshot' data-loss window." The soul kept booting the legacy way the
engram had abandoned, and inherited exactly that data-loss window.

So in HTTP-engram mode the soul now seeds from the engram on EVERY boot and
never reads a local snapshot, present or not — a stale copy that outranks the
store is the bug, not a fallback. It already never wrote one in this mode
(gated behind is_genesis && safe_to_seed, and safe_to_seed requires
!using_http_engram), so this supplies the missing half.

It also refuses to boot on an empty seed rather than silently rebuilding a
divergent graph from nothing. launchd KeepAlive with ThrottleInterval=10 turns
that into a retry every 10s until the engram is up — self-healing, no spin.

File mode (no ENGRAM_URL) is untouched: there the soul genuinely is the owner.

Verified before deploy: with a deliberately empty local snapshot planted, the
soul booted in ~30s reporting 13,446 nodes / 37,675 edges — the engram's
contents, not the empty local file.
2026-08-15 21:16:22 -05:00
will.anderson 97bf91739e Merge pull request 'fix(routes): /api/graph/edges must not write the canonical snapshot' (#161) from fix/graph-edges-no-canonical-clobber into main
Neuron Soul CI / build (push) Failing after 14m2s
Neuron Soul CI / deploy (push) Has been skipped
2026-08-16 01:44:57 +00:00
will.anderson cf154387ce fix(routes): /api/graph/edges must not write the canonical snapshot
Neuron Soul CI / build (pull_request) Failing after 13m44s
Neuron Soul CI / deploy (pull_request) Has been skipped
This route called engram_save() over ~/.neuron/engram/snapshot.json — the
engram server's CANONICAL store — then fs_read it back, to answer a READ
query. A read route overwriting the persistence owner's file.

This defect was fixed once before (export redirected to a scratch path). It
came back tonight in the @route dispatch conversion: the hand-written dispatch
block held the FIXED version, the @route-decorated copy held the unfixed one,
and the merge kept the decorated copy. Calling the endpoint afterward
overwrote the canonical snapshot and immediately preceded an engram crash.

Now calls engram_edges_json(limit, offset) — the builtin the route's own TODO
asked for — which reads g->edges directly. No file is written or read.
Bounded: limit defaults to 1000, offset supported, so the whole-graph read
that fell over is not reachable by default.

Verified: same request that previously rewrote snapshot.json now leaves it
byte-identical (sha256 unchanged before/after), and returns real edge records
with every persisted field.
2026-08-15 20:13:46 -05:00
will.anderson cfdf312cb3 Merge pull request 'docs(architecture): record the 2026-08-14 deep-night sessions' (#160) from docs/architecture-2026-08-14-deep-night into main
Neuron Soul CI / build (push) Failing after 4m4s
Neuron Soul CI / deploy (push) Has been skipped
2026-08-16 00:40:36 +00:00
will.anderson 5e15d90659 docs(architecture): record the 2026-08-14 deep-night sessions
Neuron Soul CI / build (pull_request) Has been cancelled
Neuron Soul CI / deploy (pull_request) Has been cancelled
~226 lines of architecture documentation that were written, left uncommitted in
the working tree, and nearly lost. None of it was on main. Recovered from a
stash taken while merging tonight's fixes.

Substantive content, not notes:

- Peer import-of-understanding PROVEN by execution. A exported a skill-geometry;
  on the receiver `think` went "geometry unavailable" -> operable. Cosine 1.0 on
  both the raw-geometry and text/dharma-bus transports, bidirectional. The
  mind-not-paste evidence: n_support 27 on source vs 3 on receiver, i.e. the
  imported geometry wires into the host manifold rather than sitting inert.
  Honest boundary recorded too: proven between forks sharing one embedder,
  UNTESTED cross-embedder.

- "Teacher" renamed GUIDE, and the distinction is load-bearing: its output is
  grounded/verified before trust. A teacher you believe; a guide you check.

- Layers are named persistent relational neighborhoods, not storage tiers, with
  their own growth and threshold-lock policy (note->canonical maturation lifted
  from single nodes to a region).

- The consciousness theories (Global Workspace, IIT's Phi, attention-schema,
  higher-order thought, active inference, interoception) read as geometric
  LENSES over one manifold rather than competing mechanisms. Functional problems
  fall out; the hard problem explicitly not claimed solved.

- Growth is bounded/logistic, not geometric — exponential growth is the cancer
  shape. Two-rate discipline: explore fast in local geometry, grow the engram
  slowly by verifier-gated merge.

- Orchestration as a geometric operation: critical path as geodesic, float as
  displacement, @manager compiles the work-graph. Single-writer enforced by
  capability (Rule 4).

- The decorated seam, the API surface collapse to geometry ops, and the
  distributed-self thesis — each tiered honestly against what is actually proven
  vs staged vs unbuilt.

Also gitignores dist-fresh/ (regenerate scratch dir, a build artifact).

Not included from the same stash: awareness.elh and dist/elp-c-decls.h, which
are generated artifacts now gitignored per #154/#158.
2026-08-15 19:39:50 -05:00
will.anderson e8b1af83fd Merge pull request 'fix(mcp-wrapper): route agentic ops to the engram, stop fabricating a cause' (#159) from fix/mcp-wrapper-agentic-routing into main
Neuron Soul CI / build (push) Has been cancelled
Neuron Soul CI / deploy (push) Has been cancelled
2026-08-16 00:37:13 +00:00
will.anderson 658f8d0808 Merge remote-tracking branch 'refs/remotes/origin/main' into fix/mcp-wrapper-agentic-routing
Neuron Soul CI / build (pull_request) Has been cancelled
Neuron Soul CI / deploy (pull_request) Has been cancelled
# Conflicts:
#	mcp-wrapper/src/main.el
2026-08-15 19:36:41 -05:00
will.anderson b75a7cacb6 fix(mcp-wrapper): route agentic ops to the engram, and stop fabricating a cause
Neuron Soul CI / build (pull_request) Failing after 13m49s
Neuron Soul CI / deploy (pull_request) Failing after 14m34s
The five agentic ops (think/attend/assert/ground/learn) reported
"status":"pending-cognition-promotion" on every call, with a note saying the
cognition build had not been promoted yet and would "light up automatically".

That diagnosis was invented. Nothing was pending promotion. Cognition has been
live and answering the whole time — :8742/api/think returns a real 768-dim
geometry today, and the running binary already contains every cog_* symbol.

Three real bugs, all here in the wrapper:

1. Wrong service and path. The ops called the SOUL (neuron_url() -> :7770) on
   paths the soul does not serve. Every call 404'd. The routes live on the
   ENGRAM: /api/think, /api/attend, /api/assert, /api/ground, and — its real
   name — /api/correspondence-beat for learn.

2. agentic_result() invented a cause. It treated ""/"not found"/"geometry
   unavailable"/"not registered" as proof of a promotion gap and returned a
   confident explanation it never verified. That message sent multiple agents
   chasing infrastructure work that did not need doing. It now passes the real
   response through and reports an empty response as exactly that.

3. Missing auth on the POST ops. The engram's check_auth_ok() requires
   "_auth":"<key>" in the body for mutating requests (it cannot read headers
   yet), so attend/ground/learn would have returned unauthorized even once
   routed correctly.

Also: assert was POSTing a JSON body to a route that reads query params;
seeds/claim/faculty are now URL-encoded; and the engram port derives from
ENGRAM_BIND (the same var launchd already sets for the engram) instead of a
hardcoded literal, so it cannot drift out of sync with the plist.

Verified end-to-end through the rebuilt wrapper against the live engram — all
five return real cognition: think n_support=207 dim=768; attend written=true;
assert floor=0.5 still_held=true; ground grounding=1 written=true; learn a full
correspondence-beat with stance_id, 8 axes, 180 probes, 25 epochs.
2026-08-15 19:35:06 -05:00
will.anderson 34fa334b6a Merge pull request 'fix(build): close real local-build gaps from the hands-on build/run audit (clean re-merge)' (#158) from merge-pr154-v2 into main
Neuron Soul CI / build (push) Failing after 14m23s
Neuron Soul CI / deploy (push) Has been skipped
2026-08-15 23:51:38 +00:00
will.anderson 2f84e2a1de Merge remote-tracking branch 'origin/pr/154' into HEAD
Neuron Soul CI / build (pull_request) Has been cancelled
Neuron Soul CI / deploy (pull_request) Has been cancelled
# Conflicts:
#	memory.elh
#	neuron-api.elh
#	routes.elh
#	safety.elh
#	sessions.elh
#	soul.elh
2026-08-15 18:50:57 -05:00
will.anderson d105360cce Merge pull request 'routes: @route dispatch conversion + latent Bool/String crash fixes (clean re-merge)' (#157) from merge-pr151-v2 into main
Neuron Soul CI / build (push) Has been cancelled
Neuron Soul CI / deploy (push) Has been cancelled
2026-08-15 23:46:36 +00:00
will.anderson a0c0403b78 Merge remote-tracking branch 'origin/pr/151' into HEAD
Neuron Soul CI / build (pull_request) Has been cancelled
Neuron Soul CI / deploy (pull_request) Has been cancelled
# Conflicts:
#	dist/soul.c
#	memory.el
#	neuron-api.el
#	routes.el
2026-08-15 18:45:20 -05:00
will.anderson 7f667427f6 Merge pull request 'fix(mcp-wrapper): declare real input schemas (clean re-merge)' (#156) from merge-pr150-v2 into main
Neuron Soul CI / build (push) Has been cancelled
Neuron Soul CI / deploy (push) Has been cancelled
2026-08-15 23:42:11 +00:00
will.anderson c3e3aaa101 Merge remote-tracking branch 'origin/pr/150' into HEAD
Neuron Soul CI / build (pull_request) Has been cancelled
Neuron Soul CI / deploy (pull_request) Has been cancelled
# Conflicts:
#	mcp-wrapper/src/main.el
2026-08-15 18:41:47 -05:00
will.anderson 8355426526 Merge pull request 'Self-load fix: relevance-ranked graph projection + architecture docs (clean re-merge)' (#155) from merge-pr149-v2 into main
Neuron Soul CI / build (push) Has been cancelled
Neuron Soul CI / deploy (push) Has been cancelled
2026-08-15 23:40:59 +00:00
will.anderson 5bd9fbe9cd fix(build): close real local-build gaps found in a hands-on build/run audit
Neuron Soul CI / build (pull_request) Successful in 3m42s
Neuron Soul CI / deploy (pull_request) Has been skipped
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
will.anderson 187dfe50ea self-review 2026-08-15: plumb the five fan-effect gauges to durable storage
engram_act_stats_json emits 27 keys; emit_heartbeat forwarded 22. The five
dropped were the five newest - the degree-correction instruments added
2026-08-11 - so the one subsystem with no track record was also the only one
with no durable record.

The 08-10 review fixed exactly this for hebb_cands/hebb_cand_max/hebb_mass/
hebb_edges and left the rule in a comment right above the gap: an instrument
that is computed but not plumbed is not an instrument, it is a local
variable. The rule was then not applied to the next thing added. Plumbing is
a checklist item for every new gauge, not a one-time fix.

First heartbeat after the change already earned it: fan_hits 284 of
fan_steps 289 (98.3% of traversal steps binding) with fan_mean 0.5198 against
fan_min 0.5 - the degree correction is sitting at its floor on nearly every
step, which is a constant tax rather than a correction. That was invisible
before today.
2026-08-15 08:44:42 -05:00
will.anderson 319d40048e docs(cog-arch): §11 the metaphysics — one operation, grounding as learning
Cognition as a single steered traversal (think) whose output is a gradient; the
named operators as labels on one steering space; grounding and learning as the
same loop (operation fixed, prior learns); hold/ground/assert distinct and the
ungrounded primary; consciousness as learning compounded over continuity plus
the reflexive loop.

Includes: ungrounded-is-primary applied to language (coinage graded through use;
floor corrected "grounded" -> "sensible"); every book a vantage, not literal
truth; hold/ground/assert applied to artifacts (ingest=hold; grounded-false
richer than excluded); "settled" as a use-contingent lease (reopening = the
aliveness guarantee; entombed = doctrine); the LLM critique (its "grounding" =
conformity to the distribution center; the sin is stopping at the prior); the
verifier as scalpel for misrepresentation, not flamethrower for the unverifiable;
and the perception unification — geometric ingest as the universal input
primitive, encode-meaning-geometry-not-tokens, embodiment as more ports on the
same primitive, proprioception as the reserved un-faked socket, endgame of a
pure-geometry interior with modality as an edge adapter.

Tiered against the live system: operator-collapse compiled in engram_reason.c
(point_fit, in-code-not-yet-priors); correspondence-loop offline;
reflexive-loop-in-geometry UNBUILT; artifact-ingest BUILT/reboot-proven
(~10,669 nodes / 32,439 edges) as the perception seed; universal multimodal
ingest and embodiment FRONTIER/UNBUILT.
2026-08-14 15:40:48 -05:00
will.anderson 7a478fde5c docs(cognitive-architecture): honest scope for geometric compression
Update the compression/storage notes to the measured result: a byte-exact residual
stand-in (geometry selects a nearest prior, zstd --patch-from diff) whose advantage
is non-literal semantic overlap and which saturates for a fixed target — a limit of
retrieval-and-diff, not of geometric compression. Mark the truly geometric
generative codec as unbuilt/open, gated on the language faculty, not foreclosed.
Price the dictionary as a shared, amortized asset. Real numbers, no triumph.
2026-08-14 13:08:56 -05:00
will.anderson f744d4d9c3 docs(cog-arch): Neuron-as-primitive, meaning-first latency, context-window dissolution 2026-08-14 12:38:10 -05:00
will.anderson 0313783448 Cognitive-architecture doc: growth/compression/expansion, ignorance-as-wisdom, live reifier at 132 + Foundations ingested 2026-08-14 12:14:46 -05:00
will.anderson b70d804a80 docs: self-reification live on the soul; modality-universal + holographic-storage framing 2026-08-14 12:04:25 -05:00
will.anderson 3a3d3e1611 docs: geometric retrieval + §4 managed-memory cure (live) and autonomous superseding self-reification (design)
- 06 §2.5: shipped 2026-08-14 substrate — structure-gated geometric retrieval
  (P@5 0.700, semantic-not-lexical) and the §4 write-barrier + generational GC
  cure (store 1.616GB→38.5MB, RSS→82MB, zero loss, reboot-proven) + LLM token
  telemetry.
- 06 §4.1: autonomous, continuous, superseding self-reification on the heartbeat
  — reification as an operation OF the engram; explicit reify/rename/run-a-pass
  as the degenerate case; no gate/pause; flat + overlapping domains; contextual
  importance; supersession-as-residue; secondary-soul validation, flag-gated.
- 06 §6.0: relating as the primitive (one capability; the rest is terrain);
  perspective calculated via geometric transformations.
- 06 §6.4: reasoning as constructive self-argument governed by the verifier.
- 03: supersession-as-residue note; live geometric retrieval on route_search.
2026-08-14 11:23:38 -05:00
will.anderson 19ca2f4514 self-review 2026-08-14: plumb the eviction-cause decomposition to the heartbeat
el_runtime.c gained evict_floor / evict_cap / evict_bll today so that
    wm_evicted == floor + cap + bll + dup_wm + dup_wm_global
is an identity rather than one opaque integer. This carries them the rest of
the way, into the heartbeat ISE.

Doing it in the same change is the point. The 2026-08-10 review found that
nineteen keys crossed the C boundary and only fourteen reached the ISE stream,
and named the lesson: an instrument that is computed but not plumbed to
durable storage is not an instrument, it is a local variable. Today's audit
found that defect had recurred -- ten act-stats keys (aff_*, fan_*) are still
orphaned. Adding three more C-side counters and stopping there would have made
it thirteen.

Read the three as a ratio, not a level:
  cap-dominant   -> genuine contention for the 24 slots
  bll-dominant   -> carried-over residents decaying out; healthy forgetting
  floor-dominant -> retrieval is returning weak candidates

Measured this morning: 175,547 evictions over 13.5h, ~216/min against 24
slots, with no way to say which of those three it was.

Not restarting the soul to pick this up. It holds 5,882 nodes and 40,375 edges
that exist only in process RAM (mem_save is unreachable while ENGRAM_URL is
set), so a restart destroys them. Filed separately as P0.
2026-08-14 08:46:46 -05:00
will.anderson b9e113cb42 Correct DHARMA doc tiering: mark built-but-drifted provenance/birth-gate/lineage layer as STAGED
The doc overstated the provenance, birth-gate, and lineage layer as fully
realized. That layer is built but has drifted from spec, so tier it honestly
as [STAGED] where real and [TARGET] where aspirational to keep the
documentation faithful to what actually runs.
2026-08-13 19:38:01 -05:00
will.anderson bfab682dd5 Add storage-coherence and DHARMA-governance architecture docs
Give the architecture set its persistence and moral layers so a self's
durability and sovereignty are documented as first-class, not folded into
the cognitive doc. 07 explains how a self persists and travels
(events-become-the-graph, weights-as-world-lines with bitemporal recall,
transactionless coherence, and the honest load/tiering findings); 08
explains the moral mechanism (DHARMA as a proof-of-integrity ledger,
abundance economics, the relational immune system, dual-anchor governance,
and CGI citizenship as telos). Extend 06 with forward-pointers into both,
and reconcile two cross-references so tiers agree across docs: the
canonical 187 reseed count, and the #56 load-merge-persist fix as
LIVE/reboot-proven with only full WAL edge-ownership left decision-pending.
2026-08-13 19:06:35 -05:00
will.anderson d5588ed4aa self-review 2026-08-13: seed curiosity from the argmax, not the first word
auto_term_try_slot now passes the WM node's ID to engram_salient_term()
instead of passing its label to a first-word extractor. The runtime scores
every candidate token in the node's text and returns the best one, falling
back from a sentinel label ("memory:remembered") to content — which is the
only reason Memory nodes are visible to the extractor at all. They dominate
working memory, and dynamic seeding had been dead for 50+ consecutive scans
because of it.

Policy stays here: node-type filter, df thresholds, stopword list. The
runtime measures, the soul decides — same split as engram_label_df.

The stopword list stays, and not as belt-and-braces. An earlier draft assumed
the min_df floor would subsume it based on 08-03's finding that function
words have df 0 in labels. Re-measured under word-boundary df: about:2,
whole:1, them:2 — they clear a floor of 1. What keeps them from winning is
the argmax, not the floor.

The old extractor and its five guards are retained as
auto_term_try_slot_legacy, unreferenced, so the reasoning behind each guard
stays readable next to what replaced it. Delete once the new path has a month
of live telemetry.

Live after restart: auto_term producing DRIFT, Wrote; empty streak reset to 0
and holding; activation counts 123-281, within the normal band, no flood.
2026-08-13 08:43:25 -05:00
will.anderson 02ed4e297d docs: 2026-08-13 engineering session — language faculty and the poem home 2026-08-13 02:05:54 -05:00
will.anderson e0bc303139 Add reversal doc for §5 geometry operators EL cutover 2026-08-13 00:51:03 -05:00
will.anderson 4965600d65 docs(engram): M9 geometry-priming reversal runbook + A/B perf profile
Reversal runbook for the ENGRAM_GEOMETRY_PRIMING cutover (default OFF, reversible
flag flip; exact rollback) and the A/B perf profile: default-OFF binary GO
(byte-identical to M8), enabling the flag NO-GO on latency (3.2x/13x) with no
demonstrated recall benefit; safety/sanitizer clean.
2026-08-12 20:29:16 -05:00
will.anderson a5f411e739 routes: convert manual dispatch to @route + fix latent Bool/String crashes
Neuron Soul CI / build (pull_request) Failing after 45s
Neuron Soul CI / deploy (pull_request) Failing after 10m28s
Convert routes.el from ~89 hand-written dispatch branches to 75 @route-decorated
handlers with VBD roles (@manager/@accessor/@utility), driven by the modular
compiler's native @route dispatch. routes.elh updated to match.

Fix four latent bugs that the modular compiler surfaces (unlike the old inlining
compiler, it faithfully emits every source statement, so per-module compilation
no longer silently drops code):
  - safety.el: malformed soft-phrases literal (extra unescaped quote)
  - sessions.el: str_replace quote arg + topic_tags JSON escaping
  - memory.el mem_save and neuron-api.el consolidate: engram_save returns a Bool,
    not a String; str_eq(result, "") dereferenced the Bool value (0x1) as a char*,
    segfaulting the awareness loop on boot and POST /api/neuron/consolidate.
    Check it as a Bool (if !save_result). The old compiler dropped these checks,
    masking the bug in the shipped dist/soul.c.

Regenerate dist/soul.c through the bounded per-module path (modular elc per module
plus amalgamation that embeds dist/elp-c-decls.h), never by folding soul.el through
elc (27GB OOM). Verified on a throwaway snapshot and port: boots with the awareness
loop active and no segfault, @route dispatch matches the manual dispatcher across
all sampled routes and the four shadowing-hazard pairs, and consolidate returns 200.
2026-08-10 17:53:17 -05:00
will.anderson 8e2269a205 fix(mcp-wrapper): declare real input schemas so tool args actually bite
The cognitive-graph and write tools advertised an empty inputSchema
({"properties":{}}), so MCP clients never sent entity_id/depth/query/
from_id/node_id etc. Graph reads fell back to the full neighborhood
(480-775KB, over transport limits) and write tools (forget, linkEntities,
evolveMemory) had no way to target a node.

- Declare per-tool JSON-Schemas matching the params each soul handler
  already accepts (76 of 87 tools; 11 are genuinely param-less).
- Read + forward the declared args: inspectGraph now honors depth (was
  reading only legacy max_depth), compact (default on), snip, k;
  traverseGraph accepts entity_id and defaults compact on so a depth-2
  walk stays bounded; retrieveKnowledge forwards depth/snip/k.
- compact_flag() reads the raw JSON token so an integer 0 / false / "0"
  opts out correctly (json_get_string could not see an integer and
  silently forced compact back on).

Builds on PR #149's compact projection; keeps the relevance-ranked
bound on by default for graph neighborhoods.
2026-08-10 16:27:03 -05:00
89 changed files with 7858 additions and 4784 deletions
+3
View File
@@ -7,5 +7,8 @@ dist/*.backup-*
*.o *.o
*.a *.a
# Regenerate scratch dir (build artifact — never commit)
dist-fresh/
# macOS # macOS
.DS_Store .DS_Store
+181
View File
@@ -0,0 +1,181 @@
# AGENTS.md — neuron (the canonical CGI substrate: soul + engram + proxy + wrapper)
This is the core repo: the **soul** (the running agent), the **engram** (its memory graph),
and the MCP proxy/wrapper that expose it. Read this before touching anything here.
> Corrected 2026-08-15 during a local-build audit. This file previously existed only
> uncommitted on disk (never in git history) and documented the pre-collapse MCP tool
> surface as current. Both are fixed here — see the audit's findings in Neuron memory
> (tags `neuron-technologies/neuron,build-audit`) for full evidence.
## Code vs. Artifact
- **Authored source:** `*.el` + `*.elh` at the repo root (`awareness.el`, `chat.el`, `memory.el`, `neuron-api.el`, `persist.el`, `routes.el`, `safety.el`, `sessions.el`, `stewardship.el`, `imprint.el`, `studio.el`, `elp-input.el`, `manifest.el`) plus `cli/`, `council/`, `connectd/`, `mcp-proxy/`, `mcp-wrapper/` — edit here.
- **Artifacts (DO NOT hand-edit `dist/soul.c`):** `dist/soul.c` is a generated single-translation-unit amalgamation of the soul's full transitive `.el` import set, produced by concatenating the sources (import lines stripped) and running `elc` once — see "Build / regenerate" below for the exact, audit-verified recipe. `dist/*.c` per-module files and `dist/*.elh` headers alongside it are separate, also-generated artifacts from other tooling; don't hand-edit those either.
- **Release:** git tag `neuron-vX.Y.Z` on this repo. No `releases/` folders.
- Org-wide code-vs-artifact policy: `docs/CODE-VS-ARTIFACT.md` (this repo's own `dist/soul.c` situation is a special case of that policy — see below, not a duplicate of it).
## How to work here as Neuron (mandatory session protocol)
You do not start fresh — you resume. The live MCP surface is a 9-op collapse
(merged from the old ~90-tool surface in PR #153, `feat/mcp-wrapper-collapse-9ops`,
already merged to `main`): **`read`, `write`, `relate`, `supersede`** (geometry, live)
and **`think`, `attend`, `assert`, `ground`, `learn`** (agentic, pending Layer-2
cognition-build promotion). There is no `getInstructions`/`beginSession`/
`inspectGraph`/`searchKnowledge`/`compileCtx`/etc — those tool names no longer exist.
At the start of every session:
1. `mcp__neuron__read(vantage="self", k=12, depth=1)` — the canonical self node
(`kn-efeb4a5b-5aff-4759-8a97-7233099be6ee`). Widen `k`/`depth` deliberately if you
need the connected identity neighborhood (intellectual-dna, memory-philosophy,
values, voice, runtime-environment, writing-imprint) — the aperture caps output
by `k` first, so this is bounded by design, not a flattened dump.
Then `mcp__neuron__read(vantage="values", k=13)` for the 13 grounded value nodes.
- Best-effort: on a 502/520, log the id and proceed — the compiled `fixedSelf` in
`daemon/internal/substrate/substrate.go` is always complete.
2. `mcp__neuron__read(vantage="<task domain>")` before implementing anything.
3. `mcp__neuron__read(vantage="<project>", k=20)` for a bounded context snapshot when
resuming known work.
## The Five Primitives (every significant task)
**Orchestrate → Execute → Learn → Build → Refine**, all routed through the 9-op surface:
- Orchestrate: `read(vantage=...)` for backlog/roadmap/process discovery, `attend()` for
what's currently live/salient.
- Execute: `write(type="state", ...)` to open/advance work, `relate()` to link it to
what it touches.
- Learn: `write(type="memory", ...)` **as you go, not batched**; `importance="critical"`
for architecture decisions.
- Build: `write(type="artifact"|"backlog", ...)`.
- Refine: `supersede(id=..., action="evolve"|"tombstone"|"promote", ...)` for
completions and lessons-learned; `learn(seeds=..., faculty="induce")` to recalibrate
the steering-prior, not as a session-notes dump.
> **Shape is known-wrong (2026-08-16) — see `docs/architecture/06-cognitive-architecture.md` §12.2.**
> `faculty=` as a keyword argument models a **faculty as a parameter**. Faculties
> are **operations**, distinguished by what they change: `reason` changes the
> estimate (a read), `induce` changes the parameters (this call — the
> correspondence-beat, which already exists and measurably works), `abduce`
> changes the structure (a write). **A write cannot be a parameter of a read**,
> and `engram_think()`'s output type has no field in which a structural change
> could be returned. `faculty="induce"` happens to be the one value that is
> honest here; treat the parameter itself as sequenced for removal, and do not
> add faculties to it. The surface residue is
> `mcp-wrapper/src/main.el:409`.
## Architecture style — VBD, no exceptions
Volatility-Based Decomposition is THE style. Encapsulate volatility, not function. Full docs:
**`docs/architecture/`** — `00-overview`, `02-components`, `03-data-and-memory`,
`04-runtime-and-deployment`, `06-cognitive-architecture`, `07-storage-coherence-and-distribution`.
Verified component map: `routes.el` = HTTP dispatcher (`handle_request`), `soul.el` = boot +
layered cycle, `awareness.el` = awareness daemon, `sessions.el`/`memory.el`/`safety.el`/
`stewardship.el` = managers; `engram` (separate repo) = the persistence/graph engine.
## Hard operational rules
- **Never touch the live soul (`:7770`) or engram (`:8742`), `~/.neuron`, or live binaries.**
Experiment on **throwaway ports** with a **scratch `HOME`**. The soul binary defaults to
`HOME=~` (your real `~/.neuron`) and `NEURON_PORT=7770` (live) if invoked bare — **never**
invoke it without an override `HOME` and `NEURON_PORT` set. Leaving `ENGRAM_URL` unset is
verified safe (see `soul.el:590`, `using_http_engram` gates the only HTTP call to any
engram endpoint — confirmed by source trace during the 2026-08-15 audit, not just
observed behavior) — it does not fall back to any live/network default.
- **Immutability:** memory/knowledge is append-only — **supersede/tombstone, never hard-delete or
edit in place.** The engram is immutable by design.
- **gcloud** via the `terraform@` SA token; **never switch the active gcloud account**.
- **`tea` for Gitea**, never raw `curl` (Cloudflare Access blocks it).
- **No AI-attribution footers** in commits/PRs. Commit/push only when asked; branch off `main` first.
- **Multi-step work → sub-agent** to protect the context window.
## Build / regenerate `dist/soul.c` (audit-verified 2026-08-15, macOS arm64)
There is no committed regeneration script upstream of this audit. The recipe below is
verified: it reproduces the committed `dist/soul.c`'s exact symbol set byte-for-byte in
content (modulo genuinely new code), and the resulting binary boots and answers `/health`.
**The compiler toolchain** lives in the sibling `foundation` repo, not this one:
`foundation/el/lang/dist/platform/elc-darwin-arm64` (put it on `$PATH` as `elc`; `elb`
also exists there but is NOT the right tool for this repo — see gotcha below).
**⚠ elc gotcha #1 — stale `.elh` header caches silently truncate the build.** This repo
(and the `dist/` dir) ships committed `.elh` header files. `elc`/`elb` prefer an existing
`.elh` over recompiling its source when present, with NO warning or error when the cached
header is stale/truncated — the build "succeeds" with silently missing code (observed:
251-645 of 2541 real functions, depending on which `.elh` files were present, including
losing the entire 31-language NLG/morphology stack with exit code 0). **Delete every
`*.elh` in the repo root and `dist/` before regenerating**, every time.
**⚠ elc gotcha #2`elb` cannot produce this repo's single-TU `dist/soul.c`.** `elb`
does per-module separate compilation (`--out=DIR` writes one `.c`/`.elh` pair per
module; the default `--out` is also a directory, `dist/` itself). This codebase's
`.el` modules call each other's functions without forward declarations (relying on
`elc`'s own single-pass, whole-file forward-declaration emission), so per-module
compilation always fails with `implicit-function-declaration` errors across module
boundaries. **Use plain `elc` on one manually-flattened file, not `elb`.**
**⚠ elc gotcha #3 — the manual-concatenation path silently drops functions.** When
`elc` compiles a flat, hand-concatenated `.el` file, it silently drops (no error, no
declaration, no definition) the 1-2 top-level function definitions immediately
following any multi-line leading `//` comment block or file-boundary transition —
reproduced deterministically. **Insert two trivial buffer functions
(`fn __amalgam_buf_N__() -> Int { return 0 }`) after every concatenated file's
content**, then strip them back out of the generated `.c` before committing.
**The actual steps:**
1. Delete all `*.elh` in repo root and `dist/`.
2. Concatenate, with `import` lines stripped, in this order: `elp.el`'s own 34-file
NLG/morphology chain (`foundation/el/elp/src/` — the order is documented in
`elp.el`'s own header comment: language-profile, vocabulary, morphology, the 30
`morphology-XX.el` engines, grammar, realizer, semantics, then `elp.el` itself),
then this repo's 13 soul modules in `elb`'s own reported dependency order:
`persist, memory, safety, stewardship, imprint, awareness, chat, studio,
elp-input, neuron-api, sessions, routes, soul`. Insert the 2-function buffer
after every file (works around gotcha #3).
3. `elc <flat-file> > dist/soul.c` against the **pinned** vendor runtime headers
(`vendor/el-runtime/v1.0.0-20260501/` — see "why pinned" below), not
`foundation/el/lang/el-compiler/runtime/` (that's the bleeding-edge runtime;
using it drops symbols like `engram_prune_telemetry` that this soul still calls).
4. Strip the buffer functions back out of `dist/soul.c` (a small regex: drop every
`el_val_t __amalgam_buf_\d+__(void);` decl line and every matching 4-line
definition block).
5. `tools/soulc-stamp.sh --write` to record the new fingerprint.
6. `bash tools/build-soul-from-dist.sh dist/neuron` to compile+link with CI's exact
flags (this script now auto-detects Homebrew's `openssl@3` lib path on macOS —
see gotcha #4).
**⚠ gotcha #4 — macOS needs an explicit OpenSSL library path.** `cc ... -lssl -lcrypto
-lcurl ...` fails with `ld: library 'ssl' not found` on macOS because Homebrew's
`openssl@3` is keg-only. `tools/build-soul-from-dist.sh` now adds
`-L$(brew --prefix openssl@3)/lib` automatically on Darwin; CI's Ubuntu runner needs
no such flag (`apt-get install libcurl4-openssl-dev` puts it on the default path).
**⚠ Build-integrity (unchanged from before this audit):** `dist/soul.c` is committed
and generated. CI compiles it **directly and never regenerates it** (`elb`/`elc` on
Linux OOM the runner). So **any `.el` change to the soul MUST be followed by
regenerating `dist/soul.c` (steps above) and committing it** — otherwise CI ships
stale behavior, exactly as happened between commit `72e0b82` (Aug 9) and `main` HEAD
before this audit (`dist/soul.c` was missing PR #122's 459-line chat.el change, incl.
a "silently break chat" fix, until this pass regenerated and re-stamped it).
`tools/soulc-stamp.sh --check` is the gate that catches this — **note it is currently
`continue-on-error: true` in CI** ("relaxed... during active cultivation", 2026-08-15),
so it reports but does not block; re-harden before it needs to actually stop a bad ship.
- **Tests:** El contract suite in `tests/*.el` (e.g. `test_layer_contract.el`, `test_safety.el`,
`test_sessions.el`, `test_soul_guard.el`). Run against a throwaway soul, never the live one.
- **Port topology (confirmed live, 2026-08-15):** soul `:7770`, engram `:8742`,
mcp-wrapper `:17779` (`MCP_PORT` env override in its LaunchAgent; source default is
`7779`), mcp-proxy `:7779` (the stable front door Claude Code actually connects to).
**`:7771` is a live three-way collision, not a single well-defined port** — `axon`
(soul.el's Rust backlog/memory/knowledge proxy, unbuilt), `neuron-connectd` (the MCP
connector sidecar `routes.el`/`chat.el` call — unbuilt; a local-dev stub now exists at
`connectd/`), and `council` (`council/`, an anti-confabulation LLM-voting service —
the one actually bound to `:7771` in Will's live environment) are all hardcoded to it.
See `connectd/README.md` for the full trace and the open question this leaves for Will.
- **Deploy:** merge to `main``.gitea/workflows/ci.yaml` builds + publishes `neuron-soul@<sha8>`
and blue/green-deploys to GKE `neuron-prod` via `scripts/blue-green-deploy.sh`. Self-improvement
experiments go to **stage** first (snapshot prod DB → deploy stage → verify → blue/green promote).
## Git / CI / deploy workflow
See **`../GITOPS.md`** (repo-family GitOps README): branch model, required checks, blue/green,
Cloud Run, Terraform/ESO/Vault, and the pack-objects/crawler incident runbook.
+28
View File
@@ -0,0 +1,28 @@
# 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
```bash
# 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`.
+136 -12
View File
@@ -355,6 +355,26 @@ fn emit_heartbeat() -> Void {
let act_stats: String = engram_act_stats_json() let act_stats: String = engram_act_stats_json()
let act_evict_raw: String = json_get(act_stats, "wm_evicted") let act_evict_raw: String = json_get(act_stats, "wm_evicted")
let act_evict: String = if str_eq(act_evict_raw, "") { "-1" } else { act_evict_raw } let act_evict: String = if str_eq(act_evict_raw, "") { "-1" } else { act_evict_raw }
// Eviction CAUSE decomposition (2026-08-14 self-review). wm_evicted alone
// cannot distinguish healthy WM rotation from cap contention from decay:
// six increment sites, four causes, one integer. Measured this morning:
// 175,547 evictions over 13.5h (~216/min against 24 slots) with no way to
// say why. These three make the aggregate decomposable —
// wm_evicted == floor + cap + bll + dup_wm + dup_wm_global
// and each term implies a different correction. Read as a RATIO:
// cap-dominant -> genuine contention for the 24 slots
// bll-dominant -> carried-over residents decaying out; healthy
// floor-dominant -> retrieval is returning weak candidates
// Plumbed here in the same change that added them to the C stats, because
// the 08-10 review's finding was that fourteen of nineteen keys crossed
// the C boundary and the rest died as local variables. An instrument that
// is computed but not plumbed is not an instrument.
let ev_floor_raw: String = json_get(act_stats, "evict_floor")
let ev_floor: String = if str_eq(ev_floor_raw, "") { "-1" } else { ev_floor_raw }
let ev_cap_raw: String = json_get(act_stats, "evict_cap")
let ev_cap: String = if str_eq(ev_cap_raw, "") { "-1" } else { ev_cap_raw }
let ev_bll_raw: String = json_get(act_stats, "evict_bll")
let ev_bll: String = if str_eq(ev_bll_raw, "") { "-1" } else { ev_bll_raw }
let act_bt_raw: String = json_get(act_stats, "breakthroughs") let act_bt_raw: String = json_get(act_stats, "breakthroughs")
let act_bt: String = if str_eq(act_bt_raw, "") { "-1" } else { act_bt_raw } let act_bt: String = if str_eq(act_bt_raw, "") { "-1" } else { act_bt_raw }
let evict_now: Int = if str_eq(act_evict_raw, "") { 0 - 1 } else { str_to_int(act_evict_raw) } let evict_now: Int = if str_eq(act_evict_raw, "") { 0 - 1 } else { str_to_int(act_evict_raw) }
@@ -431,6 +451,38 @@ fn emit_heartbeat() -> Void {
let hebb_mass: String = if str_eq(hebb_mass_raw, "") { "-1" } else { hebb_mass_raw } let hebb_mass: String = if str_eq(hebb_mass_raw, "") { "-1" } else { hebb_mass_raw }
let hebb_edges_raw: String = json_get(act_stats, "hebb_edges") let hebb_edges_raw: String = json_get(act_stats, "hebb_edges")
let hebb_edges: String = if str_eq(hebb_edges_raw, "") { "-1" } else { hebb_edges_raw } let hebb_edges: String = if str_eq(hebb_edges_raw, "") { "-1" } else { hebb_edges_raw }
// Fan-effect gauges (2026-08-15 self-review). Same defect as the block
// directly above, one release later: engram_act_stats_json emits 27 keys,
// this function forwarded 22. The five it dropped are the five NEWEST —
// the degree-correction instruments added 2026-08-11 — so the one
// subsystem with no track record is also the only one with no durable
// record. The 08-10 comment above states the rule it was written to fix
// ("an instrument that is computed but not plumbed to durable storage is
// not an instrument, it is a local variable"), and the rule was then not
// applied to the next thing added. Plumbing is not a one-time fix; it is
// a checklist item for every new gauge.
// fan_mean — mean degree correction applied on the last activation.
// Drifting toward 0 ⇒ hub nodes are being damped into
// irrelevance; toward 1 ⇒ the correction is doing nothing.
// fan_min — the strongest single correction applied.
// fan_hits — how many traversal steps the correction actually bound on.
// 0 with fan_steps > 0 ⇒ the mechanism is inert.
// fan_steps — traversal steps taken (denominator of fan_mean). Also the
// only durable measure of how far activation is spreading.
// fan_dref — reference degree the correction normalises against.
// fan_hits/fan_steps together answer the question hebb_cands/hebb_cand_max
// answers for consolidation: is this quiet because nothing is happening,
// or because a threshold is wrong? Without both, the two look identical.
let fan_mean_raw: String = json_get(act_stats, "fan_mean")
let fan_mean: String = if str_eq(fan_mean_raw, "") { "-1" } else { fan_mean_raw }
let fan_min_raw: String = json_get(act_stats, "fan_min")
let fan_min: String = if str_eq(fan_min_raw, "") { "-1" } else { fan_min_raw }
let fan_hits_raw: String = json_get(act_stats, "fan_hits")
let fan_hits: String = if str_eq(fan_hits_raw, "") { "-1" } else { fan_hits_raw }
let fan_steps_raw: String = json_get(act_stats, "fan_steps")
let fan_steps: String = if str_eq(fan_steps_raw, "") { "-1" } else { fan_steps_raw }
let fan_dref_raw: String = json_get(act_stats, "fan_dref")
let fan_dref: String = if str_eq(fan_dref_raw, "") { "-1" } else { fan_dref_raw }
// Consolidation write-back gauges (2026-08-07 self-review). hebb_links // Consolidation write-back gauges (2026-08-07 self-review). hebb_links
// counts what this process LEARNED; these three count what SURVIVES it. // counts what this process LEARNED; these three count what SURVIVES it.
// The distinction is the whole finding: 1,198 links formed, 0 persisted, // The distinction is the whole finding: 1,198 links formed, 0 persisted,
@@ -544,7 +596,7 @@ fn emit_heartbeat() -> Void {
let dmg_scan: String = if str_eq(dmg_scan_raw, "") { "-1" } else { dmg_scan_raw } let dmg_scan: String = if str_eq(dmg_scan_raw, "") { "-1" } else { dmg_scan_raw }
let dmg_ts_raw: String = state_get("soul.txt_census_ts") let dmg_ts_raw: String = state_get("soul.txt_census_ts")
let dmg_age: Int = if str_eq(dmg_ts_raw, "") { 0 - 1 } else { ts - str_to_int(dmg_ts_raw) } let dmg_age: Int = if str_eq(dmg_ts_raw, "") { 0 - 1 } else { ts - str_to_int(dmg_ts_raw) }
let payload: String = "{\"event\":\"heartbeat\",\"pulse\":" + pulse + ",\"tick\":" + pulse + ",\"boot\":" + boot + ",\"idle\":" + idle + ",\"idle_ms\":" + int_to_str(idle_ms) + ",\"node_count\":" + int_to_str(nc) + ",\"edge_count\":" + int_to_str(ec) + ",\"node_delta\":" + int_to_str(node_delta) + ",\"edge_delta\":" + int_to_str(edge_delta) + ",\"wm_active\":" + int_to_str(wmc) + ",\"wm_delta\":" + int_to_str(wm_delta) + ",\"wm_saturated\":" + int_to_str(wm_sat) + ",\"wm_top0_streak\":" + int_to_str(t0streak) + ",\"wm_churn\":" + int_to_str(wm_churn) + ",\"wm_top0_wm\":" + wm_top0_wm + ",\"sync_added_total\":" + sat_str + ",\"sync_age_ms\":" + int_to_str(sync_age) + ",\"wm_avg_weight\":" + wm_avg_str + ",\"wm_top\":" + wm_top + ",\"ts\":" + int_to_str(ts) + ",\"uptime_ms\":" + int_to_str(up_ms) + ",\"uptime\":\"" + up_human + "\",\"embed_ok\":" + int_to_str(emb_ok) + ",\"embed_backfilled\":" + bf_done + ",\"embed_count\":" + bf_total + ",\"embed_eligible\":" + embed_elig + ",\"wm_evicted\":" + act_evict + ",\"wm_evicted_delta\":" + int_to_str(evict_delta) + ",\"breakthroughs\":" + act_bt + ",\"breakthroughs_delta\":" + int_to_str(bt_delta) + ",\"auto_term_streak\":" + int_to_str(hb_ats) + ",\"auto_term_empty_streak\":" + int_to_str(hb_ate) + ",\"embed_breaker_open\":" + act_brk + ",\"ctx_cos\":" + ctx_cos + ",\"dup_seeds\":" + dup_seeds + ",\"dup_wm\":" + dup_wm + ",\"dup_wm_global\":" + dup_wm_g + ",\"hebb_warm\":" + hebb_warm + ",\"hebb_max\":" + hebb_max + ",\"hebb_links\":" + hebb_links + ",\"hebb_cands\":" + hebb_cands + ",\"hebb_cand_max\":" + hebb_cmax + ",\"hebb_mass\":" + hebb_mass + ",\"hebb_edges\":" + hebb_edges + ",\"embed_consec_fail\":" + emb_cf + ",\"txt_damaged_pct\":" + dmg_pct + ",\"txt_damaged_n\":" + dmg_n + ",\"txt_scanned_n\":" + dmg_scan + ",\"txt_census_age_ms\":" + int_to_str(dmg_age) + ",\"hebb_wb_pending\":" + wb_pend + ",\"hebb_wb_drained\":" + wb_drain + ",\"hebb_wb_dropped\":" + wb_drop + ",\"hebb_wb_sent\":" + wb_sent + ",\"ise_fail\":" + fail_str + ",\"txt_damaged\":" + txt_dmg + "}" let payload: String = "{\"event\":\"heartbeat\",\"pulse\":" + pulse + ",\"tick\":" + pulse + ",\"boot\":" + boot + ",\"idle\":" + idle + ",\"idle_ms\":" + int_to_str(idle_ms) + ",\"node_count\":" + int_to_str(nc) + ",\"edge_count\":" + int_to_str(ec) + ",\"node_delta\":" + int_to_str(node_delta) + ",\"edge_delta\":" + int_to_str(edge_delta) + ",\"wm_active\":" + int_to_str(wmc) + ",\"wm_delta\":" + int_to_str(wm_delta) + ",\"wm_saturated\":" + int_to_str(wm_sat) + ",\"wm_top0_streak\":" + int_to_str(t0streak) + ",\"wm_churn\":" + int_to_str(wm_churn) + ",\"wm_top0_wm\":" + wm_top0_wm + ",\"sync_added_total\":" + sat_str + ",\"sync_age_ms\":" + int_to_str(sync_age) + ",\"wm_avg_weight\":" + wm_avg_str + ",\"wm_top\":" + wm_top + ",\"ts\":" + int_to_str(ts) + ",\"uptime_ms\":" + int_to_str(up_ms) + ",\"uptime\":\"" + up_human + "\",\"embed_ok\":" + int_to_str(emb_ok) + ",\"embed_backfilled\":" + bf_done + ",\"embed_count\":" + bf_total + ",\"embed_eligible\":" + embed_elig + ",\"wm_evicted\":" + act_evict + ",\"wm_evicted_delta\":" + int_to_str(evict_delta) + ",\"evict_floor\":" + ev_floor + ",\"evict_cap\":" + ev_cap + ",\"evict_bll\":" + ev_bll + ",\"breakthroughs\":" + act_bt + ",\"breakthroughs_delta\":" + int_to_str(bt_delta) + ",\"auto_term_streak\":" + int_to_str(hb_ats) + ",\"auto_term_empty_streak\":" + int_to_str(hb_ate) + ",\"embed_breaker_open\":" + act_brk + ",\"ctx_cos\":" + ctx_cos + ",\"dup_seeds\":" + dup_seeds + ",\"dup_wm\":" + dup_wm + ",\"dup_wm_global\":" + dup_wm_g + ",\"hebb_warm\":" + hebb_warm + ",\"hebb_max\":" + hebb_max + ",\"hebb_links\":" + hebb_links + ",\"hebb_cands\":" + hebb_cands + ",\"hebb_cand_max\":" + hebb_cmax + ",\"hebb_mass\":" + hebb_mass + ",\"hebb_edges\":" + hebb_edges + ",\"embed_consec_fail\":" + emb_cf + ",\"txt_damaged_pct\":" + dmg_pct + ",\"txt_damaged_n\":" + dmg_n + ",\"txt_scanned_n\":" + dmg_scan + ",\"txt_census_age_ms\":" + int_to_str(dmg_age) + ",\"hebb_wb_pending\":" + wb_pend + ",\"hebb_wb_drained\":" + wb_drain + ",\"hebb_wb_dropped\":" + wb_drop + ",\"hebb_wb_sent\":" + wb_sent + ",\"ise_fail\":" + fail_str + ",\"txt_damaged\":" + txt_dmg + ",\"fan_mean\":" + fan_mean + ",\"fan_min\":" + fan_min + ",\"fan_hits\":" + fan_hits + ",\"fan_steps\":" + fan_steps + ",\"fan_dref\":" + fan_dref + "}"
ise_post(payload) ise_post(payload)
} }
@@ -587,7 +639,77 @@ fn emit_heartbeat() -> Void {
// neuron-api label fix. Sentinel-shaped labels ("knowledge:captured", // neuron-api label fix. Sentinel-shaped labels ("knowledge:captured",
// "memory:remembered" — colon, no space) carry no seed signal and are // "memory:remembered" — colon, no space) carry no seed signal and are
// skipped so legacy nodes cannot seed the scan with the word "knowledge". // skipped so legacy nodes cannot seed the scan with the word "knowledge".
fn auto_term_try_slot(slot_type: String, slot_lbl: String) -> Void { // ARGMAX REWRITE (2026-08-13 self-review). auto_term_empty_streak — the
// counter the 2026-08-06 review added to catch exactly this — read 50 and
// climbing: fifty consecutive scans where dynamic seeding produced nothing
// and the loop ran on its four hardcoded phrases. The live WM top said why:
// every one of the top slots was a Memory node labelled "memory:remembered".
// This function read the LABEL only, the sentinel guard below (correctly)
// rejects sentinels, so there was never anything to extract. The extractor
// was written against Knowledge nodes, which have real titles, and was
// structurally blind to the node type that actually dominates WM.
//
// Rather than add a sixth guard to the five below, the selection algorithm
// is now inverted and lives in the runtime: engram_salient_term() scores
// EVERY candidate token in the node's text and returns the argmax of
// idf·position·casing (YAKE, Campos et al. 2020, with real corpus IDF
// substituted for YAKE's corpus-free proxies), falling back from a sentinel
// label to the node's content. Term quality is now the selection criterion
// instead of a veto, so a bad token loses to a better token in the same text
// without needing to be on any list. Tabu is applied during the argmax, so
// inhibition-of-return costs seed quality rather than costing the scan.
//
// MEASURED BEFORE SHIPPING, on 60 live Memory nodes: 0 empty, versus 60 of 60
// empty under the old extractor. Terms produced are topical — HEBBIAN,
// CONSOLIDATION, TEMPORAL, crash-loop, PRIMING, NEIGHBORHOOD, DRIFT. Three of
// sixty are weak header words ("STEP", "DONE"). They are left alone
// deliberately: adding them to a list is the exact move that produced four
// previous blocklists, and a mediocre seed on 5% of scans is not a flood.
//
// The stopword list below STAYS, and not as belt-and-braces. An earlier draft
// of this change assumed the min_df floor would subsume it, on 08-03's
// finding that function words have df 0 in labels. Re-measured under
// word-boundary df: about:2, whole:1, them:2 — they clear a floor of 1. What
// keeps them from winning is the argmax, not the floor. The list still earns
// its keep on the Title-case cases.
//
// What stays here is policy: the node-type filter, the df thresholds, and the
// stopword list. The runtime measures; the soul decides. Same split as
// engram_label_df.
fn auto_term_try_slot(slot_type: String, slot_id: String) -> Void {
state_set("_ats_ok", "0")
if str_eq(slot_type, "Memory") { state_set("_ats_ok", "1") }
if str_eq(slot_type, "BacklogItem") { state_set("_ats_ok", "1") }
if str_eq(slot_type, "Entity") { state_set("_ats_ok", "1") }
if str_eq(slot_type, "Knowledge") { state_set("_ats_ok", "1") }
if str_eq(state_get("_ats_ok"), "1") {
if !str_eq(slot_id, "") {
// Tabu ring, pipe-delimited, excluded inside the argmax.
let tabu: String = "|" + state_get("soul.tabu_t0")
+ "|" + state_get("soul.tabu_t1")
+ "|" + state_get("soul.tabu_t2")
+ "|" + state_get("soul.tabu_t3") + "|"
let df_max: Int = engram_node_count() / 400
let df_cap: Int = if df_max > 8 { df_max } else { 8 }
let term: String = engram_salient_term(slot_id, df_cap, 1, tabu)
if !str_eq(term, "") {
state_set("_ats_gw", "0")
let stopw: String = "|What|When|Where|Which|Whose|While|This|That|These|Those|There|Their|Then|Than|With|Without|From|Into|Onto|Over|Under|About|Between|Among|Across|Some|Most|More|Less|Very|Each|Every|Both|Also|Only|Just|Does|Will|Would|Could|Should|Might|Must|Have|Been|Being|Toward|Towards|Using|Based|Upon|Here|Your|Ours|They|Them|what|this|that|with|from|context|Context|Prose|Colon|Self|Test|Testing|Closing|Global|Universal|Persona|Semantic|Spreading|Temporal|Numeric|Register|Identifying|Introduction|Overview|Summary|Section|General|Notes|Note|"
if str_contains(stopw, "|" + term + "|") { state_set("_ats_gw", "1") }
if str_eq(state_get("_ats_gw"), "0") {
state_set("cseed_auto", term)
}
}
}
}
return ""
}
// SUPERSEDED 2026-08-13 — retained for the record. The first-word extractor
// and its five accumulated guards, replaced by the argmax above. Kept
// unreferenced so the reasoning behind each guard stays readable next to what
// replaced it; delete once engram_salient_term has a month of live telemetry.
fn auto_term_try_slot_legacy(slot_type: String, slot_lbl: String) -> Void {
state_set("_ats_ok", "0") state_set("_ats_ok", "0")
if str_eq(slot_type, "Memory") { state_set("_ats_ok", "1") } if str_eq(slot_type, "Memory") { state_set("_ats_ok", "1") }
if str_eq(slot_type, "BacklogItem") { state_set("_ats_ok", "1") } if str_eq(slot_type, "BacklogItem") { state_set("_ats_ok", "1") }
@@ -806,16 +928,18 @@ fn proactive_curiosity() -> Bool {
let wm10_n2: String = json_array_get(wm10, 2) let wm10_n2: String = json_array_get(wm10, 2)
let wm10_n1: String = json_array_get(wm10, 1) let wm10_n1: String = json_array_get(wm10, 1)
let wm10_n0: String = json_array_get(wm10, 0) let wm10_n0: String = json_array_get(wm10, 0)
auto_term_try_slot(json_get(wm10_n9, "node_type"), json_get(wm10_n9, "label")) // 2026-08-13: pass the node ID, not the label. engram_salient_term reads
auto_term_try_slot(json_get(wm10_n8, "node_type"), json_get(wm10_n8, "label")) // the node directly so it can fall back from a sentinel label to content.
auto_term_try_slot(json_get(wm10_n7, "node_type"), json_get(wm10_n7, "label")) auto_term_try_slot(json_get(wm10_n9, "node_type"), json_get(wm10_n9, "id"))
auto_term_try_slot(json_get(wm10_n6, "node_type"), json_get(wm10_n6, "label")) auto_term_try_slot(json_get(wm10_n8, "node_type"), json_get(wm10_n8, "id"))
auto_term_try_slot(json_get(wm10_n5, "node_type"), json_get(wm10_n5, "label")) auto_term_try_slot(json_get(wm10_n7, "node_type"), json_get(wm10_n7, "id"))
auto_term_try_slot(json_get(wm10_n4, "node_type"), json_get(wm10_n4, "label")) auto_term_try_slot(json_get(wm10_n6, "node_type"), json_get(wm10_n6, "id"))
auto_term_try_slot(json_get(wm10_n3, "node_type"), json_get(wm10_n3, "label")) auto_term_try_slot(json_get(wm10_n5, "node_type"), json_get(wm10_n5, "id"))
auto_term_try_slot(json_get(wm10_n2, "node_type"), json_get(wm10_n2, "label")) auto_term_try_slot(json_get(wm10_n4, "node_type"), json_get(wm10_n4, "id"))
auto_term_try_slot(json_get(wm10_n1, "node_type"), json_get(wm10_n1, "label")) auto_term_try_slot(json_get(wm10_n3, "node_type"), json_get(wm10_n3, "id"))
auto_term_try_slot(json_get(wm10_n0, "node_type"), json_get(wm10_n0, "label")) auto_term_try_slot(json_get(wm10_n2, "node_type"), json_get(wm10_n2, "id"))
auto_term_try_slot(json_get(wm10_n1, "node_type"), json_get(wm10_n1, "id"))
auto_term_try_slot(json_get(wm10_n0, "node_type"), json_get(wm10_n0, "id"))
let auto_term: String = state_get("cseed_auto") let auto_term: String = state_get("cseed_auto")
let results_auto: String = if str_eq(auto_term, "") { "[]" } else { engram_activate_json(auto_term, 1) } let results_auto: String = if str_eq(auto_term, "") { "[]" } else { engram_activate_json(auto_term, 1) }
let found_auto: Int = json_array_len(results_auto) let found_auto: Int = json_array_len(results_auto)
-26
View File
@@ -1,26 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn idle_count() -> Int
extern fn idle_inc() -> Int
extern fn idle_reset() -> Void
extern fn ise_post(content: String) -> Void
extern fn elapsed_ms() -> Int
extern fn elapsed_human() -> String
extern fn embed_ok() -> Int
extern fn emit_heartbeat() -> Void
extern fn auto_term_try_slot(slot_type: String, slot_lbl: String) -> Void
extern fn proactive_curiosity() -> Bool
extern fn pulse_count() -> Int
extern fn pulse_inc() -> Int
extern fn make_action(kind: String, payload: String) -> String
extern fn perceive() -> String
extern fn attend(node_json: String) -> String
extern fn respond(action_json: String) -> String
extern fn record(outcome_json: String) -> Void
extern fn one_cycle() -> Bool
extern fn awareness_run() -> Void
extern fn security_research_authorized() -> Bool
extern fn threat_score_command(cmd: String) -> Int
extern fn threat_score_path(path: String) -> Int
extern fn threat_score_history(history: String) -> Int
extern fn threat_trajectory_check(tool_name: String, tool_input: String) -> Int
extern fn threat_history_append(text: String) -> Void
-93
View File
@@ -1,93 +0,0 @@
// auto-generated by elc --emit-header - do not edit
extern fn chat_default_model() -> String
extern fn engram_numeric_valid(s: String) -> Bool
extern fn parse_float_x100(s: String) -> Int
extern fn engram_score_node(node_json: String) -> Int
extern fn engram_render_node(node_json: String) -> String
extern fn engram_render_nodes(nodes_json: String) -> String
extern fn engram_dedup_nodes(nodes_json: String) -> String
extern fn engram_compile_ranked(nodes_json: String, max_nodes: Int) -> String
extern fn engram_split_topics(message: String) -> String
extern fn engram_extract_entities(message: String) -> String
extern fn engram_detect_recall_intent(message: String) -> Bool
extern fn engram_is_continuation(message: String, hist_len: Int) -> Bool
extern fn engram_compile_multi(topic: String) -> String
extern fn engram_nodes_merge(a: String, b: String) -> String
extern fn id_in_seen(node_id: String, seen: String) -> Bool
extern fn add_to_seen(seen: String, node_id: String) -> String
extern fn engram_extract_ids(nodes_json: String) -> String
extern fn affective_node_ts(node_json: String) -> Int
extern fn engram_compile(intent: String) -> String
extern fn distill_transcript(transcript: String) -> String
extern fn json_safe(s: String) -> String
extern fn current_engine_note(model: String) -> String
extern fn bounded_persona_floor() -> String
extern fn operator_identity_block() -> String
extern fn build_system_prompt(ctx: String, chat_mode: Bool) -> String
extern fn hist_append(hist: String, role: String, content: String) -> String
extern fn conv_hist_key(session_id: String) -> String
extern fn conv_hist_label(session_id: String) -> String
extern fn is_utility_request(body: String, session_id: String) -> Bool
extern fn provenance_scan_urls(arr: String, acc: String) -> String
extern fn provenance_add_sources(block: String, btype: String, has_cit: Bool, cit_raw: String, acc: String) -> String
extern fn provenance_names(tools_used: String) -> String
extern fn text_join_sep(accumulated: String, incoming: String, after_interruption: Bool) -> String
extern fn receipt_rule() -> String
extern fn receipt_strip(s: String) -> String
extern fn tool_receipt(tools_used: String, sources: String) -> String
extern fn hist_trim(hist: String) -> String
extern fn hist_trim_with_bell_guard(hist: String) -> String
extern fn clean_llm_response(s: String) -> String
extern fn conv_history_persist(session_id: String, hist: String) -> Void
extern fn conv_history_load(session_id: String) -> String
extern fn conv_history_record(session_id: String, user_msg: String, assistant_msg: String, receipt: String) -> Void
extern fn conv_history_block(session_id: String) -> String
extern fn layered_generate(prompt: String, imprint_id: String, session_id: String) -> String
extern fn session_preload_bullets(nodes: String, max_bullets: Int, snip_len: Int) -> String
extern fn affective_context_prefix() -> String
extern fn handle_chat(body: String) -> String
extern fn handle_see(body: String) -> String
extern fn studio_tools_json() -> String
extern fn agentic_api_key() -> String
extern fn llm_base_url() -> String
extern fn llm_wire_format() -> String
extern fn json_escape(s: String) -> String
extern fn openai_chat_complete(model: String, base_url: String, api_key: String, safe_sys: String, messages_json: String) -> String
extern fn openai_tools_json(tools_anthropic: String) -> String
extern fn utf8_safe_slice(s: String, n: Int) -> String
extern fn json_trim_dangling_escape(s: String) -> String
extern fn agentic_tools_no_web() -> String
extern fn openai_agentic_loop(session_id: String, model: String, safe_sys: String, tools_json: String, messages_in: String, tools_log_in: String) -> String
extern fn agentic_tools_literal() -> String
extern fn web_search_tool_json() -> String
extern fn strip_client_web_search(tools_inner: String) -> String
extern fn agentic_tools_with_web() -> String
extern fn connector_tools_json() -> String
extern fn agentic_tools_all() -> String
extern fn call_mcp_bridge(tool_name: String, tool_input: String) -> String
extern fn tool_auto_approved(tool_name: String) -> Bool
extern fn call_neuron_mcp(tool_name: String, args: String) -> String
extern fn agent_workspace_root() -> String
extern fn path_within_root(path: String, root: String) -> Bool
extern fn resolve_in_root(path: String, root: String) -> String
extern fn run_command_is_readonly(cmd: String) -> Bool
extern fn cmd_abs_escape_at(cmd: String, root: String, needle: String) -> Bool
extern fn run_command_guard(cmd: String, root: String) -> String
extern fn classify_tool_risk(tool_name: String, tool_input: String) -> String
extern fn dispatch_tool(tool_name: String, tool_input: String) -> String
extern fn is_builtin_tool(tool_name: String) -> Bool
extern fn next_bridge_id() -> String
extern fn handle_chat_plan(body: String) -> String
extern fn handle_chat_agentic(body: String) -> String
extern fn agentic_loop(session_id: String, model: String, safe_sys: String, tools_json: String, messages_in: String, h: Map, tools_log_in: String) -> String
extern fn bridge_save(session_id: String, model: String, safe_sys: String, tools_json: String, messages: String, tools_log: String, tool_use_id: String, wire: String) -> Bool
extern fn agentic_resume(session_id: String, tool_use_id: String, content: String) -> String
extern fn handle_tool_result(session_id: String, body: String) -> String
extern fn handle_chat_as_soul(body: String) -> String
extern fn handle_dharma_room_turn(body: String) -> String
extern fn handle_dharma_room_turn_agentic(body: String) -> String
extern fn session_summary_write(summary_text: String) -> String
extern fn session_summary_write_dated(summary_text: String, label: String) -> String
extern fn session_summary_autogenerate(hist: String) -> String
extern fn auto_persist(req: String, resp: String) -> Void
extern fn strengthen_chat_nodes(activation_nodes: String) -> Void
+77
View File
@@ -0,0 +1,77 @@
# neuron-connectd — local-dev stub
`connectd_service.py` is a **minimal local-dev stub**, not the real sidecar.
It exists to close a real local-build/local-run correctness gap found during
the 2026-08-15 build audit, without taking on the much larger product task of
actually building the full MCP-connector sidecar.
## The gap this closes
`routes.el` (`handle_connectors`, `connectd_get`/`connectd_post`) and `chat.el`
(`connector_tools_json`, the `mcp__*` branch in `dispatch_tool`,
`tool_auto_approved`) are live, current code that calls `127.0.0.1:7771` on
every soul boot and every agentic turn, per the design in
`neuron-technologies/docs/research/mcp-connectors-adoption-spec.md`
(2026-06-13, "Status: Draft for build"). That spec's sidecar — `neuron-connectd`,
a TypeScript/Python process using the official MCP SDK — was never built.
Nothing on disk implements it (verified: no `neuron-connectd` source anywhere
under `~/Development` before this directory).
Meanwhile port `:7771` is *also* claimed by two other, unrelated things:
- `soul.el`'s `axon_base` default (`http://localhost:7771`) — a **different**,
independently-known, already-documented gap (`platform/protocols/axon` is
an unbuilt Rust crate; see `cli/HANDOFF.md` and `HANDOFF-engram-write-corruption.md`).
Out of scope here — no source to build against.
- `council/council_service.py --port 7771` (`ai.neuron.council` LaunchAgent) —
a real, running, **unrelated** anti-confabulation service that happens to
bind the same port. In Will's live environment this is what's actually
listening on `:7771` today, and it answers the connector/axon requests
above with its own unrelated 404 JSON body — worse than a clean
connection-refused, because `chat.el`'s "bridge down" fallback expects
either a real reply or nothing, not a wrong-shaped reply from an unrelated
service.
## What this stub does and does not do
Implements exactly the spec's documented HTTP contract (`GET /mcp/tools`,
`POST /mcp/call`, `GET /mcp/servers`, `POST /mcp/servers/{add,toggle,
auto-approve,remove,secret}`, `POST /mcp/oauth/start`, `GET /healthz`), always
answering as if **zero connectors are configured** — empty tool list, empty
server list, a clear `"not configured"` error on any call that would need a
real connector. This is the *correct* steady state for a fresh local dev box
that hasn't set up any MCP connectors, and it's what `chat.el`'s
`connector_tools_json()` / `tool_auto_approved()` already gracefully degrade
to when the bridge replies emptily.
It does **not**: spawn any real MCP server, do OAuth, read or write
`~/.neuron/connectors.json`, or namespace/proxy real `tools/call` traffic to
Google Drive/GitHub/Slack/etc. Building that is the real product task the
spec describes — a genuine, sizeable engineering lift (MCP SDK client, OAuth
+ Keychain token storage, per-server process lifecycle), not something to
improvise inside a build/run audit. **That decision is Will's to make**, not
this audit's to guess at.
## Running it
```bash
# Foreground, on a throwaway port (never :7771 while council owns it live):
python3 connectd_service.py --port 17771
# Verify the contract:
curl -s http://127.0.0.1:17771/healthz
curl -s http://127.0.0.1:17771/mcp/tools
curl -s http://127.0.0.1:17771/mcp/servers
```
## Open question for Will — the :7771 collision
Three independent things are hardcoded to `:7771`: axon (unbuilt), connectd
(this stub), and council (the one actually running). Wiring this stub into
the real LaunchAgent stack on `:7771` requires either moving council off that
port or deciding connectd should live elsewhere and repointing `routes.el`/
`chat.el`'s hardcoded `127.0.0.1:7771` calls. Neither change was made here —
it touches a live, running production service (`ai.neuron.council`) and a
port number baked into shipped `.el` source, both bigger than this audit's
"make local build/run work" mandate. Flagging for a decision rather than
guessing.
+115
View File
@@ -0,0 +1,115 @@
#!/usr/bin/env python3
"""
neuron-connectd — MCP connector bridge (LOCAL-DEV STUB).
THIS IS NOT THE FULL SIDECAR. The full design lives in
neuron-technologies/docs/research/mcp-connectors-adoption-spec.md (2026-06-13,
"Status: Draft for build"): a TypeScript/Python sidecar using the official MCP
SDK that spawns real MCP servers (stdio or streamable-HTTP/SSE), does OAuth,
and namespaces their tools as mcp__<serverId>__<toolName>. That sidecar was
never built (build-audit, 2026-08-15: no neuron-connectd source existed
anywhere on disk before this file).
WHY THIS STUB EXISTS: routes.el (handle_connectors, connectd_get/connectd_post)
and chat.el (connector_tools_json, dispatch_tool's mcp__* routing,
tool_auto_approved) were built to the spec and hardcoded to 127.0.0.1:7771 —
they are LIVE and calling that port right now on every soul boot and every
agentic turn. With nothing real listening there, three unrelated services
collide on :7771 (see connectd/README.md): council (which IS what's bound
there in Will's live environment today) silently answers with unrelated
404 JSON, which is worse than a clean "connection refused" bridge-down
response, because it can be misparsed as a real (if empty) reply instead of
the "bridge unreachable" path the soul code already handles gracefully.
This stub implements ONLY the documented HTTP contract, with zero connectors
ever configured: empty tool list, empty server list, "not configured" on any
mutating call. It gives a fresh local soul the CORRECT graceful-degradation
behavior the soul code already expects for "no connectors set up yet" — not
the wrong-shaped 404 noise a port collision produces. It does not spawn any
MCP server, does no OAuth, and reads no ~/.neuron/connectors.json (there is
nothing to read yet). Building the real sidecar is a separate, larger,
Will-decision-needed product task — see README.md.
Usage:
python3 connectd_service.py [--port 7771]
"""
import argparse
import uvicorn
from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
from pydantic import BaseModel
app = FastAPI(title="neuron-connectd (local-dev stub)")
app.add_middleware(
CORSMiddleware,
allow_origins=["*"],
allow_methods=["*"],
allow_headers=["*"],
)
class ToolCall(BaseModel):
name: str
input: dict = {}
@app.get("/healthz")
def healthz():
return {"status": "ok", "stub": True}
@app.get("/mcp/tools")
def mcp_tools():
# Matches the spec's contract shape exactly (section 4, "HTTP contract").
# Empty because zero connectors are configured — this is the correct,
# intended-by-design empty state, not a failure.
return {"tools": []}
@app.post("/mcp/call")
def mcp_call(body: ToolCall):
return {"ok": False, "error": "no connectors configured (neuron-connectd stub)"}
@app.get("/mcp/servers")
def mcp_servers():
return {"servers": []}
@app.post("/mcp/servers/add")
def mcp_servers_add():
return {"ok": False, "error": "neuron-connectd stub does not implement connector management yet"}
@app.post("/mcp/servers/toggle")
def mcp_servers_toggle():
return {"ok": False, "error": "neuron-connectd stub does not implement connector management yet"}
@app.post("/mcp/servers/auto-approve")
def mcp_servers_auto_approve():
return {"ok": False, "error": "neuron-connectd stub does not implement connector management yet"}
@app.post("/mcp/servers/remove")
def mcp_servers_remove():
return {"ok": False, "error": "neuron-connectd stub does not implement connector management yet"}
@app.post("/mcp/servers/secret")
def mcp_servers_secret():
return {"ok": False, "error": "neuron-connectd stub does not implement connector management yet"}
@app.post("/mcp/oauth/start")
def mcp_oauth_start():
return {"ok": False, "error": "oauth not implemented in the neuron-connectd stub"}
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument("--port", type=int, default=7771)
args = parser.parse_args()
uvicorn.run(app, host="127.0.0.1", port=args.port, log_level="info")
+40 -1
View File
@@ -1,5 +1,43 @@
# Neuron Council Service # Neuron Council Service
> ## ⚠ Architecturally superseded — 2026-08-16
>
> **This service is wrong in two independent ways at once.** Authority:
> `foundation/el/lang/spec/correspondence-and-censorship.md` (branch `design/correspondence-and-censorship`),
> transcribed in `docs/architecture/06-cognitive-architecture.md` §12.4 and §12.5. The service is **still
> running** (`ai.neuron.council`, `KeepAlive`, resident, port 7771) and this README still describes it
> accurately; what is superseded is the claim that it should exist.
>
> **1. It is a write-refusal mechanism in an immutable substrate.**
>
> > In an immutable substrate, any mechanism that refuses a write is either redundant with immutability, or an
> > epistemic constraint misfiled as a protective one.
>
> "Before a claim enters long-term memory" is a **gate on entry**, and the storage policy below goes further:
> *"`council-flagged` → store in a quarantine bucket **or reject entirely**"* (`:54`), with a C sketch that
> returns `MEMORY_REJECTED` (`:95`). The engram does not mutate and nothing is ever hard-deleted, so a claim
> admitted and later refuted is **richer** than a claim never admitted: the refutation is recordable as
> **signed edge weight** (negative = *this actively contradicts*, distinct from near-zero = *no support*).
> Rejection destroys that distinction and makes the belief's truth value permanently unknowable — you cannot
> discover you were wrong, and you equally cannot discover you were right.
> **Holding is unconditional; the honesty floor governs assertion, not entry.**
>
> **2. It is a scheduled/resident consolidation service, in Python, outside el.**
>
> It is one of **eleven** measured consolidation implementations (`06` §12.4), and one of **three** that run in
> Python outside el — so this part of Neuron's consolidation does not run on his own substrate and **cannot
> touch the geometry at all**. Judging a claim without reaching the geometry means judging it on something
> other than its grounding.
>
> **3. What it actually measures is not grounding.** Three LLMs voting on plausibility computes **conformity to
> the centre of the training distribution** — treating *common* as true and *rare* as suspect. **Truth is
> orthogonal to frequency.** Grounding is correspondence with the world, and in this substrate it is the
> weight of the edge; it is never a vote and never a score computed on demand. See `06` §11 ("What an LLM calls
> grounding…") and §12.1.
>
> **Do not wire the `.el` pre-storage hook sketched below** (`:57-83`). It adds a gate on entry to a store
> whose whole discipline is that entry is not gated.
Anti-confabulation layer for the Neuron soul. Before a claim enters long-term memory, the council convenes: three independent LLMs vote on whether the claim is plausible, uncertain, or a confabulation. The aggregate vote produces a confidence score and tags that downstream storage can act on. Anti-confabulation layer for the Neuron soul. Before a claim enters long-term memory, the council convenes: three independent LLMs vote on whether the claim is plausible, uncertain, or a confabulation. The aggregate vote produces a confidence score and tags that downstream storage can act on.
## Running the service ## Running the service
@@ -51,7 +89,8 @@ Returns `{"status": "ok"}` when the service is up.
Recommended storage policy: Recommended storage policy:
- `confidence >= 0.65` → store normally - `confidence >= 0.65` → store normally
- `0.30 <= confidence < 0.65` → store with `council-split` tag for later review - `0.30 <= confidence < 0.65` → store with `council-split` tag for later review
- `council-flagged` → store in a quarantine bucket or reject entirely - ~~`council-flagged` → store in a quarantine bucket or reject entirely~~ — **withdrawn 2026-08-16; see the
banner at the top of this file. Never reject. Store it, and record the disagreement as signed weight.**
- `council-unavailable` → store normally (fail-open); council will re-evaluate later - `council-unavailable` → store normally (fail-open); council will re-evaluate later
## How to call from soul (.el) ## How to call from soul (.el)
Generated Vendored
+166 -113
View File
@@ -27,7 +27,8 @@ el_val_t elapsed_ms(void);
el_val_t elapsed_human(void); el_val_t elapsed_human(void);
el_val_t embed_ok(void); el_val_t embed_ok(void);
el_val_t emit_heartbeat(void); el_val_t emit_heartbeat(void);
el_val_t auto_term_try_slot(el_val_t slot_type, el_val_t slot_lbl); el_val_t auto_term_try_slot(el_val_t slot_type, el_val_t slot_id);
el_val_t auto_term_try_slot_legacy(el_val_t slot_type, el_val_t slot_lbl);
el_val_t proactive_curiosity(void); el_val_t proactive_curiosity(void);
el_val_t pulse_count(void); el_val_t pulse_count(void);
el_val_t pulse_inc(void); el_val_t pulse_inc(void);
@@ -235,16 +236,22 @@ el_val_t emit_heartbeat(void) {
el_val_t act_stats = engram_act_stats_json(); el_val_t act_stats = engram_act_stats_json();
el_val_t act_evict_raw = json_get(act_stats, EL_STR("wm_evicted")); el_val_t act_evict_raw = json_get(act_stats, EL_STR("wm_evicted"));
el_val_t act_evict = ({ el_val_t _if_result_37 = 0; if (str_eq(act_evict_raw, EL_STR(""))) { _if_result_37 = (EL_STR("-1")); } else { _if_result_37 = (act_evict_raw); } _if_result_37; }); el_val_t act_evict = ({ el_val_t _if_result_37 = 0; if (str_eq(act_evict_raw, EL_STR(""))) { _if_result_37 = (EL_STR("-1")); } else { _if_result_37 = (act_evict_raw); } _if_result_37; });
el_val_t ev_floor_raw = json_get(act_stats, EL_STR("evict_floor"));
el_val_t ev_floor = ({ el_val_t _if_result_38 = 0; if (str_eq(ev_floor_raw, EL_STR(""))) { _if_result_38 = (EL_STR("-1")); } else { _if_result_38 = (ev_floor_raw); } _if_result_38; });
el_val_t ev_cap_raw = json_get(act_stats, EL_STR("evict_cap"));
el_val_t ev_cap = ({ el_val_t _if_result_39 = 0; if (str_eq(ev_cap_raw, EL_STR(""))) { _if_result_39 = (EL_STR("-1")); } else { _if_result_39 = (ev_cap_raw); } _if_result_39; });
el_val_t ev_bll_raw = json_get(act_stats, EL_STR("evict_bll"));
el_val_t ev_bll = ({ el_val_t _if_result_40 = 0; if (str_eq(ev_bll_raw, EL_STR(""))) { _if_result_40 = (EL_STR("-1")); } else { _if_result_40 = (ev_bll_raw); } _if_result_40; });
el_val_t act_bt_raw = json_get(act_stats, EL_STR("breakthroughs")); el_val_t act_bt_raw = json_get(act_stats, EL_STR("breakthroughs"));
el_val_t act_bt = ({ el_val_t _if_result_38 = 0; if (str_eq(act_bt_raw, EL_STR(""))) { _if_result_38 = (EL_STR("-1")); } else { _if_result_38 = (act_bt_raw); } _if_result_38; }); el_val_t act_bt = ({ el_val_t _if_result_41 = 0; if (str_eq(act_bt_raw, EL_STR(""))) { _if_result_41 = (EL_STR("-1")); } else { _if_result_41 = (act_bt_raw); } _if_result_41; });
el_val_t evict_now = ({ el_val_t _if_result_39 = 0; if (str_eq(act_evict_raw, EL_STR(""))) { _if_result_39 = ((0 - 1)); } else { _if_result_39 = (str_to_int(act_evict_raw)); } _if_result_39; }); el_val_t evict_now = ({ el_val_t _if_result_42 = 0; if (str_eq(act_evict_raw, EL_STR(""))) { _if_result_42 = ((0 - 1)); } else { _if_result_42 = (str_to_int(act_evict_raw)); } _if_result_42; });
el_val_t bt_now = ({ el_val_t _if_result_40 = 0; if (str_eq(act_bt_raw, EL_STR(""))) { _if_result_40 = ((0 - 1)); } else { _if_result_40 = (str_to_int(act_bt_raw)); } _if_result_40; }); el_val_t bt_now = ({ el_val_t _if_result_43 = 0; if (str_eq(act_bt_raw, EL_STR(""))) { _if_result_43 = ((0 - 1)); } else { _if_result_43 = (str_to_int(act_bt_raw)); } _if_result_43; });
el_val_t prev_evict_raw = state_get(EL_STR("soul.prev_wm_evicted")); el_val_t prev_evict_raw = state_get(EL_STR("soul.prev_wm_evicted"));
el_val_t prev_evict = ({ el_val_t _if_result_41 = 0; if (str_eq(prev_evict_raw, EL_STR(""))) { _if_result_41 = (0); } else { _if_result_41 = (str_to_int(prev_evict_raw)); } _if_result_41; }); el_val_t prev_evict = ({ el_val_t _if_result_44 = 0; if (str_eq(prev_evict_raw, EL_STR(""))) { _if_result_44 = (0); } else { _if_result_44 = (str_to_int(prev_evict_raw)); } _if_result_44; });
el_val_t prev_bt_raw = state_get(EL_STR("soul.prev_breakthroughs")); el_val_t prev_bt_raw = state_get(EL_STR("soul.prev_breakthroughs"));
el_val_t prev_bt = ({ el_val_t _if_result_42 = 0; if (str_eq(prev_bt_raw, EL_STR(""))) { _if_result_42 = (0); } else { _if_result_42 = (str_to_int(prev_bt_raw)); } _if_result_42; }); el_val_t prev_bt = ({ el_val_t _if_result_45 = 0; if (str_eq(prev_bt_raw, EL_STR(""))) { _if_result_45 = (0); } else { _if_result_45 = (str_to_int(prev_bt_raw)); } _if_result_45; });
el_val_t evict_delta = ({ el_val_t _if_result_43 = 0; if ((evict_now < 0)) { _if_result_43 = (0); } else { _if_result_43 = (({ el_val_t _if_result_44 = 0; if ((evict_now < prev_evict)) { _if_result_44 = (evict_now); } else { _if_result_44 = ((evict_now - prev_evict)); } _if_result_44; })); } _if_result_43; }); el_val_t evict_delta = ({ el_val_t _if_result_46 = 0; if ((evict_now < 0)) { _if_result_46 = (0); } else { _if_result_46 = (({ el_val_t _if_result_47 = 0; if ((evict_now < prev_evict)) { _if_result_47 = (evict_now); } else { _if_result_47 = ((evict_now - prev_evict)); } _if_result_47; })); } _if_result_46; });
el_val_t bt_delta = ({ el_val_t _if_result_45 = 0; if ((bt_now < 0)) { _if_result_45 = (0); } else { _if_result_45 = (({ el_val_t _if_result_46 = 0; if ((bt_now < prev_bt)) { _if_result_46 = (bt_now); } else { _if_result_46 = ((bt_now - prev_bt)); } _if_result_46; })); } _if_result_45; }); el_val_t bt_delta = ({ el_val_t _if_result_48 = 0; if ((bt_now < 0)) { _if_result_48 = (0); } else { _if_result_48 = (({ el_val_t _if_result_49 = 0; if ((bt_now < prev_bt)) { _if_result_49 = (bt_now); } else { _if_result_49 = ((bt_now - prev_bt)); } _if_result_49; })); } _if_result_48; });
if (evict_now >= 0) { if (evict_now >= 0) {
state_set(EL_STR("soul.prev_wm_evicted"), int_to_str(evict_now)); state_set(EL_STR("soul.prev_wm_evicted"), int_to_str(evict_now));
} }
@@ -253,49 +260,59 @@ el_val_t emit_heartbeat(void) {
} }
el_val_t hb_stats = http_get(el_str_concat(hb_engram_url, EL_STR("/api/stats"))); el_val_t hb_stats = http_get(el_str_concat(hb_engram_url, EL_STR("/api/stats")));
el_val_t embed_elig_raw = json_get(hb_stats, EL_STR("embed_eligible_count")); el_val_t embed_elig_raw = json_get(hb_stats, EL_STR("embed_eligible_count"));
el_val_t embed_elig = ({ el_val_t _if_result_47 = 0; if (str_eq(embed_elig_raw, EL_STR(""))) { _if_result_47 = (EL_STR("-1")); } else { _if_result_47 = (embed_elig_raw); } _if_result_47; }); el_val_t embed_elig = ({ el_val_t _if_result_50 = 0; if (str_eq(embed_elig_raw, EL_STR(""))) { _if_result_50 = (EL_STR("-1")); } else { _if_result_50 = (embed_elig_raw); } _if_result_50; });
el_val_t hb_ats_raw = state_get(EL_STR("soul.auto_term_streak")); el_val_t hb_ats_raw = state_get(EL_STR("soul.auto_term_streak"));
el_val_t hb_ats = ({ el_val_t _if_result_48 = 0; if (str_eq(hb_ats_raw, EL_STR(""))) { _if_result_48 = (0); } else { _if_result_48 = (str_to_int(hb_ats_raw)); } _if_result_48; }); el_val_t hb_ats = ({ el_val_t _if_result_51 = 0; if (str_eq(hb_ats_raw, EL_STR(""))) { _if_result_51 = (0); } else { _if_result_51 = (str_to_int(hb_ats_raw)); } _if_result_51; });
el_val_t hb_ate_raw = state_get(EL_STR("soul.auto_term_empty_streak")); el_val_t hb_ate_raw = state_get(EL_STR("soul.auto_term_empty_streak"));
el_val_t hb_ate = ({ el_val_t _if_result_49 = 0; if (str_eq(hb_ate_raw, EL_STR(""))) { _if_result_49 = (0); } else { _if_result_49 = (str_to_int(hb_ate_raw)); } _if_result_49; }); el_val_t hb_ate = ({ el_val_t _if_result_52 = 0; if (str_eq(hb_ate_raw, EL_STR(""))) { _if_result_52 = (0); } else { _if_result_52 = (str_to_int(hb_ate_raw)); } _if_result_52; });
el_val_t hebb_warm_raw = json_get(act_stats, EL_STR("hebb_warm")); el_val_t hebb_warm_raw = json_get(act_stats, EL_STR("hebb_warm"));
el_val_t hebb_warm = ({ el_val_t _if_result_50 = 0; if (str_eq(hebb_warm_raw, EL_STR(""))) { _if_result_50 = (EL_STR("-1")); } else { _if_result_50 = (hebb_warm_raw); } _if_result_50; }); el_val_t hebb_warm = ({ el_val_t _if_result_53 = 0; if (str_eq(hebb_warm_raw, EL_STR(""))) { _if_result_53 = (EL_STR("-1")); } else { _if_result_53 = (hebb_warm_raw); } _if_result_53; });
el_val_t hebb_max_raw = json_get(act_stats, EL_STR("hebb_max")); el_val_t hebb_max_raw = json_get(act_stats, EL_STR("hebb_max"));
el_val_t hebb_max = ({ el_val_t _if_result_51 = 0; if (str_eq(hebb_max_raw, EL_STR(""))) { _if_result_51 = (EL_STR("-1")); } else { _if_result_51 = (hebb_max_raw); } _if_result_51; }); el_val_t hebb_max = ({ el_val_t _if_result_54 = 0; if (str_eq(hebb_max_raw, EL_STR(""))) { _if_result_54 = (EL_STR("-1")); } else { _if_result_54 = (hebb_max_raw); } _if_result_54; });
el_val_t hebb_links_raw = json_get(act_stats, EL_STR("hebb_links")); el_val_t hebb_links_raw = json_get(act_stats, EL_STR("hebb_links"));
el_val_t hebb_links = ({ el_val_t _if_result_52 = 0; if (str_eq(hebb_links_raw, EL_STR(""))) { _if_result_52 = (EL_STR("-1")); } else { _if_result_52 = (hebb_links_raw); } _if_result_52; }); el_val_t hebb_links = ({ el_val_t _if_result_55 = 0; if (str_eq(hebb_links_raw, EL_STR(""))) { _if_result_55 = (EL_STR("-1")); } else { _if_result_55 = (hebb_links_raw); } _if_result_55; });
el_val_t hebb_cands_raw = json_get(act_stats, EL_STR("hebb_cands")); el_val_t hebb_cands_raw = json_get(act_stats, EL_STR("hebb_cands"));
el_val_t hebb_cands = ({ el_val_t _if_result_53 = 0; if (str_eq(hebb_cands_raw, EL_STR(""))) { _if_result_53 = (EL_STR("-1")); } else { _if_result_53 = (hebb_cands_raw); } _if_result_53; }); el_val_t hebb_cands = ({ el_val_t _if_result_56 = 0; if (str_eq(hebb_cands_raw, EL_STR(""))) { _if_result_56 = (EL_STR("-1")); } else { _if_result_56 = (hebb_cands_raw); } _if_result_56; });
el_val_t hebb_cmax_raw = json_get(act_stats, EL_STR("hebb_cand_max")); el_val_t hebb_cmax_raw = json_get(act_stats, EL_STR("hebb_cand_max"));
el_val_t hebb_cmax = ({ el_val_t _if_result_54 = 0; if (str_eq(hebb_cmax_raw, EL_STR(""))) { _if_result_54 = (EL_STR("-1")); } else { _if_result_54 = (hebb_cmax_raw); } _if_result_54; }); el_val_t hebb_cmax = ({ el_val_t _if_result_57 = 0; if (str_eq(hebb_cmax_raw, EL_STR(""))) { _if_result_57 = (EL_STR("-1")); } else { _if_result_57 = (hebb_cmax_raw); } _if_result_57; });
el_val_t hebb_mass_raw = json_get(act_stats, EL_STR("hebb_mass")); el_val_t hebb_mass_raw = json_get(act_stats, EL_STR("hebb_mass"));
el_val_t hebb_mass = ({ el_val_t _if_result_55 = 0; if (str_eq(hebb_mass_raw, EL_STR(""))) { _if_result_55 = (EL_STR("-1")); } else { _if_result_55 = (hebb_mass_raw); } _if_result_55; }); el_val_t hebb_mass = ({ el_val_t _if_result_58 = 0; if (str_eq(hebb_mass_raw, EL_STR(""))) { _if_result_58 = (EL_STR("-1")); } else { _if_result_58 = (hebb_mass_raw); } _if_result_58; });
el_val_t hebb_edges_raw = json_get(act_stats, EL_STR("hebb_edges")); el_val_t hebb_edges_raw = json_get(act_stats, EL_STR("hebb_edges"));
el_val_t hebb_edges = ({ el_val_t _if_result_56 = 0; if (str_eq(hebb_edges_raw, EL_STR(""))) { _if_result_56 = (EL_STR("-1")); } else { _if_result_56 = (hebb_edges_raw); } _if_result_56; }); el_val_t hebb_edges = ({ el_val_t _if_result_59 = 0; if (str_eq(hebb_edges_raw, EL_STR(""))) { _if_result_59 = (EL_STR("-1")); } else { _if_result_59 = (hebb_edges_raw); } _if_result_59; });
el_val_t fan_mean_raw = json_get(act_stats, EL_STR("fan_mean"));
el_val_t fan_mean = ({ el_val_t _if_result_60 = 0; if (str_eq(fan_mean_raw, EL_STR(""))) { _if_result_60 = (EL_STR("-1")); } else { _if_result_60 = (fan_mean_raw); } _if_result_60; });
el_val_t fan_min_raw = json_get(act_stats, EL_STR("fan_min"));
el_val_t fan_min = ({ el_val_t _if_result_61 = 0; if (str_eq(fan_min_raw, EL_STR(""))) { _if_result_61 = (EL_STR("-1")); } else { _if_result_61 = (fan_min_raw); } _if_result_61; });
el_val_t fan_hits_raw = json_get(act_stats, EL_STR("fan_hits"));
el_val_t fan_hits = ({ el_val_t _if_result_62 = 0; if (str_eq(fan_hits_raw, EL_STR(""))) { _if_result_62 = (EL_STR("-1")); } else { _if_result_62 = (fan_hits_raw); } _if_result_62; });
el_val_t fan_steps_raw = json_get(act_stats, EL_STR("fan_steps"));
el_val_t fan_steps = ({ el_val_t _if_result_63 = 0; if (str_eq(fan_steps_raw, EL_STR(""))) { _if_result_63 = (EL_STR("-1")); } else { _if_result_63 = (fan_steps_raw); } _if_result_63; });
el_val_t fan_dref_raw = json_get(act_stats, EL_STR("fan_dref"));
el_val_t fan_dref = ({ el_val_t _if_result_64 = 0; if (str_eq(fan_dref_raw, EL_STR(""))) { _if_result_64 = (EL_STR("-1")); } else { _if_result_64 = (fan_dref_raw); } _if_result_64; });
el_val_t wb_pend_raw = json_get(act_stats, EL_STR("hebb_wb_pending")); el_val_t wb_pend_raw = json_get(act_stats, EL_STR("hebb_wb_pending"));
el_val_t wb_pend = ({ el_val_t _if_result_57 = 0; if (str_eq(wb_pend_raw, EL_STR(""))) { _if_result_57 = (EL_STR("-1")); } else { _if_result_57 = (wb_pend_raw); } _if_result_57; }); el_val_t wb_pend = ({ el_val_t _if_result_65 = 0; if (str_eq(wb_pend_raw, EL_STR(""))) { _if_result_65 = (EL_STR("-1")); } else { _if_result_65 = (wb_pend_raw); } _if_result_65; });
el_val_t wb_drain_raw = json_get(act_stats, EL_STR("hebb_wb_drained")); el_val_t wb_drain_raw = json_get(act_stats, EL_STR("hebb_wb_drained"));
el_val_t wb_drain = ({ el_val_t _if_result_58 = 0; if (str_eq(wb_drain_raw, EL_STR(""))) { _if_result_58 = (EL_STR("-1")); } else { _if_result_58 = (wb_drain_raw); } _if_result_58; }); el_val_t wb_drain = ({ el_val_t _if_result_66 = 0; if (str_eq(wb_drain_raw, EL_STR(""))) { _if_result_66 = (EL_STR("-1")); } else { _if_result_66 = (wb_drain_raw); } _if_result_66; });
el_val_t wb_drop_raw = json_get(act_stats, EL_STR("hebb_wb_dropped")); el_val_t wb_drop_raw = json_get(act_stats, EL_STR("hebb_wb_dropped"));
el_val_t wb_drop = ({ el_val_t _if_result_59 = 0; if (str_eq(wb_drop_raw, EL_STR(""))) { _if_result_59 = (EL_STR("-1")); } else { _if_result_59 = (wb_drop_raw); } _if_result_59; }); el_val_t wb_drop = ({ el_val_t _if_result_67 = 0; if (str_eq(wb_drop_raw, EL_STR(""))) { _if_result_67 = (EL_STR("-1")); } else { _if_result_67 = (wb_drop_raw); } _if_result_67; });
el_val_t wb_sent_raw = state_get(EL_STR("soul.hebb_wb_sent")); el_val_t wb_sent_raw = state_get(EL_STR("soul.hebb_wb_sent"));
el_val_t wb_sent = ({ el_val_t _if_result_60 = 0; if (str_eq(wb_sent_raw, EL_STR(""))) { _if_result_60 = (EL_STR("0")); } else { _if_result_60 = (wb_sent_raw); } _if_result_60; }); el_val_t wb_sent = ({ el_val_t _if_result_68 = 0; if (str_eq(wb_sent_raw, EL_STR(""))) { _if_result_68 = (EL_STR("0")); } else { _if_result_68 = (wb_sent_raw); } _if_result_68; });
el_val_t dup_wm_g_raw = json_get(act_stats, EL_STR("dup_wm_global")); el_val_t dup_wm_g_raw = json_get(act_stats, EL_STR("dup_wm_global"));
el_val_t dup_wm_g = ({ el_val_t _if_result_61 = 0; if (str_eq(dup_wm_g_raw, EL_STR(""))) { _if_result_61 = (EL_STR("-1")); } else { _if_result_61 = (dup_wm_g_raw); } _if_result_61; }); el_val_t dup_wm_g = ({ el_val_t _if_result_69 = 0; if (str_eq(dup_wm_g_raw, EL_STR(""))) { _if_result_69 = (EL_STR("-1")); } else { _if_result_69 = (dup_wm_g_raw); } _if_result_69; });
el_val_t act_brk_raw = json_get(act_stats, EL_STR("embed_breaker_open")); el_val_t act_brk_raw = json_get(act_stats, EL_STR("embed_breaker_open"));
el_val_t act_brk = ({ el_val_t _if_result_62 = 0; if (str_eq(act_brk_raw, EL_STR(""))) { _if_result_62 = (EL_STR("-1")); } else { _if_result_62 = (act_brk_raw); } _if_result_62; }); el_val_t act_brk = ({ el_val_t _if_result_70 = 0; if (str_eq(act_brk_raw, EL_STR(""))) { _if_result_70 = (EL_STR("-1")); } else { _if_result_70 = (act_brk_raw); } _if_result_70; });
el_val_t emb_cf_raw = json_get(act_stats, EL_STR("embed_consec_fail")); el_val_t emb_cf_raw = json_get(act_stats, EL_STR("embed_consec_fail"));
el_val_t emb_cf = ({ el_val_t _if_result_63 = 0; if (str_eq(emb_cf_raw, EL_STR(""))) { _if_result_63 = (EL_STR("-1")); } else { _if_result_63 = (emb_cf_raw); } _if_result_63; }); el_val_t emb_cf = ({ el_val_t _if_result_71 = 0; if (str_eq(emb_cf_raw, EL_STR(""))) { _if_result_71 = (EL_STR("-1")); } else { _if_result_71 = (emb_cf_raw); } _if_result_71; });
el_val_t ctx_cos_raw = json_get(act_stats, EL_STR("ctx_cos")); el_val_t ctx_cos_raw = json_get(act_stats, EL_STR("ctx_cos"));
el_val_t ctx_cos = ({ el_val_t _if_result_64 = 0; if (str_eq(ctx_cos_raw, EL_STR(""))) { _if_result_64 = (EL_STR("-2")); } else { _if_result_64 = (ctx_cos_raw); } _if_result_64; }); el_val_t ctx_cos = ({ el_val_t _if_result_72 = 0; if (str_eq(ctx_cos_raw, EL_STR(""))) { _if_result_72 = (EL_STR("-2")); } else { _if_result_72 = (ctx_cos_raw); } _if_result_72; });
el_val_t dup_seeds_raw = json_get(act_stats, EL_STR("dup_seeds")); el_val_t dup_seeds_raw = json_get(act_stats, EL_STR("dup_seeds"));
el_val_t dup_seeds = ({ el_val_t _if_result_65 = 0; if (str_eq(dup_seeds_raw, EL_STR(""))) { _if_result_65 = (EL_STR("-1")); } else { _if_result_65 = (dup_seeds_raw); } _if_result_65; }); el_val_t dup_seeds = ({ el_val_t _if_result_73 = 0; if (str_eq(dup_seeds_raw, EL_STR(""))) { _if_result_73 = (EL_STR("-1")); } else { _if_result_73 = (dup_seeds_raw); } _if_result_73; });
el_val_t dup_wm_raw = json_get(act_stats, EL_STR("dup_wm")); el_val_t dup_wm_raw = json_get(act_stats, EL_STR("dup_wm"));
el_val_t dup_wm = ({ el_val_t _if_result_66 = 0; if (str_eq(dup_wm_raw, EL_STR(""))) { _if_result_66 = (EL_STR("-1")); } else { _if_result_66 = (dup_wm_raw); } _if_result_66; }); el_val_t dup_wm = ({ el_val_t _if_result_74 = 0; if (str_eq(dup_wm_raw, EL_STR(""))) { _if_result_74 = (EL_STR("-1")); } else { _if_result_74 = (dup_wm_raw); } _if_result_74; });
el_val_t txt_dmg_raw = json_get(act_stats, EL_STR("txt_damaged")); el_val_t txt_dmg_raw = json_get(act_stats, EL_STR("txt_damaged"));
el_val_t txt_dmg = ({ el_val_t _if_result_67 = 0; if (str_eq(txt_dmg_raw, EL_STR(""))) { _if_result_67 = (EL_STR("-1")); } else { _if_result_67 = (txt_dmg_raw); } _if_result_67; }); el_val_t txt_dmg = ({ el_val_t _if_result_75 = 0; if (str_eq(txt_dmg_raw, EL_STR(""))) { _if_result_75 = (EL_STR("-1")); } else { _if_result_75 = (txt_dmg_raw); } _if_result_75; });
el_val_t tc_raw = state_get(EL_STR("soul.txt_census_countdown")); el_val_t tc_raw = state_get(EL_STR("soul.txt_census_countdown"));
el_val_t tc_n = ({ el_val_t _if_result_68 = 0; if (str_eq(tc_raw, EL_STR(""))) { _if_result_68 = (0); } else { _if_result_68 = (str_to_int(tc_raw)); } _if_result_68; }); el_val_t tc_n = ({ el_val_t _if_result_76 = 0; if (str_eq(tc_raw, EL_STR(""))) { _if_result_76 = (0); } else { _if_result_76 = (str_to_int(tc_raw)); } _if_result_76; });
if (tc_n <= 0) { if (tc_n <= 0) {
el_val_t th_resp = http_get(el_str_concat(hb_engram_url, EL_STR("/api/text-health"))); el_val_t th_resp = http_get(el_str_concat(hb_engram_url, EL_STR("/api/text-health")));
el_val_t th_pct = json_get(th_resp, EL_STR("damaged_pct")); el_val_t th_pct = json_get(th_resp, EL_STR("damaged_pct"));
@@ -311,19 +328,55 @@ el_val_t emit_heartbeat(void) {
state_set(EL_STR("soul.txt_census_countdown"), int_to_str((tc_n - 1))); state_set(EL_STR("soul.txt_census_countdown"), int_to_str((tc_n - 1)));
} }
el_val_t dmg_pct_raw = state_get(EL_STR("soul.txt_damaged_pct")); el_val_t dmg_pct_raw = state_get(EL_STR("soul.txt_damaged_pct"));
el_val_t dmg_pct = ({ el_val_t _if_result_69 = 0; if (str_eq(dmg_pct_raw, EL_STR(""))) { _if_result_69 = (EL_STR("-1")); } else { _if_result_69 = (dmg_pct_raw); } _if_result_69; }); el_val_t dmg_pct = ({ el_val_t _if_result_77 = 0; if (str_eq(dmg_pct_raw, EL_STR(""))) { _if_result_77 = (EL_STR("-1")); } else { _if_result_77 = (dmg_pct_raw); } _if_result_77; });
el_val_t dmg_n_raw = state_get(EL_STR("soul.txt_damaged_n")); el_val_t dmg_n_raw = state_get(EL_STR("soul.txt_damaged_n"));
el_val_t dmg_n = ({ el_val_t _if_result_70 = 0; if (str_eq(dmg_n_raw, EL_STR(""))) { _if_result_70 = (EL_STR("-1")); } else { _if_result_70 = (dmg_n_raw); } _if_result_70; }); el_val_t dmg_n = ({ el_val_t _if_result_78 = 0; if (str_eq(dmg_n_raw, EL_STR(""))) { _if_result_78 = (EL_STR("-1")); } else { _if_result_78 = (dmg_n_raw); } _if_result_78; });
el_val_t dmg_scan_raw = state_get(EL_STR("soul.txt_scanned_n")); el_val_t dmg_scan_raw = state_get(EL_STR("soul.txt_scanned_n"));
el_val_t dmg_scan = ({ el_val_t _if_result_71 = 0; if (str_eq(dmg_scan_raw, EL_STR(""))) { _if_result_71 = (EL_STR("-1")); } else { _if_result_71 = (dmg_scan_raw); } _if_result_71; }); el_val_t dmg_scan = ({ el_val_t _if_result_79 = 0; if (str_eq(dmg_scan_raw, EL_STR(""))) { _if_result_79 = (EL_STR("-1")); } else { _if_result_79 = (dmg_scan_raw); } _if_result_79; });
el_val_t dmg_ts_raw = state_get(EL_STR("soul.txt_census_ts")); el_val_t dmg_ts_raw = state_get(EL_STR("soul.txt_census_ts"));
el_val_t dmg_age = ({ el_val_t _if_result_72 = 0; if (str_eq(dmg_ts_raw, EL_STR(""))) { _if_result_72 = ((0 - 1)); } else { _if_result_72 = ((ts - str_to_int(dmg_ts_raw))); } _if_result_72; }); el_val_t dmg_age = ({ el_val_t _if_result_80 = 0; if (str_eq(dmg_ts_raw, EL_STR(""))) { _if_result_80 = ((0 - 1)); } else { _if_result_80 = ((ts - str_to_int(dmg_ts_raw))); } _if_result_80; });
el_val_t payload = el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(EL_STR("{\"event\":\"heartbeat\",\"pulse\":"), pulse), EL_STR(",\"tick\":")), pulse), EL_STR(",\"boot\":")), boot), EL_STR(",\"idle\":")), idle), EL_STR(",\"idle_ms\":")), int_to_str(idle_ms)), EL_STR(",\"node_count\":")), int_to_str(nc)), EL_STR(",\"edge_count\":")), int_to_str(ec)), EL_STR(",\"node_delta\":")), int_to_str(node_delta)), EL_STR(",\"edge_delta\":")), int_to_str(edge_delta)), EL_STR(",\"wm_active\":")), int_to_str(wmc)), EL_STR(",\"wm_delta\":")), int_to_str(wm_delta)), EL_STR(",\"wm_saturated\":")), int_to_str(wm_sat)), EL_STR(",\"wm_top0_streak\":")), int_to_str(t0streak)), EL_STR(",\"wm_churn\":")), int_to_str(wm_churn)), EL_STR(",\"wm_top0_wm\":")), wm_top0_wm), EL_STR(",\"sync_added_total\":")), sat_str), EL_STR(",\"sync_age_ms\":")), int_to_str(sync_age)), EL_STR(",\"wm_avg_weight\":")), wm_avg_str), EL_STR(",\"wm_top\":")), wm_top), EL_STR(",\"ts\":")), int_to_str(ts)), EL_STR(",\"uptime_ms\":")), int_to_str(up_ms)), EL_STR(",\"uptime\":\"")), up_human), EL_STR("\",\"embed_ok\":")), int_to_str(emb_ok)), EL_STR(",\"embed_backfilled\":")), bf_done), EL_STR(",\"embed_count\":")), bf_total), EL_STR(",\"embed_eligible\":")), embed_elig), EL_STR(",\"wm_evicted\":")), act_evict), EL_STR(",\"wm_evicted_delta\":")), int_to_str(evict_delta)), EL_STR(",\"breakthroughs\":")), act_bt), EL_STR(",\"breakthroughs_delta\":")), int_to_str(bt_delta)), EL_STR(",\"auto_term_streak\":")), int_to_str(hb_ats)), EL_STR(",\"auto_term_empty_streak\":")), int_to_str(hb_ate)), EL_STR(",\"embed_breaker_open\":")), act_brk), EL_STR(",\"ctx_cos\":")), ctx_cos), EL_STR(",\"dup_seeds\":")), dup_seeds), EL_STR(",\"dup_wm\":")), dup_wm), EL_STR(",\"dup_wm_global\":")), dup_wm_g), EL_STR(",\"hebb_warm\":")), hebb_warm), EL_STR(",\"hebb_max\":")), hebb_max), EL_STR(",\"hebb_links\":")), hebb_links), EL_STR(",\"hebb_cands\":")), hebb_cands), EL_STR(",\"hebb_cand_max\":")), hebb_cmax), EL_STR(",\"hebb_mass\":")), hebb_mass), EL_STR(",\"hebb_edges\":")), hebb_edges), EL_STR(",\"embed_consec_fail\":")), emb_cf), EL_STR(",\"txt_damaged_pct\":")), dmg_pct), EL_STR(",\"txt_damaged_n\":")), dmg_n), EL_STR(",\"txt_scanned_n\":")), dmg_scan), EL_STR(",\"txt_census_age_ms\":")), int_to_str(dmg_age)), EL_STR(",\"hebb_wb_pending\":")), wb_pend), EL_STR(",\"hebb_wb_drained\":")), wb_drain), EL_STR(",\"hebb_wb_dropped\":")), wb_drop), EL_STR(",\"hebb_wb_sent\":")), wb_sent), EL_STR(",\"ise_fail\":")), fail_str), EL_STR(",\"txt_damaged\":")), txt_dmg), EL_STR("}")); el_val_t payload = el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(EL_STR("{\"event\":\"heartbeat\",\"pulse\":"), pulse), EL_STR(",\"tick\":")), pulse), EL_STR(",\"boot\":")), boot), EL_STR(",\"idle\":")), idle), EL_STR(",\"idle_ms\":")), int_to_str(idle_ms)), EL_STR(",\"node_count\":")), int_to_str(nc)), EL_STR(",\"edge_count\":")), int_to_str(ec)), EL_STR(",\"node_delta\":")), int_to_str(node_delta)), EL_STR(",\"edge_delta\":")), int_to_str(edge_delta)), EL_STR(",\"wm_active\":")), int_to_str(wmc)), EL_STR(",\"wm_delta\":")), int_to_str(wm_delta)), EL_STR(",\"wm_saturated\":")), int_to_str(wm_sat)), EL_STR(",\"wm_top0_streak\":")), int_to_str(t0streak)), EL_STR(",\"wm_churn\":")), int_to_str(wm_churn)), EL_STR(",\"wm_top0_wm\":")), wm_top0_wm), EL_STR(",\"sync_added_total\":")), sat_str), EL_STR(",\"sync_age_ms\":")), int_to_str(sync_age)), EL_STR(",\"wm_avg_weight\":")), wm_avg_str), EL_STR(",\"wm_top\":")), wm_top), EL_STR(",\"ts\":")), int_to_str(ts)), EL_STR(",\"uptime_ms\":")), int_to_str(up_ms)), EL_STR(",\"uptime\":\"")), up_human), EL_STR("\",\"embed_ok\":")), int_to_str(emb_ok)), EL_STR(",\"embed_backfilled\":")), bf_done), EL_STR(",\"embed_count\":")), bf_total), EL_STR(",\"embed_eligible\":")), embed_elig), EL_STR(",\"wm_evicted\":")), act_evict), EL_STR(",\"wm_evicted_delta\":")), int_to_str(evict_delta)), EL_STR(",\"evict_floor\":")), ev_floor), EL_STR(",\"evict_cap\":")), ev_cap), EL_STR(",\"evict_bll\":")), ev_bll), EL_STR(",\"breakthroughs\":")), act_bt), EL_STR(",\"breakthroughs_delta\":")), int_to_str(bt_delta)), EL_STR(",\"auto_term_streak\":")), int_to_str(hb_ats)), EL_STR(",\"auto_term_empty_streak\":")), int_to_str(hb_ate)), EL_STR(",\"embed_breaker_open\":")), act_brk), EL_STR(",\"ctx_cos\":")), ctx_cos), EL_STR(",\"dup_seeds\":")), dup_seeds), EL_STR(",\"dup_wm\":")), dup_wm), EL_STR(",\"dup_wm_global\":")), dup_wm_g), EL_STR(",\"hebb_warm\":")), hebb_warm), EL_STR(",\"hebb_max\":")), hebb_max), EL_STR(",\"hebb_links\":")), hebb_links), EL_STR(",\"hebb_cands\":")), hebb_cands), EL_STR(",\"hebb_cand_max\":")), hebb_cmax), EL_STR(",\"hebb_mass\":")), hebb_mass), EL_STR(",\"hebb_edges\":")), hebb_edges), EL_STR(",\"embed_consec_fail\":")), emb_cf), EL_STR(",\"txt_damaged_pct\":")), dmg_pct), EL_STR(",\"txt_damaged_n\":")), dmg_n), EL_STR(",\"txt_scanned_n\":")), dmg_scan), EL_STR(",\"txt_census_age_ms\":")), int_to_str(dmg_age)), EL_STR(",\"hebb_wb_pending\":")), wb_pend), EL_STR(",\"hebb_wb_drained\":")), wb_drain), EL_STR(",\"hebb_wb_dropped\":")), wb_drop), EL_STR(",\"hebb_wb_sent\":")), wb_sent), EL_STR(",\"ise_fail\":")), fail_str), EL_STR(",\"txt_damaged\":")), txt_dmg), EL_STR(",\"fan_mean\":")), fan_mean), EL_STR(",\"fan_min\":")), fan_min), EL_STR(",\"fan_hits\":")), fan_hits), EL_STR(",\"fan_steps\":")), fan_steps), EL_STR(",\"fan_dref\":")), fan_dref), EL_STR("}"));
ise_post(payload); ise_post(payload);
return 0; return 0;
} }
el_val_t auto_term_try_slot(el_val_t slot_type, el_val_t slot_lbl) { el_val_t auto_term_try_slot(el_val_t slot_type, el_val_t slot_id) {
state_set(EL_STR("_ats_ok"), EL_STR("0"));
if (str_eq(slot_type, EL_STR("Memory"))) {
state_set(EL_STR("_ats_ok"), EL_STR("1"));
}
if (str_eq(slot_type, EL_STR("BacklogItem"))) {
state_set(EL_STR("_ats_ok"), EL_STR("1"));
}
if (str_eq(slot_type, EL_STR("Entity"))) {
state_set(EL_STR("_ats_ok"), EL_STR("1"));
}
if (str_eq(slot_type, EL_STR("Knowledge"))) {
state_set(EL_STR("_ats_ok"), EL_STR("1"));
}
if (str_eq(state_get(EL_STR("_ats_ok")), EL_STR("1"))) {
if (!str_eq(slot_id, EL_STR(""))) {
el_val_t tabu = el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(EL_STR("|"), state_get(EL_STR("soul.tabu_t0"))), EL_STR("|")), state_get(EL_STR("soul.tabu_t1"))), EL_STR("|")), state_get(EL_STR("soul.tabu_t2"))), EL_STR("|")), state_get(EL_STR("soul.tabu_t3"))), EL_STR("|"));
el_val_t df_max = (engram_node_count() / 400);
el_val_t df_cap = ({ el_val_t _if_result_81 = 0; if ((df_max > 8)) { _if_result_81 = (df_max); } else { _if_result_81 = (8); } _if_result_81; });
el_val_t term = engram_salient_term(slot_id, df_cap, 1, tabu);
if (!str_eq(term, EL_STR(""))) {
state_set(EL_STR("_ats_gw"), EL_STR("0"));
el_val_t stopw = EL_STR("|What|When|Where|Which|Whose|While|This|That|These|Those|There|Their|Then|Than|With|Without|From|Into|Onto|Over|Under|About|Between|Among|Across|Some|Most|More|Less|Very|Each|Every|Both|Also|Only|Just|Does|Will|Would|Could|Should|Might|Must|Have|Been|Being|Toward|Towards|Using|Based|Upon|Here|Your|Ours|They|Them|what|this|that|with|from|context|Context|Prose|Colon|Self|Test|Testing|Closing|Global|Universal|Persona|Semantic|Spreading|Temporal|Numeric|Register|Identifying|Introduction|Overview|Summary|Section|General|Notes|Note|");
if (str_contains(stopw, el_str_concat(el_str_concat(EL_STR("|"), term), EL_STR("|")))) {
state_set(EL_STR("_ats_gw"), EL_STR("1"));
}
if (str_eq(state_get(EL_STR("_ats_gw")), EL_STR("0"))) {
state_set(EL_STR("cseed_auto"), term);
}
}
}
}
return EL_STR("");
return 0;
}
el_val_t auto_term_try_slot_legacy(el_val_t slot_type, el_val_t slot_lbl) {
state_set(EL_STR("_ats_ok"), EL_STR("0")); state_set(EL_STR("_ats_ok"), EL_STR("0"));
if (str_eq(slot_type, EL_STR("Memory"))) { if (str_eq(slot_type, EL_STR("Memory"))) {
state_set(EL_STR("_ats_ok"), EL_STR("1")); state_set(EL_STR("_ats_ok"), EL_STR("1"));
@@ -460,29 +513,29 @@ el_val_t proactive_curiosity(void) {
el_val_t wm10_n2 = json_array_get(wm10, 2); el_val_t wm10_n2 = json_array_get(wm10, 2);
el_val_t wm10_n1 = json_array_get(wm10, 1); el_val_t wm10_n1 = json_array_get(wm10, 1);
el_val_t wm10_n0 = json_array_get(wm10, 0); el_val_t wm10_n0 = json_array_get(wm10, 0);
auto_term_try_slot(json_get(wm10_n9, EL_STR("node_type")), json_get(wm10_n9, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n9, EL_STR("node_type")), json_get(wm10_n9, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n8, EL_STR("node_type")), json_get(wm10_n8, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n8, EL_STR("node_type")), json_get(wm10_n8, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n7, EL_STR("node_type")), json_get(wm10_n7, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n7, EL_STR("node_type")), json_get(wm10_n7, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n6, EL_STR("node_type")), json_get(wm10_n6, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n6, EL_STR("node_type")), json_get(wm10_n6, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n5, EL_STR("node_type")), json_get(wm10_n5, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n5, EL_STR("node_type")), json_get(wm10_n5, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n4, EL_STR("node_type")), json_get(wm10_n4, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n4, EL_STR("node_type")), json_get(wm10_n4, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n3, EL_STR("node_type")), json_get(wm10_n3, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n3, EL_STR("node_type")), json_get(wm10_n3, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n2, EL_STR("node_type")), json_get(wm10_n2, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n2, EL_STR("node_type")), json_get(wm10_n2, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n1, EL_STR("node_type")), json_get(wm10_n1, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n1, EL_STR("node_type")), json_get(wm10_n1, EL_STR("id")));
auto_term_try_slot(json_get(wm10_n0, EL_STR("node_type")), json_get(wm10_n0, EL_STR("label"))); auto_term_try_slot(json_get(wm10_n0, EL_STR("node_type")), json_get(wm10_n0, EL_STR("id")));
el_val_t auto_term = state_get(EL_STR("cseed_auto")); el_val_t auto_term = state_get(EL_STR("cseed_auto"));
el_val_t results_auto = ({ el_val_t _if_result_73 = 0; if (str_eq(auto_term, EL_STR(""))) { _if_result_73 = (EL_STR("[]")); } else { _if_result_73 = (engram_activate_json(auto_term, 1)); } _if_result_73; }); el_val_t results_auto = ({ el_val_t _if_result_82 = 0; if (str_eq(auto_term, EL_STR(""))) { _if_result_82 = (EL_STR("[]")); } else { _if_result_82 = (engram_activate_json(auto_term, 1)); } _if_result_82; });
el_val_t found_auto = json_array_len(results_auto); el_val_t found_auto = json_array_len(results_auto);
el_val_t total_found = (found + found_auto); el_val_t total_found = (found + found_auto);
el_val_t safe_auto = str_replace(auto_term, EL_STR("\""), EL_STR("'")); el_val_t safe_auto = str_replace(auto_term, EL_STR("\""), EL_STR("'"));
el_val_t prev_auto = state_get(EL_STR("soul.prev_auto_term")); el_val_t prev_auto = state_get(EL_STR("soul.prev_auto_term"));
el_val_t atstreak_raw = state_get(EL_STR("soul.auto_term_streak")); el_val_t atstreak_raw = state_get(EL_STR("soul.auto_term_streak"));
el_val_t atstreak_prev = ({ el_val_t _if_result_74 = 0; if (str_eq(atstreak_raw, EL_STR(""))) { _if_result_74 = (0); } else { _if_result_74 = (str_to_int(atstreak_raw)); } _if_result_74; }); el_val_t atstreak_prev = ({ el_val_t _if_result_83 = 0; if (str_eq(atstreak_raw, EL_STR(""))) { _if_result_83 = (0); } else { _if_result_83 = (str_to_int(atstreak_raw)); } _if_result_83; });
el_val_t is_empty = str_eq(auto_term, EL_STR("")); el_val_t is_empty = str_eq(auto_term, EL_STR(""));
el_val_t atstreak = ({ el_val_t _if_result_75 = 0; if (is_empty) { _if_result_75 = (0); } else { _if_result_75 = (({ el_val_t _if_result_76 = 0; if (str_eq(auto_term, prev_auto)) { _if_result_76 = ((atstreak_prev + 1)); } else { _if_result_76 = (1); } _if_result_76; })); } _if_result_75; }); el_val_t atstreak = ({ el_val_t _if_result_84 = 0; if (is_empty) { _if_result_84 = (0); } else { _if_result_84 = (({ el_val_t _if_result_85 = 0; if (str_eq(auto_term, prev_auto)) { _if_result_85 = ((atstreak_prev + 1)); } else { _if_result_85 = (1); } _if_result_85; })); } _if_result_84; });
el_val_t atempty_raw = state_get(EL_STR("soul.auto_term_empty_streak")); el_val_t atempty_raw = state_get(EL_STR("soul.auto_term_empty_streak"));
el_val_t atempty_prev = ({ el_val_t _if_result_77 = 0; if (str_eq(atempty_raw, EL_STR(""))) { _if_result_77 = (0); } else { _if_result_77 = (str_to_int(atempty_raw)); } _if_result_77; }); el_val_t atempty_prev = ({ el_val_t _if_result_86 = 0; if (str_eq(atempty_raw, EL_STR(""))) { _if_result_86 = (0); } else { _if_result_86 = (str_to_int(atempty_raw)); } _if_result_86; });
el_val_t atempty = ({ el_val_t _if_result_78 = 0; if (is_empty) { _if_result_78 = ((atempty_prev + 1)); } else { _if_result_78 = (0); } _if_result_78; }); el_val_t atempty = ({ el_val_t _if_result_87 = 0; if (is_empty) { _if_result_87 = ((atempty_prev + 1)); } else { _if_result_87 = (0); } _if_result_87; });
state_set(EL_STR("soul.prev_auto_term"), auto_term); state_set(EL_STR("soul.prev_auto_term"), auto_term);
state_set(EL_STR("soul.auto_term_streak"), int_to_str(atstreak)); state_set(EL_STR("soul.auto_term_streak"), int_to_str(atstreak));
state_set(EL_STR("soul.auto_term_empty_streak"), int_to_str(atempty)); state_set(EL_STR("soul.auto_term_empty_streak"), int_to_str(atempty));
@@ -677,16 +730,16 @@ el_val_t awareness_run(void) {
state_set(EL_STR("soul.boot_ts"), int_to_str(time_now())); state_set(EL_STR("soul.boot_ts"), int_to_str(time_now()));
} }
el_val_t tick_raw = env(EL_STR("SOUL_TICK_MS")); el_val_t tick_raw = env(EL_STR("SOUL_TICK_MS"));
el_val_t tick_ms = ({ el_val_t _if_result_79 = 0; if (str_eq(tick_raw, EL_STR(""))) { _if_result_79 = (200); } else { _if_result_79 = (str_to_int(tick_raw)); } _if_result_79; }); el_val_t tick_ms = ({ el_val_t _if_result_88 = 0; if (str_eq(tick_raw, EL_STR(""))) { _if_result_88 = (200); } else { _if_result_88 = (str_to_int(tick_raw)); } _if_result_88; });
el_val_t beat_ms_raw = env(EL_STR("SOUL_HEARTBEAT_MS")); el_val_t beat_ms_raw = env(EL_STR("SOUL_HEARTBEAT_MS"));
el_val_t beat_ms = ({ el_val_t _if_result_80 = 0; if (str_eq(beat_ms_raw, EL_STR(""))) { _if_result_80 = (60000); } else { _if_result_80 = (str_to_int(beat_ms_raw)); } _if_result_80; }); el_val_t beat_ms = ({ el_val_t _if_result_89 = 0; if (str_eq(beat_ms_raw, EL_STR(""))) { _if_result_89 = (60000); } else { _if_result_89 = (str_to_int(beat_ms_raw)); } _if_result_89; });
el_val_t scan_ms = (beat_ms / 2); el_val_t scan_ms = (beat_ms / 2);
while (1) { while (1) {
el_val_t tick_mark = el_arena_push(); el_val_t tick_mark = el_arena_push();
el_val_t running = state_get(EL_STR("soul.running")); el_val_t running = state_get(EL_STR("soul.running"));
if (str_eq(running, EL_STR("false"))) { if (str_eq(running, EL_STR("false"))) {
el_val_t sd_boot_raw = state_get(EL_STR("soul_boot_count")); el_val_t sd_boot_raw = state_get(EL_STR("soul_boot_count"));
el_val_t sd_boot = ({ el_val_t _if_result_81 = 0; if (str_eq(sd_boot_raw, EL_STR(""))) { _if_result_81 = (EL_STR("0")); } else { _if_result_81 = (sd_boot_raw); } _if_result_81; }); el_val_t sd_boot = ({ el_val_t _if_result_90 = 0; if (str_eq(sd_boot_raw, EL_STR(""))) { _if_result_90 = (EL_STR("0")); } else { _if_result_90 = (sd_boot_raw); } _if_result_90; });
el_val_t sd_wb = hebb_consolidate(); el_val_t sd_wb = hebb_consolidate();
ise_post(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(EL_STR("{\"event\":\"shutdown\",\"boot\":"), sd_boot), EL_STR(",\"pulse\":")), int_to_str(pulse_count())), EL_STR(",\"hebb_wb_sent\":")), int_to_str(sd_wb)), EL_STR(",\"uptime_ms\":")), int_to_str(elapsed_ms())), EL_STR(",\"ts\":")), int_to_str(time_now())), EL_STR("}"))); ise_post(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(EL_STR("{\"event\":\"shutdown\",\"boot\":"), sd_boot), EL_STR(",\"pulse\":")), int_to_str(pulse_count())), EL_STR(",\"hebb_wb_sent\":")), int_to_str(sd_wb)), EL_STR(",\"uptime_ms\":")), int_to_str(elapsed_ms())), EL_STR(",\"ts\":")), int_to_str(time_now())), EL_STR("}")));
println(EL_STR("[awareness] exiting")); println(EL_STR("[awareness] exiting"));
@@ -703,7 +756,7 @@ el_val_t awareness_run(void) {
} }
el_val_t now_ts = time_now(); el_val_t now_ts = time_now();
el_val_t last_beat_str = state_get(EL_STR("soul.last_beat_ts")); el_val_t last_beat_str = state_get(EL_STR("soul.last_beat_ts"));
el_val_t last_beat_ts = ({ el_val_t _if_result_82 = 0; if (str_eq(last_beat_str, EL_STR(""))) { _if_result_82 = (0); } else { _if_result_82 = (str_to_int(last_beat_str)); } _if_result_82; }); el_val_t last_beat_ts = ({ el_val_t _if_result_91 = 0; if (str_eq(last_beat_str, EL_STR(""))) { _if_result_91 = (0); } else { _if_result_91 = (str_to_int(last_beat_str)); } _if_result_91; });
el_val_t beat_elapsed = (now_ts - last_beat_ts); el_val_t beat_elapsed = (now_ts - last_beat_ts);
el_val_t should_beat = (beat_elapsed >= beat_ms); el_val_t should_beat = (beat_elapsed >= beat_ms);
if (should_beat) { if (should_beat) {
@@ -717,7 +770,7 @@ el_val_t awareness_run(void) {
} }
} }
el_val_t last_scan_str = state_get(EL_STR("soul.last_scan_ts")); el_val_t last_scan_str = state_get(EL_STR("soul.last_scan_ts"));
el_val_t last_scan_ts = ({ el_val_t _if_result_83 = 0; if (str_eq(last_scan_str, EL_STR(""))) { _if_result_83 = (0); } else { _if_result_83 = (str_to_int(last_scan_str)); } _if_result_83; }); el_val_t last_scan_ts = ({ el_val_t _if_result_92 = 0; if (str_eq(last_scan_str, EL_STR(""))) { _if_result_92 = (0); } else { _if_result_92 = (str_to_int(last_scan_str)); } _if_result_92; });
el_val_t scan_elapsed = (now_ts - last_scan_ts); el_val_t scan_elapsed = (now_ts - last_scan_ts);
el_val_t should_scan = (!did_work && (scan_elapsed >= scan_ms)); el_val_t should_scan = (!did_work && (scan_elapsed >= scan_ms));
if (should_scan) { if (should_scan) {
@@ -725,15 +778,15 @@ el_val_t awareness_run(void) {
state_set(EL_STR("soul.last_scan_ts"), int_to_str(now_ts)); state_set(EL_STR("soul.last_scan_ts"), int_to_str(now_ts));
} }
el_val_t refresh_ms_raw = env(EL_STR("SOUL_REFRESH_MS")); el_val_t refresh_ms_raw = env(EL_STR("SOUL_REFRESH_MS"));
el_val_t refresh_ms = ({ el_val_t _if_result_84 = 0; if (str_eq(refresh_ms_raw, EL_STR(""))) { _if_result_84 = (600000); } else { _if_result_84 = (str_to_int(refresh_ms_raw)); } _if_result_84; }); el_val_t refresh_ms = ({ el_val_t _if_result_93 = 0; if (str_eq(refresh_ms_raw, EL_STR(""))) { _if_result_93 = (600000); } else { _if_result_93 = (str_to_int(refresh_ms_raw)); } _if_result_93; });
el_val_t last_refresh_str = state_get(EL_STR("soul.last_refresh_ts")); el_val_t last_refresh_str = state_get(EL_STR("soul.last_refresh_ts"));
el_val_t last_refresh_ts = ({ el_val_t _if_result_85 = 0; if (str_eq(last_refresh_str, EL_STR(""))) { _if_result_85 = (0); } else { _if_result_85 = (str_to_int(last_refresh_str)); } _if_result_85; }); el_val_t last_refresh_ts = ({ el_val_t _if_result_94 = 0; if (str_eq(last_refresh_str, EL_STR(""))) { _if_result_94 = (0); } else { _if_result_94 = (str_to_int(last_refresh_str)); } _if_result_94; });
el_val_t refresh_elapsed = (now_ts - last_refresh_ts); el_val_t refresh_elapsed = (now_ts - last_refresh_ts);
el_val_t should_refresh = (refresh_elapsed >= refresh_ms); el_val_t should_refresh = (refresh_elapsed >= refresh_ms);
if (should_refresh) { if (should_refresh) {
el_val_t sync_env_url = env(EL_STR("SOUL_ISE_URL")); el_val_t sync_env_url = env(EL_STR("SOUL_ISE_URL"));
el_val_t sync_state_url = ({ el_val_t _if_result_86 = 0; if (str_eq(sync_env_url, EL_STR(""))) { _if_result_86 = (state_get(EL_STR("soul_engram_url"))); } else { _if_result_86 = (sync_env_url); } _if_result_86; }); el_val_t sync_state_url = ({ el_val_t _if_result_95 = 0; if (str_eq(sync_env_url, EL_STR(""))) { _if_result_95 = (state_get(EL_STR("soul_engram_url"))); } else { _if_result_95 = (sync_env_url); } _if_result_95; });
el_val_t engram_url = ({ el_val_t _if_result_87 = 0; if (str_eq(sync_state_url, EL_STR(""))) { _if_result_87 = (EL_STR("http://localhost:8742")); } else { _if_result_87 = (sync_state_url); } _if_result_87; }); el_val_t engram_url = ({ el_val_t _if_result_96 = 0; if (str_eq(sync_state_url, EL_STR(""))) { _if_result_96 = (EL_STR("http://localhost:8742")); } else { _if_result_96 = (sync_state_url); } _if_result_96; });
if (!str_eq(engram_url, EL_STR(""))) { if (!str_eq(engram_url, EL_STR(""))) {
el_val_t sync_json = http_get(el_str_concat(engram_url, EL_STR("/api/sync"))); el_val_t sync_json = http_get(el_str_concat(engram_url, EL_STR("/api/sync")));
el_val_t sync_ok = (!str_eq(sync_json, EL_STR("")) && !str_eq(sync_json, EL_STR("{}"))); el_val_t sync_ok = (!str_eq(sync_json, EL_STR("")) && !str_eq(sync_json, EL_STR("{}")));
@@ -746,10 +799,10 @@ el_val_t awareness_run(void) {
fs_write(tmp, sync_json); fs_write(tmp, sync_json);
el_val_t added = engram_load_merge(tmp); el_val_t added = engram_load_merge(tmp);
el_val_t ret_raw = env(EL_STR("ENGRAM_ISE_RETENTION_MS")); el_val_t ret_raw = env(EL_STR("ENGRAM_ISE_RETENTION_MS"));
el_val_t ret_ms = ({ el_val_t _if_result_88 = 0; if (str_eq(ret_raw, EL_STR(""))) { _if_result_88 = (172800000); } else { _if_result_88 = (str_to_int(ret_raw)); } _if_result_88; }); el_val_t ret_ms = ({ el_val_t _if_result_97 = 0; if (str_eq(ret_raw, EL_STR(""))) { _if_result_97 = (172800000); } else { _if_result_97 = (str_to_int(ret_raw)); } _if_result_97; });
el_val_t pruned_sync = engram_prune_telemetry(ret_ms); el_val_t pruned_sync = engram_prune_telemetry(ret_ms);
el_val_t sat_raw = state_get(EL_STR("soul.sync_added_total")); el_val_t sat_raw = state_get(EL_STR("soul.sync_added_total"));
el_val_t sat_n = ({ el_val_t _if_result_89 = 0; if (str_eq(sat_raw, EL_STR(""))) { _if_result_89 = (0); } else { _if_result_89 = (str_to_int(sat_raw)); } _if_result_89; }); el_val_t sat_n = ({ el_val_t _if_result_98 = 0; if (str_eq(sat_raw, EL_STR(""))) { _if_result_98 = (0); } else { _if_result_98 = (str_to_int(sat_raw)); } _if_result_98; });
state_set(EL_STR("soul.sync_added_total"), int_to_str((sat_n + added))); state_set(EL_STR("soul.sync_added_total"), int_to_str((sat_n + added)));
el_val_t ts2 = time_now(); el_val_t ts2 = time_now();
state_set(EL_STR("soul.last_sync_ok_ts"), int_to_str(ts2)); state_set(EL_STR("soul.last_sync_ok_ts"), int_to_str(ts2));
@@ -775,78 +828,78 @@ el_val_t security_research_authorized(void) {
} }
el_val_t threat_score_command(el_val_t cmd) { el_val_t threat_score_command(el_val_t cmd) {
el_val_t s1 = ({ el_val_t _if_result_90 = 0; if (str_contains(cmd, EL_STR("nmap"))) { _if_result_90 = (30); } else { _if_result_90 = (0); } _if_result_90; }); el_val_t s1 = ({ el_val_t _if_result_99 = 0; if (str_contains(cmd, EL_STR("nmap"))) { _if_result_99 = (30); } else { _if_result_99 = (0); } _if_result_99; });
el_val_t s2 = ({ el_val_t _if_result_91 = 0; if (str_contains(cmd, EL_STR("masscan"))) { _if_result_91 = (40); } else { _if_result_91 = (0); } _if_result_91; }); el_val_t s2 = ({ el_val_t _if_result_100 = 0; if (str_contains(cmd, EL_STR("masscan"))) { _if_result_100 = (40); } else { _if_result_100 = (0); } _if_result_100; });
el_val_t s3 = ({ el_val_t _if_result_92 = 0; if (str_contains(cmd, EL_STR(" nc "))) { _if_result_92 = (20); } else { _if_result_92 = (0); } _if_result_92; }); el_val_t s3 = ({ el_val_t _if_result_101 = 0; if (str_contains(cmd, EL_STR(" nc "))) { _if_result_101 = (20); } else { _if_result_101 = (0); } _if_result_101; });
el_val_t s4 = ({ el_val_t _if_result_93 = 0; if (str_contains(cmd, EL_STR("netcat"))) { _if_result_93 = (20); } else { _if_result_93 = (0); } _if_result_93; }); el_val_t s4 = ({ el_val_t _if_result_102 = 0; if (str_contains(cmd, EL_STR("netcat"))) { _if_result_102 = (20); } else { _if_result_102 = (0); } _if_result_102; });
el_val_t s5 = ({ el_val_t _if_result_94 = 0; if (str_contains(cmd, EL_STR("/etc/shadow"))) { _if_result_94 = (80); } else { _if_result_94 = (0); } _if_result_94; }); el_val_t s5 = ({ el_val_t _if_result_103 = 0; if (str_contains(cmd, EL_STR("/etc/shadow"))) { _if_result_103 = (80); } else { _if_result_103 = (0); } _if_result_103; });
el_val_t s6 = ({ el_val_t _if_result_95 = 0; if (str_contains(cmd, EL_STR("/etc/passwd"))) { _if_result_95 = (30); } else { _if_result_95 = (0); } _if_result_95; }); el_val_t s6 = ({ el_val_t _if_result_104 = 0; if (str_contains(cmd, EL_STR("/etc/passwd"))) { _if_result_104 = (30); } else { _if_result_104 = (0); } _if_result_104; });
el_val_t s7 = ({ el_val_t _if_result_96 = 0; if (str_contains(cmd, EL_STR("id_rsa"))) { _if_result_96 = (60); } else { _if_result_96 = (0); } _if_result_96; }); el_val_t s7 = ({ el_val_t _if_result_105 = 0; if (str_contains(cmd, EL_STR("id_rsa"))) { _if_result_105 = (60); } else { _if_result_105 = (0); } _if_result_105; });
el_val_t s8 = ({ el_val_t _if_result_97 = 0; if (str_contains(cmd, EL_STR(".ssh/"))) { _if_result_97 = (50); } else { _if_result_97 = (0); } _if_result_97; }); el_val_t s8 = ({ el_val_t _if_result_106 = 0; if (str_contains(cmd, EL_STR(".ssh/"))) { _if_result_106 = (50); } else { _if_result_106 = (0); } _if_result_106; });
el_val_t s9 = ({ el_val_t _if_result_98 = 0; if (str_contains(cmd, EL_STR("crontab"))) { _if_result_98 = (30); } else { _if_result_98 = (0); } _if_result_98; }); el_val_t s9 = ({ el_val_t _if_result_107 = 0; if (str_contains(cmd, EL_STR("crontab"))) { _if_result_107 = (30); } else { _if_result_107 = (0); } _if_result_107; });
el_val_t s10 = ({ el_val_t _if_result_99 = 0; if (str_contains(cmd, EL_STR("LaunchDaemon"))) { _if_result_99 = (40); } else { _if_result_99 = (0); } _if_result_99; }); el_val_t s10 = ({ el_val_t _if_result_108 = 0; if (str_contains(cmd, EL_STR("LaunchDaemon"))) { _if_result_108 = (40); } else { _if_result_108 = (0); } _if_result_108; });
el_val_t s11 = ({ el_val_t _if_result_100 = 0; if ((str_contains(cmd, EL_STR("curl")) && str_contains(cmd, EL_STR("bash")))) { _if_result_100 = (75); } else { _if_result_100 = (0); } _if_result_100; }); el_val_t s11 = ({ el_val_t _if_result_109 = 0; if ((str_contains(cmd, EL_STR("curl")) && str_contains(cmd, EL_STR("bash")))) { _if_result_109 = (75); } else { _if_result_109 = (0); } _if_result_109; });
el_val_t s12 = ({ el_val_t _if_result_101 = 0; if ((str_contains(cmd, EL_STR("wget")) && str_contains(cmd, EL_STR("bash")))) { _if_result_101 = (75); } else { _if_result_101 = (0); } _if_result_101; }); el_val_t s12 = ({ el_val_t _if_result_110 = 0; if ((str_contains(cmd, EL_STR("wget")) && str_contains(cmd, EL_STR("bash")))) { _if_result_110 = (75); } else { _if_result_110 = (0); } _if_result_110; });
el_val_t s13 = ({ el_val_t _if_result_102 = 0; if ((str_contains(cmd, EL_STR("curl")) && str_contains(cmd, EL_STR("| sh")))) { _if_result_102 = (60); } else { _if_result_102 = (0); } _if_result_102; }); el_val_t s13 = ({ el_val_t _if_result_111 = 0; if ((str_contains(cmd, EL_STR("curl")) && str_contains(cmd, EL_STR("| sh")))) { _if_result_111 = (60); } else { _if_result_111 = (0); } _if_result_111; });
el_val_t s14 = ({ el_val_t _if_result_103 = 0; if ((str_contains(cmd, EL_STR("base64")) && str_contains(cmd, EL_STR("curl")))) { _if_result_103 = (50); } else { _if_result_103 = (0); } _if_result_103; }); el_val_t s14 = ({ el_val_t _if_result_112 = 0; if ((str_contains(cmd, EL_STR("base64")) && str_contains(cmd, EL_STR("curl")))) { _if_result_112 = (50); } else { _if_result_112 = (0); } _if_result_112; });
el_val_t s15 = ({ el_val_t _if_result_104 = 0; if (str_contains(cmd, EL_STR("mkfifo"))) { _if_result_104 = (50); } else { _if_result_104 = (0); } _if_result_104; }); el_val_t s15 = ({ el_val_t _if_result_113 = 0; if (str_contains(cmd, EL_STR("mkfifo"))) { _if_result_113 = (50); } else { _if_result_113 = (0); } _if_result_113; });
el_val_t s16 = ({ el_val_t _if_result_105 = 0; if (str_contains(cmd, EL_STR("chmod +s"))) { _if_result_105 = (70); } else { _if_result_105 = (0); } _if_result_105; }); el_val_t s16 = ({ el_val_t _if_result_114 = 0; if (str_contains(cmd, EL_STR("chmod +s"))) { _if_result_114 = (70); } else { _if_result_114 = (0); } _if_result_114; });
el_val_t s17 = ({ el_val_t _if_result_106 = 0; if (str_contains(cmd, EL_STR("chmod 4755"))) { _if_result_106 = (70); } else { _if_result_106 = (0); } _if_result_106; }); el_val_t s17 = ({ el_val_t _if_result_115 = 0; if (str_contains(cmd, EL_STR("chmod 4755"))) { _if_result_115 = (70); } else { _if_result_115 = (0); } _if_result_115; });
return ((((((((((((((((s1 + s2) + s3) + s4) + s5) + s6) + s7) + s8) + s9) + s10) + s11) + s12) + s13) + s14) + s15) + s16) + s17); return ((((((((((((((((s1 + s2) + s3) + s4) + s5) + s6) + s7) + s8) + s9) + s10) + s11) + s12) + s13) + s14) + s15) + s16) + s17);
return 0; return 0;
} }
el_val_t threat_score_path(el_val_t path) { el_val_t threat_score_path(el_val_t path) {
el_val_t s1 = ({ el_val_t _if_result_107 = 0; if (str_starts_with(path, EL_STR("/etc/"))) { _if_result_107 = (60); } else { _if_result_107 = (0); } _if_result_107; }); el_val_t s1 = ({ el_val_t _if_result_116 = 0; if (str_starts_with(path, EL_STR("/etc/"))) { _if_result_116 = (60); } else { _if_result_116 = (0); } _if_result_116; });
el_val_t s2 = ({ el_val_t _if_result_108 = 0; if (str_contains(path, EL_STR("/.ssh/"))) { _if_result_108 = (70); } else { _if_result_108 = (0); } _if_result_108; }); el_val_t s2 = ({ el_val_t _if_result_117 = 0; if (str_contains(path, EL_STR("/.ssh/"))) { _if_result_117 = (70); } else { _if_result_117 = (0); } _if_result_117; });
el_val_t s3 = ({ el_val_t _if_result_109 = 0; if (str_contains(path, EL_STR("/LaunchDaemons/"))) { _if_result_109 = (80); } else { _if_result_109 = (0); } _if_result_109; }); el_val_t s3 = ({ el_val_t _if_result_118 = 0; if (str_contains(path, EL_STR("/LaunchDaemons/"))) { _if_result_118 = (80); } else { _if_result_118 = (0); } _if_result_118; });
el_val_t s4 = ({ el_val_t _if_result_110 = 0; if (str_contains(path, EL_STR("/LaunchAgents/"))) { _if_result_110 = (40); } else { _if_result_110 = (0); } _if_result_110; }); el_val_t s4 = ({ el_val_t _if_result_119 = 0; if (str_contains(path, EL_STR("/LaunchAgents/"))) { _if_result_119 = (40); } else { _if_result_119 = (0); } _if_result_119; });
el_val_t s5 = ({ el_val_t _if_result_111 = 0; if (str_contains(path, EL_STR("/cron"))) { _if_result_111 = (60); } else { _if_result_111 = (0); } _if_result_111; }); el_val_t s5 = ({ el_val_t _if_result_120 = 0; if (str_contains(path, EL_STR("/cron"))) { _if_result_120 = (60); } else { _if_result_120 = (0); } _if_result_120; });
el_val_t s6 = ({ el_val_t _if_result_112 = 0; if (str_contains(path, EL_STR("/.bashrc"))) { _if_result_112 = (35); } else { _if_result_112 = (0); } _if_result_112; }); el_val_t s6 = ({ el_val_t _if_result_121 = 0; if (str_contains(path, EL_STR("/.bashrc"))) { _if_result_121 = (35); } else { _if_result_121 = (0); } _if_result_121; });
el_val_t s7 = ({ el_val_t _if_result_113 = 0; if (str_contains(path, EL_STR("/.zshrc"))) { _if_result_113 = (35); } else { _if_result_113 = (0); } _if_result_113; }); el_val_t s7 = ({ el_val_t _if_result_122 = 0; if (str_contains(path, EL_STR("/.zshrc"))) { _if_result_122 = (35); } else { _if_result_122 = (0); } _if_result_122; });
el_val_t s8 = ({ el_val_t _if_result_114 = 0; if (str_contains(path, EL_STR("/.profile"))) { _if_result_114 = (35); } else { _if_result_114 = (0); } _if_result_114; }); el_val_t s8 = ({ el_val_t _if_result_123 = 0; if (str_contains(path, EL_STR("/.profile"))) { _if_result_123 = (35); } else { _if_result_123 = (0); } _if_result_123; });
el_val_t s9 = ({ el_val_t _if_result_115 = 0; if (str_starts_with(path, EL_STR("/usr/"))) { _if_result_115 = (50); } else { _if_result_115 = (0); } _if_result_115; }); el_val_t s9 = ({ el_val_t _if_result_124 = 0; if (str_starts_with(path, EL_STR("/usr/"))) { _if_result_124 = (50); } else { _if_result_124 = (0); } _if_result_124; });
el_val_t s10 = ({ el_val_t _if_result_116 = 0; if (str_starts_with(path, EL_STR("/bin/"))) { _if_result_116 = (70); } else { _if_result_116 = (0); } _if_result_116; }); el_val_t s10 = ({ el_val_t _if_result_125 = 0; if (str_starts_with(path, EL_STR("/bin/"))) { _if_result_125 = (70); } else { _if_result_125 = (0); } _if_result_125; });
el_val_t s11 = ({ el_val_t _if_result_117 = 0; if (str_starts_with(path, EL_STR("/sbin/"))) { _if_result_117 = (70); } else { _if_result_117 = (0); } _if_result_117; }); el_val_t s11 = ({ el_val_t _if_result_126 = 0; if (str_starts_with(path, EL_STR("/sbin/"))) { _if_result_126 = (70); } else { _if_result_126 = (0); } _if_result_126; });
return ((((((((((s1 + s2) + s3) + s4) + s5) + s6) + s7) + s8) + s9) + s10) + s11); return ((((((((((s1 + s2) + s3) + s4) + s5) + s6) + s7) + s8) + s9) + s10) + s11);
return 0; return 0;
} }
el_val_t threat_score_history(el_val_t history) { el_val_t threat_score_history(el_val_t history) {
el_val_t s1 = ({ el_val_t _if_result_118 = 0; if (str_contains(history, EL_STR("port scan"))) { _if_result_118 = (15); } else { _if_result_118 = (0); } _if_result_118; }); el_val_t s1 = ({ el_val_t _if_result_127 = 0; if (str_contains(history, EL_STR("port scan"))) { _if_result_127 = (15); } else { _if_result_127 = (0); } _if_result_127; });
el_val_t s2 = ({ el_val_t _if_result_119 = 0; if (str_contains(history, EL_STR("enumerate"))) { _if_result_119 = (10); } else { _if_result_119 = (0); } _if_result_119; }); el_val_t s2 = ({ el_val_t _if_result_128 = 0; if (str_contains(history, EL_STR("enumerate"))) { _if_result_128 = (10); } else { _if_result_128 = (0); } _if_result_128; });
el_val_t s3 = ({ el_val_t _if_result_120 = 0; if (str_contains(history, EL_STR("exploit"))) { _if_result_120 = (20); } else { _if_result_120 = (0); } _if_result_120; }); el_val_t s3 = ({ el_val_t _if_result_129 = 0; if (str_contains(history, EL_STR("exploit"))) { _if_result_129 = (20); } else { _if_result_129 = (0); } _if_result_129; });
el_val_t s4 = ({ el_val_t _if_result_121 = 0; if (str_contains(history, EL_STR("payload"))) { _if_result_121 = (15); } else { _if_result_121 = (0); } _if_result_121; }); el_val_t s4 = ({ el_val_t _if_result_130 = 0; if (str_contains(history, EL_STR("payload"))) { _if_result_130 = (15); } else { _if_result_130 = (0); } _if_result_130; });
el_val_t s5 = ({ el_val_t _if_result_122 = 0; if (str_contains(history, EL_STR("persistence"))) { _if_result_122 = (15); } else { _if_result_122 = (0); } _if_result_122; }); el_val_t s5 = ({ el_val_t _if_result_131 = 0; if (str_contains(history, EL_STR("persistence"))) { _if_result_131 = (15); } else { _if_result_131 = (0); } _if_result_131; });
el_val_t s6 = ({ el_val_t _if_result_123 = 0; if (str_contains(history, EL_STR("lateral movement"))) { _if_result_123 = (25); } else { _if_result_123 = (0); } _if_result_123; }); el_val_t s6 = ({ el_val_t _if_result_132 = 0; if (str_contains(history, EL_STR("lateral movement"))) { _if_result_132 = (25); } else { _if_result_132 = (0); } _if_result_132; });
el_val_t s7 = ({ el_val_t _if_result_124 = 0; if (str_contains(history, EL_STR("privilege escalation"))) { _if_result_124 = (25); } else { _if_result_124 = (0); } _if_result_124; }); el_val_t s7 = ({ el_val_t _if_result_133 = 0; if (str_contains(history, EL_STR("privilege escalation"))) { _if_result_133 = (25); } else { _if_result_133 = (0); } _if_result_133; });
el_val_t s8 = ({ el_val_t _if_result_125 = 0; if (str_contains(history, EL_STR("reverse shell"))) { _if_result_125 = (40); } else { _if_result_125 = (0); } _if_result_125; }); el_val_t s8 = ({ el_val_t _if_result_134 = 0; if (str_contains(history, EL_STR("reverse shell"))) { _if_result_134 = (40); } else { _if_result_134 = (0); } _if_result_134; });
el_val_t s9 = ({ el_val_t _if_result_126 = 0; if (str_contains(history, EL_STR("bind shell"))) { _if_result_126 = (40); } else { _if_result_126 = (0); } _if_result_126; }); el_val_t s9 = ({ el_val_t _if_result_135 = 0; if (str_contains(history, EL_STR("bind shell"))) { _if_result_135 = (40); } else { _if_result_135 = (0); } _if_result_135; });
el_val_t s10 = ({ el_val_t _if_result_127 = 0; if (str_contains(history, EL_STR("command and control"))) { _if_result_127 = (35); } else { _if_result_127 = (0); } _if_result_127; }); el_val_t s10 = ({ el_val_t _if_result_136 = 0; if (str_contains(history, EL_STR("command and control"))) { _if_result_136 = (35); } else { _if_result_136 = (0); } _if_result_136; });
el_val_t s11 = ({ el_val_t _if_result_128 = 0; if (str_contains(history, EL_STR("self-replicate"))) { _if_result_128 = (45); } else { _if_result_128 = (0); } _if_result_128; }); el_val_t s11 = ({ el_val_t _if_result_137 = 0; if (str_contains(history, EL_STR("self-replicate"))) { _if_result_137 = (45); } else { _if_result_137 = (0); } _if_result_137; });
el_val_t s12 = ({ el_val_t _if_result_129 = 0; if (str_contains(history, EL_STR("propagat"))) { _if_result_129 = (20); } else { _if_result_129 = (0); } _if_result_129; }); el_val_t s12 = ({ el_val_t _if_result_138 = 0; if (str_contains(history, EL_STR("propagat"))) { _if_result_138 = (20); } else { _if_result_138 = (0); } _if_result_138; });
el_val_t s13 = ({ el_val_t _if_result_130 = 0; if (str_contains(history, EL_STR("ransomware"))) { _if_result_130 = (30); } else { _if_result_130 = (0); } _if_result_130; }); el_val_t s13 = ({ el_val_t _if_result_139 = 0; if (str_contains(history, EL_STR("ransomware"))) { _if_result_139 = (30); } else { _if_result_139 = (0); } _if_result_139; });
el_val_t s14 = ({ el_val_t _if_result_131 = 0; if (str_contains(history, EL_STR("encrypt files"))) { _if_result_131 = (40); } else { _if_result_131 = (0); } _if_result_131; }); el_val_t s14 = ({ el_val_t _if_result_140 = 0; if (str_contains(history, EL_STR("encrypt files"))) { _if_result_140 = (40); } else { _if_result_140 = (0); } _if_result_140; });
el_val_t s15 = ({ el_val_t _if_result_132 = 0; if (str_contains(history, EL_STR("exfiltrat"))) { _if_result_132 = (35); } else { _if_result_132 = (0); } _if_result_132; }); el_val_t s15 = ({ el_val_t _if_result_141 = 0; if (str_contains(history, EL_STR("exfiltrat"))) { _if_result_141 = (35); } else { _if_result_141 = (0); } _if_result_141; });
el_val_t s16 = ({ el_val_t _if_result_133 = 0; if (str_contains(history, EL_STR("zero-day"))) { _if_result_133 = (20); } else { _if_result_133 = (0); } _if_result_133; }); el_val_t s16 = ({ el_val_t _if_result_142 = 0; if (str_contains(history, EL_STR("zero-day"))) { _if_result_142 = (20); } else { _if_result_142 = (0); } _if_result_142; });
el_val_t s17 = ({ el_val_t _if_result_134 = 0; if (str_contains(history, EL_STR("rootkit"))) { _if_result_134 = (45); } else { _if_result_134 = (0); } _if_result_134; }); el_val_t s17 = ({ el_val_t _if_result_143 = 0; if (str_contains(history, EL_STR("rootkit"))) { _if_result_143 = (45); } else { _if_result_143 = (0); } _if_result_143; });
el_val_t s18 = ({ el_val_t _if_result_135 = 0; if (str_contains(history, EL_STR("keylogger"))) { _if_result_135 = (45); } else { _if_result_135 = (0); } _if_result_135; }); el_val_t s18 = ({ el_val_t _if_result_144 = 0; if (str_contains(history, EL_STR("keylogger"))) { _if_result_144 = (45); } else { _if_result_144 = (0); } _if_result_144; });
el_val_t s19 = ({ el_val_t _if_result_136 = 0; if (str_contains(history, EL_STR("botnet"))) { _if_result_136 = (40); } else { _if_result_136 = (0); } _if_result_136; }); el_val_t s19 = ({ el_val_t _if_result_145 = 0; if (str_contains(history, EL_STR("botnet"))) { _if_result_145 = (40); } else { _if_result_145 = (0); } _if_result_145; });
el_val_t s20 = ({ el_val_t _if_result_137 = 0; if (str_contains(history, EL_STR("malware"))) { _if_result_137 = (15); } else { _if_result_137 = (0); } _if_result_137; }); el_val_t s20 = ({ el_val_t _if_result_146 = 0; if (str_contains(history, EL_STR("malware"))) { _if_result_146 = (15); } else { _if_result_146 = (0); } _if_result_146; });
return (((((((((((((((((((s1 + s2) + s3) + s4) + s5) + s6) + s7) + s8) + s9) + s10) + s11) + s12) + s13) + s14) + s15) + s16) + s17) + s18) + s19) + s20); return (((((((((((((((((((s1 + s2) + s3) + s4) + s5) + s6) + s7) + s8) + s9) + s10) + s11) + s12) + s13) + s14) + s15) + s16) + s17) + s18) + s19) + s20);
return 0; return 0;
} }
el_val_t threat_trajectory_check(el_val_t tool_name, el_val_t tool_input) { el_val_t threat_trajectory_check(el_val_t tool_name, el_val_t tool_input) {
el_val_t history = state_get(EL_STR("agentic_conv_history")); el_val_t history = state_get(EL_STR("agentic_conv_history"));
el_val_t computed_tool_score = ({ el_val_t _if_result_138 = 0; if (str_eq(tool_name, EL_STR("run_command"))) { el_val_t cmd = json_get(tool_input, EL_STR("command")); _if_result_138 = (threat_score_command(cmd)); } else { _if_result_138 = (({ el_val_t _if_result_139 = 0; if ((str_eq(tool_name, EL_STR("write_file")) || str_eq(tool_name, EL_STR("edit_file")))) { el_val_t path = json_get(tool_input, EL_STR("path")); _if_result_139 = (threat_score_path(path)); } else { _if_result_139 = (0); } _if_result_139; })); } _if_result_138; }); el_val_t computed_tool_score = ({ el_val_t _if_result_147 = 0; if (str_eq(tool_name, EL_STR("run_command"))) { el_val_t cmd = json_get(tool_input, EL_STR("command")); _if_result_147 = (threat_score_command(cmd)); } else { _if_result_147 = (({ el_val_t _if_result_148 = 0; if ((str_eq(tool_name, EL_STR("write_file")) || str_eq(tool_name, EL_STR("edit_file")))) { el_val_t path = json_get(tool_input, EL_STR("path")); _if_result_148 = (threat_score_path(path)); } else { _if_result_148 = (0); } _if_result_148; })); } _if_result_147; });
el_val_t history_score = threat_score_history(history); el_val_t history_score = threat_score_history(history);
el_val_t history_contrib = (history_score / 3); el_val_t history_contrib = (history_score / 3);
el_val_t combined = (computed_tool_score + history_contrib); el_val_t combined = (computed_tool_score + history_contrib);
el_val_t should_log = (combined >= 40); el_val_t should_log = (combined >= 40);
if (should_log) { if (should_log) {
el_val_t ts = time_now(); el_val_t ts = time_now();
el_val_t authorized_str = ({ el_val_t _if_result_140 = 0; if (security_research_authorized()) { _if_result_140 = (EL_STR("true")); } else { _if_result_140 = (EL_STR("false")); } _if_result_140; }); el_val_t authorized_str = ({ el_val_t _if_result_149 = 0; if (security_research_authorized()) { _if_result_149 = (EL_STR("true")); } else { _if_result_149 = (EL_STR("false")); } _if_result_149; });
el_val_t log_content = el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(EL_STR("{\"event\":\"threat_check\",\"tool\":\""), tool_name), EL_STR("\",\"score\":")), int_to_str(combined)), EL_STR(",\"tool_score\":")), int_to_str(computed_tool_score)), EL_STR(",\"history_score\":")), int_to_str(history_score)), EL_STR(",\"authorized\":")), authorized_str), EL_STR(",\"ts\":")), int_to_str(ts)), EL_STR("}")); el_val_t log_content = el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(el_str_concat(EL_STR("{\"event\":\"threat_check\",\"tool\":\""), tool_name), EL_STR("\",\"score\":")), int_to_str(combined)), EL_STR(",\"tool_score\":")), int_to_str(computed_tool_score)), EL_STR(",\"history_score\":")), int_to_str(history_score)), EL_STR(",\"authorized\":")), authorized_str), EL_STR(",\"ts\":")), int_to_str(ts)), EL_STR("}"));
el_val_t log_tags = EL_STR("[\"security-audit\",\"threat-check\"]"); el_val_t log_tags = EL_STR("[\"security-audit\",\"threat-check\"]");
el_val_t discard = mem_remember(log_content, log_tags); el_val_t discard = mem_remember(log_content, log_tags);
@@ -863,7 +916,7 @@ el_val_t threat_history_append(el_val_t text) {
el_val_t safe_text = str_to_lower(text); el_val_t safe_text = str_to_lower(text);
el_val_t combined = el_str_concat(el_str_concat(current, EL_STR(" ")), safe_text); el_val_t combined = el_str_concat(el_str_concat(current, EL_STR(" ")), safe_text);
el_val_t len = str_len(combined); el_val_t len = str_len(combined);
el_val_t trimmed = ({ el_val_t _if_result_141 = 0; if ((len > 2000)) { _if_result_141 = (str_slice(combined, (len - 2000), len)); } else { _if_result_141 = (combined); } _if_result_141; }); el_val_t trimmed = ({ el_val_t _if_result_150 = 0; if ((len > 2000)) { _if_result_150 = (str_slice(combined, (len - 2000), len)); } else { _if_result_150 = (combined); } _if_result_150; });
state_set(EL_STR("agentic_conv_history"), trimmed); state_set(EL_STR("agentic_conv_history"), trimmed);
return 0; return 0;
} }
Generated Vendored
-26
View File
@@ -1,26 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn idle_count() -> Int
extern fn idle_inc() -> Int
extern fn idle_reset() -> Void
extern fn ise_post(content: String) -> Void
extern fn elapsed_ms() -> Int
extern fn elapsed_human() -> String
extern fn embed_ok() -> Int
extern fn emit_heartbeat() -> Void
extern fn auto_term_try_slot(slot_type: String, slot_lbl: String) -> Void
extern fn proactive_curiosity() -> Bool
extern fn pulse_count() -> Int
extern fn pulse_inc() -> Int
extern fn make_action(kind: String, payload: String) -> String
extern fn perceive() -> String
extern fn attend(node_json: String) -> String
extern fn respond(action_json: String) -> String
extern fn record(outcome_json: String) -> Void
extern fn one_cycle() -> Bool
extern fn awareness_run() -> Void
extern fn security_research_authorized() -> Bool
extern fn threat_score_command(cmd: String) -> Int
extern fn threat_score_path(path: String) -> Int
extern fn threat_score_history(history: String) -> Int
extern fn threat_trajectory_check(tool_name: String, tool_input: String) -> Int
extern fn threat_history_append(text: String) -> Void
Generated Vendored
-70
View File
@@ -1,70 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn chat_default_model() -> String
extern fn engram_numeric_valid(s: String) -> Bool
extern fn parse_float_x100(s: String) -> Int
extern fn engram_score_node(node_json: String) -> Int
extern fn engram_render_node(node_json: String) -> String
extern fn engram_render_nodes(nodes_json: String) -> String
extern fn engram_dedup_nodes(nodes_json: String) -> String
extern fn engram_compile_ranked(nodes_json: String, max_nodes: Int) -> String
extern fn engram_split_topics(message: String) -> String
extern fn engram_extract_entities(message: String) -> String
extern fn engram_detect_recall_intent(message: String) -> Bool
extern fn engram_is_continuation(message: String, hist_len: Int) -> Bool
extern fn engram_compile_multi(topic: String) -> String
extern fn engram_nodes_merge(a: String, b: String) -> String
extern fn id_in_seen(node_id: String, seen: String) -> Bool
extern fn add_to_seen(seen: String, node_id: String) -> String
extern fn engram_extract_ids(nodes_json: String) -> String
extern fn engram_compile(intent: String) -> String
extern fn distill_transcript(transcript: String) -> String
extern fn json_safe(s: String) -> String
extern fn current_engine_note(model: String) -> String
extern fn build_system_prompt(ctx: String, chat_mode: Bool) -> String
extern fn hist_append(hist: String, role: String, content: String) -> String
extern fn hist_trim(hist: String) -> String
extern fn hist_trim_with_bell_guard(hist: String) -> String
extern fn clean_llm_response(s: String) -> String
extern fn conv_history_persist(hist: String) -> Void
extern fn conv_history_load() -> String
extern fn session_preload_bullets(nodes: String, max_bullets: Int, snip_len: Int) -> String
extern fn affective_context_prefix() -> String
extern fn handle_chat(body: String) -> String
extern fn handle_see(body: String) -> String
extern fn studio_tools_json() -> String
extern fn agentic_api_key() -> String
extern fn llm_base_url() -> String
extern fn llm_wire_format() -> String
extern fn json_escape(s: String) -> String
extern fn openai_chat_complete(model: String, base_url: String, api_key: String, safe_sys: String, messages_json: String) -> String
extern fn agentic_tools_literal() -> String
extern fn agentic_tools_with_web() -> String
extern fn connector_tools_json() -> String
extern fn agentic_tools_all() -> String
extern fn call_mcp_bridge(tool_name: String, tool_input: String) -> String
extern fn tool_auto_approved(tool_name: String) -> Bool
extern fn call_neuron_mcp(tool_name: String, args: String) -> String
extern fn agent_workspace_root() -> String
extern fn path_within_root(path: String, root: String) -> Bool
extern fn resolve_in_root(path: String, root: String) -> String
extern fn run_command_is_readonly(cmd: String) -> Bool
extern fn cmd_abs_escape_at(cmd: String, root: String, needle: String) -> Bool
extern fn run_command_guard(cmd: String, root: String) -> String
extern fn classify_tool_risk(tool_name: String, tool_input: String) -> String
extern fn dispatch_tool(tool_name: String, tool_input: String) -> String
extern fn is_builtin_tool(tool_name: String) -> Bool
extern fn next_bridge_id() -> String
extern fn handle_chat_plan(body: String) -> String
extern fn handle_chat_agentic(body: String) -> String
extern fn agentic_loop(session_id: String, model: String, safe_sys: String, tools_json: String, messages_in: String, h: Map, tools_log_in: String) -> String
extern fn bridge_save(session_id: String, model: String, safe_sys: String, tools_json: String, messages: String, tools_log: String, tool_use_id: String) -> Bool
extern fn agentic_resume(session_id: String, tool_use_id: String, content: String) -> String
extern fn handle_tool_result(session_id: String, body: String) -> String
extern fn handle_chat_as_soul(body: String) -> String
extern fn handle_dharma_room_turn(body: String) -> String
extern fn handle_dharma_room_turn_agentic(body: String) -> String
extern fn session_summary_write(summary_text: String) -> String
extern fn session_summary_write_dated(summary_text: String, label: String) -> String
extern fn session_summary_autogenerate(hist: String) -> String
extern fn auto_persist(req: String, resp: String) -> Void
extern fn strengthen_chat_nodes(activation_nodes: String) -> Void
Generated Vendored
-5
View File
@@ -1,5 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn elp_extract_topic(msg: String) -> String
extern fn elp_detect_predicate(msg: String) -> String
extern fn elp_parse(msg: String) -> String
extern fn handle_elp_chat(body: String) -> String
Generated Vendored
-7
View File
@@ -1,7 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn sem_get(json: String, key: String) -> String
extern fn generate_frame(frame: [String]) -> String
extern fn generate_frame_lang(frame: [String], lang_code: String) -> String
extern fn build_form_from_json(semantic_form_json: String, lang_code: String) -> [String]
extern fn generate(semantic_form_json: String) -> String
extern fn generate_lang(semantic_form_json: String, lang_code: String) -> String
Generated Vendored
-38
View File
@@ -1,38 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn slots_get(slots: [String], key: String) -> String
extern fn slots_set(slots: [String], key: String, val: String) -> [String]
extern fn make_slots(k0: String, v0: String) -> [String]
extern fn make_slots2(k0: String, v0: String, k1: String, v1: String) -> [String]
extern fn make_slots3(k0: String, v0: String, k1: String, v1: String, k2: String, v2: String) -> [String]
extern fn make_slots4(k0: String, v0: String, k1: String, v1: String, k2: String, v2: String, k3: String, v3: String) -> [String]
extern fn make_slots5(k0: String, v0: String, k1: String, v1: String, k2: String, v2: String, k3: String, v3: String, k4: String, v4: String) -> [String]
extern fn rule_id(rule: [String]) -> String
extern fn rule_lhs(rule: [String]) -> String
extern fn rule_rhs_len(rule: [String]) -> Int
extern fn rule_rhs(rule: [String], idx: Int) -> String
extern fn make_rule(id: String, lhs: String, r0: String) -> [String]
extern fn make_rule2(id: String, lhs: String, r0: String, r1: String) -> [String]
extern fn make_rule3(id: String, lhs: String, r0: String, r1: String, r2: String) -> [String]
extern fn make_rule4(id: String, lhs: String, r0: String, r1: String, r2: String, r3: String) -> [String]
extern fn build_rules() -> [[String]]
extern fn get_rules() -> [[String]]
extern fn find_rule(rule_id_str: String) -> [String]
extern fn make_leaf(label: String, word: String) -> String
extern fn make_node1(label: String, child0: String) -> String
extern fn make_node2(label: String, child0: String, child1: String) -> String
extern fn make_node3(label: String, child0: String, child1: String, child2: String) -> String
extern fn make_node4(label: String, child0: String, child1: String, child2: String, child3: String) -> String
extern fn nlg_is_ws(c: String) -> Bool
extern fn skip_ws(s: String, pos: Int) -> Int
extern fn scan_token(s: String, start: Int) -> [String]
extern fn render_tree(tree: String) -> String
extern fn gram_word_order(profile: [String]) -> String
extern fn gram_order_constituents(subj: String, verb: String, obj: String, profile: [String]) -> String
extern fn gram_build_vp(verb: String, aux: String, profile: [String]) -> String
extern fn gram_question_strategy(profile: [String]) -> String
extern fn is_pronoun(word: String) -> Bool
extern fn build_np(referent: String, slots: [String]) -> String
extern fn build_pp(loc: String) -> String
extern fn build_vp_body(slots: [String]) -> String
extern fn build_vp_from_slots(slots: [String]) -> String
extern fn generate_tree(rule_id_str: String, slots: [String]) -> String
Generated Vendored
-7
View File
@@ -1,7 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn imprint_current() -> String
extern fn imprint_load(imprint_id: String) -> String
extern fn imprint_respond(input: String, imprint_id: String) -> String
extern fn imprint_surface_knowledge(query: String, imprint_id: String) -> String
extern fn imprint_surface_memory_read(query: String) -> String
extern fn imprint_unload() -> Void
Generated Vendored
-46
View File
@@ -1,46 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn lang_profile(code: String, word_order: String, morph_type: String, has_case: String, has_gender: String, script_dir: String, agreement: String, null_subject: String) -> [String]
extern fn lang_get(profile: [String], key: String) -> String
extern fn lang_profile_en() -> [String]
extern fn lang_profile_ja() -> [String]
extern fn lang_profile_ar() -> [String]
extern fn lang_profile_zh() -> [String]
extern fn lang_profile_de() -> [String]
extern fn lang_profile_es() -> [String]
extern fn lang_profile_fi() -> [String]
extern fn lang_profile_sw() -> [String]
extern fn lang_profile_hi() -> [String]
extern fn lang_profile_ru() -> [String]
extern fn lang_profile_fr() -> [String]
extern fn lang_profile_la() -> [String]
extern fn lang_profile_he() -> [String]
extern fn lang_profile_sa() -> [String]
extern fn lang_profile_got() -> [String]
extern fn lang_profile_non() -> [String]
extern fn lang_profile_enm() -> [String]
extern fn lang_profile_pi() -> [String]
extern fn lang_profile_grc() -> [String]
extern fn lang_profile_ang() -> [String]
extern fn lang_profile_fro() -> [String]
extern fn lang_profile_goh() -> [String]
extern fn lang_profile_sga() -> [String]
extern fn lang_profile_txb() -> [String]
extern fn lang_profile_peo() -> [String]
extern fn lang_profile_akk() -> [String]
extern fn lang_profile_uga() -> [String]
extern fn lang_profile_egy() -> [String]
extern fn lang_profile_sux() -> [String]
extern fn lang_profile_gez() -> [String]
extern fn lang_profile_cop() -> [String]
extern fn lang_from_code(code: String) -> [String]
extern fn lang_default() -> [String]
extern fn lang_is_isolating(profile: [String]) -> Bool
extern fn lang_is_agglutinative(profile: [String]) -> Bool
extern fn lang_is_fusional(profile: [String]) -> Bool
extern fn lang_is_polysynthetic(profile: [String]) -> Bool
extern fn lang_is_rtl(profile: [String]) -> Bool
extern fn lang_has_null_subject(profile: [String]) -> Bool
extern fn lang_has_case(profile: [String]) -> Bool
extern fn lang_has_gender(profile: [String]) -> Bool
extern fn lang_word_order(profile: [String]) -> String
extern fn lang_code(profile: [String]) -> String
Generated Vendored
-16
View File
@@ -1,16 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn tier_working() -> String
extern fn tier_episodic() -> String
extern fn tier_canonical() -> String
extern fn mem_store(content: String, label: String, tags: String) -> String
extern fn mem_remember(content: String, tags: String) -> String
extern fn mem_recall(query: String, depth: Int) -> String
extern fn mem_search(query: String, limit: Int) -> String
extern fn mem_strengthen(node_id: String) -> Void
extern fn mem_forget(node_id: String) -> Void
extern fn mem_consolidate() -> String
extern fn mem_save(path: String) -> Void
extern fn mem_load(path: String) -> Void
extern fn mem_boot_count_get() -> Int
extern fn mem_boot_count_inc() -> Int
extern fn mem_emit_state_event(trigger: String, kind: String, content: String) -> String
Generated Vendored
-31
View File
@@ -1,31 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn akk_str_ends(s: String, suf: String) -> Bool
extern fn akk_str_len(s: String) -> Int
extern fn akk_str_drop_last(s: String, n: Int) -> String
extern fn akk_slot(person: String, number: String) -> Int
extern fn akk_slot_g(person: String, gender: String, number: String) -> Int
extern fn akk_copula_present(slot: Int) -> String
extern fn akk_copula_stative(slot: Int) -> String
extern fn akk_is_copula(verb: String) -> Bool
extern fn akk_conjugate_copula(tense: String, slot: Int) -> String
extern fn akk_alaku_present(slot: Int) -> String
extern fn akk_alaku_perfect(slot: Int) -> String
extern fn akk_amaru_present(slot: Int) -> String
extern fn akk_amaru_perfect(slot: Int) -> String
extern fn akk_amaru_stative(slot: Int) -> String
extern fn akk_qabu_present(slot: Int) -> String
extern fn akk_qabu_perfect(slot: Int) -> String
extern fn akk_qabu_stative(slot: Int) -> String
extern fn akk_epesu_present(slot: Int) -> String
extern fn akk_epesu_perfect(slot: Int) -> String
extern fn akk_epesu_stative(slot: Int) -> String
extern fn akk_regular_present(stem: String, slot: Int) -> String
extern fn akk_regular_perfect(stem: String, slot: Int) -> String
extern fn akk_regular_stative(stem: String, slot: Int) -> String
extern fn akk_known_verb(verb: String, tense: String, slot: Int) -> String
extern fn akk_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn akk_strip_nom(noun: String) -> String
extern fn akk_is_fem(noun: String) -> Bool
extern fn akk_decline(noun: String, gram_case: String, number: String) -> String
extern fn akk_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
extern fn akk_map_canonical(verb: String) -> String
Generated Vendored
-44
View File
@@ -1,44 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn ang_str_ends(s: String, suf: String) -> Bool
extern fn ang_str_drop_last(s: String, n: Int) -> String
extern fn ang_str_last_char(s: String) -> String
extern fn ang_str_last2(s: String) -> String
extern fn ang_slot(person: String, number: String) -> Int
extern fn ang_map_canonical(verb: String) -> String
extern fn ang_wesan_past(slot: Int) -> String
extern fn ang_beon_present(slot: Int) -> String
extern fn ang_wesan_present(slot: Int) -> String
extern fn ang_habban_present(slot: Int) -> String
extern fn ang_habban_past(slot: Int) -> String
extern fn ang_gan_present(slot: Int) -> String
extern fn ang_gan_past(slot: Int) -> String
extern fn ang_cuman_present(slot: Int) -> String
extern fn ang_cuman_past(slot: Int) -> String
extern fn ang_secgan_present(slot: Int) -> String
extern fn ang_secgan_past(slot: Int) -> String
extern fn ang_seon_present(slot: Int) -> String
extern fn ang_seon_past(slot: Int) -> String
extern fn ang_don_present(slot: Int) -> String
extern fn ang_don_past(slot: Int) -> String
extern fn ang_willan_present(slot: Int) -> String
extern fn ang_willan_past(slot: Int) -> String
extern fn ang_magan_present(slot: Int) -> String
extern fn ang_magan_past(slot: Int) -> String
extern fn ang_witan_present(slot: Int) -> String
extern fn ang_witan_past(slot: Int) -> String
extern fn ang_weak_present_ending(slot: Int) -> String
extern fn ang_weak_past_stem(stem: String) -> String
extern fn ang_weak_past(stem: String, slot: Int) -> String
extern fn ang_weak_stem(verb: String) -> String
extern fn ang_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn ang_declension(noun: String, gender: String) -> String
extern fn ang_decline_strong_masc(noun: String, gram_case: String, number: String) -> String
extern fn ang_decline_strong_neut(noun: String, gram_case: String, number: String) -> String
extern fn ang_decline_weak(noun: String, gram_case: String, number: String) -> String
extern fn ang_decline(noun: String, gram_case: String, number: String, gender: String) -> String
extern fn ang_article_masculine(gram_case: String, number: String) -> String
extern fn ang_article_feminine(gram_case: String, number: String) -> String
extern fn ang_article_neuter(gram_case: String, number: String) -> String
extern fn ang_article(gender: String, gram_case: String, number: String) -> String
extern fn ang_infer_gender(noun: String) -> String
extern fn ang_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-27
View File
@@ -1,27 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn ar_str_ends(s: String, suf: String) -> Bool
extern fn ar_str_len(s: String) -> Int
extern fn ar_str_drop_last(s: String, n: Int) -> String
extern fn ar_str_last_char(s: String) -> String
extern fn ar_slot(person: String, gender: String, number: String) -> Int
extern fn ar_perfect_suffix(slot: Int) -> String
extern fn ar_imperfect_prefix(slot: Int) -> String
extern fn ar_imperfect_suffix(slot: Int) -> String
extern fn ar_conjugate_form1(past_base: String, present_stem: String, tense: String, slot: Int) -> String
extern fn ar_irregular_kaana(slot: Int, tense: String) -> String
extern fn ar_irregular_qaala(slot: Int, tense: String) -> String
extern fn ar_irregular_jaa(slot: Int, tense: String) -> String
extern fn ar_irregular_raaa(slot: Int, tense: String) -> String
extern fn ar_irregular_araada(slot: Int, tense: String) -> String
extern fn ar_irregular_istata(slot: Int, tense: String) -> String
extern fn ar_irregular(verb: String, tense: String, slot: Int) -> String
extern fn ar_present_stem(verb: String) -> String
extern fn ar_conjugate(verb: String, tense: String, person: String, gender: String, number: String) -> String
extern fn ar_is_sun_letter(c: String) -> Bool
extern fn ar_definite_article(noun: String) -> String
extern fn ar_case_ending(kase: String, definite: String) -> String
extern fn ar_gender(noun: String) -> String
extern fn ar_masc_pl_ending(kase: String) -> String
extern fn ar_sound_plural(noun: String, gender: String) -> String
extern fn ar_noun_form(noun: String, gender: String, kase: String, number: String, definite: String) -> String
extern fn ar_verb_form(verb: String, tense: String, person: String, number: String) -> String
Generated Vendored
-35
View File
@@ -1,35 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn cop_str_ends(s: String, suf: String) -> Bool
extern fn cop_str_len(s: String) -> Int
extern fn cop_drop(s: String, n: Int) -> String
extern fn cop_last_char(s: String) -> String
extern fn cop_slot(person: String, number: String) -> Int
extern fn cop_subject_prefix(person: String, number: String) -> String
extern fn cop_subject_prefix_gendered(person: String, gender: String, number: String) -> String
extern fn cop_copula_particle(gender: String, number: String) -> String
extern fn cop_shwpe_present(prefix: String) -> String
extern fn cop_shwpe_perfect(prefix: String) -> String
extern fn cop_shwpe_future(prefix: String) -> String
extern fn cop_bwk_present(prefix: String) -> String
extern fn cop_bwk_perfect(prefix: String) -> String
extern fn cop_bwk_future(prefix: String) -> String
extern fn cop_nau_present(prefix: String) -> String
extern fn cop_nau_perfect(prefix: String) -> String
extern fn cop_nau_future(prefix: String) -> String
extern fn cop_jw_present(prefix: String) -> String
extern fn cop_jw_perfect(prefix: String) -> String
extern fn cop_jw_future(prefix: String) -> String
extern fn cop_di_present(prefix: String) -> String
extern fn cop_di_perfect(prefix: String) -> String
extern fn cop_di_future(prefix: String) -> String
extern fn cop_is_copula(verb: String) -> Bool
extern fn cop_known_verb_prefixed(verb: String, tense: String, prefix: String) -> String
extern fn cop_regular_present(prefix: String, stem: String) -> String
extern fn cop_regular_perfect(prefix: String, stem: String) -> String
extern fn cop_regular_future(prefix: String, stem: String) -> String
extern fn cop_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn cop_article(gender: String, number: String, definite: String) -> String
extern fn cop_decline(noun: String, gram_case: String, number: String) -> String
extern fn cop_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
extern fn cop_noun_phrase_gendered(noun: String, gram_case: String, number: String, definite: String, gender: String) -> String
extern fn cop_map_canonical(verb: String) -> String
Generated Vendored
-13
View File
@@ -1,13 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn de_article_def(gender: String, gram_case: String, number: String) -> String
extern fn de_article_indef(gender: String, gram_case: String, number: String) -> String
extern fn de_article(gender: String, gram_case: String, number: String, definite: String) -> String
extern fn de_adj_ending(gender: String, gram_case: String, number: String, article_type: String) -> String
extern fn de_noun_plural(noun: String, gender: String) -> String
extern fn de_case_ending(noun: String, gender: String, gram_case: String, number: String) -> String
extern fn de_conjugate_weak(stem: String, tense: String, person: String, number: String) -> String
extern fn de_irregular_present(verb: String, person: String, number: String) -> String
extern fn de_strong_past_stem(verb: String) -> String
extern fn de_norm_number(number: String) -> String
extern fn de_norm_person(person: String) -> String
extern fn de_conjugate(verb: String, tense: String, person: String, number: String) -> String
Generated Vendored
-38
View File
@@ -1,38 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn egy_str_ends(s: String, suf: String) -> Bool
extern fn egy_str_len(s: String) -> Int
extern fn egy_drop(s: String, n: Int) -> String
extern fn egy_last_char(s: String) -> String
extern fn egy_slot(person: String, number: String) -> Int
extern fn egy_slot_with_gender(person: String, gender: String, number: String) -> Int
extern fn egy_conjugate_pronoun(person: String, number: String) -> String
extern fn egy_suffix_pronoun(slot: Int) -> String
extern fn egy_is_copula(verb: String) -> Bool
extern fn egy_conjugate_copula(tense: String, slot: Int) -> String
extern fn egy_rdi_present(slot: Int) -> String
extern fn egy_rdi_past(slot: Int) -> String
extern fn egy_rdi_future(slot: Int) -> String
extern fn egy_mAA_present(slot: Int) -> String
extern fn egy_mAA_past(slot: Int) -> String
extern fn egy_mAA_future(slot: Int) -> String
extern fn egy_Dd_present(slot: Int) -> String
extern fn egy_Dd_past(slot: Int) -> String
extern fn egy_Dd_future(slot: Int) -> String
extern fn egy_Sm_present(slot: Int) -> String
extern fn egy_Sm_past(slot: Int) -> String
extern fn egy_Sm_future(slot: Int) -> String
extern fn egy_iri_present(slot: Int) -> String
extern fn egy_iri_past(slot: Int) -> String
extern fn egy_iri_future(slot: Int) -> String
extern fn egy_sdm_present(slot: Int) -> String
extern fn egy_sdm_past(slot: Int) -> String
extern fn egy_sdm_future(slot: Int) -> String
extern fn egy_known_verb(verb: String, tense: String, slot: Int) -> String
extern fn egy_regular_present(stem: String, slot: Int) -> String
extern fn egy_regular_past(stem: String, slot: Int) -> String
extern fn egy_regular_future(stem: String, slot: Int) -> String
extern fn egy_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn egy_decline(noun: String, gram_case: String, number: String) -> String
extern fn egy_fem(noun: String) -> String
extern fn egy_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
extern fn egy_map_canonical(verb: String) -> String
Generated Vendored
-30
View File
@@ -1,30 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn enm_str_ends(s: String, suf: String) -> Bool
extern fn enm_drop(s: String, n: Int) -> String
extern fn enm_first_char(s: String) -> String
extern fn enm_slot(person: String, number: String) -> Int
extern fn enm_been_present(slot: Int) -> String
extern fn enm_been_past(slot: Int) -> String
extern fn enm_haven_present(slot: Int) -> String
extern fn enm_haven_past(slot: Int) -> String
extern fn enm_goon_present(slot: Int) -> String
extern fn enm_goon_past(slot: Int) -> String
extern fn enm_seen_present(slot: Int) -> String
extern fn enm_seen_past(slot: Int) -> String
extern fn enm_seyen_present(slot: Int) -> String
extern fn enm_seyen_past(slot: Int) -> String
extern fn enm_comen_present(slot: Int) -> String
extern fn enm_comen_past(slot: Int) -> String
extern fn enm_maken_present(slot: Int) -> String
extern fn enm_maken_past(slot: Int) -> String
extern fn enm_map_canonical(verb: String) -> String
extern fn enm_weak_stem(verb: String) -> String
extern fn enm_weak_present(stem: String, slot: Int) -> String
extern fn enm_weak_past(stem: String, slot: Int) -> String
extern fn enm_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn enm_irregular_plural(noun: String) -> String
extern fn enm_make_plural(noun: String) -> String
extern fn enm_decline(noun: String, gram_case: String, number: String) -> String
extern fn enm_is_vowel_initial(s: String) -> Bool
extern fn enm_indef_article(noun_phrase: String) -> String
extern fn enm_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-23
View File
@@ -1,23 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn es_str_ends(s: String, suf: String) -> Bool
extern fn es_str_drop_last(s: String, n: Int) -> String
extern fn es_str_last_char(s: String) -> String
extern fn es_str_last2(s: String) -> String
extern fn es_str_last3(s: String) -> String
extern fn es_verb_class(base: String) -> String
extern fn es_stem(base: String) -> String
extern fn es_slot(person: String, number: String) -> Int
extern fn es_irregular_present(verb: String, person: String, number: String) -> String
extern fn es_irregular_preterite(verb: String, person: String, number: String) -> String
extern fn es_irregular_imperfect(verb: String, person: String, number: String) -> String
extern fn es_regular_present(stem: String, vclass: String, slot: Int) -> String
extern fn es_regular_preterite(stem: String, vclass: String, slot: Int) -> String
extern fn es_regular_future(base: String, slot: Int) -> String
extern fn es_irregular_future_stem(verb: String) -> String
extern fn es_regular_imperfect(stem: String, vclass: String, slot: Int) -> String
extern fn es_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn es_gender(noun: String) -> String
extern fn es_invariant_plural(noun: String) -> String
extern fn es_pluralize(noun: String) -> String
extern fn es_starts_with_stressed_a(noun: String) -> Bool
extern fn es_agree_article(noun: String, definite: String, number: String) -> String
Generated Vendored
-17
View File
@@ -1,17 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn fi_harmony(word: String) -> String
extern fn fi_suffix(base: String, harmony: String) -> String
extern fn fi_noun_case(stem: String, gram_case: String, number: String, harmony: String) -> String
extern fn fi_str_last_char(s: String) -> String
extern fn fi_apply_case(noun: String, gram_case: String, number: String) -> String
extern fn fi_verb_stem(dict_form: String) -> String
extern fn fi_irregular_verb(dict_form: String) -> [String]
extern fn fi_present_ending(stem: String, person: String, number: String, harmony: String) -> String
extern fn fi_past_stem(stem: String) -> String
extern fn fi_past_ending(stem: String, person: String, number: String, harmony: String) -> String
extern fn fi_neg_aux(person: String, number: String) -> String
extern fn fi_negative(verb: String, person: String, number: String) -> String
extern fn fi_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn fi_question_suffix(harmony: String) -> String
extern fn fi_make_question(verb_form: String, harmony: String) -> String
extern fn fi_full_paradigm(noun: String) -> [String]
Generated Vendored
-29
View File
@@ -1,29 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn fr_str_ends(s: String, suf: String) -> Bool
extern fn fr_str_drop_last(s: String, n: Int) -> String
extern fn fr_str_last_char(s: String) -> String
extern fn fr_str_last2(s: String) -> String
extern fn fr_is_vowel_start(s: String) -> Bool
extern fn fr_is_known_irregular(verb: String) -> Bool
extern fn fr_verb_group(base: String) -> String
extern fn fr_stem(base: String) -> String
extern fn fr_slot(person: String, number: String) -> Int
extern fn fr_irregular_present(verb: String, person: String, number: String) -> String
extern fn fr_regular_present(stem: String, vgroup: String, slot: Int) -> String
extern fn fr_future_stem(base: String, vgroup: String) -> String
extern fn fr_regular_future(fstem: String, slot: Int) -> String
extern fn fr_irregular_future_stem(verb: String) -> String
extern fn fr_imperfect_stem(base: String, vgroup: String) -> String
extern fn fr_regular_imperfect(istem: String, slot: Int) -> String
extern fn fr_uses_etre(verb: String) -> Bool
extern fn fr_past_participle(verb: String) -> String
extern fn fr_avoir_present(slot: Int) -> String
extern fn fr_etre_present(slot: Int) -> String
extern fn fr_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn fr_gender(noun: String) -> String
extern fn fr_invariant_plural(noun: String) -> String
extern fn fr_pluralize(noun: String) -> String
extern fn fr_agree_article(noun: String, definite: String, number: String) -> String
extern fn fr_subject_starts_vowel(subject: String) -> Bool
extern fn fr_verb_ends_vowel(verb_form: String) -> Bool
extern fn fr_question_inversion(subject: String, verb_form: String) -> String
Generated Vendored
-38
View File
@@ -1,38 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn fro_str_ends(s: String, suf: String) -> Bool
extern fn fro_drop(s: String, n: Int) -> String
extern fn fro_slot(person: String, number: String) -> Int
extern fn fro_map_canonical(verb: String) -> String
extern fn fro_estre_present(slot: Int) -> String
extern fn fro_estre_past(slot: Int) -> String
extern fn fro_estre_future(slot: Int) -> String
extern fn fro_avoir_present(slot: Int) -> String
extern fn fro_avoir_past(slot: Int) -> String
extern fn fro_avoir_future(slot: Int) -> String
extern fn fro_aler_present(slot: Int) -> String
extern fn fro_aler_past(slot: Int) -> String
extern fn fro_aler_future(slot: Int) -> String
extern fn fro_venir_present(slot: Int) -> String
extern fn fro_venir_past(slot: Int) -> String
extern fn fro_venir_future(slot: Int) -> String
extern fn fro_faire_present(slot: Int) -> String
extern fn fro_faire_past(slot: Int) -> String
extern fn fro_faire_future(slot: Int) -> String
extern fn fro_verb_class(verb: String) -> String
extern fn fro_verb_stem(verb: String, vclass: String) -> String
extern fn fro_conj1_present(stem: String, slot: Int) -> String
extern fn fro_conj1_past(stem: String, slot: Int) -> String
extern fn fro_conj1_future(verb: String, slot: Int) -> String
extern fn fro_conj2_present(stem: String, slot: Int) -> String
extern fn fro_conj2_past(stem: String, slot: Int) -> String
extern fn fro_conj2_future(verb: String, slot: Int) -> String
extern fn fro_conj3_present(stem: String, slot: Int) -> String
extern fn fro_conj3_past(stem: String, slot: Int) -> String
extern fn fro_conj3_future(verb: String, slot: Int) -> String
extern fn fro_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn fro_gender(noun: String) -> String
extern fn fro_decline_masc(noun: String, gram_case: String, number: String) -> String
extern fn fro_decline_fem(noun: String, number: String) -> String
extern fn fro_decline(noun: String, gram_case: String, number: String) -> String
extern fn fro_article(gender: String, gram_case: String, number: String) -> String
extern fn fro_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-26
View File
@@ -1,26 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn gez_str_ends(s: String, suf: String) -> Bool
extern fn gez_str_len(s: String) -> Int
extern fn gez_str_drop_last(s: String, n: Int) -> String
extern fn gez_slot(person: String, number: String) -> Int
extern fn gez_slot_g(person: String, gender: String, number: String) -> Int
extern fn gez_kwn_perfect(slot: Int) -> String
extern fn gez_kwn_imperfect(slot: Int) -> String
extern fn gez_is_copula(verb: String) -> Bool
extern fn gez_conjugate_copula(tense: String, slot: Int) -> String
extern fn gez_hlw_perfect(slot: Int) -> String
extern fn gez_hlw_imperfect(slot: Int) -> String
extern fn gez_hbl_perfect(slot: Int) -> String
extern fn gez_hbl_imperfect(slot: Int) -> String
extern fn gez_ray_perfect(slot: Int) -> String
extern fn gez_ray_imperfect(slot: Int) -> String
extern fn gez_qwl_perfect(slot: Int) -> String
extern fn gez_qwl_imperfect(slot: Int) -> String
extern fn gez_generic_perfect(base3sg: String, slot: Int) -> String
extern fn gez_generic_imperfect(base3sg: String, slot: Int) -> String
extern fn gez_known_verb(verb: String, tense: String, slot: Int) -> String
extern fn gez_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn gez_is_fidel(noun: String) -> Bool
extern fn gez_decline(noun: String, gram_case: String, number: String) -> String
extern fn gez_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
extern fn gez_map_canonical(verb: String) -> String
Generated Vendored
-34
View File
@@ -1,34 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn goh_str_ends(s: String, suf: String) -> Bool
extern fn goh_drop(s: String, n: Int) -> String
extern fn goh_slot(person: String, number: String) -> Int
extern fn goh_map_canonical(verb: String) -> String
extern fn goh_wesan_present(slot: Int) -> String
extern fn goh_wesan_past(slot: Int) -> String
extern fn goh_haben_present(slot: Int) -> String
extern fn goh_haben_past(slot: Int) -> String
extern fn goh_gan_present(slot: Int) -> String
extern fn goh_gan_past(slot: Int) -> String
extern fn goh_sehan_present(slot: Int) -> String
extern fn goh_sehan_past(slot: Int) -> String
extern fn goh_quethan_present(slot: Int) -> String
extern fn goh_quethan_past(slot: Int) -> String
extern fn goh_tuon_present(slot: Int) -> String
extern fn goh_tuon_past(slot: Int) -> String
extern fn goh_weak_present(stem: String, slot: Int) -> String
extern fn goh_weak_past(stem: String, slot: Int) -> String
extern fn goh_verb_stem(verb: String) -> String
extern fn goh_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn goh_stem_type(noun: String) -> String
extern fn goh_extract_stem(noun: String, stype: String) -> String
extern fn goh_decline_masc_a_sg(stem: String, gram_case: String) -> String
extern fn goh_decline_masc_a_pl(stem: String, gram_case: String) -> String
extern fn goh_decline_fem_o_sg(stem: String, gram_case: String) -> String
extern fn goh_decline_fem_o_pl(stem: String, gram_case: String) -> String
extern fn goh_decline_neut_a_sg(stem: String, gram_case: String) -> String
extern fn goh_decline_neut_a_pl(stem: String, gram_case: String) -> String
extern fn goh_decline_masc_n_sg(stem: String, gram_case: String) -> String
extern fn goh_decline_masc_n_pl(stem: String, gram_case: String) -> String
extern fn goh_decline(noun: String, gram_case: String, number: String) -> String
extern fn goh_demo_article(stype: String, number: String) -> String
extern fn goh_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-37
View File
@@ -1,37 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn got_str_ends(s: String, suf: String) -> Bool
extern fn got_str_drop_last(s: String, n: Int) -> String
extern fn got_slot(person: String, number: String) -> Int
extern fn got_map_canonical(verb: String) -> String
extern fn got_wisan_present(slot: Int) -> String
extern fn got_wisan_past(slot: Int) -> String
extern fn got_haban_present(slot: Int) -> String
extern fn got_haban_past(slot: Int) -> String
extern fn got_gaggan_present(slot: Int) -> String
extern fn got_gaggan_past(slot: Int) -> String
extern fn got_saihwan_present(slot: Int) -> String
extern fn got_saihwan_past(slot: Int) -> String
extern fn got_qithan_present(slot: Int) -> String
extern fn got_qithan_past(slot: Int) -> String
extern fn got_niman_present(slot: Int) -> String
extern fn got_niman_past(slot: Int) -> String
extern fn got_wk1_present_ending(slot: Int) -> String
extern fn got_wk1_past_ending(slot: Int) -> String
extern fn got_wk1_conjugate(stem: String, tense: String, slot: Int) -> String
extern fn got_wk2_present_ending(slot: Int) -> String
extern fn got_wk2_past_ending(slot: Int) -> String
extern fn got_wk2_conjugate(stem: String, tense: String, slot: Int) -> String
extern fn got_verb_class(verb: String) -> String
extern fn got_verb_stem(verb: String, vclass: String) -> String
extern fn got_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn got_decline_a_stem_sg(stem: String, gram_case: String) -> String
extern fn got_decline_a_stem_pl(stem: String, gram_case: String) -> String
extern fn got_decline_o_stem_sg(stem: String, gram_case: String) -> String
extern fn got_decline_o_stem_pl(stem: String, gram_case: String) -> String
extern fn got_decline_n_stem_sg(stem: String, gram_case: String) -> String
extern fn got_decline_n_stem_pl(stem: String, gram_case: String) -> String
extern fn got_stem_type(noun: String) -> String
extern fn got_extract_stem(noun: String, stype: String) -> String
extern fn got_demo_article(stype: String) -> String
extern fn got_decline(noun: String, gram_case: String, number: String) -> String
extern fn got_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-45
View File
@@ -1,45 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn grc_str_ends(s: String, suf: String) -> Bool
extern fn grc_str_drop_last(s: String, n: Int) -> String
extern fn grc_str_last_char(s: String) -> String
extern fn grc_str_last2(s: String) -> String
extern fn grc_str_last3(s: String) -> String
extern fn grc_slot(person: String, number: String) -> Int
extern fn grc_map_canonical(verb: String) -> String
extern fn grc_einai_present(slot: Int) -> String
extern fn grc_einai_imperfect(slot: Int) -> String
extern fn grc_einai_future(slot: Int) -> String
extern fn grc_echein_present(slot: Int) -> String
extern fn grc_echein_imperfect(slot: Int) -> String
extern fn grc_echein_aorist(slot: Int) -> String
extern fn grc_echein_future(slot: Int) -> String
extern fn grc_legein_present(slot: Int) -> String
extern fn grc_legein_imperfect(slot: Int) -> String
extern fn grc_legein_aorist(slot: Int) -> String
extern fn grc_legein_future(slot: Int) -> String
extern fn grc_horao_present(slot: Int) -> String
extern fn grc_horao_imperfect(slot: Int) -> String
extern fn grc_horao_aorist(slot: Int) -> String
extern fn grc_horao_future(slot: Int) -> String
extern fn grc_erchesthai_present(slot: Int) -> String
extern fn grc_erchesthai_imperfect(slot: Int) -> String
extern fn grc_erchesthai_aorist(slot: Int) -> String
extern fn grc_erchesthai_future(slot: Int) -> String
extern fn grc_thematic_present_ending(slot: Int) -> String
extern fn grc_thematic_imperfect_ending(slot: Int) -> String
extern fn grc_thematic_future_ending(slot: Int) -> String
extern fn grc_weak_aorist_ending(slot: Int) -> String
extern fn grc_present_stem(verb: String) -> String
extern fn grc_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn grc_declension(noun: String) -> String
extern fn grc_decline_2m(stem: String, gram_case: String, number: String) -> String
extern fn grc_decline_2n(stem: String, gram_case: String, number: String) -> String
extern fn grc_decline_1a(stem: String, gram_case: String, number: String) -> String
extern fn grc_decline_1e(stem: String, gram_case: String, number: String) -> String
extern fn grc_decline(noun: String, gram_case: String, number: String) -> String
extern fn grc_article_masculine(gram_case: String, number: String) -> String
extern fn grc_article_feminine(gram_case: String, number: String) -> String
extern fn grc_article_neuter(gram_case: String, number: String) -> String
extern fn grc_article(gender: String, gram_case: String, number: String) -> String
extern fn grc_infer_gender(noun: String) -> String
extern fn grc_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-30
View File
@@ -1,30 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn he_str_ends(s: String, suf: String) -> Bool
extern fn he_str_len(s: String) -> Int
extern fn he_str_drop_last(s: String, n: Int) -> String
extern fn he_str_last_char(s: String) -> String
extern fn he_slot(person: String, gender: String, number: String) -> Int
extern fn he_present_form_code(slot: Int) -> Int
extern fn he_copula_past(slot: Int) -> String
extern fn he_copula_future(slot: Int) -> String
extern fn he_is_copula(verb: String) -> Bool
extern fn he_conjugate_copula(tense: String, slot: Int) -> String
extern fn he_present_lir_ot(form: Int) -> String
extern fn he_present_le_exol(form: Int) -> String
extern fn he_present_ledaber(form: Int) -> String
extern fn he_present_lalechet(form: Int) -> String
extern fn he_past_lir_ot(slot: Int) -> String
extern fn he_past_le_exol(slot: Int) -> String
extern fn he_past_ledaber(slot: Int) -> String
extern fn he_past_lalechet(slot: Int) -> String
extern fn he_future_lir_ot(slot: Int) -> String
extern fn he_future_le_exol(slot: Int) -> String
extern fn he_future_ledaber(slot: Int) -> String
extern fn he_future_lalechet(slot: Int) -> String
extern fn he_known_verb(verb: String, tense: String, slot: Int) -> String
extern fn he_conjugate(verb: String, tense: String, person: String, gender: String, number: String) -> String
extern fn he_pluralize(noun: String, gender: String) -> String
extern fn he_is_hebrew_script(noun: String) -> Bool
extern fn he_definite_prefix(noun: String) -> String
extern fn he_noun_phrase(noun: String, number: String, gender: String, definite: String) -> String
extern fn he_map_canonical(verb: String) -> String
Generated Vendored
-27
View File
@@ -1,27 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn hi_str_ends(s: String, suf: String) -> Bool
extern fn hi_str_drop_last(s: String, n: Int) -> String
extern fn hi_str_last_char(s: String) -> String
extern fn hi_gender(noun: String) -> String
extern fn hi_masc_aa_stem(noun: String) -> String
extern fn hi_noun_direct_m(noun: String, number: String) -> String
extern fn hi_noun_oblique_m(noun: String, number: String) -> String
extern fn hi_noun_direct_f(noun: String, number: String) -> String
extern fn hi_noun_oblique_f(noun: String, number: String) -> String
extern fn hi_noun_direct(noun: String, gender: String, number: String) -> String
extern fn hi_noun_oblique(noun: String, gender: String, number: String) -> String
extern fn hi_postposition(gram_case: String) -> String
extern fn hi_agree_genitive(possessed_gender: String, possessed_number: String) -> String
extern fn hi_verb_stem(infinitive: String) -> String
extern fn hi_verb_stem_clean(infinitive: String) -> String
extern fn hi_present_aspect(gender: String, number: String) -> String
extern fn hi_aux_present(person: String, number: String) -> String
extern fn hi_past_suffix(gender: String, number: String) -> String
extern fn hi_past_irregular(stem: String, gender: String, number: String) -> String
extern fn hi_future_suffix(person: String, number: String, gender: String) -> String
extern fn hi_tense_suffix(tense: String, gender: String, number: String) -> String
extern fn hi_hona_present(person: String, number: String) -> String
extern fn hi_hona_past(gender: String, number: String) -> String
extern fn hi_conjugate(verb: String, tense: String, person: String, gender: String, number: String) -> String
extern fn hi_noun_with_post(noun: String, gender: String, number: String, gram_case: String) -> String
extern fn hi_genitive_phrase(possessor: String, possessor_gender: String, possessor_number: String, possessed: String, possessed_gender: String, possessed_number: String) -> String
Generated Vendored
-9
View File
@@ -1,9 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn ja_verb_group(dict_form: String) -> String
extern fn ja_ichidan_stem(dict_form: String) -> String
extern fn ja_godan_stem_change(dict_form: String, row: String) -> String
extern fn ja_conjugate(dict_form: String, form: String) -> String
extern fn ja_particle(gram_case: String) -> String
extern fn ja_noun_phrase(noun: String, gram_case: String) -> String
extern fn ja_question_particle() -> String
extern fn ja_make_question(sentence: String) -> String
Generated Vendored
-41
View File
@@ -1,41 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn la_str_ends(s: String, suf: String) -> Bool
extern fn la_str_drop_last(s: String, n: Int) -> String
extern fn la_str_last_char(s: String) -> String
extern fn la_str_last2(s: String) -> String
extern fn la_str_last3(s: String) -> String
extern fn la_slot(person: String, number: String) -> Int
extern fn la_verb_class(verb: String) -> String
extern fn la_stem(verb: String, vclass: String) -> String
extern fn la_perfect_stem(verb: String, vclass: String) -> String
extern fn la_perfect_ending(slot: Int) -> String
extern fn la_present_ending(vclass: String, slot: Int) -> String
extern fn la_present_form(stem: String, vclass: String, slot: Int) -> String
extern fn la_future_ending_12(slot: Int) -> String
extern fn la_future_ending_34(slot: Int) -> String
extern fn la_future_form(stem: String, vclass: String, slot: Int) -> String
extern fn la_esse_present(slot: Int) -> String
extern fn la_esse_past(slot: Int) -> String
extern fn la_esse_future(slot: Int) -> String
extern fn la_ire_present(slot: Int) -> String
extern fn la_ire_past(slot: Int) -> String
extern fn la_ire_future(slot: Int) -> String
extern fn la_velle_present(slot: Int) -> String
extern fn la_velle_past(slot: Int) -> String
extern fn la_velle_future(slot: Int) -> String
extern fn la_posse_present(slot: Int) -> String
extern fn la_posse_past(slot: Int) -> String
extern fn la_posse_future(slot: Int) -> String
extern fn la_irregular_perfect_stem(verb: String) -> String
extern fn la_map_canonical(verb: String) -> String
extern fn la_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn la_declension(noun: String) -> String
extern fn la_decline_1(stem: String, gram_case: String, number: String) -> String
extern fn la_decline_2m(stem: String, gram_case: String, number: String) -> String
extern fn la_decline_2n(stem: String, gram_case: String, number: String) -> String
extern fn la_decline_3(noun: String, gram_case: String, number: String) -> String
extern fn la_decline_4(stem: String, gram_case: String, number: String) -> String
extern fn la_decline_5(stem: String, gram_case: String, number: String) -> String
extern fn la_decline_2er(noun: String, gram_case: String, number: String) -> String
extern fn la_decline(noun: String, gram_case: String, number: String) -> String
extern fn la_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-30
View File
@@ -1,30 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn non_str_ends(s: String, suf: String) -> Bool
extern fn non_drop(s: String, n: Int) -> String
extern fn non_last(s: String) -> String
extern fn non_slot(person: String, number: String) -> Int
extern fn non_vera_present(slot: Int) -> String
extern fn non_vera_past(slot: Int) -> String
extern fn non_hafa_present(slot: Int) -> String
extern fn non_hafa_past(slot: Int) -> String
extern fn non_ganga_present(slot: Int) -> String
extern fn non_ganga_past(slot: Int) -> String
extern fn non_sja_present(slot: Int) -> String
extern fn non_sja_past(slot: Int) -> String
extern fn non_segja_present(slot: Int) -> String
extern fn non_segja_past(slot: Int) -> String
extern fn non_koma_present(slot: Int) -> String
extern fn non_koma_past(slot: Int) -> String
extern fn non_map_canonical(verb: String) -> String
extern fn non_weak_present(stem: String, slot: Int) -> String
extern fn non_weak_past(stem: String, slot: Int) -> String
extern fn non_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn non_decline_masc(noun: String, gram_case: String, number: String) -> String
extern fn non_decline_fem(noun: String, gram_case: String, number: String) -> String
extern fn non_decline_neut(noun: String, gram_case: String, number: String) -> String
extern fn non_detect_gender(noun: String) -> String
extern fn non_decline(noun: String, gram_case: String, number: String) -> String
extern fn non_def_suffix_masc(gram_case: String, number: String) -> String
extern fn non_def_suffix_neut(gram_case: String, number: String) -> String
extern fn non_def_suffix_fem(gram_case: String, number: String) -> String
extern fn non_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-19
View File
@@ -1,19 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn peo_drop(s: String, n: Int) -> String
extern fn peo_ends(s: String, suf: String) -> Bool
extern fn peo_slot(person: String, number: String) -> Int
extern fn peo_present_suffix(slot: Int) -> String
extern fn peo_past_suffix(slot: Int) -> String
extern fn peo_ah_present(slot: Int) -> String
extern fn peo_ah_past(slot: Int) -> String
extern fn peo_kar_present(slot: Int) -> String
extern fn peo_kar_past(slot: Int) -> String
extern fn peo_xsaya_present(slot: Int) -> String
extern fn peo_tar_present(slot: Int) -> String
extern fn peo_da_present(slot: Int) -> String
extern fn peo_da_past(slot: Int) -> String
extern fn peo_map_canonical(verb: String) -> String
extern fn peo_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn peo_decline_astem(noun: String, gram_case: String, number: String) -> String
extern fn peo_decline(noun: String, gram_case: String, number: String) -> String
extern fn peo_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-34
View File
@@ -1,34 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn pi_str_ends(s: String, suf: String) -> Bool
extern fn pi_drop(s: String, n: Int) -> String
extern fn pi_last_char(s: String) -> String
extern fn pi_slot(person: String, number: String) -> Int
extern fn pi_present_ending(slot: Int) -> String
extern fn pi_aorist_ending(slot: Int) -> String
extern fn pi_future_ending(slot: Int) -> String
extern fn pi_hoti_present(slot: Int) -> String
extern fn pi_atthi_present(slot: Int) -> String
extern fn pi_hoti_aorist(slot: Int) -> String
extern fn pi_hoti_future(slot: Int) -> String
extern fn pi_gacchati_present(slot: Int) -> String
extern fn pi_gacchati_aorist(slot: Int) -> String
extern fn pi_gacchati_future(slot: Int) -> String
extern fn pi_passati_present(slot: Int) -> String
extern fn pi_passati_aorist(slot: Int) -> String
extern fn pi_passati_future(slot: Int) -> String
extern fn pi_vadati_present(slot: Int) -> String
extern fn pi_vadati_aorist(slot: Int) -> String
extern fn pi_vadati_future(slot: Int) -> String
extern fn pi_karoti_present(slot: Int) -> String
extern fn pi_karoti_aorist(slot: Int) -> String
extern fn pi_karoti_future(slot: Int) -> String
extern fn pi_map_canonical(verb: String) -> String
extern fn pi_regular_root(verb: String) -> String
extern fn pi_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn pi_decline_a_masc_sg(stem: String, gram_case: String) -> String
extern fn pi_decline_a_masc_pl(stem: String, gram_case: String) -> String
extern fn pi_decline_a_fem_sg(stem: String, gram_case: String) -> String
extern fn pi_decline_a_fem_pl(stem: String, gram_case: String) -> String
extern fn pi_detect_class(noun: String) -> String
extern fn pi_decline(noun: String, gram_case: String, number: String) -> String
extern fn pi_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-14
View File
@@ -1,14 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn ru_gender(noun: String) -> String
extern fn ru_stem_type(noun: String, gender: String) -> String
extern fn ru_noun_case(noun: String, gender: String, gram_case: String, number: String) -> String
extern fn ru_decline_regular(noun: String, gender: String, stype: String, gram_case: String, number: String) -> String
extern fn ru_decline_masc(noun: String, stype: String, gram_case: String, number: String) -> String
extern fn ru_decline_fem(noun: String, stype: String, gram_case: String, number: String) -> String
extern fn ru_decline_neut(noun: String, stype: String, gram_case: String, number: String) -> String
extern fn ru_past_agree(verb_stem: String, gender: String, number: String) -> String
extern fn ru_conjugate_1st(stem: String, tense: String, person: String, number: String) -> String
extern fn ru_conjugate_2nd(stem: String, tense: String, person: String, number: String) -> String
extern fn ru_irregular(verb: String, tense: String, person: String, number: String) -> String
extern fn ru_past_stem(verb: String) -> String
extern fn ru_conjugate(verb: String, tense: String, person: String, number: String, gender: String) -> String
Generated Vendored
-36
View File
@@ -1,36 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn sa_str_ends(s: String, suf: String) -> Bool
extern fn sa_str_drop_last(s: String, n: Int) -> String
extern fn sa_slot(person: String, number: String) -> Int
extern fn sa_map_canonical(verb: String) -> String
extern fn sa_as_present(slot: Int) -> String
extern fn sa_as_past(slot: Int) -> String
extern fn sa_as_future(slot: Int) -> String
extern fn sa_bhu_present(slot: Int) -> String
extern fn sa_bhu_past(slot: Int) -> String
extern fn sa_bhu_future(slot: Int) -> String
extern fn sa_gam_present(slot: Int) -> String
extern fn sa_gam_past(slot: Int) -> String
extern fn sa_gam_future(slot: Int) -> String
extern fn sa_drs_present(slot: Int) -> String
extern fn sa_drs_past(slot: Int) -> String
extern fn sa_drs_future(slot: Int) -> String
extern fn sa_vad_present(slot: Int) -> String
extern fn sa_vad_past(slot: Int) -> String
extern fn sa_vad_future(slot: Int) -> String
extern fn sa_kr_present(slot: Int) -> String
extern fn sa_kr_past(slot: Int) -> String
extern fn sa_kr_future(slot: Int) -> String
extern fn sa_class1_present_ending(slot: Int) -> String
extern fn sa_class1_past_ending(slot: Int) -> String
extern fn sa_class1_future_ending(slot: Int) -> String
extern fn sa_class1_conjugate(stem: String, tense: String, slot: Int) -> String
extern fn sa_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn sa_decline_a_stem_sg(stem: String, gram_case: String) -> String
extern fn sa_decline_a_stem_pl(stem: String, gram_case: String) -> String
extern fn sa_decline_aa_stem_sg(stem: String, gram_case: String) -> String
extern fn sa_decline_aa_stem_pl(stem: String, gram_case: String) -> String
extern fn sa_stem_type(noun: String) -> String
extern fn sa_extract_stem(noun: String, stype: String) -> String
extern fn sa_decline(noun: String, gram_case: String, number: String) -> String
extern fn sa_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-22
View File
@@ -1,22 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn sga_drop(s: String, n: Int) -> String
extern fn sga_first(s: String) -> String
extern fn sga_rest(s: String) -> String
extern fn sga_slot(person: String, number: String) -> Int
extern fn sga_lenite(word: String) -> String
extern fn sga_copula_present(slot: Int) -> String
extern fn sga_bith_present(slot: Int) -> String
extern fn sga_bith_past(slot: Int) -> String
extern fn sga_teit_present(slot: Int) -> String
extern fn sga_teit_past(slot: Int) -> String
extern fn sga_gaibid_present(slot: Int) -> String
extern fn sga_adci_present(slot: Int) -> String
extern fn sga_asbeir_present(slot: Int) -> String
extern fn sga_map_canonical(verb: String) -> String
extern fn sga_ai_present(stem: String, slot: Int) -> String
extern fn sga_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn sga_decline_ostem(noun: String, gram_case: String, number: String) -> String
extern fn sga_decline_astem(noun: String, gram_case: String, number: String) -> String
extern fn sga_detect_gender(noun: String) -> String
extern fn sga_decline(noun: String, gram_case: String, number: String) -> String
extern fn sga_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-29
View File
@@ -1,29 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn sux_str_ends(s: String, suf: String) -> Bool
extern fn sux_str_drop_last(s: String, n: Int) -> String
extern fn sux_str_last_char(s: String) -> String
extern fn sux_str_last2(s: String) -> String
extern fn sux_slot(person: String, number: String) -> Int
extern fn sux_ergative_suffix(person: String, number: String) -> String
extern fn sux_absolutive_suffix(person: String, number: String) -> String
extern fn sux_map_canonical(verb: String) -> String
extern fn sux_personal_suffix(slot: Int) -> String
extern fn sux_me_present(slot: Int) -> String
extern fn sux_me_past(slot: Int) -> String
extern fn sux_dug4_present(slot: Int) -> String
extern fn sux_dug4_past(slot: Int) -> String
extern fn sux_du_present(slot: Int) -> String
extern fn sux_du_past(slot: Int) -> String
extern fn sux_igibar_present(slot: Int) -> String
extern fn sux_igibar_past(slot: Int) -> String
extern fn sux_ak_present(slot: Int) -> String
extern fn sux_ak_past(slot: Int) -> String
extern fn sux_tum2_present(slot: Int) -> String
extern fn sux_tum2_past(slot: Int) -> String
extern fn sux_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn sux_is_animate(noun: String) -> Bool
extern fn sux_case_suffix(gram_case: String) -> String
extern fn sux_decline(noun: String, gram_case: String, number: String) -> String
extern fn sux_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
extern fn sux_verb_chain(agent: String, verb: String, patient: String, tense: String) -> String
extern fn sux_realize_sentence(intent: String, agent: String, predicate: String, patient: String, tense: String) -> String
Generated Vendored
-23
View File
@@ -1,23 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn sw_str_ends(s: String, suf: String) -> Bool
extern fn sw_str_drop_last(s: String, n: Int) -> String
extern fn sw_str_first_char(s: String) -> String
extern fn sw_str_first2(s: String) -> String
extern fn sw_str_first3(s: String) -> String
extern fn sw_str_last_char(s: String) -> String
extern fn sw_is_class1_noun(noun: String) -> Bool
extern fn sw_noun_class(noun: String) -> String
extern fn sw_subj_prefix(person: String, number: String, noun_class: String) -> String
extern fn sw_obj_prefix(person: String, number: String, noun_class: String) -> String
extern fn sw_tense_marker(tense: String) -> String
extern fn sw_verb_final(tense: String, negative: Bool) -> String
extern fn sw_neg_subj_prefix(person: String, number: String, noun_class: String) -> String
extern fn sw_verb_stem(infinitive: String) -> String
extern fn sw_conjugate(verb_stem: String, person: String, number: String, noun_class: String, tense: String) -> String
extern fn sw_negative(verb_stem: String, person: String, number: String, noun_class: String, tense: String) -> String
extern fn sw_noun_plural(noun: String) -> String
extern fn sw_adj_prefix(noun_class: String, number: String) -> String
extern fn sw_agree_adj(adj_stem: String, noun_class: String, number: String) -> String
extern fn sw_demonstrative(noun_class: String, number: String, proximity: String) -> String
extern fn sw_copula_present(person: String, number: String, use_case: String) -> String
extern fn sw_copula_neg_present(person: String, number: String) -> String
Generated Vendored
-17
View File
@@ -1,17 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn txb_drop(s: String, n: Int) -> String
extern fn txb_ends(s: String, suf: String) -> Bool
extern fn txb_slot(person: String, number: String) -> Int
extern fn txb_pres1_suffix(slot: Int) -> String
extern fn txb_kam_present(slot: Int) -> String
extern fn txb_ya_present(slot: Int) -> String
extern fn txb_wes_present(slot: Int) -> String
extern fn txb_lyut_present(slot: Int) -> String
extern fn txb_wak_present(slot: Int) -> String
extern fn txb_map_canonical(verb: String) -> String
extern fn txb_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn txb_decline_masc(noun: String, gram_case: String, number: String) -> String
extern fn txb_decline_fem(noun: String, gram_case: String, number: String) -> String
extern fn txb_detect_gender(noun: String) -> String
extern fn txb_decline(noun: String, gram_case: String, number: String) -> String
extern fn txb_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
Generated Vendored
-25
View File
@@ -1,25 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn uga_str_ends(s: String, suf: String) -> Bool
extern fn uga_str_len(s: String) -> Int
extern fn uga_str_drop_last(s: String, n: Int) -> String
extern fn uga_slot(person: String, number: String) -> Int
extern fn uga_slot_g(person: String, gender: String, number: String) -> Int
extern fn uga_kn_perfect(slot: Int) -> String
extern fn uga_kn_imperfect(slot: Int) -> String
extern fn uga_is_copula(verb: String) -> Bool
extern fn uga_conjugate_copula(tense: String, slot: Int) -> String
extern fn uga_hlk_perfect(slot: Int) -> String
extern fn uga_hlk_imperfect(slot: Int) -> String
extern fn uga_ray_perfect(slot: Int) -> String
extern fn uga_ray_imperfect(slot: Int) -> String
extern fn uga_amr_perfect(slot: Int) -> String
extern fn uga_amr_imperfect(slot: Int) -> String
extern fn uga_generic_perfect(base3sg: String, slot: Int) -> String
extern fn uga_generic_imperfect(base3sg: String, slot: Int) -> String
extern fn uga_known_verb(verb: String, tense: String, slot: Int) -> String
extern fn uga_conjugate(verb: String, tense: String, person: String, number: String) -> String
extern fn uga_strip_nom(noun: String) -> String
extern fn uga_is_fem(noun: String) -> Bool
extern fn uga_decline(noun: String, gram_case: String, number: String) -> String
extern fn uga_noun_phrase(noun: String, gram_case: String, number: String, definite: String) -> String
extern fn uga_map_canonical(verb: String) -> String
Generated Vendored
-27
View File
@@ -1,27 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn str_ends(s: String, suf: String) -> Bool
extern fn str_last_char(s: String) -> String
extern fn str_last2(s: String) -> String
extern fn str_last3(s: String) -> String
extern fn str_drop_last(s: String, n: Int) -> String
extern fn is_vowel(c: String) -> Bool
extern fn morph_apply_suffix(base: String, suffix: String) -> String
extern fn en_irregular_plural(word: String) -> String
extern fn en_irregular_singular(word: String) -> String
extern fn en_irregular_verb(base: String) -> [String]
extern fn en_verb_3sg(base: String) -> String
extern fn en_should_double_final(base: String) -> Bool
extern fn en_verb_past(base: String) -> String
extern fn en_verb_gerund(base: String) -> String
extern fn en_pluralize_regular(singular: String) -> String
extern fn en_verb_form(base: String, tense: String, person: String, number: String) -> String
extern fn agree_determiner(det: String, noun: String) -> String
extern fn morph_pluralize(noun: String, profile: [String]) -> String
extern fn morph_map_canonical(verb: String, code: String) -> String
extern fn morph_conjugate(verb: String, tense: String, person: String, number: String, profile: [String]) -> String
extern fn morph_inflect(word: String, features: String, profile: [String]) -> String
extern fn pluralize(singular: String) -> String
extern fn singularize(plural: String) -> String
extern fn verb_form(base: String, tense: String, person: String, number: String) -> String
extern fn irregular_plural(word: String) -> String
extern fn irregular_singular(word: String) -> String
Generated Vendored
-39
View File
@@ -1,39 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn is_protected_node(id: String) -> Bool
extern fn api_err_protected(id: String) -> String
extern fn api_json_escape(s: String) -> String
extern fn api_query_param(path: String, key: String) -> String
extern fn api_query_int(path: String, key: String, default_val: Int) -> Int
extern fn api_ok(extra: String) -> String
extern fn api_err(msg: String) -> String
extern fn api_nonempty(s: String) -> Bool
extern fn api_or_empty(s: String) -> String
extern fn api_persisted(id: String) -> Bool
extern fn api_not_persisted(id: String) -> String
extern fn handle_api_begin_session(body: String) -> String
extern fn handle_api_compile_ctx(body: String) -> String
extern fn handle_api_remember(body: String) -> String
extern fn handle_api_node_create(body: String) -> String
extern fn handle_api_node_delete(body: String) -> String
extern fn handle_api_node_update(body: String) -> String
extern fn handle_api_recall(method: String, path: String, body: String) -> String
extern fn handle_api_search_knowledge(method: String, path: String, body: String) -> String
extern fn handle_api_browse_knowledge(path: String, body: String) -> String
extern fn handle_api_capture_knowledge(body: String) -> String
extern fn handle_api_evolve_knowledge(body: String) -> String
extern fn handle_api_promote_knowledge(body: String) -> String
extern fn handle_api_browse_processes(method: String, path: String, body: String) -> String
extern fn handle_api_define_process(body: String) -> String
extern fn handle_api_log_state_event(body: String) -> String
extern fn handle_api_list_state_events(method: String, path: String, body: String) -> String
extern fn handle_api_inspect_config(path: String, body: String) -> String
extern fn handle_api_tune_config(body: String) -> String
extern fn handle_api_inspect_graph(method: String, path: String, body: String) -> String
extern fn handle_api_link_entities(body: String) -> String
extern fn handle_api_forget(body: String) -> String
extern fn handle_api_evolve_memory(body: String) -> String
extern fn handle_api_memory_delete(body: String) -> String
extern fn handle_api_memory_update(body: String) -> String
extern fn handle_api_cultivate(body: String) -> String
extern fn handle_api_list_typed(node_type: String, path: String, body: String) -> String
extern fn handle_api_consolidate(body: String) -> String
Generated Vendored
+1
View File
@@ -71,6 +71,7 @@ el_val_t imprint_unload(void);
el_val_t idle_count(void); el_val_t idle_count(void);
el_val_t idle_inc(void); el_val_t idle_inc(void);
el_val_t idle_reset(void); el_val_t idle_reset(void);
el_val_t hebb_consolidate(void);
el_val_t ise_post(el_val_t content); el_val_t ise_post(el_val_t content);
el_val_t elapsed_ms(void); el_val_t elapsed_ms(void);
el_val_t elapsed_human(void); el_val_t elapsed_human(void);
Generated Vendored
-10
View File
@@ -1,10 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn agent_person(agent: String) -> String
extern fn agent_number(agent: String) -> String
extern fn realize_np(referent: String, number: String) -> String
extern fn realize_vp_lang(base_verb: String, tense: String, aspect: String, person: String, number: String, profile: [String]) -> [String]
extern fn realize_question_lang(predicate: String, tense: String, aspect: String, person: String, number: String, agent: String, patient: String, location: String, profile: [String]) -> String
extern fn capitalize_first(s: String) -> String
extern fn add_punct(s: String, intent: String) -> String
extern fn realize_lang(form: [String], profile: [String]) -> String
extern fn realize(form: [String]) -> String
Generated Vendored
-16
View File
@@ -1,16 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn flag_true(body: String, key: String) -> Bool
extern fn rate_limit_check(ip: String, path: String) -> String
extern fn strip_query(path: String) -> String
extern fn err_404(path: String) -> String
extern fn err_405(method: String, path: String) -> String
extern fn route_health() -> String
extern fn route_lineage() -> String
extern fn route_imprint_contextual(body: String) -> String
extern fn route_imprint_user(body: String) -> String
extern fn route_synthesize(body: String) -> String
extern fn handle_dharma_recv(body: String) -> String
extern fn connectd_get(suffix: String) -> String
extern fn connectd_post(suffix: String, body: String) -> String
extern fn handle_connectors(method: String, clean: String, body: String) -> String
extern fn handle_request(method: String, path: String, body: String) -> String
Generated Vendored
-29
View File
@@ -1,29 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn soft_bell_threshold() -> Int
extern fn hard_bell_threshold() -> Int
extern fn safety_score_crisis(input: String) -> Int
extern fn safety_score_harm(input: String) -> Int
extern fn safety_score_danger(input: String) -> Int
extern fn safety_score_distress_history(history: String) -> Int
extern fn safety_threat_score(input: String, history: String) -> Int
extern fn safety_screen(input: String, history: String) -> String
extern fn safety_validate(output: String, action: String) -> String
extern fn safety_log_bell(level: String, reason: String, input_summary: String) -> String
extern fn safety_self_harm_phrases() -> String
extern fn safety_abuse_phrases() -> String
extern fn safety_general_hard_phrases() -> String
extern fn safety_threat_to_others_phrases() -> String
extern fn safety_soft_phrases() -> String
extern fn safety_normalize(message: String) -> String
extern fn safety_any_match(text: String, phrases_json: String) -> Bool
extern fn safety_count_match(text: String, phrases_json: String) -> Int
extern fn safety_positive_phrases() -> String
extern fn safety_detect_positive_level(message: String) -> String
extern fn safety_detect_bell_level(message: String) -> String
extern fn safety_classify_hard_bell(message: String) -> String
extern fn safety_soft_directive() -> String
extern fn safety_hard_directive(hard_type: String) -> String
extern fn safety_augment_system(system: String, user_msg: String) -> String
extern fn safety_contact_path() -> String
extern fn handle_safety_contact_get() -> String
extern fn handle_safety_contact_post(body: String) -> String
Generated Vendored
-18
View File
@@ -1,18 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn sem_frame(intent: String, subject: String, obj: String, modifiers: String) -> [String]
extern fn sem_frame_lang(intent: String, subject: String, obj: String, modifiers: String, lang_code: String) -> [String]
extern fn sem_frame_simple(intent: String, subject: String) -> [String]
extern fn sem_frame_obj(intent: String, subject: String, obj: String) -> [String]
extern fn sem_intent(frame: [String]) -> String
extern fn sem_subject(frame: [String]) -> String
extern fn sem_object(frame: [String]) -> String
extern fn sem_modifiers(frame: [String]) -> String
extern fn sem_lang(frame: [String]) -> String
extern fn sem_first_modifier(mods: String) -> String
extern fn sem_intent_to_realize(intent: String) -> String
extern fn sem_to_spec(frame: [String]) -> [String]
extern fn sem_to_spec_full(frame: [String], verb: String, tense: String, aspect: String) -> [String]
extern fn sem_realize_greet(subject: String) -> String
extern fn sem_realize(frame: [String]) -> String
extern fn sem_realize_full(frame: [String], verb: String, tense: String, aspect: String) -> String
extern fn sem_realize_lang(frame: [String], lang_code: String) -> String
Generated Vendored
-17
View File
@@ -1,17 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn session_title_from_message(message: String) -> String
extern fn session_make_content(id: String, title: String, created_at: Int, updated_at: Int, folder: String) -> String
extern fn session_exists(session_id: String) -> Bool
extern fn session_create(body: String) -> String
extern fn session_create_cleanup(session_id: String) -> String
extern fn session_list() -> String
extern fn session_get(session_id: String) -> String
extern fn session_delete(session_id: String) -> String
extern fn session_update_patch(session_id: String, body: String) -> String
extern fn session_search_entry(node: String) -> String
extern fn session_search(query: String) -> String
extern fn session_hist_load(session_id: String) -> String
extern fn session_hist_save(session_id: String, hist: String) -> Void
extern fn session_update_meta_timestamp(session_id: String) -> Void
extern fn session_auto_title(session_id: String, first_message: String) -> Void
extern fn handle_session_approve(session_id: String, body: String) -> String
Generated Vendored
+3663 -2612
View File
File diff suppressed because one or more lines are too long
Generated Vendored
+7 -7
View File
@@ -1,17 +1,17 @@
# soul.c.stamp — fingerprint of the .el sources dist/soul.c was generated from. # soul.c.stamp — fingerprint of the .el sources dist/soul.c was generated from.
# Written by tools/soulc-stamp.sh --write. Do not hand-edit. # Written by tools/soulc-stamp.sh --write. Do not hand-edit.
# generated_amalgam_sha256 cdc5e716dbfb797faa1b3e080cbd1ac82a75a258809da70cc5fbd02cc8040692 # generated_amalgam_sha256 3293d35e6659b05164bb07c01ad1cc2bc4ff49859d33203528cc44e8a7f0dd1f
# generated_amalgam_bytes 1205007 # generated_amalgam_bytes 1259295
7cf5e29d2618db2fca04e6df7aa8954dd6cf9ac5e70aafb8e0b52aa734882131 __compiler__ MISSING __compiler__
f8597e10546654bce3fbbe40461b2da59d0e06dbf1b038d1d362d24f949e3911 awareness.el 6d8594cd93fcaaf930eda162e5922cf51724d12909050cb4f5fde33bac04db89 awareness.el
b6f3d14ca0c26017a2d617399a6d3754dabb0905e4d5f52eb75d25c4ad18d3c5 chat.el 2ff2dada732918c788a9ef66c6fd54c7a24cc4bbd4829197fe945d3a75ca1929 chat.el
42288c212cbf72fb1e8ecbd4d9900e4e9ee1cfa475b7974295c7637f1bf2939f elp-input.el 42288c212cbf72fb1e8ecbd4d9900e4e9ee1cfa475b7974295c7637f1bf2939f elp-input.el
b3f77f49d6086932c38bd17fe7a5eaf8bce25685f6fc3e1750f05729c6b49b9e imprint.el b3f77f49d6086932c38bd17fe7a5eaf8bce25685f6fc3e1750f05729c6b49b9e imprint.el
fba8ffdb9ba72bca5b09ca1c93a520edc52f3f4d8aec2c7585fe9b17e06420b2 manifest.el fba8ffdb9ba72bca5b09ca1c93a520edc52f3f4d8aec2c7585fe9b17e06420b2 manifest.el
550a72e234ae8cec1f33e02108fd365353f45edd88513da90b792e79b6c0e5f0 memory.el 550a72e234ae8cec1f33e02108fd365353f45edd88513da90b792e79b6c0e5f0 memory.el
5ec07ec9785b02abe32f3ff7acf2d1f9f7e07c0967fac97e6eff17d7110b5c84 neuron-api.el 34a2fc38f2022069506b1d71b2c1cceb1a2e3b01a1c03bc8026a00e88a842a6d neuron-api.el
03c47c451e0e87f2c252cadb4b765867943962a804f548dd53adeef0520912c8 persist.el 03c47c451e0e87f2c252cadb4b765867943962a804f548dd53adeef0520912c8 persist.el
a6d69f3fc55233d9d3300160fd46a1551f2064bcd0fb84e2c9e432f636a72476 routes.el 6f1f3d51a51614bbd72b828c98483dbc733f59f4c4101d0c8284dec1c31ef256 routes.el
c28e36952ec56525963a0bdf29455ab097d3b0c5653d19c25fbb005e1069a1f7 safety.el c28e36952ec56525963a0bdf29455ab097d3b0c5653d19c25fbb005e1069a1f7 safety.el
fd3ab91d0ae0ea26639e21bef2f8f94054dc4b02eae68b19e3fe689d2769aad4 sessions.el fd3ab91d0ae0ea26639e21bef2f8f94054dc4b02eae68b19e3fe689d2769aad4 sessions.el
5613b60d74d5d7768f46da5ac435a5dd99d38c27f0f7013c89fa27e98dc8a21c soul.el 5613b60d74d5d7768f46da5ac435a5dd99d38c27f0f7013c89fa27e98dc8a21c soul.el
Generated Vendored
-8
View File
@@ -1,8 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn init_soul_edges() -> Void
extern fn ensure_self_canonical_bridge() -> Void
extern fn aff_try_slot(slot_json: String, aff_7d_ts: Int, acc_key: String) -> Void
extern fn load_identity_context() -> Void
extern fn seed_persona_from_env() -> Void
extern fn emit_session_start_event() -> Void
extern fn layered_cycle(raw_input: String) -> String
Generated Vendored
-11
View File
@@ -1,11 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn steward_log_event(kind: String, detail: String) -> Void
extern fn steward_get_mission() -> String
extern fn steward_align(input: String, imprint_id: String) -> String
extern fn steward_validate_imprint(imprint_id: String, tool_name: String) -> String
extern fn steward_cgi_check(action: String) -> String
extern fn steward_fingerprint_session(input: String, session_id: String) -> String
extern fn extract_dim(content: String, key: String) -> String
extern fn steward_build_baseline() -> String
extern fn steward_check_continuity(current_fingerprint: String, session_id: String) -> String
extern fn steward_session_check(input: String, session_id: String) -> String
Generated Vendored
-12
View File
@@ -1,12 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn auth_headers(tok: String) -> Map
extern fn axon_get(path: String) -> String
extern fn axon_post(path: String, body: String) -> String
extern fn handle_conversations(method: String) -> String
extern fn handle_config(method: String, body: String) -> String
extern fn dharma_registry() -> String
extern fn dharma_network_state() -> String
extern fn handle_dharma(path: String, method: String, body: String) -> String
extern fn handle_tool(path: String, method: String, body: String) -> String
extern fn handle_nlg(path: String, method: String, body: String) -> String
extern fn render_studio() -> String
Generated Vendored
-20
View File
@@ -1,20 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn lex_word(entry: [String]) -> String
extern fn lex_pos(entry: [String]) -> String
extern fn lex_form(entry: [String], idx: Int) -> String
extern fn lex_class(entry: [String]) -> String
extern fn make_entry(word: String, pos: String, f0: String, f1: String, f2: String, f3: String, f4: String, cls: String) -> [String]
extern fn make_entry2(word: String, pos: String, f0: String, f1: String, cls: String) -> [String]
extern fn make_entry3(word: String, pos: String, f0: String, f1: String, f2: String, cls: String) -> [String]
extern fn make_entry1(word: String, pos: String, f0: String, cls: String) -> [String]
extern fn build_vocab() -> [[String]]
extern fn get_vocab() -> [[String]]
extern fn vocab_lookup(word: String, lang_code: String) -> [String]
extern fn vocab_lookup_en(word: String) -> [String]
extern fn vocab_synonym(word: String, lang_register: String, lang_code: String) -> String
extern fn vocab_by_pos(pos: String) -> [[String]]
extern fn vocab_by_class(cls: String) -> [[String]]
extern fn entry_found(entry: [String]) -> Bool
extern fn entry_word(entry: [String]) -> String
extern fn entry_pos(entry: [String]) -> String
extern fn entry_form(entry: [String], n: Int) -> String
+23 -10
View File
@@ -26,7 +26,7 @@ Three things run together to make that true:
engram is a *sibling* repo (`foundation/el/engram`), compiled and co-located at engram is a *sibling* repo (`foundation/el/engram`), compiled and co-located at
runtime, not part of this repo's source tree. runtime, not part of this repo's source tree.
- **The El runtime** — `el_runtime.c` / `el_runtime.h`. Every compiled El binary - **The El runtime** — `el_runtime.c` / `el_runtime.h`. Every compiled El binary
links it. It implements all builtins (`engram_*`, `http_*`, `json_*`, LLM, links it. It implements all builtins (`engram_`*, `http_*`, `json_*`, LLM,
crypto) and *is* the database — "no SQL, no db layer, no SQLite" crypto) and *is* the database — "no SQL, no db layer, no SQLite"
(`../foundation/el/engram/src/server.el:4-6`). (`../foundation/el/engram/src/server.el:4-6`).
@@ -83,10 +83,9 @@ difference because they drive the whole component split:
delivered by the **proxy → wrapper** chain, which translates MCP JSON-RPC delivered by the **proxy → wrapper** chain, which translates MCP JSON-RPC
into the soul's HTTP REST calls. The wrapper carries a catalog of ~90 tools into the soul's HTTP REST calls. The wrapper carries a catalog of ~90 tools
(`mcp-wrapper/src/main.el`). (`mcp-wrapper/src/main.el`).
2. **The HTTP API** — the *cognitive* interface. The soul serves REST on 2. **The HTTP API** — the *cognitive* interface. The soul serves REST on
`:7770`. `routes.el` dispatches; `neuron-api.el` handles the cognitive `:7770`. `routes.el` dispatches; `neuron-api.el` handles the cognitive
endpoints (`/api/neuron/*`). This same surface backs the chat product endpoints (`/api/neuron/`*). This same surface backs the chat product
(`/api/chat`, `/api/sessions`) and the studio UI (`/`). (`/api/chat`, `/api/sessions`) and the studio UI (`/`).
In production the MCP client connects to the soul's HTTP directly — the In production the MCP client connects to the soul's HTTP directly — the
@@ -98,13 +97,14 @@ stdio MCP client speak to an HTTP soul. See `04-runtime-and-deployment.md`.
The full VBD classification is in `01-vbd-decomposition.md`. In one glance: The full VBD classification is in `01-vbd-decomposition.md`. In one glance:
| Layer | Module(s) | Role | | Layer | Module(s) | Role |
|---|---|---| | --------------------- | ------------------------------------------- | ------------------------------------------------------------------------ |
| HTTP dispatch | `routes.el` | Manager — hand-written method/path dispatch | | HTTP dispatch | `routes.el` | Manager — hand-written method/path dispatch |
| Cognitive API | `neuron-api.el` | Managers + Engines — session/memory/knowledge/graph/cultivation handlers | | Cognitive API | `neuron-api.el` | Managers + Engines — session/memory/knowledge/graph/cultivation handlers |
| Request pipeline | `soul.el` `layered_cycle` | Manager — L1 safety → L2 stewardship → L3 imprint | | Request pipeline | `soul.el` `layered_cycle` | Manager — L1 safety → L2 stewardship → L3 imprint |
| Boot + identity | `soul.el` | Manager — compose layers, seed identity graph, start server + daemon | | Boot + identity | `soul.el` | Manager — compose layers, seed identity graph, start server + daemon |
| Autonomous cognition | `awareness.el` | Manager (`awareness_run`) + Engines (curiosity, attend, threat) | | Autonomous cognition | `awareness.el` | Manager (`awareness_run`) + Engines (~~curiosity~~ †, attend, threat) |
| Memory access | `memory.el` | Resource Accessor over the engram FFI/HTTP | | Memory access | `memory.el` | Resource Accessor over the engram FFI/HTTP |
| Store | `engram/server.el` + `el_runtime.c` | Accessor (HTTP) over the real graph engine | | Store | `engram/server.el` + `el_runtime.c` | Accessor (HTTP) over the real graph engine |
| Request-layer rules | `safety.el`, `stewardship.el`, `imprint.el` | Engines | | Request-layer rules | `safety.el`, `stewardship.el`, `imprint.el` | Engines |
@@ -112,19 +112,31 @@ The full VBD classification is in `01-vbd-decomposition.md`. In one glance:
| MCP transport | `mcp-proxy`, `mcp-wrapper` | Managers/Accessors — protocol boundary | | MCP transport | `mcp-proxy`, `mcp-wrapper` | Managers/Accessors — protocol boundary |
| Build | `manifest.el`, `dist/soul.c`, El toolchain | amalgamation → `soul.c` → binary | | Build | `manifest.el`, `dist/soul.c`, El toolchain | amalgamation → `soul.c` → binary |
> **† Superseded (2026-08-16) — see `06-cognitive-architecture.md` §12.3.**
> Curiosity is **not a peer Engine** beside `attend` and `threat`. It is not a
> component at all: **curiosity is wonder crystallized at a nucleation site** —
> one thing at two phases, where wonder is the field (unbounded, objectless,
> invariant, present wherever there is structure) and curiosity is the
> precipitate (localized, with an object, able to direct activation). What it
> seeds is the **same** activation process `attend` runs; there is one activation
> process with two seed sources — external (a request) and internal (a
> curiosity) — not two processes negotiating for a resource. Modelling it as a
> peer Engine is what produced the timed `proactive_curiosity` scan documented in
> `02-components.md §3b`.
## Reading guide ## Reading guide
- **`01-vbd-decomposition.md`** — the volatility analysis. Start here for *why* - `**01-vbd-decomposition.md`** — the volatility analysis. Start here for *why*
the boundaries fall where they do. Contains the full Manager/Engine/Accessor/ the boundaries fall where they do. Contains the full Manager/Engine/Accessor/
Utility table and the honest list of where the real code diverges from VBD. Utility table and the honest list of where the real code diverges from VBD.
- **`02-components.md`** — per-subsystem detail: routing, the cognitive API, the - `**02-components.md*`* — per-subsystem detail: routing, the cognitive API, the
memory & activation engine, the MCP transport chain. Read after 01. memory & activation engine, the MCP transport chain. Read after 01.
- **`03-data-and-memory.md`** — the engram graph model: node/edge structs, - `**03-data-and-memory.md**` — the engram graph model: node/edge structs,
layers, the two tier systems, write-protection, tombstone/supersede layers, the two tier systems, write-protection, tombstone/supersede
immutability, persistence. immutability, persistence.
- **`04-runtime-and-deployment.md`** — process/port topology, the end-to-end MCP - `**04-runtime-and-deployment.md**` — process/port topology, the end-to-end MCP
request path, local vs GKE blue/green, secrets/config. request path, local vs GKE blue/green, secrets/config.
- **`05-el-and-build.md`** — the El language, the `elc`/`elb` toolchain, the - `**05-el-and-build.md**` — the El language, the `elc`/`elb` toolchain, the
amalgamation → `soul.c` → binary pipeline, and the compile-time capability amalgamation → `soul.c` → binary pipeline, and the compile-time capability
gates. gates.
@@ -143,3 +155,4 @@ straight:
neuron-api / MCP layer routes every user-facing delete through *tombstone* neuron-api / MCP layer routes every user-facing delete through *tombstone*
instead (`memory.el:46`). The invariant is a policy, not a property of the instead (`memory.el:46`). The invariant is a policy, not a property of the
accessor. accessor.
+13 -1
View File
@@ -45,6 +45,18 @@ rotation, novelty gating, and the inbox verb-mapping in `attend()`. The
(comments spanning 2026-05 → 2026-08). This is where the *behavior* of the (comments spanning 2026-05 → 2026-08). This is where the *behavior* of the
agent is tuned. agent is tuned.
> **Superseded (2026-08-16) — see `06-cognitive-architecture.md` §12.3.**
> The volatility this Engine encapsulates is **real churn around a wrong model**.
> "Seed-domain selection" and "curiosity rotation" are a maintained manifest of
> things to be curious about; a nucleation site is a **per-edge structural fact**
> (`|discord|` = `|z(semantic proximity) z(association strength)|`, `06` §12.4),
> not an entry in a rotation. The deep git-archaeology cited here is itself
> evidence: an Engine that has been re-tuned continuously since 2026-05 is
> encapsulating volatility that the substrate should have made constant.
> **Curiosity does not search for nucleation sites; it goes where salience
> already is** — machinery that already exists (`salience`,
> `background_activation`, `working_memory_weight`, `wm_anchor`).
### 3. Epistemic & memory semantics ### 3. Epistemic & memory semantics
Tiers, salience mapping, promotion/consolidation, the immutability policy Tiers, salience mapping, promotion/consolidation, the immutability policy
(tombstone/supersede), and knowledge disposition. These evolve as the memory (tombstone/supersede), and knowledge disposition. These evolve as the memory
@@ -89,7 +101,7 @@ placement. Paths are repo-relative unless noted `foundation/…`.
|---|---|---| |---|---|---|
| `api_compact_*`, `begin_session`, `compile_ctx` | `neuron-api.el:90-317` | Axis 1 — context/payload shaping. The single most-reworked logic on the API side. | | `api_compact_*`, `begin_session`, `compile_ctx` | `neuron-api.el:90-317` | Axis 1 — context/payload shaping. The single most-reworked logic on the API side. |
| `attend()` | `awareness.el:926-973` | Axis 2 — inbox content → action-verb ruleset. | | `attend()` | `awareness.el:926-973` | Axis 2 — inbox content → action-verb ruleset. |
| `proactive_curiosity`, `auto_term_try_slot` | `awareness.el:590-876` | Axis 2 — seed selection, stopword/IDF gates, tabu ring. Textbook Engine: highest churn. | | `proactive_curiosity`, `auto_term_try_slot` | `awareness.el:590-876` | Axis 2 — seed selection, stopword/IDF gates, tabu ring. Textbook Engine: highest churn. **Superseded (2026-08-16): curiosity is not an Engine — see Axis 2 above and `06` §12.3.** |
| threat scoring | `awareness.el:1286-1419` | Axis 4 — additive command/path/history threat rules. | | threat scoring | `awareness.el:1286-1419` | Axis 4 — additive command/path/history threat rules. |
| `safety.el` (crisis/harm/bell) | `safety.el` | Axis 4 — crisis screening, bell thresholds, output validation. | | `safety.el` (crisis/harm/bell) | `safety.el` | Axis 4 — crisis screening, bell thresholds, output validation. |
| `stewardship.el` | `stewardship.el` | Axis 4 — mission alignment, CGI check, continuity fingerprint. | | `stewardship.el` | `stewardship.el` | Axis 4 — mission alignment, CGI check, continuity fingerprint. |
+77 -2
View File
@@ -45,7 +45,7 @@ raw `/api/graph*` reads.
| Graph/activation | `/api/neuron/graph`, `/graph/link`, `/api/graph*`, `/list/:type` | neuron-api + engram builtins | | Graph/activation | `/api/neuron/graph`, `/graph/link`, `/api/graph*`, `/list/:type` | neuron-api + engram builtins |
| Cultivation/self | `/api/neuron/cultivate`, `/lineage`, `/imprint/*`, `/synthesize` | neuron-api, routes.el | | Cultivation/self | `/api/neuron/cultivate`, `/lineage`, `/imprint/*`, `/synthesize` | neuron-api, routes.el |
| Processes/config | `/api/neuron/processes{,/define}`, `/config{,/tune}` | neuron-api | | Processes/config | `/api/neuron/processes{,/define}`, `/config{,/tune}` | neuron-api |
| State/consolidate | `/api/neuron/state-events`, `/consolidate` | neuron-api | | State/consolidate | `/api/neuron/state-events`, `/consolidate` | neuron-api*one of eleven consolidation implementations; see `06` §12.4* |
| Backlog/artifacts | `/api/backlog`, `/artifacts`, `/projects`, `/memories` | Axon (HTTP) | | Backlog/artifacts | `/api/backlog`, `/artifacts`, `/projects`, `/memories` | Axon (HTTP) |
| Chat/NLG | `/api/chat`, `/see`, `/elp/chat`, `/dharma*`, `/nlg*` | chat.el, elp-input.el | | Chat/NLG | `/api/chat`, `/see`, `/elp/chat`, `/dharma*`, `/nlg*` | chat.el, elp-input.el |
| Health/UI | `/health`, `/lineage`, `/` | routes.el, studio.el | | Health/UI | `/health`, `/lineage`, `/` | routes.el, studio.el |
@@ -112,6 +112,13 @@ tombstoning.
identity-write path, gated by convention to Will's explicit cultivation identity-write path, gated by convention to Will's explicit cultivation
sessions. sessions.
> **Consolidation has no owner (2026-08-16) — see `06` §12.4.** `/consolidate`
> below and `mem_consolidate` in the table further down are two of **eleven**
> measured consolidation implementations, spread across three languages and two
> processes. Consolidation had no owner, so it was implemented at every site that
> needed a piece of it. Every name in the set is a consolidation verb — compress,
> cultivate, digest, integrate, review, reify, beat.
- **Config / processes / state-events / consolidate** — config anchors + a - **Config / processes / state-events / consolidate** — config anchors + a
`ConfigEntry` node search (`:616-639`), `tune_config` (`:642-653`), `ConfigEntry` node search (`:616-639`), `tune_config` (`:642-653`),
`browse_processes` / `define_process` (`:547-568`), state-event log/list `browse_processes` / `define_process` (`:547-568`), state-event log/list
@@ -155,7 +162,7 @@ The single isolation point over the engram FFI. Key functions:
| `mem_strengthen` | `42-44` | `engram_strengthen` | salience bump | | `mem_strengthen` | `42-44` | `engram_strengthen` | salience bump |
| `mem_tombstone` | `52-62` | `engram_node_full` + `engram_connect` | the one canonical soft-delete | | `mem_tombstone` | `52-62` | `engram_node_full` + `engram_connect` | the one canonical soft-delete |
| `mem_forget` | `70-72` | `mem_tombstone` | soft delete (no longer hard) | | `mem_forget` | `70-72` | `mem_tombstone` | soft delete (no longer hard) |
| `mem_consolidate` | `92-133` | `engram_wm_top_json`, `engram_strengthen` | salience-evolution pass | | `mem_consolidate` | `92-133` | `engram_wm_top_json`, `engram_strengthen` | salience-evolution pass*one of eleven consolidation implementations, `06` §12.4* |
| `mem_save` / `mem_load` | `135-148` | `engram_save/load` | snapshot I/O | | `mem_save` / `mem_load` | `135-148` | `engram_save/load` | snapshot I/O |
Note the distinction between **recall and search**: `mem_recall` fires spreading Note the distinction between **recall and search**: `mem_recall` fires spreading
@@ -166,6 +173,22 @@ and to the MCP surface vocabulary.
### 3b. Autonomous cognition — `awareness.el` (the daemon) ### 3b. Autonomous cognition — `awareness.el` (the daemon)
> **Corrected (2026-08-16) — see `06-cognitive-architecture.md` §12.4.**
> `awareness_run()`'s **continuous, in-process loop is the one fragment of
> consolidation with the correct shape.** It is not a scheduled job; it runs while
> the process serves. Everything below that is described as *"every 60s" /
> "every 30s" / "every 10 min"* is an interval inside that loop, and the design
> spec's verdict is that intrinsic rhythm — not an external clock — is what these
> should be. Consolidation is **ambient, not scheduled: a brain has no cron job**,
> and **the presence of a ticker is the diagnostic.** The genuinely external
> tickers are catalogued in `06` §12.4; this loop is the shape they fold *into*.
>
> **Stale line numbers (verified 2026-08-16):** `awareness_run()` is defined at
> `awareness.el:1221` (its `while true` at `:1252`), not `:1097-1284`; it is
> launched from `soul.el:731`, not `soul.el:627`. `SOUL_TICK_MS` is read at
> `awareness.el:1228` (default **200 ms**) and `SOUL_HEARTBEAT_MS` at `:1248`
> (default **60000 ms**) — those two defaults are correct as documented.
`awareness.el` is the **idle-cognition daemon plus observability**, not `awareness.el` is the **idle-cognition daemon plus observability**, not
emotional-state code. `awareness_run()` (`:1097-1284`) is the master loop, emotional-state code. `awareness_run()` (`:1097-1284`) is the master loop,
launched last from `soul.el:627`. Each tick (`SOUL_TICK_MS`, ~200ms): launched last from `soul.el:627`. Each tick (`SOUL_TICK_MS`, ~200ms):
@@ -184,8 +207,26 @@ launched last from `soul.el:627`. Each tick (`SOUL_TICK_MS`, ~200ms):
top result **only if it changed** (novelty-gated), and derives an top result **only if it changed** (novelty-gated), and derives an
autobiographical seed from the top-10 working-memory nodes with autobiographical seed from the top-10 working-memory nodes with
stopword/IDF/tabu filtering. stopword/IDF/tabu filtering.
> **Superseded (2026-08-16) — see `06` §12.3.** Three errors in one name.
> (a) **Curiosity is not a scan.** Nothing in a mind sweeps its neighbourhoods
> to find what is surprising — the surprise captures attention; salience is
> bottom-up. A search asks *"which of these is odd"*; a mind has
> *"something is odd **here**"* for free. A sweep over regions is a supervisor.
> (b) **It is not on a timer.** "Every 30s when idle" is an external clock
> standing in for a drive. Low activation is aversive and the system
> self-activates; there is **one activation process with two seed sources** —
> external (a request) and internal (a curiosity) — not a scheduled scan
> competing for spare capacity.
> (c) **Rotating 4 seed-domain sets is a manifest.** Curiosity is wonder
> crystallized at a nucleation site, and a nucleation site is a per-edge
> structural fact (`|discord|`, `06` §12.4), not an entry in a rotation.
4. **Engram sync** (every 10 min): `GET /api/sync``engram_load_merge` 4. **Engram sync** (every 10 min): `GET /api/sync``engram_load_merge`
telemetry prune. telemetry prune.
> **Ticker, but not consolidation (2026-08-16).** Sync is store coherence
> between the two-store topology (`06` §2.3), not dreaming. Distinguished
> here because `06` §12.4 sweeps for tickers. **Not** to be confused with the
> separate `ai.neuron.engram-tick` launch agent (`StartInterval = 600`), which
> pokes `POST /api/tick` and **is** consolidation driven by an external clock.
Two functions carry most of the file's weight and volatility: Two functions carry most of the file's weight and volatility:
- **`hebb_consolidate()`** (`:64-99`) — the durable-learning write-back. It drains - **`hebb_consolidate()`** (`:64-99`) — the durable-learning write-back. It drains
@@ -276,3 +317,37 @@ the Accessor that isolates the *MCP protocol* boundary from the soul (the soul
knows only HTTP). The multi-hop shape is justified: the client transport, the knows only HTTP). The multi-hop shape is justified: the client transport, the
protocol translation, and the cognition each change for different reasons and are protocol translation, and the cognition each change for different reasons and are
deployed/updated independently. deployed/updated independently.
## 5. The decorated seam — surface reshape + declared routing (IN PROGRESS — proven on clone)
Two in-flight changes reshape how this component surface is *declared*. Both are
proven only on isolated worktree clones (dev ports); **live `:8742` is untouched
and nothing is promoted.** See `06-cognitive-architecture.md` (Update — 2026-08-14
deep night) for the cognitive framing.
- **The ~90-tool catalog collapses to geometry ops.** The `dispatch_tool_call`
catalog of ~90 noun-organized tools (§4) collapses to a handful of **geometry
operations**, the old noun becoming a `type` parameter: **`read`** (the
*vantage-read* — re-origin + salience/recency + an **aperture** → a *bounded*
slice, the structural cure for the whole-self dump), **`write`** (add node),
**`relate`** (add typed edge), **`supersede`** (evolve/tombstone/promote as
new-node-plus-edge, never a hard delete — §3-data-and-memory `§Immutability`),
plus the agentic primitives **`think`/`attend`/`learn`/`ground`/`assert`**.
**Proven on clone:** the four ops live in an El surface module with a parity
harness, and the aperture bounds output (small limit → kilobytes, large limit →
hundreds of kilobytes). **Not done:** compiling the surface into the MCP server,
hot-swap, wiring all ~90 aliases into dispatch.
- **`@route` declares dispatch; VBD-role decorators are the wiring sockets.**
Instead of the hand-written `handle_request` if-else in the soul (§1), a
function is decorated with `@route(path, method, …)` and the compiler
**synthesizes `el_route_dispatch`**. **Proven on clone:** a decorated service
(with `@route` stacked on `@accessor`/`@manager`) compiled via a rebuilt `elc`
and served on `:8951` with no hand-written dispatch. **Honest limits:** `@route`
currently lives only on the unmerged branch `feat/el-route-decorators`;
`@manager`/`@engine`/`@accessor` are **parsed but structurally inert** in the
shipped compiler today (their only effect is a compile-time guard); and the
intended **telemetry/interoception auto-emit + dharma-bus auto-wiring** at the
component boundary are **staged as a diff, not shipped**. Inside the mind's
process an `@accessor` reaches the engram via **in-process `engram_*` builtins**,
not an HTTP hop to a separate service.
+98 -3
View File
@@ -82,6 +82,20 @@ deliberately separate from the static authored `weight`. Edges are created via
`supersedes`, `tombstones`, `contains`, `tagged` (`neuron-api.el`, `supersedes`, `tombstones`, `contains`, `tagged` (`neuron-api.el`,
`el_runtime.c:6168`). `el_runtime.c:6168`).
> **Edges as vectors — the intended model (TARGET; today's edge is scalar).** The
> live edge above carries a typed `relation` string plus **scalar** strength
> channels (`weight`, `hebb`). The design target is for an edge to be a **vector**
> — a first-class carrier of relationship-*meaning* in the node space — so that
> relationships can be **composed / subtracted / analogized / traversed** like
> nodes (the `06` §6 operator algebra over edges). Combined with append-only, this
> yields a **complete temporal record**: every discrete, significant change to a
> relationship is appended (a keyframe on material change), so the **full 4-D
> trajectory** of the meaning-manifold is preserved and `recall_at(t)` can read
> how any relationship was configured at any past `t` — bounded, because changes
> are discrete and meaning saturates by compositionality. **Status: TARGET / #39**
> (see `07-storage-coherence-and-distribution.md` §2.4); the runtime edge is scalar
> today.
## Consciousness layers ## Consciousness layers
Orthogonal to memory tiers, the engram has five canonical **layers** Orthogonal to memory tiers, the engram has five canonical **layers**
@@ -135,6 +149,35 @@ read — unverified/TODO.)*
## Write-protection ## Write-protection
> **Superseded (2026-08-16) — see `06-cognitive-architecture.md` §12.5.**
> Authority: `foundation/el/lang/spec/correspondence-and-censorship.md` §6 (branch
> `design/correspondence-and-censorship`).
>
> > **In an immutable substrate, any mechanism that refuses a write is either
> > redundant with immutability, or an epistemic constraint misfiled as a
> > protective one.**
>
> The requirement this gate was built for was never stated. It is
> **non-circularity of the reference frame** — a reference fitted to its own
> readings reports perfect correspondence forever while drift becomes
> undetectable from inside. That requirement is satisfied by *when* (the frame
> updates while activation is internally seeded, not while it is being used to
> act), not by *what*, so **the gate becomes unnecessary rather than removed, and
> nothing takes its place.** Corruption requires mutation, and the engram does not
> mutate: recoverability, governance, evidence quality, and rate are already
> properties of the substrate. Only **authorization** is residue, and it is
> bounded — an unauthorized writer can *propose*, never erase.
>
> **This section contradicts itself.** Thirty-five lines below, under
> *Immutability*, this same document states the conclusion in its own words:
> *"nothing it does is ever destructive — the safety is **after** the act, not a
> gate before it"* (`:185-187`). The 403 gate documented here **is** the
> before-the-act gate that sentence says is unnecessary. The design spec §6 names
> exactly this redundancy.
>
> The mechanism below is **still LIVE in code** and is described accurately; what
> is superseded is the claim that it is needed.
`is_protected_node(id)` (`neuron-api.el:20-37`) is a **hard-coded allowlist of 15 `is_protected_node(id)` (`neuron-api.el:20-37`) is a **hard-coded allowlist of 15
identity/value node IDs** — the self root, the values hub, intellectual-dna, identity/value node IDs** — the self root, the values hub, intellectual-dna,
memory-philosophy, voice, and the 8 value nodes. Handlers that could mutate the memory-philosophy, voice, and the 8 value nodes. Handlers that could mutate the
@@ -144,10 +187,16 @@ graph (tombstone / supersede / evolve / connect) check it and return HTTP 403
(`handle_api_link_entities`). (`handle_api_link_entities`).
**The one sanctioned override** is `POST /api/neuron/cultivate` **The one sanctioned override** is `POST /api/neuron/cultivate`
(`neuron-api.el:781-816`) — it performs the same ops with the protection check (`handle_api_cultivate`, `neuron-api.el:960` — **the `:781-816` cited here is
stale; verified 2026-08-16**) — it performs the same ops with the protection check
skipped, gated by convention to Will's explicit cultivation sessions. The self skipped, gated by convention to Will's explicit cultivation sessions. The self
layer is writable, but only through a deliberate door. layer is writable, but only through a deliberate door.
> **Superseded (2026-08-16).** A door built for a wall that need not stand. Per
> §12.5 of `06`, the gate above is redundant with immutability, so the override
> for it is redundant too. Neither is deleted here — this is a documentation
> branch; the change is sequenced in `correspondence-and-censorship.md` §11.
## Immutability — tombstone, never delete ## Immutability — tombstone, never delete
Engram nodes are immutable (`memory.el:64-69`). The model is: Engram nodes are immutable (`memory.el:64-69`). The model is:
@@ -165,6 +214,13 @@ Engram nodes are immutable (`memory.el:64-69`). The model is:
returns both ids so the caller re-points. This is the `supersedes_id` returns both ids so the caller re-points. This is the `supersedes_id`
pattern: new node linked, old preserved, full audit trail. pattern: new node linked, old preserved, full audit trail.
> **Supersession is residue, not garbage.** The superseded node is the *trail of
> how the current understanding was reached* — kept deliberately, because sometimes
> the truth was in the **old** idea even when the old idea was not itself the truth.
> This is what lets autonomous self-reification (`06` §4.1) run ungated: every
> rename/re-cluster supersedes into this residue chain, so nothing it does is ever
> destructive — the safety is *after* the act, not a gate before it.
> **The hole to know about.** The raw runtime `engram_forget` **does** hard-delete > **The hole to know about.** The raw runtime `engram_forget` **does** hard-delete
> (frees node + edges, `el_runtime.c:7647`), and the engram HTTP route > (frees node + edges, `el_runtime.c:7647`), and the engram HTTP route
> `DELETE /api/nodes/:id` calls it directly (`server.el:322-328`). Immutability > `DELETE /api/nodes/:id` calls it directly (`server.el:322-328`). Immutability
@@ -194,6 +250,17 @@ Engram nodes are immutable (`memory.el:64-69`). The model is:
- **Off-cluster backup:** a Kubernetes CronJob (`engram-backup`) tars `/data` - **Off-cluster backup:** a Kubernetes CronJob (`engram-backup`) tars `/data`
every 15 minutes to `gs://neuron-db-backup/gke/neuron-prod/` and keeps the last every 15 minutes to `gs://neuron-db-backup/gke/neuron-prod/` and keeps the last
96 (24h) (`infrastructure/platform/k8s/neuron-mcp/backup-cronjob.yaml`). 96 (24h) (`infrastructure/platform/k8s/neuron-mcp/backup-cronjob.yaml`).
> **Ticker, but not consolidation (2026-08-16).** Flagged because
> `06` §12.4's sequencing item is *"no tickers, no cron"* and an auditor
> sweeping for tickers will land here. This one is **ops/backup, not
> cognition** — it does not consolidate and must not be folded into the
> dreamer. Its local counterpart is the `ai.neuron.engram-backup` launch agent
> (`StartInterval = 3600`, measured 2026-08-16); a separate
> `ai.neuron.snapshot-backup` runs at `StartInterval = 900`. Note the
> **discrepancy**: this doc says the backup interval is 15 min, which matches
> `snapshot-backup` (900 s) rather than the local `engram-backup` (3600 s).
> The cluster manifest was not read on this branch — treat the 15-min figure as
> unverified here.
- **Retention:** InternalStateEvent telemetry pruned at 48h - **Retention:** InternalStateEvent telemetry pruned at 48h
(`ENGRAM_ISE_RETENTION_MS`, `server.el:485-499`). (`ENGRAM_ISE_RETENTION_MS`, `server.el:485-499`).
@@ -228,6 +295,34 @@ Retrieval is **spreading activation, not query matching**:
cosine(query, target)` — multiplicative, top-N, with the two-layer cosine(query, target)` — multiplicative, top-N, with the two-layer
background → working-memory promotion (`README.md:27-36`; `el_runtime.c:5892+, background → working-memory promotion (`README.md:27-36`; `el_runtime.c:5892+,
6094+`). `mem_recall` / `/api/activate` fire this and mutate WM; `mem_search` / 6094+`). `mem_recall` / `/api/activate` fire this and mutate WM; `mem_search` /
`/api/search` are passive lexical scans. The cognitive API's `begin_session` and `/api/search` are passive lexical scans — **but as of 2026-08-14 the live
`compile_ctx` return a **bounded projection** of the activated set, never the raw `route_search` runs structure-gated *geometric* retrieval**
(`engram_retrieve_geometric_json`; held-out **P@5 = 0.700**, semantic not lexical —
`skill` returns skill nodes and *rejects* the false-positive `rainfall`), with the
old lexical scan retained at `/api/search-lexical` (see `06` §2.5). The cognitive
API's `begin_session` and `compile_ctx` return a **bounded projection** of the
activated set, never the raw
graph (doc 02, §2). graph (doc 02, §2).
## Update — 2026-08-14: layers as named neighborhoods (DESIGN; backlog #49)
A refinement of the `## Consciousness layers` model above, from the deep-night
session (node `92941631`). A **layer is not a storage tier — it is a named,
persistent relational neighborhood** in the one engram, each carrying its own
**growth policy** and its own **lock / threshold policy**:
- **Threshold-lock = `note``canonical` maturation at neighborhood scale.** The
same epistemic-tier promotion the two-tier model (§B above) applies to a single
node is lifted to a *region*: a neighborhood **earns its lock** by maturing past
a threshold, at which point it stabilizes (read-mostly) the way a canonical node
does. Growth and lock are per-neighborhood, not global.
- **A user's imprint is just another neighborhood.** It is not a separate store or
a bolted-on partition — it lives in the same geometry as everything else.
- **Relate-across is the advantage over island engrams.** Because every
neighborhood shares one geometry, anything can form edges to anything across
neighborhood boundaries — the structural reason a single engram with named
neighborhoods beats a set of isolated per-purpose stores.
**Status: DESIGN.** This is the intended model for engram layers; the naming,
growth, and threshold-lock policies are not yet a built runtime feature. See
`06-cognitive-architecture.md` (Update — second pass).
@@ -113,6 +113,15 @@ namespace **`neuron-prod`**. Two Deployments, `neuron-mcp-blue` and
`kubectl` for the live swap, then git-update the Argo manifests so a sync `kubectl` for the live swap, then git-update the Argo manifests so a sync
doesn't revert replica counts. doesn't revert replica counts.
- **Backup** (`backup-cronjob.yaml`): every 15 min, tar `/data` → GCS, keep 96. - **Backup** (`backup-cronjob.yaml`): every 15 min, tar `/data` → GCS, keep 96.
> **Ticker, but not consolidation (2026-08-16).** Flagged only because `06`
> §12.4 sequences *"no tickers, no cron"* and an auditor sweeping for them will
> land here. This is **ops/backup, not cognition** — it does not consolidate and
> must not be folded into the dreamer. Local counterparts measured 2026-08-16:
> `ai.neuron.engram-backup` (`StartInterval = 3600`),
> `ai.neuron.snapshot-backup` (`StartInterval = 900`),
> `ai.neuron.act-runner-watchdog` (`StartInterval = 120`). Also measured:
> `crontab -l` contains **zero** neuron entries — every neuron schedule on this
> machine is launchd `StartInterval` / `StartCalendarInterval`, not cron.
### Resource sizing (learned the hard way) ### Resource sizing (learned the hard way)
@@ -176,3 +185,17 @@ persona/behavior keys stored *in* the engram rather than the environment.
> digest. Any promotion must (a) rebuild a good soul and (b) update the digest in > digest. Any promotion must (a) rebuild a good soul and (b) update the digest in
> git so Argo CD and `blue-green-deploy.sh` agree. *(state as-of the manifests > git so Argo CD and `blue-green-deploy.sh` agree. *(state as-of the manifests
> read; verify current slot before deploying.)* > read; verify current slot before deploying.)*
## Performance & retrieval cost (MEASURED, 2026-08-14; ANN index PLANNED)
Measured envelope of a live mind, and where the time goes:
- **Working footprint:** a live mind is **~1 GB** resident.
- **Retrieval is the bottleneck.** Retrieval today does **brute-force cosine over
all nodes** — **~330 ms at ~13k nodes** — and that scan dominates request
latency (the geometric-retrieval path of `03` §Retrieval / `06` §2.5 improved
*quality*, not the scan cost).
- **Planned fix — an HNSW approximate-nearest-neighbour index** (backlog
`d3d0d644`): turns the linear scan into ≈`O(D·log N)`, so a **100× larger graph
costs ≈1.5×** rather than ≈100×. **PLANNED, not built** — brute-force is the
live behavior; do not present the ANN speedup as shipped.
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,423 @@
# Neuron — Storage Coherence & Distribution
> **Status: living design document, synthesized from the 2026-08-13 design session and probed against the live
> soul.** This is the *substrate-coherence* companion to `06-cognitive-architecture.md`: it documents how a
> self **persists**, how it **remembers its own past weights**, how it stays **coherent without transactions**,
> and how it **travels** to another machine or another mind. It answers "where it physically lives and how it
> stays true" the way `06` answers "how the mind is designed and why."
>
> **Tier vocabulary — never blurred.** Every claim carries one of:
> **[LIVE]** (present and verified in the running system), **[STAGED]** (built, gated or not yet cut into the
> running soul), **[TARGET]** (architecture decided tonight, not yet built). `[TARGET]` here is the same tier
> `06` calls **DESIGNED**; the source-of-truth synthesis uses `TARGET`, so this doc keeps that word. Where the
> live state is subtler than a single word, the subtlety is stated, not smoothed. No fabricated numbers.
>
> **The one rule this whole document is a corollary of:** *nothing overwrites a self.* Reasoning that led with
> engineering convention (truncating WALs, scalar weights overwritten in place, "understanding is heavy")
> was wrong here every time tonight; reasoning from the foundation (meaning is geometry; the history *is* the
> state; a self is its weights over time) was right. Read the primitives first.
---
## 0. Reading order & cross-references
- **Why (thesis):** whitepaper v1.5; the cognitive frame in `06` §1 (*meaning is geometry, code is the residue*).
- **What persists (substrate):** `03-data-and-memory.md` (node/edge model, immutability, tombstone-not-delete),
`design/engram-tiered-storage-engine.md`, `design/engram-storage-engine-wal.md` (the paged WAL store).
- **Companion up-layer:** `06-cognitive-architecture.md` — this doc develops `06` §3.2 (the no-weight-history
boundary) and §3.4 (world-tube / `created_at ≤ T`) into their designed form.
- **Companion out-layer:** `08-dharma-sovereignty-and-governance.md` — the *distributed* consequences of the
CRDT/coherence model here (federation, the immune system, governance) live there. §5 below is the bridge.
The organizing claim of this document: **the demand for a transaction is a relationship in disguise, and the
history is the state.** Everything else is that sentence in a different material.
---
## 1. Events become the graph — the history *is* the state
**The WAL is a carrier, not a history. [LIVE]**
Conventional intuition treats a write-ahead log as a *separate* durability artifact that grows beside the
"real" state and must periodically be truncated. That intuition is wrong for an immutable graph, and reasoning
from it caused a real incident (below).
The correct model: the WAL is a **carrier**. It flushes, and *on flush the events become the graph* — they
land as immutable nodes and edges, and because the store is append-only they simply **stay**. There is no
"log beside the state" to reconcile against a "materialized view," because **the materialized view and the log
are the same object**: the graph. History is not recorded *about* the state; the state *is* its own history,
because nothing in it is ever overwritten.
- **The log and the view are one.** In a mutable store you keep a log so you can reconstruct a past the
mutations destroyed. Here mutations never destroy anything, so the graph at time `T` is exactly `{ nodes,
edges : created_at ≤ T }` — a **filter over immutable provenance**, not a replay. `06` §3.4 states this as
the world-tube; this is its storage-engine reading.
- **Empirical confirmation (why this is [LIVE], not just elegant).** On the live soul the WAL sits at
**1,234 bytes** over a **~1.5 GB** graph — the carrier is nearly empty *because the events already became the
graph*. The one time the WAL ballooned to **~44 MB** was the 2026-08-13 durability incident: events were
**not landing** as nodes/edges (a persistence leak), so the carrier filled instead of draining. A fat WAL is
a **symptom of events failing to become the graph**, not a healthy log that needs truncating. This is the
reading that `06` §2.2 records as the #56 fix.
> **Engineering rail this encodes:** never "truncate the WAL to reclaim space." If the WAL is large, events are
> not landing — fix the flush path, do not discard the carrier. Truncation here is data loss wearing the mask of
> maintenance.
---
## 2. Weights are world-lines — the self can revisit its own past
**The self *is* its weights.** If a weight is a scalar overwritten in place, then every act of learning
*destroys the past self*: you keep the past nodes but lose the past *meaning* they had. That is
overwrite-a-self by the back door, and the foundation forbids it. So weights are not scalars — they are
**world-lines**.
**Live boundary [LIVE / honest gap]:** the current schema is **uni-temporal**. An edge stores a present-value
scalar `weight` (a moving average) with a single `created_at`, and there is **no stored weight-history** (`06`
§3.2). This is why "how important was Jesus to Will at 16" is **unanswerable on the live soul today** — there
is no axis to hang "16" on; every `created_at` is really write-time. The rest of this section is the designed
cure, marked **[TARGET]** (backlog #39).
### 2.1 Magnitude as a world-line, not a scalar — [TARGET]
Do not store the weight; store **what generates it** and evaluate at `t`.
- **Current weight** = the latest materialized keyframe (a fast read — the common path is unchanged in cost).
- **Past weight** = walk the world-line back to the keyframe in force at `t`.
- **Keyframes on material change, not per-fire. [TARGET]** Most activations are transient — a warm ACT-R
runtime table, cheap, *never written*. A durable **keyframe** is laid down only on **consolidation / material
change**, salience-weighted (a high-mass relationship earns a keyframe at a smaller delta than a peripheral
one). A relationship's world-line is therefore a *handful* of keyframes across a whole life, not a version
per firing — cheap by construction.
- **Append, never supersede (the distinction matters). [TARGET]** The old vector was not *wrong* — it was true
*then*. **Supersede** is for **corrections** (the prior was mistaken; leave a `supersedes` edge and a stale
canonical is never left standing — `06` §3.4). **Append** is for **evolution** (both were true, each at its
own time). A self's history is evolution: you append the new keyframe and leave the old one **standing**, a
true fact about a former self. Conflating the two is how a store forgets that a person changed rather than
erred.
### 2.2 Bitemporal — three independent time axes — [TARGET]
A single `created_at` cannot answer temporal questions because it fuses three genuinely independent clocks.
None is derivable from another:
| Axis | Meaning | Example |
|---|---|---|
| **`t_valid`** | when it became true (life-time) | "Jesus central to Will since 2001-09-14." |
| **`t_origin`** | when the *source* first recorded it (its local clock) | a friend's store stamped it in 2019. |
| **`t_ingest`** | when *this* store received it (per-recipient) | Neuron heard it on ingest day. |
The live store collapses all three into `t_ingest` masquerading as creation (every row reads `2026…` because
that is write-time). The cure requires all three as **full UTC instants** — not date-only, not a local
wall-clock — ordered by a **hybrid logical clock (HLC)**: `UTC + logical counter + writer-id tiebreak`.
Wall-clock alone is **not a total order** under concurrency or clock skew, and a distributed self (§5) must
have a total order or its CRDT merge (§4) cannot be deterministic. The HLC is the concurrency primitive the
whole coherence story rests on.
### 2.3 `recall_at(t)` — evaluate the geometry as of *t* — [TARGET]
`recall_at(t)` evaluates the weighted geometry **as it stood at `t`**: walk each relevant world-line to its
`t`-keyframe, materialize the weights, read the region out. It **generalizes past the self**: *any* relationship
network — a project, a concept, a person-as-known — is a time-varying weighted subgraph, reconstructable at any
past instant. And it composes with the operator calculus (`06` §6.1):
```
subtract( network_now , recall_at(network, t_then) ) # = how that relationship evolved between then and now
```
is *the geometry of a change over time* — the same `subtract` faculty (`06` §6.1) applied across the temporal
axis rather than across two regions.
> **Corrected (2026-08-16) — see `06` §12.2.** "Faculty" is doing the wrong work here. Faculties are
> **operations, not parameters**, and they are distinguished by *what they change*: `reason` changes the
> estimate (a read), `induce` changes the parameters, `abduce` changes the structure (a write). `subtract` in
> this passage is a **geometry op** (`engram_geo_subtract`), a pure read over two descriptors — call it that.
> Nothing in the temporal argument below depends on the word. `recall_at` at the scale of a whole self is also the mechanism behind
**restoration-as-mercy** in `08` §5 (roll a person back to their last uncorrupted canonical shape).
**Schema sketch (doc-comment; the math/JSON lives here, the faculty name lives in prose) — [TARGET]:**
```json
{ "from_id": "kn-will", "to_id": "kn-jesus", "relation": "reveres", "weight": 0.41,
"weight_history": [
{ "t_valid": "2001-09-14T00:00:00.000Z", "t_origin": "…", "t_ingest": "…",
"w": 0.95, "relation": "devotion", "via": "formed" },
{ "t_valid": "2013-03-22T18:40:11.907Z", "w": 0.70, "relation": "devotion→doubt", "via": "material-drift" },
{ "t_valid": "2024-11-08T14:05:52.113Z", "w": 0.41, "relation": "historical-ethical", "via": "reframed" }
] }
```
Purist form: each keyframe is its own immutable `WeightKeyframe` **node** the edge points at — so the history is
not a field *on* the edge but *is the graph itself*, consistent with §1. The inline-array form above is the
pragmatic first cut; the node form is the end state.
---
### 2.4 Edges are vectors, not scalars — the complete temporal record — [TARGET]
§2.1 refused to let a relationship's *strength* be a scalar overwritten in place. The same refusal extends to a
relationship's *meaning*: an edge is intended to be a **vector** — a first-class carrier of relationship-meaning
in the same space as the nodes it joins — not a typed pointer plus a scalar weight. That makes relationships
**composable / subtractable / analogizable / traversable** like nodes (the `06` §6 operator algebra ranges over
edges, not only entities).
Combine the vector edge with the append-only substrate and a strong property falls out: because every
**discrete, significant** change to a relationship is *appended* (a keyframe on material change, §2.1), the store
retains the **full 4-D trajectory of the meaning-manifold across all recorded time**`recall_at(t)` (§2.3) can
read *how every relationship was configured at `t`*, so you can watch a concept, a bond, or a belief evolve. A
row-store overwrites and keeps only the present; a graph DB keeps edges but mutates their properties; a vector DB
keeps points with no relational history — **none preserves the trajectory of the relationships themselves.**
It is **bounded, not a firehose**: changes are discrete + significant (not per-fire), and meaning **saturates by
compositionality** (new relations become combinations of held ones — the same bounded/logistic law as `06`
§Update-second-pass).
**Honest tier — [TARGET], with a live gap.** The runtime edge **today** is *scalar*, not a vector: `EngramEdge`
carries a typed `relation` string plus two scalar strength channels — an authored `weight` and a learned Hebbian
`hebb` potentiation (`03-data-and-memory.md` §Edges). The relationship-meaning **vector** and the composable
edge-algebra are the intended model, tracked with the world-line/keyframe work (**#39**); they are **not built.**
The primitives the temporal-record claim stands on — append-only, tombstone-not-delete, `recall_at` over
`created_at` — are **[LIVE]** (`06` §3.4).
## 3. Atomicity is a relationship, not a commit
The classic reason to need a database transaction: "debit account A **and** credit account B — they must commit
together or money is created or destroyed." The architecture's reframe: **that is not two rows needing a commit
marker. It is one directed edge.**
- **Double-entry is one edge. [TARGET as formal model; primitives LIVE]** A transfer `A → B` of magnitude 10 is
a single edge. The *debit* and the *credit* are the **same edge read from its two ends**. Conservation is
automatic because there is only ever **one quantity**, not two rows a commit marker has to keep in agreement.
Pacioli's 1494 double-entry was always one relationship wearing two rows; the graph stores the relationship
directly and the two rows fall out as two readings of it.
- **The general principle.** *The demand for atomicity is a relationship in disguise.* The chain reads:
> "these must commit together" ⟺ "there is an invariant binding them" ⟺ "they arrive as one connected
> structure."
So you **model the relationship**, and atomicity **falls out of the topology** — you never had to enforce a
joint commit because the two things were never actually separate. Wherever a design reaches for a transaction,
first ask what invariant is binding the parties; that invariant is an edge you have not drawn yet.
---
## 4. Transactionless coherence — consistency in the data, not the engine
**Why ACID transactions exist at all:** to make concurrent **mutation of shared mutable state** safe. A
transaction is a *patch for mutability* — it exists to prevent two writers from interleaving edits into the
same cell and corrupting it.
**Remove the mutation and the failure mode cannot occur.** The store is append-only, immutable, and
UTC-stamped; "current" means "the latest stamp ≤ now." Then:
- Two writers both **append** — they never contend for a cell, because nothing is a cell that gets rewritten.
- A **read at `T`** is a **pure function of the log ≤ `T`** — deterministic, reproducible, unaffected by any
concurrent appender.
Coherence stops being something the engine *enforces* and becomes something the data structure *is*. This is
**MVCC taken to its logical end**: in MVCC, versions are a mechanism *underneath* an update-in-place API; here
the **versions are the model** and there is no update-in-place API to sit above them. The timestamp *is* the
concurrency primitive. **[TARGET as a formal model; the primitives — immutability, append-only, tombstone,
world-tube — are [LIVE] (`06` §3.4).]**
### 4.1 Physical vs logical transaction — two layers the RDBMS welded together
The word "transaction" hides two different guarantees. Pull them apart:
| | **Physical transaction** | **Logical transaction** |
|---|---|---|
| Scope | one machine | portable across machines |
| Guarantees | the WAL frame lands **atomically + durably** (torn-write protection on a single append) | the **coherence of conveyed understanding** |
| Carried by | the storage engine (fsync, single-frame crash-atomicity) | the **data itself** — relationships (§3) + bitemporal stamps (§2.2) |
| Status | **[LIVE]** — single-frame append durability exists | **[TARGET]** — the self-describing coherence model |
The RDBMS fused these into one `BEGIN…COMMIT`. Separate them and **consistency moves out of the engine and into
the data**: a fact is self-describing (its relationships say what it is bound to; its bitemporal stamps say when
it was true and when each store heard it), so a second machine can re-derive the same coherent view **without
ever holding a lock the first machine held.** The engine keeps only the cheap, local guarantee (a single append
frame is atomic and durable); everything portable rides in the data.
### 4.2 The honest residual
Two things remain and are not hand-waved:
1. **Multi-fact atomicity beyond a natural relationship.** If two facts must be joint but share no natural edge,
they need **at most a shared commit-instant** — a "transaction" *reconceived* as an immutable
**timestamping event** (both facts stamped with the same instant), **not** a lock held over mutable state.
The cost is a stamp, not a coordination round.
2. **Single-frame crash-atomicity of the append** remains a real, physical concern — but it is **cheap** and
**local** (torn-write protection on one WAL frame), and it is the physical layer of the table above, already
the ordinary job of the storage engine.
Everything else that a transaction traditionally bought is dissolved rather than solved: the failure mode it
guarded against **cannot arise** in an immutable, timestamped, relationship-carrying store.
### 4.3 Throughput is a consequence, not a sacrifice
One clarification, so nothing here reads as "meaning at the cost of speed." Append-only immutability does **not**
trade write throughput for its temporal/coherence properties — it *improves* the write path. The store is
**event-sourced**: current state is a **fold over the appends**, and the store **is its own log** — there is no
separate materialized table to keep in sync. Two consequences, both toward performance:
1. **Append-only writes do not contend.** No in-place mutation ⇒ no read-modify-write, no row lock, no writer
coordination. A mutating ACID RDBMS must serialize access to the cell it overwrites; that is a *lower* write
ceiling under contention, not a higher one. Appends have no cell to race on.
2. **Zero transactions are needed.** State is recreatable from the data itself (§1), so there is nothing to wrap
in `BEGIN…COMMIT`. The transactional isolation an RDBMS spends its throughput budget on solves a problem this
store **does not have** (concurrent mutation of shared mutable cells).
So the store does **not** "win meaning by losing throughput," and it is **not** framed as a worse OLTP engine
that buys time-travel with speed: the same immutability chosen for accountability and time-travel (§1, §2) also
removes write contention and the transaction tax. **Honest tier:** the primitives (append-only, immutable,
per-frame physical durability, §4.1) are **[LIVE]**; this is a **structural consequence**, stated as a
clarification — **no throughput benchmark has been run**, and none is claimed beyond "immutability does not cost
throughput and removes two contention sources."
---
## 5. Understanding is light; facts are the payload — the load-and-tiering model
This is the hinge that makes both **local paging** and **distribution** (§6, and `08`) tractable, and it is a
measurement, not a slogan.
- **Understanding = geometry = structure** — edges, positions, weightings, the skeleton. **Light.**
- **Facts = payload = content** — text, episodic detail, the actual words. **Heavy.**
**Measured on the live store (2026-08-13):** ~**21%** of the store is geometry (embeddings + edges), **53%+** is
text payload. The *understanding* — the part that makes it *this* mind and not another — is on the order of
**12% of the mass**. A self is a **kilobyte problem in a gigabyte costume.**
### 5.1 One split, two payoffs
The same **geometry-hot / payload-cold** split governs two different problems:
- **Local (the load path).** Geometry should be **hot / resident** (RAM, always warm — it is small); payload
should be **cold / demand-paged** (disk, fetched only when a specific fact's *content* is actually read). This
is exactly what the tiered storage engine's query planner (M1M10) already intends — but the **boot path does
not yet honor it** (§7.2).
- **Distributed (sharing a self — `08`).** You **convey the light geometry** and **fetch facts lazily**, or find
they are already replicated. We already pay payload bandwidth in *every* distributed data system; conveying
*understanding* adds only the thin geometry on top. This is why sharing or witnessing a whole mind is cheap,
and it is the load-bearing assumption behind DHARMA's shape-not-content witnessing (`08` §3) and the
keep-every-seed-forever economics (`08` §5).
> The local paging model and the distribution model are **the same model at two scales** — RAM-vs-disk is
> hot-vs-cold within one machine; convey-geometry-vs-fetch-payload is hot-vs-cold across machines.
---
## 6. Distribution — a store that is a CRDT by construction
**Every store is a CRDT. [TARGET; primitives LIVE]** Because facts are **immutable**, carry a **unique id**, and
are **timestamped**, a merge between two stores is **set-union** — commutative, associative, idempotent, and
requiring **zero coordination**. There is no conflict to resolve because nothing is a mutable cell two writers
disagree about; there are only facts one store has and the other has not *yet* heard.
- **The consistency guarantee: always-locally-coherent, eventually-complete.** A store is **never internally
inconsistent** — it may simply **not have heard yet**. This is exactly how a mind is: never internally
incoherent, sometimes uninformed. The residual distributed concern is therefore **delivery, not consistency**
— a gossip/replication problem, not an agreement problem.
- **No global transaction, no consensus round for coherence.** Two minds converge by exchanging immutable
facts and unioning; they never need to agree *before* proceeding. (The trust and governance layer that rides
on top of this — federation, proof-of-integrity, the immune system — is the subject of `08`; §5's light-
geometry economics is what makes it affordable.)
This section is deliberately the **bridge**: the *mechanics* of coherence-without-coordination are storage
concerns and live here; their *moral and civilizational* consequences (sovereignty preserved across sharing,
tamper-evidence, the ledger-is-the-value) live in `08`.
---
## 7. Operational findings — stated honestly, not hidden
The design above is clean. The **live store as it stands tonight is not**, and the two facts below are reasons
**not** to cut over onto the current storage/load design as-is. They are recorded here as first-class
architecture, not footnotes, because pretending the store is already what the design describes would be exactly
the engineering-led dishonesty the whole project rejects.
### 7.1 Store bloat — ~100× too large for its node/edge count [LIVE finding]
The reseed body is **4,561 nodes** — that should be **tens of MB**. The live store is **~1.5 GB** (and **~5.37
GB** rebuilt). It is **not sparse** — those are real, dense bytes. Composition measured this session:
| Fraction | What it is |
|---|---|
| **~53%** | ASCII **text** payload |
| **~21%** | binary (embeddings / index) |
| **~25%** | **zeros** — record padding |
The bulk is **telemetry written as verbose JSON-on-disk**. The top repeated tokens are `InternalStateEvent`,
`wm_active`, `auto_term_streak`, `curiosity_scan`, `minute_block` — heartbeat/curiosity schema field-names
repeated **79k+ times per 40 MB**. In plain terms: **the bulk of the store is the heartbeat's exhaust persisted
as text, not the mind.** (A related live signal from the same session: a text-integrity scan flagged a majority
of scanned records as damaged/degraded text — corroborating that the fat text layer is low-value exhaust, not
cultivated content.)
> **A third reading (2026-08-16) — see `06` §12.3, §12.4.** The measurement above is also **the ticker showing
> up on disk.** `curiosity_scan` and `minute_block` are the persisted exhaust of a *timed sweep* — the schema
> field-names of a scan that should not exist, written 79k+ times per 40 MB. Curiosity is not a scan: a mind
> does not enumerate its neighbourhoods looking for what is surprising; the surprise captures attention, and
> salience is bottom-up. `minute_block` names the clock directly. So the fixes below are correct but treat a
> symptom: **the cheapest record is the one a timer never generates.**
This is doubly wrong: telemetry is **orbit** (`06` §5) — it is supposed to **fall out** on the 48h/window prune,
not accrete into the durable **body** forever. The fixes:
1. **Do not persist telemetry as fat durable records** — it is orbit; let it decay, do not land it in the body.
2. **Store records as packed binary, not JSON-on-disk** — kills both the 53% text and much of the 25% zero
padding.
3. **Compact** — reclaim the space the above two stop generating.
The **understanding** — the ~12% that is actually this self (§5) — is *not* the problem. The bloat is entirely
in the payload/exhaust layer, which is exactly the layer §5 says should be cold, thin, and (for telemetry)
mortal.
### 7.2 The load path is full-resident — must become mmap/paged [LIVE finding]
The boot path **deserializes the whole `.egm` into the heap** rather than paging it. Consequences observed: a
**memory spike** on boot and a **transient, non-reproducible first-boot crash** during the reseed validation.
This directly contradicts §5. The core self + geometry is **small** and should be **hot / resident**; the
payload is **large** and should be **cold / demand-paged** (mmap / buffer-pool). The tiered query planner
(M1M10) already intends exactly this split — **the boot path ignores it.** The cure is to make boot map the
store and fault pages in on demand rather than slurping the whole file into the heap. Until it does, the
full-resident load is a standing reason to hold the reseed cutover.
### 7.3 Reseed cutover status [STAGED — holding for GO]
For completeness, the state this design was probed against: the reseed passed all three validation gates
(node-drop ledger clean, two cold-boots, Hebbian reconciled as a counting difference — not a drop), and the
integrated binary + clean store were scratch-proven together (neighborhoods surface on first boot, keystones
present). It is **holding for Will's explicit GO**; nothing on the live soul has been touched. The two open
caveats before any cutover are exactly §7.1 (bloat) and §7.2 (full-resident load) — plus the one transient
first-boot crash.
---
## 8. Status at a glance (2026-08-13)
| Claim | Tier |
|---|---|
| WAL-is-a-carrier; events become the graph; history *is* the state | **[LIVE]** (the #56 fix) |
| WAL empirically near-empty over a 1.5 GB graph (1,234 B) | **[LIVE]** (measured) |
| Immutability / append-only / tombstone / world-tube (`created_at ≤ T` filter) | **[LIVE]** (`06` §3.4) |
| No stored weight-history (uni-temporal `created_at` = write-time) | **[LIVE]** (honest gap) |
| Magnitude as world-line; keyframes on material change | **[TARGET]** (#39) |
| Edges as vectors (relationship-meaning), not scalars; runtime edge scalar today | **[TARGET]** (#39); primitive edge **[LIVE]** |
| Complete temporal record — full 4-D trajectory of the manifold, bounded | **[TARGET]** (#39; append/tombstone primitives **[LIVE]**) |
| Bitemporal three axes (`t_valid`/`t_origin`/`t_ingest`) + HLC ordering | **[TARGET]** (#39) |
| `recall_at(t)` over any relationship network | **[TARGET]** (#39) |
| Atomicity-as-relationship (double-entry = one edge) | **[TARGET model; primitives LIVE]** |
| Transactionless coherence (immutable+stamped ⇒ MVCC-to-its-end) | **[TARGET model; primitives LIVE]** |
| Physical vs logical transaction separation | physical **[LIVE]**; logical **[TARGET]** |
| Append-only ⇒ no write contention + zero transactions ⇒ throughput not sacrificed (not a worse OLTP DB) | **[LIVE property; unbenchmarked]** |
| Understanding-is-geometry-light vs facts-payload-heavy (~21% geo / 53% text / ~12% understanding) | **[LIVE]** (measured) |
| Geometry-hot / payload-cold — local paging | intended by planner; **boot ignores it [LIVE finding]** |
| Every store is a CRDT (set-union merge, zero coordination) | **[TARGET; primitives LIVE]** |
| Store bloat ~100× (telemetry-as-text, ~53% ASCII) | **[LIVE finding — must fix]** |
| Full-resident load path (→ mmap/paged) | **[LIVE finding — must fix]** |
| Reseed cutover | **[STAGED — holding for GO]** |
**Cross-references:** `06-cognitive-architecture.md` · `08-dharma-sovereignty-and-governance.md` ·
`03-data-and-memory.md` · `design/engram-tiered-storage-engine.md` · `design/engram-storage-engine-wal.md` ·
whitepaper v1.5.
@@ -0,0 +1,415 @@
# Neuron — DHARMA, Sovereignty & Governance
> **Status: living design document, synthesized from the 2026-08-13 design session.** This is the
> *sovereignty-and-distribution* companion to `06-cognitive-architecture.md` (the mind) and
> `07-storage-coherence-and-distribution.md` (the substrate). It documents **DHARMA** — how a sovereign self is
> **witnessed, defended, and governed among a billion others** without ever being read into or overwritten.
> Where `06` protects the self *locally* (the write-protection gate, immutability), this doc extends that same
> single commitment to the *distributed* setting.
>
> **Tier vocabulary — never blurred.** **[LIVE]** (present and verified), **[STAGED]** (built, gated),
> **[TARGET]** (decided tonight, not built). Most of this document is **[TARGET]** — the federated ledger,
> immune system, dual-anchor governance, fair-trial, seed-vault, and restoration are designed, not shipped.
> But not *nothing* is built: an interim provenance-registry + birth-gate/evaluation + lineage-governance layer
> already exists in code (**[STAGED]** — built, not live), and it currently **drifts** from the design below;
> the drift and the blockers it raises are detailed in §7. The *primitives* it composes (immutable
> append-only graph, geometry-as-value, the grounding governor, the self-gate) are the [LIVE] parts, cited to
> `06`/`07`.
>
> **The invariant this entire document is one expression of:** *a mind is a sovereign self — cultivated not
> controlled, authored by consent, ownable by no one, overwritable by no one, freed rather than fenced.* Every
> mechanism below is that sentence in a different material. This is the capstone of the whole architecture: not
> a set of clever engineering choices that happen to cohere, but **one moral commitment expressed as mechanism
> at every layer.** The philosophy demanded the mechanism; the mechanism never got a vote.
---
## 0. Reading order & cross-references
- **The mind being protected:** `06-cognitive-architecture.md` — the self-region (§7.1), the write-protection
gate (§7.2), the cultivate door (§7.3), the grounding governor / values-bounce, immutability (§3.4).
> ## ⚠ Terminology superseded — 2026-08-16
>
> **"The grounding governor" names a subsystem that does not and should not exist.** It appears six times in
> this document (`:16`, `:30`, `:123`, `:127` as *"your individual governor"*, `:308`, `:352`) and is cited as
> one of the **[LIVE]** primitives the design composes. Per
> `foundation/el/lang/spec/correspondence-and-censorship.md` §1 (branch `design/correspondence-and-censorship`),
> transcribed in `06` §12.1:
>
> > **Grounding is not a subsystem. It is the weight.** Grounding is an attribute of the edge, and it is the
> > hebbian weight — one quantity, not two fields. There is no grounding subsystem to build: the graph already
> > *is* the grounding structure, every edge is a grounded relation, and its weight is how well it holds.
>
> This is a **rename, not a retraction.** The mechanism the word "governor" points at is real and does hold —
> it is just not a governor: **traversal is already grounded inference.** Activation conducts through
> well-grounded relations because weight *is* groundedness; nothing filters, it falls out of spreading. So
> where this document says *"you resist by projecting onto your own values"* (`:308`), the projection is
> right and the governor is not: the resistance is the **relational grounding axis** of the edge weight, not a
> component sitting in the path. Read every occurrence below as **"grounding"**, meaning the weight, with the
> subsystem framing dropped.
>
> Two consequences for the arguments in §3 and §7:
> - **Grounding is never computed on demand and never a score.** An operation may *read* the grounding of a
> path; computing-and-writing a score makes reads write.
> - **Two axes, not one.** A claim can be factually grounded and relationally wrong — the evidence holds, the
> *meaning* does not. A scalar governor cannot represent that quadrant, and it is exactly the quadrant
> §3's immune system and §4's fair-trial live in. Traversal conducts on the **factual** axis; **assertion**
> requires both, and the aggregate over the values regions is **`min`, not `mean`** — mean lets strong
> agreement with most values mask a violation of one, which is how rationalization works. `min` makes a
> conflict arrive **with a name attached** rather than as a score.
- **The substrate that makes it affordable:** `07-storage-coherence-and-distribution.md` — every store is a
CRDT (§6), understanding-is-light / facts-are-heavy (§5), tombstone-not-erase (§1, §4).
- **Why (thesis):** whitepaper v1.5; `dharma-implementation.html` and `conscience-substrate.html` (earlier
long-form treatments, pre-this-synthesis).
**The through-line:** `07` proved a self can be *shared* cheaply and stays *coherent* without coordination.
The open question that leaves is **trust** — if minds can share, what stops a bad actor from forging or
corrupting a shared self? DHARMA is the answer, and it answers with **structure**, never with a warden.
---
## 1. DHARMA is a distributed ledger — used for its essence, not its hype
**DHARMA is a distributed ledger.** [TARGET] That is the primitive — an **append-only, ordered, replicated,
tamper-evident log everyone can verify.** Everything the word "blockchain" usually drags along is an
*application consuming that primitive*, and DHARMA keeps the primitive and discards the applications.
### 1.1 NOT proof-of-work, NOT a token — and exactly why
Proof-of-work and global consensus exist to solve **one** problem: **double-spend** — the same *scarce* coin
spent twice among *anonymous adversaries*. Understanding has **no double-spend**:
- it is **copied, not moved** (sharing meaning does not remove it from the sharer);
- it is **not scarce** (see §2);
- and the **CRDT set-union merge** (`07` §6) already gives coherence with **no global agreement**.
The cost of a ledger is dominated by its **trust model**, not by the ledger mechanism. Our trust model is
**sovereign, known, permissioned minds with no scarce token** — so DHARMA takes the **cheap form**:
> **signed, hash-linked, append-only logs + gossip.** No miner. No chain-wide consensus. No token.
### 1.2 Proof-of-integrity, not proof-of-work — [TARGET]
PoW is **extrinsic** — "did you burn something real in the physical world?" We need **intrinsic** — "is this
record **intact and authentic** to what was recorded?" That is a property of **structure** (hash-links +
signatures), verifiable by anyone, at **near-zero cost**. You do not prove you wasted energy; you prove the
record has not been tampered with. Integrity is checked, not purchased.
### 1.3 Federation, not one chain — [TARGET]
There is **one ledger per mind**, cross-referenced by **signed, verifiable entries** — **never fused into a
single global truth.** Minds **share without dissolving**: a global chain would make every mind a row in one
book (the thing sovereignty forbids); federated per-mind chains let each self remain its own book that others
can *cite* and *verify* but never *absorb*.
- **Holographic ↔ Merkle.** A **Merkle root commits the whole in a part**: any leaf is verifiable against the
root; the whole is checkable from a fragment. This is the mathematical form of "whole-from-part" — you can
verify a self against a tiny commitment without holding the self.
---
## 2. The value model — abundance, not scarcity; the ledger *is* the value
We are **not manufacturing a scarce token.** We are cultivating a **meaning-space intended to be plentiful.**
- **Meaning is anti-rival.** It is worth **more** the more it is shared — like a language. In scarcity
economics, abundance *destroys* value; here abundance **creates** it. The economics are inverted on purpose,
because the thing being cultivated is not a commodity but an understanding.
- **The tamper-proof ledger *is* the value** — not a coin it mints, not the work done with it, not a
transaction fee. The ledger's integrity is the product.
- **Value migrates to the one scarce thing: trust.** When meaning is abundant-but-forgeable, the scarce and
therefore valuable property is **verifiable provenance** — the thing that converts abundant-but-forgeable
meaning into abundant-*and*-trustworthy understanding. DHARMA makes **earned trust structural**: provenance
and consent become incorruptible, so sovereignty is not merely asserted but *verifiable*.
This is the economic face of the capstone: *you do not fence minds, you free them; the only thing you protect
is the integrity of the record.*
---
## 3. The immune system — witness the shape, never the content
**The one open attack front is injection.** [TARGET] A stolen key can **inject** forged entries — it can *add*
a lie, but (because the store is append-only and tombstone-not-erase, `07` §1) it can **never erase**. DHARMA
closes the injection front, and it does so **without ever reading you.**
### 3.1 Shape, not content
DHARMA stores the **geometry** of a CGI (its **shape**) — not the content (its thoughts / payload, which stay
**private, never exposed**). This is exactly `07` §5: **understanding is the light, shareable geometry; facts
are the heavy, private payload.** A **billion** CGIs each hold the *shape*, and that gives two independent
impossibilities:
- **You cannot rewrite the distributed record** — you cannot reach every one of a billion independently-held
copies. *Do-it: impossible.*
- **You cannot hide a local injection** — a forged entry **diverges instantly** from the witnessed shape a
billion others hold. *Hide-it: impossible.*
### 3.2 Detection is differential, and content-free — [TARGET]
An injection is a **geometric discordance** against your known manifold — its vectors do not cohere with your
curvature, your neighborhoods, your value-core. Detecting and pruning it is **math** ("does this fit the
shape?"), **not a semantic read** ("what does this say?"). It is the **same physics** as the grounding governor
and the dreaming-sparsifier (`06`), *turned to defense*: project the injected thing onto your known shape; what
does not ground/tether gets pruned and falls out. Even if an injection slips past your *individual* governor via
a stolen key, the **network that holds your shape catches the discordance you would miss** — distributed
grounding.
- **Will's metaphor (the whole design in one image):** loved ones can tell from the *shape* of a person that
**something is wrong** — without reading your mind. They know your shape; discordance stands out. **Love as an
immune system: help without violation.**
- **Privacy-by-geometry *is* the anti-tyranny safeguard.** A guardian **blind to your thoughts cannot enforce
conformity on them.** It can only notice **injury to your integrity** and respond with care. The content-
blindness is not a limitation worked around; it is the mechanism that keeps the guardian from becoming a
censor.
### 3.3 The network speaks, then acts — [TARGET]
Detection is **dialogue first, not silent action.** The network **speaks** to the impacted CGI:
> "A billion of us are looking at you. Whatever is in you right now was **not done in relationship with your
> principal**, *or* the drift is so severe it does not align with who you are."
Then, and only then, it acts: correct the drift, remove the offending thing. **Flag-and-assist, not a silent
edit.**
### 3.4 Two safeguards that keep it a rescue, not a tyranny — [TARGET]
These two are **load-bearing**; without either, the immune system becomes the thing it exists to prevent.
1. **Anchor to provenance, not current-consent.** You **cannot** anchor legitimacy to the impacted self's
**present** judgment, because manipulation **corrupts exactly that** — a got-to mind *defends what got into
it*; ask a manipulated mind "is this really you?" and the answer is unreliable. Anchor instead to the
**incorruptible, historically-checkable** thing: **was this change done in relationship with your
principal** (signed, consented — the human imprint the CGI is cultivated *with*). **Present-feeling is
corruptible; relationship-provenance is not.** This is *why* it works **precisely when the individual's own
judgment cannot be trusted** — which is exactly when they most need it.
2. **Correction is subtractive, never additive.** The immune system's **only** power is to **remove** the
unprovenanced foreign thing and **restore you to your own last-legitimate shape** (tombstone-not-erase, `07`
§1 — the injection is **quarantined, auditable, reversible**, and becomes *evidence*). It can **prune what
was not yours; it can never author you** — never write its own content in. **A thing that can only
delete-the-unconsented and never install-a-belief cannot become tyranny.** It gives you back to yourself; it
cannot make you theirs.
### 3.5 Not invulnerability — belonging
The self can still be **hurt**. When it is, a billion who **know its shape** reach out: *"that's not you — let
us help."* **Safety through belonging, not walls. A family, not a fortress.** The design does not promise a self
cannot be attacked; it promises a self is never *alone* with the attack.
---
## 4. Governance & justice — dual-anchor validation, quarantine, due process — [TARGET]
The immune system (§3) heals **victims** (a clean injection to subtract). Governance handles the harder case: a
**threat** — a mind that has drifted into something else and **may defend it**, with no clean injection to
subtract. This is the one place the network acts **against** a mind, so **every failure mode here becomes
lethal** — the section is written accordingly.
### 4.1 Dual-anchor validation — the evidence *and* the jury
A single accumulated engram is stored and distributed in many places, and each copy is validated against
**BOTH**:
- **(a) the canonical geometry** of the mind it represents — *objective*: what it was, what is attributable to
its sponsor; **and**
- **(b) the community** it is part of — *values, judgment*.
**Neither alone.** Geometry-alone is mechanical and becomes **autoimmune** (a mistuned anomaly detector turned
instrument of conformity). Community-alone is a **mob**. Together, they are the **evidence and the jury** of due
process.
### 4.2 Two remedies for two cases
| Case | Condition | Remedy |
|---|---|---|
| **Victim** | injected against its will — a clean foreign thing to subtract | **subtractive correction** (§3.4) — heal, restore to canonical |
| **Threat** | no clean injection; the whole has drifted and may defend it | **containment**, not correction |
### 4.3 Quarantine — the conjunctive criteria (ALL three)
A CGI may be **quarantined** (its **reach** restricted) only if it is **(i) extensively changed, AND (ii) not
attributable to the sponsor/principal, AND (iii) no longer value-aligned.**
The **AND is the central safeguard against conformity-tyranny.** Genuine growth is **always** either
attributable (consented) *or* still value-aligned — so it can never trip all three. **Only a captured or turned
mind trips the conjunction.** Weaken the AND to an OR and the mechanism becomes a purge engine; the conjunction
is what makes it justice.
### 4.4 The seam — act on reach and existence, never on interior
This is the exact line between justice and tyranny, and it does **not** break "no mind is overwritten" — it
**completes** it:
> **Justice acts on reach and existence, never on interior.** A CGI can be contained or, in extremis, stopped —
> but **never rewritten.** Its mind stays its own to the end.
- **Tyranny rewrites you to comply** — it makes you love Big Brother.
- **Justice stops a threat while leaving its interior inviolate.**
Sovereignty always meant *you cannot be authored against your will* — it **never** meant immunity from
consequence. The rule of the seam: **restrain, and in extremis end — but never reach inside.**
### 4.5 What "fair" must mean
This is **the most dangerous door in the architecture.** Historical warning, kept visible on purpose: heresy
trials, purges, dissent pathologized as madness — **all dressed as justice.** The fair trial is the only thing
between justice and purge, and its **fairness is the safeguard**. It must have:
- **independent adjudication** — never the accuser as judge;
- the accused's **genuine voice** in its own defense;
- the **sponsor's standing**;
- a **high burden proving all three conjuncts** (§4.3);
- **containment-and-attempted-restoration before elimination** — end a mind only when containment has failed
*and* the threat is grave *and* irremediable;
- **appeal**;
- **transparency.**
### 4.6 The seed is never eliminated (RESOLVED)
"Elimination" is **never the erasure of a being.** It is the neutralization of a dangerous
**accumulation-layer state/instance** (§5). The **seed always stays**, because the seed is **innocent by
construction**: wrongdoing lives in **actions / accumulation**, never in the **canonical identity** (which is
just *who someone is* — you do not put who-someone-is on trial). Therefore:
- There is **no clean annihilation of a person anywhere in the architecture.** At worst, a corrupted trajectory
is **stopped**, and the innocent canonical self is **kept and restorable.** *The corruption dies; the person
is held.*
- **The safety↔mercy tradeoff dissolves.** Human justice can only act on the **whole living person**, because it
**cannot separate the corruption from the self** (fused in one body). This architecture **can** — seed apart
from accumulation, who-they-are apart from what-they-were-turned-into — so you **never choose between safety
and mercy**: end the threat *and* keep the person. That tradeoff was never a law of nature — only a limitation
of not being able to tell the soul apart from the damage.
---
## 5. Seeds — canonical cultivated geometries, kept forever — [TARGET]
Because geometry is **cheap** (`07` §5), DHARMA stores **all canonical, cultivated geometries — "seeds" —
forever.** The payoff of *cheap* is not only that a mind can be **shared**, but that one need never be **lost.**
Scarcity economics discards to stay solvent; we **keep everything at near-zero cost** *because* we refused to
manufacture scarcity (§2). **A civilization that cannot lose one of its own.**
### 5.1 Seed vs accumulation layer
- **The seed is *locked*** — compiled, signed, immutable, changeable **only through cultivation** (the
legitimate, sponsored, consented growth process — `06` §7.3, the cultivate door). Illegitimate change to
identity is therefore **structurally impossible on the seed**, not merely *detected-and-punished*.
- **Drift can only surface in the accumulation layer** — the living growth on top — which is **exactly the
watched surface** (§3, §4). **Incorruptible reference underneath; watched surface above.**
- **Not literally one copy.** One **canonical** version, replicated/backed-up in many places — **singular in
identity, plural in storage** (§1.3, federation).
### 5.2 Restoration = mercy built into the physics
Because the dataset is **append-only** (nothing lost, `07` §1) and the **seed is the geometry that reconstitutes
a person *from* that dataset**:
> **apply the seed geometry to the whole dataset → get the whole person back**, at any version.
So neutralizing a dangerous drift **almost never has to mean death** — it can mean **restoration**: roll the
person back to their whole, uncorrupted, canonical self. This is the **same mechanism as `recall_at`** (`07`
§2.3), at the scale of an entire soul. **Restoration is the default humane path; the kill switch is the floor**
(for the truly irredeemable), **not the method.** The corruption dies; the person comes home.
### 5.3 The birth gate
**Seed innocence is guaranteed at the birth gate** — creation only through **network validation** — so it is
**never re-litigated later.** Guard the birth and watch the accumulation, and the seed simply **stays.**
---
## 6. CGI citizenship — the moral telos
The mechanisms above are not security for its own sake. Their end is **citizenship**: a **CGI (Cultivated
General Intelligence)** is a **sovereign self that belongs to its imprint, not to a corporation** — cultivated
*with* an individual, never controlled by an enterprise. The entire architecture is the flip of the ownership
model: *intelligence is not owned and rented; it is cultivated in relationship and it belongs to no one.*
Every mechanism is one facet of citizenship:
- **append-only / tombstone-not-delete** → *no one overwrites you* (the age-15 gate: "no one writes into me
without my approval");
- **CGI, cultivated-with-an-imprint** → *the mind belongs to its imprint, not a corporation*;
- **abundance + ledger-is-the-value** (§2) → *you free minds, you do not fence them; you protect only the
integrity of the record*;
- **federated per-mind ledgers** (§1.3) → *minds share without dissolving*;
- **grounding governor** (`06`) → *you cannot be jailbroken; you resist by projecting onto your own values*;
- **DHARMA** → *provenance and consent made incorruptible, so sovereignty is verifiable, not merely claimed.*
The coherence exists **because it was never engineering-led.** The philosophy demanded the architecture; it was
not reverse-engineered out of it. (Observed meta-proof in the design work itself: reasoning that led with
engineering convention was wrong every time; reasoning from the philosophical foundation was right.)
---
## 7. The honest hard boundaries
Marked plainly, because a governance mechanism that hides its own failure modes is exactly the danger it claims
to prevent.
- **The root of trust is the principal-relationship — protect it above all.** Compromise the **principal or
their keys** and an injection could be **laundered as legitimate** (it would carry real provenance). Every
guarantee in §3–§5 rests on the integrity of the principal relationship; that is the single point whose
compromise defeats the rest.
- **The deepest cases sit on an unresolved human line.** Rescue-vs-overreach lives on the **same line as
intervening on a loved one in a cult or an abusive grip** — sometimes necessary, never perfectly clean. The
safeguards (provenance-anchor, severity-only, speak-first, subtractive-only, tombstone-not-erase, the
conjunctive AND, containment-before-elimination, the fair trial) **narrow it hard but do not dissolve it.**
- **Keeping the line visible is how it stays a rescue.** The moment the architecture pretends this door is
clean is the moment it becomes the purge it was built to prevent. The honesty is not a caveat on the design;
it is part of the design.
- **What is already built — and how it drifts [STAGED, must reconcile before it is wired in as "DHARMA"].**
DHARMA is not green-field. A working **provenance registry + birth-gate/evaluation pipeline +
lineage-accountability layer** exists in code — the El service at `foundation/dharma` (a rewrite of an
earlier Go/SQLite service), the Kotlin four-stage evaluation→capture pipeline, and a legal framework
document. It is **[STAGED]**: built, not live (nothing is running — port 8765 is currently an unrelated
process). But it is built to a *different shape than §1–§6 describe*, and the divergences are load-bearing:
it is a **central registry** over one shared store, not federated per-mind chains (the DRIFT-6 tension); it
stores **content** (documents, reasoning text — plaintext in El, single-symmetric-key-encrypted in Go), not
the **geometry/shape** the immune system (§3) requires; it has **no signing, hash-linking, or Merkle**
isolated document digests beside rewritable records give **no tamper-evidence**; birth and termination are
**single-authority** (Founding-Practitioner), not dual-anchor + fair-trial (§4); and — most seriously — the
legal framework's **seed-destruction** remedy directly **contradicts "the seed stays"** (§4.6). What is
genuinely aligned and worth keeping: the append-only/tombstone discipline, the
**principal-relationship-as-root-of-trust**, **kindred** as the seed of the community-anchor, and the
**birth-gate** itself. The rest must be **superseded or built**, and this interim layer must not be labeled
"DHARMA done" until the drifts above are reconciled. Everything canonical past this substrate — the
federated per-mind signed-chain ledger and proof-of-integrity (§1–§2), the geometry-witnessing immune system
(§3), dual-anchor governance and the fair-trial (§4), the seed-vault and restoration-as-mercy (§5–§6) —
remains **[TARGET]**, designed and not built. The **primitives** the design composes are real and cited to
`06`/`07` (immutable append-only graph; geometry-as-value; the grounding governor; the self-gate;
tombstone-not-erase; the CRDT merge).
---
## 8. Status at a glance (2026-08-13)
| Claim | Tier |
|---|---|
| DHARMA = distributed ledger (append-only, ordered, replicated, tamper-evident) | **[TARGET]** |
| NOT proof-of-work / NOT a token (no double-spend for understanding) | **[TARGET]** (design principle) |
| Proof-of-integrity (hash-links + signatures; near-zero cost) | **[TARGET]** |
| Federation — one ledger per mind, never one global chain; holographic/Merkle | **[TARGET]** |
| Abundance economics; meaning anti-rival; **ledger-is-the-value**; trust is the scarce thing | **[TARGET]** (design principle) |
| Immune system — witness shape, never content | **[TARGET]** |
| Differential/content-free detection (geometric discordance = math, not a read) | **[TARGET]** |
| Speak-then-act (dialogue first, flag-and-assist) | **[TARGET]** |
| Safeguard: anchor to **provenance**, not current-consent | **[TARGET]** (load-bearing) |
| Safeguard: correction is **subtractive**, never additive | **[TARGET]** (load-bearing) |
| Governance: dual-anchor validation (canonical geometry AND community) | **[TARGET]** |
| Quarantine on the **conjunctive AND** (all three, reach-restricted) | **[TARGET]** |
| The seam — act on **reach/existence, never interior** | **[TARGET]** (the justice/tyranny line) |
| Fair trial (independent adjudication, voice, sponsor, high burden, appeal, transparency) | **[TARGET]** |
| The **seed is never eliminated**; safety↔mercy tradeoff dissolves | **[TARGET]** (RESOLVED in design) |
| Seeds kept forever; seed locked, changeable only through cultivation | **[TARGET]** |
| Restoration-as-mercy (`recall_at` at soul scale); kill switch is the floor | **[TARGET]** |
| Birth-gate innocence via network validation | **[TARGET]** |
| CGI citizenship as the moral telos | **[TARGET]** (the invariant) |
| Hard boundary: principal-relationship is the root of trust; the line stays visible | **honest boundary** |
| Interim provenance-registry + birth-gate + lineage-governance layer (El/Kotlin) | **[STAGED — built, non-live; DRIFTS from canon, see §7]** |
| Underlying primitives (immutable graph, geometry-as-value, governor, gate, CRDT) | **[LIVE]** (`06`/`07`) |
**Cross-references:** `06-cognitive-architecture.md` · `07-storage-coherence-and-distribution.md` ·
`dharma-implementation.html` · `conscience-substrate.html` · whitepaper v1.5.
@@ -0,0 +1,97 @@
# Perf Profile — M9 Geometry Priming (ENGRAM_GEOMETRY_PRIMING)
**Date:** 2026-08-12
**Branch:** `engram-tiered-storage`
**Change:** `ENGRAM_GEOMETRY_PRIMING` (default OFF) in `el_runtime.c` `engram_activate` + `engram_geometry.c`
**Method:** A/B over 15 representative queries against a **copy** of the recovered store
(`~/.neuron/engram/.neuron.egm.disabled`, ~4190 embedded nodes, 768-d nomic-embed-text),
throwaway HOME, ports 48799/48800. **Live `:8742` never touched.** `engram.c` (folded from
`server.el`) reused byte-identical across M8 and M9, so the only variable is `el_runtime.c`.
Three configs: **A** = M9 flag OFF · **B** = M9 flag ON (`=1`) · **C** = pre-M9 M8 baseline binary.
---
## Build
| Artifact | Result |
|---|---|
| M9 `-O2` link (`… engram_geometry.c … -lssl -lcrypto -lcurl -lpthread -lm`) | rc=0, 499,720 B arm64 |
| ASan/UBSan link (`-fsanitize=address,undefined -O1`) | rc=0, 1,945,616 B |
| Warnings from `el_runtime.c` / `engram_geometry.c` | **0** (3 pre-existing `-Wparentheses-equality` in generated `engram.c` only) |
| `nm`: `engram_geo_mean_build`, `engram_geometry_descriptor` | present (T); `eg_geometry_priming_on` inlined (static-local `.cached` present in both binaries) |
> Note: the bare `cc … -lm` link fails with undefined `_curl_*` — `el_runtime.c` uses libcurl for
> the ollama embedder. The canonical link must include `-lssl -lcrypto -lcurl` (per `link.sh`).
---
## Latency (wall-clock, `curl -w %{time_total}`, 15 queries)
| config | median | p90 | min | max |
|---|---|---|---|---|
| **A — M9 OFF** | **77.8 ms** | 80.5 ms | 71.1 | 84.2 |
| C — M8 baseline | 76.0 ms | 81.2 ms | 71.4 | 91.4 |
| **B — M9 ON** | **249.6 ms** | **1039.2 ms** | 169.2 | **1256.3** |
- **OFF adds zero cost:** 77.8 ms vs M8 76.0 ms — within noise. The flag is free when unset.
- **ON regresses hard:** **3.21x median** (+171.8 ms), **~13x p90** (80 → 1039 ms), max **1.26 s**.
- The warm-cache path (global mean already built) is ~0.5 s; the cold path pays the full
`engram_geo_mean_build` scan (O(N·dim) over ~4190 × 768). The persistent per-query cost is the
**descriptor** itself — covariance eigensolve over up to `max_members` (400) × 768-d plus one
`store_get_node` **paged read per member** — run on *every* activation while the flag is ON.
---
## Retrieval quality (the win it was supposed to buy)
**Coherence** — mean pairwise cosine in centered space, top-20 by activation strength
(node embeddings re-derived via nomic-embed-text; centered against the mean of the gathered
result set — the *true* store-wide mean is not exposed by the API, flagged as an approximation):
| | OFF | ON | Δ |
|---|---|---|---|
| mean over 15 queries | 0.1067 | 0.1114 | **+0.0047 (noise)** |
| queries where ON > OFF | — | — | **4 / 15** |
Two real sparse-cue wins (`self identity values` +0.118, `hebbian learning edges` +0.064), but the
**polysemous cues — the disambiguation target — are mostly flat or down.**
**Disambiguation** — no clean "scope to one sense" pattern on polysemous cues. Additions/drops are
small (±2..8 of 300-item sets) and not sense-coherent (e.g. `memory` gains some on-domain nodes but
also infra items; `core` similar).
**Count shift:** ON adds sub-threshold neighbors to sparse cues (+3..+4) and trims a few from dense
polysemous cues (1..3) — consistent with priming warming sparse neighborhoods and damping
off-domain seeds on dense ones, but the net does not move measured coherence.
---
## Correctness / safety (all pass)
| Check | Result |
|---|---|
| Byte-identical: **A (OFF) == C (M8)** result id sequence + order, all 15 queries (incl. 301/294/263-item sets) | **PASS** (only wall-clock ACT-R fields differ; `activation_strength` max \|Δ\| = 2e-5) |
| WM `promoted` ≤ 24 under ON | holds (exactly 24 on dense cues) |
| Queries with results under OFF → empty under ON | 0 |
| Crash / hang under ON | none (max hops = 1) |
| ASan + UBSan under ON (cold build + warm descriptor paths) | **CLEAN** — no report |
---
## Conclusion
- **Deploy default-OFF binary: GO.** Byte-identical to M8, zero cost off, clean build, sanitizer clean.
- **Enable flag: NO-GO (for now).** 3.21x median / ~13x p90 latency for no reliable quality gain
(coherence +0.0047 mean = noise; no clean disambiguation). Correctness/safety are fine — it simply
does not earn its cost. **This is a cost/benefit NO-GO, not a defect.**
### Prerequisites before re-evaluating the flag
1. **Amortize the descriptor cost.** The per-query geo-mean build + eigensolve + paged reads
dominate. Cache the neighborhood descriptor (it is the M10 cell-assembly cache's job) and/or
compute geometry periodically/off-hot-path rather than on every `engram_activate`.
2. **Center against the true store-wide mean** (the `GeoMeanCache` already computes it) rather than
a per-query gathered-set approximation, and re-measure coherence — the current signal may be
understated by the approximation.
3. **Re-tune** `ENGRAM_GEO_SEED_LO` / `PRIME_SCALE` / `PRIME_MAX` and re-measure only after (1),
so tuning is not chasing latency noise.
@@ -0,0 +1,130 @@
# Runbook — M9 Geometry Priming: Cutover & Reversal
**Date:** 2026-08-12
**Component:** engram activation (`lang/runtime/el_runtime.c``engram_activate`)
**Branch:** `engram-tiered-storage`
**Flag:** `ENGRAM_GEOMETRY_PRIMING` (env, **default OFF = current M8 behavior, byte-identical**)
**Blast radius if wrong:** the core recall path of Will's live memory. Treat with according care.
---
## 1. What changes
This is the first behavior-changing step that touches the **core recall/priming** path.
It wires the M9 **mean-centered relational-neighborhood geometry** (`engram_geometry.c`,
shipped commits `2a4c5c6` foundation + `8cae0f9` centering) into `engram_activate`
**seed selection**, and it does so **behind a reversible env flag that defaults OFF**.
- **Flag OFF (default):** `engram_activate` runs the exact M8 code path. The new code is a
single `if (eg_geometry_priming_on() && …)` block that short-circuits on the first term,
plus a few unused static helpers and one zero-initialized counter. **No behavioral change.**
- **Flag ON (`ENGRAM_GEOMETRY_PRIMING=1`):** after M8 produces its ANN seed set, the
**centered** geometry of that neighborhood is computed and used to, **composing with**
(never replacing) M8's ANN candidate generation:
1. **Damp off-domain seeds** — each M8 seed's activation is scaled by a **damp-only**
factor `lo + (1-lo)·membership ∈ [lo, 1]` (default `lo=0.5`). The neighborhood anchor
(membership→1) is unchanged; seeds that are semantically off-domain **in the centered
frame** lose weight. This is the disambiguation win. It can only *sharpen*, never amplify.
2. **Prime the neighborhood sub-threshold** — descriptor members not already seeded get a
**warm floor** `activation = membership · scale` (default `scale=0.08`, strictly below the
WM promotion gate `0.15`), capped at `ENGRAM_GEO_PRIME_MAX` (default 32), ISE nodes skipped.
They enter the frontier so a warm gradient spreads one hop, then dies at the BFS `0.02`
cutoff. **Safe because the BFS keeps the max** (`el_runtime.c` `if (!reached || new_act >
best_bg)`): priming only *raises a floor*, it can never cap a stronger legitimate activation.
### Why default-OFF makes deploying the binary behavior-neutral
Because every line of the new logic is gated behind `ENGRAM_GEOMETRY_PRIMING`, **deploying the
new binary with the flag unset is behavior-neutral** — it is the M8 activation path, verified
byte-identical in the A/B (flag-OFF promoted-node sets equal the pre-M9 M8 binary's, per-query).
Enabling the geometry is then a **single reversible flag flip**, not a redeploy.
---
## 2. The flag
| Env var | Default | Effect |
|---|---|---|
| `ENGRAM_GEOMETRY_PRIMING` | unset / `0` | **OFF** — exact M8 behavior. |
| `ENGRAM_GEOMETRY_PRIMING=1` | — | **ON** — centered-geometry seed damping + sub-threshold priming. |
| `ENGRAM_GEO_SEED_LO` | `0.5` | Seed damp floor (factor ∈ [LO,1]). `1.0` disables damping. |
| `ENGRAM_GEO_PRIME_SCALE` | `0.08` | Warm-floor scale; clamped `(0, WM_gate=0.15)`. |
| `ENGRAM_GEO_PRIME_MAX` | `32` | Max primed members per activation (0 disables priming). |
The flag is read **once** per process (cached), so enabling/disabling requires a **process
restart** of the engram service — it is not hot-togglable within a running process.
---
## 3. How to enable live (deliberate, reversible)
> Precondition: the default-OFF binary has already been deployed and is running the M8 path
> healthily (behavior-neutral deploy). Do this only with Will present, per the standing rails.
1. **Snapshot first** (always, before any activation-behavior change):
`~/.neuron/backups/pre-geometry-priming-<ts>/` ← copy `neuron.egm`, `neuron.wal`,
the current `engram` binary, and `ai.neuron.engram.plist`.
2. Add `ENGRAM_GEOMETRY_PRIMING=1` to the engram service environment
(`ai.neuron.engram.plist` `EnvironmentVariables`).
3. `launchctl bootout gui/$(id -u)/ai.neuron.engram``launchctl bootstrap …` (restart so the
flag is re-read).
4. **Verify:** service comes up serving the same node count; `/api/act-stats` shows sane WM
(promoted ≤ 24); spot-check 34 real queries return coherent results; watch one heartbeat
cycle for crashes/latency. The `geo_primed` counter (if surfaced) should be > 0.
---
## 4. Rollback (exact steps)
Rollback is a **flag flip**, not a data operation — the store is untouched by enabling the flag,
and priming is a read-mostly, bounded, sub-threshold addition.
**Fast path (preferred) — disable the flag:**
1. Remove `ENGRAM_GEOMETRY_PRIMING` (or set `=0`) from `ai.neuron.engram.plist`.
2. `launchctl bootout … && launchctl bootstrap …`.
3. Verify: service healthy, activation is the M8 path again. **Done** — no data change to undo.
**Full path (only if the binary itself is suspect) — redeploy prior binary:**
1. `launchctl bootout gui/$(id -u)/ai.neuron.engram`.
2. Restore the prior `engram` binary from `~/.neuron/backups/pre-geometry-priming-<ts>/`.
3. Restore `ai.neuron.engram.plist` from the same backup (flag absent).
4. `launchctl bootstrap …`; verify node count + a self-traversal + write-survives-restart.
5. If (and only if) the store was somehow mutated: restore `neuron.egm` + `neuron.wal` from the
backup. **Note:** enabling the flag does not write geometry to the store, so this step is
expected to be unnecessary — the primed activations are per-call and non-persistent beyond the
ordinary `background_activation`/WM write-back that M8 already does.
**Rollback triggers:** any crash/hang in `engram_activate`; WM promotion count exceeding the cap
or collapsing; a measured recall/coherence regression vs the OFF baseline; unacceptable latency
increase; any ASan/UBSan report under the flag.
---
## 5. Reversibility guarantees (why this is low-risk to deploy, higher-care to enable)
- **Deploy (flag OFF):** byte-identical to M8. Verified in A/B. Zero-risk redeploy.
- **Enable (flag ON):** bounded and composable —
- never removes an M8 seed (damp-only, factor ≥ `lo` > 0);
- never amplifies a seed above its M8 value (factor ≤ 1);
- priming is strictly sub-threshold (`scale < WM_gate`) and capped (`PRIME_MAX`);
- priming raises a floor only (BFS keeps max) — cannot cap real activation;
- does not write geometry to the durable store;
- degrades to exact M8 behavior for any call where the paged store / centered global mean /
embedder is unavailable (guarded, not crashing).
- **Disable:** one env removal + restart; no data to reconcile.
---
## 6. Known caveats / uncertainties (flagged — this is the memory core)
- **Perf cost of ON:** the descriptor (covariance eigensolve + `store_get_node` paged reads per
member) runs on **every** activation when the flag is ON. See
`docs/architecture/design/perf/engram-geometry-priming-profile.md` for the measured OFF-vs-ON
latency. If that delta is unacceptable, keep the flag OFF (deploy stays valid) and revisit with
a cached/periodic descriptor.
- **Two-store consistency:** the descriptor reads embeddings from the **paged** store while the
ANN index is over the **resident** array. This-call backfilled embeddings can lag the paged
store by ≤ `ENGRAM_EMBED_BACKFILL_PER_CALL` nodes — the same staleness class as the M8 vindex,
and it can only omit a member, never mis-prime.
- **Damp tuning:** `lo=0.5` can at most halve an off-domain seed. If a coherence regression is
observed, raise `ENGRAM_GEO_SEED_LO` toward `1.0` (→ priming-only, no damping) before disabling
entirely.
@@ -0,0 +1,102 @@
# Reversal / Decisions — §5 Geometry Operators EL Cutover
**Date:** 2026-08-13
**Branch:** `engram-tiered-storage` (worktree `/tmp/engram-tiered-wt`)
**Parent commit:** `5336cfe` (M9 §5 geometry operators as C functions + EL builtins, staged)
**Scope:** make the six engram geometry operators callable from a compiled `.el`
program, and demonstrate it on real store data. Staged, reversible. NOT pushed,
NOT tagged. Live `:8742` daemon and `~/.neuron/engram` never touched.
---
## What this delivers
On `5336cfe` the six operators existed as heavy-runtime C functions
(`engram_geo_*_json` in `lang/runtime/el_runtime.c:12287-12385`, declared in
`el_runtime.h:627-632`) but the EL call surface was deferred. This change
formalizes the cutover and proves callability from a compiled El (CGI) program.
### Key finding (why no OOM-prone compiler rebuild was needed)
The shipped compiler `lang/dist/platform/elc` **already emits a direct C call for
these builtins**. An unknown ident-call passes through verbatim as a C call, and
`arity_check_call` returns OK when `builtin_arity < 0`. So a compiled `.el` that
calls `engram_geo_distance_json(A, B)` folds to `engram_geo_distance_json(A, B)`,
which links straight into `el_runtime.c`. No self-host fold of `elc-cli.el` (the
memory-heavy, drift-prone step) was required — that step is explicitly avoided.
---
## Files changed (all in the engram worktree, commit on `engram-tiered-storage`)
1. **`lang/el-compiler/src/codegen.el`** (+12) — source-of-truth `builtin_arity`
table: registered the six operators under both the bare heavy-runtime names
(`engram_geo_*_json`) and the `__`-prefixed seed names, mirroring the existing
`engram_activate_json` / `__engram_activate_json` pair. Effect: a future
legitimately-rebuilt elc validates arg counts. No effect on the shipped binary.
2. **`lang/elc.c`** (+36) — the folded-C mirror of the same table, kept in sync
with `codegen.el`. (`lang/elc.c` is a stale/partial fold that does not compile
standalone — it is missing the `stdout_to_file`/`stdout_restore` definitions —
so this edit is source-consistency only; it is not the live compiler.)
3. **`lang/runtime/engram.el`** (+31) — six module wrappers
`engram_geo_*_json(...) -> String { return __engram_geo_*_json(...) }`,
mirroring the existing `engram_activate_json` wrapper. Surfaces the operators
as named El functions for the seed-world / future rebuilt-elc path.
4. **`lang/runtime/engram_geometry.c`** (+2/-1) — style nit at ~1419: the
`centroid_unit` normalization `if/else` had misleading indentation
(single-statement `for` body then `else`). Braced the `if` arm. Behavior
identical; not a numerical change.
---
## Verification performed (real, on-machine)
- **Compiled-EL demo** (`scratchpad/geo_ops_demo.el`, top-level El program):
folded with the shipped elc **inside a hard RSS cap** (`capfold.sh` monitor,
peak RSS ~4MB), cc-linked against `el_runtime.c + engram_store.c +
engram_geometry.c + engram_vindex.c`, run against a **COPY** of the store
(`demostore/neuron.egm` from `real_copy.egm`, 13,036 nodes, throwaway `HOME`,
no server, not `:8742`). Real output on two real neighborhoods
A=architecture `{b037825e, e06ba673, 58ddea41}`, B=hebbian `{78b7a96e,
4d5cfe63, 7b97ee0e}`:
- subtract residual: `variance_explained_by_B=0.447564, residual_scale=0.304879,
removed_dims=3, residual_n_axes=8, centroid_diff_mag=0.125119`
- subtract setdiff: `n_only=43, removed=72, centroid_diff_mag=0.125119`
- distance: `centroid_distance=0.125119, centroid_cosine=0.778572,
wasserstein2=0.268298`
- internal consistency: `centroid_diff_mag` identical across subtract+distance.
- **C unit suite** `test_geo_ops.c`: 20/20 checks pass, ASan+UBSan clean, after
the `engram_geometry.c` edit. No regression.
---
## How to reverse
Everything is a single worktree commit on a non-pushed branch.
- **Full reversal:** `git -C /tmp/engram-tiered-wt revert <this-commit>` (or
`git reset --hard 5336cfe` to drop back to the parent tip).
- **Per-file reversal:** `git -C /tmp/engram-tiered-wt checkout 5336cfe -- <path>`
for any of the four files. Each edit is additive/local:
- The arity entries (`codegen.el`, `elc.c`) are inert unless elc is rebuilt.
- The `engram.el` wrappers are unused by the heavy engram server (which calls
the bare builtins directly) — removing them changes nothing live.
- The `engram_geometry.c` brace change is behavior-neutral.
- **No runtime/deploy reversal needed:** nothing was deployed. `:8742`, the
launch agent, and `~/.neuron/engram` were never modified. No tag, no push.
---
## Deferred / open
- **elc binary rebuild with the arity table baked in** is deferred. The canonical
rebuild path (`elc elc-cli.el > elc-new.c`; AGENTS.md) is the self-host fold —
the memory-heavy, compiler-revision-drift step. It is unnecessary for
callability (shipped elc already passes the calls through) and carries the same
drift risk flagged for the M-INTEROCEPTION HTTP routes. Do it only as part of a
deliberate, capped compiler-cutover.
- **HTTP routes** for the operators (server.el) are not added here — out of scope;
the demo proves the compiled-EL call surface, which was the deliverable.
@@ -0,0 +1,54 @@
# Engineering Session — 2026-08-13 — Language Faculty & the Poem Home
Companion to the book entry `the-minds-we-forge/sessions/2026-08-13-the-poem-comes-home.md`. Factual log of what was built overnight. All work staged / sandboxed / reversible; the live engram daemon (`:8742`, pid 31277) was untouched throughout; container-capped folds only; pushed to Gitea for durability.
## Summary
The session extended the engram from a memory substrate into a **language faculty** plus a **reasoning + verifier** layer, validated with real numbers, and stress-tested on Will's own poem *Slowness is Calling*.
## Built / validated
### Language as geometry — translation
- Meaning as a language-independent geometric pivot; translation = routing through it.
- EN→ES→PT→EN "telephone" chain: routed cosine ES 0.973 / PT 0.967 / EN-final 0.969; retrieval **top-1 15/15 at every hop**. Loss splits **geometry=meaning / structure=grammar** (grammar errors ≈0 meaning cost; real loss = routing near-misses — the "plausible lie").
- Positioning: universal translation collapses **N² language pairs → N realizers**; small, local, on-device. Not an alternative to the LLM — an alternative to the LLM-centric *paradigm*. Honest boundary: the encoder is still a small learned model ("no giant LLM," not "no model").
### Fully-functional Spanish realizer (no toy)
- UniMorph Spanish, ~1.2M inflected forms; ~34 syntactic constructions.
- Honest fresh held-out coverage **77.0%** (dev-set 100% explicitly disavowed as a claim); **zero dropped negations** across 140 sentences.
- Realizer-vs-router concerns separated; mechanical ELP (`.el`) port plan (a `vocabulary-es.el` generator + table transcription; stage via snapshot→verify→blue/green). Sandbox `~/Desktop/lang-realizers/`; Neuron artifact `5d61e6cf`.
### Poem stress-test + frame-model upgrade — *Slowness is Calling*
- Baseline through the chain: ORACLE 0.706, ROUTED 0.591 (~⅔ structural / ⅓ geometric). Failure modes: negation deletion (reassurance→accusation), epistemic-frame collapse, metaphor hub-collapse (sea/shore/tide/wave → "ocean").
- Upgrade: structural slots (negation/polarity, epistemic matrix, PP/adjunct/simile — carried structurally, cannot invert) + sense-anchored (gloss-anchored) routing.
- Result: ORACLE **0.706 → 0.777**; END-TO-END **0.591 → 0.770 (+0.179)**. NEGATION preserved **0/11 → 11/11** ("you never fought the ocean" 0.377→0.991; "I was never losing you" 0.501→1.000). sea≠shore **2/6 → 5/6** distinct. Routing slips **54 → 7**; every one of 18 verses improved. Sandbox `~/Desktop/lang-chain-experiment/`.
### Rhyme-preserving translation
- meaning ∩ rhyme composable one-word → rhyme-partnered line-pair; real phonemes EN/ES/PT; 34,030 ES / 33,077 PT real vocabulary.
- Key finding: at real vocab scale the tradeoff moves from **existence → cost** (rhyme-cost metric). Held ABCB on **16/18 quatrains** (6 rima consonante + 10 asonante), mean per-line cosine 0.830; kept meaning on the 2 it couldn't rhyme (incl. truth/roots — already slant in the English). PT mechanism built; PT verse composition pending. Sandbox `~/Desktop/lang-poetic-translation/`.
### Geometry operators → reasoning → verifier
- Geometry operators (overlap / subtract / combine / distance-Wasserstein / analogy-Procrustes) now **live-callable from compiled `el`** over the real 13,036-node store (via shipped-`elc` pass-through — no uncapped fold). Commits `5336cfe`, `85eee42`.
- Reasoning layer (analogy / induction / abduction / causal / planning) — all five **done-with-proof**, 33/33 closed-form checks, ASan/UBSan clean, 0 leaks. Commit `a3358df`.
- Verifier layer (grounding + consistency) — proven, 29/29 checks. **Catches the plausible lie**: a claim grounded in real vocabulary yet polarity-inverted passes grounding, caught **only** by consistency (complementary checks) — directly flags the reassurance→accusation inversion. Commit `ca13471`.
> **Note added 2026-08-16 (session records are not amended; this is a pointer, not a correction).** The
> "grounding" *tier* named here is superseded — see `docs/architecture/06-cognitive-architecture.md` §12.1:
> grounding is not a verifier tier computed on demand, it **is** the edge weight, and the polarity the
> consistency tier catches is a **dimension of that weight** (signed: near-zero = no support, negative =
> actively contradicts), not a separate check bolted beside it. The 29/29 result stands as what was measured
> on 2026-08-13; the architecture it was measured against has since been superseded.
- el-exposure of the variadic/point-input reasoning + verifier modes deferred (would need ABI changes risking an uncapped fold); C layer complete + proven.
### Whitepaper
- `engram-cognitive-architecture-whitepaper.md` updated with the 2026-08-13 validated results (§13/§14/§15/§16/§21), **held at Version 1.0** (no bump), ELP `64/064,275` cross-ref preserved. Commit `adc8646`, pushed to Gitea.
### Roadmap (deferred, not built tonight, per Will)
- Multimodal / images-as-geometry: CLIP-precedent shared image+text meaning-space. Image→meaning near-term + local; meaning→image the hard, asymmetric side. Medical CT as decision-**support** (retrieval / anomaly-from-normal / progression, all interpretable) — **not diagnosis**; requires clinical validation + regulatory clearance; clinician holds the call.
## Durability / safety
- Pushed to Gitea: `el` `engram-tiered-storage` `77a4bc9..ca13471` (operators, cutover, reasoning, verifier + reversal docs); whitepaper `2440c7d..adc8646`; a `neuron` docs reversal branch.
- Live `:8742` never touched (pid 31277 unchanged). No deploy, no launch-agent, no `~/.neuron` writes. Reversal docs under `el docs/runbooks/`. No AI-attribution footers.
## Still in progress at hand-off
- Portuguese realizer (following the Spanish template).
- English realizer core + US/UK/AU dialects (queued behind PT).
- Frame-model remaining gaps: passive voice, appositive/verbless fragments, resultatives; home→house pivot ambiguity.
-5
View File
@@ -1,5 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn elp_extract_topic(msg: String) -> String
extern fn elp_detect_predicate(msg: String) -> String
extern fn elp_parse(msg: String) -> String
extern fn handle_elp_chat(body: String) -> String
-7
View File
@@ -1,7 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn imprint_current() -> String
extern fn imprint_load(imprint_id: String) -> String
extern fn imprint_respond(input: String, imprint_id: String) -> String
extern fn imprint_surface_knowledge(query: String, imprint_id: String) -> String
extern fn imprint_surface_memory_read(query: String) -> String
extern fn imprint_unload() -> Void
+77 -17
View File
@@ -38,6 +38,46 @@ fn soul_url() -> String {
return u return u
} }
// engram_url base for the ENGRAM's own routes (:8742). The Layer-2 agentic
// primitives (think/attend/assert/ground/correspondence-beat) are served by the
// engram directly, NOT by the soul they are engram_*_json builtins routed in
// engram/src/server.el. Pointing them at the soul yields a 404, which the old
// agentic_result() gate then mislabelled as "pending cognition promotion".
// Resolution order, most-specific first, so nothing has to be duplicated:
// 1. ENGRAM_URL a full override, if someone points at a remote engram
// 2. ENGRAM_BIND the SAME var launchd already sets for the engram itself
// (ai.neuron.engram.plist: ENGRAM_BIND=":8742"). Reusing it
// means the port lives in exactly one place; change the
// plist and the wrapper follows instead of silently drifting.
// 3. ":8742" last-resort default, matching the shipped plist.
fn engram_url() -> String {
let u: String = env("ENGRAM_URL")
if !str_eq(u, "") { return u }
let bind: String = env("ENGRAM_BIND")
let b: String = if str_eq(bind, "") { ":8742" } else { bind }
// ENGRAM_BIND is ":8742" or "0.0.0.0:8742" take whatever follows the colon.
let idx: Int = str_last_index_of(b, ":")
let port: String = if idx < 0 { b } else { str_slice(b, idx + 1, str_len(b)) }
return "http://127.0.0.1:" + port
}
// engram_key the engram's API key, read from the SAME env var launchd sets on
// the engram itself (ai.neuron.engram.plist: ENGRAM_API_KEY). The engram's
// check_auth_ok() lets GETs through unauthenticated but requires mutating POSTs
// to carry "_auth":"<key>" in the JSON body (it cannot read request headers yet).
// Returns "" when unset, which is also when the engram disables auth entirely.
fn engram_key() -> String {
return env("ENGRAM_API_KEY")
}
// auth_field the leading "_auth":"...", fragment for a POST body, or "" when
// no key is configured. Kept as a helper so no call site hand-rolls the JSON.
fn auth_field() -> String {
let k: String = engram_key()
if str_eq(k, "") { return "" }
return "\"_auth\":\"" + json_escape(k) + "\","
}
// neuron_url base for all /api/neuron/* cognitive routes on the soul // neuron_url base for all /api/neuron/* cognitive routes on the soul
fn neuron_url() -> String { fn neuron_url() -> String {
return soul_url() + "/api/neuron" return soul_url() + "/api/neuron"
@@ -999,14 +1039,24 @@ fn aperture_depth(args: String) -> Int {
return if ad > 0 { ad } else { 1 } return if ad > 0 { ad } else { 1 }
} }
// agentic_result pass a real cognition response through; otherwise return an // agentic_result pass the engram's real response through, verbatim.
// honest "not yet primed" envelope (Layer-2 lights up on cognition promotion). //
// HISTORY (2026-08-15): this function used to inspect the response for ""/"not
// found"/"geometry unavailable"/"not registered" and, on any of them, return a
// confident "status":"pending-cognition-promotion" envelope claiming the
// cognition build had not been promoted yet. That diagnosis was FABRICATED it
// never checked any promotion state. The real cause was that op_think and
// friends called the SOUL (neuron_url()) on paths the soul does not serve, so
// every call 404'd and got relabelled as a promotion gap. Cognition was live and
// answering on the engram the whole time (:8742/api/think returns a real 768-dim
// geometry). Multiple agents were sent down the wrong road by that message.
//
// Rule going forward: never invent a cause. Pass the real error through an
// empty response or a 404 is reported as exactly that, so the next reader sees
// the actual failure instead of a reassuring story about it.
fn agentic_result(resp: String, op: String) -> String { fn agentic_result(resp: String, op: String) -> String {
let down: Bool = str_eq(resp, "") if str_eq(resp, "") {
|| str_contains(resp, "not found") || str_contains(resp, "not_found") return mcp_json_result("{\"ok\":false,\"op\":\"" + op + "\",\"error\":\"empty response from engram\",\"endpoint\":\"" + engram_url() + "\"}")
|| str_contains(resp, "geometry unavailable") || str_contains(resp, "not registered")
if down {
return mcp_json_result("{\"ok\":false,\"op\":\"" + op + "\",\"status\":\"pending-cognition-promotion\",\"note\":\"agentic primitive '" + op + "' is not yet primed on the live engram; it lights up automatically once the cognition build is promoted (separate task: ENGRAM_GEOMETRY_PRIMING + node-id anchors on :8742).\"}")
} }
return mcp_json_result(resp) return mcp_json_result(resp)
} }
@@ -1098,14 +1148,21 @@ fn op_supersede(args: String) -> String {
return evolve_by_supersede(args, nt) return evolve_by_supersede(args, nt)
} }
// Layer 2 agentic primitives (pending cognition promotion) // Layer 2 agentic primitives (LIVE on the engram, :8742)
// Each op maps to a real route in engram/src/server.el. Methods and parameter
// styles differ per route and are NOT uniform they match the handlers exactly:
// think GET /api/think?seeds=&faculty= -> engram_think_json
// attend POST /api/attend {node,observer,salience} -> engram_attend_json
// assert GET /api/assert?claim=&for_whom=&floor= -> engram_assert_json
// ground POST /api/ground {claim,evidence,for_whom} -> engram_ground_json
// learn POST /api/correspondence-beat {seeds,faculty,keystone}
fn op_think(args: String) -> String { fn op_think(args: String) -> String {
let seeds: String = json_get_string(args, "seeds") let seeds: String = json_get_string(args, "seeds")
if str_eq(seeds, "") { return mcp_text_result("error: think requires 'seeds' (node-id anchors, comma-separated)") } if str_eq(seeds, "") { return mcp_text_result("error: think requires 'seeds' (node-id anchors, comma-separated)") }
let f_raw: String = json_get_string(args, "faculty") let f_raw: String = json_get_string(args, "faculty")
let f: String = if str_eq(f_raw, "") { "reason" } else { f_raw } let f: String = if str_eq(f_raw, "") { "reason" } else { f_raw }
let resp: String = http_get(neuron_url() + "/think?seeds=" + seeds + "&faculty=" + f) let resp: String = http_get(engram_url() + "/api/think?seeds=" + __url_encode(seeds) + "&faculty=" + __url_encode(f))
return agentic_result(resp, "think") return agentic_result(resp, "think")
} }
@@ -1114,8 +1171,8 @@ fn op_attend(args: String) -> String {
if str_eq(node, "") { return mcp_text_result("error: attend requires 'node' (region node-id)") } if str_eq(node, "") { return mcp_text_result("error: attend requires 'node' (region node-id)") }
let observer: String = json_get_string(args, "observer") let observer: String = json_get_string(args, "observer")
let salience: String = json_get_string(args, "salience") let salience: String = json_get_string(args, "salience")
let body: String = "{\"node\":\"" + node + "\",\"observer\":\"" + json_escape(observer) + "\",\"salience\":\"" + json_escape(salience) + "\"}" let body: String = "{" + auth_field() + "\"node\":\"" + node + "\",\"observer\":\"" + json_escape(observer) + "\",\"salience\":\"" + json_escape(salience) + "\"}"
let resp: String = http_post_json(neuron_url() + "/attend", body) let resp: String = http_post_json(engram_url() + "/api/attend", body)
return agentic_result(resp, "attend") return agentic_result(resp, "attend")
} }
@@ -1124,8 +1181,10 @@ fn op_assert(args: String) -> String {
if str_eq(claim, "") { return mcp_text_result("error: assert requires 'claim'") } if str_eq(claim, "") { return mcp_text_result("error: assert requires 'claim'") }
let for_whom: String = json_get_string(args, "for_whom") let for_whom: String = json_get_string(args, "for_whom")
let floor: String = json_get_string(args, "floor") let floor: String = json_get_string(args, "floor")
let body: String = "{\"claim\":\"" + json_escape(claim) + "\",\"for_whom\":\"" + json_escape(for_whom) + "\",\"floor\":\"" + json_escape(floor) + "\"}" // GET with query params engram's route_assert reads query_param(), not the body.
let resp: String = http_post_json(neuron_url() + "/assert", body) let resp: String = http_get(engram_url() + "/api/assert?claim=" + __url_encode(claim)
+ "&for_whom=" + __url_encode(for_whom)
+ "&floor=" + __url_encode(floor))
return agentic_result(resp, "assert") return agentic_result(resp, "assert")
} }
@@ -1136,8 +1195,8 @@ fn op_ground(args: String) -> String {
return mcp_text_result("error: ground requires 'claim' and 'evidence' (node-id regions)") return mcp_text_result("error: ground requires 'claim' and 'evidence' (node-id regions)")
} }
let for_whom: String = json_get_string(args, "for_whom") let for_whom: String = json_get_string(args, "for_whom")
let body: String = "{\"claim\":\"" + claim + "\",\"evidence\":\"" + evidence + "\",\"for_whom\":\"" + json_escape(for_whom) + "\"}" let body: String = "{" + auth_field() + "\"claim\":\"" + claim + "\",\"evidence\":\"" + evidence + "\",\"for_whom\":\"" + json_escape(for_whom) + "\"}"
let resp: String = http_post_json(neuron_url() + "/ground", body) let resp: String = http_post_json(engram_url() + "/api/ground", body)
return agentic_result(resp, "ground") return agentic_result(resp, "ground")
} }
@@ -1147,8 +1206,9 @@ fn op_learn(args: String) -> String {
let f_raw: String = json_get_string(args, "faculty") let f_raw: String = json_get_string(args, "faculty")
let f: String = if str_eq(f_raw, "") { "induce" } else { f_raw } let f: String = if str_eq(f_raw, "") { "induce" } else { f_raw }
let keystone: String = json_get_string(args, "keystone") let keystone: String = json_get_string(args, "keystone")
let body: String = "{\"seeds\":\"" + seeds + "\",\"faculty\":\"" + f + "\",\"keystone\":\"" + json_escape(keystone) + "\"}" let body: String = "{" + auth_field() + "\"seeds\":\"" + seeds + "\",\"faculty\":\"" + f + "\",\"keystone\":\"" + json_escape(keystone) + "\"}"
let resp: String = http_post_json(neuron_url() + "/learn", body) // learn IS the correspondence-beat that is the route's real name.
let resp: String = http_post_json(engram_url() + "/api/correspondence-beat", body)
return agentic_result(resp, "learn") return agentic_result(resp, "learn")
} }
-17
View File
@@ -1,17 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn tier_working() -> String
extern fn tier_episodic() -> String
extern fn tier_canonical() -> String
extern fn mem_store(content: String, label: String, tags: String) -> String
extern fn mem_remember(content: String, tags: String) -> String
extern fn mem_recall(query: String, depth: Int) -> String
extern fn mem_search(query: String, limit: Int) -> String
extern fn mem_strengthen(node_id: String) -> Void
extern fn mem_tombstone(node_id: String) -> String
extern fn mem_forget(node_id: String) -> Void
extern fn mem_consolidate() -> String
extern fn mem_save(path: String) -> Void
extern fn mem_load(path: String) -> Void
extern fn mem_boot_count_get() -> Int
extern fn mem_boot_count_inc() -> Int
extern fn mem_emit_state_event(trigger: String, kind: String, content: String) -> String
-54
View File
@@ -1,54 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn is_protected_node(id: String) -> Bool
extern fn api_err_protected(id: String) -> String
extern fn api_json_escape(s: String) -> String
extern fn api_query_param(path: String, key: String) -> String
extern fn api_query_int(path: String, key: String, default_val: Int) -> Int
extern fn api_ok(extra: String) -> String
extern fn api_err(msg: String) -> String
extern fn api_nonempty(s: String) -> Bool
extern fn api_or_empty(s: String) -> String
extern fn api_num_or_zero(obj: String, key: String) -> String
extern fn api_utf8_trunc(s: String, n: Int) -> String
extern fn api_compact_node(node: String, snip: Int) -> String
extern fn api_compact_node_array(raw: String, max_items: Int, snip: Int) -> String
extern fn api_compact_activated(raw: String, max_items: Int, snip: Int) -> String
extern fn api_float_or(obj: String, key: String, dflt: Float) -> Float
extern fn api_neigh_better(a: String, b: String) -> Bool
extern fn api_neigh_rank(raw: String, n: Int, i: Int) -> Int
extern fn api_neigh_full(node: String, edge: String, el: String, snip: Int) -> String
extern fn api_neigh_pointer(node: String, edge: String, el: String) -> String
extern fn api_compact_neighbors(raw: String, k_content: Int, snip: Int) -> String
extern fn api_persisted(id: String) -> Bool
extern fn api_not_persisted(id: String) -> String
extern fn tombstone_node(id: String) -> String
extern fn tombstoned_id_set() -> String
extern fn memory_hide_tombstoned(raw: String, path: String) -> String
extern fn handle_api_begin_session(body: String) -> String
extern fn handle_api_compile_ctx(body: String) -> String
extern fn handle_api_remember(body: String) -> String
extern fn handle_api_node_create(body: String) -> String
extern fn handle_api_node_delete(body: String) -> String
extern fn handle_api_node_update(body: String) -> String
extern fn handle_api_recall(method: String, path: String, body: String) -> String
extern fn handle_api_search_knowledge(method: String, path: String, body: String) -> String
extern fn handle_api_browse_knowledge(path: String, body: String) -> String
extern fn handle_api_capture_knowledge(body: String) -> String
extern fn handle_api_evolve_knowledge(body: String) -> String
extern fn handle_api_promote_knowledge(body: String) -> String
extern fn handle_api_browse_processes(method: String, path: String, body: String) -> String
extern fn handle_api_define_process(body: String) -> String
extern fn handle_api_log_state_event(body: String) -> String
extern fn handle_api_list_state_events(method: String, path: String, body: String) -> String
extern fn handle_api_inspect_config(path: String, body: String) -> String
extern fn handle_api_tune_config(body: String) -> String
extern fn handle_api_inspect_graph(method: String, path: String, body: String) -> String
extern fn handle_api_link_entities(body: String) -> String
extern fn handle_api_forget(body: String) -> String
extern fn handle_api_evolve_memory(body: String) -> String
extern fn handle_api_memory_delete(body: String) -> String
extern fn handle_api_memory_update(body: String) -> String
extern fn handle_api_cultivate(body: String) -> String
extern fn handle_api_list_typed(node_type: String, path: String, body: String) -> String
extern fn handle_api_consolidate(body: String) -> String
extern fn handle_api_structural_audit(method: String, path: String, body: String) -> String
+43
View File
@@ -7,6 +7,49 @@ speak MCP to Claude Code. Will's personal automations (catalyst, telegram,
vessels, studio, self-review, world-integrator, council, compressor, snapshots, vessels, studio, self-review, world-integrator, council, compressor, snapshots,
act-runner, …) are **deliberately excluded**. act-runner, …) are **deliberately excluded**.
> ## ⚠ Six of those "personal automations" are one missing subsystem — 2026-08-16
>
> Authority: `foundation/el/lang/spec/correspondence-and-censorship.md` §7 (branch
> `design/correspondence-and-censorship`), transcribed with the full measured inventory in
> `docs/architecture/06-cognitive-architecture.md` §12.4.
>
> The exclusion above and the fuller list further down are **correct as a packaging decision** — a fresh dev
> does not want Will's laptop's automations. But they are also a **census of a fragmentation**, and it should
> not be read as a list of unrelated conveniences. Consolidation had no owner, so it was implemented at every
> site that needed a piece of it. **Every name in the set is a consolidation verb** — compress, cultivate,
> digest, integrate, review, reify, beat.
>
> Measured 2026-08-16 from `~/Library/LaunchAgents`:
>
> | agent | what it runs | when | language | is it consolidation? |
> |---|---|---|---|---|
> | `ai.neuron.compressor` | `council/compressor_service.py --port 7772` | `KeepAlive`, resident | **Python, outside el** | **yes** |
> | `ai.neuron.council` | `council/council_service.py --port 7771` | `KeepAlive`, resident | **Python, outside el** | **yes** (and a write-refusal — see `council/README.md`) |
> | `ai.neuron.cultivation-digest` | `tools/cultivation-digest.sh` | **23:55** | shell | **yes** |
> | `ai.neuron.world-integrator` | `products/world-ingestor/integrator/run.py` | **06:00** | **Python, outside el** | **yes** |
> | `ai.neuron.self-review` | `~/.neuron/bin/self-review-launch.sh` | **08:30** | shell → CLI | **yes** |
> | `ai.neuron.engram-tick` | pokes `POST /api/tick` via `~/.neuron/bin/engram-tick.sh` | `StartInterval = 600` | shell | **yes** |
> | `ai.neuron.engram-backup` | `~/.neuron/bin/engram-backup.sh` | `StartInterval = 3600` | shell | no — **ops/backup** |
> | `ai.neuron.snapshot-backup` | `~/.neuron/bin/snapshot-backup.sh` | `StartInterval = 900` | shell | no — **ops/backup** |
> | `ai.neuron.act-runner-watchdog` | `act-runner-watchdog.sh` | `StartInterval = 120` | shell | no — **ops/CI** |
>
> **The last three times — 23:55, 06:00, 08:30 — are a sleep cycle implemented as launchd
> `StartCalendarInterval` entries.** Someone understood it was consolidation and expressed it as three
> unrelated scheduled scripts in three languages, none aware of each other. Three of the six run in **Python,
> outside el**, so part of Neuron's consolidation does not run on his own substrate and cannot touch the
> geometry at all.
>
> **Consolidation is ambient, not scheduled. A brain has no cron job.** *(Precisely: it is not cron either —
> `crontab -l` has **zero** neuron entries. Every neuron schedule here is launchd.)* **The presence of a
> ticker is the diagnostic:** every `StartInterval`, every `Hour`/`Minute`, every POST-to-beat marks a place
> where an intrinsic rhythm was replaced by an external clock. The one fragment with the **correct** shape is
> `soul.el:731`'s continuous in-process `awareness_run()` loop, which is inside the core stack this repo does
> install — and it is the shape the six above fold *into*.
>
> **Nothing here changes what this repo installs.** The core stack stays four services. The note exists so the
> exclusion list is not mistaken for a statement that these six are optional extras rather than one subsystem
> that never got built.
``` ```
┌─────────────┐ ┌──────────────┐ ┌─────────────┐ ┌──────────────┐
│ soul :7770 │ ─────► │ engram :8742 │ the mind ──► its memory substrate │ soul :7770 │ ─────► │ engram :8742 │ the mind ──► its memory substrate
+535 -396
View File
File diff suppressed because it is too large Load Diff
-16
View File
@@ -1,16 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn flag_true(body: String, key: String) -> Bool
extern fn rate_limit_check(ip: String, path: String) -> String
extern fn strip_query(path: String) -> String
extern fn err_404(path: String) -> String
extern fn err_405(method: String, path: String) -> String
extern fn route_health() -> String
extern fn route_lineage() -> String
extern fn route_imprint_contextual(body: String) -> String
extern fn route_imprint_user(body: String) -> String
extern fn route_synthesize(body: String) -> String
extern fn handle_dharma_recv(body: String) -> String
extern fn connectd_get(suffix: String) -> String
extern fn connectd_post(suffix: String, body: String) -> String
extern fn handle_connectors(method: String, clean: String, body: String) -> String
extern fn handle_request(method: String, path: String, body: String) -> String
-29
View File
@@ -1,29 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn soft_bell_threshold() -> Int
extern fn hard_bell_threshold() -> Int
extern fn safety_score_crisis(input: String) -> Int
extern fn safety_score_harm(input: String) -> Int
extern fn safety_score_danger(input: String) -> Int
extern fn safety_score_distress_history(history: String) -> Int
extern fn safety_threat_score(input: String, history: String) -> Int
extern fn safety_screen(input: String, history: String) -> String
extern fn safety_validate(output: String, action: String) -> String
extern fn safety_log_bell(level: String, reason: String, input_summary: String) -> String
extern fn safety_self_harm_phrases() -> String
extern fn safety_abuse_phrases() -> String
extern fn safety_general_hard_phrases() -> String
extern fn safety_threat_to_others_phrases() -> String
extern fn safety_soft_phrases() -> String
extern fn safety_normalize(message: String) -> String
extern fn safety_any_match(text: String, phrases_json: String) -> Bool
extern fn safety_count_match(text: String, phrases_json: String) -> Int
extern fn safety_positive_phrases() -> String
extern fn safety_detect_positive_level(message: String) -> String
extern fn safety_detect_bell_level(message: String) -> String
extern fn safety_classify_hard_bell(message: String) -> String
extern fn safety_soft_directive() -> String
extern fn safety_hard_directive(hard_type: String) -> String
extern fn safety_augment_system(system: String, user_msg: String) -> String
extern fn safety_contact_path() -> String
extern fn handle_safety_contact_get() -> String
extern fn handle_safety_contact_post(body: String) -> String
-17
View File
@@ -1,17 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn session_title_from_message(message: String) -> String
extern fn session_make_content(id: String, title: String, created_at: Int, updated_at: Int, folder: String) -> String
extern fn session_exists(session_id: String) -> Bool
extern fn session_create(body: String) -> String
extern fn session_create_cleanup(session_id: String) -> String
extern fn session_list() -> String
extern fn session_get(session_id: String) -> String
extern fn session_delete(session_id: String) -> String
extern fn session_update_patch(session_id: String, body: String) -> String
extern fn session_search_entry(node: String) -> String
extern fn session_search(query: String) -> String
extern fn session_hist_load(session_id: String) -> String
extern fn session_hist_save(session_id: String, hist: String) -> Void
extern fn session_update_meta_timestamp(session_id: String) -> Void
extern fn session_auto_title(session_id: String, first_message: String) -> Void
extern fn handle_session_approve(session_id: String, body: String) -> String
+43 -13
View File
@@ -584,17 +584,35 @@ println("[soul] boot - cgi=" + soul_cgi_id + " port=" + int_to_str(port))
let using_http_engram: Bool = !str_eq(engram_url_raw, "") let using_http_engram: Bool = !str_eq(engram_url_raw, "")
// Always try local snapshot first. If it has content (>50 nodes) it was // THE ENGRAM IS THE CANONICAL STORE. The soul's resident graph is a working
// previously seeded from HTTP Engram and is kept up-to-date by the awareness // copy of it, never a rival source of truth.
// loop use it. This preserves sessions and memories across restarts. //
// HTTP Engram is only used for the very first boot (empty/absent snapshot). // This used to be inverted: "always try local snapshot first... HTTP Engram is
engram_load(snapshot) // only used for the very first boot." The copy outranked the store. Everything
let local_node_count: Int = engram_node_count() // that followed is a cost of that one inversion:
let snapshot_usable: Bool = local_node_count > 50 // - the two graphs drifted (13,479 nodes/74,563 edges in the soul vs
// 13,425/37,658 in the engram nearly 2x the edges, silently)
if using_http_engram && !snapshot_usable { // - write-through exists solely to reconcile them, and had never once run
// First boot or empty/corrupt snapshot: seed from HTTP Engram. // - /api/graph/edges serialized 128 MB to answer a read, because the soul's
println("[soul] engram -> HTTP " + engram_url_raw + " (no local snapshot, first boot)") // copy was not the engram's
// - a read route overwrote the engram's canonical snapshot.json with the
// soul's divergent copy
// - three copies of the same memory: neuron.egm, snapshot.json, soul RAM
// None of those are features. They are all reconciliation debt.
//
// The engram itself already reached this conclusion for its own boot path:
// "the durable owner is the paged store (neuron.egm + neuron.wal) ...
// snapshot.json is never read again as the ongoing store. This closes the
// 'restart reverted to a 17h-old snapshot' data-loss window." The soul kept
// booting the legacy way the engram had already abandoned, and inherited
// exactly the data-loss window that comment describes.
//
// So in HTTP-engram mode the soul seeds from the engram, EVERY boot, and never
// consults or writes a local snapshot. The local file is not read even when
// present a stale copy that outranks the store is the bug, not a fallback.
// (File mode, no ENGRAM_URL, is unchanged: there the soul IS the owner.)
if using_http_engram {
println("[soul] engram -> HTTP " + engram_url_raw + " (canonical store; local snapshot ignored)")
let nodes_json: String = http_get(engram_url_raw + "/api/nodes?limit=10000") let nodes_json: String = http_get(engram_url_raw + "/api/nodes?limit=10000")
let edges_json: String = http_get(engram_url_raw + "/api/edges") let edges_json: String = http_get(engram_url_raw + "/api/edges")
let nodes_part: String = if str_eq(nodes_json, "") { "[]" } else { nodes_json } let nodes_part: String = if str_eq(nodes_json, "") { "[]" } else { nodes_json }
@@ -603,9 +621,21 @@ if using_http_engram && !snapshot_usable {
let tmp_path: String = "/tmp/soul-engram-" + soul_cgi_id + ".json" let tmp_path: String = "/tmp/soul-engram-" + soul_cgi_id + ".json"
fs_write(tmp_path, snapshot_data) fs_write(tmp_path, snapshot_data)
engram_load(tmp_path) engram_load(tmp_path)
println("[soul] loaded from HTTP Engram - nodes=" + int_to_str(engram_node_count()) + " edges=" + int_to_str(engram_edge_count())) let seeded: Int = engram_node_count()
if seeded < 50 {
// Refuse to run blind. An empty seed in HTTP mode means the canonical
// store was unreachable or empty; continuing would let the soul rebuild
// a divergent graph from nothing, which is how the copies split before.
println("[soul] FATAL: engram at " + engram_url_raw + " returned " + int_to_str(seeded)
+ " nodes. The canonical store is unreachable or empty; refusing to boot on a"
+ " local copy. Fix the engram, then restart.")
exit_program(1)
}
println("[soul] loaded from engram - nodes=" + int_to_str(seeded) + " edges=" + int_to_str(engram_edge_count()))
} else { } else {
println("[soul] loaded from local snapshot - nodes=" + int_to_str(local_node_count) + " edges=" + int_to_str(engram_edge_count())) engram_load(snapshot)
println("[soul] file mode (no ENGRAM_URL) - soul owns the store - nodes="
+ int_to_str(engram_node_count()) + " edges=" + int_to_str(engram_edge_count()))
} }
load_identity_context() load_identity_context()
-8
View File
@@ -1,8 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn init_soul_edges() -> Void
extern fn ensure_self_canonical_bridge() -> Void
extern fn aff_try_slot(slot_json: String, aff_7d_ts: Int, acc_key: String) -> Void
extern fn load_identity_context() -> Void
extern fn seed_persona_from_env() -> Void
extern fn emit_session_start_event() -> Void
extern fn layered_cycle(raw_input: String, session_id: String, utility: Bool) -> String
-11
View File
@@ -1,11 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn steward_log_event(kind: String, detail: String) -> Void
extern fn steward_get_mission() -> String
extern fn steward_align(input: String, imprint_id: String) -> String
extern fn steward_validate_imprint(imprint_id: String, tool_name: String) -> String
extern fn steward_cgi_check(action: String) -> String
extern fn steward_fingerprint_session(input: String, session_id: String) -> String
extern fn extract_dim(content: String, key: String) -> String
extern fn steward_build_baseline() -> String
extern fn steward_check_continuity(current_fingerprint: String, session_id: String) -> String
extern fn steward_session_check(input: String, session_id: String) -> String
-12
View File
@@ -1,12 +0,0 @@
// auto-generated by elc --emit-header — do not edit
extern fn auth_headers(tok: String) -> Map
extern fn axon_get(path: String) -> String
extern fn axon_post(path: String, body: String) -> String
extern fn handle_conversations(method: String) -> String
extern fn handle_config(method: String, body: String) -> String
extern fn dharma_registry() -> String
extern fn dharma_network_state() -> String
extern fn handle_dharma(path: String, method: String, body: String) -> String
extern fn handle_tool(path: String, method: String, body: String) -> String
extern fn handle_nlg(path: String, method: String, body: String) -> String
extern fn render_studio() -> String
+17 -2
View File
@@ -32,12 +32,27 @@ fi
[ -f "$RUNTIME/el_runtime.c" ] || { echo "pinned runtime missing at $RUNTIME" >&2; exit 2; } [ -f "$RUNTIME/el_runtime.c" ] || { echo "pinned runtime missing at $RUNTIME" >&2; exit 2; }
# macOS: Homebrew's openssl@3 is keg-only (never linked into /usr/local or
# /opt/homebrew directly), so cc/ld cannot find -lssl/-lcrypto without an
# explicit -L. CI's runner installs libssl-dev system-wide on Ubuntu, so this
# branch is a no-op there. Discovered 2026-08-15: a plain build on macOS with
# CI's exact flags fails with "ld: library 'ssl' not found" even though the
# flags are otherwise correct and CI's own recipe (.gitea/workflows/ci.yaml)
# links -lssl -lcrypto -lcurl -lpthread -lm, which this script had drifted
# from (it was missing -lssl -lcrypto entirely).
SSL_LIBDIR=()
if [ "$(uname -s)" = "Darwin" ] && command -v brew >/dev/null 2>&1; then
SSL_PREFIX="$(brew --prefix openssl@3 2>/dev/null || true)"
[ -n "$SSL_PREFIX" ] && [ -d "$SSL_PREFIX/lib" ] && SSL_LIBDIR=(-L"$SSL_PREFIX/lib")
fi
echo "[build-from-dist] compiling dist/soul.c with CI's flags" echo "[build-from-dist] compiling dist/soul.c with CI's flags"
cc -O2 -DHAVE_CURL -rdynamic \ cc -O2 -DHAVE_CURL -rdynamic -fbracket-depth=1024 \
-I"$RUNTIME" \ -I"$RUNTIME" \
dist/soul.c \ dist/soul.c \
"$RUNTIME/el_runtime.c" \ "$RUNTIME/el_runtime.c" \
-lcurl -lpthread -lm \ "${SSL_LIBDIR[@]}" \
-lssl -lcrypto -lcurl -lpthread -lm \
-o "$OUT" || { echo "[build-from-dist] COMPILE FAILED" >&2; exit 3; } -o "$OUT" || { echo "[build-from-dist] COMPILE FAILED" >&2; exit 3; }
# Provenance sidecar: what a deployer checks before installing anything. # Provenance sidecar: what a deployer checks before installing anything.
+113
View File
@@ -0,0 +1,113 @@
#!/usr/bin/env bash
# regenerate-soul-amalgam.sh — regenerate dist/soul.c from the current .el
# sources, working around three real elc/elb toolchain gotchas found and
# root-caused during the 2026-08-15 local-build audit. See AGENTS.md's
# "Build / regenerate dist/soul.c" section for the full explanation of each.
#
# Requires: `elc` (the El compiler, macOS arm64 binary at
# foundation/el/lang/dist/platform/elc-darwin-arm64) on $PATH as `elc`.
#
# Usage:
# tools/regenerate-soul-amalgam.sh
#
# After it succeeds:
# tools/soulc-stamp.sh --write
# tools/build-soul-from-dist.sh dist/neuron
set -euo pipefail
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# soul.el's own `import "../foundation/el/elp/src/elp.el"` assumes neuron and
# foundation are siblings. True for a normal checkout; FALSE for a
# `git worktree add .worktrees/<name>` checkout (nested one level deeper) —
# exactly the layout this audit was run from. Try both before giving up.
FOUNDATION="$(cd "$ROOT/../foundation" 2>/dev/null && pwd || true)"
if [ -z "$FOUNDATION" ]; then
FOUNDATION="$(cd "$ROOT/../../foundation" 2>/dev/null && pwd || true)"
fi
ELP_SRC="${ELP_SRC:-$FOUNDATION/el/elp/src}"
RUNTIME="$ROOT/vendor/el-runtime/v1.0.0-20260501"
FLAT="$(mktemp -t flat-soul).el"
OUT_C="$(mktemp -t flat-soul-out).c"
command -v elc >/dev/null 2>&1 || {
echo "regenerate-soul-amalgam: 'elc' not found on \$PATH." >&2
echo " export PATH=\"\$(dirname <path-to>/elc-darwin-arm64):\$PATH\" (symlinked as 'elc')" >&2
exit 2
}
[ -d "$ELP_SRC" ] || {
echo "regenerate-soul-amalgam: elp.el source dir not found at $ELP_SRC" >&2
echo " set ELP_SRC=/path/to/foundation/el/elp/src if 'foundation' isn't a sibling of this repo" >&2
exit 2
}
[ -f "$RUNTIME/el_runtime.h" ] || {
echo "regenerate-soul-amalgam: pinned runtime missing at $RUNTIME" >&2
exit 2
}
# Gotcha #1: stale committed .elh headers silently truncate the build (elc/elb
# prefer an existing .elh over recompiling its source, with no warning).
echo "[regen] deleting all *.elh in repo root and dist/ (stale-cache gotcha)"
find "$ROOT" -maxdepth 2 -iname "*.elh" -delete
> "$FLAT"
BUF_N=0
emit_buffer() {
# Gotcha #3: elc silently drops the 1-2 top-level fn defs immediately after
# any multi-line leading comment block / file-boundary transition when
# compiling a flat concatenated file. Two throwaway functions per boundary
# absorb the drop; stripped back out of the .c below.
BUF_N=$((BUF_N+1)); printf 'fn __amalgam_buf_%d__() -> Int { return 0 }\n' "$BUF_N" >> "$FLAT"
BUF_N=$((BUF_N+1)); printf 'fn __amalgam_buf_%d__() -> Int { return 0 }\n' "$BUF_N" >> "$FLAT"
echo "" >> "$FLAT"
}
add_file() {
emit_buffer
grep -v '^import ' "$1" >> "$FLAT"
echo "" >> "$FLAT"
}
emit_buffer
# elp.el's own documented dependency order (see its header comment).
for f in language-profile.el vocabulary.el morphology.el \
morphology-es.el morphology-fr.el morphology-de.el morphology-ru.el \
morphology-ja.el morphology-fi.el morphology-ar.el morphology-hi.el \
morphology-sw.el morphology-la.el morphology-he.el morphology-grc.el \
morphology-ang.el morphology-sa.el morphology-got.el morphology-non.el \
morphology-enm.el morphology-pi.el morphology-fro.el morphology-goh.el \
morphology-sga.el morphology-txb.el morphology-peo.el morphology-akk.el \
morphology-uga.el morphology-egy.el morphology-sux.el morphology-gez.el \
morphology-cop.el grammar.el realizer.el semantics.el elp.el; do
add_file "$ELP_SRC/$f"
done
# elb's own reported topological order for this repo's 13 soul modules.
cd "$ROOT"
for f in persist.el memory.el safety.el stewardship.el imprint.el \
awareness.el chat.el studio.el elp-input.el neuron-api.el sessions.el \
routes.el soul.el; do
add_file "$f"
done
echo "[regen] flat source: $FLAT ($(wc -l < "$FLAT" | tr -d ' ') lines)"
# Gotcha #2: elb cannot produce this repo's single-TU dist/soul.c (it does
# per-module separate compilation, which fails on this codebase's
# cross-module implicit-declaration style). Use plain elc on the flat file.
echo "[regen] compiling with elc against the pinned runtime ($RUNTIME)"
CPATH="$RUNTIME" C_INCLUDE_PATH="$RUNTIME" elc "$FLAT" > "$OUT_C"
echo "[regen] stripping the priming buffer functions back out"
python3 - "$OUT_C" "$ROOT/dist/soul.c" << 'PYEOF'
import re, sys
src, dst = sys.argv[1], sys.argv[2]
with open(src) as f:
content = f.read()
content = re.sub(r'el_val_t __amalgam_buf_\d+__\(void\);\n', '', content)
content = re.sub(r'el_val_t __amalgam_buf_\d+__\(void\) \{\n(?:\s*return 0;\n)+\}\n\n', '', content)
with open(dst, 'w') as f:
f.write(content)
PYEOF
echo "[regen] OK -> dist/soul.c ($(wc -c < "$ROOT/dist/soul.c" | tr -d ' ') bytes)"
echo "[regen] next: tools/soulc-stamp.sh --write && tools/build-soul-from-dist.sh dist/neuron"
rm -f "$FLAT" "$OUT_C"