{
  "markdown": "<div align=\"center\">\n  <img src=\"./rainbow-book.jpg\" alt=\"AlloFlow open-source AI classroom assistant logo\" width=\"150\"/>\n\n  # AlloFlow (v1.2)\n  **Adaptive Levels, Layers, & Outputs ➔ Flexible Learning Options for Whole-Student Education**\n\n  [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)\n  [![Local-First Architecture](https://img.shields.io/badge/Architecture-Local--First-brightgreen.svg)](#-local-first-desktop-and-school-box)\n  [![Privacy: FERPA-aligned deployment](https://img.shields.io/badge/Privacy-FERPA--aligned_deployment-red.svg)](#-privacy--ferpa-aligned-deployment)\n  [![Accessibility: WCAG 2.2 AA-oriented](https://img.shields.io/badge/Accessibility-WCAG_2.2_AA--oriented-blue.svg)](#-accessibility)\n  [![UDL Aligned](https://img.shields.io/badge/UDL-Aligned-purple.svg)](#-udl-alignment)\n</div>\n\n---\n\n## 🚀 What is AlloFlow?\n\nAlloFlow is an **open-source, privacy-first AI classroom assistant and instructional differentiation engine** built for educators, special education teams, and school psychologists. Use the keyless Google-managed Gemini Canvas path with no installation, or run AlloFlow Desktop for a local-first teacher-laptop workflow. AlloFlow can transform source material into interactive, differentiated learning resources.\n\n**No AlloFlow software subscription. Local classroom flows can run without student accounts or required PII. Cloud-provider terms, data handling, and costs depend on the deployment you choose.**\n\n**Official AlloFlow website:** [apomera.github.io/AlloFlow](https://apomera.github.io/AlloFlow/)\n\n**Official source repository:** [github.com/Apomera/AlloFlow](https://github.com/Apomera/AlloFlow)\n\n**Official project facts:** [apomera.github.io/AlloFlow/about.html](https://apomera.github.io/AlloFlow/about.html) &mdash; maintained identity, version, license, privacy boundaries, and guidance for distinguishing the canonical project from forks.\n\n**Search identity:** AlloFlow is a free open-source AI classroom assistant for differentiated instruction, UDL, accessibility, AAC communication, STEM/SEL tools, RTI, and local-first school deployments.\n\n**Current inventory (verified September 7, 2026):** the repository registry check reports 148 STEM tool registrations and 72 SEL tool registrations; the STEM directory contains 148 plugin files. The broader July 3 codebase review remains the dated source for architecture and size estimates. AlloFlow Desktop is the everyday local-first path, while the Docker School Box stack is optional server/appliance infrastructure. See [docs/codebase_review_2026-07-03.md](./docs/codebase_review_2026-07-03.md), [docs/code_size_inventory_2026-07-03.csv](./docs/code_size_inventory_2026-07-03.csv), [docs/competitive_positioning_review_2026-07-03.md](./docs/competitive_positioning_review_2026-07-03.md), and [desktop/README.md](./desktop/README.md).\n\n🔗 **[Launch AlloFlow](https://apomera.github.io/AlloFlow/launch.html)**\n\n---\n\n## ⚡ Quick Start\n\n1. **[Click to launch](https://apomera.github.io/AlloFlow/launch.html)** — opens the Gemini Canvas path (eligible Google account required; availability and school administrator settings apply)\n2. **Paste your lesson text** into the Source Material box, or let the AI generate from a topic\n3. **Click Fullpack** — leveled text, glossary, quizzes, and scaffolds generated in one click\n4. **Start a Live Session** to push resources to student devices in real-time\n\n> 💡 For local-first use on a teacher laptop, see [desktop/README.md](./desktop/README.md). For school-owned server/appliance experiments, see [School Box](#-local-first-desktop-and-school-box) below.\n>\n> 🏫 **District decision-maker?** See the 2-page [Admin Brief](./AdminBrief.md) — cost comparison, privacy/compliance, and pilot-path summary.\n\n### Agent-authored AlloPacks\n\nAn agent can author the same portable resource-pack structure without opening the AlloFlow UI. The local Agent Core MCP accepts agent-generated resource history, validates renderer-critical shapes and privacy safeguards, creates a teacher-review preview, and exports a .allopack.json payload. It does not silently call a model, read API keys, upload source text, publish content, or write arbitrary paths. See the [MCP connector guide](./desktop/mcp/README.md), the [AlloPack specification](./docs/ALLOPACK_FORMAT_SPEC.md), and the reusable [AlloFlow resource-pack authoring skill](./agent_skills/alloflow-resource-pack-authoring/SKILL.md).\n\n---\n\n## Product tour\n\n- [Promotion site](https://apomera.github.io/AlloFlow/) -- overview, deployment paths, and current evidence\n- [Official project facts](https://apomera.github.io/AlloFlow/about.html) -- canonical repository, current release, license, authorship, and deployment boundaries\n- [Tool finder](https://apomera.github.io/AlloFlow/tools.html) -- search by goal, source requirement, AI need, and access path\n- [Document remediation](https://apomera.github.io/AlloFlow/remediation.html) -- pipeline, evidence boundaries, portable Skill, and connector status\n- [Ways to use AlloFlow](https://apomera.github.io/AlloFlow/ways-to-use.html) -- compare Gemini Canvas, browser, Desktop, Skill, and connector paths\n- [Accessibility white paper](https://apomera.github.io/AlloFlow/whitepaper.html) -- standards context, architecture, privacy boundaries, and evidence\n- [Feedback](https://apomera.github.io/AlloFlow/feedback.html) -- safe routes for ideas, bugs, accessibility barriers, and de-identified use stories\n- [Feature catalog](https://apomera.github.io/AlloFlow/features.html) -- documented capabilities organized around UDL\n- [Student experience](https://apomera.github.io/AlloFlow/students.html) -- learner-facing tools and accessibility supports\n- [District brief](https://apomera.github.io/AlloFlow/for-districts.html) -- planning, privacy, accessibility, and pilot considerations\n\n> Screenshots change quickly as the interface evolves. Use the current promotion pages and launch flow for the latest maintained product tour.\n\n---\n\n## ✨ Key Features\n\n### 🎓 For Teachers\n\n| Feature | Description |\n|---------|-------------|\n| **Leveled Text & Scaffolds** | Instantly rewrite any source to K-12 plus higher-education/adult reading levels with bilingual side-by-side views, cloze passages, and scaffolded writing frames |\n| **Fullpack Generation** | One click generates glossary, leveled reader, quiz, visual organizer, and lesson plan simultaneously |\n| **Live Session (Classroom Sync)** | Push your screen to all student devices in real-time — Teacher Paced or Student Paced modes |\n| **Group Differentiation** | Assign different resources to different student groups simultaneously during a live session |\n| **Lesson Plan Builder** | Auto-synthesizes all generated resources into a scripted, standard-aligned lesson plan |\n| **Standards Alignment** | Align to CCSS, NGSS, CASEL, or any state standard; AI audits its own output for compliance |\n| **Smart Profiles** | Save configurations (e.g., \"Grade 5 + ESL\") for one-click switching across lessons |\n| **Multimodal Input** | Source from text paste, URL, PDF/image OCR, audio/video transcription, or AI generation |\n| **AlloStudio** | Born-accessible flyer/worksheet/digital-art studio with real text, explicit reading order, required alt/decorative image states, and provenance-aware process history |\n| **Open Groove Studio** | Browser-based groovebox/composition studio for rhythm, synthesis, samples, notation concepts, and license-aware classroom music creation |\n| **Cinematic Studio** | Agentic document → video generator: source-grounded storyboard JSON, captions + translation, and client-side rendering (WebCodecs / Remotion) — no render server required (Educator Hub → 🎬) |\n| **Professional Development** | Community-authored PD modules with AI co-authoring, completion tracking, and certificates (Educator Hub → Community Catalog → Professional Development) |\n\n### 🎮 For Students\n\n| Feature | Description |\n|---------|-------------|\n| **Adventure Mode** | Choose-your-own-adventure RPG with XP, inventory, dynamic Imagen-generated scenes, and Storybook export |\n| **Boss Battle** | Whole-class cooperative quiz game — correct answers deal damage to the boss |\n| **Escape Room** | Team-based puzzle challenges with teacher-controlled hints and timed escape tracking |\n| **Review Game** | Jeopardy-style competitive review with teams and real-time scoring |\n| **Democracy Mode** | Class votes on the answer; majority response is submitted |\n| **Gamification Engine** | XP, levels, streaks, and badges earned across all activities |\n| **Interactive Glossary** | Memory Match, Word Search, Crossword, Bingo, Scramble — all generated instantly from the vocabulary list |\n| **Immersive Reader** | RSVP speed reader, karaoke highlighting, bionic reading, and adjustable reading ruler |\n\n### 🩺 For Special Educators & BCBAs\n\n| Feature | Description |\n|---------|-------------|\n| **BehaviorLens** | Full FBA/BIP suite — ABC data collection, frequency/interval tracking, IOA calculator (5 methods), scatterplot analysis, preference assessments (MSWO, Paired, Free Operant) |\n| **Quick-Fill AI** | Type a natural language observation; AI auto-structures it into Antecedent, Behavior, Consequence with function hypothesis |\n| **Intervention Templates** | DRO protocols, token economies, behavior contracts, SMART goals, FCT templates, de-escalation toolkit |\n| **Restorative Language** | Affirmative Glossary translates clinical ABA terms to person-first language throughout; Restorative Questions generated from each logged incident |\n| **Symbol Studio** | Full AAC platform — AI-generated PCS-style symbols (Imagen + image-to-image), board builder, visual schedules, social stories (Carol Gray format), 8 Quick Board types, Symbol Quest (4 game modes), Symbol Search (auditory-to-visual training), Word Garden (vocabulary growth tracking), IEP goal tracking with auto-recorded trials, partner-assisted scanning, multilingual boards (14 languages), per-cell parent voice recording, up to 8 student profiles |\n| **Word Sounds Studio** | 17 literacy activities across five strands — 6 phonemic awareness (counting, segmentation, isolation, blending, sound sort, manipulation), 4 syllable & rhyme, 3 phonics, 3 spelling, 1 handwriting with grade-normed adaptive difficulty and 6 achievement badges |\n| **StoryForge** | 6-phase scaffolded creative writing with AI illustration (Imagen), narration (8 TTS voices), grading with custom rubrics, 18-language support, writing sprint timers, AI grammar/style coaching, revision tracking, and comic panel stickers |\n\n### 🧠 For School Psychologists\n\n| Feature | Description |\n|---------|-------------|\n| **Report Writer Wizard** | 10-step guided wizard for synthesizing standardized assessment data into bilingual psychoeducational reports with triangulated generation (N parallel passes, best-of-N by evidence coverage), self-healing dual-pass accuracy audit, score-text verification, and cross-section consistency checking |\n| **Fact-Chunk Pipeline** | Immutable PII-scrubbing layer prevents AI hallucination or statistical misinterpretation during report generation; developmental norms cross-referencing (attention span, tantrum frequency, social play, vocabulary by age) |\n| **17 Assessment Presets** | WISC-V, WIAT-4, BASC-3 (Parent & Teacher), Vineland-3, BRIEF-2, Conners-4, WJ-IV COG & ACH, KABC-II, DAS-II, CELF-5, KTEA-3, SRS-2, GARS-3, BOT-2 |\n| **Student Analytics (RTI)** | Automated Tier 1/2/3 classification with aimline monitoring (4-week warning, 6-week critical alerts); ORF, Math Fluency, and Literacy CBM probes; Pearson correlation analysis; anomaly flagging; CSV export |\n| **Math Fluency Probes** | K–8 grade-normed DCPM arithmetic drills (addition, subtraction, multiplication, division) with error analysis and frustration detection |\n| **PDF Accessibility Pipeline** | Upload any PDF → up to 10-auditor triangulated AI audit (user-configurable, with stakeholder-perspective variants: screen-reader user, disability-rights advocate, Section 508, Title II ADA, JAWS/NVDA tester, etc.) → statistical agreement analysis (ICC-like, Cronbach-like) → one-click WCAG remediation via Vision API + Tesseract.js OCR (Gemini Vision fallback) for scanned/encrypted PDFs → axe-core 4.10 verification → self-healing auto-fix loop with regression-revert + SEM-based plateau detection → **native tagged-PDF output** (real `/StructTreeRoot` via pdf-lib, font embedding per PDF/UA §7.21.4.1) → in-app structural checks plus optional independent **PDF/UA-1 (ISO 14289-1) validation** through the local veraPDF demo/QA workflow → preview/edit with themes, brand matching, and AI image tools → **PII redaction** (true text removal) and **fillable AcroForm worksheets** → export as accessible PDF, HTML, ePub3, DAISY, ODT, or audio |\n\n---\n\n## STEM Lab (148 Plugin Files / 148 Registered Tool IDs)\n\nThe STEM Lab is a dynamically-loaded suite of browser-based interactive tools. As verified by `node dev-tools/check_tool_registry.cjs` on September 7, 2026, the workspace contains **148 `stem_tool_*.js` files** and **148 registered STEM tool IDs**.\n\n| Domain | Tools |\n|--------|-------|\n| **Math Fundamentals** | Fraction Lab, Area Model, Multiplication Table, Number Line, Math Manipulatives, Money Math, Coordinate Grid, Angle Explorer, 3D Volume Explorer, 3D Geometry Sandbox |\n| **Advanced Math** | Function Grapher, Inequality Grapher, Calculus Visualizer, Algebra CAS, Graphing Calculator, Probability Explorer, Unit Converter, Logic Lab |\n| **Life Science & Biology** | Cell Simulator, Human Anatomy, Brain Atlas, DNA Lab, Punnett Square, Virtual Dissection, Decomposer, Companion Planting Lab, Aquaculture & Ocean Lab, Ecosystem Simulator, Beehive Simulator |\n| **Earth & Space Science** | Rocks & Minerals, Water Cycle, Climate Explorer, Plate Tectonics, Solar System, Universe Timelapse, Galaxy Explorer, Moon Mission |\n| **Physics & Chemistry** | Wave Simulator, Physics Simulator, Circuit Builder, Chemical Equation Balancer, Molecule Builder, Titration Lab, Semiconductor Lab, Data Plotter |\n| **Technology & CS** | Coding Playground, Cyber Defense Lab, Data Studio |\n| **Creative & Design** | Architecture Studio, Art & Design Studio, Art Studio, Creative Studio, Game Studio |\n| **Social Studies & Life** | Economics Lab, Life Skills Lab |\n| **Simulation & Applied** | Kepler Colony, Behavior Shaping Lab, Flight Simulator, ATC Tower, Fire Ecology, Epidemic Simulator, World Builder, Science Lab, Geometry World |\n\nEach tool supports **Generate Drill** for instant related practice sets and saves/restores state with the session.\n\n---\n\n## 💚 SEL Hub (72 Interactive Tools)\n\nThe SEL Hub provides **72 social-emotional learning tools** aligned with CASEL's core competencies and expanded AlloFlow categories such as self-direction, inner work, care of self, and stewardship:\n\n| Competency | Tools |\n|------------|-------|\n| **Self-Awareness** | Emotions Explorer, Strengths Inventory, Journal, Zones of Regulation, Growth Mindset Workshop |\n| **Self-Management** | Coping Strategies, Goals & Planning, Mindfulness, Transitions |\n| **Social Awareness** | Perspective Taking, Compassion, Culture Explorer, Upstander Training |\n| **Relationship Skills** | Friendship Builder, Conflict Resolution, Community, Teamwork, Restorative Circle |\n| **Responsible Decision-Making** | Decisions Lab, Ethical Reasoning Lab, Civic Action & Hope, Safety, Social Skills, Advocacy |\n\nHighlights include the **Growth Mindset Workshop** (Brain Science, Reframe Engine, Famous Yet Stories, AI Growth Coach, Letter to Future Me), **Restorative Circle** (5 circle types with Indigenous roots and talking pieces), **Ethical Reasoning Lab** (6 contemporary dilemmas, 6 ethical frameworks, stakeholder mapping), and **Culture Explorer** (80+ world cultures with AI-powered deep dives).\n\n---\n\n## 🔐 Privacy & FERPA-Aligned Deployment\n\nAlloFlow is designed so schools can keep student data inside the browser, teacher device, or school-controlled infrastructure. Cloud use is explicit and deployment-dependent.\n\n| Principle | Implementation |\n|-----------|----------------|\n| **No PII Required** | The tool does not require names, IDs, or identifying information |\n| **On-Device Storage** | Most ordinary work persists in browser local storage or downloaded project files; live-session cloud paths are designed to avoid durable student records |\n| **TeacherGate** | Clinical tools, grading rubrics, and answer keys are isolated behind educator verification |\n| **Local Voice/ASR Options** | Desktop can run local voice and transcription paths; web deployments can fall back to browser/local options when available |\n| **Local-First Options** | AlloFlow Desktop supports no-Docker local use and same-room LAN sessions; the Docker School Box stack is optional server/appliance infrastructure |\n\n> For districts using **Google Workspace for Education**: Canvas/Firebase coverage and student-privacy obligations depend on the district's account, contracts, retention settings, and actual use. AlloFlow is built to support FERPA-aligned deployments, but final compliance is a district/legal determination.\n\n---\n\n## 🏫 Local-First: Desktop and School Box\n\n> **Status as of August 1, 2026:** AlloFlow Desktop is the recommended local-first path for a teacher laptop or personal workstation. It serves the bundled app locally, manages keys and local AI settings, supports the built-in local engine, and can run same-room Desktop LAN sessions without Docker. The Docker School Box stack remains an optional server/appliance path for school-owned boxes, district/server experiments, and heavier air-gapped infrastructure.\n\nFor everyday local use:\n\n```powershell\nnpm.cmd run desktop:check\nnpm.cmd run desktop:smoke\nnpm.cmd run desktop\n```\n\nFor optional School Box server/appliance testing:\n\n```bash\n# Clone the repository\ngit clone https://github.com/apomera/AlloFlow.git\n\n# Start the optional Docker server stack\ndocker-compose up -d\n```\n\n**What can run locally:**\n- **AlloFlow Desktop** — bundled app hosting, local keys, diagnostics, built-in local engine, local ASR/TTS settings, and Desktop LAN sessions\n- **Optional Docker School Box stack** — server/appliance services such as PocketBase, Ollama, Piper, SearXNG, Flux, and Nginx when a school wants managed local infrastructure\n- **LM Studio / Ollama / LocalAI** — compatibility paths for users who already run those local providers\n- **PocketBase** — local database replacing Firebase\n\nHardware needs depend on the local model and service profile. See [desktop/README.md](./desktop/README.md), [docker/README.md](./docker/README.md), and [DEPLOY_YOUR_OWN.md](./DEPLOY_YOUR_OWN.md).\n\n---\n\n## ♿ Accessibility\n\nAlloFlow is built toward **WCAG 2.2 AA** with keyboard-first interaction patterns, automated audits, and per-tool accessibility gates. The current evidence set includes an interim v1.2 VPAT and a limited-scope WCAG 2.2 audit; neither is a product-wide certification. Compliance-sensitive deployments should still verify the exact workflow and exported artifacts they use.\n\n- **Dyslexia Fonts** — OpenDyslexic, Lexend, Atkinson Hyperlegible\n- **Bionic Reading** — bolds initial letters to guide decoding\n- **Voice options** — word-for-word tracking through configured browser, cloud, Desktop, or optional local voice engines\n- **Color Overlays** — Peach, Blue, Yellow tints for Irlen syndrome support\n- **Reading Ruler** — mouse-following line isolation bar\n- **High Contrast & Dark Mode**\n- **Voice Dictation** — speech-to-text on all input fields\n- **Keyboard-first coverage** — core navigation and audited workflows support standard keyboard interaction; use the published audit and report any tool-specific gaps\n\n---\n\n## 💵 Is It Really Free?\n\n**The software:** yes — free and open-source under AGPL v3. **The Gemini API usage** depends on your deployment path:\n\n| Path | Software cost | API cost | What You Need |\n|------|---|---|---|\n| **Gemini Canvas** | No AlloFlow license fee | Subject to Google's current terms and quotas | A Google account; uses the host-provided keyless path |\n| **Firebase Hosting (Spark — free tier)** | No AlloFlow license fee | Hosting and AI-provider usage are subject to current free-tier limits | A Firebase project plus a securely configured AI-provider path |\n| **Firebase Hosting (Blaze — pay-as-you-go)** | No AlloFlow license fee | Provider and hosting charges vary by usage | Relevant for heavier workflows; see [DEPLOY_YOUR_OWN.md](./DEPLOY_YOUR_OWN.md) and verify current provider pricing |\n| **AlloFlow Desktop** | Free | $0 for local engine use; cloud providers optional | Teacher laptop/workstation; no Docker required |\n| **School Box Server (optional Docker)** | Hardware cost only | $0 for local model paths; cloud providers optional | School-owned server/appliance stack |\n\n---\n\n## 🎯 UDL Alignment\n\nEvery feature maps to [CAST's UDL Guidelines](https://udlguidelines.cast.org/):\n\n| UDL Principle | AlloFlow Tools |\n|---------------|----------------|\n| **Engagement** | Adventure Mode, Boss Battle, Escape Room, Democracy Mode, Symbol Quest, Symbol Search, StoryForge, Growth Mindset Workshop, Gamification Engine |\n| **Representation** | Leveled Text, Bilingual Views, Glossary with Icons, STEM Lab (148 plugin files / 148 registered IDs), SEL Hub (72 tools), TTS (40+ languages), Color Overlays, Bionic Reading, Symbol Studio AAC boards |\n| **Action & Expression** | Writing Scaffolds, StoryForge, Auto-Grader, Rubrics, Oral Fluency Coach, Dictation, QTI Export, Symbol Studio, Report Writer, PDF Pipeline |\n\n---\n\n## 📚 Documentation\n\n| Resource | Link |\n|----------|------|\n| 🏫 Admin Brief (for districts) | [AdminBrief.md](./AdminBrief.md) |\n| ♿ Interim Accessibility Conformance Report (VPAT® 2.5Rev WCAG) | [VPAT-2.5-WCAG-AlloFlow.md](./VPAT-2.5-WCAG-AlloFlow.md) |\n| ♿ Current WCAG 2.2 audit | [a11y-audit/WCAG-2.2-current-audit.md](./a11y-audit/WCAG-2.2-current-audit.md) |\n| ♿ Historical WCAG AA audit | [alloflow_wcag_aa_audit_report.md](./alloflow_wcag_aa_audit_report.md) |\n| 📖 Complete User Manual | [AlloFlow Complete User Manual.md](./AlloFlow%20Complete%20User%20Manual.md) |\n| Teacher Guide (searchable) | [guide/index.html](./guide/index.html) |\n| Teacher Guide (offline / print) | [guide/offline.html](./guide/offline.html) |\n| 🖨️ Quick Reference Cards | [QuickReferenceCards.md](./QuickReferenceCards.md) |\n| 🏗️ Architecture Overview | [architecture.md](./architecture.md) |\n| 🚀 Firebase Deployment | [DEPLOY_YOUR_OWN.md](./DEPLOY_YOUR_OWN.md) |\n| 🔒 Security Policy | [SECURITY.md](./SECURITY.md) |\n| 🤝 Contributing | [CONTRIBUTING.md](./CONTRIBUTING.md) |\n| 🐛 Report Issues | [GitHub Issues](https://github.com/Apomera/AlloFlow/issues) |\n\n---\n\n## 🔧 For Developers\n\nAlloFlow uses a **Hub-and-Spoke architecture** — a single orchestrator component (`App.jsx` / `AlloFlowANTI.txt`, ~31K lines in the current deploy copy) dynamically loads a large set of modules and plugin families on demand: STEM Lab (148 plugin files / 148 registered IDs), SEL Hub (72 tools), BehaviorLens, Report Writer, Symbol Studio, Word Sounds, Student Analytics, StoryForge, Cinematic Studio (doc→video), AlloStudio, Open Groove Studio, Professional Development, Doc Pipeline, Games, AI Backend, and more. Modules are served from the selected deployment's static asset host; `build.js` handles URL resolution. See [CONTRIBUTING.md](./CONTRIBUTING.md) for architecture rules and [architecture.md](./architecture.md) for a full technical overview.\n\n```bash\n# Cloud deployment (Firebase)\ncd desktop/web-app\nnpm install\nnpm run build\nfirebase deploy\n\n# Desktop local runtime\nnpm.cmd run desktop:check\nnpm.cmd run desktop:smoke\nnpm.cmd run desktop\n\n# Run clinical logic test suite (no dependencies)\nnode tests/clinical_tests.js\n```\n\n### 🧪 Test Suite\n\nAlloFlow includes **117 automated tests** covering clinical decision-making logic — the scoring algorithms, classification lookups, and data transformations that affect real student services. Tests are organized in three tiers:\n\n- **Tier 1 (Clinical Decisions):** Score classification (standard + T-score), percentile calculation, PII scrubbing, RTI tier classification, developmental norms\n- **Tier 2 (Learning Tracking):** Familiarity scoring, word growth levels, codename validation, Pearson correlation, aimline monitoring\n- **Tier 3 (Data Quality):** Math fluency benchmarks, error analysis, doc pipeline issue normalization, assessment preset integrity\n\nRun with `node tests/clinical_tests.js` — zero dependencies, just Node.js. See [tests/README.md](./tests/README.md) for full documentation.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome — especially new STEM/SEL tools, accessibility improvements, clinical test cases, and additional language support.\n\n1. Read [CONTRIBUTING.md](./CONTRIBUTING.md) for architecture rules (Hub-and-Spoke pattern, Cloudflare CDN module resolution, plugin templates).\n2. Read [architecture.md](./architecture.md) for a full technical overview.\n3. Open a descriptive PR explaining which UDL checkpoint or clinical workflow your change enhances.\n\n**Quick wins for new contributors:**\n- Add a new STEM tool (`stem_lab/stem_tool_yourname.js`) — self-contained, no core file changes needed\n- Add a new SEL tool (`sel_hub/sel_tool_yourname.js`) — same plugin pattern\n- Add clinical test cases to `tests/clinical_tests.js` (verify expected values against assessment manuals)\n- Improve i18n strings in `ui_strings.js` for an underrepresented language\n- Add keyboard navigation to an existing game\n- Fix an issue tagged `good first issue` on [GitHub Issues](https://github.com/Apomera/AlloFlow/issues)\n\n---\n\n## 📄 License & Credits\n\n**AGPL v3** — free and open source under a strong copyleft license, supporting educational technology as a public good.\n\n© 2026 Aaron Pomeranz, PsyD\n\n<p align=\"center\">\n  <strong>Built by a school psychologist, for educators.</strong><br>\n  <em>\"Differentiation should be the default, not the exception.\"</em>\n</p>\n",
  "bytes": 26000,
  "sha": "1734981451d83290043f89454714e2e1ac74c98529c5f95d86c33c8b95c34ec8",
  "repo_slug": "apomera/alloflow",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_apomera_alloflow_remediation_2fd35284/readme"
}