This directory decomposes the single ../V9_features.md
hub into focused, in-depth, code-grounded pages. The hub remains the canonical
entry point and preserves its heading anchors (so existing cross-references keep
resolving); each page below expands one section with far richer, code-grounded
detail. The companion architecture section lives at
../architecture/README.md.
Cross-reference convention. A bare
§N/§N.Mpoints at a section of the backlog../V9_TODOS.md;deps§Npoints at../V9_DEPENDENCIES.md; page-to-page links are relative (./<slug>.md, or../architecture/<slug>.mdfor the companion).
Feature landscape#
Drawn from its Mermaid source.
As text
Parts: - Learner wonder - Atlas concept prerequisite and gap resolution - Prometheus solve-first lesson forge - Sophia sources Nyx and Kalika computed truth - Chiron embodied Socratic teaching - Hephaestus reachable explorables - Aletheia truth pedagogy completeness safety and provenance - Versioned accessible lesson artifact - Threads Mnemosyne mastery and retrieval - Theia braid Commons and next better question - Sources kernels verdicts provenance and replay (data) - Governance cost localization LMS delivery retraction and rollback Connections: - Learner wonder to Atlas concept prerequisite and gap resolution - Atlas concept prerequisite and gap resolution to Prometheus solve-first lesson forge - Prometheus solve-first lesson forge to Sophia sources Nyx and Kalika computed truth - Sophia sources Nyx and Kalika computed truth to Chiron embodied Socratic teaching - Sophia sources Nyx and Kalika computed truth to Hephaestus reachable explorables - Chiron embodied Socratic teaching to Aletheia truth pedagogy completeness safety and provenance - Hephaestus reachable explorables to Aletheia truth pedagogy completeness safety and provenance - Aletheia truth pedagogy completeness safety and provenance to Versioned accessible lesson artifact - Versioned accessible lesson artifact to Threads Mnemosyne mastery and retrieval - Threads Mnemosyne mastery and retrieval to Theia braid Commons and next better question - Theia braid Commons and next better question to Atlas concept prerequisite and gap resolution - Aletheia truth pedagogy completeness safety and provenance to Sources kernels verdicts provenance and replay - Sources kernels verdicts provenance and replay to Governance cost localization LMS delivery retraction and rollback
Show source
flowchart LR
Learner[Learner wonder] --> Atlas[Atlas concept prerequisite and gap resolution]
Atlas --> Prometheus[Prometheus solve-first lesson forge]
Prometheus --> Truth[Sophia sources Nyx and Kalika computed truth]
Truth --> Chiron[Chiron embodied Socratic teaching]
Truth --> Hephaestus[Hephaestus reachable explorables]
Chiron --> Gates[Aletheia truth pedagogy completeness safety and provenance]
Hephaestus --> Gates
Gates --> Lesson[Versioned accessible lesson artifact]
Lesson --> Mastery[Threads Mnemosyne mastery and retrieval]
Mastery --> Theia[Theia braid Commons and next better question]
Theia --> Atlas
Gates --> Evidence[(Sources kernels verdicts provenance and replay)]
Evidence --> Operations[Governance cost localization LMS delivery retraction and rollback]
The landscape shows one learning loop, not a content funnel. Wonder is scoped to prerequisites and authority before generation; teaching and exploration are gated as a complete lesson; demonstrated evidence updates mastery; continuation returns to the knowledge spine. Engagement alone never advances truth or mastery.
Use this index to select the learner-facing job, pair it with the owning architecture page, and trace concept/source/kernel pins, objectives, claims, activities, solutions, gate versions, artifact versions, learner consent, mastery evidence, fallback, and retraction. Then inspect product/gap/research/dependency documents, backlog, current code/tests/artifacts, learner evidence, and operations before assigning status.
Every focused feature page appears exactly once below. The V9 documentation guide supplies role-based paths and the lesson-truth model; the diagram atlas supplies knowledge, lesson, data, lifecycle, composition, learner, and release views. Poetic framing remains explicitly separate from empirical claims and computed truth.
Orientation#
- Metis — A Curious Ape's Guide to Reality (Product Overview) — the integration+productization thesis, the five atoms (Metis/Wonder/Lesson/Thread/Atlas), the seven wonder axes, and the nine-moment learner journey at a glance
- Subsystem Map, Substrate Reuse, and the Seven Gates — the nine Promethean codenames mapped to their real libs/v9 packages and the V1–V8 substrates each composes, plus the G1–G7 release-gate contract every lesson must pass
Generating a Verified Lesson#
- The Atlas of Reality and Wonder Resolution — how a free-text wonder resolves to a mastery-scoped prerequisite frontier — graph unification, BM25+dense retrieval, Mnemosyne gap-finding, and the two node grounding invariants
- Prometheus — the Solve-First Lesson Forge — the eight-stage solve-first pipeline (resolve→ground→plan→write→explorable→assess→gate→compile), Aletheia's truth/accuracy gating, and the verified-skeleton vs regenerable-surface lesson artifact
Delivering and Remembering the Lesson#
- Chiron and Hephaestus — the Embodied Teacher and Explorables — the live Socratic tutor (integrity modes, avatar→voice→text fallback, grounded personas) and the manipulable computed-kernel explorables (Nyx sky, Kalika orbit) with demonstrably-reached success states
- Threads, the Personal Atlas, and the Mnemosyne Mastery Loop — the next-better-question thread, the brightness-as-mastery star map, and the FSRS knowledge-trace + IRT adaptive difficulty + spaced-retrieval checkpoint that feeds mastery back to wonder-scoping
Soul, Commons, and Platform#
- The Soulful Braid, the Agora Commons, and Explainer Films — the awe→curiosity→understanding emotional arc and science↔human braid, creator-authored guided journeys and shareable objects, and verified generative widgets + Manim-style explainer films
- Governance, Cross-Cutting Discipline, Non-Goals, and Definition of Done — the AgentRun governance plane (DAG/budget/kill-switch/replay, no-eighth-loop), entitlement/age/region gating, determinism/cost/a11y/LMS/anti-metric discipline, and the six boundaries + seven-point GA bar