# V9 Diagram Atlas This atlas provides V9's cross-cutting visual models for wonder resolution, solve-first lesson generation, durable learning data, lesson lifecycle, reuse composition, subsystem ownership, the learner journey, and release evidence. Focused pages, typed artifacts, source/kernel pins, gate verdicts, tests, learner evidence, and current operations remain authoritative. ## Wonder-to-mastery landscape ```mermaid flowchart LR Wonder[Learner wonder] --> Atlas[Atlas resolves concepts prerequisites and gaps] Atlas --> Ground[Sophia sources and Nyx or Kalika computed truth] Ground --> Prometheus[Prometheus solve-first lesson plan] Prometheus --> Narrative[Grounded explanation and soulful braid] Prometheus --> Hephaestus[Computed or verified explorable] Prometheus --> Assessment[Worked solution and assessment] Narrative --> Chiron[Chiron embodied Socratic delivery] Hephaestus --> Chiron Assessment --> Aletheia[Aletheia G1 through G7] Chiron --> Aletheia Aletheia --> Artifact[Versioned lesson artifact] Artifact --> Learner[Accessible web-first lesson] Learner --> Mnemosyne[Mastery and spaced retrieval] Mnemosyne --> Theia[Theia continuation and next better question] Theia --> Atlas Artifact --> Evidence[(Sources kernels gates provenance and replay)] ``` The loop advances only from demonstrated learning evidence. Engagement may inform experience quality, but it cannot substitute for truth, reachable activity completion, assessment validity, or mastery. ## Lesson-forge sequence ```mermaid sequenceDiagram actor Learner participant Atlas participant Ground as Sophia and kernels participant Forge as Prometheus participant Build as Chiron and Hephaestus participant Gate as Aletheia participant Mastery as Mnemosyne and Theia Learner->>Atlas: Wonder context language and consented profile Atlas->>Ground: Resolve prerequisite frontier sources and computations alt insufficient grounding or prerequisites Ground-->>Learner: Withheld lesson and safe next step else grounded scope Ground-->>Forge: Pinned concept source kernel and misconception set Forge->>Build: Objectives narrative activities assessment and modality plan Build->>Gate: Complete versioned lesson candidate alt any gate fails Gate-->>Forge: Directed rejection or regeneration evidence else G1 through G7 pass Gate-->>Learner: Compiled accessible lesson artifact Learner->>Mastery: Responses success states and assessment evidence Mastery-->>Learner: Retrieval schedule and next better question end end ``` The grounded scope precedes generation. Surface regeneration can preserve the verified skeleton; changed claims, kernels, objectives, or solutions require the applicable gates again. ## Durable knowledge and learning records ```mermaid erDiagram LEARNER ||--o{ CONSENTED_PROFILE : controls LEARNER ||--o{ WONDER : asks WONDER ||--o{ LESSON_VERSION : produces CONCEPT ||--o{ PREREQUISITE_EDGE : requires CONCEPT ||--o{ SOURCE_PIN : grounded_by CONCEPT ||--o{ KERNEL_REF : computed_by LESSON_VERSION ||--|{ LEARNING_OBJECTIVE : targets LESSON_VERSION ||--o{ CLAIM : contains CLAIM }o--|{ SOURCE_PIN : cites CLAIM }o--o{ KERNEL_REF : verifies LESSON_VERSION ||--o{ EXPLORABLE : contains EXPLORABLE ||--|| SUCCESS_STATE : defines LESSON_VERSION ||--o{ ASSESSMENT_ITEM : contains LESSON_VERSION ||--o{ GATE_VERDICT : receives LEARNER ||--o{ MASTERY_RECORD : earns CONCEPT ||--o{ MASTERY_RECORD : measures MASTERY_RECORD ||--o{ RETRIEVAL_EVENT : schedules ``` Learner profile, wonder, concept, source, kernel, objective, claim, explorable, assessment, gate, and mastery records remain independently versioned. A source correction can identify affected claims and lessons without erasing historical learner evidence. ## Lesson lifecycle ```mermaid stateDiagram-v2 [*] --> Wonder Wonder --> Scoped: concepts prerequisites and learner gap resolved Scoped --> Grounded: source and kernel authority pinned Grounded --> Planned: objectives activities solutions and assessment complete Planned --> Realized: narrative media tutor and explorable generated Realized --> Gated: seven versioned verdicts produced Gated --> Compiled: immutable skeleton and regenerable surfaces bundled Compiled --> Delivered: eligible learner receives supported modalities Delivered --> Assessed: valid evidence collected Assessed --> Practicing: retrieval schedule active Practicing --> Mastered: mastery threshold and retention evidence Scoped --> Withheld: prerequisite or authority absent Realized --> Regenerating: surface quality or modality failure Regenerating --> Realized Gated --> Rejected: truth pedagogy completeness safety or provenance fails Delivered --> Retracted: source correction policy or regression ``` Mastery is not a terminal marketing label; later retrieval can revise the estimate and reopen practice. Retraction preserves audit history and gives affected learners a correction path. ## Six-layer reuse composition ```mermaid classDiagram class ModelPlane { Iris Nous } class AgentRuntime { planning tools replay } class CapabilityServers { Sophia Nyx Kalika Mnemosyne } class ProductionPlane { Yemaya Isis Euterpe Psyche } class GovernancePlane { budgets killSwitch gates } class DeliveryPlane { web cache LMS } ModelPlane --> AgentRuntime : serves AgentRuntime --> CapabilityServers : invokes CapabilityServers --> ProductionPlane : grounds ProductionPlane --> GovernancePlane : submits artifacts GovernancePlane --> DeliveryPlane : admits ``` V9 composes these layers rather than introducing a second agent loop. Atlas, Hephaestus, and the consumer experience add product-specific contracts while the shared layers retain their authority. ## Promethean subsystem estate ```mermaid mindmap root((Metis V9)) Knowledge and truth Atlas knowledge spine Sophia sources and provenance Nyx astronomy kernels Kalika math and physics kernels Forge and gates Prometheus lesson generation Aletheia truth and release gates Lesson artifact and Theia continuation Determinism cost and replay Experience and mastery Chiron embodied teaching Hephaestus explorables Mnemosyne learning science Threads personal Atlas and assessment Community and platform Soulful braid films and Agora Accessibility localization and LMS Identity entitlement age and region Governance operations retraction and rollback ``` The estate locates canonical ownership and prevents poetic product language from obscuring source, computation, pedagogy, safety, or delivery authority. ## Learner journey ```mermaid journey title From curiosity to durable understanding section Wonder Ask freely and receive an honest scoped question: 5: Learner, Atlas See prerequisites sources and uncertainty: 5: Learner section Explore Learn through grounded explanation and Socratic dialogue: 5: Learner, Chiron Manipulate a reachable computed or verified explorable: 5: Learner, Hephaestus section Demonstrate Explain predict solve or create without leakage: 5: Learner Receive corrective kind and source-linked feedback: 5: Learner, Aletheia section Remember Practice at the right interval and modality: 5: Learner, Mnemosyne Follow the next better question through the Atlas: 5: Learner, Theia ``` The complete journey includes withholding, fallback, correction, and retraction—not only the ideal generated lesson. ## Evidence order ```mermaid timeline title V9 release evidence Contract : Concept source kernel claim objective and learner invariants : Lesson artifact gate consent and retraction schemas Runtime : Atlas Prometheus Chiron Hephaestus Aletheia and mastery composition : Web delivery modality fallback cache LMS and providers Verification : Truth computation pedagogy completeness and assessment tests : Safety accessibility localization privacy and cost evidence Candidate : Seed replay source correction load operations and rollback : Staged learner cohort and preregistered learning evidence Supported : Named topics ages regions modalities and integrations : Current mastery drift incident and retraction evidence ``` The timeline orders proof. Beautiful output cannot advance past missing truth or learning evidence. ## How to use this atlas Use the landscape and sequence for lesson tracing, ER/state diagrams for data and retraction reviews, class/estate models for ownership, and the journey/timeline for learner and release evidence. Continue to the [V9 guide](./README.md), [feature index](../features/README.md), and [architecture index](../architecture/README.md).