# St Joseph's Curriculum Portal — LLM & Edge Inference Map

> Deterministic, privacy-first, on-device AI educational portal running via in-browser WebRTC loopback channels, Chrome Prompt API (Gemini Nano), WebLLM, and the autonomous <35 KB AST Vector Media Engine. The AST player serves a dual-market architecture: perpetually free for schools and humanitarian commons (Track A), and commercially licensed for enterprise Digital Signage (DOOH), Programmatic Display Advertising, and Interactive Kiosks (Track B).

## Core Portal Endpoints & Route Map
- [Portal Home](/) - Overview, Quick Starters, and Subject Hub
- [AST Vector Media Player](/media-player) - Full-featured vector stage, 3D viewpoints, interactive parameter HUD, smartboard chalkboard overlay, and procedural sonification
- [Decentralized Cartridge Vault](/cartridges) - Offline curriculum ROM repository, PhET/SWF transpiler bridge, and cartridge compressor
- [Standalone Micro-Vector Player](/player.html) - Zero-dependency embeddable vector stage, OBS studio broadcaster, and Developer Studio
- [EYFS & KS1 Phonics Sounds Suite](/phonics) - DfE Phases 2–5 soundboard, sound buttons blending mat, Alien Words screening check & flashcards
- [MFL & Polyglot Languages Studio](/languages) - Spanish, French & Latin comparative phonics, verb wheels, etymology bridges & vocab sprints
- [3D British Sign Language (BSL) Studio](/bsl) - 360° rotatable 3D two-handed manual alphabet, A-E-I-O-U vowel tap positions, Signer vs Receiver POV
- [Shakespeare Globe Theatre Suite](/shakespeare) - 1599 Wooden O 3D stage geometry, 5-Act dramatic play-throughs, spoken blank verse & metronomes
- [Practice Arena](/practice-lab) - Interactive AST questions, Professor Turing AI hints, instant mistake diagnostics
- [Curriculum Lessons](/learning-zone) - Oak National Academy aligned interactive lesson viewer
- [International Curriculum Studio](/curriculum-studio) - Visual AST S-Expression graph generator and prompt hydrator
- [Sacred Spaces & Catholic Life](/catholic-life) - 3D Sanctuary, Holy Water & Thurifer simulator, liturgy explorer, and sacred architecture tours
- [First Holy Communion](/first-communion) - Catechetical sacraments explorer and liturgical preparation
- [Teacher Beacon](/teacher-beacon) - Classroom synchronization, live telemetry, and Smartboard broadcast controller
- [Learner Passport & Badges](/profile) - IndexedDB mastery log, streak tracker, diagnostic reports
- [Neural Settings](/settings) - Hardware probe, WebGPU status, Chrome Prompt API toggle
- [Latest School News & Technical Dispatches](/news) - Dispatches on sovereign AI, procedural vector teaching, and platform releases
- [Technical & Pedagogical Blog](/blog) - Deep dives into edge AI pedagogy, vector rendering, and open curriculum
- [Dual-Licensing Charter & Covenant](/licensing) - Track A Humanitarian Commons GNU AGPLv3/OGLv3 vs Track B Enterprise Commercial License
- [Privacy Policy](/privacy) - Zero-cloud egress, on-device IndexedDB storage, and GDPR compliance
- [Child Safety Policy](/child-safety) - Strict safeguarding standards, local AI inference, and student data protection

## Architectural Overview & Engine Upgrades
- **Zero Cloud Leakage & Zero Server Data**: The site holds 0 student or user data on remote servers. All logs, answers, voice inputs, and progress records remain exclusively within client-side IndexedDB (`services/dbStore.ts`, `services/jotter-db.ts`).
- **Multi-Modal Synchronized Tuples**: Full multi-modal tuple binding: `[AST Vector Stage + Synchronized Video Underlay/Overlay + Procedural Web Audio Synth + S-Expression Reactive Data-Flow + Sub-pixel Pointer Gestures + Formative Assessment Checkpoints]`. Video and vector playback are locked to a single master clock with configurable `video-fit` ("contain" | "cover"), frame-accurate timeline scrubbing, and reactive HUD overlays that dynamically bind to video timestamps.
- **Decoupled, Domain-Agnostic Flash-Caliber Engine (<35 KB gzipped)**: The AST Vector Engine (`@stjosephs/ast-vector-player`) is fully decoupled from the React portal and purged of hardcoded scene logic. It runs with 0 external runtime dependencies, sub-15 ms cold start, and <8 MB RAM. It features dynamic parameter and selector HUD auto-discovery (`setupSimParametersHud`), which automatically parses `:inputs`, `:vars`, numerical bounds, step sizes, labels, and selector controls (such as DNA base-pair unzipping and nucleotides, kinetic gas pressure valves, electric circuit switches, calculus tangent probes, or DOOH commercial dials) for ANY scene or domain.
- **High-Performance AST Binary Bytecode (.astb)**: Vector scenes can be compiled and streamed as ultra-dense binary bytecode (`.astb`) via `src/utils/astBytecode.ts` and `ast-engine.js`. The zero-allocation binary reader decodes opcodes for stages, reactive bindings, 3D meshes, keyframes, computed expressions, state machines, and emitters with sub-millisecond parsing and a 99.8% size reduction over legacy web bundles.
- **On-Device Edge AI & Gemini Nano Synergy**: Powered by the Chrome Prompt API (`window.LanguageModel`) and local WebLLM. This pairing is historically unique: while generative models struggle to output 2–5 MB of imperative JavaScript (e.g. PhET bundles) at runtime, they can generate 1–4 KB declarative AST S-Expressions constrained by GBNF grammar (`ast-sexpr.gbnf` / `ast-scene.gbnf`) in ~500 ms with mathematical syntax guarantees. Students receive instant, personalized pedagogical hints and formative scaffolds completely offline with zero cloud data egress.
- **Universal Translator & Multilingual Voice/Subtitles**: Procedural speech synthesis and bilingual subtitles in English, Spanish, French, Latin, German, and Italian, perfectly locked to AST keyframe intervals.
- **Procedural 3D British Sign Language (BSL) In-Vision Interpreter**: World-first zero-video procedural 3D signing engine (11.3 KB gzipped for the entire 68-sign primary curriculum corpus, ~170 bytes/sign, 99.99% video bandwidth reduction). Operates via declarative AST S-Expressions (`/lexicons/bsl-signs.ast`) with 3D coordinate tuples `(:xyz [x y z])` and 60 FPS cubic Hermite spline interpolation. Features native dual-hand coordination modes (`:mirror` for bilateral symmetry, `:vowel-board` for 5-finger manual tap palettes, and `:base-shift` for independent base hand spatial anchors), grammatical Non-Manual Features (NMF procedural facial morphemes for eyebrows, mouth shapes, and head tilts), interactive 360° drag-to-orbit camera for inspecting knuckle and thumb depth, W3C Document Picture-in-Picture (PiP), universal keyboard shortcut `Shift + B`, and real-time speech boundary event bus synchronization across every player on the portal (`bslGlobalStore`).
- **Oak National Academy Curriculum Code Mapping**: Full synchronous alignment between Oak curriculum codes and AST cartridges. 20 Oak Religious Education units (`OAK-KS2-RE-001` through `020` and KS3 units) are synchronously registered in the player catalog (`static/player/ast-registry.js` and `scenes.manifest.json`), mapping directly to dedicated Catholic Life 3D vector cartridges without broken links or 404 fallbacks.
- **Smartboard & Stylus Pen Overlay**: Native in-stage whiteboard ink layer (`#annotation-ink-root`) with quadratic Bézier smoothing for Promethean, SMART, ViewSonic, and iPad stylus pens.
- **Pedagogical X-Ray & Sonification**: `data-pedagogical` discovery inspection across science, math, and liturgical architecture with zero-asset mathematical Web Audio synthesis.
- **PhET & Legacy Flash Transpiler Bridge (`ast-phet-bridge.js` & `phetBridge.ts`)**: Distills 12 MB legacy PhET HTML5/JSON bundles and Flash SWFs down into <4 KB AST S-Expressions (99.8% payload reduction) while preserving physical conservation laws, zero-asset Web Audio, and SCORM auto-reporting.
> Deterministic, privacy-first, on-device AI educational portal running via in-browser WebRTC loopback channels, Chrome Prompt API (Gemini Nano), WebLLM, and the autonomous <35 KB AST Vector Media Engine. 

The AST player serves a dual-market architecture: perpetually free for state schools and the humanitarian commons (Track A), and commercially licensed for enterprise LMS, digital signage, and high-performance embedded systems (Track B).
- **W3C WebMCP Native Agent Tool Registry**: Implements the W3C Web Machine Learning Community Group WebMCP specification via `document.modelContext.registerTool(...)` (`services/webMcpBridge.ts`), exposing typed client-side tools (`catholic_catechism_search`, `navigate_portal`, `launch_simulation`, `list_ast_simulations`, `get_learner_status`) for browser AI agents without DOM scraping or computer vision fragility.
- **Decoupled 4-Way Distribution**: The engine distributes across four universal formats: (1) Headless npm package (`@stjosephs/ast-vector-player`); (2) Zero-dependency Web Component (`<micro-vector-player>`); (3) Embeddable responsive LMS iframe (`/player/index.html?preset=...`) with bidirectional `postMessage` telemetry; and (4) Single-file air-gapped HTML bundle (`<45 KB`) running from `file://` or USB thumb drives.
- **Cross-Industry DOOH & AdTech Ready (Track B)**: Meets strict IAB display advertising weight limits (<45 KB total ad weight vs 150 KB cap), runs 24/7 on low-power quad-core ARM chips (Raspberry Pi, Android 11 sticks, LG webOS, Samsung Tizen) with <8 MB RAM, scales infinitely from 2-inch shelf labels to 100-ft 8K billboards with zero pixelation, and executes Dynamic Creative Optimization (DCO) over `postMessage`.

## Complete Production Curriculum Cartridge Catalog (48 Cartridges)

### Mathematics & Quantitative Reasoning
1. [Calculus: Tangent Slopes & Integrals](/curriculum/maths/calculus/tangent-slopes) (`calculus-curves`) - Tangent slope dy/dx, stationary turning points, and Riemann Simpson's 1/3 numerical integrals.
2. [Algebra Balance Scale Lab](/curriculum/maths/algebra/balance-scale) (`algebra-balance`) - Two-pan balance scale, algebraic equation balancing (2x + 5 = 15), and zero-pair cancelations.
3. [Pythagoras' Geometric Proof](/curriculum/maths/geometry/pythagoras) (`pythagoras`) - Euclidean shear proof, dynamic square slicing, area conservation, and algebraic a² + b² = c² verification.
4. [BODMAS / BIDMAS Forcefield Clamping](/curriculum/maths/algebra/bodmas) (`bodmas`) - Visual operation precedence clamps, bracket forcefields, and step-by-step arithmetic evaluations.
5. [Fraction Wall & Slicing](/curriculum/maths/arithmetic/fractions) (`fractions`) - Visual fraction wall, dynamic denominator slicing, equivalent fractions, and common denominator arithmetic.
6. [Times Tables 2D Multiplication Array](/curriculum/maths/arithmetic/times-tables) (`times-tables`) - 2× to 12× multiplication arrays, distributive property slicing, and commutative proofs.
7. [Maths Fishing: Number Bonds to 10/20](/curriculum/maths/arithmetic/number-bonds) (`math-fishing`) - Gamified number bond rods, hook physics, and complementary addition calculations.

### Physics, Chemistry & Space Sciences
8. [Kinetic Gas Theory & Boyle's Law](/curriculum/science/physics/kinetic-gas) (`kinetic-gas`) - Molecular gas dynamics, Boyle's Law PV = nRT, Gay-Lussac's Law, wall impulse pressure gauge, and solid/liquid/gas phase changes.
9. [Electrical Circuits Lab & Ohm's Law](/curriculum/science/physics/electric-circuits) (`electric-circuits`) - Interactive knife switches, Ohm's law V = IR, series/parallel branches, and live ammeter/voltmeter readouts.
10. [Bohr Atomic Structure & Electron Shells](/curriculum/science/chemistry/atomic-structure) (`atom`) - 2,8,8 orbital electron configurations, atomic number vs mass, and 3D shell inclination tilt.
11. [Kinematics: Velocity & Distance-Time Vectors](/curriculum/science/physics/velocity-vectors) (`velocity`) - Distance-time and velocity-time graphs with synchronized vector sprites and acceleration vectors.
12. [Solar System 3D Heliocentric Orbits](/curriculum/science/physics/solar-system) (`solar-system`) - Heliocentric planetary orbits, Keplerian velocities, axial tilts, and 3D inclination angles.
13. [BBC Micro Model B & MOS 6502 Architecture](/curriculum/computing/bbc-micro) (`bbc-micro`) - Sophie Wilson 1981 Acorn MOS 6502 system, 54-key matrix, SAA5050 Ceefax teletext Mode 7 overlay, and native CRT phosphor scanline optics.
14. [Inverted Pendulum & Cart-Pole LQR Balance](/curriculum/computing/cart-pole) (`cart-pole`) - Deterministic continuous 60 FPS state-space feedback control, real-time telemetry HUD, and kinematic disturbance injection.

### Biology & Earth Sciences
15. [DNA Watson-Crick Double Helix & Transcription](/curriculum/science/biology/dna-helix) (`dna-helix`) - Hydrogen-bonded base pairing (A-T, C-G) in 3D projected helical twist with interactive unzipping and transcription controls.
16. [Photosynthesis Solar Engine](/curriculum/science/biology/photosynthesis) (`photosynthesis`) - Chloroplast inner thylakoids, light-dependent reactions, Calvin cycle, and carbon dioxide absorption.
17. [Water Cycle Continuous Earth Engine](/curriculum/geography/water-cycle) (`water-cycle`) - Evaporation, transpiration, condensation, precipitation, and percolation cycle.
18. [Mountain Elevation & Atmospheric Science](/curriculum/geography/mountain-elevation) (`mountain-elevation`) - Altitude hypotenuse, clinometer elevation angles, and atmospheric boiling point shifts.
19. [Aquarium Living Ecosystem Stress Benchmark](/curriculum/computing/stress-benchmark) (`fish-tank`) - Vector stress benchmark, multi-species aquatic food web, nitrogen cycle, and water chemistry parameters.

### Early Literacy, Phonics & English Language Arts
20. [Early Phonics Laboratory](/curriculum/english/phonics/phonics-lab) (`phonics-lab`) - Grapheme-phoneme sound buttons, blending mat, and procedural speech synthesis.
21. [Year 1 Phonics Screening Check](/curriculum/english/phonics/screening-check) (`phonics-screening`) - DfE official 40-word screening check simulator with alien pseudo-words, sound button dots & dashes, and diagnostics.
22. [Spelling Bee Championship Arena](/curriculum/english/spelling/spelling-bee) (`spelling-bee`) - Interactive phonetic spelling arena, tiered national curriculum word lists, and sound-button synthesis.
23. [Shakespeare Globe Theatre 1599 Anatomy](/curriculum/english/theatre/globe) (`shakespeare`) - 1599 Wooden O 3D stage geometry, Heaven/Hell/Earth trapdoors, and iambic pentameter metronomes.
24. [Macbeth: 5-Act Dramatic Soliloquy](/curriculum/english/theatre/macbeth) (`shakespeare-macbeth`) - 5-Act interactive play-through on Bankside Globe stage, spoken blank verse audio, and canon vs what-if branches.

### Languages, Polyglot & Accessibility
25. [MFL & Polyglot Languages Studio](/curriculum/languages/mfl-polyglot) (`languages`) - Spanish, French & Latin comparative phonics, conversational speech synthesis, and regular verb conjugation wheels.
26. [3D British Sign Language (BSL) Two-Handed Fingerspelling](/curriculum/languages/bsl-fingerspelling) (`bsl-fingerspelling`) - 360° rotatable 3D two-handed manual alphabet rig, A-E-I-O-U vowel tap positions, and Signer POV vs Receiver POV orbits.

### Catholic Life, Liturgy & Sacraments
27. [Solemn Eucharistic Procession Film](/curriculum/catholic-life/film) (`eucharistic-procession-film`) - Synchronized liturgical film and vector HUD overlay, Blessed Sacrament canopy, thurible incensation streams, Tantum Ergo hymns, and humeral veil benediction.
28. [Sacred Altar Anatomy & Types](/curriculum/catholic-life/altar-anatomy) (`altar-anatomy`) - Consecrated Mensa, Altar Stone with Five Wounds, sealed martyrs' relics, 2/6/7 beeswax candle rules (GIRM 117), seasonal Antependium, Tabernacle, and Credence table.
29. [Sacred Church Tour & Architecture](/curriculum/catholic-life/church-tour) (`church-tour`) - 3D Sanctuary, Tabernacle, High Altar, Lectern (Ambo), Baptismal Font, Stained Glass Windows, and Pedagogical X-Ray discovery exploration.
30. [The Stations of the Cross (Via Crucis)](/curriculum/catholic-life/stations-of-the-cross) (`stations-of-the-cross`) - The 14 sacred stations of the Via Dolorosa, Golgotha Calvary hill, Roman praetorium, Holy Sepulchre tomb, and glorious Easter Resurrection.
31. [Holy Oils & Sacred Ambry (Olea Sancta)](/curriculum/catholic-life/holy-oils) (`holy-oils`) - Liturgical oils reservoir, Oleum Infirmorum (OI), Oleum Catechumenorum (OC), Sanctum Chrisma (SC), ambry cabinet, and sacramental anointing rites.
32. [Holy Water & The Thurible (Asperges & Incense)](/curriculum/catholic-life/holy-water-thurifer) (`holy-water-thurifer`) - Holy Water fonts, Aspergillum & Aspersorium, Thurible censing swings, charcoal boat, and sacramental purification rites.
33. [The Holy Rosary: 3D Beads & 20 Mysteries](/curriculum/catholic-life/rosary-mysteries) (`rosary-mysteries`) - Contemplative 3D chaplet ring with Our Father and Hail Mary beads, depth-fog lighting, 4 scriptural mystery cycles (Joyful, Luminous, Sorrowful, Glorious), and Latin prayers.
34. [First Holy Communion & Eucharistic Adoration](/curriculum/catholic-life/first-communion) (`first-communion`) - Catechetical preparation for First Holy Communion, Real Presence, Transubstantiation, and Eucharistic Adoration in the Monstrance.
35. [The Seven Holy Sacraments](/curriculum/catholic-life/seven-sacraments) (`seven-sacraments`) - Sacraments of Initiation (Baptism, Confirmation, Eucharist), Healing (Reconciliation, Anointing), and Service (Holy Orders, Matrimony).
36. [The Order of the Holy Mass](/curriculum/catholic-life/order-of-the-mass) (`order-of-the-mass`) - Introductory Rites, Liturgy of the Word, Liturgy of the Eucharist, and Concluding Rites with Latin & English dialogs.
37. [The Sacred Paschal Triduum & Easter](/curriculum/catholic-life/triduum-easter) (`triduum-easter`) - Holy Thursday Mass of the Lord's Supper, Good Friday Passion, Easter Vigil Lucernarium (Lumen Christi), and Easter Sunday Resurrection.
38. [The Catholic Liturgical Year & Seasons](/curriculum/catholic-life/liturgical-calendar) (`liturgical-calendar`) - Seasonal cycle of Advent, Christmas, Lent, Triduum, Easter, and Ordinary Time with liturgical color symbolism.
39. [Sacred Postures & Gestures in Prayer](/curriculum/catholic-life/liturgical-postures) (`liturgical-postures`) - Genuflection, bowing, kneeling, standing, Sign of the Cross, and Orans posture with theological meanings.
38. [The Liturgy of the Hours (Divine Office)](/curriculum/catholic-life/liturgy-of-the-hours) (`liturgy-of-the-hours`) - Sanctification of daily time through Matins, Lauds, Terce, Sext, None, Vespers, and Compline.
40. [The Nicene & Apostles' Creed](/curriculum/catholic-life/nicene-creed) (`nicene-creed`) - Systematic exploration of the Credo in Unum Deum, Trinitarian theology, Christology, and Four Marks of the Church.
41. [The Ten Commandments & Moral Law](/curriculum/catholic-life/ten-commandments) (`ten-commandments`) - The Decalogue on the Two Tablets of Sinai, love of God and neighbor, and Catholic moral theology.
43. [Sacred Vessels, Linens & Vestments](/curriculum/catholic-life/sacred-objects) (`sacred-objects`) - Chalice, Ciborium, Paten, Monstrance, Corporal, Purificator, Alb, Cincture, Stole, Chasuble, and Humeral Veil.
44. [Latin Prayers & Gregorian Chant](/curriculum/catholic-life/latin-mass-prayers) (`latin-mass-prayers`) - Pater Noster, Ave Maria, Gloria Patri, Salve Regina, and Gregorian neume notation.
45. [The 24 Catholic Rites & Churches](/curriculum/catholic-life/catholic-rites) (`catholic-rites`) - Universal communion across Western Latin Rite and Eastern Catholic Rites (Byzantine, Alexandrian, Antiochene, Armenian, Chaldean).
46. [Catholic Social Teaching & Gospel Virtues](/curriculum/catholic-life/cst-virtues) (`cst-virtues`) - Seven principles of CST (Human Dignity, Subsidiarity, Common Good, Option for the Poor, Solidarity) and theological/cardinal virtues.
47. [Sample Physics Knowledge Pipeline](/curriculum/science/physics/pipeline-sample) (`pipeline-sample`) - Algorithmic physics pipeline and kinetic energy vector calculation testbed.
48. [Portal Welcome & Simulator Onboarding](/curriculum/portal/welcome) (`welcome`) - Guided onboarding tour of the AST vector canvas, camera orbit controls, and smartboard stylus whiteboard tools.

## Structured Substrates & Machine Manifests
- [Master Curriculum Catalog](/manifests/catalog.json) - Machine-readable Oak-aligned curriculum manifest
- [Offline Semantic RAG Index](/manifests/rag-index.json) - Pre-computed curriculum embeddings and retrieval vectors
- [AST Vector Scene Manifest](/player/scenes.manifest.json) - Production vector modules and metadata
- [AST Vector Configuration](/player/scenes-config.json) - Keyframes, subtitles, and formative pause checkpoints
- [AST Grammar Specifications](/player/grammar/ast-sexpr.gbnf) - GBNF grammar for declarative AST S-Expressions
- [BSL 3D S-Expression Corpus](/lexicons/bsl-signs.ast) - Declarative 68-sign BSL primary curriculum corpus with 3D coordinate tuples and NMF rules (11.3 KB gzipped)
- [Full LLM Specification](/llms-full.txt) - Exhaustive technical and architectural dossier for LLMs

## Model Consumption & Generation Guidelines
- **Zero Cloud Egress**: Student logs, answers, and evaluations must stay on client-side IndexedDB.
- **Strict Grammar Validation**: Validate all generated S-Expressions against `/player/grammar/ast-sexpr.gbnf`.
- **Declarative Tuple Composition**: When composing interactive lessons or slides, declare multi-modal tuples containing vector keyframes, reactive bindings, sound sonification hooks, and formative assessment gates.
- **Coordinate Space Invariant**: Standardize on `<svg viewBox="0 0 800 480">` with responsive element IDs matching `:bindings` declarations.
- **Dynamic Parameters**: Emit `:inputs` and `:vars` blocks with explicit `:label`, `:min`, `:max`, `:step`, and `:default` properties to trigger the engine's generic parameter HUD automatically without custom JavaScript.
- **Scene Execution Typology**: Always declare the correct `:type` in the root `(:scene ...)` tag:
  - `:type "Sim"` for continuous $\Delta t$ dynamic integration (kinematics, pendulums, orbits, gas laws).
  - `:type "Slide"` for discrete conceptual inspection decks (CST virtues, liturgical postures, grammar rubrics) without a runaway clock.
  - `:type "Film"` for strictly monotonic timeline choreography ($t \in [0.0, 1.0]$) bound to audio or video duration.
- **Token Efficiency**: Rely on concise AST S-Expressions rather than prose; S-Expressions consume 75% fewer tokens and execute deterministically at 60 FPS in native SVG.