V9 — Features (Page Index) — Metis

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.M points at a section of the backlog ../V9_TODOS.md; deps§N points at ../V9_DEPENDENCIES.md; page-to-page links are relative (./<slug>.md, or ../architecture/<slug>.md for the companion).

Feature landscape#

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