~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.
High-fanout identity anchors (voice, writing-imprint, self-root) have ~670KB
neighborhoods. inspect_graph returned the full traversal, which overflowed the
MCP client's context and socket-closed the wrapper mid self-load -- the soul
could not traverse its own identity graph.
handle_api_inspect_graph gains an opt-in `compact` projection (compact=1|true):
the neighborhood is relevance-ranked, the top K (default 12) keep a UTF-8-safe
content snippet (default snip=600), and the remainder collapse to lightweight
{id,label,node_type,tier,edge,pointer:true} stubs. This bounds the voice node
from 669,799B -> 25,353B (HTTP 200, valid JSON) and the wrapper's soul-load no
longer socket-closes. New helpers: api_compact_neighbors, api_neigh_full,
api_neigh_pointer, api_neigh_rank, api_neigh_better, api_float_or.
The flag is gated: ABSENT it, the response is byte-identical to the old plain
traversal, so the studio app (which never sends it) is unaffected. The MCP
wrapper (mcp-wrapper/src/main.el) appends &compact=1 on its inspectGraph and
fetch-by-id paths.
dist/soul.c is REGENERATED so CI ships the fix: CI compiles the committed
single-TU dist/soul.c directly (running elb/elc on the Linux runner OOM-kills
it), so an .el-only change would build the OLD behavior. Regenerated and verified
on macOS -- compiles with the CI cc line (0 errors) and, on a throwaway soul over
a copy of the live snapshot, serves compact ~25KB / non-compact ~670KB. The regen
also syncs the amalgamation to this branch's .el sources, which had drifted
several self-review commits ahead of the previously-committed soul.c.
Docs: docs/architecture/00-05 added; 01/02/05 corrected so the relevance-ranked
inspect_graph projection reads as committed source, not an in-flight concern.
will.anderson