@thanh01.pmt/curriculum-kit 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -696,4 +696,161 @@ declare class MisconceptionEvaluator {
696
696
  static evaluateQuiz(quiz: DiagnosticQuiz): DimensionScore;
697
697
  }
698
698
 
699
- export { ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactProductionSpec, type AuditBundleInput, BLOOM_ACTION_VERBS, BloomTaxonomyEvaluator, type BuildContextOptions, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DependencyEdge, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXPOSITION_REL, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, type GenerateExpositionOptions, ICurriculumStorage, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QualityAuditReport, ResolvedGateSettings, type SlashCommandDefinition, SlideDeck, SmartResumeContext, TranslationPolicy, type TranslationTarget, type TranslationTrigger, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildSessionSliceContext, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, expositionCacheKey, extractScopeSequenceRows, extractSessionSlice, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, topoSort };
699
+ /**
700
+ * Markdown Template for Master Lesson Plan (5E Model)
701
+ * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/LESSON_5E_template.md
702
+ */
703
+ declare const LESSON_PLAN_TEMPLATE: string;
704
+
705
+ /**
706
+ * Markdown Template for Inquiry-Based Activity (ACT)
707
+ * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/ACT_template.md
708
+ */
709
+ declare const ACT_TEMPLATE: string;
710
+
711
+ /**
712
+ * Markdown Template for Code Lab (LAB)
713
+ * 100% English Template Structure (Ported from /Users/tonypham/MEGA/ai-platform/my-mcp/_templates/LAB_TEMPLATE.md)
714
+ */
715
+ declare const CODE_LAB_TEMPLATE: string;
716
+
717
+ /**
718
+ * Markdown Template for Student Handout (5-Second Rule Cheat Sheet)
719
+ * 100% English Template Structure (Ported from /Users/tonypham/MEGA/ai-platform/my-mcp/_templates/HANDOUT_template.md)
720
+ */
721
+ declare const HANDOUT_TEMPLATE: string;
722
+
723
+ /**
724
+ * Markdown Template for Presentation Slides Deck (SLIDE)
725
+ * Powered by Marp — Built on Chunky Micro-Cycle Learning (Learn-Apply-Validate Loops)
726
+ */
727
+ declare const SLIDE_TEMPLATE: string;
728
+
729
+ /**
730
+ * Markdown Template for Student Worksheet (WKS)
731
+ * 100% English Template Structure (Ported from /Users/tonypham/MEGA/ai-platform/my-mcp/_templates/WKS_template.md)
732
+ */
733
+ declare const WORKSHEET_TEMPLATE: string;
734
+
735
+ /**
736
+ * Markdown Template for Instructable-style Project Tutorial
737
+ * 100% English Template Structure (Ported from researcher/prompts/tutorial.md & my-mcp)
738
+ */
739
+ declare const PROJECT_INSTRUCTION_TEMPLATE: string;
740
+
741
+ /**
742
+ * Markdown Template for Assessment Rubric (RUBRIC)
743
+ * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/RUBRIC_template.md
744
+ */
745
+ declare const RUBRIC_TEMPLATE: string;
746
+
747
+ /**
748
+ * Markdown Template for Teacher Guide (GUIDE)
749
+ * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/GUIDE_template.md
750
+ */
751
+ declare const TEACHER_GUIDE_TEMPLATE: string;
752
+
753
+ /**
754
+ * Markdown Template for Self-Paced Hands-on Lab (SELF_LAB)
755
+ * Features Progressive Hints System (Accordion/Spoilers) & Automated Verification Commands
756
+ */
757
+ declare const SELF_LAB_TEMPLATE: string;
758
+
759
+ /**
760
+ * Markdown Template for Diagnostic & Active Recall Quiz (QUIZ)
761
+ * Compatible with @thanh01.pmt/interactive-quiz-kit standard
762
+ */
763
+ declare const QUIZ_TEMPLATE: string;
764
+
765
+ /**
766
+ * Markdown Template for Extension Challenge (EXT)
767
+ */
768
+ declare const EXT_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"EXT\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T8\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Target Mastery & Acceleration\"\n - \"Challenge 1\"\n - \"Challenge 2\"\n - \"Verification Criteria\"\n---\n<!-- INJECT_BODY -->\n\n# EXTENSION CHALLENGES: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}}_\n\n## [REQUIRED] Target Mastery & Acceleration\n> *Designed for advanced learners who have successfully completed the core lesson requirements ahead of schedule.*\n\n---\n\n## [REQUIRED] Challenge 1: {{CHALLENGE_1_TITLE}} (Difficulty: \u2B50\u2B50\u2B50)\n- **Problem Statement:** {{CHALLENGE_1_DESCRIPTION}}\n- **Architectural Clues & Hints:**\n{{CHALLENGE_1_HINTS}}\n- **Expected Outcome & Deliverable:** {{CHALLENGE_1_OUTCOME}}\n\n---\n\n## [REQUIRED] Challenge 2: {{CHALLENGE_2_TITLE}} (Difficulty: \u2B50\u2B50\u2B50\u2B50)\n- **Problem Statement:** {{CHALLENGE_2_DESCRIPTION}}\n- **Architectural Clues & Hints:**\n{{CHALLENGE_2_HINTS}}\n- **Expected Outcome & Deliverable:** {{CHALLENGE_2_OUTCOME}}\n\n---\n\n## [REQUIRED] Verification Criteria\n- [ ] Code passes all extended unit tests.\n- [ ] No regression introduced into core components.\n- [ ] Demonstrates high-order optimization or architectural separation.\n";
769
+
770
+ /**
771
+ * Markdown Template for Technical Glossary (GLOSSARY)
772
+ */
773
+ declare const GLOSSARY_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"GLOSSARY\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T9\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Core Technical Terminology\"\n - \"Conceptual Analogies & Non-examples\"\n - \"Cross-Technology Crosswalk\"\n---\n<!-- INJECT_BODY -->\n\n# TECHNICAL GLOSSARY & VOCABULARY: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Reference Standard: CS2023_\n\n## [REQUIRED] Core Technical Terminology\n\n| Term / Keyword | Formal Engineering Definition | Code Usage Context | Common Misconception |\n| :--- | :--- | :--- | :--- |\n{{GLOSSARY_TABLE_ROWS}}\n\n---\n\n## [REQUIRED] Conceptual Analogies & Non-examples\n\n{{ANALOGY_SECTIONS}}\n\n---\n\n## [REQUIRED] Cross-Technology Crosswalk (Neutral vs. Specific)\n\n| Universal Concept (Marr Level 1/2) | Target Language Syntax (Level 3) | Alternative Language Equivalent |\n| :--- | :--- | :--- |\n{{CROSSWALK_ROWS}}\n";
774
+ /**
775
+ * Markdown Template for Bill of Materials (BOM)
776
+ */
777
+ declare const BOM_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"BOM\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T6\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Hardware & Sensor Specification\"\n - \"Software & Environment Invariants\"\n - \"Procurement & Safety Requirements\"\n---\n<!-- INJECT_BODY -->\n\n# BILL OF MATERIALS & LAB PREREQUISITES: {{TITLE}}\n_Unit: {{UNIT_ID}} | Target Class Size: {{CLASS_SIZE}} Students_\n\n## [REQUIRED] Hardware & Sensor Specification\n\n| Item Code | Component Name | Required Qty per Student/Group | Min Spec / Pinout | Alternative Substitute |\n| :--- | :--- | :--- | :--- | :--- |\n{{HARDWARE_BOM_ROWS}}\n\n---\n\n## [REQUIRED] Software & Environment Invariants\n\n| Tool / Runtime | Required Version | Licensing / Cost | Fallback Offline Mode |\n| :--- | :--- | :--- | :--- |\n{{SOFTWARE_BOM_ROWS}}\n\n---\n\n## [REQUIRED] Procurement & Safety Requirements\n- \u26A0\uFE0F **Voltage & Current Constraints:** {{POWER_CONSTRAINTS}}\n- \uD83D\uDD12 **API Quota & Rate Limits:** {{API_LIMITS}}\n";
778
+
779
+ /**
780
+ * Markdown Template for Formative Exit Ticket (EXIT_TICKET)
781
+ */
782
+ declare const EXIT_TICKET_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"EXIT_TICKET\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T10\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Target Learning Objectives\"\n - \"Recall & Conceptual Anchor\"\n - \"Application & Bug Hunt\"\n - \"Metacognitive Reflection & Confidence Check\"\n - \"Scoring & Teacher Intervention Trigger\"\n---\n<!-- INJECT_BODY -->\n\n# FORMATIVE EXIT TICKET: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}} | Estimated Time: 5-7 mins_\n\n## [REQUIRED] Target Learning Objectives\n- **Target LO 1 (ULO):** {{TARGET_LO_1}}\n- **Target LO 2 (CIO/SIO):** {{TARGET_LO_2}}\n\n---\n\n## [REQUIRED] Part 1: Recall & Conceptual Anchor (Prompt 1)\n> *Objective: Test core mental model without allowing rote syntax memorization.*\n\n**Question 1:** \n{{CONCEPTUAL_QUESTION}}\n\n- **Student Answer Area:** \n ```text\n [Write 1-2 concise sentences explaining the difference in runtime mechanism]\n ```\n\n---\n\n## [REQUIRED] Part 2: Application & Bug Hunt (Prompt 2)\n> *Objective: Test code diagnosis and precise correction in \u2264 3 lines of modification.*\n\n**Code Snippet:** \n```{{CODE_LANGUAGE}}\n{{BUGGY_CODE_SNIPPET}}\n```\n\n**Task:** \n1. **Identify the Compiler/Runtime Error:** {{BUG_SYMPTOM_HINT}}\n2. **Corrected Line:** \n ```{{CODE_LANGUAGE}}\n {{CORRECTED_CODE_SLOT}}\n ```\n\n---\n\n## [REQUIRED] Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)\n> *Objective: Empower student self-regulation and provide immediate diagnostic signals.*\n\n**Traffic Light Self-Assessment:** \n- [ ] \uD83D\uDFE2 **Green (Mastered):** \"I can build and explain this concept to a peer without any hints.\"\n- [ ] \uD83D\uDFE1 **Yellow (Needs Practice):** \"I understand the concept but got stuck on syntax or error messages.\"\n- [ ] \uD83D\uDD34 **Red (Blocked):** \"I need help understanding why this architecture is used.\"\n\n**One Lingering Question (Exit Ticket Note):** \n```text\n[What is one question you still have before leaving today's lab?]\n```\n\n---\n\n## [REQUIRED] Scoring & Teacher Intervention Trigger\n- **Proficiency Threshold:** Green/Yellow check + Correct Answer to Part 2 Bug Hunt.\n- **Intervention Protocol:** {{INTERVENTION_PROTOCOL}}\n";
783
+
784
+ /**
785
+ * Markdown Template for 3-Tier Differentiated Practice (TIERED_PRACTICE)
786
+ */
787
+ declare const TIERED_PRACTICE_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"TIERED_PRACTICE\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T11\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Computational Objective & Tier Matrix\"\n - \"Bronze Tier (Foundational Scaffolding)\"\n - \"Silver Tier (Independent Application)\"\n - \"Gold Tier (Enrichment & Optimization)\"\n - \"Automated Test Verification Matrix\"\n - \"Answer Key & Mentor Hints\"\n---\n<!-- INJECT_BODY -->\n\n# 3-TIER DIFFERENTIATED PRACTICE LAB: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}} | Mode: Adaptive Lab_\n\n## [REQUIRED] Computational Objective & Tier Matrix\n\n| Tier Level | Cognitive Target (Bloom) | Scaffolding Ratio | Success Criteria |\n| :--- | :--- | :--- | :--- |\n| \uD83E\uDD49 **Bronze** | Remember / Understand | **70% Starter Code / 30% Fill-in** | Complete basic syntax & pass Baseline Unit Test. |\n| \uD83E\uDD48 **Silver** | Apply / Analyze | **30% Starter Code / 70% Implementation** | Implement business logic, edge-case handling & multi-component binding. |\n| \uD83E\uDD47 **Gold** | Evaluate / Create | **0% Code / Open Architecture** | Optimize performance, refactor with concurrency/state isolation & self-author tests. |\n\n---\n\n## [REQUIRED] \uD83E\uDD49 Bronze Tier: Foundational Scaffolding (Baseline for All)\n- **Target Audience:** All learners (mandatory milestone).\n- **Guiding Prompt:** {{BRONZE_PROMPT}}\n\n### Starter Code & Fill-in Slots:\n```{{CODE_LANGUAGE}}\n{{BRONZE_STARTER_CODE}}\n```\n\n- **Verification Check:** Run test `testBronzeBaseline()` \u2014 Expect status `PASS`.\n\n---\n\n## [REQUIRED] \uD83E\uDD48 Silver Tier: Independent Application (Target Mastery)\n- **Target Audience:** Learners who completed Bronze without mentor intervention.\n- **Guiding Prompt:** {{SILVER_PROMPT}}\n\n### Specification & Requirements:\n{{SILVER_SPECIFICATIONS}}\n\n### Implementation Target:\n```{{CODE_LANGUAGE}}\n{{SILVER_IMPLEMENTATION_SLOT}}\n```\n\n- **Verification Check:** Run test `testSilverLogicAndValidation()` \u2014 Expect status `PASS`.\n\n---\n\n## [REQUIRED] \uD83E\uDD47 Gold Tier: Enrichment & Optimization (Open Extension)\n- **Target Audience:** Advanced learners finished ahead of schedule.\n- **Architectural Challenge:** {{GOLD_CHALLENGE}}\n\n### Constraints & Invariants:\n{{GOLD_CONSTRAINTS}}\n\n---\n\n## [REQUIRED] Automated Test Verification Matrix & Mentor Hints\n```{{CODE_LANGUAGE}}\n{{TEST_HARNESS_CODE}}\n```\n\n### Mentor Debugging Cheatsheet:\n{{MENTOR_DEBUG_CHEATSHEET}}\n";
788
+ /**
789
+ * Markdown Template for 9-Square Choice Board (CHOICE_BOARD)
790
+ */
791
+ declare const CHOICE_BOARD_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"CHOICE_BOARD\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T12\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Learning Goals & Rule of Choice\"\n - \"The 9-Square Activity Matrix\"\n - \"Activity Detailed Blueprints\"\n - \"Universal Assessment Rubric\"\n---\n<!-- INJECT_BODY -->\n\n# 9-SQUARE CHOICE BOARD: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Target Competency: {{CORE_COMPETENCY}}_\n\n## [REQUIRED] Learning Goals & Rule of Choice\n- **Core Concept Anchor:** {{CORE_CONCEPT_ANCHOR}}\n- **Rule of Choice (Tic-Tac-Toe / Point Model):**\n - *Option A (Tic-Tac-Toe):* Complete 3 activities in a row (Horizontal, Vertical, or Diagonal).\n - *Option B (Point Balance):* Reach $\\ge 100\\text{ pts}$ (Choose $\\ge 1$ Technical Lab + $\\ge 1$ Explanatory/Visual + $\\ge 1$ Creative Challenge).\n\n---\n\n## [REQUIRED] The 9-Square Activity Matrix\n\n| Column 1: Analytical & Code | Column 2: Visual & Architecture | Column 3: Creative & Applied |\n| :--- | :--- | :--- |\n| **Square 1: {{SQ1_TITLE}} ({{SQ1_PTS}} pts)**<br>{{SQ1_DESC}} | **Square 2: {{SQ2_TITLE}} ({{SQ2_PTS}} pts)**<br>{{SQ2_DESC}} | **Square 3: {{SQ3_TITLE}} ({{SQ3_PTS}} pts)**<br>{{SQ3_DESC}} |\n| **Square 4: {{SQ4_TITLE}} ({{SQ4_PTS}} pts)**<br>{{SQ4_DESC}} | **\u2B50 Square 5: {{SQ5_TITLE}} ({{SQ5_PTS}} pts)**<br>{{SQ5_DESC}} | **Square 6: {{SQ6_TITLE}} ({{SQ6_PTS}} pts)**<br>{{SQ6_DESC}} |\n| **Square 7: {{SQ7_TITLE}} ({{SQ7_PTS}} pts)**<br>{{SQ7_DESC}} | **Square 8: {{SQ8_TITLE}} ({{SQ8_PTS}} pts)**<br>{{SQ8_DESC}} | **Square 9: {{SQ9_TITLE}} ({{SQ9_PTS}} pts)**<br>{{SQ9_DESC}} |\n\n---\n\n## [REQUIRED] Activity Detailed Blueprints\n\n### Detail: Square 1 \u2014 {{SQ1_TITLE}}\n{{SQ1_BLUEPRINT}}\n\n### Detail: Square 2 \u2014 {{SQ2_TITLE}}\n{{SQ2_BLUEPRINT}}\n\n### Detail: \u2B50 Square 5 \u2014 {{SQ5_TITLE}} (Mandatory Center Option)\n{{SQ5_BLUEPRINT}}\n\n---\n\n## [REQUIRED] Universal Assessment Rubric\n| Criteria | Exemplary (4) | Proficient (3) | Developing (2) | Beginning (1) |\n| :--- | :--- | :--- | :--- | :--- |\n| **Technical Accuracy** | 100% executable, idiomatic syntax, zero race conditions. | Compiles and runs; minor non-critical styling issue. | Runs with partial errors or missing edge cases. | Does not compile or contains critical syntax bugs. |\n| **Conceptual Clarity** | Explains architectural trade-offs using rigorous engineering terms. | Explains the \"how\" accurately with basic rationale. | Description is vague or confuses terminology. | Cannot explain how code works. |\n| **Creativity & Autonomy** | Goes beyond specifications with thoughtful UX or performance optimizations. | Fulfills all specified criteria independently. | Needs significant scaffolding hints to complete. | Incomplete submission. |\n";
792
+
793
+ /**
794
+ * Markdown Template for Science / Code Lab with CER Framework (SCIENCE_LAB)
795
+ */
796
+ declare const SCIENCE_LAB_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"SCIENCE_LAB\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T13\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Guiding Inquiry & Driving Question\"\n - \"Hypothesis & Experimental Design\"\n - \"Data Collection & Code Lab Protocol\"\n - \"CER Scientific Conclusion (Claim, Evidence, Reasoning)\"\n - \"Peer Review & Verification Protocol\"\n---\n<!-- INJECT_BODY -->\n\n# STEM / CODE INVESTIGATION LAB (CER): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Domain: {{DOMAIN_NAME}}_\n\n## [REQUIRED] Guiding Inquiry & Driving Question\n- **Real-World Driving Question:** {{DRIVING_QUESTION}}\n- **Engineering Phenomenon:** {{ENGINEERING_PHENOMENON}}\n\n---\n\n## [REQUIRED] Hypothesis & Experimental Design\n- **Student Hypothesis Template:** \n > *\"If we [Action / Variable Manipulation], then [Predicted Outcome] because [Scientific / Engineering Rationale].\"*\n\n### Controlled Variables:\n- **Independent Variable (Manipulated):** {{INDEPENDENT_VARIABLE}}\n- **Dependent Variable (Measured):** {{DEPENDENT_VARIABLE}}\n- **Control Variables (Constant):** {{CONTROL_VARIABLES}}\n\n---\n\n## [REQUIRED] Data Collection & Code Lab Protocol\n\n### Lab Setup & Instrumentation Code:\n```{{CODE_LANGUAGE}}\n{{BENCHMARK_PROBE_CODE}}\n```\n\n### Data Collection Table:\n| Trial | Variable State | Memory (MB) | Latency (ms) | Error / Anomaly Count |\n| :---: | :--- | :---: | :---: | :---: |\n{{DATA_COLLECTION_ROWS}}\n\n---\n\n## [REQUIRED] CER Scientific Conclusion (Claim, Evidence, Reasoning)\n\n### 1. \uD83D\uDCCC Claim (Kh\u1EB3ng \u0111\u1ECBnh):\n- *Direct answer to the driving question in 1 concise sentence:* \n ```text\n [State clear conclusion based on data]\n ```\n\n### 2. \uD83D\uDCCA Evidence (B\u1EB1ng ch\u1EE9ng s\u1ED1 li\u1EC7u):\n- *Specific quantitative data points cited directly from the Data Collection Table:* \n ```text\n [Cite concrete numerical metrics and trials]\n ```\n\n### 3. \uD83E\uDDE0 Reasoning (L\u1EADp lu\u1EADn khoa h\u1ECDc):\n- *Connect the evidence back to the underlying technical principle:* \n ```text\n [Explain why the runtime/hardware behaved this way]\n ```\n\n---\n\n## [REQUIRED] Peer Review & Verification Protocol\n- **Reproducibility Test:** Exchange code probes with another group to verify if results match within $\\pm 10\\%$ tolerance.\n";
797
+ /**
798
+ * Markdown Template for Printable Task Cards Pack (TASK_CARDS)
799
+ */
800
+ declare const TASK_CARDS_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"TASK_CARDS\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T14\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Deck Overview & Print Instructions\"\n - \"Task Cards 1 to 4 (Foundational Concepts)\"\n - \"Task Cards 5 to 8 (Code Diagnosis & Debugging)\"\n - \"Task Cards 9 to 12 (Application & Synthesis)\"\n - \"Teacher Answer Key & Scoring Matrix\"\n---\n<!-- INJECT_BODY -->\n\n# PRINTABLE TASK CARDS PACK: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Total Cards: {{CARD_COUNT}} Cards_\n\n## [REQUIRED] Deck Overview & Print Instructions\n- **Card Format:** 4 cards per page (A4 layout with cutting guidelines and QR code link).\n- **Target Skills:** Conceptual Understanding, Code Tracing, Bug Hunting, Architectural Reasoning.\n- **Scoring System:** Bronze Cards (1 pt), Silver Cards (2 pts), Gold Cards (3 pts).\n\n---\n\n## [REQUIRED] Set A: Foundational Concepts (Cards 1\u20134)\n{{TASK_CARDS_SET_A}}\n\n---\n\n## [REQUIRED] Set B: Code Diagnosis & Debugging (Cards 5\u20138)\n{{TASK_CARDS_SET_B}}\n\n---\n\n## [REQUIRED] Set C: Application & Synthesis (Cards 9\u201312)\n{{TASK_CARDS_SET_C}}\n\n---\n\n## [REQUIRED] Teacher Answer Key & Scoring Matrix\n| Card ID | Correct Answer / Solution Blueprint | Max Points |\n| :---: | :--- | :---: |\n{{TASK_CARDS_ANSWER_ROWS}}\n";
801
+
802
+ /**
803
+ * Markdown Template for Station Rotation Blended Lessons (STATION_ROTATION)
804
+ */
805
+ declare const STATION_ROTATION_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"STATION_ROTATION\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T15\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Station Architecture & Timer Overview\"\n - \"Station 1: Teacher-Led Small Group (Deep Dive)\"\n - \"Station 2: Collaborative Hands-On Lab (Peer Pair)\"\n - \"Station 3: Independent Digital Practice (Async Code)\"\n - \"Station 4: Offline Modeling & Architecture (Whiteboard)\"\n - \"Station Recording Sheet & Rotation Bell Protocol\"\n---\n<!-- INJECT_BODY -->\n\n# STATION ROTATION LESSON PACK: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: 4 Stations x 15 Mins_\n\n## [REQUIRED] Station Architecture & Timer Overview\n- **Classroom Layout:** 4 designated physical zones with clear signage and materials.\n- **Rotation Time:** 15 minutes per station + 2 minutes clean transition buffer.\n- **Audience Grouping:** Heterogeneous groups of 4-6 students rotating simultaneously.\n\n---\n\n## [REQUIRED] Station 1: Teacher-Led Small Group (Guided Inquiry)\n- **Goal:** Direct coaching, conceptual check, and resolving misconceptions in real-time.\n- **Teacher Script & Inquiry Questions:**\n{{STATION_1_GUIDANCE}}\n\n---\n\n## [REQUIRED] Station 2: Collaborative Hands-On Lab (Pair Programming)\n- **Goal:** Students work in pairs (Driver / Navigator) to solve a 2-stage challenge.\n- **Task Materials:** {{STATION_2_MATERIALS}}\n- **Success Milestone:** {{STATION_2_MILESTONE}}\n\n---\n\n## [REQUIRED] Station 3: Independent Digital Practice (Self-Paced Code Lab)\n- **Goal:** Autonomy and individual mastery verification.\n- **Student Instructions:**\n{{STATION_3_INSTRUCTIONS}}\n\n---\n\n## [REQUIRED] Station 4: Offline Modeling & Architecture (No Screens)\n- **Goal:** Cognitive unloading and physical spatial reasoning.\n- **Materials:** Whiteboard markers, physical Task Cards deck, and laminated architecture templates.\n- **Task:** {{STATION_4_TASK}}\n\n---\n\n## [REQUIRED] Station Recording Sheet (Student Passport)\n| Station | Task Completed | Signature / Verification Stamp | 1 Key Insight Learned |\n| :---: | :--- | :--- | :--- |\n| **1 (Teacher)** | Debugging Probe Discussion | [Teacher Stamp] | |\n| **2 (Pair Lab)** | Stage 1 & 2 Test Suite | [Peer Signature] | |\n| **3 (Digital)** | Micro-Challenges Token | [Auto Token] | |\n| **4 (Offline)** | Flowchart Diagram Approved | [Mentor Stamp] | |\n";
806
+ /**
807
+ * Markdown Template for Weekly Bell Ringers (BELL_RINGER)
808
+ */
809
+ declare const BELL_RINGER_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"BELL_RINGER\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T16\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Weekly Objective & Schedule\"\n - \"Monday: Mental Model Recall\"\n - \"Tuesday: Code Spot-Check\"\n - \"Wednesday: Bug Hunt & Fix\"\n - \"Thursday: Architecture Tracing\"\n - \"Friday: Creative Synthesis & Bridge\"\n - \"Answer Key & Scoring Guide\"\n---\n<!-- INJECT_BODY -->\n\n# WEEKLY BELL RINGERS (5-DAY WARM-UP PACK): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Time: 3-5 Mins per Session_\n\n## [REQUIRED] Weekly Objective & Schedule\n- **Weekly Core Theme:** {{WEEKLY_THEME}}\n- **Routine Protocol:** Display prompt on projector immediately as students enter.\n\n---\n\n## [REQUIRED] Day 1 (Monday): Mental Model Recall & Analogy\n{{DAY_1_PROMPT}}\n\n---\n\n## [REQUIRED] Day 2 (Tuesday): Rapid Code Tracing\n{{DAY_2_PROMPT}}\n\n---\n\n## [REQUIRED] Day 3 (Wednesday): Quick Bug Hunt (Spot the Defect)\n{{DAY_3_PROMPT}}\n\n---\n\n## [REQUIRED] Day 4 (Thursday): Visual Diagram Tracing\n{{DAY_4_PROMPT}}\n\n---\n\n## [REQUIRED] Day 5 (Friday): Creative Synthesis & Bridge Forward\n{{DAY_5_PROMPT}}\n\n---\n\n## [REQUIRED] Teacher Answer Key & Scoring Guide\n{{TEACHER_ANSWER_KEY}}\n";
810
+ /**
811
+ * Markdown Template for Interactive Review Game (REVIEW_GAME)
812
+ */
813
+ declare const REVIEW_GAME_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"REVIEW_GAME\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T17\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Game Rules & Setup Guide\"\n - \"Round 1: Speed Round (100-200 Pts)\"\n - \"Round 2: Code Duel & Debugging (300-400 Pts)\"\n - \"Round 3: Final Boss Architecture Challenge (500 Pts)\"\n - \"Kahoot / Quizizz CSV Export Format\"\n---\n<!-- INJECT_BODY -->\n\n# INTERACTIVE REVIEW GAME (QUIZ SHOW PACK): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Live Classroom Quiz Show_\n\n## [REQUIRED] Game Rules & Setup Guide\n- **Format:** 3 Rounds of progressive difficulty with team buzzers.\n- **Team Size:** 3-5 students per squad.\n\n---\n\n## [REQUIRED] Round 1: Rapid-Fire Speed Round (100\u2013200 Points)\n{{ROUND_1_QUESTIONS}}\n\n---\n\n## [REQUIRED] Round 2: Code Duel & Debugging (300\u2013400 Points)\n{{ROUND_2_CHALLENGES}}\n\n---\n\n## [REQUIRED] Round 3: Final Boss Architecture Challenge (500 Points)\n{{ROUND_3_BOSS_CHALLENGE}}\n\n---\n\n## [REQUIRED] Kahoot / Quizizz CSV Export Format\n```csv\n{{KAHOOT_CSV_CONTENT}}\n```\n";
814
+ /**
815
+ * Markdown Template for Visual Graphic Organizers (GRAPHIC_ORGANIZER)
816
+ */
817
+ declare const GRAPHIC_ORGANIZER_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"GRAPHIC_ORGANIZER\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T18\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Visual Paradigm Overview\"\n - \"Organizer 1: Architectural Data Flow (Mermaid Flowchart)\"\n - \"Organizer 2: Comparative Analysis (Mermaid / Markdown Venn)\"\n - \"Organizer 3: State Machine & Lifecycle (Mermaid StateDiagram)\"\n - \"Student Fill-in Worksheet Format\"\n---\n<!-- INJECT_BODY -->\n\n# VISUAL GRAPHIC ORGANIZERS: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Mermaid Diagrams + Printable Handouts_\n\n## [REQUIRED] Visual Paradigm Overview\n- **Cognitive Purpose:** Unload mental processing burden through spatial diagramming.\n\n---\n\n## [REQUIRED] Organizer 1: Architectural Data Flow (Mermaid Flowchart)\n```mermaid\n{{MERMAID_FLOWCHART}}\n```\n\n---\n\n## [REQUIRED] Organizer 2: Comparative Analysis (Venn Diagram / Matrix)\n```mermaid\n{{MERMAID_VENN_OR_MATRIX}}\n```\n\n---\n\n## [REQUIRED] Organizer 3: State Machine & Lifecycle (State Diagram)\n```mermaid\n{{MERMAID_STATE_DIAGRAM}}\n```\n\n---\n\n## [REQUIRED] Student Fill-in Worksheet Format (Offline Handout)\n{{OFFLINE_WORKSHEET_FORMAT}}\n";
818
+
819
+ /**
820
+ * @learnwell/curriculum-kit — Slide Layout Presets & Single-Page Slide Templates
821
+ *
822
+ * Reusable catalog of production-ready single slide templates with Marp YAML layout comments,
823
+ * presenter notes, and pedagogical structures for curriculum authoring & LLM generation.
824
+ */
825
+ type SlideLayoutCategory = 'cover' | 'content' | 'split' | 'code' | 'metrics' | 'diagram' | 'quote' | 'assessment';
826
+ interface LayoutBoxConfig {
827
+ id: string;
828
+ target?: string;
829
+ pos: [number, number, number, number];
830
+ fontSize?: string;
831
+ color?: string;
832
+ textAlign?: 'left' | 'center' | 'right' | 'justify';
833
+ style?: string;
834
+ }
835
+ interface SlideLayoutData {
836
+ boxes: LayoutBoxConfig[];
837
+ }
838
+ interface SlideLayoutPreset {
839
+ id: string;
840
+ name: string;
841
+ category: SlideLayoutCategory;
842
+ description: string;
843
+ layout: SlideLayoutData;
844
+ markdownSnippet: string;
845
+ }
846
+ declare const SLIDE_LAYOUT_PRESETS: SlideLayoutPreset[];
847
+ /**
848
+ * Find a preset by its unique ID
849
+ */
850
+ declare function getSlideLayoutPresetById(id: string): SlideLayoutPreset | undefined;
851
+ /**
852
+ * Filter presets by category
853
+ */
854
+ declare function getSlideLayoutPresetsByCategory(category: SlideLayoutCategory): SlideLayoutPreset[];
855
+
856
+ export { ACT_TEMPLATE, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DependencyEdge, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, HANDOUT_TEMPLATE, ICurriculumStorage, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, type SlashCommandDefinition, SlideDeck, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, SmartResumeContext, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildSessionSliceContext, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, expositionCacheKey, extractScopeSequenceRows, extractSessionSlice, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, topoSort };
package/dist/index.d.ts CHANGED
@@ -696,4 +696,161 @@ declare class MisconceptionEvaluator {
696
696
  static evaluateQuiz(quiz: DiagnosticQuiz): DimensionScore;
697
697
  }
698
698
 
699
- export { ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactProductionSpec, type AuditBundleInput, BLOOM_ACTION_VERBS, BloomTaxonomyEvaluator, type BuildContextOptions, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DependencyEdge, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXPOSITION_REL, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, type GenerateExpositionOptions, ICurriculumStorage, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QualityAuditReport, ResolvedGateSettings, type SlashCommandDefinition, SlideDeck, SmartResumeContext, TranslationPolicy, type TranslationTarget, type TranslationTrigger, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildSessionSliceContext, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, expositionCacheKey, extractScopeSequenceRows, extractSessionSlice, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, topoSort };
699
+ /**
700
+ * Markdown Template for Master Lesson Plan (5E Model)
701
+ * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/LESSON_5E_template.md
702
+ */
703
+ declare const LESSON_PLAN_TEMPLATE: string;
704
+
705
+ /**
706
+ * Markdown Template for Inquiry-Based Activity (ACT)
707
+ * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/ACT_template.md
708
+ */
709
+ declare const ACT_TEMPLATE: string;
710
+
711
+ /**
712
+ * Markdown Template for Code Lab (LAB)
713
+ * 100% English Template Structure (Ported from /Users/tonypham/MEGA/ai-platform/my-mcp/_templates/LAB_TEMPLATE.md)
714
+ */
715
+ declare const CODE_LAB_TEMPLATE: string;
716
+
717
+ /**
718
+ * Markdown Template for Student Handout (5-Second Rule Cheat Sheet)
719
+ * 100% English Template Structure (Ported from /Users/tonypham/MEGA/ai-platform/my-mcp/_templates/HANDOUT_template.md)
720
+ */
721
+ declare const HANDOUT_TEMPLATE: string;
722
+
723
+ /**
724
+ * Markdown Template for Presentation Slides Deck (SLIDE)
725
+ * Powered by Marp — Built on Chunky Micro-Cycle Learning (Learn-Apply-Validate Loops)
726
+ */
727
+ declare const SLIDE_TEMPLATE: string;
728
+
729
+ /**
730
+ * Markdown Template for Student Worksheet (WKS)
731
+ * 100% English Template Structure (Ported from /Users/tonypham/MEGA/ai-platform/my-mcp/_templates/WKS_template.md)
732
+ */
733
+ declare const WORKSHEET_TEMPLATE: string;
734
+
735
+ /**
736
+ * Markdown Template for Instructable-style Project Tutorial
737
+ * 100% English Template Structure (Ported from researcher/prompts/tutorial.md & my-mcp)
738
+ */
739
+ declare const PROJECT_INSTRUCTION_TEMPLATE: string;
740
+
741
+ /**
742
+ * Markdown Template for Assessment Rubric (RUBRIC)
743
+ * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/RUBRIC_template.md
744
+ */
745
+ declare const RUBRIC_TEMPLATE: string;
746
+
747
+ /**
748
+ * Markdown Template for Teacher Guide (GUIDE)
749
+ * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/GUIDE_template.md
750
+ */
751
+ declare const TEACHER_GUIDE_TEMPLATE: string;
752
+
753
+ /**
754
+ * Markdown Template for Self-Paced Hands-on Lab (SELF_LAB)
755
+ * Features Progressive Hints System (Accordion/Spoilers) & Automated Verification Commands
756
+ */
757
+ declare const SELF_LAB_TEMPLATE: string;
758
+
759
+ /**
760
+ * Markdown Template for Diagnostic & Active Recall Quiz (QUIZ)
761
+ * Compatible with @thanh01.pmt/interactive-quiz-kit standard
762
+ */
763
+ declare const QUIZ_TEMPLATE: string;
764
+
765
+ /**
766
+ * Markdown Template for Extension Challenge (EXT)
767
+ */
768
+ declare const EXT_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"EXT\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T8\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Target Mastery & Acceleration\"\n - \"Challenge 1\"\n - \"Challenge 2\"\n - \"Verification Criteria\"\n---\n<!-- INJECT_BODY -->\n\n# EXTENSION CHALLENGES: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}}_\n\n## [REQUIRED] Target Mastery & Acceleration\n> *Designed for advanced learners who have successfully completed the core lesson requirements ahead of schedule.*\n\n---\n\n## [REQUIRED] Challenge 1: {{CHALLENGE_1_TITLE}} (Difficulty: \u2B50\u2B50\u2B50)\n- **Problem Statement:** {{CHALLENGE_1_DESCRIPTION}}\n- **Architectural Clues & Hints:**\n{{CHALLENGE_1_HINTS}}\n- **Expected Outcome & Deliverable:** {{CHALLENGE_1_OUTCOME}}\n\n---\n\n## [REQUIRED] Challenge 2: {{CHALLENGE_2_TITLE}} (Difficulty: \u2B50\u2B50\u2B50\u2B50)\n- **Problem Statement:** {{CHALLENGE_2_DESCRIPTION}}\n- **Architectural Clues & Hints:**\n{{CHALLENGE_2_HINTS}}\n- **Expected Outcome & Deliverable:** {{CHALLENGE_2_OUTCOME}}\n\n---\n\n## [REQUIRED] Verification Criteria\n- [ ] Code passes all extended unit tests.\n- [ ] No regression introduced into core components.\n- [ ] Demonstrates high-order optimization or architectural separation.\n";
769
+
770
+ /**
771
+ * Markdown Template for Technical Glossary (GLOSSARY)
772
+ */
773
+ declare const GLOSSARY_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"GLOSSARY\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T9\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Core Technical Terminology\"\n - \"Conceptual Analogies & Non-examples\"\n - \"Cross-Technology Crosswalk\"\n---\n<!-- INJECT_BODY -->\n\n# TECHNICAL GLOSSARY & VOCABULARY: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Reference Standard: CS2023_\n\n## [REQUIRED] Core Technical Terminology\n\n| Term / Keyword | Formal Engineering Definition | Code Usage Context | Common Misconception |\n| :--- | :--- | :--- | :--- |\n{{GLOSSARY_TABLE_ROWS}}\n\n---\n\n## [REQUIRED] Conceptual Analogies & Non-examples\n\n{{ANALOGY_SECTIONS}}\n\n---\n\n## [REQUIRED] Cross-Technology Crosswalk (Neutral vs. Specific)\n\n| Universal Concept (Marr Level 1/2) | Target Language Syntax (Level 3) | Alternative Language Equivalent |\n| :--- | :--- | :--- |\n{{CROSSWALK_ROWS}}\n";
774
+ /**
775
+ * Markdown Template for Bill of Materials (BOM)
776
+ */
777
+ declare const BOM_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"BOM\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T6\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Hardware & Sensor Specification\"\n - \"Software & Environment Invariants\"\n - \"Procurement & Safety Requirements\"\n---\n<!-- INJECT_BODY -->\n\n# BILL OF MATERIALS & LAB PREREQUISITES: {{TITLE}}\n_Unit: {{UNIT_ID}} | Target Class Size: {{CLASS_SIZE}} Students_\n\n## [REQUIRED] Hardware & Sensor Specification\n\n| Item Code | Component Name | Required Qty per Student/Group | Min Spec / Pinout | Alternative Substitute |\n| :--- | :--- | :--- | :--- | :--- |\n{{HARDWARE_BOM_ROWS}}\n\n---\n\n## [REQUIRED] Software & Environment Invariants\n\n| Tool / Runtime | Required Version | Licensing / Cost | Fallback Offline Mode |\n| :--- | :--- | :--- | :--- |\n{{SOFTWARE_BOM_ROWS}}\n\n---\n\n## [REQUIRED] Procurement & Safety Requirements\n- \u26A0\uFE0F **Voltage & Current Constraints:** {{POWER_CONSTRAINTS}}\n- \uD83D\uDD12 **API Quota & Rate Limits:** {{API_LIMITS}}\n";
778
+
779
+ /**
780
+ * Markdown Template for Formative Exit Ticket (EXIT_TICKET)
781
+ */
782
+ declare const EXIT_TICKET_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"EXIT_TICKET\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T10\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Target Learning Objectives\"\n - \"Recall & Conceptual Anchor\"\n - \"Application & Bug Hunt\"\n - \"Metacognitive Reflection & Confidence Check\"\n - \"Scoring & Teacher Intervention Trigger\"\n---\n<!-- INJECT_BODY -->\n\n# FORMATIVE EXIT TICKET: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}} | Estimated Time: 5-7 mins_\n\n## [REQUIRED] Target Learning Objectives\n- **Target LO 1 (ULO):** {{TARGET_LO_1}}\n- **Target LO 2 (CIO/SIO):** {{TARGET_LO_2}}\n\n---\n\n## [REQUIRED] Part 1: Recall & Conceptual Anchor (Prompt 1)\n> *Objective: Test core mental model without allowing rote syntax memorization.*\n\n**Question 1:** \n{{CONCEPTUAL_QUESTION}}\n\n- **Student Answer Area:** \n ```text\n [Write 1-2 concise sentences explaining the difference in runtime mechanism]\n ```\n\n---\n\n## [REQUIRED] Part 2: Application & Bug Hunt (Prompt 2)\n> *Objective: Test code diagnosis and precise correction in \u2264 3 lines of modification.*\n\n**Code Snippet:** \n```{{CODE_LANGUAGE}}\n{{BUGGY_CODE_SNIPPET}}\n```\n\n**Task:** \n1. **Identify the Compiler/Runtime Error:** {{BUG_SYMPTOM_HINT}}\n2. **Corrected Line:** \n ```{{CODE_LANGUAGE}}\n {{CORRECTED_CODE_SLOT}}\n ```\n\n---\n\n## [REQUIRED] Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)\n> *Objective: Empower student self-regulation and provide immediate diagnostic signals.*\n\n**Traffic Light Self-Assessment:** \n- [ ] \uD83D\uDFE2 **Green (Mastered):** \"I can build and explain this concept to a peer without any hints.\"\n- [ ] \uD83D\uDFE1 **Yellow (Needs Practice):** \"I understand the concept but got stuck on syntax or error messages.\"\n- [ ] \uD83D\uDD34 **Red (Blocked):** \"I need help understanding why this architecture is used.\"\n\n**One Lingering Question (Exit Ticket Note):** \n```text\n[What is one question you still have before leaving today's lab?]\n```\n\n---\n\n## [REQUIRED] Scoring & Teacher Intervention Trigger\n- **Proficiency Threshold:** Green/Yellow check + Correct Answer to Part 2 Bug Hunt.\n- **Intervention Protocol:** {{INTERVENTION_PROTOCOL}}\n";
783
+
784
+ /**
785
+ * Markdown Template for 3-Tier Differentiated Practice (TIERED_PRACTICE)
786
+ */
787
+ declare const TIERED_PRACTICE_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"TIERED_PRACTICE\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T11\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Computational Objective & Tier Matrix\"\n - \"Bronze Tier (Foundational Scaffolding)\"\n - \"Silver Tier (Independent Application)\"\n - \"Gold Tier (Enrichment & Optimization)\"\n - \"Automated Test Verification Matrix\"\n - \"Answer Key & Mentor Hints\"\n---\n<!-- INJECT_BODY -->\n\n# 3-TIER DIFFERENTIATED PRACTICE LAB: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}} | Mode: Adaptive Lab_\n\n## [REQUIRED] Computational Objective & Tier Matrix\n\n| Tier Level | Cognitive Target (Bloom) | Scaffolding Ratio | Success Criteria |\n| :--- | :--- | :--- | :--- |\n| \uD83E\uDD49 **Bronze** | Remember / Understand | **70% Starter Code / 30% Fill-in** | Complete basic syntax & pass Baseline Unit Test. |\n| \uD83E\uDD48 **Silver** | Apply / Analyze | **30% Starter Code / 70% Implementation** | Implement business logic, edge-case handling & multi-component binding. |\n| \uD83E\uDD47 **Gold** | Evaluate / Create | **0% Code / Open Architecture** | Optimize performance, refactor with concurrency/state isolation & self-author tests. |\n\n---\n\n## [REQUIRED] \uD83E\uDD49 Bronze Tier: Foundational Scaffolding (Baseline for All)\n- **Target Audience:** All learners (mandatory milestone).\n- **Guiding Prompt:** {{BRONZE_PROMPT}}\n\n### Starter Code & Fill-in Slots:\n```{{CODE_LANGUAGE}}\n{{BRONZE_STARTER_CODE}}\n```\n\n- **Verification Check:** Run test `testBronzeBaseline()` \u2014 Expect status `PASS`.\n\n---\n\n## [REQUIRED] \uD83E\uDD48 Silver Tier: Independent Application (Target Mastery)\n- **Target Audience:** Learners who completed Bronze without mentor intervention.\n- **Guiding Prompt:** {{SILVER_PROMPT}}\n\n### Specification & Requirements:\n{{SILVER_SPECIFICATIONS}}\n\n### Implementation Target:\n```{{CODE_LANGUAGE}}\n{{SILVER_IMPLEMENTATION_SLOT}}\n```\n\n- **Verification Check:** Run test `testSilverLogicAndValidation()` \u2014 Expect status `PASS`.\n\n---\n\n## [REQUIRED] \uD83E\uDD47 Gold Tier: Enrichment & Optimization (Open Extension)\n- **Target Audience:** Advanced learners finished ahead of schedule.\n- **Architectural Challenge:** {{GOLD_CHALLENGE}}\n\n### Constraints & Invariants:\n{{GOLD_CONSTRAINTS}}\n\n---\n\n## [REQUIRED] Automated Test Verification Matrix & Mentor Hints\n```{{CODE_LANGUAGE}}\n{{TEST_HARNESS_CODE}}\n```\n\n### Mentor Debugging Cheatsheet:\n{{MENTOR_DEBUG_CHEATSHEET}}\n";
788
+ /**
789
+ * Markdown Template for 9-Square Choice Board (CHOICE_BOARD)
790
+ */
791
+ declare const CHOICE_BOARD_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"CHOICE_BOARD\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T12\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Learning Goals & Rule of Choice\"\n - \"The 9-Square Activity Matrix\"\n - \"Activity Detailed Blueprints\"\n - \"Universal Assessment Rubric\"\n---\n<!-- INJECT_BODY -->\n\n# 9-SQUARE CHOICE BOARD: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Target Competency: {{CORE_COMPETENCY}}_\n\n## [REQUIRED] Learning Goals & Rule of Choice\n- **Core Concept Anchor:** {{CORE_CONCEPT_ANCHOR}}\n- **Rule of Choice (Tic-Tac-Toe / Point Model):**\n - *Option A (Tic-Tac-Toe):* Complete 3 activities in a row (Horizontal, Vertical, or Diagonal).\n - *Option B (Point Balance):* Reach $\\ge 100\\text{ pts}$ (Choose $\\ge 1$ Technical Lab + $\\ge 1$ Explanatory/Visual + $\\ge 1$ Creative Challenge).\n\n---\n\n## [REQUIRED] The 9-Square Activity Matrix\n\n| Column 1: Analytical & Code | Column 2: Visual & Architecture | Column 3: Creative & Applied |\n| :--- | :--- | :--- |\n| **Square 1: {{SQ1_TITLE}} ({{SQ1_PTS}} pts)**<br>{{SQ1_DESC}} | **Square 2: {{SQ2_TITLE}} ({{SQ2_PTS}} pts)**<br>{{SQ2_DESC}} | **Square 3: {{SQ3_TITLE}} ({{SQ3_PTS}} pts)**<br>{{SQ3_DESC}} |\n| **Square 4: {{SQ4_TITLE}} ({{SQ4_PTS}} pts)**<br>{{SQ4_DESC}} | **\u2B50 Square 5: {{SQ5_TITLE}} ({{SQ5_PTS}} pts)**<br>{{SQ5_DESC}} | **Square 6: {{SQ6_TITLE}} ({{SQ6_PTS}} pts)**<br>{{SQ6_DESC}} |\n| **Square 7: {{SQ7_TITLE}} ({{SQ7_PTS}} pts)**<br>{{SQ7_DESC}} | **Square 8: {{SQ8_TITLE}} ({{SQ8_PTS}} pts)**<br>{{SQ8_DESC}} | **Square 9: {{SQ9_TITLE}} ({{SQ9_PTS}} pts)**<br>{{SQ9_DESC}} |\n\n---\n\n## [REQUIRED] Activity Detailed Blueprints\n\n### Detail: Square 1 \u2014 {{SQ1_TITLE}}\n{{SQ1_BLUEPRINT}}\n\n### Detail: Square 2 \u2014 {{SQ2_TITLE}}\n{{SQ2_BLUEPRINT}}\n\n### Detail: \u2B50 Square 5 \u2014 {{SQ5_TITLE}} (Mandatory Center Option)\n{{SQ5_BLUEPRINT}}\n\n---\n\n## [REQUIRED] Universal Assessment Rubric\n| Criteria | Exemplary (4) | Proficient (3) | Developing (2) | Beginning (1) |\n| :--- | :--- | :--- | :--- | :--- |\n| **Technical Accuracy** | 100% executable, idiomatic syntax, zero race conditions. | Compiles and runs; minor non-critical styling issue. | Runs with partial errors or missing edge cases. | Does not compile or contains critical syntax bugs. |\n| **Conceptual Clarity** | Explains architectural trade-offs using rigorous engineering terms. | Explains the \"how\" accurately with basic rationale. | Description is vague or confuses terminology. | Cannot explain how code works. |\n| **Creativity & Autonomy** | Goes beyond specifications with thoughtful UX or performance optimizations. | Fulfills all specified criteria independently. | Needs significant scaffolding hints to complete. | Incomplete submission. |\n";
792
+
793
+ /**
794
+ * Markdown Template for Science / Code Lab with CER Framework (SCIENCE_LAB)
795
+ */
796
+ declare const SCIENCE_LAB_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"SCIENCE_LAB\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T13\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Guiding Inquiry & Driving Question\"\n - \"Hypothesis & Experimental Design\"\n - \"Data Collection & Code Lab Protocol\"\n - \"CER Scientific Conclusion (Claim, Evidence, Reasoning)\"\n - \"Peer Review & Verification Protocol\"\n---\n<!-- INJECT_BODY -->\n\n# STEM / CODE INVESTIGATION LAB (CER): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Domain: {{DOMAIN_NAME}}_\n\n## [REQUIRED] Guiding Inquiry & Driving Question\n- **Real-World Driving Question:** {{DRIVING_QUESTION}}\n- **Engineering Phenomenon:** {{ENGINEERING_PHENOMENON}}\n\n---\n\n## [REQUIRED] Hypothesis & Experimental Design\n- **Student Hypothesis Template:** \n > *\"If we [Action / Variable Manipulation], then [Predicted Outcome] because [Scientific / Engineering Rationale].\"*\n\n### Controlled Variables:\n- **Independent Variable (Manipulated):** {{INDEPENDENT_VARIABLE}}\n- **Dependent Variable (Measured):** {{DEPENDENT_VARIABLE}}\n- **Control Variables (Constant):** {{CONTROL_VARIABLES}}\n\n---\n\n## [REQUIRED] Data Collection & Code Lab Protocol\n\n### Lab Setup & Instrumentation Code:\n```{{CODE_LANGUAGE}}\n{{BENCHMARK_PROBE_CODE}}\n```\n\n### Data Collection Table:\n| Trial | Variable State | Memory (MB) | Latency (ms) | Error / Anomaly Count |\n| :---: | :--- | :---: | :---: | :---: |\n{{DATA_COLLECTION_ROWS}}\n\n---\n\n## [REQUIRED] CER Scientific Conclusion (Claim, Evidence, Reasoning)\n\n### 1. \uD83D\uDCCC Claim (Kh\u1EB3ng \u0111\u1ECBnh):\n- *Direct answer to the driving question in 1 concise sentence:* \n ```text\n [State clear conclusion based on data]\n ```\n\n### 2. \uD83D\uDCCA Evidence (B\u1EB1ng ch\u1EE9ng s\u1ED1 li\u1EC7u):\n- *Specific quantitative data points cited directly from the Data Collection Table:* \n ```text\n [Cite concrete numerical metrics and trials]\n ```\n\n### 3. \uD83E\uDDE0 Reasoning (L\u1EADp lu\u1EADn khoa h\u1ECDc):\n- *Connect the evidence back to the underlying technical principle:* \n ```text\n [Explain why the runtime/hardware behaved this way]\n ```\n\n---\n\n## [REQUIRED] Peer Review & Verification Protocol\n- **Reproducibility Test:** Exchange code probes with another group to verify if results match within $\\pm 10\\%$ tolerance.\n";
797
+ /**
798
+ * Markdown Template for Printable Task Cards Pack (TASK_CARDS)
799
+ */
800
+ declare const TASK_CARDS_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"TASK_CARDS\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T14\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Deck Overview & Print Instructions\"\n - \"Task Cards 1 to 4 (Foundational Concepts)\"\n - \"Task Cards 5 to 8 (Code Diagnosis & Debugging)\"\n - \"Task Cards 9 to 12 (Application & Synthesis)\"\n - \"Teacher Answer Key & Scoring Matrix\"\n---\n<!-- INJECT_BODY -->\n\n# PRINTABLE TASK CARDS PACK: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Total Cards: {{CARD_COUNT}} Cards_\n\n## [REQUIRED] Deck Overview & Print Instructions\n- **Card Format:** 4 cards per page (A4 layout with cutting guidelines and QR code link).\n- **Target Skills:** Conceptual Understanding, Code Tracing, Bug Hunting, Architectural Reasoning.\n- **Scoring System:** Bronze Cards (1 pt), Silver Cards (2 pts), Gold Cards (3 pts).\n\n---\n\n## [REQUIRED] Set A: Foundational Concepts (Cards 1\u20134)\n{{TASK_CARDS_SET_A}}\n\n---\n\n## [REQUIRED] Set B: Code Diagnosis & Debugging (Cards 5\u20138)\n{{TASK_CARDS_SET_B}}\n\n---\n\n## [REQUIRED] Set C: Application & Synthesis (Cards 9\u201312)\n{{TASK_CARDS_SET_C}}\n\n---\n\n## [REQUIRED] Teacher Answer Key & Scoring Matrix\n| Card ID | Correct Answer / Solution Blueprint | Max Points |\n| :---: | :--- | :---: |\n{{TASK_CARDS_ANSWER_ROWS}}\n";
801
+
802
+ /**
803
+ * Markdown Template for Station Rotation Blended Lessons (STATION_ROTATION)
804
+ */
805
+ declare const STATION_ROTATION_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"STATION_ROTATION\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T15\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Station Architecture & Timer Overview\"\n - \"Station 1: Teacher-Led Small Group (Deep Dive)\"\n - \"Station 2: Collaborative Hands-On Lab (Peer Pair)\"\n - \"Station 3: Independent Digital Practice (Async Code)\"\n - \"Station 4: Offline Modeling & Architecture (Whiteboard)\"\n - \"Station Recording Sheet & Rotation Bell Protocol\"\n---\n<!-- INJECT_BODY -->\n\n# STATION ROTATION LESSON PACK: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: 4 Stations x 15 Mins_\n\n## [REQUIRED] Station Architecture & Timer Overview\n- **Classroom Layout:** 4 designated physical zones with clear signage and materials.\n- **Rotation Time:** 15 minutes per station + 2 minutes clean transition buffer.\n- **Audience Grouping:** Heterogeneous groups of 4-6 students rotating simultaneously.\n\n---\n\n## [REQUIRED] Station 1: Teacher-Led Small Group (Guided Inquiry)\n- **Goal:** Direct coaching, conceptual check, and resolving misconceptions in real-time.\n- **Teacher Script & Inquiry Questions:**\n{{STATION_1_GUIDANCE}}\n\n---\n\n## [REQUIRED] Station 2: Collaborative Hands-On Lab (Pair Programming)\n- **Goal:** Students work in pairs (Driver / Navigator) to solve a 2-stage challenge.\n- **Task Materials:** {{STATION_2_MATERIALS}}\n- **Success Milestone:** {{STATION_2_MILESTONE}}\n\n---\n\n## [REQUIRED] Station 3: Independent Digital Practice (Self-Paced Code Lab)\n- **Goal:** Autonomy and individual mastery verification.\n- **Student Instructions:**\n{{STATION_3_INSTRUCTIONS}}\n\n---\n\n## [REQUIRED] Station 4: Offline Modeling & Architecture (No Screens)\n- **Goal:** Cognitive unloading and physical spatial reasoning.\n- **Materials:** Whiteboard markers, physical Task Cards deck, and laminated architecture templates.\n- **Task:** {{STATION_4_TASK}}\n\n---\n\n## [REQUIRED] Station Recording Sheet (Student Passport)\n| Station | Task Completed | Signature / Verification Stamp | 1 Key Insight Learned |\n| :---: | :--- | :--- | :--- |\n| **1 (Teacher)** | Debugging Probe Discussion | [Teacher Stamp] | |\n| **2 (Pair Lab)** | Stage 1 & 2 Test Suite | [Peer Signature] | |\n| **3 (Digital)** | Micro-Challenges Token | [Auto Token] | |\n| **4 (Offline)** | Flowchart Diagram Approved | [Mentor Stamp] | |\n";
806
+ /**
807
+ * Markdown Template for Weekly Bell Ringers (BELL_RINGER)
808
+ */
809
+ declare const BELL_RINGER_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"BELL_RINGER\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T16\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Weekly Objective & Schedule\"\n - \"Monday: Mental Model Recall\"\n - \"Tuesday: Code Spot-Check\"\n - \"Wednesday: Bug Hunt & Fix\"\n - \"Thursday: Architecture Tracing\"\n - \"Friday: Creative Synthesis & Bridge\"\n - \"Answer Key & Scoring Guide\"\n---\n<!-- INJECT_BODY -->\n\n# WEEKLY BELL RINGERS (5-DAY WARM-UP PACK): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Time: 3-5 Mins per Session_\n\n## [REQUIRED] Weekly Objective & Schedule\n- **Weekly Core Theme:** {{WEEKLY_THEME}}\n- **Routine Protocol:** Display prompt on projector immediately as students enter.\n\n---\n\n## [REQUIRED] Day 1 (Monday): Mental Model Recall & Analogy\n{{DAY_1_PROMPT}}\n\n---\n\n## [REQUIRED] Day 2 (Tuesday): Rapid Code Tracing\n{{DAY_2_PROMPT}}\n\n---\n\n## [REQUIRED] Day 3 (Wednesday): Quick Bug Hunt (Spot the Defect)\n{{DAY_3_PROMPT}}\n\n---\n\n## [REQUIRED] Day 4 (Thursday): Visual Diagram Tracing\n{{DAY_4_PROMPT}}\n\n---\n\n## [REQUIRED] Day 5 (Friday): Creative Synthesis & Bridge Forward\n{{DAY_5_PROMPT}}\n\n---\n\n## [REQUIRED] Teacher Answer Key & Scoring Guide\n{{TEACHER_ANSWER_KEY}}\n";
810
+ /**
811
+ * Markdown Template for Interactive Review Game (REVIEW_GAME)
812
+ */
813
+ declare const REVIEW_GAME_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"REVIEW_GAME\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T17\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Game Rules & Setup Guide\"\n - \"Round 1: Speed Round (100-200 Pts)\"\n - \"Round 2: Code Duel & Debugging (300-400 Pts)\"\n - \"Round 3: Final Boss Architecture Challenge (500 Pts)\"\n - \"Kahoot / Quizizz CSV Export Format\"\n---\n<!-- INJECT_BODY -->\n\n# INTERACTIVE REVIEW GAME (QUIZ SHOW PACK): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Live Classroom Quiz Show_\n\n## [REQUIRED] Game Rules & Setup Guide\n- **Format:** 3 Rounds of progressive difficulty with team buzzers.\n- **Team Size:** 3-5 students per squad.\n\n---\n\n## [REQUIRED] Round 1: Rapid-Fire Speed Round (100\u2013200 Points)\n{{ROUND_1_QUESTIONS}}\n\n---\n\n## [REQUIRED] Round 2: Code Duel & Debugging (300\u2013400 Points)\n{{ROUND_2_CHALLENGES}}\n\n---\n\n## [REQUIRED] Round 3: Final Boss Architecture Challenge (500 Points)\n{{ROUND_3_BOSS_CHALLENGE}}\n\n---\n\n## [REQUIRED] Kahoot / Quizizz CSV Export Format\n```csv\n{{KAHOOT_CSV_CONTENT}}\n```\n";
814
+ /**
815
+ * Markdown Template for Visual Graphic Organizers (GRAPHIC_ORGANIZER)
816
+ */
817
+ declare const GRAPHIC_ORGANIZER_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"GRAPHIC_ORGANIZER\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T18\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n - \"Visual Paradigm Overview\"\n - \"Organizer 1: Architectural Data Flow (Mermaid Flowchart)\"\n - \"Organizer 2: Comparative Analysis (Mermaid / Markdown Venn)\"\n - \"Organizer 3: State Machine & Lifecycle (Mermaid StateDiagram)\"\n - \"Student Fill-in Worksheet Format\"\n---\n<!-- INJECT_BODY -->\n\n# VISUAL GRAPHIC ORGANIZERS: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Mermaid Diagrams + Printable Handouts_\n\n## [REQUIRED] Visual Paradigm Overview\n- **Cognitive Purpose:** Unload mental processing burden through spatial diagramming.\n\n---\n\n## [REQUIRED] Organizer 1: Architectural Data Flow (Mermaid Flowchart)\n```mermaid\n{{MERMAID_FLOWCHART}}\n```\n\n---\n\n## [REQUIRED] Organizer 2: Comparative Analysis (Venn Diagram / Matrix)\n```mermaid\n{{MERMAID_VENN_OR_MATRIX}}\n```\n\n---\n\n## [REQUIRED] Organizer 3: State Machine & Lifecycle (State Diagram)\n```mermaid\n{{MERMAID_STATE_DIAGRAM}}\n```\n\n---\n\n## [REQUIRED] Student Fill-in Worksheet Format (Offline Handout)\n{{OFFLINE_WORKSHEET_FORMAT}}\n";
818
+
819
+ /**
820
+ * @learnwell/curriculum-kit — Slide Layout Presets & Single-Page Slide Templates
821
+ *
822
+ * Reusable catalog of production-ready single slide templates with Marp YAML layout comments,
823
+ * presenter notes, and pedagogical structures for curriculum authoring & LLM generation.
824
+ */
825
+ type SlideLayoutCategory = 'cover' | 'content' | 'split' | 'code' | 'metrics' | 'diagram' | 'quote' | 'assessment';
826
+ interface LayoutBoxConfig {
827
+ id: string;
828
+ target?: string;
829
+ pos: [number, number, number, number];
830
+ fontSize?: string;
831
+ color?: string;
832
+ textAlign?: 'left' | 'center' | 'right' | 'justify';
833
+ style?: string;
834
+ }
835
+ interface SlideLayoutData {
836
+ boxes: LayoutBoxConfig[];
837
+ }
838
+ interface SlideLayoutPreset {
839
+ id: string;
840
+ name: string;
841
+ category: SlideLayoutCategory;
842
+ description: string;
843
+ layout: SlideLayoutData;
844
+ markdownSnippet: string;
845
+ }
846
+ declare const SLIDE_LAYOUT_PRESETS: SlideLayoutPreset[];
847
+ /**
848
+ * Find a preset by its unique ID
849
+ */
850
+ declare function getSlideLayoutPresetById(id: string): SlideLayoutPreset | undefined;
851
+ /**
852
+ * Filter presets by category
853
+ */
854
+ declare function getSlideLayoutPresetsByCategory(category: SlideLayoutCategory): SlideLayoutPreset[];
855
+
856
+ export { ACT_TEMPLATE, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DependencyEdge, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, HANDOUT_TEMPLATE, ICurriculumStorage, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, type SlashCommandDefinition, SlideDeck, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, SmartResumeContext, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildSessionSliceContext, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, expositionCacheKey, extractScopeSequenceRows, extractSessionSlice, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, topoSort };