@thanh01.pmt/curriculum-kit 1.4.7 → 1.4.8

package/dist/index.cjs

@@ -9819,6 +9819,224 @@ function gateModeFor(resolved, type) {
   return resolved[type] ?? "OFF";
 }
 
+// src/services/languageDirective.ts
+function resolveTargetLanguageCode(language) {
+  const raw = String(language || "vi").trim().toLowerCase();
+  if (raw.startsWith("vi")) return "vi";
+  if (raw.startsWith("en")) return "en";
+  return raw || "vi";
+}
+function targetLanguageDisplayName(code) {
+  const map = {
+    vi: "Vietnamese (Ti\u1EBFng Vi\u1EC7t)",
+    en: "English (US)"
+  };
+  return map[code] || code;
+}
+function buildLanguageDirective(targetLanguage) {
+  const code = resolveTargetLanguageCode(targetLanguage);
+  const name = targetLanguageDisplayName(code);
+  const perLanguageExamples = {
+    vi: `- V\xED d\u1EE5 ti\xEAu \u0111\u1EC1 b\xE0i h\u1ECDc \u0111\xFAng chu\u1EA9n: "B\xE0i 1: Kh\xE1m ph\xE1 m\u1EA1ch \u0111i\u1EC7n c\u01A1 b\u1EA3n", "B\xE0i 2: \u0110i\u1EC1u khi\u1EC3n \u0111\xE8n LED nh\u1EA5p nh\xE1y" \u2014 KH\xD4NG d\xF9ng ti\xEAu \u0111\u1EC1 ti\u1EBFng Anh.`,
+    en: `- Example compliant lesson title: "Lesson 1: Exploring Basic Circuits" \u2014 natural, idiomatic English throughout.`
+  };
+  const exampleLine = perLanguageExamples[code] || "";
+  return `MANDATORY LANGUAGE DIRECTIVE (TARGET OUTPUT LANGUAGE: ${name}):
+- The TARGET OUTPUT LANGUAGE for this course is ${name}. You MUST author the ENTIRE document in ${name}.
+- All section titles, table headers, table cells, lesson names, learning objectives, pedagogical narratives, and cognitive analyses MUST be written in natural, fluent, academic ${name}.
+- Technical identifiers, code keywords (e.g. setup(), loop(), pinMode()), standard protocols (I2C, SPI, UART, GPIO), and component model numbers (ESP32, Arduino Uno) remain in standard technical notation, but all surrounding explanations MUST be in ${name}.
+- DO NOT mix in paragraphs, tables, or titles written in any other language. Strict adherence is required.${exampleLine ? `
+${exampleLine}` : ""}`;
+}
+function matchesArtifactType(candidate, target) {
+  const c = candidate.trim().toUpperCase();
+  const t = target.trim().toUpperCase();
+  if (c === t) return true;
+  if (c.startsWith("LESSON") && t.startsWith("LESSON")) return true;
+  if ((c === "CODE" || c === "CODE_LAB") && (t === "CODE" || t === "CODE_LAB")) return true;
+  if ((c === "EXPOSITION" || c === "KNOWLEDGE_EXPOSITION") && (t === "EXPOSITION" || t === "KNOWLEDGE_EXPOSITION")) return true;
+  if ((c === "WKS" || c === "WORKSHEET") && (t === "WKS" || t === "WORKSHEET")) return true;
+  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"
+  }
+};
+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 {};
+  };
+  if (!slcInput) return getFallback();
+  if (typeof slcInput === "object") {
+    if (slcInput[upperType] && Object.keys(slcInput[upperType]).length > 0) return slcInput[upperType];
+    for (const [key, mapping] of Object.entries(slcInput)) {
+      if (matchesArtifactType(key, upperType) && Object.keys(mapping).length > 0) {
+        return mapping;
+      }
+    }
+    return getFallback();
+  }
+  const slcMarkdown = slcInput;
+  const blocks = slcMarkdown.split(/\n(?=#{2,3}\s+[A-Z0-9_]+)/g);
+  for (const block of blocks) {
+    const headerMatch = block.match(/^#{2,3}\s+([A-Z0-9_]+)/);
+    if (!headerMatch) continue;
+    const blockType = headerMatch[1].trim().toUpperCase();
+    if (matchesArtifactType(blockType, upperType)) {
+      const mapping = {};
+      const lines = block.split("\n");
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("|") && !trimmed.includes("---")) {
+          const cells = trimmed.split("|").map((c) => c.trim()).filter((_, idx, arr) => idx > 0 && idx < arr.length - 1);
+          if (cells.length >= 2 && !cells[0].toLowerCase().includes("canonical") && !cells[1].toLowerCase().includes("localized")) {
+            mapping[cells[0]] = cells[1];
+          }
+        } else {
+          const bullet = line.match(/^[-*]\s+([^:]+):\s+(.+)$/);
+          if (bullet) {
+            mapping[bullet[1].trim()] = bullet[2].trim();
+          }
+        }
+      }
+      if (Object.keys(mapping).length > 0) return mapping;
+    }
+  }
+  return getFallback();
+}
+function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi") {
+  const headings = extractSectionHeadingsFromSLC(slcMarkdown, artifactType, targetLanguage);
+  if (Object.keys(headings).length === 0) {
+    return "";
+  }
+  const lines = Object.entries(headings).map(
+    ([canonical, localized]) => `  - "${canonical}" -> Use Display Heading: "${localized}"`
+  );
+  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):
+${lines.join("\n")}
+- For example: if canonical section is "Computational Thinking Focus", your heading must be "## [REQUIRED] ${headings["Computational Thinking Focus"] || "Computational Thinking Focus"}".`;
+}
+
 // src/services/contextBuilder.ts
 var DEFAULT_LESSON_PRIORITIES = [
   "A. Lesson Design Plan",
@@ -10108,7 +10326,8 @@ var DEPTH_RULES = {
   cio: "Write WHAT + WHY + HOW: include the mechanism, step by step, still technology-independent.",
   sio: "Write WHAT + WHY + HOW + SPECIFIC: include concrete implementations and how the real project keywords are used."
 };
-function buildSystemPrompt() {
+function buildSystemPrompt(targetLanguage = "vi") {
+  const langDirective = buildLanguageDirective(targetLanguage);
   return [
     "You write KNOWLEDGE_EXPOSITION: self-study reading material for a student in a teacherless program.",
     "Rules:",
@@ -10117,12 +10336,22 @@ function buildSystemPrompt() {
     "3. Respect each concept depth target (ULO/CIO/SIO) \u2014 do not overshoot.",
     "4. Student-facing only: no teacher instructions, no classroom management text.",
     "5. Output the full markdown document following the provided section skeleton exactly (headers and placeholders preserved).",
-    "6. English."
+    langDirective
   ].join("\n");
 }
-function buildUserPrompt(session, plan, glossary) {
+function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMarkdown) {
   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 skeleton = `## ${hScope} / ## ${hTerms} / ## ${hNarratives} / ## ${hExamples} / ## ${hMistakes} / ## ${hQuestions}`;
+  const headingDirective = buildHeadingDirective("KNOWLEDGE_EXPOSITION", slcMarkdown, targetLanguage);
   return [
     "Session: " + session.id + " \u2014 " + session.title,
     "Objective: " + session.prose_objective,
@@ -10137,9 +10366,10 @@ function buildUserPrompt(session, plan, glossary) {
     termLines || "(none provided \u2014 write definitions and mark them for glossary sync)",
     "",
     "Section skeleton to fill (replace ONLY the {{placeholders}}):",
-    "## Session Scope / ## Key Terms / ## Concept Narratives / ## Worked Micro-Examples / ## Common Mistakes / ## Self-Check Questions",
+    skeleton,
+    headingDirective ? "\n" + headingDirective : "",
     "Plan hash: " + plan.plan_hash
-  ].join("\n");
+  ].filter(Boolean).join("\n");
 }
 async function ensureKnowledgeExposition(options) {
   const { projectId, lessonCode, plan, glossary, llmFn, storage } = options;
@@ -10155,11 +10385,18 @@ async function ensureKnowledgeExposition(options) {
   if (plan.approval.plan_hash !== plan.plan_hash) {
     throw new ExpositionApprovalError("Approval hash " + plan.approval.plan_hash + " does not match current plan hash " + plan.plan_hash + " \u2014 re-approve after plan changes");
   }
-  const content = (await llmFn(buildSystemPrompt(), buildUserPrompt(session, plan, glossary))).trim();
+  const targetLanguage = options.targetLanguage || plan.translation?.target_language || "vi";
+  const content = (await llmFn(
+    buildSystemPrompt(targetLanguage),
+    buildUserPrompt(session, plan, glossary, targetLanguage, options.slcMarkdown)
+  )).trim();
   if (content.length < 200) {
     throw new Error("EXPOSITION too short for " + lessonCode + " (" + content.length + " chars) \u2014 refusing to save");
   }
-  if (!content.includes("## Key Terms") || !content.includes("## Concept Narratives") || !content.includes("## Self-Check")) {
+  const hasKeyTerms = content.includes("Key Terms") || content.includes("Thu\u1EADt ng\u1EEF");
+  const hasNarratives = content.includes("Concept Narratives") || content.includes("Kh\xE1i ni\u1EC7m") || content.includes("Di\u1EC5n gi\u1EA3i");
+  const hasSelfCheck = content.includes("Self-Check") || content.includes("T\u1EF1 ki\u1EC3m tra") || content.includes("C\xE2u h\u1ECFi");
+  if (!hasKeyTerms || !hasNarratives || !hasSelfCheck) {
     throw new Error("EXPOSITION missing required sections for " + lessonCode + " \u2014 refusing to save");
   }
   const gateMode = gateModeFor(options.gates ?? {}, "KNOWLEDGE_EXPOSITION");
@@ -10221,16 +10458,20 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
   const scopedTerms = new Set(plan.glossary_scope.find((g) => g.session_id === lessonCode)?.terms ?? []);
   glossary = glossary.filter((g) => scopedTerms.has(g.term));
   const { runCurriculumAIInference: runCurriculumAIInference2 } = await Promise.resolve().then(() => (init_streamRunner(), streamRunner_exports));
+  const targetLang = options.targetLanguage || plan.translation?.target_language || "vi";
   const result = await ensureKnowledgeExposition({
     projectId,
     lessonCode,
     plan,
     glossary,
+    targetLanguage: targetLang,
+    slcMarkdown: options.slcMarkdown,
     llmFn: async (systemPrompt, userPrompt) => {
+      const runnerOpts = options.customInference ? { customInference: options.customInference } : {};
       const out = await runCurriculumAIInference2(
         [{ role: "user", content: userPrompt + "\n\n[SYSTEM RULES]:\n" + systemPrompt }],
-        "You are generating KNOWLEDGE_EXPOSITION - canonical self-study knowledge for one session. Output the complete markdown document only.",
-        {}
+        `You are generating KNOWLEDGE_EXPOSITION - canonical self-study knowledge for one session in ${targetLang === "vi" ? "VIETNAMESE" : targetLang}. Output the complete markdown document only.`,
+        runnerOpts
       );
       return out;
     },
@@ -23978,90 +24219,6 @@ function extractStandardRefs(text) {
   return Array.from(new Set(matches));
 }
 
-// src/services/languageDirective.ts
-function resolveTargetLanguageCode(language) {
-  const raw = String(language || "vi").trim().toLowerCase();
-  if (raw.startsWith("vi")) return "vi";
-  if (raw.startsWith("en")) return "en";
-  return raw || "vi";
-}
-function targetLanguageDisplayName(code) {
-  const map = {
-    vi: "Vietnamese (Ti\u1EBFng Vi\u1EC7t)",
-    en: "English (US)"
-  };
-  return map[code] || code;
-}
-function buildLanguageDirective(targetLanguage) {
-  const code = resolveTargetLanguageCode(targetLanguage);
-  const name = targetLanguageDisplayName(code);
-  const perLanguageExamples = {
-    vi: `- V\xED d\u1EE5 ti\xEAu \u0111\u1EC1 b\xE0i h\u1ECDc \u0111\xFAng chu\u1EA9n: "B\xE0i 1: Kh\xE1m ph\xE1 m\u1EA1ch \u0111i\u1EC7n c\u01A1 b\u1EA3n", "B\xE0i 2: \u0110i\u1EC1u khi\u1EC3n \u0111\xE8n LED nh\u1EA5p nh\xE1y" \u2014 KH\xD4NG d\xF9ng ti\xEAu \u0111\u1EC1 ti\u1EBFng Anh.`,
-    en: `- Example compliant lesson title: "Lesson 1: Exploring Basic Circuits" \u2014 natural, idiomatic English throughout.`
-  };
-  const exampleLine = perLanguageExamples[code] || "";
-  return `MANDATORY LANGUAGE DIRECTIVE (TARGET OUTPUT LANGUAGE: ${name}):
-- The TARGET OUTPUT LANGUAGE for this course is ${name}. You MUST author the ENTIRE document in ${name}.
-- All section titles, table headers, table cells, lesson names, learning objectives, pedagogical narratives, and cognitive analyses MUST be written in natural, fluent, academic ${name}.
-- Technical identifiers, code keywords (e.g. setup(), loop(), pinMode()), standard protocols (I2C, SPI, UART, GPIO), and component model numbers (ESP32, Arduino Uno) remain in standard technical notation, but all surrounding explanations MUST be in ${name}.
-- DO NOT mix in paragraphs, tables, or titles written in any other language. Strict adherence is required.${exampleLine ? `
-${exampleLine}` : ""}`;
-}
-function extractSectionHeadingsFromSLC(slcInput, artifactType) {
-  if (!slcInput) return {};
-  const upperType = artifactType.trim().toUpperCase();
-  if (typeof slcInput === "object") {
-    if (slcInput[upperType]) return slcInput[upperType];
-    for (const [key, mapping] of Object.entries(slcInput)) {
-      if (key.toUpperCase() === upperType || upperType.startsWith("LESSON") && key.toUpperCase().startsWith("LESSON")) {
-        return mapping;
-      }
-    }
-    return {};
-  }
-  const slcMarkdown = slcInput;
-  const blocks = slcMarkdown.split(/\n(?=#{2,3}\s+[A-Z0-9_]+)/g);
-  for (const block of blocks) {
-    const headerMatch = block.match(/^#{2,3}\s+([A-Z0-9_]+)/);
-    if (!headerMatch) continue;
-    const blockType = headerMatch[1].trim().toUpperCase();
-    if (blockType === upperType || upperType.startsWith("LESSON") && blockType.startsWith("LESSON")) {
-      const mapping = {};
-      const lines = block.split("\n");
-      for (const line of lines) {
-        const trimmed = line.trim();
-        if (trimmed.startsWith("|") && !trimmed.includes("---")) {
-          const cells = trimmed.split("|").map((c) => c.trim()).filter((_, idx, arr) => idx > 0 && idx < arr.length - 1);
-          if (cells.length >= 2 && !cells[0].toLowerCase().includes("canonical") && !cells[1].toLowerCase().includes("localized")) {
-            mapping[cells[0]] = cells[1];
-          }
-        } else {
-          const bullet = line.match(/^[-*]\s+([^:]+):\s+(.+)$/);
-          if (bullet) {
-            mapping[bullet[1].trim()] = bullet[2].trim();
-          }
-        }
-      }
-      if (Object.keys(mapping).length > 0) return mapping;
-    }
-  }
-  return {};
-}
-function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi") {
-  const headings = extractSectionHeadingsFromSLC(slcMarkdown, artifactType);
-  if (Object.keys(headings).length === 0) {
-    return "";
-  }
-  const lines = Object.entries(headings).map(
-    ([canonical, localized]) => `  - "${canonical}" -> Use Display Heading: "${localized}"`
-  );
-  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):
-${lines.join("\n")}
-- For example: if canonical section is "Computational Thinking Focus", your heading must be "## [REQUIRED] ${headings["Computational Thinking Focus"] || "Computational Thinking Focus"}".`;
-}
-
 // src/services/lessonProductionService.ts
 var __filename2 = typeof (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) === "string" && typeof url.fileURLToPath === "function" ? url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))) : "";
 var _resolvedDir = __filename2 ? path3__default.default.dirname(__filename2) : typeof __dirname !== "undefined" ? __dirname : process.cwd();
@@ -24475,7 +24632,10 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   try {
     const exposition = await ensureExpositionForLesson(storage, projectId, lessonCode, {
       gates: resolveGateSettings(options.gateSettings),
-      force: options.force
+      force: options.force,
+      targetLanguage: targetLang,
+      slcMarkdown,
+      customInference: options.customInference
     });
     if (exposition) {
       const expoExcerpt = buildExpositionExcerpt(exposition.rawContent || exposition.context, {
@@ -25525,6 +25685,22 @@ ${buildHeadingDirective("CODE", slcMarkdown, targetLang)}`;
   if (artifactScope.includes("EXT") && (!await storage.readArtifact(projectId, extRelPath) || force)) {
     onProgress?.("@activity", `Authoring Advanced Extension Challenge: \`EXT_${lessonCode}.md\`...`, { artifactType: "EXT" });
     const extDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const isVi = targetLang === "vi";
+    const extHeadings = isVi ? {
+      main: "# NHI\u1EC6M V\u1EE4 N\xC2NG CAO: [TI\xCAU \u0110\u1EC0 B\xC0I H\u1ECCC]",
+      sub: "## D\xE0nh cho: H\u1ECDc sinh N\xE2ng cao / Ho\xE0n th\xE0nh S\u1EDBm",
+      c1: "### Th\u1EED th\xE1ch 1: [T\xEAn th\u1EED th\xE1ch] (\u0110\u1ED9 kh\xF3: \u2B50\u2B50\u2B50) \u2014 B\u1ED1i c\u1EA3nh Nhi\u1EC7m v\u1EE5 Th\u1EF1c t\u1EBF & K\u1ECBch b\u1EA3n \u1EE8ng d\u1EE5ng",
+      c2: "### Th\u1EED th\xE1ch 2: [T\xEAn th\u1EED th\xE1ch] (\u0110\u1ED9 kh\xF3: \u2B50\u2B50\u2B50\u2B50) \u2014 R\xE0ng bu\u1ED9c Ki\u1EBFn tr\xFAc N\xE2ng cao & Tr\u01B0\u1EDDng h\u1EE3p Bi\xEAn",
+      c3: "### Th\u1EED th\xE1ch 3: [T\xEAn th\u1EED th\xE1ch] (\u0110\u1ED9 kh\xF3: \u2B50\u2B50\u2B50\u2B50\u2B50) \u2014 C\xE1c M\u1ED1c Nhi\u1EC7m v\u1EE5 N\xE2ng cao (C\u1EA5p 1: Kh\u1EDFi \u0111\u1ED9ng \u2192 C\u1EA5p 2: N\xE2ng cao \u2192 C\u1EA5p 3: Chuy\xEAn gia)",
+      meta: "## [REQUIRED] Suy ng\u1EABm Si\xEAu nh\u1EADn th\u1EE9c & \u0110\xE1nh \u0111\u1ED5i K\u1EF9 thu\u1EADt"
+    } : {
+      main: "# EXTENSION TASKS: [LESSON TITLE]",
+      sub: "## For: Advanced Students / Extra Time",
+      c1: "### Challenge 1: [Name] (Difficulty: \u2B50\u2B50\u2B50) \u2014 Mission Briefing & Real-World High-Stakes Scenario",
+      c2: "### Challenge 2: [Name] (Difficulty: \u2B50\u2B50\u2B50\u2B50) \u2014 Advanced Architectural Constraints & Edge Cases",
+      c3: "### Challenge 3: [Name] (Difficulty: \u2B50\u2B50\u2B50\u2B50\u2B50) \u2014 Extension Milestones (Level 1: Ninja \u2192 Level 2: Guru \u2192 Level 3: Master)",
+      meta: "## [REQUIRED] Metacognitive Deep Dive & Engineering Trade-offs"
+    };
     const extPrompt = `You are @activity (Lead STEM Specialist & Differentiated Extension Designer).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, author the advanced extension challenge: \`EXT_${lessonCode}.md\`.
 
@@ -25540,16 +25716,21 @@ deliverable: "P3-T8"
 version: "v1.0"
 date: "${extDateStr}"
 template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Challenge 1: Mission Briefing & Real-World High-Stakes Scenario"
+  - "Challenge 2: Advanced Architectural Constraints & Edge Cases"
+  - "Challenge 3: Extension Milestones"
+  - "Metacognitive Deep Dive & Engineering Trade-offs"
 ---
 
-# EXTENSION TASKS: [LESSON TITLE]
-## For: Advanced Students / Extra Time
+${extHeadings.main}
+${extHeadings.sub}
 
 2. Mandatory sections (matching EXT_template.md):
-   - ### Challenge 1: [Name] (Difficulty: \u2B50\u2B50\u2B50) \u2014 Mission Briefing & Real-World High-Stakes Scenario
-   - ### Challenge 2: [Name] (Difficulty: \u2B50\u2B50\u2B50\u2B50) \u2014 Advanced Architectural Constraints & Edge Cases
-   - ### Challenge 3: [Name] (Difficulty: \u2B50\u2B50\u2B50\u2B50\u2B50) \u2014 Extension Milestones (Level 1: Ninja \u2192 Level 2: Guru \u2192 Level 3: Master)
-   - ## [REQUIRED] Metacognitive Deep Dive & Engineering Trade-offs
+   - ${extHeadings.c1}
+   - ${extHeadings.c2}
+   - ${extHeadings.c3}
+   - ${extHeadings.meta}
 3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
 
 ${languageDirective}
@@ -30205,6 +30386,7 @@ exports.DEFAULT_KX_PRIORITIES = DEFAULT_KX_PRIORITIES;
 exports.DEFAULT_LESSON_PRIORITIES = DEFAULT_LESSON_PRIORITIES;
 exports.DEFAULT_STREAM_IDLE_MS = DEFAULT_STREAM_IDLE_MS;
 exports.DEFAULT_STREAM_TOTAL_MS = DEFAULT_STREAM_TOTAL_MS;
+exports.DEFAULT_VIETNAMESE_SECTION_HEADINGS = DEFAULT_VIETNAMESE_SECTION_HEADINGS;
 exports.DependencyEdgeSchema = DependencyEdgeSchema;
 exports.DepthAssignmentSchema = DepthAssignmentSchema;
 exports.DepthLevelSchema = DepthLevelSchema;