Doctrine: routing-is-inference · curriculum first, kiln second · parent seal ·
concept cards not RAG blobs. Version: see services/ai/brain/VERSION ·
log: ChangeLogs/AI/CHANGELOG.md.
1. What you are looking at
Joshua is a solid-state mind path (Brain Box), not “one big chat model.” Transformers are optional organs (mentor dies). Memory is files + tags + planes.
| Layer | Meaning |
|---|---|
| Chat UI | Talk to the product mind (/joshua-ai) |
| Board.think | Packet hops: bind → executive → speech / kiln |
| HOT / SANDBOX / POISON | Truth / homework / killed cards |
| Kiln / mentor | Local LLM teacher when index misses |
2. On-screen owner tools (Joshua-AI)
| Control | What it does |
|---|---|
| OWNER · toolbox (top strip) | Expand: VRAM toolbox, warm dies, profiles, fallback voice model, NAP/CURATE sleep panel. |
| WARM ALL / REFRESH | Pin toolbox models into GPU VRAM on Ollama buses. May show HTTP 502 if generate is overloaded. |
| NAP / CURATE | Sleep school: draft + score drafts. Does not auto fine-tune. |
| FOUNDRY rail (right sidebar) | Collapsible Soft-PCB / FT queue (legacy). Collapse saves in browser localStorage. |
| TOOLS · LEGEND (in FOUNDRY rail) | This page + short legend. Always available next to the foundry queue. |
| Whitepaper abstract / full (owner) | Public abstract; full proprietary paper at /api/joshua/brain/whitepaper (owner). |
3. Owner dash tools
| Where | What |
|---|---|
| /owner-dash/brain-bench 🧠 | Brain Bench — regular baseline: does he feel alive? Bands: alive / warm / stirring / cold. Can compare engine brain vs ollama. |
| /owner-dash/foundry | Neuron fine-tune wizard (never auto-starts). |
| /owner-dash/console | Owner AI Console (biographer / ops chat). |
| Lab Oscope | Servers / topology / model list. |
4. CLI tools (run from project root)
These are Node scripts in your repo — not Windows commands.
Open a terminal, cd to themightyjoshua, then run:
cd C:\Users\Josh6\projects\themightyjoshua # Curriculum seed (syntax library → HOT cards) node scripts/seed_core_memory.js # Teach a lesson into concept cards (paste / demo / URL) node scripts/teach_ingest.js --demo node scripts/teach_ingest.js --demo --seal node scripts/teach_ingest.js --url "https://www.w3schools.com/js/js_variables.asp" node scripts/teach_ingest.js --file path\to\lesson.md --seal # Talk probes (Board.think, no browser) node scripts/_talk_joshua_ingest.js node scripts/_talk_curiosity_loop.js # Regular baseline bench node scripts/brain_bench.js --suite quick node scripts/brain_bench.js --suite baseline node scripts/brain_bench.js --engine ollama --model josh_public:latest
What each script is for
| Script | Job |
|---|---|
seed_core_memory.js |
Install parent syntax library (asm/cpp/python/… hello + basics) as HOT sealed cards. |
teach_ingest.js |
Teach from URL, paste, or file: chunk → tag → SANDBOX cards (or HOT if --seal). Not a RAG mega-blob. |
_talk_joshua_ingest.js |
Ask hello-world questions via Board.think; print path + reply (debug ingest). |
brain_bench.js |
Score feel-alive suite; save history for dash. |
5. HTTP APIs (owner session)
| API | Use |
|---|---|
POST /api/joshua/chat |
Normal chat (Brain Box when enabled). |
GET/POST /api/joshua/brain/bench |
Load last bench / run suite. |
GET/POST /api/joshua/brain/teach |
Teach ingest: { "url" } or { "text" }, optional seal: true. |
GET/POST /api/joshua/brain/curiosity |
Growth queue: list / enqueue / study one want. |
POST /api/joshua/brain/warm |
Warm toolbox dies (owner). |
GET/POST /api/joshua/brain/sleep |
Nap / sleep school report. |
GET /api/joshua/brain/foundry |
Foundry rail scores / queue. |
6. Memory planes (why seal matters)
| Plane | Meaning |
|---|---|
| SANDBOX | Homework / draft. Product index usually ignores. |
| HOT | Parent-sealed product truth. Index answers from here. |
| POISON | Killed wrong-shelf card. Never serve. |
Teach default is sandbox until you trust the source, then --seal or API seal: true.
7. Networks = routing tables (auto-assign)
At the end of the day it is routing tables. A dedicated assigner
(NetworkTable + attention stamp) puts each turn on a network:
net.code, net.engineering, net.math,
net.history, net.art, net.science, …
Talk engineering → stay on engineering; switch to history → network switches
and shelves hang under the new route. Sticky until a strong new match.
| Piece | Job |
|---|---|
NetworkTable.js | Match text → network id (routing table) |
NetworkAssign.js | Stamp packet body.network |
| attention.tag | Runs assign every turn (auto) |
| ThreadStore.network | Sticky network across turns |
| ShelfCatalog | Shelves addressed under network id |
GET /api/joshua/brain/networks?q=… | List table + sample assign |
8. Organic shelves (mind grows folders itself)
After each substantive talk turn the mind opens a shelf under the active network, files notes from what you said + mentor tries into SANDBOX, and studies curiosity in the background. No CLI required for everyday ingest. NAP drains more. Parent still seals HOT.
| Tool | Organic use |
|---|---|
| TalkIngest | harvest claims from talk + consult + catalogue |
| ShelfCatalog | ensure + fileCard under network address |
| OrganicTools | every think → shelveTalkTurn (sandbox) |
| CuriosityQueue | enqueue gaps after think |
| CuriosityStudy | after-thought + NAP drain → sandbox |
| TeachIngest | optional URL/paste bulk; same card shape |
GET /api/joshua/brain/shelves | list living shelves |
POST /api/joshua/brain/organic | force nap-style study tick |
9. Parent seal button (after each turn) · 0.7.0
Under every Brain Box reply (owner): SEAL → HOT elevates that
turn’s sandbox card to product truth; REJECT poisons it;
SEAL SHELF seals every card on the network shelf.
API: POST /api/joshua/brain/seal · POST /api/joshua/brain/reject.
Stream exposes site_gen_stats.sealable + network + organic.
Parent talk also drives the correction / coach loop: grade a try with yes/no, or teach the correct claim in the next sentence — mind uses inference to recatalogue, never silent-HOT without your seal. (“Right triangle” is geometry, not a pass grade.)
End goal (whitepaper v10): inference as a protocol — swarm of
brain-services and sealed knowledge. See docs/BRAIN_FABRIC.md.
10. Recommended daily loop
1. Talk naturally — mind assigns network + shelves claims as you speak 2. Hit SEAL → HOT under the turn when claims look right 3. Or REJECT / teach a correction in chat (coach loop) 4. Optional bulk: teach a page (CLI or POST /brain/teach) 5. NAP to drain curiosity homework into shelves 6. Brain Bench (quick) — band should stay "alive"
11. Docs map
| Doc | Path |
|---|---|
| This legend | /docs/Brain-Box-Tools-Legend.html |
| Whitepaper abstract (public) | /docs/Solid-State-AI-Whitepaper-abstract.html |
| Whitepaper full (owner) | /api/joshua/brain/whitepaper · .docx same path |
| Brain map | docs/BRAIN_BOX_V0.md |
| AI versioning | docs/AI_VERSIONING.md |
| AI changelog | ChangeLogs/AI/CHANGELOG.md |
| Brain VERSION | services/ai/brain/VERSION |
If a tool name confuses you: start with Brain Bench (feel) and teach_ingest --demo (ingest). Everything else is optional organs.