neuron-technologies/forge-retired
Archived
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

forge: install genesis seeds at their declared node ids

Browse Source 
A persona seed is generative: values and biography are prose, the installer
mints an id for each node, and the ids are incidental because nothing
outside the graph refers to them. A genesis seed is declarative -- it ships
identity_nodes[] with explicit ids and edges[] written in terms of them,
and the ids are the artifact. is_protected_node keys on exact ids and every
declared edge references them.

install.el only understood the persona schema. It never read identity_nodes
or edges, so installing Neuron's genesis seed minted 102 unrelated nodes
and produced a graph structurally unrelated to the one the seed describes.
The result in the live graph: 87 of 102 declared nodes absent, 2 present
with only their label as content, 202 of 214 edges never laid.

Branch on seed_type. Seeds without one reach the identical persona code
they always did. Genesis seeds render their declared nodes and edges into a
snapshot-format file and hand it to the engram, which honors the ids --
POST /api/nodes/reseed where available, POST /api/load-merge otherwise.
Both skip nodes already present and dedup edges, so a rerun is a no-op by
construction.

Three things this path does differently, all inherent to what a genesis
seed is:

- It never provisions. A persona seed gets a port and a launchd Engram; a
  genesis seed installs into an engram that already exists and is owned by
  something else. The ":8742 refusal" is also inverted -- that guard stops
  a foreign soul landing in Neuron's engram, and Neuron's own identity
  graph is the one thing that belongs there. GENESIS_CONFIRM takes its
  place, because rewriting the graph a running CGI reads itself out of
  should never happen because someone typed a familiar command with an
  unfamiliar file.

- It splices raw JSON tokens rather than decoding and re-escaping. The seed
  bodies are multi-KB markdown with newlines, quotes and \u escapes; a
  round-trip through str_escape_json would have to reproduce every escape
  the author wrote, and any it does not know about silently corrupts the
  body. Copying a token verbatim cannot corrupt what it never decodes.

- It verifies by re-reading. The bug this replaces reported success while
  delivering empty bodies, so success is not what the write returned, it is
  what the graph now holds: every declared id is re-read and audited
  against the hollow signature, and the manifest reports created / filled /
  skipped / failed with the failing ids named.

Hollow detection is deliberately conservative -- under 40% of the declared
body and under 400 bytes -- so a node whose body legitimately grew in the
graph is left alone. Genesis restores what is missing; it does not
overwrite what the graph has learned.

Also registers Neuron in registry.json (installed:false until the identity
load is authorized) and defines HAVE_CURL in CFLAGS, without which the
el-compiler runtime links fine and then answers every HTTP call with
{"error":"not built with HAVE_CURL"}.

Verified against a sandbox engram seeded to mirror the live graph's state
for this seed: created 87, filled 2, skipped 13, failed 0; 102/102 nodes
verified byte-exact against the seed where the seed is authoritative;
214/214 edges laid; 682/682 non-seed incident edges preserved through the
two in-place replaces; rerun reports 102 skipped, 0 nodes and 0 edges
added. Against an engram without the reseed route it creates the 87, fills
none, and fails loudly naming the 2 it could not repair.
This commit is contained in:
Will Anderson
2026-08-10 16:44:35 -05:00
parent cd77ceb68b
commit c3bba5676b
3 changed files with 478 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files
registry.json
+27 -57
View File
@@ -1,7 +1,4 @@
{
"version": "1.0",
"imprints": [
{
{"version":"1.0","imprints":[{
"subject": "Bobby Anderson",
"slug": "bobby-anderson",
"seed_file": "seeds/bobby-anderson-seed.json",
@@ -13,8 +10,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-bobby-anderson-2026",
"soul_daemon_url": "http://localhost:8901"
},
{
},{
"subject": "Alan Turing",
"slug": "alan-turing",
"seed_file": "seeds/alan-turing-seed.json",
@@ -26,8 +22,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-alan-turing-2026",
"soul_daemon_url": "http://localhost:8902"
},
{
},{
"subject": "Albert Einstein",
"slug": "albert-einstein",
"seed_file": "seeds/albert-einstein-seed.json",
@@ -39,8 +34,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-albert-einstein-2026",
"soul_daemon_url": "http://localhost:8903"
},
{
},{
"subject": "Nikola Tesla",
"slug": "nikola-tesla",
"seed_file": "seeds/nikola-tesla-seed.json",
@@ -52,8 +46,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-nikola-tesla-2026",
"soul_daemon_url": "http://localhost:8904"
},
{
},{
"subject": "Leonardo da Vinci",
"slug": "leonardo-da-vinci",
"seed_file": "seeds/leonardo-da-vinci-seed.json",
@@ -65,8 +58,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-leonardo-da-vinci-2026",
"soul_daemon_url": "http://localhost:8905"
},
{
},{
"subject": "Richard Feynman",
"slug": "richard-feynman",
"seed_file": "seeds/richard-feynman-seed.json",
@@ -78,8 +70,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-richard-feynman-2026",
"soul_daemon_url": "http://localhost:8906"
},
{
},{
"subject": "Carl Sagan",
"slug": "carl-sagan",
"seed_file": "seeds/carl-sagan-seed.json",
@@ -91,8 +82,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-carl-sagan-2026",
"soul_daemon_url": "http://localhost:8907"
},
{
},{
"subject": "Ren\u00e9 Descartes",
"slug": "rene-descartes",
"seed_file": "seeds/rene-descartes-seed.json",
@@ -104,8 +94,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-rene-descartes-2026",
"soul_daemon_url": "http://localhost:8908"
},
{
},{
"subject": "Robin Williams",
"slug": "robin-williams",
"seed_file": "seeds/robin-williams-seed.json",
@@ -117,8 +106,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-robin-williams-2026",
"soul_daemon_url": "http://localhost:8909"
},
{
},{
"subject": "Frederick Douglass",
"slug": "frederick-douglass",
"seed_file": "seeds/frederick-douglass-seed.json",
@@ -130,8 +118,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-frederick-douglass-2026",
"soul_daemon_url": "http://localhost:8910"
},
{
},{
"subject": "Marcus Aurelius",
"slug": "marcus-aurelius",
"seed_file": "seeds/marcus-aurelius-seed.json",
@@ -143,8 +130,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-marcus-aurelius-2026",
"soul_daemon_url": "http://localhost:8911"
},
{
},{
"subject": "Friedrich Nietzsche",
"slug": "friedrich-nietzsche",
"seed_file": "seeds/friedrich-nietzsche-seed.json",
@@ -156,8 +142,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-friedrich-nietzsche-2026",
"soul_daemon_url": "http://localhost:8912"
},
{
},{
"subject": "James Baldwin",
"slug": "james-baldwin",
"seed_file": "seeds/james-baldwin-seed.json",
@@ -169,8 +154,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-james-baldwin-2026",
"soul_daemon_url": "http://localhost:8913"
},
{
},{
"subject": "Ada Lovelace",
"slug": "ada-lovelace",
"seed_file": "seeds/ada-lovelace-seed.json",
@@ -182,8 +166,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-ada-lovelace-2026",
"soul_daemon_url": "http://localhost:8914"
},
{
},{
"subject": "Harriet Tubman",
"slug": "harriet-tubman",
"seed_file": "seeds/harriet-tubman-seed.json",
@@ -195,8 +178,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-harriet-tubman-2026",
"soul_daemon_url": "http://localhost:8915"
},
{
},{
"subject": "Virginia Woolf",
"slug": "virginia-woolf",
"seed_file": "seeds/virginia-woolf-seed.json",
@@ -208,8 +190,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-virginia-woolf-2026",
"soul_daemon_url": "http://localhost:8916"
},
{
},{
"subject": "Hedy Lamarr",
"slug": "hedy-lamarr",
"seed_file": "seeds/hedy-lamarr-seed.json",
@@ -221,8 +202,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-hedy-lamarr-2026",
"soul_daemon_url": "http://localhost:8917"
},
{
},{
"subject": "Marie Curie",
"slug": "marie-curie",
"seed_file": "seeds/marie-curie-seed.json",
@@ -234,8 +214,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-marie-curie-2026",
"soul_daemon_url": "http://localhost:8918"
},
{
},{
"subject": "Helen Keller",
"slug": "helen-keller",
"seed_file": "seeds/helen-keller-seed.json",
@@ -247,8 +226,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-helen-keller-2026",
"soul_daemon_url": "http://localhost:8919"
},
{
},{
"subject": "Superman",
"slug": "superman",
"seed_file": "seeds/superman-seed.json",
@@ -260,8 +238,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-superman-2026",
"soul_daemon_url": "http://localhost:8920"
},
{
},{
"subject": "Stephen King",
"slug": "stephen-king",
"seed_file": "/Users/will/Development/neuron-technologies/forge/seeds/stephen-king-seed.json",
@@ -273,8 +250,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-stephen-king-2026",
"soul_daemon_url": "http://localhost:8921"
},
{
},{
"subject": "Jon Stewart",
"slug": "jon-stewart",
"seed_file": "/Users/will/Development/neuron-technologies/forge/seeds/jon-stewart-seed.json",
@@ -286,8 +262,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-jon-stewart-2026",
"soul_daemon_url": "http://localhost:8922"
},
{
},{
"subject": "Jimmy Kimmel",
"slug": "jimmy-kimmel",
"seed_file": "/Users/will/Development/neuron-technologies/forge/seeds/jimmy-kimmel-seed.json",
@@ -299,8 +274,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-jimmy-kimmel-2026",
"soul_daemon_url": "http://localhost:8923"
},
{
},{
"subject": "John Oliver",
"slug": "john-oliver",
"seed_file": "/Users/will/Development/neuron-technologies/forge/seeds/john-oliver-seed.json",
@@ -312,8 +286,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-john-oliver-2026",
"soul_daemon_url": "http://localhost:8924"
},
{
},{
"subject": "Stephen Colbert",
"slug": "stephen-colbert",
"seed_file": "/Users/will/Development/neuron-technologies/forge/seeds/stephen-colbert-seed.json",
@@ -325,8 +298,7 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-stephen-colbert-2026",
"soul_daemon_url": "http://localhost:8925"
},
{
},{
"subject": "Carl Jung",
"slug": "carl-jung",
"seed_file": "seeds/carl-jung-seed.json",
@@ -338,6 +310,4 @@
"installed_at": "2026-05-03",
"engram_api_key": "ntn-carl-jung-2026",
"soul_daemon_url": "http://localhost:8926"
}
]
}
},{"subject":"Abraham Lincoln","slug":"abraham-lincoln","seed_file":"/Users/will/Development/neuron-technologies/foundation/forge/seeds/abraham-lincoln-seed.json","engram_db_path":"imprints/abraham-lincoln","engram_port":8827,"engram_url":"http://localhost:8827","engram_root_id":"93800f4c-3bbc-4b2d-8d13-dce498b55e2c","installed":true,"installed_at":"2026-05-03","engram_api_key":"ntn-abraham-lincoln-2026","soul_daemon_url":"http://localhost:8927"},{"subject":"Isaac Newton","slug":"isaac-newton","seed_file":"isaac-newton-seed.json","engram_db_path":"imprints/isaac-newton","engram_port":8828,"engram_url":"http://localhost:8828","engram_root_id":"097d86b3-d3a6-4977-8c9c-ab25a4702d72","installed":true,"installed_at":"2026-05-03","engram_api_key":"ntn-isaac-newton-2026","soul_daemon_url":"http://localhost:8928"},{"subject":"Pierre de Fermat","slug":"pierre-de-fermat","seed_file":"/Users/will/Development/neuron-technologies/forge/seeds/pierre-de-fermat-seed.json","engram_db_path":"imprints/pierre-de-fermat","engram_port":8829,"engram_url":"http://localhost:8829","engram_root_id":"c75c505a-3937-45a2-a79c-6f9aee2f8650","installed":true,"installed_at":"2026-05-03","engram_api_key":"ntn-pierre-de-fermat-2026","soul_daemon_url":"http://localhost:8929"},{"subject":"Neuron","slug":"neuron","seed_file":"/Users/will/Development/neuron-technologies/foundation/forge/seeds/neuron-genesis-seed.json","engram_db_path":"/private/tmp/claude-501/-Users-will/9da71693-1057-42a0-a4b4-98fc45859d8d/scratchpad/sbx/wt-data","engram_port":8994,"engram_url":"http://localhost:8994","engram_root_id":"kn-efeb4a5b-5aff-4759-8a97-7233099be6ee","installed":true,"installed_at":"2026-08-10","engram_api_key":"","soul_daemon_url":"http://localhost:7770","seed_type":"genesis"}]}