ings in spiral (legacy pattern, proven): - angleStep = (PI * 2) / 24 - ring = floor(idx / 8), radius = 18 + ring * 25 - angle = idx * angleStep + ring * 0.5 - x = cos(angle) * radius, z = sin(angle) * radius 2. Verify: all positions within ground plane (400x400), no overlaps 3. Verify: collision boxes registered for all 24 ### Phase 3: Visual Integration (rendering change) 1. Replace 8 hardcoded addBuilding() calls with 24 data-driven calls 2. Pass room.name as label for texture 3. Pass room.icon for texture emblem (if available) 4. Keep tactical texture system (proven working) 5. Verify: all 24 render, all 24 block movement ### Phase 4: Information Layer (interaction) 1. Add tap-to-select: raycast on touch, show building info panel 2. Info panel: name, what, does, matters, connections (from API data) 3. Preserve: collision still blocks during panel open (joystick z-index 50) 4. Do NOT port: legacy glass panel CSS (rebuild minimal) ### Phase 5: Testing Checklist - [ ] All 24 buildings visible on iPhone - [ ] All 24 block movement (walk into each) - [ ] No overlaps or gaps in spiral - [ ] Textures readable at distance - [ ] Performance: 24 buildings + 24 colliders, 60fps target - [ ] Joystick still works with info panel open ## ROLLBACK PLAN - Foundation V1 backed up: /opt/epistles/public/solidivism/foundation.js.v1-20261008 - Demo page backed up: /opt/epistles/public/solidivism/index.html.v1-20261008 - Rollback: cp *.v1-20261008 → live files (2 commands, <5 seconds) - Legacy /solidability/ untouched throughout (per GPT-6: no replacement without authorization) ## RISK ASSESSMENT - LOW: Data loading (API proven working, returns 24 rooms) - LOW: Layout math (legacy pattern, already validated) - MEDIUM: 24 textures (canvas generation x24 — test performance) - LOW: Collision (system proven, just more boxes) - NONE: Foundation rendering (verified working) ## DEPLOYMENT GATE DO NOT DEPLOY until: 1. King authorizes (explicit word) 2. GPT-6 authorizes (per directive: "without explicit authorization") 3. All Phase 5 checklist items pass on King's iPhone ## LONG-TERM INTEGRATION POINTS (per GPT-6) - Navigable buildings: add door gaps to collision boxes, interior rooms - Source-to-geometry mapping: link building → source file path - Selectable walls: raycast per-face, highlight on tap - Hyper Controller: port 15-button toolbar (rebuild, not copy) - AI Drive: port navigation system (requires working pathfinding) - Autonomous investigation: read-only scene inspection API Each integrates through Solidivism.addBuilding() interface. No direct scene manipulation. No silent divergence. One object = one visual = one collision. Always. ===== FILE: public/solidivism/OPTIMIZATION-ENGINE-ARCHITECTURE.md ===== # EPISTEMOLOGICAL REASONING AND OPTIMIZATION ENGINE ## Architectural Design **Requested by:** THE PROGRAMMER / GPT-6 **Date:** October 9, 2026 **Status:** ARCHITECTURAL DESIGN — No implementation. Live systems preserved. **Builds on:** All prior epistemological proposals (identity registry, ledger, sixfold inquiry, persona of articulation, causal distinctions, reality and constraint principle, epistle identity doctrine). This engine is their computational application. --- ## 1. WHAT THIS IS An engine that investigates code the way the epistemological foundation investigates truth: with identity, provenance, evidence, competing hypotheses, and honest uncertainty — applied to the specific task of understanding and improving computational systems. **What it is not:** - Not an AI personality. The Persona of Articulation informs its disposition, not its interface. - Not a debugging tool. Debugging is one application; optimization under constraints is the purpose. - Not an autopilot. Every optimization is proposed, evidenced, and reviewable. Nothing changes without authorization. - Not a promise of perfection. It designs for demonstrable improvement under explicit constraints, not universal optimality. --- ## 2. ARCHITECTURE ``` ┌─────────────────────────────────────────────────────────────┐ │ PERSONA OF ARTICULATION │ │ (Dispositional layer — governs all) │ │ │ │ "It would be nice to know what actually limits this system."│ └──────────────────────────┬──────────────────────────────────┘ │ informs ┌──────────────────────────▼──────────────────────────────────┐ │ INTENTION TRANSLATOR │ │ Human instruction → Explicit requirements → Human review │ │ (AI interpretation marked as interpretation, not truth) │ └──────────────────────────┬──────────────────────────────────┘ │ ┌──────────────────────────▼──────────────────────────────────┐ │ IDENTITY & PROVENANCE LAYER │ │ Code, deps, authors, instructions, envs, measuremen