@thanh01.pmt/curriculum-kit 1.4.40 → 1.4.42

package/dist/index.cjs

@@ -4204,334 +4204,35 @@ This lab focuses on the practical implementation of core technical concepts, bri
 {{CHECKLIST_ITEMS}}
 `.trim();
 
-// src/templates/handoutTemplate.ts
-var HANDOUT_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "HANDOUT"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T6"
-version: "{{VERSION}}"
-date: "{{DATE}}"
----
-
-# STUDENT HANDOUT: {{TITLE}}
-**Quick-Reference Cheat Sheet & Concept Summary**
-
-> **For Students:** This document summarizes the core concepts and the most important syntax following the **5-Second Rule** (instant look-up). Use it as a quick reference during your lab tasks or projects.
-
-## \u{1F4D6} 1. Core Concepts
-{{CORE_CONCEPTS_SUMMARY}}
-
-## \u26A1 2. Common Syntax & Configurations
-| Syntax / Config | Meaning & Function | Example / Snippet |
-| :--- | :--- | :--- |
-{{SYNTAX_TABLE_ROWS}}
-
-## \u{1F680} 3. General Problem-Solving Procedure
-*Three general thinking steps when tackling problems in this domain:*
-1. **Step 1 (Input/Trigger):** {{STEP1_TRIGGER}}
-2. **Step 2 (Logic/Transform):** {{STEP2_LOGIC}}
-3. **Step 3 (Output/Verify):** {{STEP3_OUTPUT}}
-
----
-
-### \u{1F4A1} Pro-tip
-{{PRO_TIPS}}
-`.trim();
-
-// src/templates/slideTemplate.ts
-var SLIDE_TEMPLATE = `
----
-marp: true
-theme: {{THEME}}
-paginate: true
-header: "{{HEADER_TITLE}}"
-footer: "LearnWell Platform | {{LESSON_ID}}"
----
-
-# \u{1F680} {{TITLE}}
-### {{SUBTITLE}}
-
-**Audience:** {{AUDIENCE}}  
-**Tech Stack:** {{TECH_STACK}}  
-**Estimated Time:** {{DURATION_MINS}} mins
-
-<!--
-Presenter Notes:
-{{TITLE_PRESENTER_NOTES}}
--->
-
----
-
-## \u{1F5FA}\uFE0F Agenda & Milestone Journey Map
-
-| Time | Stage | Focus Activity |
-|:---:|---|---|
-{{AGENDA_ROWS}}
-
-<!--
-Presenter Notes:
-{{AGENDA_PRESENTER_NOTES}}
--->
-
----
-
-## \u26A1 Warm-Up & Prior Knowledge Recall
-
-{{WARMUP_CONTENT}}
-
-<!--
-Presenter Notes:
-{{WARMUP_PRESENTER_NOTES}}
--->
-
----
-
-## \u{1F3AF} Hook Scenario: The Real-World Engineering Challenge
-
-> \u26A0\uFE0F **The Problem / System Failure:**  
-> {{HOOK_SCENARIO}}
-
-- **Key Constraint:** {{HOOK_CONSTRAINT}}
-- **Mission Question:** {{HOOK_QUESTION}}
-
-<!--
-Presenter Notes:
-{{HOOK_PRESENTER_NOTES}}
--->
-
----
-
-<!-- [CONCEPT_MICRO_CYCLES_START] -->
-{{CONCEPT_MICRO_CYCLES_SECTION}}
-<!-- [CONCEPT_MICRO_CYCLES_END] -->
-
----
-
-## \u{1F6E0}\uFE0F Integrated Hands-On Lab: Capstone Challenge
-
-### \u{1F3AF} Mission Goal:
-{{ADVANCED_LAB_GOAL}}
-
-### 3-Tier Progressive Differentiation:
-- \u{1F949} **Bronze Tier:** {{BRONZE_TASK}}
-- \u{1F948} **Silver Tier:** {{SILVER_TASK}}
-- \u{1F947} **Gold Tier:** {{GOLD_TASK}}
-
-<!--
-Presenter Notes:
-{{ADVANCED_LAB_PRESENTER_NOTES}}
--->
-
----
-
-## \u{1F6A6} Formative Checkpoint: Traffic Light Assessment
-
-- \u{1F7E2} **Ready to Accelerate:** Solved Bronze + Silver, ready for Gold tier!
-- \u{1F7E1} **Need Quick Help:** Stuck on syntax or compilation error $\rightarrow$ Call assistant / check troubleshooting matrix.
-- \u{1F534} **Blocked:** Concept unclear $\rightarrow$ Step back to Micro-Practice 1.
-
-<!--
-Presenter Notes:
-{{CHECKPOINT_PRESENTER_NOTES}}
--->
-
----
-
-## \u{1F39F}\uFE0F Exit Ticket & Metacognitive Reflection
-
-1. **Scenario Question 1:** {{EXIT_Q1}}
-2. **Scenario Question 2:** {{EXIT_Q2}}
-3. **Metacognitive Reflection:** {{EXIT_REFLECTION}}
-
-<!--
-Presenter Notes:
-{{EXIT_PRESENTER_NOTES}}
--->
-
----
-
-## \u{1F3C1} Summary & Key Takeaways
-
-- \u2705 **Rule 1:** {{TAKEAWAY_1}}
-- \u2705 **Rule 2:** {{TAKEAWAY_2}}
-- \u2705 **Rule 3:** {{TAKEAWAY_3}}
-
-\u{1F449} **Next Milestone Preview:** {{NEXT_MILESTONE_PREVIEW}}
-`.trim();
-
-// src/templates/worksheetTemplate.ts
-var WORKSHEET_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "WKS"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T7"
-version: "{{VERSION}}"
-date: "{{DATE}}"
----
-
-# WORKSHEET: {{TITLE}}
-
-**Student Name:** _______________________  
-**Class / Cohort:** _______________________  
-**Date:** _______________________  
-
-> **For Students:** This document guides you step-by-step through practical tasks. Read carefully, fill in the blanks, and check off [x] once completed. If you encounter errors, refer back to your **HANDOUT**.
-
-## Part 1: Knowledge Check
-{{PART1_KNOWLEDGE_CHECK}}
-
-## Part 2: Guided Practice (Step-by-Step)
-**Task Objective:** {{PART2_OBJECTIVE}}
-
-{{PART2_STEPS}}
-
-## Part 3: Reflection / Computational Thinking
-- What is the most critical lesson learned from today's practice?  
-  ____________________________________________________________________
-- If you wanted to scale this system for 10,000 active users, where do you predict the primary bottleneck will be?  
-  ____________________________________________________________________
-`.trim();
-
-// src/templates/projectInstructionTemplate.ts
-var PROJECT_INSTRUCTION_TEMPLATE = `
+// src/templates/quizTemplate.ts
+var QUIZ_TEMPLATE = `
 ---
 id: "{{ID}}"
 title: "{{TITLE}}"
-type: "INSTRUCTION"
+type: "QUIZ"
 language: "{{LANGUAGE}}"
-difficulty: "{{DIFFICULTY}}"
-estimated_minutes: {{ESTIMATED_MINUTES}}
-tech_stack: {{TECH_STACK}}
----
-
-# \u{1F6E0}\uFE0F {{TITLE}}
-
-> \u23F1\uFE0F **Estimated Duration:** ~{{ESTIMATED_MINUTES}} mins  
-> \u{1F3AF} **Difficulty:** {{DIFFICULTY_UPPER}}  
-> \u{1F9F0} **Tech Stack:** {{TECH_STACK_STR}}
-
----
-
-## \u{1F4CB} Prerequisites & Tools
-* **Prerequisites:** {{PREREQUISITES}}
-* **Materials & Tools:** {{MATERIALS_AND_TOOLS}}
-
----
-
-{{SECTIONS_CONTENT}}
-
----
-
-## \u{1F3C1} Verification Checklist
-{{VERIFICATION_CHECKLIST}}
-`.trim();
-
-// src/templates/rubricTemplate.ts
-var RUBRIC_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "RUBRIC"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T5"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Assessment Overview"
-  - "Assessment Rubric"
----
-
-# ASSESSMENT: {{TITLE}}
-
-_Milestone: {{MILESTONE_ID}} | Lesson: {{LESSON_ID}}_
-
-## [REQUIRED] Assessment Overview
-- **Type:** {{ASSESSMENT_TYPE}}
-- **Format:** {{ASSESSMENT_FORMAT}}
-- **Learning Objectives Measured:** {{LEARNING_OBJECTIVES_MEASURED}}
-- **Target Language:** {{TARGET_AUDIENCE_NOTE}}
-
+total_questions: {{TOTAL_QUESTIONS}}
+passing_score_pct: {{PASSING_SCORE_PCT}}
 ---
 
-## [REQUIRED] Assessment Rubric
-_Note for @assessor: Describe SPECIFIC behaviors. Avoid vague words like "good" or "understand."_
-
-| Criteria | Weight | Excellent (4) | Proficient (3) | Developing (2) | Beginning (1) |
-|---|:---:|---|---|---|---|
-{{RUBRIC_TABLE_ROWS}}
-
----
+# \u{1F9E0} Diagnostic & Active Recall Quiz: {{TITLE}}
 
-## [OPTIONAL] Exit Ticket
-_Used at the end of class for a quick pulse check (Max 3 questions)._
-{{EXIT_TICKET_QUESTIONS}}
+> \u23F1\uFE0F **Recommended Time:** ~10-15 mins  
+> \u{1F3AF} **Passing Score:** {{PASSING_SCORE_PCT}}%  
+> \u{1F4A1} **Purpose:** Test your conceptual understanding, catch hidden misconceptions, and evaluate architectural trade-offs.
 
 ---
 
-## [OPTIONAL] Student Self-Assessment Checklist
-_Simple language for students to reflect after completing a project._
-{{SELF_ASSESSMENT_CHECKLIST}}
-`.trim();
+{{QUESTIONS_SECTION}}
 
-// src/templates/guideTemplate.ts
-var TEACHER_GUIDE_TEMPLATE = `
 ---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "GUIDE"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T5"
-version: "{{VERSION}}"
-date: "{{DATE}}"
----
-
-# TEACHER GUIDE: {{TITLE}}
-_For Teacher Use Only | Milestone: {{MILESTONE_ID}} | Lesson: {{LESSON_ID}}_
-
-## 1. Objectives & Preparation
-- **Pedagogical Goal:** {{PEDAGOGICAL_GOAL}}
-- **Common Student Blindspots:** {{COMMON_BLINDSPOTS}}
-- **Technical Checklist:**
-{{TECHNICAL_CHECKLIST}}
-
-## 2. Teaching Script & Progression
-
-### Hook / Engage (5-10 minutes)
-- **The Delivery:** {{HOOK_DELIVERY}}
-- **Key Point:** {{HOOK_KEY_POINT}}
-
-### Explore / Core Concepts (15-20 minutes)
-- **Explanation Strategy:** {{EXPLANATION_STRATEGY}}
-- **Quick Check Questions:**
-{{QUICK_CHECK_QUESTIONS}}
-- **Time Management:** {{TIME_MANAGEMENT_TIPS}}
-
-### Elaborate / Hands-on Activity (30-45 minutes)
-- **Classroom Management:** {{CLASSROOM_MANAGEMENT}}
-- **Facilitation:** {{FACILITATION_TIPS}}
-- **Pro-tips:** {{PRO_TIPS}}
-
-### Evaluate / Wrap-up (5-10 minutes)
-- **Exit Ticket Strategy:** {{EXIT_TICKET_STRATEGY}}
-- **Minimum Requirement:** {{MINIMUM_REQUIREMENT}}
 
-## 3. Troubleshooting & FAQs
-{{TROUBLESHOOTING_FAQS}}
+## \u{1F511} Comprehensive Answer Key & Deep Explanation (Expand after completing)
+<details>
+<summary><b>\u{1F449} Click to View Full Explanations & Common Pitfall Analysis</b></summary>
 
-## 4. Assessment & Differentiation Tips
-- **Proficient:** {{PROFICIENT_THRESHOLD}}
-- **Advanced:** {{ADVANCED_EXTENSIONS}}
-- **Enrichment Question:** {{ENRICHMENT_QUESTIONS}}
+{{ANSWER_KEY_SECTION}}
+</details>
 `.trim();
 
 // src/templates/selfLabTemplate.ts
@@ -4627,1459 +4328,83 @@ tech_stack: {{TECH_STACK}}
 <details>
 <summary><b>\u{1F4A1} Hint Level 1: Conceptual Clue (H\u01B0\u1EDBng t\u01B0 duy)</b></summary>
 
-{{SILVER_HINT_1}}
-</details>
-
-<details>
-<summary><b>\u{1F50D} Hint Level 2: Structural Skeleton (Khung code m\u1EABu)</b></summary>
-
-\`\`\`{{CODE_LANGUAGE}}
-{{SILVER_HINT_2}}
-\`\`\`
-</details>
-
-<details>
-<summary><b>\u{1F6A8} Hint Level 3: Full Solution & Explanation (L\u1EDDi gi\u1EA3i tr\u1ECDn v\u1EB9n)</b></summary>
-
-\`\`\`{{CODE_LANGUAGE}}
-{{SILVER_HINT_3_CODE}}
-\`\`\`
-
-**Why this solution works:**
-{{SILVER_HINT_3_EXPLANATION}}
-</details>
-
----
-
-### \u{1F947} Challenge 3: Edge Cases & Optimization (Gold) \u2014 ~{{GOLD_MINS}} mins
-**Objective:** {{GOLD_OBJECTIVE}}
-
-#### Tasks & Implementation Details:
-{{GOLD_TASKS}}
-
-#### \u{1F9EA} Self-Verification Command:
-\`\`\`bash
-{{GOLD_VERIFY_COMMAND}}
-\`\`\`
-*Expected Terminal Output:*
-\`\`\`text
-{{GOLD_EXPECTED_OUTPUT}}
-\`\`\`
-
-#### \u{1F4A1} Progressive Hints (Expand only if stuck):
-<details>
-<summary><b>\u{1F4A1} Hint Level 1: Conceptual Clue (H\u01B0\u1EDBng t\u01B0 duy)</b></summary>
-
-{{GOLD_HINT_1}}
-</details>
-
-<details>
-<summary><b>\u{1F50D} Hint Level 2: Structural Skeleton (Khung code m\u1EABu)</b></summary>
-
-\`\`\`{{CODE_LANGUAGE}}
-{{GOLD_HINT_2}}
-\`\`\`
-</details>
-
-<details>
-<summary><b>\u{1F6A8} Hint Level 3: Full Solution & Explanation (L\u1EDDi gi\u1EA3i tr\u1ECDn v\u1EB9n)</b></summary>
-
-\`\`\`{{CODE_LANGUAGE}}
-{{GOLD_HINT_3_CODE}}
-\`\`\`
-
-**Why this solution works:**
-{{GOLD_HINT_3_EXPLANATION}}
-</details>
-
----
-
-## \u{1F50D} Self-Learner Troubleshooting Matrix
-| Symptom / Error Message | Root Cause | Exact Fix |
-| :--- | :--- | :--- |
-{{TROUBLESHOOTING_ROWS}}
-
----
-
-## \u{1F3C1} Final Lab Submission & Mastery Checklist
-{{FINAL_CHECKLIST}}
-`.trim();
-
-// src/templates/quizTemplate.ts
-var QUIZ_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "QUIZ"
-language: "{{LANGUAGE}}"
-total_questions: {{TOTAL_QUESTIONS}}
-passing_score_pct: {{PASSING_SCORE_PCT}}
----
-
-# \u{1F9E0} Diagnostic & Active Recall Quiz: {{TITLE}}
-
-> \u23F1\uFE0F **Recommended Time:** ~10-15 mins  
-> \u{1F3AF} **Passing Score:** {{PASSING_SCORE_PCT}}%  
-> \u{1F4A1} **Purpose:** Test your conceptual understanding, catch hidden misconceptions, and evaluate architectural trade-offs.
-
----
-
-{{QUESTIONS_SECTION}}
-
----
-
-## \u{1F511} Comprehensive Answer Key & Deep Explanation (Expand after completing)
-<details>
-<summary><b>\u{1F449} Click to View Full Explanations & Common Pitfall Analysis</b></summary>
-
-{{ANSWER_KEY_SECTION}}
-</details>
-`.trim();
-
-// src/templates/extTemplate.ts
-var EXT_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "EXT"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T8"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Target Mastery & Acceleration"
-  - "Challenge 1"
-  - "Challenge 2"
-  - "Verification Criteria"
----
-<!-- INJECT_BODY -->
-
-# EXTENSION CHALLENGES: {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}}_
-
-## [REQUIRED] Target Mastery & Acceleration
-> *Designed for advanced learners who have successfully completed the core lesson requirements ahead of schedule.*
-
----
-
-## [REQUIRED] Challenge 1: {{CHALLENGE_1_TITLE}} (Difficulty: \u2B50\u2B50\u2B50)
-- **Problem Statement:** {{CHALLENGE_1_DESCRIPTION}}
-- **Architectural Clues & Hints:**
-{{CHALLENGE_1_HINTS}}
-- **Expected Outcome & Deliverable:** {{CHALLENGE_1_OUTCOME}}
-
----
-
-## [REQUIRED] Challenge 2: {{CHALLENGE_2_TITLE}} (Difficulty: \u2B50\u2B50\u2B50\u2B50)
-- **Problem Statement:** {{CHALLENGE_2_DESCRIPTION}}
-- **Architectural Clues & Hints:**
-{{CHALLENGE_2_HINTS}}
-- **Expected Outcome & Deliverable:** {{CHALLENGE_2_OUTCOME}}
-
----
-
-## [REQUIRED] Verification Criteria
-- [ ] Code passes all extended unit tests.
-- [ ] No regression introduced into core components.
-- [ ] Demonstrates high-order optimization or architectural separation.
-`;
-
-// src/templates/glossaryTemplate.ts
-var GLOSSARY_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "GLOSSARY"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T9"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Core Technical Terminology"
-  - "Conceptual Analogies & Non-examples"
-  - "Cross-Technology Crosswalk"
----
-<!-- INJECT_BODY -->
-
-# TECHNICAL GLOSSARY & VOCABULARY: {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Reference Standard: CS2023_
-
-## [REQUIRED] Core Technical Terminology
-
-| Term / Keyword | Formal Engineering Definition | Code Usage Context | Common Misconception |
-| :--- | :--- | :--- | :--- |
-{{GLOSSARY_TABLE_ROWS}}
-
----
-
-## [REQUIRED] Conceptual Analogies & Non-examples
-
-{{ANALOGY_SECTIONS}}
-
----
-
-## [REQUIRED] Cross-Technology Crosswalk (Neutral vs. Specific)
-
-| Universal Concept (Marr Level 1/2) | Target Language Syntax (Level 3) | Alternative Language Equivalent |
-| :--- | :--- | :--- |
-{{CROSSWALK_ROWS}}
-`;
-var BOM_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "BOM"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T6"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Hardware & Sensor Specification"
-  - "Software & Environment Invariants"
-  - "Procurement & Safety Requirements"
----
-<!-- INJECT_BODY -->
-
-# BILL OF MATERIALS & LAB PREREQUISITES: {{TITLE}}
-_Unit: {{UNIT_ID}} | Target Class Size: {{CLASS_SIZE}} Students_
-
-## [REQUIRED] Hardware & Sensor Specification
-
-| Item Code | Component Name | Required Qty per Student/Group | Min Spec / Pinout | Alternative Substitute |
-| :--- | :--- | :--- | :--- | :--- |
-{{HARDWARE_BOM_ROWS}}
-
----
-
-## [REQUIRED] Software & Environment Invariants
-
-| Tool / Runtime | Required Version | Licensing / Cost | Fallback Offline Mode |
-| :--- | :--- | :--- | :--- |
-{{SOFTWARE_BOM_ROWS}}
-
----
-
-## [REQUIRED] Procurement & Safety Requirements
-- \u26A0\uFE0F **Voltage & Current Constraints:** {{POWER_CONSTRAINTS}}
-- \u{1F512} **API Quota & Rate Limits:** {{API_LIMITS}}
-`;
-
-// src/templates/exitTicketTemplate.ts
-var EXIT_TICKET_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "EXIT_TICKET"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T10"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Target Learning Objectives"
-  - "Recall & Conceptual Anchor"
-  - "Application & Bug Hunt"
-  - "Metacognitive Reflection & Confidence Check"
-  - "Scoring & Teacher Intervention Trigger"
----
-<!-- INJECT_BODY -->
-
-# FORMATIVE EXIT TICKET: {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}} | Estimated Time: 5-7 mins_
-
-## [REQUIRED] Target Learning Objectives
-- **Target LO 1 (ULO):** {{TARGET_LO_1}}
-- **Target LO 2 (CIO/SIO):** {{TARGET_LO_2}}
-
----
-
-## [REQUIRED] Part 1: Recall & Conceptual Anchor (Prompt 1)
-> *Objective: Test core mental model without allowing rote syntax memorization.*
-
-**Question 1:**  
-{{CONCEPTUAL_QUESTION}}
-
-- **Student Answer Area:**  
-  \`\`\`text
-  [Write 1-2 concise sentences explaining the difference in runtime mechanism]
-  \`\`\`
-
----
-
-## [REQUIRED] Part 2: Application & Bug Hunt (Prompt 2)
-> *Objective: Test code diagnosis and precise correction in \u2264 3 lines of modification.*
-
-**Code Snippet:**  
-\`\`\`{{CODE_LANGUAGE}}
-{{BUGGY_CODE_SNIPPET}}
-\`\`\`
-
-**Task:**  
-1. **Identify the Compiler/Runtime Error:** {{BUG_SYMPTOM_HINT}}
-2. **Corrected Line:**  
-   \`\`\`{{CODE_LANGUAGE}}
-   {{CORRECTED_CODE_SLOT}}
-   \`\`\`
-
----
-
-## [REQUIRED] Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)
-> *Objective: Empower student self-regulation and provide immediate diagnostic signals.*
-
-**Traffic Light Self-Assessment:**  
-- [ ] \u{1F7E2} **Green (Mastered):** "I can build and explain this concept to a peer without any hints."
-- [ ] \u{1F7E1} **Yellow (Needs Practice):** "I understand the concept but got stuck on syntax or error messages."
-- [ ] \u{1F534} **Red (Blocked):** "I need help understanding why this architecture is used."
-
-**One Lingering Question (Exit Ticket Note):**  
-\`\`\`text
-[What is one question you still have before leaving today's lab?]
-\`\`\`
-
----
-
-## [REQUIRED] Scoring & Teacher Intervention Trigger
-- **Proficiency Threshold:** Green/Yellow check + Correct Answer to Part 2 Bug Hunt.
-- **Intervention Protocol:** {{INTERVENTION_PROTOCOL}}
-`;
-
-// src/templates/tieredPracticeTemplate.ts
-var TIERED_PRACTICE_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "TIERED_PRACTICE"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T11"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Computational Objective & Tier Matrix"
-  - "Bronze Tier (Foundational Scaffolding)"
-  - "Silver Tier (Independent Application)"
-  - "Gold Tier (Enrichment & Optimization)"
-  - "Automated Test Verification Matrix"
-  - "Answer Key & Mentor Hints"
----
-<!-- INJECT_BODY -->
-
-# 3-TIER DIFFERENTIATED PRACTICE LAB: {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}} | Mode: Adaptive Lab_
-
-## [REQUIRED] Computational Objective & Tier Matrix
-
-| Tier Level | Cognitive Target (Bloom) | Scaffolding Ratio | Success Criteria |
-| :--- | :--- | :--- | :--- |
-| \u{1F949} **Bronze** | Remember / Understand | **70% Starter Code / 30% Fill-in** | Complete basic syntax & pass Baseline Unit Test. |
-| \u{1F948} **Silver** | Apply / Analyze | **30% Starter Code / 70% Implementation** | Implement business logic, edge-case handling & multi-component binding. |
-| \u{1F947} **Gold** | Evaluate / Create | **0% Code / Open Architecture** | Optimize performance, refactor with concurrency/state isolation & self-author tests. |
-
----
-
-## [REQUIRED] \u{1F949} Bronze Tier: Foundational Scaffolding (Baseline for All)
-- **Target Audience:** All learners (mandatory milestone).
-- **Guiding Prompt:** {{BRONZE_PROMPT}}
-
-### Starter Code & Fill-in Slots:
-\`\`\`{{CODE_LANGUAGE}}
-{{BRONZE_STARTER_CODE}}
-\`\`\`
-
-- **Verification Check:** Run test \`testBronzeBaseline()\` \u2014 Expect status \`PASS\`.
-
----
-
-## [REQUIRED] \u{1F948} Silver Tier: Independent Application (Target Mastery)
-- **Target Audience:** Learners who completed Bronze without mentor intervention.
-- **Guiding Prompt:** {{SILVER_PROMPT}}
-
-### Specification & Requirements:
-{{SILVER_SPECIFICATIONS}}
-
-### Implementation Target:
-\`\`\`{{CODE_LANGUAGE}}
-{{SILVER_IMPLEMENTATION_SLOT}}
-\`\`\`
-
-- **Verification Check:** Run test \`testSilverLogicAndValidation()\` \u2014 Expect status \`PASS\`.
-
----
-
-## [REQUIRED] \u{1F947} Gold Tier: Enrichment & Optimization (Open Extension)
-- **Target Audience:** Advanced learners finished ahead of schedule.
-- **Architectural Challenge:** {{GOLD_CHALLENGE}}
-
-### Constraints & Invariants:
-{{GOLD_CONSTRAINTS}}
-
----
-
-## [REQUIRED] Automated Test Verification Matrix & Mentor Hints
-\`\`\`{{CODE_LANGUAGE}}
-{{TEST_HARNESS_CODE}}
-\`\`\`
-
-### Mentor Debugging Cheatsheet:
-{{MENTOR_DEBUG_CHEATSHEET}}
-`;
-var CHOICE_BOARD_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "CHOICE_BOARD"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T12"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Learning Goals & Rule of Choice"
-  - "The 9-Square Activity Matrix"
-  - "Activity Detailed Blueprints"
-  - "Universal Assessment Rubric"
----
-<!-- INJECT_BODY -->
-
-# 9-SQUARE CHOICE BOARD: {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Target Competency: {{CORE_COMPETENCY}}_
-
-## [REQUIRED] Learning Goals & Rule of Choice
-- **Core Concept Anchor:** {{CORE_CONCEPT_ANCHOR}}
-- **Rule of Choice (Tic-Tac-Toe / Point Model):**
-  - *Option A (Tic-Tac-Toe):* Complete 3 activities in a row (Horizontal, Vertical, or Diagonal).
-  - *Option B (Point Balance):* Reach $\\ge 100\\text{ pts}$ (Choose $\\ge 1$ Technical Lab + $\\ge 1$ Explanatory/Visual + $\\ge 1$ Creative Challenge).
-
----
-
-## [REQUIRED] The 9-Square Activity Matrix
-
-| Column 1: Analytical & Code | Column 2: Visual & Architecture | Column 3: Creative & Applied |
-| :--- | :--- | :--- |
-| **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}} |
-| **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}} |
-| **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}} |
-
----
-
-## [REQUIRED] Activity Detailed Blueprints
-
-### Detail: Square 1 \u2014 {{SQ1_TITLE}}
-{{SQ1_BLUEPRINT}}
-
-### Detail: Square 2 \u2014 {{SQ2_TITLE}}
-{{SQ2_BLUEPRINT}}
-
-### Detail: \u2B50 Square 5 \u2014 {{SQ5_TITLE}} (Mandatory Center Option)
-{{SQ5_BLUEPRINT}}
-
----
-
-## [REQUIRED] Universal Assessment Rubric
-| Criteria | Exemplary (4) | Proficient (3) | Developing (2) | Beginning (1) |
-| :--- | :--- | :--- | :--- | :--- |
-| **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. |
-| **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. |
-| **Creativity & Autonomy** | Goes beyond specifications with thoughtful UX or performance optimizations. | Fulfills all specified criteria independently. | Needs significant scaffolding hints to complete. | Incomplete submission. |
-`;
-
-// src/templates/scienceLabTemplate.ts
-var SCIENCE_LAB_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "SCIENCE_LAB"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T13"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Guiding Inquiry & Driving Question"
-  - "Hypothesis & Experimental Design"
-  - "Data Collection & Code Lab Protocol"
-  - "CER Scientific Conclusion (Claim, Evidence, Reasoning)"
-  - "Peer Review & Verification Protocol"
----
-<!-- INJECT_BODY -->
-
-# STEM / CODE INVESTIGATION LAB (CER): {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Domain: {{DOMAIN_NAME}}_
-
-## [REQUIRED] Guiding Inquiry & Driving Question
-- **Real-World Driving Question:** {{DRIVING_QUESTION}}
-- **Engineering Phenomenon:** {{ENGINEERING_PHENOMENON}}
-
----
-
-## [REQUIRED] Hypothesis & Experimental Design
-- **Student Hypothesis Template:**  
-  > *"If we [Action / Variable Manipulation], then [Predicted Outcome] because [Scientific / Engineering Rationale]."*
-
-### Controlled Variables:
-- **Independent Variable (Manipulated):** {{INDEPENDENT_VARIABLE}}
-- **Dependent Variable (Measured):** {{DEPENDENT_VARIABLE}}
-- **Control Variables (Constant):** {{CONTROL_VARIABLES}}
-
----
-
-## [REQUIRED] Data Collection & Code Lab Protocol
-
-### Lab Setup & Instrumentation Code:
-\`\`\`{{CODE_LANGUAGE}}
-{{BENCHMARK_PROBE_CODE}}
-\`\`\`
-
-### Data Collection Table:
-| Trial | Variable State | Memory (MB) | Latency (ms) | Error / Anomaly Count |
-| :---: | :--- | :---: | :---: | :---: |
-{{DATA_COLLECTION_ROWS}}
-
----
-
-## [REQUIRED] CER Scientific Conclusion (Claim, Evidence, Reasoning)
-
-### 1. \u{1F4CC} Claim (Kh\u1EB3ng \u0111\u1ECBnh):
-- *Direct answer to the driving question in 1 concise sentence:*  
-  \`\`\`text
-  [State clear conclusion based on data]
-  \`\`\`
-
-### 2. \u{1F4CA} Evidence (B\u1EB1ng ch\u1EE9ng s\u1ED1 li\u1EC7u):
-- *Specific quantitative data points cited directly from the Data Collection Table:*  
-  \`\`\`text
-  [Cite concrete numerical metrics and trials]
-  \`\`\`
-
-### 3. \u{1F9E0} Reasoning (L\u1EADp lu\u1EADn khoa h\u1ECDc):
-- *Connect the evidence back to the underlying technical principle:*  
-  \`\`\`text
-  [Explain why the runtime/hardware behaved this way]
-  \`\`\`
-
----
-
-## [REQUIRED] Peer Review & Verification Protocol
-- **Reproducibility Test:** Exchange code probes with another group to verify if results match within $\\pm 10\\%$ tolerance.
-`;
-var TASK_CARDS_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "TASK_CARDS"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T14"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Deck Overview & Print Instructions"
-  - "Task Cards 1 to 4 (Foundational Concepts)"
-  - "Task Cards 5 to 8 (Code Diagnosis & Debugging)"
-  - "Task Cards 9 to 12 (Application & Synthesis)"
-  - "Teacher Answer Key & Scoring Matrix"
----
-<!-- INJECT_BODY -->
-
-# PRINTABLE TASK CARDS PACK: {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Total Cards: {{CARD_COUNT}} Cards_
-
-## [REQUIRED] Deck Overview & Print Instructions
-- **Card Format:** 4 cards per page (A4 layout with cutting guidelines and QR code link).
-- **Target Skills:** Conceptual Understanding, Code Tracing, Bug Hunting, Architectural Reasoning.
-- **Scoring System:** Bronze Cards (1 pt), Silver Cards (2 pts), Gold Cards (3 pts).
-
----
-
-## [REQUIRED] Set A: Foundational Concepts (Cards 1\u20134)
-{{TASK_CARDS_SET_A}}
-
----
-
-## [REQUIRED] Set B: Code Diagnosis & Debugging (Cards 5\u20138)
-{{TASK_CARDS_SET_B}}
-
----
-
-## [REQUIRED] Set C: Application & Synthesis (Cards 9\u201312)
-{{TASK_CARDS_SET_C}}
-
----
-
-## [REQUIRED] Teacher Answer Key & Scoring Matrix
-| Card ID | Correct Answer / Solution Blueprint | Max Points |
-| :---: | :--- | :---: |
-{{TASK_CARDS_ANSWER_ROWS}}
-`;
-
-// src/templates/stationRotationTemplate.ts
-var STATION_ROTATION_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "STATION_ROTATION"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T15"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Station Architecture & Timer Overview"
-  - "Station 1: Teacher-Led Small Group (Deep Dive)"
-  - "Station 2: Collaborative Hands-On Lab (Peer Pair)"
-  - "Station 3: Independent Digital Practice (Async Code)"
-  - "Station 4: Offline Modeling & Architecture (Whiteboard)"
-  - "Station Recording Sheet & Rotation Bell Protocol"
----
-<!-- INJECT_BODY -->
-
-# STATION ROTATION LESSON PACK: {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: 4 Stations x 15 Mins_
-
-## [REQUIRED] Station Architecture & Timer Overview
-- **Classroom Layout:** 4 designated physical zones with clear signage and materials.
-- **Rotation Time:** 15 minutes per station + 2 minutes clean transition buffer.
-- **Audience Grouping:** Heterogeneous groups of 4-6 students rotating simultaneously.
-
----
-
-## [REQUIRED] Station 1: Teacher-Led Small Group (Guided Inquiry)
-- **Goal:** Direct coaching, conceptual check, and resolving misconceptions in real-time.
-- **Teacher Script & Inquiry Questions:**
-{{STATION_1_GUIDANCE}}
-
----
-
-## [REQUIRED] Station 2: Collaborative Hands-On Lab (Pair Programming)
-- **Goal:** Students work in pairs (Driver / Navigator) to solve a 2-stage challenge.
-- **Task Materials:** {{STATION_2_MATERIALS}}
-- **Success Milestone:** {{STATION_2_MILESTONE}}
-
----
-
-## [REQUIRED] Station 3: Independent Digital Practice (Self-Paced Code Lab)
-- **Goal:** Autonomy and individual mastery verification.
-- **Student Instructions:**
-{{STATION_3_INSTRUCTIONS}}
-
----
-
-## [REQUIRED] Station 4: Offline Modeling & Architecture (No Screens)
-- **Goal:** Cognitive unloading and physical spatial reasoning.
-- **Materials:** Whiteboard markers, physical Task Cards deck, and laminated architecture templates.
-- **Task:** {{STATION_4_TASK}}
-
----
-
-## [REQUIRED] Station Recording Sheet (Student Passport)
-| Station | Task Completed | Signature / Verification Stamp | 1 Key Insight Learned |
-| :---: | :--- | :--- | :--- |
-| **1 (Teacher)** | Debugging Probe Discussion | [Teacher Stamp] | |
-| **2 (Pair Lab)** | Stage 1 & 2 Test Suite | [Peer Signature] | |
-| **3 (Digital)** | Micro-Challenges Token | [Auto Token] | |
-| **4 (Offline)** | Flowchart Diagram Approved | [Mentor Stamp] | |
-`;
-var BELL_RINGER_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "BELL_RINGER"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T16"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Weekly Objective & Schedule"
-  - "Monday: Mental Model Recall"
-  - "Tuesday: Code Spot-Check"
-  - "Wednesday: Bug Hunt & Fix"
-  - "Thursday: Architecture Tracing"
-  - "Friday: Creative Synthesis & Bridge"
-  - "Answer Key & Scoring Guide"
----
-<!-- INJECT_BODY -->
-
-# WEEKLY BELL RINGERS (5-DAY WARM-UP PACK): {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Time: 3-5 Mins per Session_
-
-## [REQUIRED] Weekly Objective & Schedule
-- **Weekly Core Theme:** {{WEEKLY_THEME}}
-- **Routine Protocol:** Display prompt on projector immediately as students enter.
-
----
-
-## [REQUIRED] Day 1 (Monday): Mental Model Recall & Analogy
-{{DAY_1_PROMPT}}
-
----
-
-## [REQUIRED] Day 2 (Tuesday): Rapid Code Tracing
-{{DAY_2_PROMPT}}
-
----
-
-## [REQUIRED] Day 3 (Wednesday): Quick Bug Hunt (Spot the Defect)
-{{DAY_3_PROMPT}}
-
----
-
-## [REQUIRED] Day 4 (Thursday): Visual Diagram Tracing
-{{DAY_4_PROMPT}}
-
----
-
-## [REQUIRED] Day 5 (Friday): Creative Synthesis & Bridge Forward
-{{DAY_5_PROMPT}}
-
----
-
-## [REQUIRED] Teacher Answer Key & Scoring Guide
-{{TEACHER_ANSWER_KEY}}
-`;
-var REVIEW_GAME_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "REVIEW_GAME"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T17"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Game Rules & Setup Guide"
-  - "Round 1: Speed Round (100-200 Pts)"
-  - "Round 2: Code Duel & Debugging (300-400 Pts)"
-  - "Round 3: Final Boss Architecture Challenge (500 Pts)"
-  - "Kahoot / Quizizz CSV Export Format"
----
-<!-- INJECT_BODY -->
-
-# INTERACTIVE REVIEW GAME (QUIZ SHOW PACK): {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Live Classroom Quiz Show_
-
-## [REQUIRED] Game Rules & Setup Guide
-- **Format:** 3 Rounds of progressive difficulty with team buzzers.
-- **Team Size:** 3-5 students per squad.
-
----
-
-## [REQUIRED] Round 1: Rapid-Fire Speed Round (100\u2013200 Points)
-{{ROUND_1_QUESTIONS}}
-
----
-
-## [REQUIRED] Round 2: Code Duel & Debugging (300\u2013400 Points)
-{{ROUND_2_CHALLENGES}}
-
----
-
-## [REQUIRED] Round 3: Final Boss Architecture Challenge (500 Points)
-{{ROUND_3_BOSS_CHALLENGE}}
-
----
-
-## [REQUIRED] Kahoot / Quizizz CSV Export Format
-\`\`\`csv
-{{KAHOOT_CSV_CONTENT}}
-\`\`\`
-`;
-var GRAPHIC_ORGANIZER_TEMPLATE = `---
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "GRAPHIC_ORGANIZER"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T18"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Visual Paradigm Overview"
-  - "Organizer 1: Architectural Data Flow (Mermaid Flowchart)"
-  - "Organizer 2: Comparative Analysis (Mermaid / Markdown Venn)"
-  - "Organizer 3: State Machine & Lifecycle (Mermaid StateDiagram)"
-  - "Student Fill-in Worksheet Format"
----
-<!-- INJECT_BODY -->
-
-# VISUAL GRAPHIC ORGANIZERS: {{TITLE}}
-_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Mermaid Diagrams + Printable Handouts_
-
-## [REQUIRED] Visual Paradigm Overview
-- **Cognitive Purpose:** Unload mental processing burden through spatial diagramming.
-
----
-
-## [REQUIRED] Organizer 1: Architectural Data Flow (Mermaid Flowchart)
-\`\`\`mermaid
-{{MERMAID_FLOWCHART}}
-\`\`\`
-
----
-
-## [REQUIRED] Organizer 2: Comparative Analysis (Venn Diagram / Matrix)
-\`\`\`mermaid
-{{MERMAID_VENN_OR_MATRIX}}
-\`\`\`
-
----
-
-## [REQUIRED] Organizer 3: State Machine & Lifecycle (State Diagram)
-\`\`\`mermaid
-{{MERMAID_STATE_DIAGRAM}}
-\`\`\`
-
----
-
-## [REQUIRED] Student Fill-in Worksheet Format (Offline Handout)
-{{OFFLINE_WORKSHEET_FORMAT}}
-`;
-
-// src/templates/slidePresets.ts
-var SLIDE_LAYOUT_PRESETS = [
-  {
-    id: "title-hero",
-    name: "Title & Speaker Cover",
-    category: "cover",
-    description: "High-impact opening slide with large title, subtitle, and speaker credentials.",
-    layout: {
-      boxes: [
-        {
-          id: "title",
-          target: "h1",
-          pos: [100, 180, 1080, 140],
-          fontSize: "3rem",
-          textAlign: "center"
-        },
-        {
-          id: "subtitle",
-          target: "h3",
-          pos: [100, 350, 1080, 70],
-          fontSize: "1.5rem",
-          textAlign: "center"
-        },
-        {
-          id: "speaker-meta",
-          target: "p",
-          pos: [100, 460, 1080, 80],
-          fontSize: "1.1rem",
-          textAlign: "center"
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: title
-      target: h1
-      pos: [100, 180, 1080, 140]
-      fontSize: 3rem
-      textAlign: center
-    - id: subtitle
-      target: h3
-      pos: [100, 350, 1080, 70]
-      fontSize: 1.5rem
-      textAlign: center
-    - id: speaker-meta
-      target: p
-      pos: [100, 460, 1080, 80]
-      fontSize: 1.1rem
-      textAlign: center
--->
-
-# \u{1F680} Engineering Scalable Cloud Systems
-### Principles, Bottlenecks, and Real-World Architecture Patterns
-
-**Presenter:** Senior Systems Architect | **Duration:** 45 mins | **Level:** Intermediate
-
-<!--
-Presenter Notes:
-- Welcome the audience and outline today's primary engineering goals.
-- Spark curiosity with an opening hook about scaling under high concurrency.
--->`
-  },
-  {
-    id: "two-column-split",
-    name: "Two-Column Comparison",
-    category: "split",
-    description: "Balanced side-by-side comparison for legacy vs modern patterns or pros vs cons.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [80, 50, 1120, 70],
-          fontSize: "2rem"
-        },
-        {
-          id: "col-left",
-          target: ".columns-2 > div:first-child",
-          pos: [80, 150, 530, 510]
-        },
-        {
-          id: "col-right",
-          target: ".columns-2 > div:last-child",
-          pos: [670, 150, 530, 510]
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [80, 50, 1120, 70]
-      fontSize: 2rem
-    - id: col-left
-      target: '.columns-2 > div:first-child'
-      pos: [80, 150, 530, 510]
-    - id: col-right
-      target: '.columns-2 > div:last-child'
-      pos: [670, 150, 530, 510]
--->
-
-## \u2696\uFE0F Monolithic Polling vs Event-Driven Architecture
-
-<div class="columns-2">
-<div>
-
-### \u{1F534} Legacy Polling
-- Heavy database CPU overhead on idle cycles
-- High network latency between updates
-- Prone to cascading timeouts during spikes
-
-</div>
-<div>
-
-### \u{1F7E2} Event-Driven Streams
-- Real-time event propagation via webhooks
-- Zero idle compute waste with serverless consumers
-- Automatic backpressure and queue isolation
-
-</div>
-</div>
-
-<!--
-Presenter Notes:
-- Emphasize the core failure mode of periodic polling under sudden load spikes.
-- Ask the room if anyone has experienced database lockups caused by polling loops.
--->`
-  },
-  {
-    id: "code-explainer",
-    name: "Code Walkthrough & Analysis",
-    category: "code",
-    description: "Syntax-highlighted code block on the left with step-by-step key annotations on the right.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [80, 45, 1120, 65],
-          fontSize: "1.9rem"
-        },
-        {
-          id: "code-box",
-          target: ".columns-2 > div:first-child",
-          pos: [80, 135, 630, 535]
-        },
-        {
-          id: "notes-box",
-          target: ".columns-2 > div:last-child",
-          pos: [740, 135, 460, 535]
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [80, 45, 1120, 65]
-      fontSize: 1.9rem
-    - id: code-box
-      target: '.columns-2 > div:first-child'
-      pos: [80, 135, 630, 535]
-    - id: notes-box
-      target: '.columns-2 > div:last-child'
-      pos: [740, 135, 460, 535]
--->
-
-## \u{1F4BB} Robust Async Transaction Pipeline
-
-<div class="columns-2">
-<div>
-
-\`\`\`ts
-// Process payment with idempotency guarantee
-export async function processPayment(order: Order) {
-  const isValid = await validateOrder(order);
-  if (!isValid) throw new Error("ValidationFailed");
-
-  const receipt = await chargeCard(order);
-  return sendConfirmation(receipt);
-}
-\`\`\`
-
-</div>
-<div>
-
-### \u{1F50D} Key Engineering Invariants:
-1. **Early Guard Clause:** Validates payload immediately at line 3 before triggering external calls.
-2. **Deterministic Sequence:** Enforces strict order of operations using native \`await\`.
-3. **Audit Trail:** Returns immutable payment receipt upon successful execution.
-
-</div>
-</div>
-
-<!--
-Presenter Notes:
-- Walk through lines 1 to 7 sequentially.
-- Cold-call check: "What happens if line 6 throws a network timeout?"
-- Cognitive scaffolding: Highlight the importance of idempotency keys in payment APIs.
--->`
-  },
-  {
-    id: "metrics-3-card",
-    name: "3-Metric Key Results Grid",
-    category: "metrics",
-    description: "Three high-visibility KPI stat cards for benchmarks, impact, and success criteria.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [80, 50, 1120, 70],
-          fontSize: "2rem",
-          textAlign: "center"
-        },
-        {
-          id: "metric-1",
-          target: ".columns-3 > div:nth-child(1)",
-          pos: [80, 165, 340, 485]
-        },
-        {
-          id: "metric-2",
-          target: ".columns-3 > div:nth-child(2)",
-          pos: [470, 165, 340, 485]
-        },
-        {
-          id: "metric-3",
-          target: ".columns-3 > div:nth-child(3)",
-          pos: [860, 165, 340, 485]
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [80, 50, 1120, 70]
-      fontSize: 2rem
-      textAlign: center
-    - id: metric-1
-      target: '.columns-3 > div:nth-child(1)'
-      pos: [80, 165, 340, 485]
-    - id: metric-2
-      target: '.columns-3 > div:nth-child(2)'
-      pos: [470, 165, 340, 485]
-    - id: metric-3
-      target: '.columns-3 > div:nth-child(3)'
-      pos: [860, 165, 340, 485]
--->
-
-## \u{1F4CA} Performance & Reliability Benchmarks
-
-<div class="columns-3">
-<div>
-
-# \u26A1 99.99%
-### SLA Availability
-High-availability multi-region cluster with automated failover routing.
-
-</div>
-<div>
-
-# \u{1F680} 15ms
-### P99 Latency
-Sub-20ms roundtrip response time via distributed edge caching.
-
-</div>
-<div>
-
-# \u{1F6E1}\uFE0F Zero
-### Unhandled Breaches
-Full SOC2 Type II compliance and end-to-end payload encryption.
-
-</div>
-</div>
-
-<!--
-Presenter Notes:
-- Highlight the 15ms P99 latency target as the primary technical milestone.
-- Connect these metrics directly to the architecture decisions discussed next.
--->`
-  },
-  {
-    id: "process-flow",
-    name: "Architecture & Process Flow",
-    category: "diagram",
-    description: "Multi-stage workflow with responsive Mermaid diagram and phase summaries.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [80, 45, 1120, 65],
-          fontSize: "1.9rem"
-        },
-        {
-          id: "diagram-box",
-          target: "pre.mermaid, .mermaid",
-          pos: [80, 130, 1120, 310]
-        },
-        {
-          id: "summary-box",
-          target: "ul, p",
-          pos: [80, 465, 1120, 205]
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [80, 45, 1120, 65]
-      fontSize: 1.9rem
-    - id: diagram-box
-      target: 'pre.mermaid, .mermaid'
-      pos: [80, 130, 1120, 310]
-    - id: summary-box
-      target: 'ul, p'
-      pos: [80, 465, 1120, 205]
--->
-
-## \u{1F504} End-to-End Data Ingestion Pipeline
-
-\`\`\`mermaid
-graph LR
-    A[1. Client Ingress] --> B[2. API Gateway]
-    B --> C[3. Auth Verifier]
-    C --> D[4. Distributed DB]
-    style A fill:#0284c7,stroke:#38bdf8,stroke-width:2px,color:#fff
-    style B fill:#1e293b,stroke:#64748b,stroke-width:2px,color:#fff
-    style C fill:#059669,stroke:#34d399,stroke-width:2px,color:#fff
-    style D fill:#7c3aed,stroke:#a78bfa,stroke-width:2px,color:#fff
-\`\`\`
-
-- **Ingress & Gateway:** Rate-limits traffic and applies reverse-proxy load balancing.
-- **Verification & Storage:** Decodes cryptographic JWT tokens before transactional write commit.
-
-<!--
-Presenter Notes:
-- Trace each hop across the diagram from left to right.
-- Ask: "Where should rate limiting be applied to prevent DDoS attacks?"
--->`
-  },
-  {
-    id: "quote-highlight",
-    name: "Core Principle & Quote Highlight",
-    category: "quote",
-    description: "Prominent quote callout for fundamental engineering rules or memorable mantras.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [100, 100, 1080, 80],
-          fontSize: "2.2rem",
-          textAlign: "center"
-        },
-        {
-          id: "quote-box",
-          target: "blockquote",
-          pos: [140, 230, 1e3, 360],
-          fontSize: "1.4rem"
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [100, 100, 1080, 80]
-      fontSize: 2.2rem
-      textAlign: center
-    - id: quote-box
-      target: blockquote
-      pos: [140, 230, 1000, 360]
-      fontSize: 1.4rem
--->
-
-## \u{1F4A1} Foundational Architecture Principle
-
-> "Simplicity is prerequisite for reliability. A well-engineered distributed system is one where a new engineer can understand the request flow within their first hour."
-> 
-> \u2014 **Edsger W. Dijkstra**
-
-<!--
-Presenter Notes:
-- Pause for 5 seconds of silence to let the quote sink in.
-- Ask: "How do our current architectural choices reflect this principle?"
--->`
-  },
-  {
-    id: "quiz-checkpoint",
-    name: "Interactive Formative Checkpoint",
-    category: "assessment",
-    description: "Interactive multiple-choice diagnostic checkpoint with A/B/C/D voting options.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [80, 45, 1120, 65],
-          fontSize: "1.9rem"
-        },
-        {
-          id: "question-callout",
-          target: "blockquote",
-          pos: [80, 130, 1120, 110],
-          fontSize: "1.2rem"
-        },
-        {
-          id: "options-list",
-          target: "ul",
-          pos: [80, 260, 1120, 390],
-          fontSize: "1.15rem"
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [80, 45, 1120, 65]
-      fontSize: 1.9rem
-    - id: question-callout
-      target: blockquote
-      pos: [80, 130, 1120, 110]
-      fontSize: 1.2rem
-    - id: options-list
-      target: ul
-      pos: [80, 260, 1120, 390]
-      fontSize: 1.15rem
--->
+{{SILVER_HINT_1}}
+</details>
 
-## \u{1F3AF} Formative Checkpoint: Verify Your Understanding
+<details>
+<summary><b>\u{1F50D} Hint Level 2: Structural Skeleton (Khung code m\u1EABu)</b></summary>
 
-> **Question:** In an event-driven architecture, which pattern guarantees that messages are never permanently lost if a downstream consumer crashes?
+\`\`\`{{CODE_LANGUAGE}}
+{{SILVER_HINT_2}}
+\`\`\`
+</details>
 
-- **A.** Direct synchronous HTTP request with short 2-second timeout
-- **B.** Persistent Message Broker with Dead-Letter Queue (DLQ) & retry policy
-- **C.** In-memory client RAM cache without persistence
-- **D.** Discarding failed packets and prompting the user to re-submit
+<details>
+<summary><b>\u{1F6A8} Hint Level 3: Full Solution & Explanation (L\u1EDDi gi\u1EA3i tr\u1ECDn v\u1EB9n)</b></summary>
 
-<!--
-Presenter Notes:
-- Give students 30 seconds to vote on option A, B, C, or D.
-- Correct answer: B.
-- Explain why options A and C introduce catastrophic data loss in production.
--->`
-  },
-  {
-    id: "tiered-practice-3cards",
-    name: "Tiered Differentiation (Bronze / Silver / Gold)",
-    category: "content",
-    description: "Three progressive competency tiers allowing self-paced learning acceleration.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [80, 45, 1120, 65],
-          fontSize: "1.9rem"
-        },
-        {
-          id: "tier-bronze",
-          target: ".columns-3 > div:nth-child(1)",
-          pos: [80, 140, 350, 520]
-        },
-        {
-          id: "tier-silver",
-          target: ".columns-3 > div:nth-child(2)",
-          pos: [465, 140, 350, 520]
-        },
-        {
-          id: "tier-gold",
-          target: ".columns-3 > div:nth-child(3)",
-          pos: [850, 140, 350, 520]
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [80, 45, 1120, 65]
-      fontSize: 1.9rem
-    - id: tier-bronze
-      target: '.columns-3 > div:nth-child(1)'
-      pos: [80, 140, 350, 520]
-    - id: tier-silver
-      target: '.columns-3 > div:nth-child(2)'
-      pos: [465, 140, 350, 520]
-    - id: tier-gold
-      target: '.columns-3 > div:nth-child(3)'
-      pos: [850, 140, 350, 520]
--->
+\`\`\`{{CODE_LANGUAGE}}
+{{SILVER_HINT_3_CODE}}
+\`\`\`
 
-## \u{1F6E0}\uFE0F Hands-On Challenge: 3-Tier Differentiation
+**Why this solution works:**
+{{SILVER_HINT_3_EXPLANATION}}
+</details>
 
-<div class="columns-3">
-<div>
+---
 
-### \u{1F949} Bronze Tier
-- Implement baseline function
-- Pass 3 baseline unit tests
-- *Goal: Foundational mastery*
+### \u{1F947} Challenge 3: Edge Cases & Optimization (Gold) \u2014 ~{{GOLD_MINS}} mins
+**Objective:** {{GOLD_OBJECTIVE}}
 
-</div>
-<div>
+#### Tasks & Implementation Details:
+{{GOLD_TASKS}}
 
-### \u{1F948} Silver Tier
-- Add boundary error handling
-- Enforce O(N) memory complexity
-- *Goal: Production-ready code*
+#### \u{1F9EA} Self-Verification Command:
+\`\`\`bash
+{{GOLD_VERIFY_COMMAND}}
+\`\`\`
+*Expected Terminal Output:*
+\`\`\`text
+{{GOLD_EXPECTED_OUTPUT}}
+\`\`\`
 
-</div>
-<div>
+#### \u{1F4A1} Progressive Hints (Expand only if stuck):
+<details>
+<summary><b>\u{1F4A1} Hint Level 1: Conceptual Clue (H\u01B0\u1EDBng t\u01B0 duy)</b></summary>
 
-### \u{1F947} Gold Tier
-- Design distributed retry queue
-- Add 95% automated test coverage
-- *Goal: Architectural leadership*
+{{GOLD_HINT_1}}
+</details>
 
-</div>
-</div>
+<details>
+<summary><b>\u{1F50D} Hint Level 2: Structural Skeleton (Khung code m\u1EABu)</b></summary>
 
-<!--
-Presenter Notes:
-- All learners begin at Bronze to establish baseline competency.
-- Accelerate self-directed learners to Silver and Gold as they complete each tier.
--->`
-  },
-  {
-    id: "agenda-timeline",
-    name: "Session Agenda & Milestones",
-    category: "content",
-    description: "Structured time-budgeted agenda mapping stages to measurable deliverables.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [80, 45, 1120, 65],
-          fontSize: "1.9rem"
-        },
-        {
-          id: "table-box",
-          target: "table",
-          pos: [80, 140, 1120, 520]
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [80, 45, 1120, 65]
-      fontSize: 1.9rem
-    - id: table-box
-      target: table
-      pos: [80, 140, 1120, 520]
--->
+\`\`\`{{CODE_LANGUAGE}}
+{{GOLD_HINT_2}}
+\`\`\`
+</details>
 
-## \u{1F5FA}\uFE0F Milestone Roadmap & Time Budget
+<details>
+<summary><b>\u{1F6A8} Hint Level 3: Full Solution & Explanation (L\u1EDDi gi\u1EA3i tr\u1ECDn v\u1EB9n)</b></summary>
 
-| Allocated Time | Session Stage | Core Learning Focus | Deliverable Milestone |
-|:---:|---|---|---|
-| **05 mins** | Warm-Up | Real-World Scenario & Context | Identify system bottleneck |
-| **15 mins** | Concept Discovery | Core Architectural Patterns | Deconstruct message queue models |
-| **20 mins** | Hands-On Lab | Tiered Code Implementation | Complete Bronze + Silver tasks |
-| **05 mins** | Wrap-Up | Formative Checkpoint & Debrief | Consolidate key principles |
+\`\`\`{{CODE_LANGUAGE}}
+{{GOLD_HINT_3_CODE}}
+\`\`\`
 
-<!--
-Presenter Notes:
-- Walk through the time budget so students understand expectations and pacing.
--->`
-  },
-  {
-    id: "takeaways-summary",
-    name: "Key Takeaways & Wrap-up",
-    category: "content",
-    description: "Three memorable synthesis takeaways with actionable next steps.",
-    layout: {
-      boxes: [
-        {
-          id: "heading",
-          target: "h2",
-          pos: [80, 50, 1120, 70],
-          fontSize: "2rem"
-        },
-        {
-          id: "list-box",
-          target: "ol",
-          pos: [80, 150, 1120, 340],
-          fontSize: "1.25rem"
-        },
-        {
-          id: "callout-next",
-          target: "blockquote",
-          pos: [80, 520, 1120, 140],
-          fontSize: "1.1rem"
-        }
-      ]
-    },
-    markdownSnippet: `<!-- layout:
-  boxes:
-    - id: heading
-      target: h2
-      pos: [80, 50, 1120, 70]
-      fontSize: 2rem
-    - id: list-box
-      target: ol
-      pos: [80, 150, 1120, 340]
-      fontSize: 1.25rem
-    - id: callout-next
-      target: blockquote
-      pos: [80, 520, 1120, 140]
-      fontSize: 1.1rem
--->
+**Why this solution works:**
+{{GOLD_HINT_3_EXPLANATION}}
+</details>
 
-## \u{1F3C1} Key Takeaways & Action Items
+---
 
-1. **Decouple Before Scaling:** Separate producer rate from consumer processing capacity.
-2. **Design for Failure:** Always configure retries, backoff intervals, and dead-letter queues.
-3. **Measure End-to-End:** Track P99 latency and error rates across all distributed boundaries.
+## \u{1F50D} Self-Learner Troubleshooting Matrix
+| Symptom / Error Message | Root Cause | Exact Fix |
+| :--- | :--- | :--- |
+{{TROUBLESHOOTING_ROWS}}
 
-> \u{1F4DD} **Next Action Item:** Complete the Silver Tier refactoring challenge before our next peer-review session.
+---
 
-<!--
-Presenter Notes:
-- Deliver a crisp 2-minute wrap-up reinforcing the 3 core takeaways.
-- Acknowledge strong peer collaboration during the hands-on lab.
--->`
-  }
-];
-function getSlideLayoutPresetById(id) {
-  return SLIDE_LAYOUT_PRESETS.find((p) => p.id === id);
-}
-function getSlideLayoutPresetsByCategory(category) {
-  return SLIDE_LAYOUT_PRESETS.filter((p) => p.category === category);
-}
+## \u{1F3C1} Final Lab Submission & Mastery Checklist
+{{FINAL_CHECKLIST}}
+`.trim();
 
 // src/ai/prompts/lessonMasterPrompt.ts
 function buildLessonMasterPrompt(input) {
@@ -27136,33 +25461,117 @@ function evaluateActivityAlignment(canonicalExcerpt, generatedContent, now = /*
   const passed = matchedTokens.length > 0;
   return { checked: true, passed, matchedTokens: matchedTokens.slice(0, 10), missingTokens: missingTokens.slice(0, 10), mode };
 }
-
-// src/services/lessonProductionService.ts
-var __filename2 = typeof (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) === "string" && typeof url.fileURLToPath === "function" ? url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))) : "";
-var _resolvedDir = __filename2 ? path3__default.default.dirname(__filename2) : typeof __dirname !== "undefined" ? __dirname : process.cwd();
-function loadCurriculumTemplate(templateName) {
-  const candidatePaths = [
-    path3__default.default.resolve("/Users/tonypham/MEGA/WebApp/WIP/learnwell-platform/packages/curriculum-kit/docs/refs/templates", templateName),
-    path3__default.default.resolve(process.cwd(), "packages/curriculum-kit/docs/refs/templates", templateName),
-    path3__default.default.resolve(process.cwd(), "_templates", templateName),
-    path3__default.default.resolve(process.cwd(), "docs/refs/templates", templateName),
-    path3__default.default.resolve(_resolvedDir, "../docs/refs/templates", templateName),
-    path3__default.default.resolve(_resolvedDir, "../../docs/refs/templates", templateName),
-    path3__default.default.resolve(_resolvedDir, "../../../docs/refs/templates", templateName),
-    path3__default.default.resolve("/Users/tonypham/MEGA/WebApp/content-gen/the-ultimate-curriculum-agent-os/_templates", templateName),
-    path3__default.default.resolve(_resolvedDir, "../../../../the-ultimate-curriculum-agent-os/_templates", templateName)
-  ];
-  for (const p of candidatePaths) {
-    if (fs2__default.default.existsSync(p)) {
-      try {
-        return fs2__default.default.readFileSync(p, "utf-8");
-      } catch {
-      }
+function stripTemplateFrontmatter(raw) {
+  let body = raw;
+  if (body.startsWith("---")) {
+    const end = body.indexOf("\n---", 3);
+    if (end !== -1) body = body.slice(end + 4);
+  }
+  return body.split("\n").filter((l) => l.trim() !== "<!-- INJECT_BODY -->").join("\n").replace(/^\s*\n/, "").trimEnd();
+}
+function extractRequiredSections(raw) {
+  const lines = raw.split("\n");
+  const start = lines.findIndex((l) => /^template_required_sections:\s*$/.test(l.trim()));
+  if (start === -1) return null;
+  const items = [];
+  for (let i = start + 1; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    if (line.trim() === "") continue;
+    if (!/^\s+-\s/.test(line)) break;
+    items.push(line.trim().replace(/^-\s+/, "").replace(/^["']|["']$/g, ""));
+  }
+  return items.length > 0 ? items : null;
+}
+function normalizeHeading2(h) {
+  return h.replace(/\[(REQUIRED|OPTIONAL|CONDITIONAL)\]\s*/gi, "").replace(/\s+/g, " ").trim();
+}
+function extractBodySections(raw) {
+  const body = stripTemplateFrontmatter(raw);
+  return body.split("\n").filter((l) => l.startsWith("## ")).map((l) => normalizeHeading2(l.slice(3).trim())).filter((s) => s.length > 0);
+}
+var KIT_TEMPLATE_FALLBACK_DIRS = [
+  // Packaged with the npm bundle (dist/templates) — resolves from node_modules.
+  "templates",
+  // Repo checkout layouts.
+  "docs/refs/templates"
+];
+var _moduleDir = (() => {
+  try {
+    if (typeof ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) }) !== "undefined" && typeof (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) === "string") {
+      return path3__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
     }
+  } catch {
+  }
+  return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+})();
+function candidateDirs(explicitDir) {
+  const dirs = [];
+  if (explicitDir) dirs.push(explicitDir);
+  if (process.env.CURRICULUM_TEMPLATES_DIR) dirs.push(process.env.CURRICULUM_TEMPLATES_DIR);
+  dirs.push(path3__default.default.resolve(process.cwd(), "_templates"));
+  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
+    dirs.push(path3__default.default.resolve(_moduleDir, rel));
+    dirs.push(path3__default.default.resolve(process.cwd(), rel));
+    dirs.push(path3__default.default.resolve(process.cwd(), "packages/curriculum-kit", rel));
+  }
+  return dirs;
+}
+function findTemplatePath(templateName, explicitDir) {
+  for (const dir of candidateDirs(explicitDir)) {
+    const p = path3__default.default.join(dir, templateName);
+    if (!fs2__default.default.existsSync(p)) continue;
+    try {
+      fs2__default.default.accessSync(p, fs2__default.default.constants.R_OK);
+      return p;
+    } catch {
+    }
+  }
+  return null;
+}
+function resolveArtifactTemplate(templateName, opts) {
+  const p = findTemplatePath(templateName, opts?.templatesDir);
+  if (!p) return null;
+  try {
+    const raw = fs2__default.default.readFileSync(p, "utf-8");
+    return {
+      content: stripTemplateFrontmatter(raw),
+      sections: extractRequiredSections(raw) ?? extractBodySections(raw),
+      sourcePath: p
+    };
+  } catch {
+    return null;
+  }
+}
+function loadCurriculumTemplate(templateName, templatesDir) {
+  const p = findTemplatePath(templateName, templatesDir);
+  if (!p) return "";
+  try {
+    return fs2__default.default.readFileSync(p, "utf-8");
+  } catch {
+    return "";
   }
-  console.warn(`[curriculum-kit:loadCurriculumTemplate] \u26A0\uFE0F Template "${templateName}" not found across candidate paths. Falling back to inline structural scaffolding.`);
-  return "";
 }
+
+// src/services/lessonProductionService.ts
+var LESSON_TEMPLATE_BY_PEDAGOGY = {
+  edp: "LESSON_EDP_template.md",
+  general: "LESSON_GENERAL_template.md",
+  pbl: "LESSON_GENERAL_template.md",
+  "5e": "LESSON_5E_template.md"
+};
+function buildArtifactPrompt(parts, opts) {
+  const resolved = resolveArtifactTemplate(parts.templateFile, opts);
+  const body = resolved?.content ?? parts.epilogue ?? "";
+  const source = resolved ? `
+<!-- P52 template: ${parts.templateFile} \u2190 ${resolved.sourcePath} -->
+` : "\n<!-- P52 template: NOT FOUND \u2014 inline fallback scaffold -->\n";
+  return `${parts.directive}${source}${body}`;
+}
+var NO_VERBATIM_COPYING = `
+VERBATIM SOURCING RULE: When a section in the template says to extract a table
+or list from the canonical knowledge context (KX/LESSON), copy that table
+VERBATIM \u2014 do not re-invent or paraphrase it. Every fact must live in exactly
+one canonical artifact; your document references, it does not restate.`;
 function detectProjectPedagogy(frameworkText, styleGuideText, explicitPedagogy) {
   if (explicitPedagogy) return explicitPedagogy;
   const combined = (frameworkText + " " + styleGuideText).toLowerCase();
@@ -27323,7 +25732,21 @@ ${nextRow}`
   return parts.join("\n\n") || framework.slice(0, 1500);
 }
 function buildLessonPrompt(pedagogy, lessonCode, unitCode, lessonTitle, concept, bloomLevel, dateStr, targetLanguage = "vi", sectionLanguageContract) {
-  const commonFrontmatter = `id: "LESSON_${lessonCode}"
+  const templateFile = LESSON_TEMPLATE_BY_PEDAGOGY[pedagogy] ?? "LESSON_5E_template.md";
+  const artifactType = templateFile.replace("_template.md", "");
+  const contract = resolveArtifactTemplate(templateFile)?.sections ?? [];
+  const sectionsYaml = contract.map((s) => `  - "${s}"`).join("\n");
+  const directive = `You are @content (Educational Content Editor & ${artifactType} Instructional Model Specialist).
+Author the comprehensive Master Lesson Plan \`LESSON_${lessonCode}.md\` for:
+- Lesson Code: ${lessonCode}
+- Title: ${lessonTitle}
+- Core Concept: ${concept}
+- Bloom Level: ${bloomLevel}
+
+Format requirements:
+1. EXACT YAML Frontmatter \u2014 copy verbatim, then fill in the blanks:
+---
+id: "LESSON_${lessonCode}"
 title: "${lessonTitle}"
 created_by: "Curriculum OS Builder"
 phase: "P3"
@@ -27334,182 +25757,25 @@ lesson_id: "${lessonCode}"
 unit_id: "${unitCode}"
 template_contract: "lesson-plan-v2"
 template_required_sections:
-  - "A. Lesson Design Plan"
-  - "Learning Objectives & Evidence"
-  - "Activity Sequence"
-  - "Resource Map"
-  - "Assessment Map"
-  - "Artifact Contract"
-  - "B. Lesson Flow"
-  - "Artifact Linkage"`;
-  let prompt = "";
-  if (pedagogy === "edp") {
-    prompt = `You are @content (Educational Content Editor & EDP Engineering Design Process Specialist).
-Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_EDP_template.md\` standards for:
-- Lesson Code: ${lessonCode}
-- Title: ${lessonTitle}
-- Core Concept: ${concept}
-- Bloom Level: ${bloomLevel}
-
-Mandatory Format Requirements:
-1. Standard YAML Frontmatter:
----
-${commonFrontmatter}
-type: "LESSON_EDP"
----
-2. Mandatory Document Structure:
-# LESSON [XX]: ${lessonTitle} (EDP Model - Engineering Design Process)
-
-## [REQUIRED] A. Lesson Design Plan
-
-### 1. Learning Objectives & Evidence
-- **Estimated Duration:** 90 minutes
-- **Project Objective:** [Complete engineering system or functional deliverable students build]
-- **Materials & Equipment:** [Detailed hardware, software libraries, and workstation tools]
-- **Learning Objectives Table:** (LO1, LO2 mapped with EDP Bloom level, Student Evidence, Success Criteria, and matching Standard ID from [STANDARDS STATEMENTS] if present, e.g. "CSTA: 1B-AP-10" or "CS2023-SDF-01")
-
-### 2. Activity Sequence
-> Activity Contract table with columns: Seq, EDP Phase (Ask, Imagine, Plan, Create, Test & Improve, Share & Evaluate), Activity Type, Actor, Purpose, Student Action, Teacher Move, Output/Evidence, LO, Time, Artifact Contract.
-
-### 3. Resource Map (Slide, Handout, Starter Code, Lab Tools)
-### 4. Assessment Map (Rubric criteria, formative checkpoints, remediation paths)
-### 5. Artifact Contract & Code Symbol Ledger
-- **Primary Struct / Class / Component:** [Explicit canonical identifier e.g. ProfileCardView]
-- **Entry Source File:** [Explicit file name e.g. ProfileCardView.swift]
-- **Key Functions & State Variables:** [Canonical identifiers used across all student activities]
-- **Artifact Specifications:** [Deliverable requirements for ACT, SLIDE, QUIZ, GUIDE, WKS, CODE, EXT]
-
----
-
-## [REQUIRED] B. Lesson Flow
-
-### 1. ASK \u2014 [10 mins] (Problem Statement, High-Stakes Real-World Context & Engineering Challenge)
-### 2. IMAGINE \u2014 [15 mins] (Brainstorming Design Alternatives & Trade-off Evaluation)
-### 3. PLAN \u2014 [15 mins] (System Block Diagrams, Module Architecture & Task Decomposition)
-### 4. CREATE \u2014 [25 mins] (Implementation / Verified 100% Executable Code Blueprint)
-### 5. TEST & IMPROVE \u2014 [15 mins] (Diagnostic Testing, Telemetry & Iterative Debugging)
-### 6. SHARE & EVALUATE \u2014 [10 mins] (Showcase, Metacognitive Reflection & Peer Evaluation)
-
----
-
-## [REQUIRED] Artifact Linkage (Master Index)
-Linkage ledger mapping all satellite artifacts (\`ACT_...\`, \`QUIZ_...\`, \`SLIDE_...\`, \`GUIDE_...\`).
-
-3. Ensure all sample code and schemas are 100% syntax-valid and executable.
-4. Output 100% clean Markdown directly.`;
-  } else if (pedagogy === "pbl" || pedagogy === "general") {
-    prompt = `You are @content (Educational Content Editor & PBL/General Pedagogy Specialist).
-Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_GENERAL_template.md\` standards for:
-- Lesson Code: ${lessonCode}
-- Title: ${lessonTitle}
-- Core Concept: ${concept}
-- Bloom Level: ${bloomLevel}
-
-Mandatory Format Requirements:
-1. Standard YAML Frontmatter:
----
-${commonFrontmatter}
-type: "LESSON_GENERAL"
----
-2. Mandatory Document Structure:
-# LESSON [XX]: ${lessonTitle}
-
-## [REQUIRED] A. Lesson Design Plan
-
-### 1. Learning Objectives & Evidence
-- **Estimated Duration:** 90 minutes
-- **Materials & Equipment:** [Tools, IDE, workstations, resources]
-- **Keywords / Core Concepts:** [Core domain terminology]
-- **Learning Objectives Table:** (LO1, LO2 with Bloom action verbs, Student Evidence, Success Criteria, and matching Standard ID from [STANDARDS STATEMENTS] if present, e.g. "CSTA: 1B-AP-10" or "CS2023-SDF-01")
-
-### 2. Activity Sequence
-> Activity Contract table with columns: Seq, Lesson Stage (Warm-up, Core Concepts, Guided Practice, Independent Practice, Wrap-up), Activity Type, Actor, Purpose, Student Action, Teacher Move, Output/Evidence, LO, Time, Artifact Contract.
-
-### 3. Resource Map
-### 4. Assessment Map
-### 5. Artifact Contract & Code Symbol Ledger
-- **Primary Struct / Class / Component:** [Explicit canonical identifier e.g. MainComponent]
-- **Entry Source File:** [Explicit file name e.g. MainComponent.ext]
-- **Key Functions & State Variables:** [Canonical identifiers used across all student activities]
-- **Artifact Specifications:** [Deliverable requirements for ACT, SLIDE, QUIZ, GUIDE, WKS, CODE, EXT]
-
----
-
-## [REQUIRED] B. Lesson Flow
-
-### 1. Warm-up & Hook \u2014 [10 mins]
-### 2. Core Concepts & Demo \u2014 [25 mins] (Accompanied by Mermaid Diagram or Code Blueprint)
-### 3. Guided Practice \u2014 [20 mins] (Step-by-step teacher-led scaffolding: I Do -> We Do)
-### 4. Independent Practice / Challenge \u2014 [25 mins] (Autonomous student lab / Mini-project)
-### 5. Wrap-up & Evaluation \u2014 [10 mins] (Synthesis & Formative Checkpoint)
-
----
-
-## [REQUIRED] Artifact Linkage (Master Index)
-Linkage ledger mapping all satellite artifacts (\`ACT_...\`, \`QUIZ_...\`, \`SLIDE_...\`).
-
-3. Output 100% clean Markdown directly.`;
-  } else {
-    prompt = `You are @content (Educational Content Editor & 5E Instructional Model Specialist).
-Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_5E_template.md\` standards for:
-- Lesson Code: ${lessonCode}
-- Title: ${lessonTitle}
-- Core Concept: ${concept}
-- Bloom Level: ${bloomLevel}
-
-Mandatory Format Requirements:
-1. Standard YAML Frontmatter:
----
-${commonFrontmatter}
-type: "LESSON_5E"
----
-2. Mandatory Document Structure:
-# LESSON [XX]: ${lessonTitle} (5E Model)
-
-## [REQUIRED] A. Lesson Design Plan
-
-### 1. Learning Objectives & Evidence
-- **Estimated Duration:** 90 minutes
-- **Materials & Equipment:** [Tools, IDE, hardware/software specifications]
-- **Keywords / Core Concepts:** [Core domain terminology]
-- **Learning Objectives Table:** (LO1, LO2 with Bloom action verbs, Student Evidence, Success Criteria, and matching Standard ID from [STANDARDS STATEMENTS] if present, e.g. "CSTA: 1B-AP-10" or "CS2023-SDF-01")
-
-### 2. Activity Sequence
-> Activity Contract table with columns: Seq, 5E Phase (Engage, Explore, Explain, Elaborate, Evaluate), Activity Type, Actor, Purpose, Student Action, Teacher Move, Output/Evidence, LO, Time, Artifact Contract.
-
-### 3. Resource Map
-### 4. Assessment Map
-### 5. Artifact Contract & Code Symbol Ledger
-- **Primary Struct / Class / Component:** [Explicit canonical identifier e.g. MainComponent]
-- **Entry Source File:** [Explicit file name e.g. MainComponent.ext]
-- **Key Functions & State Variables:** [Canonical identifiers used across all student activities]
-- **Artifact Specifications:** [Deliverable requirements for ACT, SLIDE, QUIZ, GUIDE, WKS, CODE, EXT]
-
----
-
-## [REQUIRED] B. Lesson Flow
-
-### 1. ENGAGE \u2014 [10 mins] (High-Stakes Hook Scenario, Inquiry Question, Transition)
-### 2. EXPLORE \u2014 [20 mins] (Inquiry-Based Discovery, Hands-on Sandbox)
-### 3. EXPLAIN \u2014 [25 mins] (Core Definitions, Relatable Analogies, Mermaid Diagram & Code Blueprints)
-### 4. ELABORATE \u2014 [25 mins] (3-Tier Differentiated Scaffolding: \u{1F949} Bronze, \u{1F948} Silver, \u{1F947} Gold tasks)
-### 5. EVALUATE \u2014 [10 mins] (Exit Ticket, Metacognitive Reflection)
-
+${sectionsYaml}
+type: "${artifactType}"
 ---
-
-## [REQUIRED] Artifact Linkage (Master Index)
-Linkage ledger mapping all satellite artifacts (\`GUIDE_...\`, \`SLIDE_...\`, \`HANDOUT_...\`, \`ACT_...\`, \`WKS_...\`, \`QUIZ_...\`, \`EXT_...\`).
-
-3. Ensure all sample code and syntax are 100% verified and runnable.
-4. Output 100% clean Markdown directly.`;
-  }
+2. Fill in the template body below. Keep every header EXACTLY as written
+   ([REQUIRED]/[CONDITIONAL] markers and canonical English headings included)
+   and respect the template's OWNERSHIP note: each fact lives in exactly ONE
+   section \u2014 never restate satellite lists, resources, or assessment content
+   across sections, and never embed KX-owned question banks or self-check text.
+3. Use the exact vocabulary of the canonical knowledge context for every
+   concept and term.
+${NO_VERBATIM_COPYING}`;
   const langDirective = buildLanguageDirective(targetLanguage);
   const headingDirective = buildHeadingDirective(
     pedagogy === "edp" ? "LESSON_EDP" : pedagogy === "general" || pedagogy === "pbl" ? "LESSON_GENERAL" : "LESSON_5E",
     sectionLanguageContract,
     targetLanguage
   );
-  return `${prompt}
+  const body = buildArtifactPrompt({ directive, templateFile });
+  return `${body}
 
 ${langDirective}${headingDirective ? `
 
@@ -28256,10 +26522,10 @@ ${currentContent}` }],
   if (artifactScope.includes("ACT") && (!existingAct || force || isStaleVsPlan(existingAct))) {
     onProgress?.("@activity", `[2/4] Authoring Hands-on Lab: \`ACT_${lessonCode}.md\`...`);
     const actDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    const actPrompt = `You are @activity (Lead Hands-on STEM & Laboratory Exercise Designer).
+    const actDirective = `You are @activity (Lead Hands-on STEM & Laboratory Exercise Designer).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, author the comprehensive hands-on lab guide: \`ACT_${lessonCode}.md\`.
 
-Mandatory Format Requirements:
+Format requirements:
 1. EXACT YAML Frontmatter \u2014 copy verbatim, then fill in the blanks:
 ---
 id: "ACT_${lessonCode}"
@@ -28280,17 +26546,14 @@ template_required_sections:
   - "Reflection"
 ---
 
-2. Mandatory sections (matching ACT_template.md):
-   - ## [REQUIRED] Computational Thinking Focus (Problem statement, decomposition, algorithm design)
-   - ## [REQUIRED] Materials & Setup (Hardware BOM with <!-- [HARDWARE_BOM] --> marker, software, consumables)
-   - ## [REQUIRED] Constraints & Safety (Technical/safety warnings, design constraints)
-   - ## [REQUIRED] Active Learning Workflow with 3 phases:
-     - ### Phase 1: Planning & Design
-     - ### Phase 2: Implementation & Discovery
-     - ### Phase 3: Debugging & Testing
-   - ## [REQUIRED] 3-Tier Differentiation (Bronze/Silver/Gold tasks)
-   - ## [REQUIRED] Reflection (Discussion question)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+2. Fill in the ACT template body below. Keep every header EXACTLY as written.
+   Physical hardware belongs inside the \`<!-- [HARDWARE_BOM] -->\` marker ONLY
+   when this lesson's activity contract involves physical wiring; otherwise
+   list software/consumables only.
+3. Expand the Activity Contract rows the LESSON assigns to this artifact \u2014 do
+   not invent a different sequence.
+${NO_VERBATIM_COPYING}`;
+    const actPrompt = `${buildArtifactPrompt({ directive: actDirective, templateFile: "ACT_template.md" })}
 
 ${languageDirective}
 
@@ -28327,7 +26590,7 @@ ${buildHeadingDirective("ACT", slcMarkdown, targetLang)}`;
   if (artifactScope.includes("QUIZ") && (!existingQuiz || force || isStaleVsPlan(existingQuiz))) {
     onProgress?.("@assessor", `[3/4] Authoring Assessment Bank: \`QUIZ_${lessonCode}.md\`...`);
     const quizDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    const quizPrompt = `You are @assessor (Lead Psychometrician & Competency Assessment Specialist).
+    const quizDirective = `You are @assessor (Lead Psychometrician & Competency Assessment Specialist).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, author the scenario-based diagnostic question bank: \`QUIZ_${lessonCode}.md\`.
 
 SCOPE & PACING (prompt audit S-6):
@@ -28335,7 +26598,7 @@ SCOPE & PACING (prompt audit S-6):
 - Size the bank to fit the session's Wrap-up (~10 minutes of answering): the MCQ bank, code-tracing question, and rubric together must be completable by a student in that time.
 - Question ONLY concepts inside this session's scope (see SESSION SLICE + ALLOWED DESIGN SPACE in the context).
 
-Mandatory Format Requirements:
+Format requirements:
 1. EXACT YAML Frontmatter \u2014 copy verbatim, then fill in the blanks:
 ---
 id: "QUIZ_${lessonCode}"
@@ -28354,13 +26617,14 @@ template_required_sections:
   - "Competency Rubric"
 ---
 
-2. Mandatory sections (matching QUIZ_v4.6_template.md):
-   - ## 1. Metadata Specs (Lesson ID, Bloom target levels, language)
-   - ## [REQUIRED] Assessment Objectives (Bloom taxonomy aligned goals for each LO)
-   - ## [REQUIRED] Multiple-Choice Question Bank (\u22655 scenario-based 4-option questions with: Question text, A/B/C/D options, Correct answer, Bloom level, Detailed distractor rationale)
-   - ## [REQUIRED] Code Analysis / Debugging Question (1 deep code tracing question requiring students to predict output or identify bugs)
-   - ## [REQUIRED] Competency Rubric (4-tier matrix: Developing \u2192 Proficient \u2192 Advanced \u2192 Exemplary)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+2. Fill in the QUIZ template body below. Keep every header EXACTLY as written.
+   The Assessment Objectives table MUST reuse the LESSON A1 Learning
+   Objectives verbatim \u2014 same Bloom verbs, same evidence. Do NOT re-target the
+   Bloom level (drift guard: quiz Bloom = lesson Bloom).
+3. Every distractor must be a real misconception from this lesson's Common
+   Mistakes \u2014 never random filler.
+${NO_VERBATIM_COPYING}`;
+    const quizPrompt = `${buildArtifactPrompt({ directive: quizDirective, templateFile: "QUIZ_v4.6_template.md" })}
 
 ${languageDirective}
 
@@ -28535,10 +26799,10 @@ footer: "Curriculum OS \u2022 ${lessonCode} (${pedagogyLabel})"
   if (artifactScope.includes("GUIDE") && (!existingGuide || force || isStaleVsPlan(existingGuide))) {
     onProgress?.("@content", `Authoring Teacher Guide: \`GUIDE_${lessonCode}.md\`...`, { artifactType: "GUIDE" });
     const guideDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    const guidePrompt = `You are @content (Senior Curriculum Developer & Teacher Facilitation Specialist).
+    const guideDirective = `You are @content (Senior Curriculum Developer & Teacher Facilitation Specialist).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\` and pedagogical context, author the comprehensive Teacher Guide: \`GUIDE_${lessonCode}.md\`.
 
-Mandatory Format Requirements:
+Format requirements:
 1. EXACT YAML Frontmatter \u2014 copy verbatim, then fill in the blanks:
 ---
 id: "GUIDE_${lessonCode}"
@@ -28550,15 +26814,22 @@ deliverable: "P3-T5"
 version: "v1.0"
 date: "${guideDateStr}"
 template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Objectives & Preparation"
+  - "Preparation Checklist & Workstation Setup"
+  - "Facilitation Script & Timeline"
+  - "Common Misconceptions & Diagnostic Remediation Matrix"
+  - "Differentiated Support Strategies"
 ---
 
-2. Mandatory sections (matching GUIDE_template.md):
-   - ## [REQUIRED] Objectives & Preparation (Pedagogical goal, common blindspots, technical checklist)
-   - ## [REQUIRED] Preparation Checklist & Workstation Setup
-   - ## [REQUIRED] Facilitation Script & Timeline (Phase-by-phase teacher moves, inquiry questions, transitions)
-   - ## [REQUIRED] Common Misconceptions & Diagnostic Remediation Matrix
-   - ## [REQUIRED] Differentiated Support Strategies (Support scaffolds vs Extension challenges)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+2. Fill in the GUIDE template body below. Keep every header EXACTLY as written.
+   - The Facilitation timeline MUST mirror the LESSON B-flow phase-by-phase \u2014
+     same phases, same minutes. Do not invent a different allocation.
+   - Misconceptions have ONE home: the Remediation Matrix. Extract the Common
+     Mistakes table VERBATIM from the canonical knowledge context; do not
+     restate them in Objectives & Preparation.
+${NO_VERBATIM_COPYING}`;
+    const guidePrompt = `${buildArtifactPrompt({ directive: guideDirective, templateFile: "GUIDE_template.md" })}
 
 ${languageDirective}
 
@@ -28587,10 +26858,10 @@ ${buildHeadingDirective("GUIDE", slcMarkdown, targetLang)}`;
   if (artifactScope.includes("HANDOUT") && (!existingHandout || force || isStaleVsPlan(existingHandout))) {
     onProgress?.("@content", `Authoring Student Handout: \`HANDOUT_${lessonCode}.md\`...`, { artifactType: "HANDOUT" });
     const handoutDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    const handoutPrompt = `You are @content (Educational Content Specialist).
+    const handoutDirective = `You are @content (Educational Content Specialist).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, author the student self-paced reference handout: \`HANDOUT_${lessonCode}.md\`.
 
-Mandatory Format Requirements:
+Format requirements:
 1. EXACT YAML Frontmatter \u2014 copy verbatim, then fill in the blanks:
 ---
 id: "HANDOUT_${lessonCode}"
@@ -28602,15 +26873,19 @@ deliverable: "P3-T6"
 version: "v1.0"
 date: "${handoutDateStr}"
 template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Core Concepts"
+  - "Core Syntax & Mechanism Cheat Sheet"
+  - "Visual Mental Model / Architecture Diagram"
+  - "Step-by-Step Practical Quick-Start Guide"
+  - "Self-Check Diagnostic Checklist"
 ---
 
-2. Mandatory sections (matching HANDOUT_template.md):
-   - ## [REQUIRED] \u{1F4D6} Core Concepts (Key terms, definitions, and student-friendly explanations)
-   - ## [REQUIRED] Core Syntax & Mechanism Cheat Sheet (Quick-scan reference table)
-   - ## [REQUIRED] Visual Mental Model / Architecture Diagram (Mermaid or ASCII diagram)
-   - ## [REQUIRED] Step-by-Step Practical Quick-Start Guide
-   - ## [REQUIRED] Self-Check Diagnostic Checklist (Can-do statements for student self-assessment)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+2. Fill in the HANDOUT template body below. Keep every header EXACTLY as
+   written. Align term definitions with the canonical knowledge context (KX
+   Key Terms) and can-do statements with the LESSON A1 evidence column.
+${NO_VERBATIM_COPYING}`;
+    const handoutPrompt = `${buildArtifactPrompt({ directive: handoutDirective, templateFile: "HANDOUT_template.md" })}
 
 ${languageDirective}
 
@@ -28639,10 +26914,10 @@ ${buildHeadingDirective("HANDOUT", slcMarkdown, targetLang)}`;
   if (artifactScope.includes("WKS") && (!existingWks || force || isStaleVsPlan(existingWks))) {
     onProgress?.("@content", `Authoring Student Worksheet: \`WKS_${lessonCode}.md\`...`, { artifactType: "WKS" });
     const wksDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    const wksPrompt = `You are @content (Instructional Activity & Worksheet Designer).
+    const wksDirective = `You are @content (Instructional Activity & Worksheet Designer).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, author the guided student worksheet: \`WKS_${lessonCode}.md\`.
 
-Mandatory Format Requirements:
+Format requirements:
 1. EXACT YAML Frontmatter \u2014 copy verbatim, then fill in the blanks:
 ---
 id: "WKS_${lessonCode}"
@@ -28654,19 +26929,19 @@ deliverable: "P3-T7"
 version: "v1.0"
 date: "${wksDateStr}"
 template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Part 1: Knowledge Check"
+  - "Part 2: Concept Tracing & Diagram Fill-in"
+  - "Part 3: Code Analysis & Bug Hunting Challenge"
+  - "Part 4: Synthesis & Problem-Solving Application"
+  - "Part 5: Self-Reflection & Learning Log"
 ---
 
-**Student Name:** _______________________  **Class:** _______________  **Date:** _______________
-
-> **For Students:** This document guides you step-by-step through the practical tasks. Read carefully, fill in the blanks, and mark the checkbox [x] once completed. If you encounter errors, refer back to your **HANDOUT**.
-
-2. Mandatory sections (matching WKS_template.md):
-   - ## [REQUIRED] Part 1: Knowledge Check (Warm-up \u2014 Prior knowledge retrieval tasks)
-   - ## [REQUIRED] Part 2: Concept Tracing & Diagram Fill-in
-   - ## [REQUIRED] Part 3: Code Analysis & Bug Hunting Challenge
-   - ## [REQUIRED] Part 4: Synthesis & Problem-Solving Application
-   - ## [REQUIRED] Part 5: Self-Reflection & Learning Log
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+2. Fill in the WKS template body below (including the student name/class/date
+   header line). Keep every header EXACTLY as written. The Part 3 bug must be
+   a real mistake from this lesson's Common Mistakes table.
+${NO_VERBATIM_COPYING}`;
+    const wksPrompt = `${buildArtifactPrompt({ directive: wksDirective, templateFile: "WKS_template.md" })}
 
 ${languageDirective}
 
@@ -28695,10 +26970,10 @@ ${buildHeadingDirective("WKS", slcMarkdown, targetLang)}`;
   if ((artifactScope.includes("CODE") || artifactScope.includes("CODE_LAB")) && (!existingCode || force || isStaleVsPlan(existingCode))) {
     onProgress?.("@activity", `Authoring Executable Code Lab: \`CODE_${lessonCode}.md\`...`, { artifactType: "CODE" });
     const codeDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    const codePrompt = `You are @activity & @tech_sme (Lead Software Engineer & Technical SME).
+    const codeDirective = `You are @activity & @tech_sme (Lead Software Engineer & Technical SME).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, hardware platform, and starter code requirements, author the comprehensive executable Code Lab: \`CODE_${lessonCode}.md\`.
 
-Mandatory Format Requirements:
+Format requirements:
 1. EXACT YAML Frontmatter \u2014 copy verbatim, then fill in the blanks:
 ---
 id: "CODE_${lessonCode}"
@@ -28719,14 +26994,17 @@ template_required_sections:
   - "Common Syntax & Runtime Pitfalls Matrix"
 ---
 
-2. Mandatory sections:
-   - ## [REQUIRED] Technical Overview & Architecture Blueprint
-   - ## [REQUIRED] Hardware Pinout & Wiring Configuration Matrix
-   - ## [REQUIRED] Starter Code Sandbox (Skeleton code with explicit TODO comments for students)
-   - ## [REQUIRED] Verified Reference Solution Code (100% syntactically valid, production-ready, fully commented)
-   - ## [REQUIRED] Automated Test / Verification Script (How to compile, flash, or unit test)
-   - ## [REQUIRED] Common Syntax & Runtime Pitfalls Matrix
-3. Output 100% clean Markdown directly with runnable code snippets \u2014 NO outer code fences around the document.
+2. Fill in the CODE template body below. Keep every header EXACTLY as written.
+   - The Hardware Pinout & Wiring section is [CONDITIONAL]: include it ONLY
+     when this lesson's activity contract involves physical hardware wiring.
+     For pure-software lessons OMIT the entire section \u2014 never emit placeholder
+     wiring tables.
+   - Starter/Solution code MUST implement the exact Activity Contract rows the
+     LESSON assigns to CODE_LAB, using the LESSON Code Symbol Ledger
+     identifiers verbatim.
+3. Output runnable code snippets \u2014 NO outer code fences around the document.
+${NO_VERBATIM_COPYING}`;
+    const codePrompt = `${buildArtifactPrompt({ directive: codeDirective, templateFile: "CODE_template.md" })}
 
 ${languageDirective}
 
@@ -32077,7 +30355,8 @@ var DeterministicStructuralLinter = class {
     const hasHeavyTech = heavyKeywords.some((k) => allTechStrings.includes(k));
     if (hasHeavyTech) {
       const declaredStrategy = scope?.provisioning_strategy || scope?.provisioning_model || graph.project?.provisioning_strategy;
-      const isValidStrategy = ENVIRONMENT_PROVISIONING_MODELS.includes(declaredStrategy);
+      const normalizedStrategy = String(declaredStrategy || "").trim().toUpperCase().replace(/[-\s]/g, "_");
+      const isValidStrategy = ENVIRONMENT_PROVISIONING_MODELS.includes(normalizedStrategy);
       if (!isValidStrategy) {
         score -= 15;
         findings.push({
@@ -32089,7 +30368,7 @@ var DeterministicStructuralLinter = class {
           remediationAdvice: `Specify provisioning_strategy as PRE_INSTALLED_LAB, CLOUD_MANAGED, or DEDICATED_SETUP to ensure classroom feasibility.`
         });
       } else {
-        strengths.push(`Heavy technology stack backed by explicit provisioning model: ${declaredStrategy}`);
+        strengths.push(`Heavy technology stack backed by explicit provisioning model: ${normalizedStrategy}`);
       }
     }
     score = Math.max(0, Math.min(100, score));
@@ -33743,9 +32022,7 @@ exports.ActivityStepSchema = ActivityStepSchema;
 exports.ArtifactContractRowSchema = ArtifactContractRowSchema;
 exports.AssessmentMapRowSchema = AssessmentMapRowSchema;
 exports.AssessmentObjectiveSchema = AssessmentObjectiveSchema;
-exports.BELL_RINGER_TEMPLATE = BELL_RINGER_TEMPLATE;
 exports.BLOOM_ACTION_VERBS = BLOOM_ACTION_VERBS;
-exports.BOM_TEMPLATE = BOM_TEMPLATE;
 exports.BUNDLED_STANDARDS_PACK_IDS = BUNDLED_STANDARDS_PACK_IDS;
 exports.BellRingerDaySchema = BellRingerDaySchema;
 exports.BellRingerSchema = BellRingerSchema;
@@ -33754,7 +32031,6 @@ exports.BloomLevelSchema = BloomLevelSchema;
 exports.BloomTaxonomyEvaluator = BloomTaxonomyEvaluator;
 exports.BronzeTierSchema = BronzeTierSchema;
 exports.CERConclusionSchema = CERConclusionSchema;
-exports.CHOICE_BOARD_TEMPLATE = CHOICE_BOARD_TEMPLATE;
 exports.CODE_LAB_TEMPLATE = CODE_LAB_TEMPLATE;
 exports.CURRICULUM_SLASH_COMMANDS = CURRICULUM_SLASH_COMMANDS;
 exports.CardTierEnum = CardTierEnum;
@@ -33795,9 +32071,7 @@ exports.DiagnosticQuestionSchema = DiagnosticQuestionSchema;
 exports.DiagnosticQuizSchema = DiagnosticQuizSchema;
 exports.EDPPhaseEnum = EDPPhaseEnum;
 exports.ENVIRONMENT_PROVISIONING_MODELS = ENVIRONMENT_PROVISIONING_MODELS;
-exports.EXIT_TICKET_TEMPLATE = EXIT_TICKET_TEMPLATE;
 exports.EXPOSITION_REL = EXPOSITION_REL;
-exports.EXT_TEMPLATE = EXT_TEMPLATE;
 exports.EntryLevelSchema = EntryLevelSchema;
 exports.ExitTicketBugHuntSchema = ExitTicketBugHuntSchema;
 exports.ExitTicketMetacognitionSchema = ExitTicketMetacognitionSchema;
@@ -33816,8 +32090,6 @@ exports.FrameworkMappingSchema = FrameworkMappingSchema;
 exports.FrameworkPackManifestSchema = FrameworkPackManifestSchema;
 exports.FrameworkPackSchema = FrameworkPackSchema;
 exports.FrameworkStatementSchema = FrameworkStatementSchema;
-exports.GLOSSARY_TEMPLATE = GLOSSARY_TEMPLATE;
-exports.GRAPHIC_ORGANIZER_TEMPLATE = GRAPHIC_ORGANIZER_TEMPLATE;
 exports.GlossaryQuickRefRowSchema = GlossaryQuickRefRowSchema;
 exports.GlossarySchema = GlossarySchema;
 exports.GlossaryTermSchema = GlossaryTermSchema;
@@ -33825,7 +32097,6 @@ exports.GoldTierSchema = GoldTierSchema;
 exports.GradeBandSchema = GradeBandSchema;
 exports.GraphicOrganizerItemSchema = GraphicOrganizerItemSchema;
 exports.GraphicOrganizerSchema = GraphicOrganizerSchema;
-exports.HANDOUT_TEMPLATE = HANDOUT_TEMPLATE;
 exports.HandoutSchema = HandoutSchema;
 exports.HandoutSectionSchema = HandoutSectionSchema;
 exports.InstructionSectionSchema = InstructionSectionSchema;
@@ -33864,7 +32135,6 @@ exports.MisconceptionSchema = MisconceptionSchema;
 exports.ModelPolicyResolver = ModelPolicyResolver;
 exports.NodeKindSchema = NodeKindSchema;
 exports.OrganizerTypeEnum = OrganizerTypeEnum;
-exports.PROJECT_INSTRUCTION_TEMPLATE = PROJECT_INSTRUCTION_TEMPLATE;
 exports.PhaseInputSchema = PhaseInputSchema;
 exports.PlanConstraintsSchema = PlanConstraintsSchema;
 exports.PlannerInputSchema = PlannerInputSchema;
@@ -33881,8 +32151,6 @@ exports.ProjectProfileSchema = ProjectProfileSchema;
 exports.QUIZ_TEMPLATE = QUIZ_TEMPLATE;
 exports.QualityAuditVerdictSchema = QualityAuditVerdictSchema;
 exports.QuizOptionSchema = QuizOptionSchema;
-exports.REVIEW_GAME_TEMPLATE = REVIEW_GAME_TEMPLATE;
-exports.RUBRIC_TEMPLATE = RUBRIC_TEMPLATE;
 exports.RecordProvenanceSchema = RecordProvenanceSchema;
 exports.ResourceMapRowSchema = ResourceMapRowSchema;
 exports.ReviewGameExportRowSchema = ReviewGameExportRowSchema;
@@ -33893,14 +32161,10 @@ exports.RotationStationSchema = RotationStationSchema;
 exports.RubricCriteriaSchema = RubricCriteriaSchema;
 exports.RubricSchema = RubricSchema;
 exports.SATELLITE_LESSON_PRIORITIES = SATELLITE_LESSON_PRIORITIES;
-exports.SCIENCE_LAB_TEMPLATE = SCIENCE_LAB_TEMPLATE;
 exports.SELF_LAB_TEMPLATE = SELF_LAB_TEMPLATE;
 exports.SLIDE_CANONICAL_METHODOLOGY = SLIDE_CANONICAL_METHODOLOGY;
-exports.SLIDE_LAYOUT_PRESETS = SLIDE_LAYOUT_PRESETS;
-exports.SLIDE_TEMPLATE = SLIDE_TEMPLATE;
 exports.STANDARD_REF_REGEX = STANDARD_REF_REGEX;
 exports.STANDARD_SOT_FILES = STANDARD_SOT_FILES;
-exports.STATION_ROTATION_TEMPLATE = STATION_ROTATION_TEMPLATE;
 exports.STUDENT_FRICTION_MULTIPLIER = STUDENT_FRICTION_MULTIPLIER;
 exports.ScaffoldDecisionEntrySchema = ScaffoldDecisionEntrySchema;
 exports.ScaffoldDecisionSchema = ScaffoldDecisionSchema;
@@ -33919,9 +32183,6 @@ exports.StationRecordRowSchema = StationRecordRowSchema;
 exports.StationRotationSchema = StationRotationSchema;
 exports.StationTypeEnum = StationTypeEnum;
 exports.SupabaseCurriculumAdapter = SupabaseCurriculumAdapter;
-exports.TASK_CARDS_TEMPLATE = TASK_CARDS_TEMPLATE;
-exports.TEACHER_GUIDE_TEMPLATE = TEACHER_GUIDE_TEMPLATE;
-exports.TIERED_PRACTICE_TEMPLATE = TIERED_PRACTICE_TEMPLATE;
 exports.TaskCardSchema = TaskCardSchema;
 exports.TaskCardsSchema = TaskCardsSchema;
 exports.TeacherGuideSchema = TeacherGuideSchema;
@@ -33934,7 +32195,6 @@ exports.TroubleshootingEntrySchema = TroubleshootingEntrySchema;
 exports.TroubleshootingRowSchema = TroubleshootingRowSchema;
 exports.UnitPlanSchema = UnitPlanSchema;
 exports.UserJourneySchema = UserJourneySchema;
-exports.WORKSHEET_TEMPLATE = WORKSHEET_TEMPLATE;
 exports.WalkingSkeletonSchema = WalkingSkeletonSchema;
 exports.WorksheetItemSchema = WorksheetItemSchema;
 exports.WorksheetItemTypeEnum = WorksheetItemTypeEnum;
@@ -33953,6 +32213,7 @@ exports.auditCurriculumQualityFlow = auditCurriculumQualityFlow;
 exports.auditProjectGraphFlow = auditProjectGraphFlow;
 exports.auditQualityReport = auditQualityReport;
 exports.buildActivityPrompt = buildActivityPrompt;
+exports.buildArtifactPrompt = buildArtifactPrompt;
 exports.buildCodeLabPrompt = buildCodeLabPrompt;
 exports.buildConceptPrerequisites = buildConceptPrerequisites;
 exports.buildCurriculumContext = buildCurriculumContext;
@@ -34019,8 +32280,10 @@ exports.exportAllProjectQuizzes = exportAllProjectQuizzes;
 exports.expositionCacheKey = expositionCacheKey;
 exports.extractActivityContractRows = extractActivityContractRows;
 exports.extractAssessmentMap = extractAssessmentMap;
+exports.extractBodySections = extractBodySections;
 exports.extractCurriculumHorizon = extractCurriculumHorizon;
 exports.extractJsonArray = extractJsonArray;
+exports.extractRequiredSections = extractRequiredSections;
 exports.extractScopeSequenceRows = extractScopeSequenceRows;
 exports.extractSectionHeadingsFromSLC = extractSectionHeadingsFromSLC;
 exports.extractSessionSlice = extractSessionSlice;
@@ -34059,8 +32322,6 @@ exports.getDesignatedFallbackConfig = getDesignatedFallbackConfig;
 exports.getLessonMetadata = getLessonMetadata;
 exports.getProjectArtifactScope = getProjectArtifactScope;
 exports.getProjectStatusReport = getProjectStatusReport;
-exports.getSlideLayoutPresetById = getSlideLayoutPresetById;
-exports.getSlideLayoutPresetsByCategory = getSlideLayoutPresetsByCategory;
 exports.getSmartResumeContext = getSmartResumeContext;
 exports.glossaryTermsForSession = glossaryTermsForSession;
 exports.illustratorTools = illustratorTools;
@@ -34097,6 +32358,7 @@ exports.renderHorizonPromptBlock = renderHorizonPromptBlock;
 exports.renderMediaPlaceholder = renderMediaPlaceholder;
 exports.researcherTools = researcherTools;
 exports.resolveApiKey = resolveApiKey;
+exports.resolveArtifactTemplate = resolveArtifactTemplate;
 exports.resolveGateSettings = resolveGateSettings;
 exports.resolveStandardsPacks = resolveStandardsPacks;
 exports.resolveStreamBudget = resolveStreamBudget;
@@ -34124,6 +32386,7 @@ exports.streamLayerPrefillWithFallback = streamLayerPrefillWithFallback;
 exports.streamLessonMasterFlow = streamLessonMasterFlow;
 exports.streamSelfLabFlow = streamSelfLabFlow;
 exports.stripLlmJsonWrappers = stripLlmJsonWrappers;
+exports.stripTemplateFrontmatter = stripTemplateFrontmatter;
 exports.targetLanguageDisplayName = targetLanguageDisplayName;
 exports.techSmeTools = techSmeTools;
 exports.topoSort = topoSort;