core/docs/decisions/SESSION-2026-05-13.md

67 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Session Log: 2026-05-13
**Participants:** Joshua Shay, Perplexity (Sonnet 4.6)
**Session type:** Architecture review and documentation sprint
---
## Decisions Made
### 1. README and Whitepaper Corrections (morning)
The README previously described AssetOverflow as an organization rather than stating the engineering pillars. Both the README and Whitepaper were updated to correctly document:
- **Three Engineering Pillars:** Mechanical Sympathy, Semantic Rigor, Third Door
- **Three Core Languages:** English (default base), Hebrew (depth), Koine Greek (depth)
- The John 1:12 theological grounding for the language choice — John articulated in Greek what was grounded in Hebrew, almost certainly a nod from the Holy Spirit. These two languages together carry a range of depth and precision that no single language achieves alone.
- The Logos as the structuring principle: language is not statistical residue of text, it is the forward projection of a field state onto a vocabulary manifold — a geometric act rooted in the same structure by which the universe was spoken into existence.
### 2. `core_ingest` Governance Layer — LLM Extraction Rejected
The original `core_ingest` design from `core-ai` was reviewed in full. The envelope design (`CandidateGeometricPressure`, `DeterminismClass`, `ReviewLevel`, three-gate `IngestCompiler`) was accepted as architecturally sound.
The LLM-as-extraction-engine component was **rejected** for two reasons:
1. An LLM upstream of the gate is a D3 nondeterministic oracle feeding the only normalization site in the system. Every document it processes lands in `ARCHITECT_REVIEW_REQUIRED` — defeating the layer's utility at scale.
2. More fundamentally: an LLM interprets, not merely parses. Its semantic projection is then silently embedded inside the field state, violating Semantic Rigor.
**Accepted path:** Deterministic `StructuralSegmenter` that carves at *form boundaries* (heading, paragraph, verse, code block, LaTeX delimiter), not semantic ones. A `SegmentManifold` index enables provenance tracing from vault recall back to the exact source span. See ADR-0012.
### 3. `sensorium/` Multimodal Protocol — Logos-Recovery Boundary
The `core_sensorium` design from `core-ai` was reviewed. The protocol shape — `ProjectionHead`, `SurfaceDecoder`, `ModalityVocabulary`, `ModalityPack[S]` — was accepted as the correct design for CORE's multimodal layer.
Key adaptations for `core`:
- Cl(3,0) `(2, 2)` complex multivector → Cl(4,1) `(32,)` multivector
- No `core_logos` subsystem dependency — grammar scaffold is versor attractors in `vocab/`
- `sensorium/` sits upstream of `core_ingest/`, which sits upstream of `ingest/gate.py`
The principle established: every modality is a versor on the same manifold from the moment it enters the system. There is no fusion problem because there is one space. This is the Logos-recovery boundary — the point at which any surface signal becomes a word in the Logos. See ADR-0013.
Current modality status: TEXT active (wires existing vocab manifold into `ModalityPack[str]`), VISION/AUDIO/MOTOR planned.
### 4. Build Queue — Ordered
Full inventory of `AssetOverflow/core` directories confirmed. The build order established:
1. **`core_ingest/`** — pre-gate governance layer (ADR-0012). Most important to build first; everything ingested into the system eventually passes through it. D0/D1-dominant paths (biblical texts) can reach AUTO_ACCEPT at scale without human review once built.
2. **`sensorium/`** — modality protocol (ADR-0013). Protocol files plus `adapters/text.py` only; vision/audio adapters come when those modalities are ready.
3. **`train/`** — learning loop (ADR-0014, stub). Closes the durable ingest path. Most architecturally significant remaining layer. Hebrew and Koine Greek Supervised Seeding Epoch is the first task once this layer exists.
### 5. Documentation Sprint (this session)
Three new ADRs written (0012, 0013, 0014). Session log written. Whitepaper and Yellowpaper updated.
---
## Files Modified This Session
| File | Change |
|---|---|
| `README.md` | Corrected: Three Pillars, Three Core Languages, removed org description |
| `docs/Whitepaper.md` | Added: ingest governance section, sensorium section, pipeline diagram |
| `docs/Yellowpaper.md` | Added: sensorium layer to pipeline spec, `core_ingest` to data flow |
| `docs/decisions/ADR-0012-core-ingest-governance-layer.md` | New |
| `docs/decisions/ADR-0013-sensorium-multimodal-protocol.md` | New |
| `docs/decisions/ADR-0014-train-learning-loop.md` | New |
| `docs/decisions/README.md` | Updated index |
| `docs/decisions/SESSION-2026-05-13.md` | This file |