@thanh01.pmt/curriculum-kit 1.4.43 → 1.4.44

package/dist/ai/index.mjs

@@ -1,8 +1,9 @@
 import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import { createOpenAI } from '@ai-sdk/openai';
 import { createDeepSeek } from '@ai-sdk/deepseek';
-import fs from 'fs';
+import fs2 from 'fs';
 import path from 'path';
+import { fileURLToPath } from 'url';
 import { generateObject, streamObject } from 'ai';
 import { z } from 'zod';
 
@@ -126,8 +127,8 @@ function resolveApiKey(keyName, explicitKey) {
       path.resolve(currentDir, "../..", ".env")
     ];
     for (const envPath of envPaths) {
-      if (fs.existsSync(envPath)) {
-        const content = fs.readFileSync(envPath, "utf-8");
+      if (fs2.existsSync(envPath)) {
+        const content = fs2.readFileSync(envPath, "utf-8");
         for (const line of content.split("\n")) {
           const trimmed = line.trim();
           if (trimmed && !trimmed.startsWith("#") && trimmed.startsWith(keyName + "=")) {
@@ -1107,467 +1108,61 @@ function detectDefaultProvider() {
   }
   return getDesignatedFallbackConfig().provider;
 }
-
-// src/templates/lessonTemplate.ts
-var LESSON_PLAN_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "LESSON_5E"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T1"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-prerequisite: []
-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"
----
-<!-- INJECT_BODY -->
-
-# LESSON [{{LESSON_ID}}]: {{TITLE}} (5E Model)
-
-## [REQUIRED] A. Lesson Design Plan
-
-### 1. Learning Objectives & Evidence
-- **Estimated Duration:** {{DURATION}}
-- **Materials & Equipment:** {{MATERIALS_SUMMARY}}
-- **Keywords / Core Concepts:** {{KEYWORDS}}
-
-| LO | Objective (Bloom's) | Student Evidence | Success Criteria |
-|---|---|---|---|
-{{LEARNING_OBJECTIVES_TABLE_ROWS}}
-
-### 2. Activity Sequence
-> This is the canonical activity contract. Satellite artifacts must expand this sequence and must not invent a different one.
-
-| Seq | 5E Phase | Activity Type | Actor | Purpose | Student Action | Teacher Move | Output/Evidence | LO | Time | Artifact Contract |
-|---|---|---|---|---|---|---|---|---|---|---|
-{{ACTIVITY_SEQUENCE_TABLE_ROWS}}
-
-### 3. Resource Map
-| Resource | Used In Activity | Purpose | Owner Artifact |
-|---|---|---|---|
-{{RESOURCE_MAP_TABLE_ROWS}}
-
-### 4. Assessment Map
-| Evidence | Assessed By | Criteria | Follow-up If Missing |
-|---|---|---|---|
-{{ASSESSMENT_MAP_TABLE_ROWS}}
-
-### 5. Artifact Contract
-- **ACT must expand:** {{ACT_CONTRACT}}
-- **GUIDE must support:** {{GUIDE_CONTRACT}}
-- **SLIDE must visualize:** {{SLIDE_CONTRACT}}
-- **HANDOUT must provide:** {{HANDOUT_CONTRACT}}
-- **WKS must practice:** {{WKS_CONTRACT}}
-- **QUIZ must assess:** {{QUIZ_CONTRACT}}
-- **EXT must extend:** {{EXT_CONTRACT}}
-
----
-
-## [REQUIRED] B. Lesson Flow
-
-### 1. ENGAGE \u2014 {{ENGAGE_DURATION}} mins
-- **Hook Scenario:** {{HOOK_SCENARIO}}
-- **Open Question:** {{HOOK_OPEN_QUESTION}}
-- **Transition:** {{HOOK_TRANSITION}}
-
-### 2. EXPLORE \u2014 {{EXPLORE_DURATION}} mins
-- **Activity Reference:** {{EXPLORE_ACTIVITY_REF}}
-- **Student Discovery:** {{EXPLORE_STUDENT_DISCOVERY}}
-
-### 3. EXPLAIN \u2014 {{EXPLAIN_DURATION}} mins
-- **Definitions:** 
-{{EXPLAIN_DEFINITIONS}}
-- **Visual Illustration (REQUIRED):**
-{{EXPLAIN_VISUAL_ILLUSTRATION}}
-
-### 4. ELABORATE \u2014 {{ELABORATE_DURATION}} mins
-- **Tiered Scaffolding:**
-  - \u{1F949} **Bronze:** {{DIFFERENTIATION_BRONZE}}
-  - \u{1F948} **Silver:** {{DIFFERENTIATION_SILVER}}
-  - \u{1F947} **Gold:** {{DIFFERENTIATION_GOLD}}
-
-> **ACT Contract**: Detailed operational instructions must expand the Activity Sequence above and must not change the planned evidence target.
-
-### 5. EVALUATE \u2014 {{EVALUATE_DURATION}} mins
-- **Exit Ticket:** {{EXIT_TICKET_CONTENT}}
-- **Closing:** {{CLOSING_REMARKS}}
-
-> **QUIZ Contract**: Detailed assessment criteria and rubrics must assess the evidence and success criteria defined in the Lesson Design Plan.
-
----
-
-## [OPTIONAL] Teacher Notes
-- **Common Pitfalls:**
-{{COMMON_PITFALLS}}
-- **Troubleshooting:**
-{{TROUBLESHOOTING_ROWS}}
-
----
-
-## [REQUIRED] Artifact Linkage (Master Index)
-> List all satellite files used in this lesson.
-
-| Artifact File | Role in the Classroom | When to Use |
-|---|---|---|
-| \`GUIDE_{{LESSON_ID}}.md\` | Detailed Teaching Script | Teacher preparation |
-| \`SLIDE_{{LESSON_ID}}.md\` | Presentation Content | Throughout the session |
-| \`HANDOUT_{{LESSON_ID}}.md\` | Theory Summary for Students | During EXPLAIN phase |
-| \`ACT_{{LESSON_ID}}.md\` | Detailed Learning Activity Operations | During EXPLORE / ELABORATE / checkpoint phases |
-| \`WKS_{{LESSON_ID}}.md\` | Individual Worksheet | Wrap-up or Homework |
-| \`QUIZ_{{LESSON_ID}}.md\` | Assessment Rubric | During EVALUATE phase |
-| \`EXT_{{LESSON_ID}}.md\` | Enrichment Materials | For "Gold" students |
-`.trim();
-
-// src/templates/actTemplate.ts
-var ACT_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "ACT"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T2"
-version: "{{VERSION}}"
-date: "{{DATE}}"
-template_contract: "artifact-template-v1"
-template_required_sections:
-  - "Computational Thinking Focus"
-  - "Materials & Setup"
-  - "Constraints & Safety"
-  - "Active Learning Workflow"
-  - "3-Tier Differentiation"
-  - "Reflection"
----
-<!-- INJECT_BODY -->
-
-# INQUIRY-BASED ACTIVITY: {{TITLE}}
-_Milestone: {{MILESTONE_ID}} | Module: {{MODULE_NAME}} | Lesson: {{LESSON_ID}}_
-
-## [REQUIRED] Computational Thinking Focus
-- **Problem Statement (Real-world Scenario):** {{PROBLEM_STATEMENT}}
-- **Decomposition:**
-{{DECOMPOSITION_STEPS}}
-- **Algorithm Design:** {{ALGORITHM_DESIGN}}
-
-## [REQUIRED] Materials & Setup
-- **Reference Material:** Students should use the **HANDOUT** for this lesson as their primary technical reference (lifeline).
-- **Hardware/Software:**
-<!-- [HARDWARE_BOM] -->
-{{HARDWARE_ITEMS}}
-<!-- [/HARDWARE_BOM] -->
-- **Software:** {{SOFTWARE_ITEMS}}
-- **Consumables:** {{CONSUMABLES}}
-- **Other Resources:** {{OTHER_RESOURCES}}
-
-## [REQUIRED] Constraints & Safety
-- \u26A0\uFE0F **Technical/Safety:** {{SAFETY_WARNING}}
-- \u{1F4A1} **Design Constraint:** {{DESIGN_CONSTRAINT}}
-
-## [REQUIRED] Active Learning Workflow
-
-### Phase 1: Planning & Design \u2014 {{PHASE1_DURATION}} mins
-- **Student Task:** Hand-draw (or draft in words) the algorithm flowchart or connection architecture before touching the computer/devices.
-- **Teacher Action:** Walk around to check the logic of each group. Ask inquiry questions:
-{{PHASE1_INQUIRY_QUESTIONS}}
-
-### Phase 2: Implementation & Discovery \u2014 {{PHASE2_DURATION}} mins
-- **Student Task:** Apply the knowledge from the **HANDOUT** to realize the plan designed in Phase 1. Encourage self-inquiry and documentation lookup.
-- **Teacher Action:** Avoid "hand-holding." Only intervene if a group has been stuck for more than 5 minutes.
-{{PHASE2_GUIDANCE_BLOCK}}
-
-### Phase 3: Debugging & Testing \u2014 {{PHASE3_DURATION}} mins
-- **Testing:** Students run their system.
-- **Error Analysis:** Ask students to record any error codes or unexpected behaviors and compare them with the Troubleshooting table in the Handout.
-{{PHASE3_TESTING_STEPS}}
-
-## [REQUIRED] 3-Tier Differentiation
-> MUST design tasks in 3 tiers to support diverse learner groups. Bronze is the minimum requirement for all students.
-- \u{1F949} **Bronze (Foundational):** {{DIFFERENTIATION_BRONZE}}
-- \u{1F948} **Silver (Application):** {{DIFFERENTIATION_SILVER}}
-- \u{1F947} **Gold (Enrichment/Creative):** {{DIFFERENTIATION_GOLD}}
-
-## [REQUIRED] Reflection
-- **Discussion Question:** {{REFLECTION_QUESTION}}
-`.trim();
-
-// src/templates/codeLabTemplate.ts
-var CODE_LAB_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "LAB"
-created_by: "Curriculum OS Builder"
-phase: "{{PHASE}}"
-deliverable: "P3-T2"
-version: "{{VERSION}}"
-date: "{{DATE}}"
----
-<!-- INJECT_BODY -->
-
-# \u{1F468}\u200D\u{1F4BB} CODE LAB: {{TITLE}}
-_Milestone: {{MILESTONE_ID}} | Tech Stack: {{TECH_STACK}}_
-
-## \u{1F3AF} Overview
-This lab focuses on the practical implementation of core technical concepts, bridging theory into working, robust, and testable code.
-
-## \u{1F6E0}\uFE0F Environment & Setup
-- **Language / Framework:** {{LANGUAGE_FRAMEWORK}}
-- **IDE / Editor:** {{IDE_EDITOR}}
-- **Required Libraries:** {{REQUIRED_LIBRARIES}}
-- **Hardware / Connection Setup:** {{HARDWARE_ENV_CONNECTION}}
-
-## \u{1F4DD} Lab Tasks (3-Tier Differentiation)
-
-### \u{1F949} Bronze (Foundational) \u2014 {{BRONZE_MINS}} mins
-**Objective:** {{BRONZE_OBJECTIVE}}
-- **Task:** {{BRONZE_TASK}}
-- **Requirement:** {{BRONZE_REQUIREMENT}}
-
-### \u{1F948} Silver (Application) \u2014 {{SILVER_MINS}} mins
-**Objective:** {{SILVER_OBJECTIVE}}
-- **Task:** {{SILVER_TASK}}
-- **Requirement:** {{SILVER_REQUIREMENT}}
-
-### \u{1F947} Gold (Enrichment/Creative) \u2014 {{GOLD_MINS}} mins
-**Objective:** {{GOLD_OBJECTIVE}}
-- **Task:** {{GOLD_TASK}}
-- **Requirement:** {{GOLD_REQUIREMENT}}
-
-## \u{1F4BB} Technical Reference ([SME_MANDATE])
-<!-- [SME_MANDATE] -->
-> Any code provided in this section is verified for syntax accuracy and runtime execution.
-
-### Starter Code Template
-\`\`\`{{CODE_LANGUAGE}}
-{{STARTER_CODE}}
-\`\`\`
-
-### Solution Code
-\`\`\`{{CODE_LANGUAGE}}
-{{SOLUTION_CODE}}
-\`\`\`
-<!-- [/SME_MANDATE] -->
-
-## \u{1F50D} Troubleshooting & Debugging Matrix
-| Issue | Potential Cause | Solution |
-| :--- | :--- | :--- |
-{{TROUBLESHOOTING_ROWS}}
-
-## \u{1F3C1} Submission & Verification Checklist
-{{CHECKLIST_ITEMS}}
-`.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/selfLabTemplate.ts
-var SELF_LAB_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "SELF_LAB"
-language: "{{LANGUAGE}}"
-difficulty: "{{DIFFICULTY}}"
-estimated_minutes: {{ESTIMATED_MINUTES}}
-tech_stack: {{TECH_STACK}}
----
-
-# \u{1F680} Self-Paced Hands-On Lab: {{TITLE}}
-
-> \u23F1\uFE0F **Estimated Duration:** ~{{ESTIMATED_MINUTES}} mins  
-> \u{1F3AF} **Difficulty Level:** {{DIFFICULTY_UPPER}}  
-> \u{1F9F0} **Tech Stack:** {{TECH_STACK_STR}}  
-> \u{1F4A1} **Self-Learner Notice:** You are in full control of this lab. Follow the progressive challenges below. If you get stuck at any point, use the **Progressive Hints System** to get unstuck without ruining the learning experience!
-
----
-
-## \u{1F4CB} Mission Briefing & Environment Setup
-{{MISSION_BRIEFING}}
-
-### \u{1F6EB} Preflight Checklist
-{{PREFLIGHT_CHECKLIST}}
-
----
-
-## \u{1F3AF} Progressive Challenges (3-Tier Differentiation)
-
-### \u{1F949} Challenge 1: Foundational Core (Bronze) \u2014 ~{{BRONZE_MINS}} mins
-**Objective:** {{BRONZE_OBJECTIVE}}
-
-#### Tasks & Implementation Details:
-{{BRONZE_TASKS}}
-
-#### \u{1F9EA} Self-Verification Command:
-\`\`\`bash
-{{BRONZE_VERIFY_COMMAND}}
-\`\`\`
-*Expected Terminal Output:*
-\`\`\`text
-{{BRONZE_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>
-
-{{BRONZE_HINT_1}}
-</details>
-
-<details>
-<summary><b>\u{1F50D} Hint Level 2: Structural Skeleton (Khung code m\u1EABu)</b></summary>
-
-\`\`\`{{CODE_LANGUAGE}}
-{{BRONZE_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}}
-{{BRONZE_HINT_3_CODE}}
-\`\`\`
-
-**Why this solution works:**
-{{BRONZE_HINT_3_EXPLANATION}}
-</details>
-
----
-
-### \u{1F948} Challenge 2: Logic & Error Handling (Silver) \u2014 ~{{SILVER_MINS}} mins
-**Objective:** {{SILVER_OBJECTIVE}}
-
-#### Tasks & Implementation Details:
-{{SILVER_TASKS}}
-
-#### \u{1F9EA} Self-Verification Command:
-\`\`\`bash
-{{SILVER_VERIFY_COMMAND}}
-\`\`\`
-*Expected Terminal Output:*
-\`\`\`text
-{{SILVER_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>
-
-{{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();
+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();
+}
+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 import.meta !== "undefined" && typeof import.meta.url === "string") {
+      return path.dirname(fileURLToPath(import.meta.url));
+    }
+  } catch {
+  }
+  return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+})();
+function candidateDirs(explicitDir) {
+  const dirs = [];
+  if (process.env.CURRICULUM_TEMPLATES_DIR) dirs.push(process.env.CURRICULUM_TEMPLATES_DIR);
+  dirs.push(path.resolve(process.cwd(), "_templates"));
+  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
+    dirs.push(path.resolve(_moduleDir, rel));
+    dirs.push(path.resolve(process.cwd(), rel));
+    dirs.push(path.resolve(process.cwd(), "packages/curriculum-kit", rel));
+  }
+  return dirs;
+}
+function findTemplatePath(templateName, explicitDir) {
+  for (const dir of candidateDirs()) {
+    const p = path.join(dir, templateName);
+    if (!fs2.existsSync(p)) continue;
+    try {
+      fs2.accessSync(p, fs2.constants.R_OK);
+      return p;
+    } catch {
+    }
+  }
+  return null;
+}
+function loadAuthoringTemplate(templateName, templatesDir) {
+  const p = findTemplatePath(templateName);
+  if (!p) return "";
+  try {
+    return stripTemplateFrontmatter(fs2.readFileSync(p, "utf-8"));
+  } catch {
+    return "";
+  }
+}
 
 // src/ai/prompts/lessonMasterPrompt.ts
 function buildLessonMasterPrompt(input) {
@@ -1621,7 +1216,7 @@ Build a deep, rigorous, and highly pedagogical Master Lesson Plan (LESSON) that
 # MANDATORY TEMPLATE STRUCTURE
 You MUST generate structured data that will render directly into this exact Markdown template:
 ---
-${LESSON_PLAN_TEMPLATE}
+${loadAuthoringTemplate("LESSON_5E_template.md") ?? "[TEMPLATE FILE NOT FOUND: LESSON_5E_template.md]"}
 ---
 
 # INPUT PARAMETERS
@@ -1699,7 +1294,7 @@ Transform the exact pedagogical flow and activities from the Master Lesson Plan
 # MANDATORY TEMPLATE STRUCTURE
 You MUST generate data aligned with this Markdown template:
 ---
-${ACT_TEMPLATE}
+${loadAuthoringTemplate("ACT_template.md") ?? "[TEMPLATE FILE NOT FOUND: ACT_template.md]"}
 ---
 
 # CANONICAL MASTER LESSON CONTEXT (SOURCE OF TRUTH)
@@ -1794,7 +1389,7 @@ Generate complete, verified source code that satisfies the lesson objectives and
 # MANDATORY TEMPLATE STRUCTURE
 You MUST generate data aligned with this Markdown template:
 ---
-${CODE_LAB_TEMPLATE}
+${loadAuthoringTemplate("LAB_TEMPLATE.md") ?? "[TEMPLATE FILE NOT FOUND: LAB_TEMPLATE.md]"}
 ---
 
 # CANONICAL LESSON CONTEXT (SOURCE OF TRUTH)
@@ -2489,7 +2084,7 @@ Build a complete, engaging Self-Paced Hands-On Lab (SELF_LAB) for autonomous lea
 # MANDATORY TEMPLATE STRUCTURE
 You MUST generate data aligned with this Markdown template:
 ---
-${SELF_LAB_TEMPLATE}
+${loadAuthoringTemplate("SELF_LAB_template.md") ?? "[TEMPLATE FILE NOT FOUND: SELF_LAB_template.md]"}
 ---
 
 # INPUT PARAMETERS
@@ -2626,7 +2221,7 @@ Use this mapping to determine which Bloom level each question truly targets. Mat
 # MANDATORY TEMPLATE STRUCTURE
 You MUST generate data aligned with this Markdown template:
 ---
-${QUIZ_TEMPLATE}
+${loadAuthoringTemplate("QUIZ_v4.6_template.md") ?? "[TEMPLATE FILE NOT FOUND: QUIZ_v4.6_template.md]"}
 ---
 
 # INPUT PARAMETERS