@thanh01.pmt/curriculum-kit 1.4.43 → 1.4.45

package/dist/index.mjs

@@ -1,8 +1,9 @@
-import fs2 from 'fs';
-import path3 from 'path';
+import fs3 from 'fs';
+import path4 from 'path';
 import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import { createOpenAI } from '@ai-sdk/openai';
 import { createDeepSeek } from '@ai-sdk/deepseek';
+import { fileURLToPath } from 'url';
 import { z } from 'zod';
 import { generateObject, streamObject, streamText, generateText } from 'ai';
 import pRetry from 'p-retry';
@@ -11,7 +12,6 @@ import pLimit from 'p-limit';
 import fsPromises from 'fs/promises';
 import crypto, { createHash } from 'crypto';
 import { createClient } from '@supabase/supabase-js';
-import { fileURLToPath } from 'url';
 import { Octokit } from '@octokit/rest';
 
 var __defProp = Object.defineProperty;
@@ -165,18 +165,18 @@ function resolveApiKey(keyName, explicitKey) {
   try {
     const currentDir = process.cwd();
     const envPaths = [
-      path3.resolve(currentDir, ".env.local"),
-      path3.resolve(currentDir, ".env"),
-      path3.resolve(currentDir, "apps/web/.env.local"),
-      path3.resolve(currentDir, "packages/learnwell-platform/.env"),
-      path3.resolve(currentDir, "..", ".env.local"),
-      path3.resolve(currentDir, "..", ".env"),
-      path3.resolve(currentDir, "../..", ".env.local"),
-      path3.resolve(currentDir, "../..", ".env")
+      path4.resolve(currentDir, ".env.local"),
+      path4.resolve(currentDir, ".env"),
+      path4.resolve(currentDir, "apps/web/.env.local"),
+      path4.resolve(currentDir, "packages/learnwell-platform/.env"),
+      path4.resolve(currentDir, "..", ".env.local"),
+      path4.resolve(currentDir, "..", ".env"),
+      path4.resolve(currentDir, "../..", ".env.local"),
+      path4.resolve(currentDir, "../..", ".env")
     ];
     for (const envPath of envPaths) {
-      if (fs2.existsSync(envPath)) {
-        const content = fs2.readFileSync(envPath, "utf-8");
+      if (fs3.existsSync(envPath)) {
+        const content = fs3.readFileSync(envPath, "utf-8");
         for (const line of content.split("\n")) {
           const trimmed = line.trim();
           if (trimmed && !trimmed.startsWith("#") && trimmed.startsWith(keyName + "=")) {
@@ -1166,6 +1166,229 @@ var init_provider_factory = __esm({
     };
   }
 });
+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 stripHeadingKey(h) {
+  return h.replace(/\[(REQUIRED|OPTIONAL|CONDITIONAL)\]\s*/gi, "").replace(/^\s*\d+[.)]\s+/, "").replace(/\s+/g, " ").trim();
+}
+function isVariableHeading(text) {
+  return /\{\{[^}]*\}\}/.test(text) || /\[[^\]]+\]/.test(text);
+}
+function collectHeadings(body) {
+  const out = [];
+  let inFence = false;
+  for (const line of body.split("\n")) {
+    if (/^(```|~~~)/.test(line.trim())) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence) continue;
+    const m = line.match(/^(#{2,3})\s+(.*)$/);
+    if (!m) continue;
+    const text = m[2].trim();
+    const optional = /^\[OPTIONAL\]/i.test(text);
+    const name = stripHeadingKey(text);
+    if (!name || isVariableHeading(name)) continue;
+    out.push({ level: m[1].length, name, optional });
+  }
+  return out;
+}
+function extractEchoSections(raw) {
+  const hs = collectHeadings(stripTemplateFrontmatter(raw));
+  return {
+    required: hs.filter((h) => !h.optional).map((h) => h.name),
+    optional: hs.filter((h) => h.optional).map((h) => h.name)
+  };
+}
+function extractConditionalSections(raw) {
+  const body = stripTemplateFrontmatter(raw);
+  return body.split("\n").filter((l) => /^#{2,3} .*\[CONDITIONAL\]/i.test(l)).map((l) => stripHeadingKey(l.replace(/^#{2,3}\s*/, "").trim())).filter((s) => s.length > 0 && !isVariableHeading(s));
+}
+function extractDeclaredLanguage(raw) {
+  const m = raw.match(/^template_language:\s*["']?([a-zA-Z-]+)["']?\s*$/m);
+  return m?.[1]?.toLowerCase() || "en";
+}
+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(path4.resolve(process.cwd(), "_templates"));
+  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
+    dirs.push(path4.resolve(_moduleDir, rel));
+    dirs.push(path4.resolve(process.cwd(), rel));
+    dirs.push(path4.resolve(process.cwd(), "packages/curriculum-kit", rel));
+  }
+  return dirs;
+}
+function findTemplatePath(templateName, explicitDir) {
+  for (const dir of candidateDirs(explicitDir)) {
+    const p = path4.join(dir, templateName);
+    if (!fs3.existsSync(p)) continue;
+    try {
+      fs3.accessSync(p, fs3.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 = fs3.readFileSync(p, "utf-8");
+    const echo = extractEchoSections(raw);
+    return {
+      content: stripTemplateFrontmatter(raw),
+      sections: echo.required,
+      optionalSections: echo.optional,
+      sourcePath: p,
+      conditionals: extractConditionalSections(raw),
+      declaredLang: extractDeclaredLanguage(raw)
+    };
+  } catch {
+    return null;
+  }
+}
+function assembleTranslatedTemplate(templateName, translatedBody, targetLanguage, opts) {
+  const raw = loadCurriculumTemplate(templateName, opts?.templatesDir);
+  if (!raw || !translatedBody?.trim()) return null;
+  const base = collectHeadings(stripTemplateFrontmatter(raw));
+  const out = collectHeadings(translatedBody);
+  if (base.length !== out.length) return null;
+  for (let i = 0; i < base.length; i++) {
+    if (base[i].level !== out[i].level || base[i].optional !== out[i].optional) return null;
+  }
+  const srcBody = stripTemplateFrontmatter(raw);
+  for (const ph of new Set(srcBody.match(/\{\{[^}]+\}\}/g) ?? [])) {
+    if (!translatedBody.includes(ph)) return null;
+  }
+  for (const mk of new Set(srcBody.match(/<!--\s*\[\/?[^\]]+\]\s*-->/g) ?? [])) {
+    if (!translatedBody.includes(mk)) return null;
+  }
+  const lang = targetLanguage.trim().toLowerCase() || "en";
+  const req = out.filter((h) => !h.optional).map((h) => h.name);
+  let fmRaw = "";
+  if (raw.startsWith("---")) {
+    const end = raw.indexOf("\n---", 3);
+    if (end !== -1) fmRaw = raw.slice(0, end + 4);
+  }
+  const fm = stampEchoOnFrontmatter(fmRaw || "---\n---", lang, req);
+  return { raw: `${fm}
+${translatedBody.trimStart()}`, sections: req, templateLanguage: lang };
+}
+function stampEchoOnFrontmatter(rawDoc, lang, sections) {
+  const echoLines = ['template_language: "' + lang + '"', "template_required_sections:", ...sections.map((n) => `  - "${n.replace(/"/g, '\\"')}"`)];
+  if (rawDoc.startsWith("---")) {
+    const lines = rawDoc.split("\n");
+    const closeIdx = lines.findIndex((l, i) => i > 0 && l.trim() === "---");
+    if (closeIdx === -1) {
+      return ["---", ...echoLines, "---", "", stripTemplateFrontmatter(rawDoc)].join("\n");
+    }
+    const kept = [];
+    let skippingList = false;
+    for (const l of lines.slice(0, closeIdx)) {
+      const t = l.trim();
+      if (/^template_required_sections:$/.test(t)) {
+        skippingList = true;
+        continue;
+      }
+      if (/^template_language:/.test(t)) continue;
+      if (skippingList) {
+        if (/^\s+-\s/.test(l)) continue;
+        skippingList = false;
+      }
+      kept.push(l);
+    }
+    return [...kept, ...echoLines, "---", ...lines.slice(closeIdx + 1)].join("\n");
+  }
+  return ["---", ...echoLines, "---", "", rawDoc].join("\n");
+}
+async function translateTemplate(templateName, targetLanguage, runner, opts) {
+  const raw = loadCurriculumTemplate(templateName, opts?.templatesDir);
+  if (!raw) return null;
+  const body = stripTemplateFrontmatter(raw);
+  const placeholders = Array.from(new Set(body.match(/\{\{[^}]+\}\}/g) ?? []));
+  const markers = Array.from(new Set(body.match(/<!--\s*\[\/?[^\]]+\]\s*-->/g) ?? []));
+  const prompt = `Translate the following Markdown artifact TEMPLATE body into ${targetLanguage}.
+STRICT PRESERVATION RULES (violating any of these invalidates the output):
+1. Keep the document structure EXACTLY: same number of headings, same order, same heading levels (## / ###).
+2. Translate heading TEXT naturally, but a heading must remain a single static line: move nothing into or out of it. Headings never contain durations or placeholders \u2014 if a source heading carries "[X mins]"-style timing, the timing belongs on the line below the heading, not inside it.
+3. Keep every placeholder token VERBATIM (do not translate or alter), including {{ XX }}-style duration tokens: ${placeholders.join(" ") || "(none)"}
+4. Keep every HTML comment marker VERBATIM: ${markers.join(" ") || "(none)"}
+5. Keep code blocks, file paths, technical identifiers (API names, protocols, component models) untranslated.
+6. Translate ONLY natural-language prose, headings, and table headers into natural ${targetLanguage}.
+7. Output ONLY the translated markdown \u2014 no explanations, no code fences around the whole document.
+
+TEMPLATE BODY:
+${body}`;
+  let translatedBody;
+  try {
+    translatedBody = await runner(prompt);
+  } catch {
+    return null;
+  }
+  if (!translatedBody || translatedBody.length < body.length * 0.4) return null;
+  translatedBody = translatedBody.trim().replace(/^```(?:markdown)?\n/, "").replace(/\n```$/, "");
+  return assembleTranslatedTemplate(templateName, translatedBody, targetLanguage, opts);
+}
+function loadCurriculumTemplate(templateName, templatesDir) {
+  const p = findTemplatePath(templateName, templatesDir);
+  if (!p) return "";
+  try {
+    return fs3.readFileSync(p, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function loadAuthoringTemplate(templateName, templatesDir) {
+  const p = findTemplatePath(templateName, templatesDir);
+  if (!p) return "";
+  try {
+    return stripTemplateFrontmatter(fs3.readFileSync(p, "utf-8"));
+  } catch {
+    return "";
+  }
+}
+var KIT_TEMPLATE_FALLBACK_DIRS, _moduleDir;
+var init_templateLoader = __esm({
+  "src/services/templateLoader.ts"() {
+    KIT_TEMPLATE_FALLBACK_DIRS = [
+      // Packaged with the npm bundle (dist/templates) — resolves from node_modules.
+      "templates",
+      // Repo checkout layouts.
+      "docs/refs/templates"
+    ];
+    _moduleDir = (() => {
+      try {
+        if (typeof import.meta !== "undefined" && typeof import.meta.url === "string") {
+          return path4.dirname(fileURLToPath(import.meta.url));
+        }
+      } catch {
+      }
+      return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+    })();
+  }
+});
 
 // src/pipeline/artifactLinter.ts
 var artifactLinter_exports = {};
@@ -1532,14 +1755,26 @@ function parseLessonFlow(lessonMarkdown) {
       }
     }
   }
-  const flowMatch = lessonMarkdown.match(/##\s*\[?REQUIRED\]?\s*B\.\s*Lesson Flow([\s\S]*?)$/i);
+  const flowMatch = lessonMarkdown.match(/##\s*(?:\[?REQUIRED\]?\s*)?B\.\s*Lesson Flow([\s\S]*?)$/i);
   const flowSection = flowMatch ? flowMatch[1] : lessonMarkdown;
-  const phaseRegex = /###\s*(?:(\d+)\.\s*)?([^\n—\-]+)(?:[—\-]\s*\[?([^\]\n]+)\]?)?\s*\n([\s\S]*?)(?=(?:###\s*(?:\d+\.)?|$))/gi;
+  const phaseRegex = /###\s*(?:(\d+)\.\s*)?([^\n]+)\n([\s\S]*?)(?=(?:###\s*(?:\d+\.)?|$))/gi;
   let pMatch;
   while ((pMatch = phaseRegex.exec(flowSection)) !== null) {
-    const rawPhaseName = pMatch[2].trim();
-    const timing = pMatch[3]?.trim();
-    const content = pMatch[4].trim();
+    const headingText = pMatch[2].trim();
+    const tailMatch = headingText.match(/[—–-]\s*\[?([^\]—–]+)\]?\s*$/);
+    const tail = tailMatch?.[1]?.trim() ?? "";
+    const rawPhaseName = stripHeadingKey(
+      tailMatch && /mins?/i.test(tail) ? headingText.slice(0, tailMatch.index).trim() : headingText
+    );
+    let content = pMatch[3].trim();
+    let timing;
+    const durMatch2 = content.match(/^>?\s*\**Duration:?\**\s*([~0-9][^\n]*)/i);
+    if (durMatch2) {
+      timing = durMatch2[1].trim();
+      content = content.replace(/^>?\s*\**Duration:?\**\s*[^\n]*\n?/i, "").trim();
+    } else if (tail && /mins?/i.test(tail)) {
+      timing = tail;
+    }
     const codeSnippets = [];
     const codeRegex = /```(?:[a-zA-Z0-9_\-]+)?\s*\n([\s\S]*?)```/g;
     let cMatch;
@@ -1567,6 +1802,7 @@ function parseLessonFlow(lessonMarkdown) {
 }
 var init_lessonFlowParser = __esm({
   "src/parsers/lessonFlowParser.ts"() {
+    init_templateLoader();
   }
 });
 
@@ -3933,468 +4169,8 @@ var RoadmapInputSchema = z.object({
 // src/ai/index.ts
 init_provider_factory();
 
-// 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();
-
 // src/ai/prompts/lessonMasterPrompt.ts
+init_templateLoader();
 function buildLessonMasterPrompt(input) {
   const { milestone, language, topic, targetAudience, contextContinuity, standardsContext } = input;
   const learningObjectives = milestone.learning_objectives || [];
@@ -4446,7 +4222,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
@@ -4496,6 +4272,7 @@ Return a single valid JSON object matching the LessonPlanSchema with these exact
 }
 
 // src/ai/prompts/activityPrompt.ts
+init_templateLoader();
 function buildActivityPrompt(input) {
   const { lesson, language, hardwareBOM, softwareTools } = input;
   const loList = lesson.learningObjectives.map((lo) => `- [${lo.bloomLevel}] ${lo.code}: ${lo.name || ""} \u2014 ${lo.description}${lo.successCriteria ? ` (Evidence: ${lo.successCriteria})` : ""}`).join("\n");
@@ -4524,7 +4301,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)
@@ -4595,6 +4372,7 @@ Return a single JSON object matching ActivityLabSchema with these exact keys:
 }
 
 // src/ai/prompts/codeLabPrompt.ts
+init_templateLoader();
 function buildCodeLabPrompt(input) {
   const { lesson, activity, language, targetTechStack } = input;
   const techStackList = targetTechStack && targetTechStack.length > 0 ? targetTechStack : ["General Programming & Engineering"];
@@ -4619,7 +4397,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)
@@ -5284,6 +5062,7 @@ Please return a single JSON object matching these exact keys:
 }
 
 // src/ai/prompts/selfLabPrompt.ts
+init_templateLoader();
 function buildSelfLabPrompt(input) {
   const { milestone, projectGraph, language, targetTechStack, contextContinuity } = input;
   const techStackList = targetTechStack && targetTechStack.length > 0 ? targetTechStack : milestone.tech_keywords && milestone.tech_keywords.length > 0 ? milestone.tech_keywords : ["General Engineering"];
@@ -5314,7 +5093,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
@@ -5392,6 +5171,7 @@ Return a single valid JSON object matching SelfLabSchema with these exact keys:
 }
 
 // src/ai/prompts/diagnosticQuizPrompt.ts
+init_templateLoader();
 function buildDiagnosticQuizPrompt(input) {
   const { milestone, language, questionCount = 4, passingScorePct = 80 } = input;
   const learningObjectives = milestone.learning_objectives || [];
@@ -5451,7 +5231,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
@@ -6856,7 +6636,7 @@ ${cc.technicalDepth}`;
       const dataRows = cc.comparisonTable.rows.map((r) => `| ${r.join(" | ")} |`).join("\n");
       str += `
 
-#### Comparison & Trade-off Analysis
+**Comparison & Trade-off Analysis**
 ${headerRow}
 ${dividerRow}
 ${dataRows}`;
@@ -6900,7 +6680,8 @@ ${learningObjectivesStr}
 
 ---
 
-## 1. ENGAGE (Hook & High-Stakes Scenario) \u2014 10-15 mins
+## 1. ENGAGE (Hook & High-Stakes Scenario)
+> **Duration:** 10-15 mins
 
 ### Real-World Context: "${lesson.hookTitle || "The Incident"}"
 ${lesson.hookScenario}
@@ -6909,13 +6690,15 @@ ${lesson.hookQuestions && lesson.hookQuestions.length > 0 ? lesson.hookQuestions
 
 ---
 
-## 2. EXPLORE & EXPLAIN (Core Technical Concepts & Principles) \u2014 30-40 mins
+## 2. EXPLORE & EXPLAIN (Core Technical Concepts & Principles)
+> **Duration:** 30-40 mins
 
 ${coreConceptsStr}
 
 ---
 
-## 3. GUIDED PRACTICE (Visual Architecture & Annotated Code) \u2014 20-25 mins
+## 3. GUIDED PRACTICE (Visual Architecture & Annotated Code)
+> **Duration:** 20-25 mins
 
 ### System Architecture & Data Flow (Mermaid Diagram)
 ${mermaidBlock}
@@ -6929,7 +6712,8 @@ ${guidedPractice.codeSnippet}
 
 ---
 
-## 4. ELABORATE & INDEPENDENT PRACTICE (Technical Challenge & Scaffolding) \u2014 15-20 mins
+## 4. ELABORATE & INDEPENDENT PRACTICE (Technical Challenge & Scaffolding)
+> **Duration:** 15-20 mins
 
 ### Engineering Challenge: "${lesson.independentPractice?.title || "System Optimization Challenge"}"
 ${lesson.independentPractice?.description || "Implement the core logic and test against simulated edge cases."}
@@ -6940,7 +6724,8 @@ ${lesson.independentPractice?.description || "Implement the core logic and test
 
 ---
 
-## 5. EVALUATE (Summary, Assessment & Metacognition) \u2014 5-10 mins
+## 5. EVALUATE (Summary, Assessment & Metacognition)
+> **Duration:** 5-10 mins
 
 ### Exit Ticket (Bloom: Apply / Analyze)
 > **Scenario Question:** ${lesson.exitTicket.questionStem}  
@@ -7033,12 +6818,16 @@ ${hardwareItems}
 
 ## [REQUIRED] Active Learning Workflow
 
-### Phase 1: Planning & Design \u2014 ${phase1.durationMinutes} mins
+### Phase 1: Planning & Design
+> **Duration:** ${phase1.durationMinutes} mins
+
 - **Student Task:** ${phase1.studentTask}
 - **Teacher Action:** ${phase1.teacherAction}
 ${phase1.inquiryQuestions.map((q) => `  - *Inquiry Question:* ${q}`).join("\n")}
 
-### Phase 2: Implementation & Discovery \u2014 ${phase2.durationMinutes} mins
+### Phase 2: Implementation & Discovery
+> **Duration:** ${phase2.durationMinutes} mins
+
 - **Student Task:** ${phase2.studentTask}
 - **Teacher Action:** ${phase2.teacherAction}
 
@@ -7046,7 +6835,9 @@ ${phase2.codeOrCommands.map((c) => `\`\`\`text
 ${c}
 \`\`\``).join("\n\n")}
 
-### Phase 3: Debugging & Testing \u2014 ${phase3.durationMinutes} mins
+### Phase 3: Debugging & Testing
+> **Duration:** ${phase3.durationMinutes} mins
+
 - **Testing:** ${phase3.testingSteps}
 - **Error Analysis:** ${phase3.errorAnalysis}
 
@@ -7101,22 +6892,28 @@ This lab focuses on the practical implementation of core technical concepts, bri
 
 ## \u{1F4DD} Lab Tasks (3-Tier Differentiation)
 
-### \u{1F949} Bronze (Foundational) \u2014 ${tasks.bronze.mins} mins
+### \u{1F949} Bronze (Foundational)
+> **Duration:** ${tasks.bronze.mins} mins
+
 **Objective:** ${tasks.bronze.objective}
 - **Task:** ${tasks.bronze.task}
 - **Requirement:** ${tasks.bronze.requirement}
 
-### \u{1F948} Silver (Application) \u2014 ${tasks.silver.mins} mins
+### \u{1F948} Silver (Application)
+> **Duration:** ${tasks.silver.mins} mins
+
 **Objective:** ${tasks.silver.objective}
 - **Task:** ${tasks.silver.task}
 - **Requirement:** ${tasks.silver.requirement}
 
-### \u{1F947} Gold (Enrichment/Creative) \u2014 ${tasks.gold.mins} mins
+### \u{1F947} Gold (Enrichment/Creative)
+> **Duration:** ${tasks.gold.mins} mins
+
 **Objective:** ${tasks.gold.objective}
 - **Task:** ${tasks.gold.task}
 - **Requirement:** ${tasks.gold.requirement}
 
-## \u{1F4BB} Technical Reference ([SME_MANDATE])
+## \u{1F4BB} Technical Reference
 <!-- [SME_MANDATE] -->
 > Any code provided in this section is verified for syntax accuracy and runtime execution.
 
@@ -7254,7 +7051,9 @@ ${instruction.verificationChecklist.map((c) => `- [ ] ${c}`).join("\n")}
 function serializeSelfLabToMarkdown(lab) {
   const renderChallenge = (c, label) => {
     const tasksList = c.tasks.map((t) => `- ${t}`).join("\n");
-    return `### ${label}: ${c.title} \u2014 ~${c.estimatedMinutes} mins
+    return `### ${label}: ${c.title}
+> **Duration:** ~${c.estimatedMinutes} mins
+
 **Objective:** ${c.objective}
 
 #### Tasks & Implementation Details:
@@ -7748,13 +7547,13 @@ async function generateSelfPacedBundle(input) {
   if (input.outputDirectory) {
     await fsPromises.mkdir(input.outputDirectory, { recursive: true });
     await Promise.all([
-      fsPromises.writeFile(path3.join(input.outputDirectory, "INSTRUCTION.md"), instructionMd, "utf-8"),
-      fsPromises.writeFile(path3.join(input.outputDirectory, "SELF_LAB.md"), selfLabMd, "utf-8"),
-      fsPromises.writeFile(path3.join(input.outputDirectory, "QUIZ.md"), quizMd, "utf-8"),
-      fsPromises.writeFile(path3.join(input.outputDirectory, "QUIZ.json"), JSON.stringify(quiz, null, 2), "utf-8"),
-      fsPromises.writeFile(path3.join(input.outputDirectory, "CHEAT_SHEET.md"), cheatSheetMd, "utf-8"),
-      fsPromises.writeFile(path3.join(input.outputDirectory, "LAB.md"), codeLabMd, "utf-8"),
-      fsPromises.writeFile(path3.join(input.outputDirectory, "bundle.json"), JSON.stringify(bundle, null, 2), "utf-8")
+      fsPromises.writeFile(path4.join(input.outputDirectory, "INSTRUCTION.md"), instructionMd, "utf-8"),
+      fsPromises.writeFile(path4.join(input.outputDirectory, "SELF_LAB.md"), selfLabMd, "utf-8"),
+      fsPromises.writeFile(path4.join(input.outputDirectory, "QUIZ.md"), quizMd, "utf-8"),
+      fsPromises.writeFile(path4.join(input.outputDirectory, "QUIZ.json"), JSON.stringify(quiz, null, 2), "utf-8"),
+      fsPromises.writeFile(path4.join(input.outputDirectory, "CHEAT_SHEET.md"), cheatSheetMd, "utf-8"),
+      fsPromises.writeFile(path4.join(input.outputDirectory, "LAB.md"), codeLabMd, "utf-8"),
+      fsPromises.writeFile(path4.join(input.outputDirectory, "bundle.json"), JSON.stringify(bundle, null, 2), "utf-8")
     ]);
   }
   return {
@@ -8155,15 +7954,15 @@ var STANDARD_SOT_FILES = [
   "ALIGNMENT_MATRIX.md"
 ];
 function atomicWriteFileSync(targetPath, content) {
-  const dir = path3.dirname(targetPath);
-  if (!fs2.existsSync(dir)) fs2.mkdirSync(dir, { recursive: true });
-  const tmpPath = path3.join(dir, `.${path3.basename(targetPath)}.${process.pid}.${Date.now()}.${crypto.randomBytes(4).toString("hex")}.tmp`);
+  const dir = path4.dirname(targetPath);
+  if (!fs3.existsSync(dir)) fs3.mkdirSync(dir, { recursive: true });
+  const tmpPath = path4.join(dir, `.${path4.basename(targetPath)}.${process.pid}.${Date.now()}.${crypto.randomBytes(4).toString("hex")}.tmp`);
   try {
-    fs2.writeFileSync(tmpPath, content, "utf-8");
-    fs2.renameSync(tmpPath, targetPath);
+    fs3.writeFileSync(tmpPath, content, "utf-8");
+    fs3.renameSync(tmpPath, targetPath);
   } catch (err) {
     try {
-      if (fs2.existsSync(tmpPath)) fs2.unlinkSync(tmpPath);
+      if (fs3.existsSync(tmpPath)) fs3.unlinkSync(tmpPath);
     } catch {
     }
     throw err;
@@ -8172,51 +7971,51 @@ function atomicWriteFileSync(targetPath, content) {
 var FileSystemCurriculumAdapter = class {
   baseDir;
   constructor(options = {}) {
-    this.baseDir = options.baseDir || path3.resolve(process.cwd(), "output", "projects");
+    this.baseDir = options.baseDir || path4.resolve(process.cwd(), "output", "projects");
   }
   getProjectDir(projectId) {
     const raw = (projectId || "").replace("proj_", "");
-    const directPath = path3.join(this.baseDir, raw);
-    if (fs2.existsSync(directPath)) return directPath;
-    const fullIdPath = path3.join(this.baseDir, projectId);
-    if (fs2.existsSync(fullIdPath)) return fullIdPath;
+    const directPath = path4.join(this.baseDir, raw);
+    if (fs3.existsSync(directPath)) return directPath;
+    const fullIdPath = path4.join(this.baseDir, projectId);
+    if (fs3.existsSync(fullIdPath)) return fullIdPath;
     return directPath;
   }
   /** Ensures the resolved path stays within the project directory (prevents path traversal). */
   assertInsideProject(projectDir, targetPath) {
-    const resolvedProject = path3.resolve(projectDir);
-    const resolvedTarget = path3.resolve(targetPath);
-    if (!resolvedTarget.startsWith(resolvedProject + path3.sep) && resolvedTarget !== resolvedProject) {
+    const resolvedProject = path4.resolve(projectDir);
+    const resolvedTarget = path4.resolve(targetPath);
+    if (!resolvedTarget.startsWith(resolvedProject + path4.sep) && resolvedTarget !== resolvedProject) {
       throw new Error(`[FileSystemCurriculumAdapter] Path traversal blocked: ${targetPath} is outside project directory ${projectDir}`);
     }
   }
   async projectExists(projectId) {
-    return fs2.existsSync(this.getProjectDir(projectId));
+    return fs3.existsSync(this.getProjectDir(projectId));
   }
   async readSotDocument(projectId, filename) {
     const projectDir = this.getProjectDir(projectId);
     const possiblePaths = [
-      path3.join(projectDir, "_sot", filename),
-      path3.join(projectDir, filename)
+      path4.join(projectDir, "_sot", filename),
+      path4.join(projectDir, filename)
     ];
     for (const p of possiblePaths) {
-      if (fs2.existsSync(p) && fs2.statSync(p).isFile()) {
-        return fs2.readFileSync(p, "utf-8");
+      if (fs3.existsSync(p) && fs3.statSync(p).isFile()) {
+        return fs3.readFileSync(p, "utf-8");
       }
     }
     return null;
   }
   async listSotDocuments(projectId) {
     const projectDir = this.getProjectDir(projectId);
-    const sotDir = path3.join(projectDir, "_sot");
+    const sotDir = path4.join(projectDir, "_sot");
     const discoveredFiles = new Set(STANDARD_SOT_FILES);
-    if (fs2.existsSync(sotDir)) {
+    if (fs3.existsSync(sotDir)) {
       try {
-        const diskFiles = fs2.readdirSync(sotDir);
+        const diskFiles = fs3.readdirSync(sotDir);
         for (const f of diskFiles) {
           if (f.startsWith(".") || f.endsWith(".review.json")) continue;
-          const fullPath = path3.join(sotDir, f);
-          if (fs2.statSync(fullPath).isFile()) {
+          const fullPath = path4.join(sotDir, f);
+          if (fs3.statSync(fullPath).isFile()) {
             discoveredFiles.add(f);
           }
         }
@@ -8224,9 +8023,9 @@ var FileSystemCurriculumAdapter = class {
       }
     }
     return Array.from(discoveredFiles).map((filename) => {
-      const p = fs2.existsSync(path3.join(sotDir, filename)) ? path3.join(sotDir, filename) : fs2.existsSync(path3.join(projectDir, filename)) ? path3.join(projectDir, filename) : null;
-      if (p && fs2.existsSync(p)) {
-        const stats = fs2.statSync(p);
+      const p = fs3.existsSync(path4.join(sotDir, filename)) ? path4.join(sotDir, filename) : fs3.existsSync(path4.join(projectDir, filename)) ? path4.join(projectDir, filename) : null;
+      if (p && fs3.existsSync(p)) {
+        const stats = fs3.statSync(p);
         return {
           name: filename.replace(/\.(md|json)$/i, "").replace(/_/g, " "),
           filename,
@@ -8244,18 +8043,18 @@ var FileSystemCurriculumAdapter = class {
   }
   async readArtifact(projectId, relPathOrIdentifier) {
     const projectDir = this.getProjectDir(projectId);
-    const directCandidate = path3.join(projectDir, relPathOrIdentifier);
+    const directCandidate = path4.join(projectDir, relPathOrIdentifier);
     this.assertInsideProject(projectDir, directCandidate);
     const possiblePaths = [
       directCandidate,
-      path3.join(projectDir, "_sot", relPathOrIdentifier),
-      path3.join(projectDir, "lessons", relPathOrIdentifier),
-      path3.join(projectDir, "_sot", path3.basename(relPathOrIdentifier)),
-      path3.join(projectDir, "lessons", path3.basename(relPathOrIdentifier))
+      path4.join(projectDir, "_sot", relPathOrIdentifier),
+      path4.join(projectDir, "lessons", relPathOrIdentifier),
+      path4.join(projectDir, "_sot", path4.basename(relPathOrIdentifier)),
+      path4.join(projectDir, "lessons", path4.basename(relPathOrIdentifier))
     ];
     for (const p of possiblePaths) {
-      if (fs2.existsSync(p) && fs2.statSync(p).isFile()) {
-        return fs2.readFileSync(p, "utf-8");
+      if (fs3.existsSync(p) && fs3.statSync(p).isFile()) {
+        return fs3.readFileSync(p, "utf-8");
       }
     }
     if (relPathOrIdentifier.includes(".md") || relPathOrIdentifier.includes("/")) {
@@ -8264,8 +8063,8 @@ var FileSystemCurriculumAdapter = class {
     const lessonMatch = relPathOrIdentifier.match(/U\d+_M\d+_L\d+/i);
     if (lessonMatch) {
       const lessonId = lessonMatch[0].toUpperCase();
-      const lessonDir = path3.join(projectDir, "lessons", lessonId);
-      if (fs2.existsSync(lessonDir) && fs2.statSync(lessonDir).isDirectory()) {
+      const lessonDir = path4.join(projectDir, "lessons", lessonId);
+      if (fs3.existsSync(lessonDir) && fs3.statSync(lessonDir).isDirectory()) {
         const lower = relPathOrIdentifier.toLowerCase();
         let artifactPrefix = "LESSON";
         if (lower.includes("act") || lower.includes("lab") || lower.includes("th\u1EF1c h\xE0nh")) {
@@ -8285,9 +8084,9 @@ var FileSystemCurriculumAdapter = class {
         } else if (lower.includes("ext") || lower.includes("extension")) {
           artifactPrefix = "EXT";
         }
-        const candidateFile = path3.join(lessonDir, `${artifactPrefix}_${lessonId}.md`);
-        if (fs2.existsSync(candidateFile)) {
-          return fs2.readFileSync(candidateFile, "utf-8");
+        const candidateFile = path4.join(lessonDir, `${artifactPrefix}_${lessonId}.md`);
+        if (fs3.existsSync(candidateFile)) {
+          return fs3.readFileSync(candidateFile, "utf-8");
         }
       }
     }
@@ -8295,22 +8094,22 @@ var FileSystemCurriculumAdapter = class {
   }
   async saveArtifact(projectId, relPath, content) {
     const projectDir = this.getProjectDir(projectId);
-    const targetPath = path3.join(projectDir, relPath);
+    const targetPath = path4.join(projectDir, relPath);
     this.assertInsideProject(projectDir, targetPath);
-    const targetDir = path3.dirname(targetPath);
-    if (!fs2.existsSync(targetDir)) {
-      fs2.mkdirSync(targetDir, { recursive: true });
+    const targetDir = path4.dirname(targetPath);
+    if (!fs3.existsSync(targetDir)) {
+      fs3.mkdirSync(targetDir, { recursive: true });
     }
-    if (fs2.existsSync(targetPath)) {
+    if (fs3.existsSync(targetPath)) {
       try {
-        const oldContent = fs2.readFileSync(targetPath, "utf-8");
+        const oldContent = fs3.readFileSync(targetPath, "utf-8");
         if (oldContent !== content) {
-          const historyDir = path3.join(projectDir, ".history", relPath);
-          fs2.mkdirSync(historyDir, { recursive: true });
-          atomicWriteFileSync(path3.join(historyDir, `${Date.now()}.md`), oldContent);
-          const versions = fs2.readdirSync(historyDir).filter((f) => f.endsWith(".md")).sort();
+          const historyDir = path4.join(projectDir, ".history", relPath);
+          fs3.mkdirSync(historyDir, { recursive: true });
+          atomicWriteFileSync(path4.join(historyDir, `${Date.now()}.md`), oldContent);
+          const versions = fs3.readdirSync(historyDir).filter((f) => f.endsWith(".md")).sort();
           while (versions.length > 10) {
-            fs2.unlinkSync(path3.join(historyDir, versions.shift()));
+            fs3.unlinkSync(path4.join(historyDir, versions.shift()));
           }
         }
       } catch (histErr) {
@@ -8318,24 +8117,24 @@ var FileSystemCurriculumAdapter = class {
       }
     }
     atomicWriteFileSync(targetPath, content);
-    const filename = path3.basename(relPath);
+    const filename = path4.basename(relPath);
     const match = filename.match(/(LESSON|ACT|QUIZ|SLIDE|GUIDE|HANDOUT|WKS|EXT)_(U\d+_M\d+_L\d+)\.md/i);
     if (match) {
       const lessonId = match[2].toUpperCase();
-      atomicWriteFileSync(path3.join(projectDir, "lessons", lessonId, filename), content);
-      const legacyContentDir = path3.join(projectDir, "_content", lessonId);
-      if (fs2.existsSync(legacyContentDir)) {
-        atomicWriteFileSync(path3.join(legacyContentDir, filename), content);
+      atomicWriteFileSync(path4.join(projectDir, "lessons", lessonId, filename), content);
+      const legacyContentDir = path4.join(projectDir, "_content", lessonId);
+      if (fs3.existsSync(legacyContentDir)) {
+        atomicWriteFileSync(path4.join(legacyContentDir, filename), content);
       }
     }
   }
   async listLessons(projectId) {
-    const lessonsDir = path3.join(this.getProjectDir(projectId), "lessons");
-    if (!fs2.existsSync(lessonsDir)) return [];
-    const lessonFolders = fs2.readdirSync(lessonsDir).filter((f) => !f.startsWith("."));
+    const lessonsDir = path4.join(this.getProjectDir(projectId), "lessons");
+    if (!fs3.existsSync(lessonsDir)) return [];
+    const lessonFolders = fs3.readdirSync(lessonsDir).filter((f) => !f.startsWith("."));
     return lessonFolders.map((folder) => {
-      const lDir = path3.join(lessonsDir, folder);
-      const isDir = fs2.statSync(lDir).isDirectory();
+      const lDir = path4.join(lessonsDir, folder);
+      const isDir = fs3.statSync(lDir).isDirectory();
       if (!isDir) {
         return {
           lessonId: folder,
@@ -8344,7 +8143,7 @@ var FileSystemCurriculumAdapter = class {
           artifacts: []
         };
       }
-      const artifacts = fs2.readdirSync(lDir).filter((f) => !f.startsWith("."));
+      const artifacts = fs3.readdirSync(lDir).filter((f) => !f.startsWith("."));
       return {
         lessonId: folder,
         artifactsCount: artifacts.length,
@@ -8390,10 +8189,10 @@ ${lessonTable}
   }
   async getPipelineState(projectId) {
     const projectDir = this.getProjectDir(projectId);
-    const stateFile = path3.join(projectDir, "_pipeline", "state.json");
-    if (fs2.existsSync(stateFile)) {
+    const stateFile = path4.join(projectDir, "_pipeline", "state.json");
+    if (fs3.existsSync(stateFile)) {
       try {
-        const raw = fs2.readFileSync(stateFile, "utf-8");
+        const raw = fs3.readFileSync(stateFile, "utf-8");
         const parsed = JSON.parse(raw);
         if (parsed && typeof parsed === "object" && parsed.tasks) {
           return parsed;
@@ -8410,11 +8209,11 @@ ${lessonTable}
   }
   async savePipelineState(projectId, state) {
     const projectDir = this.getProjectDir(projectId);
-    const pipelineDir = path3.join(projectDir, "_pipeline");
-    if (!fs2.existsSync(pipelineDir)) {
-      fs2.mkdirSync(pipelineDir, { recursive: true });
+    const pipelineDir = path4.join(projectDir, "_pipeline");
+    if (!fs3.existsSync(pipelineDir)) {
+      fs3.mkdirSync(pipelineDir, { recursive: true });
     }
-    const stateFile = path3.join(pipelineDir, "state.json");
+    const stateFile = path4.join(pipelineDir, "state.json");
     state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     atomicWriteFileSync(stateFile, JSON.stringify(state, null, 2));
   }
@@ -8437,9 +8236,9 @@ ${lessonTable}
   async deleteArtifact(projectId, relPath) {
     try {
       const projectDir = this.getProjectDir(projectId);
-      const targetPath = path3.join(projectDir, relPath);
+      const targetPath = path4.join(projectDir, relPath);
       this.assertInsideProject(projectDir, targetPath);
-      if (fs2.existsSync(targetPath)) fs2.rmSync(targetPath, { force: true });
+      if (fs3.existsSync(targetPath)) fs3.rmSync(targetPath, { force: true });
     } catch {
     }
   }
@@ -9189,19 +8988,19 @@ function buildStandardStackMarkdown(opts) {
 
 // src/services/sotGeneratorService.ts
 var __filename$1 = typeof import.meta?.url === "string" && typeof fileURLToPath === "function" ? fileURLToPath(import.meta.url) : "";
-var __dirname2 = __filename$1 ? path3.dirname(__filename$1) : process.cwd();
+var __dirname2 = __filename$1 ? path4.dirname(__filename$1) : process.cwd();
 function loadSotTemplate(templateFileName) {
   const possiblePaths = [
-    path3.resolve(__dirname2, "../../docs/refs/templates", templateFileName),
-    path3.resolve(process.cwd(), "packages/curriculum-kit/docs/refs/templates", templateFileName),
-    path3.resolve(process.cwd(), "../learnwell-platform/packages/curriculum-kit/docs/refs/templates", templateFileName),
-    path3.resolve("/Users/tonypham/MEGA/WebApp/WIP/learnwell-platform/packages/curriculum-kit/docs/refs/templates", templateFileName),
-    path3.resolve("/Users/tonypham/MEGA/ai-platform/learning-artifact-gen-ui/_templates", templateFileName)
+    path4.resolve(__dirname2, "../../docs/refs/templates", templateFileName),
+    path4.resolve(process.cwd(), "packages/curriculum-kit/docs/refs/templates", templateFileName),
+    path4.resolve(process.cwd(), "../learnwell-platform/packages/curriculum-kit/docs/refs/templates", templateFileName),
+    path4.resolve("/Users/tonypham/MEGA/WebApp/WIP/learnwell-platform/packages/curriculum-kit/docs/refs/templates", templateFileName),
+    path4.resolve("/Users/tonypham/MEGA/ai-platform/learning-artifact-gen-ui/_templates", templateFileName)
   ];
   for (const p of possiblePaths) {
-    if (fs2.existsSync(p)) {
+    if (fs3.existsSync(p)) {
       try {
-        return fs2.readFileSync(p, "utf-8");
+        return fs3.readFileSync(p, "utf-8");
       } catch {
       }
     }
@@ -9617,6 +9416,7 @@ function gateModeFor(resolved, type) {
 }
 
 // src/services/languageDirective.ts
+init_templateLoader();
 function resolveTargetLanguageCode(language) {
   const raw = String(language || "vi").trim().toLowerCase();
   if (raw.startsWith("vi")) return "vi";
@@ -9657,137 +9457,58 @@ function matchesArtifactType(candidate, target) {
   if ((c === "EXT" || c === "EXTENSION") && (t === "EXT" || t === "EXTENSION")) return true;
   return false;
 }
-var DEFAULT_VIETNAMESE_SECTION_HEADINGS = {
-  LEARNER_PROFILE: {
-    "Foundational Info": "Th\xF4ng tin N\u1EC1n t\u1EA3ng",
-    "Entry Level": "Tr\xECnh \u0111\u1ED9 \u0110\u1EA7u v\xE0o",
-    "Learning Context": "B\u1ED1i c\u1EA3nh H\u1ECDc t\u1EADp",
-    "Client Objectives": "M\u1EE5c ti\xEAu Kh\xE1ch h\xE0ng & Chu\u1EA9n \u0111\u1EA7u ra"
-  },
-  PROJECT_BRIEF: {
-    "Project Overview": "T\u1ED5ng quan D\u1EF1 \xE1n",
-    "Audience & Duration": "\u0110\u1ED1i t\u01B0\u1EE3ng & Th\u1EDDi l\u01B0\u1EE3ng",
-    "Learning Roadmap": "L\u1ED9 tr\xECnh H\u1ECDc t\u1EADp & C\u1ED9t m\u1ED1c",
-    "Artifact Scope": "Ph\u1EA1m vi S\u1EA3n ph\u1EA9m H\u1ECDc t\u1EADp"
-  },
-  CURRICULUM_FRAMEWORK: {
-    "Course Overview": "T\u1ED5ng quan Kh\xF3a h\u1ECDc",
-    "Global Learning Objectives": "M\u1EE5c ti\xEAu H\u1ECDc t\u1EADp To\xE0n di\u1EC7n",
-    "Structural Hierarchy (Unit & Module)": "C\u1EA5u tr\xFAc Kh\xF3a h\u1ECDc (Unit & Module)",
-    "Scope & Sequence (Detailed Roadmap)": "Ph\u1EA1m vi & Tr\xECnh t\u1EF1 Chi ti\u1EBFt"
-  },
-  CONTENT_STYLE_GUIDE: {
-    "Voice & Tone": "Gi\u1ECDng v\u0103n & Phong c\xE1ch",
-    "Standard Terminology (Glossary)": "Thu\u1EADt ng\u1EEF Chu\u1EA9n (B\u1EA3ng thu\u1EADt ng\u1EEF)",
-    "Examples & Context Rules": "Quy t\u1EAFc V\xED d\u1EE5 & Ng\u1EEF c\u1EA3nh",
-    "Lesson Content Standards": "Ti\xEAu chu\u1EA9n N\u1ED9i dung B\xE0i h\u1ECDc"
-  },
-  SECTION_LANGUAGE_CONTRACT: {
-    "Metadata & Scope": "Th\xF4ng tin & Ph\u1EA1m vi H\u1EE3p \u0111\u1ED3ng",
-    "Section Translation Matrix": "Ma tr\u1EADn Ti\xEAu \u0111\u1EC1 \u0110a ng\xF4n ng\u1EEF",
-    "Validation Rules": "Quy t\u1EAFc X\xE1c th\u1EF1c & Kh\xF3a Chu\u1EA9n"
-  },
-  KNOWLEDGE_EXPOSITION: {
-    "Session Scope": "Ph\u1EA1m vi Bu\u1ED5i h\u1ECDc",
-    "Key Terms": "Thu\u1EADt ng\u1EEF Then ch\u1ED1t",
-    "Concept Narratives": "Di\u1EC5n gi\u1EA3i Kh\xE1i ni\u1EC7m",
-    "Worked Micro-Examples": "V\xED d\u1EE5 M\u1EABu Chi ti\u1EBFt",
-    "Common Mistakes": "L\u1ED7i Th\u01B0\u1EDDng g\u1EB7p & Kh\u1EAFc ph\u1EE5c",
-    "Self-Check Questions": "C\xE2u h\u1ECFi T\u1EF1 ki\u1EC3m tra"
-  },
-  LESSON: {
-    "A. Lesson Design Plan": "A. K\u1EBF ho\u1EA1ch Thi\u1EBFt k\u1EBF B\xE0i h\u1ECDc",
-    "Learning Objectives & Evidence": "M\u1EE5c ti\xEAu H\u1ECDc t\u1EADp & B\u1EB1ng ch\u1EE9ng N\u0103ng l\u1EF1c",
-    "Activity Sequence": "Chu\u1ED7i Ho\u1EA1t \u0111\u1ED9ng D\u1EA1y & H\u1ECDc",
-    "Resource Map": "B\u1EA3n \u0111\u1ED3 T\xE0i nguy\xEAn & H\u1ECDc li\u1EC7u",
-    "Assessment Map": "B\u1EA3n \u0111\u1ED3 \u0110\xE1nh gi\xE1 N\u0103ng l\u1EF1c",
-    "Artifact Contract": "H\u1EE3p \u0111\u1ED3ng S\u1EA3n ph\u1EA9m \u0110\u1EA7u ra",
-    "B. Lesson Flow": "B. Ti\u1EBFn tr\xECnh Gi\u1EA3ng d\u1EA1y Chi ti\u1EBFt"
-  },
-  ACT: {
-    "Computational Thinking Focus": "Tr\u1ECDng t\xE2m T\u01B0 duy M\xE1y t\xEDnh",
-    "Materials & Setup": "V\u1EADt li\u1EC7u & Chu\u1EA9n b\u1ECB Thi\u1EBFt b\u1ECB",
-    "Constraints & Safety": "R\xE0ng bu\u1ED9c & An to\xE0n Ph\xF2ng th\u1EF1c h\xE0nh",
-    "Active Learning Workflow": "Quy tr\xECnh Ho\u1EA1t \u0111\u1ED9ng Tr\u1EA3i nghi\u1EC7m",
-    "3-Tier Differentiation": "Ph\xE2n h\xF3a H\u1ECDc t\u1EADp 3 T\u1EA7ng",
-    "Reflection": "T\u1ED5ng k\u1EBFt & \u0110\xFAc k\u1EBFt Tr\u1EA3i nghi\u1EC7m"
-  },
-  CODE: {
-    "Technical Overview & Architecture Blueprint": "T\u1ED5ng quan K\u1EF9 thu\u1EADt & B\u1EA3n thi\u1EBFt k\u1EBF Ki\u1EBFn tr\xFAc",
-    "Hardware Pinout & Wiring Configuration Matrix": "S\u01A1 \u0111\u1ED3 Ch\xE2n & Ma tr\u1EADn N\u1ED1i d\xE2y Ph\u1EA7n c\u1EE9ng",
-    "Starter Code Sandbox": "M\xE3 ngu\u1ED3n Kh\u1EDFi \u0111\u1EA7u (Starter Code)",
-    "Verified Reference Solution Code": "M\xE3 ngu\u1ED3n L\u1EDDi gi\u1EA3i Chu\u1EA9n (Reference Solution)",
-    "Automated Test / Verification Script": "K\u1ECBch b\u1EA3n Ki\u1EC3m th\u1EED T\u1EF1 \u0111\u1ED9ng",
-    "Common Syntax & Runtime Pitfalls Matrix": "Ma tr\u1EADn L\u1ED7i C\xFA ph\xE1p & Th\u1EDDi gian ch\u1EA1y Th\u01B0\u1EDDng g\u1EB7p"
-  },
-  CODE_LAB: {
-    "Technical Overview & Architecture Blueprint": "T\u1ED5ng quan K\u1EF9 thu\u1EADt & B\u1EA3n thi\u1EBFt k\u1EBF Ki\u1EBFn tr\xFAc",
-    "Hardware Pinout & Wiring Configuration Matrix": "S\u01A1 \u0111\u1ED3 Ch\xE2n & Ma tr\u1EADn N\u1ED1i d\xE2y Ph\u1EA7n c\u1EE9ng",
-    "Starter Code Sandbox": "M\xE3 ngu\u1ED3n Kh\u1EDFi \u0111\u1EA7u (Starter Code)",
-    "Verified Reference Solution Code": "M\xE3 ngu\u1ED3n L\u1EDDi gi\u1EA3i Chu\u1EA9n (Reference Solution)",
-    "Automated Test / Verification Script": "K\u1ECBch b\u1EA3n Ki\u1EC3m th\u1EED T\u1EF1 \u0111\u1ED9ng",
-    "Common Syntax & Runtime Pitfalls Matrix": "Ma tr\u1EADn L\u1ED7i C\xFA ph\xE1p & Th\u1EDDi gian ch\u1EA1y Th\u01B0\u1EDDng g\u1EB7p"
-  },
-  QUIZ: {
-    "Assessment Objectives": "M\u1EE5c ti\xEAu \u0110\xE1nh gi\xE1",
-    "Multiple-Choice Question Bank": "Ng\xE2n h\xE0ng C\xE2u h\u1ECFi Tr\u1EAFc nghi\u1EC7m",
-    "Code Analysis / Debugging Question": "C\xE2u h\u1ECFi Ph\xE2n t\xEDch M\xE3 ngu\u1ED3n & S\u1EEDa l\u1ED7i",
-    "Competency Rubric": "Thang \u0111o \u0110\xE1nh gi\xE1 N\u0103ng l\u1EF1c (Rubric)"
-  },
-  GUIDE: {
-    "Objectives & Preparation": "M\u1EE5c ti\xEAu & Chu\u1EA9n b\u1ECB Gi\u1EA3ng d\u1EA1y",
-    "Preparation Checklist & Workstation Setup": "Danh m\u1EE5c Ki\u1EC3m tra Chu\u1EA9n b\u1ECB & Tr\u1EA1m Th\u1EF1c h\xE0nh",
-    "Facilitation Script & Timeline": "K\u1ECBch b\u1EA3n \u0110i\u1EC1u ph\u1ED1i & Khung Th\u1EDDi gian",
-    "Common Misconceptions & Diagnostic Remediation Matrix": "Quan ni\u1EC7m Sai l\u1EA7m Th\u01B0\u1EDDng g\u1EB7p & Ma tr\u1EADn Kh\u1EAFc ph\u1EE5c",
-    "Differentiated Support Strategies": "Chi\u1EBFn l\u01B0\u1EE3c H\u1ED7 tr\u1EE3 Ph\xE2n h\xF3a"
-  },
-  HANDOUT: {
-    "Core Concepts": "Kh\xE1i ni\u1EC7m C\u1ED1t l\xF5i",
-    "Core Syntax & Mechanism Cheat Sheet": "B\u1EA3ng Tra c\u1EE9u C\xFA ph\xE1p & C\u01A1 ch\u1EBF Tr\u1ECDng t\xE2m",
-    "Visual Mental Model / Architecture Diagram": "M\xF4 h\xECnh T\u01B0 duy Tr\u1EF1c quan / S\u01A1 \u0111\u1ED3 Ki\u1EBFn tr\xFAc",
-    "Step-by-Step Practical Quick-Start Guide": "H\u01B0\u1EDBng d\u1EABn Th\u1EF1c h\xE0nh T\u1EEBng b\u01B0\u1EDBc",
-    "Self-Check Diagnostic Checklist": "B\u1EA3ng Ki\u1EC3m tra T\u1EF1 ch\u1EA9n \u0111o\xE1n"
-  },
-  WKS: {
-    "Part 1: Knowledge Check": "Ph\u1EA7n 1: Ki\u1EC3m tra Ki\u1EBFn th\u1EE9c",
-    "Part 2: Concept Tracing & Diagram Fill-in": "Ph\u1EA7n 2: L\u1EA7n v\u1EBFt Kh\xE1i ni\u1EC7m & \u0110i\u1EC1n S\u01A1 \u0111\u1ED3",
-    "Part 3: Code Analysis & Bug Hunting Challenge": "Ph\u1EA7n 3: Ph\xE2n t\xEDch M\xE3 & Th\u1EED th\xE1ch S\u0103n l\u1ED7i",
-    "Part 4: Synthesis & Problem-Solving Application": "Ph\u1EA7n 4: T\u1ED5ng h\u1EE3p & \u1EE8ng d\u1EE5ng Gi\u1EA3i quy\u1EBFt V\u1EA5n \u0111\u1EC1",
-    "Part 5: Self-Reflection & Learning Log": "Ph\u1EA7n 5: T\u1EF1 suy ng\u1EABm & Nh\u1EADt k\xFD H\u1ECDc t\u1EADp"
-  },
-  EXT: {
-    "For: Advanced Students / Extra Time": "D\xE0nh cho: H\u1ECDc sinh N\xE2ng cao / Ho\xE0n th\xE0nh S\u1EDBm",
-    "Challenge 1: Mission Briefing & Real-World High-Stakes Scenario": "Th\u1EED th\xE1ch 1: B\u1ED1i c\u1EA3nh Nhi\u1EC7m v\u1EE5 Th\u1EF1c t\u1EBF & K\u1ECBch b\u1EA3n \u1EE8ng d\u1EE5ng",
-    "Challenge 2: Advanced Architectural Constraints & Edge Cases": "Th\u1EED th\xE1ch 2: R\xE0ng bu\u1ED9c Ki\u1EBFn tr\xFAc N\xE2ng cao & Tr\u01B0\u1EDDng h\u1EE3p Bi\xEAn",
-    "Challenge 3: Extension Milestones": "Th\u1EED th\xE1ch 3: C\xE1c M\u1ED1c Nhi\u1EC7m v\u1EE5 N\xE2ng cao",
-    "Metacognitive Deep Dive & Engineering Trade-offs": "Suy ng\u1EABm Si\xEAu nh\u1EADn th\u1EE9c & \u0110\xE1nh \u0111\u1ED5i K\u1EF9 thu\u1EADt"
-  },
-  SLIDE: {
-    "Title & Agenda": "Ti\xEAu \u0111\u1EC1 & M\u1EE5c l\u1EE5c",
-    "Core Concepts": "Kh\xE1i ni\u1EC7m C\u1ED1t l\xF5i",
-    "Guided Demonstration": "H\u01B0\u1EDBng d\u1EABn Th\u1EF1c h\xE0nh & Th\u1ECB ph\u1EA1m",
-    "Hands-on Mission": "Nhi\u1EC7m v\u1EE5 Th\u1EF1c h\xE0nh Tr\u1EA3i nghi\u1EC7m",
-    "Summary & Next Steps": "T\u1ED5ng k\u1EBFt & \u0110\u1ECBnh h\u01B0\u1EDBng Ti\u1EBFp theo"
-  }
+var TEMPLATE_BY_TYPE = {
+  LESSON: "LESSON_5E_template.md",
+  LESSON_5E: "LESSON_5E_template.md",
+  LESSON_EDP: "LESSON_EDP_template.md",
+  LESSON_GENERAL: "LESSON_GENERAL_template.md",
+  ACT: "ACT_template.md",
+  CODE: "CODE_template.md",
+  // JSON-first code lab shares the CODE label set (the serializer renders its
+  // own headings; this lookup only feeds the SLC/directive fallback path).
+  CODE_LAB: "CODE_template.md",
+  QUIZ: "QUIZ_v4.6_template.md",
+  GUIDE: "GUIDE_template.md",
+  HANDOUT: "HANDOUT_template.md",
+  WKS: "WKS_template.md",
+  EXT: "EXT_template.md",
+  SLIDE: "SLIDE_template.md",
+  KNOWLEDGE_EXPOSITION: "KNOWLEDGE_EXPOSITION_template.md",
+  LEARNER_PROFILE: "LEARNER_PROFILE_template.md",
+  PROJECT_BRIEF: "PROJECT_BRIEF_template.md",
+  CURRICULUM_FRAMEWORK: "CURRICULUM_FRAMEWORK_template.md",
+  CONTENT_STYLE_GUIDE: "CONTENT_STYLE_GUIDE_template.md",
+  SECTION_LANGUAGE_CONTRACT: "SECTION_LANGUAGE_CONTRACT_template.md"
 };
+function keepContractEntries(artifactType, mapping) {
+  const templateFile = TEMPLATE_BY_TYPE[artifactType.trim().toUpperCase()];
+  if (!templateFile) return mapping;
+  const resolved = resolveArtifactTemplate(templateFile);
+  if (!resolved) return mapping;
+  const contract = new Set(resolved.sections.map(stripHeadingKey));
+  const kept = {};
+  for (const [k, v] of Object.entries(mapping)) {
+    if (contract.has(stripHeadingKey(k))) kept[k] = v;
+  }
+  return kept;
+}
 function extractSectionHeadingsFromSLC(slcInput, artifactType, targetLanguage = "vi") {
   const upperType = artifactType.trim().toUpperCase();
   const getFallback = () => {
-    if (resolveTargetLanguageCode(targetLanguage) === "vi") {
-      for (const [key, mapping] of Object.entries(DEFAULT_VIETNAMESE_SECTION_HEADINGS)) {
-        if (matchesArtifactType(key, upperType)) {
-          return mapping;
-        }
-      }
-    }
-    return {};
+    const templateFile = TEMPLATE_BY_TYPE[upperType];
+    if (!templateFile) return {};
+    const resolved = resolveArtifactTemplate(templateFile);
+    if (!resolved) return {};
+    return Object.fromEntries(resolved.sections.map((s) => [s, s]));
   };
   if (!slcInput) return getFallback();
   if (typeof slcInput === "object") {
-    if (slcInput[upperType] && Object.keys(slcInput[upperType]).length > 0) return slcInput[upperType];
+    if (slcInput[upperType] && Object.keys(slcInput[upperType]).length > 0) {
+      return keepContractEntries(upperType, slcInput[upperType]);
+    }
     for (const [key, mapping] of Object.entries(slcInput)) {
       if (matchesArtifactType(key, upperType) && Object.keys(mapping).length > 0) {
-        return mapping;
+        return keepContractEntries(upperType, mapping);
       }
     }
     return getFallback();
@@ -9815,24 +9536,33 @@ function extractSectionHeadingsFromSLC(slcInput, artifactType, targetLanguage =
           }
         }
       }
-      if (Object.keys(mapping).length > 0) return mapping;
+      if (Object.keys(mapping).length > 0) return keepContractEntries(upperType, mapping);
     }
   }
   return getFallback();
 }
-function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi") {
-  const headings = extractSectionHeadingsFromSLC(slcMarkdown, artifactType, targetLanguage);
+function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi", opts) {
+  const upperType = artifactType.trim().toUpperCase();
+  const templateFile = TEMPLATE_BY_TYPE[upperType];
+  const resolved = templateFile ? resolveArtifactTemplate(templateFile, opts) : null;
+  const baked = !!resolved && resolved.declaredLang !== "en";
+  const headings = resolved ? Object.fromEntries(
+    resolved.sections.map((s) => [
+      s,
+      baked ? s : extractSectionHeadingsFromSLC(slcMarkdown, upperType, targetLanguage)[s] || s
+    ])
+  ) : extractSectionHeadingsFromSLC(baked ? null : slcMarkdown, upperType, targetLanguage);
   if (Object.keys(headings).length === 0) {
     return "";
   }
   const lines = Object.entries(headings).map(
-    ([canonical, localized]) => `  - "${canonical}" -> Use Display Heading: "${localized}"`
+    ([heading, display]) => heading === display ? `  - "${display}"` : `  - "${heading}" -> Use Display Heading: "${display}"`
   );
-  return `MANDATORY SECTION HEADINGS FROM SECTION_LANGUAGE_CONTRACT:
-- The YAML frontmatter \`template_required_sections\` MUST preserve the exact English canonical keys.
-- In the markdown body, section headers MUST use the EXACT Localized Display Labels below (do NOT translate or paraphrase):
+  return `MANDATORY SECTION HEADINGS (SOURCE: RESOLVED ARTIFACT TEMPLATE):
+- Copy the template's YAML frontmatter \`template_required_sections\` list VERBATIM into the artifact frontmatter \u2014 never translate, reorder, or invent entries.
+- In the markdown body, section headers MUST be exactly the Display Headings below (do NOT translate, paraphrase, or re-marker them):
 ${lines.join("\n")}
-- For example: if canonical section is "Computational Thinking Focus", your heading must be "## [REQUIRED] ${headings["Computational Thinking Focus"] || "Computational Thinking Focus"}".`;
+- Example: if the resolved template's heading is "${Object.values(headings)[0]}", your body heading must be exactly "## ${Object.values(headings)[0]}".`;
 }
 
 // src/services/curriculumHorizon.ts
@@ -10686,14 +10416,13 @@ function buildSystemPrompt(targetLanguage = "vi", techStack, hardwarePlatform) {
 function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMarkdown, refPack) {
   const depthLines = session.depth_assignments.map((d) => "- " + d.node_id + " [" + d.depth.toUpperCase() + "]: " + DEPTH_RULES[d.depth]).join("\n");
   const termLines = glossary.map((g) => "- " + g.term + (g.definition ? " \u2014 " + g.definition : "") + (g.example ? " (example: " + g.example + ")" : "")).join("\n");
-  const langCode = resolveTargetLanguageCode(targetLanguage);
-  const headings = extractSectionHeadingsFromSLC(slcMarkdown, "KNOWLEDGE_EXPOSITION");
-  const hScope = headings["Session Scope"] || (langCode === "vi" ? "Ph\u1EA1m vi Bu\u1ED5i h\u1ECDc" : "Session Scope");
-  const hTerms = headings["Key Terms"] || (langCode === "vi" ? "Thu\u1EADt ng\u1EEF Then ch\u1ED1t" : "Key Terms");
-  const hNarratives = headings["Concept Narratives"] || (langCode === "vi" ? "Di\u1EC5n gi\u1EA3i Kh\xE1i ni\u1EC7m" : "Concept Narratives");
-  const hExamples = headings["Worked Micro-Examples"] || (langCode === "vi" ? "V\xED d\u1EE5 M\u1EABu Chi ti\u1EBFt" : "Worked Micro-Examples");
-  const hMistakes = headings["Common Mistakes"] || (langCode === "vi" ? "L\u1ED7i Th\u01B0\u1EDDng g\u1EB7p & Kh\u1EAFc ph\u1EE5c" : "Common Mistakes");
-  const hQuestions = headings["Self-Check Questions"] || (langCode === "vi" ? "C\xE2u h\u1ECFi T\u1EF1 ki\u1EC3m tra" : "Self-Check Questions");
+  const headings = extractSectionHeadingsFromSLC(slcMarkdown, "KNOWLEDGE_EXPOSITION", targetLanguage);
+  const hScope = headings["Session Scope"] || "Session Scope";
+  const hTerms = headings["Key Terms"] || "Key Terms";
+  const hNarratives = headings["Concept Narratives"] || "Concept Narratives";
+  const hExamples = headings["Worked Micro-Examples"] || "Worked Micro-Examples";
+  const hMistakes = headings["Common Mistakes"] || "Common Mistakes";
+  const hQuestions = headings["Self-Check Questions"] || "Self-Check Questions";
   const skeleton = `## ${hScope} / ## ${hTerms} / ## ${hNarratives} / ## ${hExamples} / ## ${hMistakes} / ## ${hQuestions}`;
   const headingDirective = buildHeadingDirective("KNOWLEDGE_EXPOSITION", slcMarkdown, targetLanguage);
   let refPackBlock = "";
@@ -25449,98 +25178,9 @@ 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 };
 }
-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 import.meta !== "undefined" && typeof import.meta.url === "string") {
-      return path3.dirname(fileURLToPath(import.meta.url));
-    }
-  } 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.resolve(process.cwd(), "_templates"));
-  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
-    dirs.push(path3.resolve(_moduleDir, rel));
-    dirs.push(path3.resolve(process.cwd(), rel));
-    dirs.push(path3.resolve(process.cwd(), "packages/curriculum-kit", rel));
-  }
-  return dirs;
-}
-function findTemplatePath(templateName, explicitDir) {
-  for (const dir of candidateDirs(explicitDir)) {
-    const p = path3.join(dir, templateName);
-    if (!fs2.existsSync(p)) continue;
-    try {
-      fs2.accessSync(p, fs2.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.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.readFileSync(p, "utf-8");
-  } catch {
-    return "";
-  }
-}
 
 // src/services/lessonProductionService.ts
+init_templateLoader();
 var LESSON_TEMPLATE_BY_PEDAGOGY = {
   edp: "LESSON_EDP_template.md",
   general: "LESSON_GENERAL_template.md",
@@ -29476,14 +29116,15 @@ function isTranslationDue(target, context) {
 }
 
 // src/services/index.ts
+init_templateLoader();
 init_slideProductionWorkflow();
 var LocalWorkspaceManager = class {
   baseDir;
   constructor(baseDir) {
-    this.baseDir = baseDir || path3.resolve(process.cwd(), "output", "workspace-jobs");
+    this.baseDir = baseDir || path4.resolve(process.cwd(), "output", "workspace-jobs");
   }
   getJobDirectory(jobId) {
-    return path3.join(this.baseDir, jobId);
+    return path4.join(this.baseDir, jobId);
   }
   async initJobWorkspace(jobId, initialInfo) {
     const jobDir = this.getJobDirectory(jobId);
@@ -29506,9 +29147,9 @@ var LocalWorkspaceManager = class {
   }
   async saveArtifact(jobId, milestoneSlug, filename, content, artifactType) {
     const jobDir = this.getJobDirectory(jobId);
-    const targetDir = path3.join(jobDir, milestoneSlug);
+    const targetDir = path4.join(jobDir, milestoneSlug);
     await fsPromises.mkdir(targetDir, { recursive: true });
-    const filePath = path3.join(targetDir, filename);
+    const filePath = path4.join(targetDir, filename);
     await fsPromises.writeFile(filePath, content, "utf-8");
     const stat = await fsPromises.stat(filePath);
     const manifest = await this.getManifest(jobId);
@@ -29516,7 +29157,7 @@ var LocalWorkspaceManager = class {
       manifest.artifacts.push({
         milestoneId: milestoneSlug,
         artifactType,
-        filePath: path3.relative(jobDir, filePath),
+        filePath: path4.relative(jobDir, filePath),
         sizeBytes: stat.size,
         createdAt: (/* @__PURE__ */ new Date()).toISOString()
       });
@@ -29526,7 +29167,7 @@ var LocalWorkspaceManager = class {
     return filePath;
   }
   async getManifest(jobId) {
-    const manifestPath = path3.join(this.getJobDirectory(jobId), "manifest.json");
+    const manifestPath = path4.join(this.getJobDirectory(jobId), "manifest.json");
     try {
       const data = await fsPromises.readFile(manifestPath, "utf-8");
       return JSON.parse(data);
@@ -29535,7 +29176,7 @@ var LocalWorkspaceManager = class {
     }
   }
   async saveManifest(jobId, manifest) {
-    const manifestPath = path3.join(this.getJobDirectory(jobId), "manifest.json");
+    const manifestPath = path4.join(this.getJobDirectory(jobId), "manifest.json");
     manifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     await fsPromises.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
   }
@@ -29576,12 +29217,12 @@ async function publishToGitHub(options) {
     async function scanDir(currentDir) {
       const entries = await fsPromises.readdir(currentDir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = path3.join(currentDir, entry.name);
+        const fullPath = path4.join(currentDir, entry.name);
         if (entry.isDirectory()) {
           await scanDir(fullPath);
         } else if (entry.isFile() && !entry.name.startsWith(".")) {
           const content = await fsPromises.readFile(fullPath, "utf-8");
-          const relPath = path3.relative(options.localJobDir, fullPath);
+          const relPath = path4.relative(options.localJobDir, fullPath);
           filesToUpload.push({ path: relPath, content });
         }
       }
@@ -31687,13 +31328,13 @@ var MediaLedger = class {
   filePath;
   entries = /* @__PURE__ */ new Map();
   constructor(projectDir, lessonId) {
-    this.filePath = path3.join(projectDir, "_media", `ledger-${lessonId.toUpperCase()}.jsonl`);
+    this.filePath = path4.join(projectDir, "_media", `ledger-${lessonId.toUpperCase()}.jsonl`);
     this.load();
   }
   load() {
     this.entries.clear();
-    if (!fs2.existsSync(this.filePath)) return;
-    const lines = fs2.readFileSync(this.filePath, "utf-8").split("\n");
+    if (!fs3.existsSync(this.filePath)) return;
+    const lines = fs3.readFileSync(this.filePath, "utf-8").split("\n");
     for (const line of lines) {
       const trimmed = line.trim();
       if (!trimmed) continue;
@@ -31705,8 +31346,8 @@ var MediaLedger = class {
     }
   }
   persist() {
-    fs2.mkdirSync(path3.dirname(this.filePath), { recursive: true });
-    fs2.writeFileSync(this.filePath, Array.from(this.entries.values()).map((e) => JSON.stringify(e)).join("\n") + "\n", "utf-8");
+    fs3.mkdirSync(path4.dirname(this.filePath), { recursive: true });
+    fs3.writeFileSync(this.filePath, Array.from(this.entries.values()).map((e) => JSON.stringify(e)).join("\n") + "\n", "utf-8");
   }
   /** Agent tạo artifact ghi entry mới (hoặc cập nhật nếu slug đã có và chưa done) */
   upsert(input) {
@@ -31888,8 +31529,8 @@ async function fulfillMediaLedger(options) {
   const maxRetries = options.maxRetries ?? 2;
   const approved = ledger.listByStatus("approved");
   const result = { done: [], failed: [], skipped: [] };
-  const mediaDir = path3.join(projectDir, "_media");
-  fs2.mkdirSync(mediaDir, { recursive: true });
+  const mediaDir = path4.join(projectDir, "_media");
+  fs3.mkdirSync(mediaDir, { recursive: true });
   const mode = policy.mode ?? "auto";
   const canSearch = mode === "search_only" || mode === "auto";
   const canGen = mode === "gen_only" || mode === "auto";
@@ -31971,7 +31612,7 @@ async function fulfillMediaLedger(options) {
         });
         const ext = image.mimeType === "image/jpeg" ? "jpg" : "png";
         const filename = `${entry.slug}-${Date.now()}.${ext}`;
-        fs2.writeFileSync(path3.join(mediaDir, filename), Buffer.from(image.base64, "base64"));
+        fs3.writeFileSync(path4.join(mediaDir, filename), Buffer.from(image.base64, "base64"));
         ledger.setStatus(entry.slug, "done", { relPath: `_media/${filename}`, provider: image.provider });
         result.done.push(entry.slug);
         options.onProgress?.(entry.slug, "done", `source: ${image.provider}`);
@@ -32002,6 +31643,6 @@ function renderMediaPlaceholder(entry) {
   return `> \u{1F5BC}\uFE0F [\u1EA2nh \u0111ang ch\u1EDD: ${entry.name} \u2014 s\u1EBD \u0111\u01B0\u1EE3c t\u1EA1o sau khi duy\u1EC7t media]`;
 }
 
-export { ACT_TEMPLATE, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, AcademicAuditor, ActionableRepairActionSchema, ActionableRepairPromptSchema, ActiveLearningWorkflowSchema, ActivityLabSchema, ActivitySeqRowSchema, ActivityStepSchema, ArtifactContractRowSchema, AssessmentMapRowSchema, AssessmentObjectiveSchema, BLOOM_ACTION_VERBS, BUNDLED_STANDARDS_PACK_IDS, BellRingerDaySchema, BellRingerSchema, BloomHintSchema, BloomLevelSchema, BloomTaxonomyEvaluator, BronzeTierSchema, CERConclusionSchema, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CardTierEnum, ChoiceBoardRubricRowSchema, ChoiceBoardSchema, ChoiceRuleSchema, ChoiceSquareSchema, ClassificationSchema, CodeHardwareFeasibilityEvaluator, CodeLabSchema, CodeSnippetSchema, CompetencyRubricRowSchema, ComputationalThinkingSchema, ConceptPrerequisiteEdgeSchema, ConceptSpiralEncounterSchema, ConstructiveAlignmentEvaluator, CoreConceptSchema, CourseObjectiveSchema, CoverageReportSchema, CrossArtifactDriftEvaluator, CurriculumArtifactSchema, CurriculumError, CurriculumPlanSchema, CurriculumQualityReportSchema, DEFAULT_ARTIFACT_STREAM_IDLE_MS, DEFAULT_ARTIFACT_STREAM_TOTAL_MS, DEFAULT_ENABLED_PROVIDERS, DEFAULT_GATE_SETTINGS, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_OVERHEAD_RATIO, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DEFAULT_VIETNAMESE_SECTION_HEADINGS, DependencyEdgeSchema, DepthAssignmentSchema, DepthLevelSchema, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuestionSchema, DiagnosticQuizSchema, EDPPhaseEnum, ENVIRONMENT_PROVISIONING_MODELS, EXPOSITION_REL, EntryLevelSchema, ExitTicketBugHuntSchema, ExitTicketMetacognitionSchema, ExitTicketQuickItemSchema, ExitTicketRecallPromptSchema, ExitTicketSchema, ExperimentalDesignSchema, ExpositionApprovalError, ExtensionChallengeSchema, ExtensionSchema, FileSystemCurriculumAdapter, FiveEFlowPhaseSchema, FiveEInstructionalEvaluator, FiveEPhaseEnum, FrameworkMappingSchema, FrameworkPackManifestSchema, FrameworkPackSchema, FrameworkStatementSchema, GeneratedSlideArraySchema, GeneratedSlideSchema, GlossaryQuickRefRowSchema, GlossarySchema, GlossaryTermSchema, GoldTierSchema, GradeBandSchema, GraphicOrganizerItemSchema, GraphicOrganizerSchema, HandoutSchema, HandoutSectionSchema, HybridBlueprintArraySchema, HybridBlueprintItemSchema, HybridDeckSlideArraySchema, HybridDeckSlideSchema, HybridPipelineError, InstructionSectionSchema, InstructionStepSchema, JUDGE_AUTO_APPROVE_THRESHOLD, JUDGE_ESCALATE_THRESHOLD, JudgeCriterionSchema, LAYER_IDLE_BUDGET_MS, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, LLMJudgeEngine, LabTierTaskSchema, LearningObjectiveInputSchema, LearningObjectiveRowSchema, LessonEntitySchema, LessonFlowPhaseSchema, LessonPlan5ESchema, LessonPlanEDPSchema, LessonPlanSchema, LessonSectionSchema, LocalWorkspaceManager, MAX_AUTONOMOUS_REPAIR_TURNS, MAX_IN_SESSION_SETUP_MINUTES, MAX_NEW_CONCEPTS_PER_SESSION_ADULT, MAX_NEW_CONCEPTS_PER_SESSION_K12, MacroPedagogyPlanAuditSchema, MappingKindSchema, MarpSlideSchema, MasteryGateSchema, MediaError, MediaLedger, MentorCheatsheetSchema, MilestoneInputSchema, MisconceptionEvaluator, MisconceptionSchema, ModelPolicyResolver, NVIDIA_MODELS, NodeKindSchema, OrganizerTypeEnum, PhaseInputSchema, PlanConstraintsSchema, PlannerInputSchema, PlanningGraphSchema, PlanningNodeSchema, PrerequisiteDecisionEntrySchema, PrerequisiteDecisionSchema, ProductGoalSchema, ProgressiveHintsSchema, ProjectGraphAuditSchema, ProjectGraphSchema, ProjectInstructionSchema, ProjectProfileSchema, QUIZ_TEMPLATE, QualityAuditVerdictSchema, QuizOptionSchema, RecordProvenanceSchema, ResourceMapRowSchema, ReviewGameExportRowSchema, ReviewGameQuestionSchema, ReviewGameSchema, RoadmapInputSchema, RotationStationSchema, RubricCriteriaSchema, RubricSchema, SATELLITE_LESSON_PRIORITIES, SELF_LAB_TEMPLATE, SLIDE_CANONICAL_METHODOLOGY, STANDARD_REF_REGEX, STANDARD_SOT_FILES, STUDENT_FRICTION_MULTIPLIER, ScaffoldDecisionEntrySchema, ScaffoldDecisionSchema, ScienceLabSchema, ScoringRubricRowSchema, SelfLabSchema, SelfPacedBundleSchema, SelfPacedChallengeSchema, SessionPlanSchema, SessionZpdStatusSchema, SilverTierSchema, SlideBlueprintArraySchema, SlideBlueprintItemSchema, SlideDeckSchema, StandardizedTermRowSchema, StandardsRegistryAdapter, StationRecordRowSchema, StationRotationSchema, StationTypeEnum, SupabaseCurriculumAdapter, TaskCardSchema, TaskCardsSchema, TeacherGuideSchema, TeachingScriptPhaseSchema, TierLevelEnum, TierObjectiveSchema, TieredPracticeSchema, TranslationPolicySchema, TroubleshootingEntrySchema, TroubleshootingRowSchema, UnitPlanSchema, UserJourneySchema, WalkingSkeletonSchema, WorksheetItemSchema, WorksheetItemTypeEnum, WorksheetPartSchema, WorksheetSchema, ZpdVerdictSchema, activityTools, analystTools, analyzeProjectCreationIntent, assertAcyclic, assessorTools, assignDepths, atomicWriteFileSync, auditCurriculumPlanFlow, auditCurriculumQualityFlow, auditProjectGraphFlow, auditQualityReport, buildActivityPrompt, buildArtifactPrompt, buildCodeLabPrompt, buildConceptPrerequisites, buildCurriculumContext, buildCurriculumPlan, buildCurriculumPlanJudgePrompt, buildDeliveryPackages, buildDiagnosticQuizPrompt, buildDomainLexiconGuardrail, buildExpositionContext, buildExpositionExcerpt, buildExtensionPrompt, buildHandoutPrompt, buildHeadingDirective, buildHtmlDeckSlidePrompt, buildImagePrompt, buildJudgePrompt, buildLanguageDirective, buildLessonEntityJson, buildLessonExcerpt, buildLessonMasterPrompt, buildMarpMarkdownSlidePrompt, buildMasteryGates, buildProjectGraphJudgePrompt, buildProjectInstructionPrompt, buildSatelliteContext, buildSectionAwareExcerpt, buildSelfLabPrompt, buildSessionSliceContext, buildSlidesPrompt, buildStandardStackMarkdown, buildStandardsContext, buildStandardsContextBlock, buildTeacherGuidePrompt, buildWalkingSkeleton, buildWorksheetPrompt, checkSessionZpd, closeTruncatedJson, computeConceptSpiralProgression, computeContentHash, computePackingSpec, conductPreliminaryResearch, contentTools, convertRoadmapToFoundationSot, createAiInferenceError, createContextMissingError, createCurriculumStorage, createIdleAbortController, createStreamAbortController, createStreamAbortSignal, createStreamChunkExtractor, curateMediaLedger, designerTools, detectProjectPedagogy, dropCyclicConceptEdges, emitUsage, ensureExpositionForLesson, ensureKnowledgeExposition, entityRowAssignedTo, evaluateActivityAlignment, evaluateStandardsCoverage, executeCurriculumCommand, executeSlideProductionWorkflow, exportAllProjectQuizzes, expositionCacheKey, extractActivityContractRows, extractAssessmentMap, extractBodySections, extractCurriculumHorizon, extractJsonArray, extractRequiredSections, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStandardRefs, extractStreamChunk, extractSymbolLedger, extractThoughtAndContent, extractTieredScaffoldingBlock, findStandardStatement, formatQuizzesToCsv, fulfillMediaLedger, gateModeFor, generateActivityFlow, generateCodeLabFlow, generateDiagnosticQuizFlow, generateEducationalImage, generateExtensionFlow, generateHandoutFlow, generateLessonMasterFlow, generateMilestoneCurriculumBundle, generatePhase1SotArtifacts, generatePhase2SotArtifacts, generateProjectInstruction, generateProjectInstructionFlow, generateRoadmapCurriculum, generateSelfLabFlow, generateSelfPacedBundle, generateSingleArtifact, generateSlidesFlow, generateTeacherGuideFlow, generateWorksheetFlow, getAIModel, getArtifactMetadata, getDesignatedFallbackChain, getDesignatedFallbackConfig, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSmartResumeContext, glossaryTermsForSession, illustratorTools, importRoadmapToProject, ingestProjectGraphIntoProject, initializeProjectInStorage, injectMediaIntoMarkdown, isActivityAlignmentLogOnly, isExpositionFresh, isModelAllowed, isProviderEnabled, isTranslationDue, lintAndSanitizeArtifact, lintCurriculumFramework, lintFrameworkPack, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, normalizeSlcContract, packagerTools, parseAllSessions, parseGateSettings, parseQuizMarkdown, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, publishToGitHub, publishToSupabase, rankGenCandidates, renderAssignedRowsTable, renderEntitySlotsForType, renderFrameworkFromPlan, renderHorizonPromptBlock, renderMediaPlaceholder, researcherTools, resolveApiKey, resolveArtifactTemplate, resolveGateSettings, resolveStandardsPacks, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, reviewerTools, runCurriculumAIInference, safeParseJson, searchEducationalImages, searchEducationalVideos, selectStatementsForLesson, serializeActivityToMarkdown, serializeCodeLabToMarkdown, serializeDiagnosticQuizToMarkdown, serializeHandoutToMarkdown, serializeLessonToMarkdown, serializeProjectInstructionToMarkdown, serializeSelfLabToMarkdown, slugifyProjectName, streamCurriculumAIInference, streamCurriculumAIInferenceWithTools, streamDiagnosticQuizFlow, streamLLMWithFallback, streamLayerPrefillWithFallback, streamLessonMasterFlow, streamSelfLabFlow, stripLlmJsonWrappers, stripTemplateFrontmatter, targetLanguageDisplayName, techSmeTools, topoSort, uploadAssetToBucket, validateArtifactDependencies, validateCurriculumPlan, validateFrameworkPack, validateHorizonCompliance, validateHybridDeckSlides, validateMarkdownTables, validateMermaidSyntax, withAutoRepair };
+export { ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, AcademicAuditor, ActionableRepairActionSchema, ActionableRepairPromptSchema, ActiveLearningWorkflowSchema, ActivityLabSchema, ActivitySeqRowSchema, ActivityStepSchema, ArtifactContractRowSchema, AssessmentMapRowSchema, AssessmentObjectiveSchema, BLOOM_ACTION_VERBS, BUNDLED_STANDARDS_PACK_IDS, BellRingerDaySchema, BellRingerSchema, BloomHintSchema, BloomLevelSchema, BloomTaxonomyEvaluator, BronzeTierSchema, CERConclusionSchema, CURRICULUM_SLASH_COMMANDS, CardTierEnum, ChoiceBoardRubricRowSchema, ChoiceBoardSchema, ChoiceRuleSchema, ChoiceSquareSchema, ClassificationSchema, CodeHardwareFeasibilityEvaluator, CodeLabSchema, CodeSnippetSchema, CompetencyRubricRowSchema, ComputationalThinkingSchema, ConceptPrerequisiteEdgeSchema, ConceptSpiralEncounterSchema, ConstructiveAlignmentEvaluator, CoreConceptSchema, CourseObjectiveSchema, CoverageReportSchema, CrossArtifactDriftEvaluator, CurriculumArtifactSchema, CurriculumError, CurriculumPlanSchema, CurriculumQualityReportSchema, DEFAULT_ARTIFACT_STREAM_IDLE_MS, DEFAULT_ARTIFACT_STREAM_TOTAL_MS, DEFAULT_ENABLED_PROVIDERS, DEFAULT_GATE_SETTINGS, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_OVERHEAD_RATIO, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdgeSchema, DepthAssignmentSchema, DepthLevelSchema, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuestionSchema, DiagnosticQuizSchema, EDPPhaseEnum, ENVIRONMENT_PROVISIONING_MODELS, EXPOSITION_REL, EntryLevelSchema, ExitTicketBugHuntSchema, ExitTicketMetacognitionSchema, ExitTicketQuickItemSchema, ExitTicketRecallPromptSchema, ExitTicketSchema, ExperimentalDesignSchema, ExpositionApprovalError, ExtensionChallengeSchema, ExtensionSchema, FileSystemCurriculumAdapter, FiveEFlowPhaseSchema, FiveEInstructionalEvaluator, FiveEPhaseEnum, FrameworkMappingSchema, FrameworkPackManifestSchema, FrameworkPackSchema, FrameworkStatementSchema, GeneratedSlideArraySchema, GeneratedSlideSchema, GlossaryQuickRefRowSchema, GlossarySchema, GlossaryTermSchema, GoldTierSchema, GradeBandSchema, GraphicOrganizerItemSchema, GraphicOrganizerSchema, HandoutSchema, HandoutSectionSchema, HybridBlueprintArraySchema, HybridBlueprintItemSchema, HybridDeckSlideArraySchema, HybridDeckSlideSchema, HybridPipelineError, InstructionSectionSchema, InstructionStepSchema, JUDGE_AUTO_APPROVE_THRESHOLD, JUDGE_ESCALATE_THRESHOLD, JudgeCriterionSchema, LAYER_IDLE_BUDGET_MS, LAYER_TOTAL_BUDGET_MS, LLMJudgeEngine, LabTierTaskSchema, LearningObjectiveInputSchema, LearningObjectiveRowSchema, LessonEntitySchema, LessonFlowPhaseSchema, LessonPlan5ESchema, LessonPlanEDPSchema, LessonPlanSchema, LessonSectionSchema, LocalWorkspaceManager, MAX_AUTONOMOUS_REPAIR_TURNS, MAX_IN_SESSION_SETUP_MINUTES, MAX_NEW_CONCEPTS_PER_SESSION_ADULT, MAX_NEW_CONCEPTS_PER_SESSION_K12, MacroPedagogyPlanAuditSchema, MappingKindSchema, MarpSlideSchema, MasteryGateSchema, MediaError, MediaLedger, MentorCheatsheetSchema, MilestoneInputSchema, MisconceptionEvaluator, MisconceptionSchema, ModelPolicyResolver, NVIDIA_MODELS, NodeKindSchema, OrganizerTypeEnum, PhaseInputSchema, PlanConstraintsSchema, PlannerInputSchema, PlanningGraphSchema, PlanningNodeSchema, PrerequisiteDecisionEntrySchema, PrerequisiteDecisionSchema, ProductGoalSchema, ProgressiveHintsSchema, ProjectGraphAuditSchema, ProjectGraphSchema, ProjectInstructionSchema, ProjectProfileSchema, QualityAuditVerdictSchema, QuizOptionSchema, RecordProvenanceSchema, ResourceMapRowSchema, ReviewGameExportRowSchema, ReviewGameQuestionSchema, ReviewGameSchema, RoadmapInputSchema, RotationStationSchema, RubricCriteriaSchema, RubricSchema, SATELLITE_LESSON_PRIORITIES, SLIDE_CANONICAL_METHODOLOGY, STANDARD_REF_REGEX, STANDARD_SOT_FILES, STUDENT_FRICTION_MULTIPLIER, ScaffoldDecisionEntrySchema, ScaffoldDecisionSchema, ScienceLabSchema, ScoringRubricRowSchema, SelfLabSchema, SelfPacedBundleSchema, SelfPacedChallengeSchema, SessionPlanSchema, SessionZpdStatusSchema, SilverTierSchema, SlideBlueprintArraySchema, SlideBlueprintItemSchema, SlideDeckSchema, StandardizedTermRowSchema, StandardsRegistryAdapter, StationRecordRowSchema, StationRotationSchema, StationTypeEnum, SupabaseCurriculumAdapter, TaskCardSchema, TaskCardsSchema, TeacherGuideSchema, TeachingScriptPhaseSchema, TierLevelEnum, TierObjectiveSchema, TieredPracticeSchema, TranslationPolicySchema, TroubleshootingEntrySchema, TroubleshootingRowSchema, UnitPlanSchema, UserJourneySchema, WalkingSkeletonSchema, WorksheetItemSchema, WorksheetItemTypeEnum, WorksheetPartSchema, WorksheetSchema, ZpdVerdictSchema, activityTools, analystTools, analyzeProjectCreationIntent, assembleTranslatedTemplate, assertAcyclic, assessorTools, assignDepths, atomicWriteFileSync, auditCurriculumPlanFlow, auditCurriculumQualityFlow, auditProjectGraphFlow, auditQualityReport, buildActivityPrompt, buildArtifactPrompt, buildCodeLabPrompt, buildConceptPrerequisites, buildCurriculumContext, buildCurriculumPlan, buildCurriculumPlanJudgePrompt, buildDeliveryPackages, buildDiagnosticQuizPrompt, buildDomainLexiconGuardrail, buildExpositionContext, buildExpositionExcerpt, buildExtensionPrompt, buildHandoutPrompt, buildHeadingDirective, buildHtmlDeckSlidePrompt, buildImagePrompt, buildJudgePrompt, buildLanguageDirective, buildLessonEntityJson, buildLessonExcerpt, buildLessonMasterPrompt, buildMarpMarkdownSlidePrompt, buildMasteryGates, buildProjectGraphJudgePrompt, buildProjectInstructionPrompt, buildSatelliteContext, buildSectionAwareExcerpt, buildSelfLabPrompt, buildSessionSliceContext, buildSlidesPrompt, buildStandardStackMarkdown, buildStandardsContext, buildStandardsContextBlock, buildTeacherGuidePrompt, buildWalkingSkeleton, buildWorksheetPrompt, checkSessionZpd, closeTruncatedJson, computeConceptSpiralProgression, computeContentHash, computePackingSpec, conductPreliminaryResearch, contentTools, convertRoadmapToFoundationSot, createAiInferenceError, createContextMissingError, createCurriculumStorage, createIdleAbortController, createStreamAbortController, createStreamAbortSignal, createStreamChunkExtractor, curateMediaLedger, designerTools, detectProjectPedagogy, dropCyclicConceptEdges, emitUsage, ensureExpositionForLesson, ensureKnowledgeExposition, entityRowAssignedTo, evaluateActivityAlignment, evaluateStandardsCoverage, executeCurriculumCommand, executeSlideProductionWorkflow, exportAllProjectQuizzes, expositionCacheKey, extractActivityContractRows, extractAssessmentMap, extractConditionalSections, extractCurriculumHorizon, extractDeclaredLanguage, extractEchoSections, extractJsonArray, extractRequiredSections, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStandardRefs, extractStreamChunk, extractSymbolLedger, extractThoughtAndContent, extractTieredScaffoldingBlock, findStandardStatement, formatQuizzesToCsv, fulfillMediaLedger, gateModeFor, generateActivityFlow, generateCodeLabFlow, generateDiagnosticQuizFlow, generateEducationalImage, generateExtensionFlow, generateHandoutFlow, generateLessonMasterFlow, generateMilestoneCurriculumBundle, generatePhase1SotArtifacts, generatePhase2SotArtifacts, generateProjectInstruction, generateProjectInstructionFlow, generateRoadmapCurriculum, generateSelfLabFlow, generateSelfPacedBundle, generateSingleArtifact, generateSlidesFlow, generateTeacherGuideFlow, generateWorksheetFlow, getAIModel, getArtifactMetadata, getDesignatedFallbackChain, getDesignatedFallbackConfig, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSmartResumeContext, glossaryTermsForSession, illustratorTools, importRoadmapToProject, ingestProjectGraphIntoProject, initializeProjectInStorage, injectMediaIntoMarkdown, isActivityAlignmentLogOnly, isExpositionFresh, isModelAllowed, isProviderEnabled, isTranslationDue, lintAndSanitizeArtifact, lintCurriculumFramework, lintFrameworkPack, loadAuthoringTemplate, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, normalizeSlcContract, packagerTools, parseAllSessions, parseGateSettings, parseQuizMarkdown, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, publishToGitHub, publishToSupabase, rankGenCandidates, renderAssignedRowsTable, renderEntitySlotsForType, renderFrameworkFromPlan, renderHorizonPromptBlock, renderMediaPlaceholder, researcherTools, resolveApiKey, resolveArtifactTemplate, resolveGateSettings, resolveStandardsPacks, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, reviewerTools, runCurriculumAIInference, safeParseJson, searchEducationalImages, searchEducationalVideos, selectStatementsForLesson, serializeActivityToMarkdown, serializeCodeLabToMarkdown, serializeDiagnosticQuizToMarkdown, serializeHandoutToMarkdown, serializeLessonToMarkdown, serializeProjectInstructionToMarkdown, serializeSelfLabToMarkdown, slugifyProjectName, streamCurriculumAIInference, streamCurriculumAIInferenceWithTools, streamDiagnosticQuizFlow, streamLLMWithFallback, streamLayerPrefillWithFallback, streamLessonMasterFlow, streamSelfLabFlow, stripHeadingKey, stripLlmJsonWrappers, stripTemplateFrontmatter, targetLanguageDisplayName, techSmeTools, topoSort, translateTemplate, uploadAssetToBucket, validateArtifactDependencies, validateCurriculumPlan, validateFrameworkPack, validateHorizonCompliance, validateHybridDeckSlides, validateMarkdownTables, validateMermaidSyntax, withAutoRepair };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map