@thanh01.pmt/curriculum-kit 1.0.21 → 1.1.0

package/dist/index.cjs

@@ -2432,9 +2432,20 @@ var SessionPlanSchema = zod.z.object({
   differentiation: zod.z.object({ bronze: zod.z.string(), silver: zod.z.string(), gold: zod.z.string() })
 });
 var TranslationPolicySchema = zod.z.object({
-  policy: zod.z.enum(["after_artifact", "end_of_unit", "at_publish"]).default("at_publish"),
+  policy: zod.z.enum(["after_artifact", "end_of_unit", "at_publish", "native"]).default("native"),
   target_language: zod.z.string().nullable().default(null)
-});
+}).refine(
+  (data) => {
+    if (data.policy === "native") {
+      return typeof data.target_language === "string" && data.target_language.trim().length > 0;
+    }
+    return true;
+  },
+  {
+    message: "When translation policy is 'native', target_language must be a non-empty string",
+    path: ["target_language"]
+  }
+);
 var CoverageReportSchema = zod.z.object({
   assigned_node_ids: zod.z.array(zod.z.string()),
   unassigned_node_ids: zod.z.array(zod.z.string()),
@@ -8637,12 +8648,15 @@ var SupabaseCurriculumAdapter = class {
       } catch {
       }
     }
+    if (relPathOrIdentifier.includes(".md") || relPathOrIdentifier.includes(".json") || relPathOrIdentifier.includes("/")) {
+      return null;
+    }
     const lessonMatch = relPathOrIdentifier.match(/U\d+_M\d+_L\d+/i);
     if (lessonMatch) {
       const lessonId = lessonMatch[0].toUpperCase();
       const unitCode = lessonId.split("_")[0] || "U01";
       const lower = relPathOrIdentifier.toLowerCase();
-      let artifactPrefix = "LESSON";
+      let artifactPrefix = null;
       if (lower.includes("act") || lower.includes("lab") || lower.includes("th\u1EF1c h\xE0nh")) {
         artifactPrefix = "ACT";
       } else if (lower.includes("quiz") || lower.includes("tr\u1EAFc nghi\u1EC7m") || lower.includes("\u0111\xE1nh gi\xE1")) {
@@ -8651,8 +8665,31 @@ var SupabaseCurriculumAdapter = class {
         artifactPrefix = "SLIDE";
       } else if (lower.includes("guide") || lower.includes("h\u01B0\u1EDBng d\u1EABn")) {
         artifactPrefix = "GUIDE";
+      } else if (lower.includes("wks") || lower.includes("worksheet") || lower.includes("phi\u1EBFu b\xE0i t\u1EADp")) {
+        artifactPrefix = "WKS";
+      } else if (lower.includes("handout") || lower.includes("t\xE0i li\u1EC7u")) {
+        artifactPrefix = "HANDOUT";
+      } else if (lower.includes("code")) {
+        artifactPrefix = "CODE";
+      } else if (lower.includes("ext") || lower.includes("extension") || lower.includes("m\u1EDF r\u1ED9ng")) {
+        artifactPrefix = "EXT";
+      } else if (lower.includes("exp") || lower.includes("exposition") || lower.includes("t\u1EF1 h\u1ECDc") || lower.includes("ki\u1EBFn th\u1EE9c n\u1EC1n")) {
+        artifactPrefix = "EXPOSITION";
+      } else if (lower.includes("rubric")) {
+        artifactPrefix = "RUBRIC";
+      } else if (lower.includes("bom")) {
+        artifactPrefix = "BOM";
+      } else if (lower.includes("lesson") || lower.includes("gi\xE1o \xE1n") || lower.includes("5e")) {
+        artifactPrefix = "LESSON";
+      }
+      if (!artifactPrefix) {
+        return null;
       }
-      const candidatePaths = [
+      const candidatePaths = artifactPrefix === "EXPOSITION" ? [
+        `${projectId}/_sot/expositions/${lessonId}.md`,
+        `${projectId}/_content/${unitCode}/EXPOSITION_${lessonId}.md`,
+        `${projectId}/lessons/${lessonId}/EXPOSITION_${lessonId}.md`
+      ] : [
         `${projectId}/_content/${unitCode}/${artifactPrefix}_${lessonId}.md`,
         `${projectId}/lessons/${lessonId}/${artifactPrefix}_${lessonId}.md`,
         `${projectId}/${artifactPrefix}_${lessonId}.md`
@@ -9829,6 +9866,7 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
   });
   return { relPath: result.relPath, context: buildExpositionContext(result.content), reused: result.reused };
 }
+init_errors();
 var asArr = (v) => Array.isArray(v) ? v : [];
 var asStr = (v, dflt = "") => typeof v === "string" ? v : dflt;
 var asNum = (v, dflt) => typeof v === "number" && Number.isFinite(v) ? v : dflt;
@@ -10471,7 +10509,15 @@ function extractSessionSlice(plan, lessonCode) {
 }
 function buildSessionSliceContext(plan, lessonCode) {
   const s = plan.sessions.find((x) => x.id === lessonCode);
-  if (!s) return "";
+  if (!s) {
+    throw new exports.CurriculumError({
+      errorCode: "ERR_LESSON_NOT_IN_SOT",
+      message: `Session "${lessonCode}" not found in CURRICULUM_PLAN.json (${plan.plan_hash})`,
+      suggestedAction: "\u0110\u1ED3ng b\u1ED9 CURRICULUM_PLAN r\u1ED3i ch\u1EA1y l\u1EA1i",
+      retryable: false,
+      lessonId: lessonCode
+    });
+  }
   const lines = [];
   lines.push("[SESSION SLICE (from CURRICULUM_PLAN " + plan.plan_hash + ")]");
   lines.push("- Objective: " + s.prose_objective);
@@ -11038,6 +11084,80 @@ function resolveStandardsPacks(packIds) {
   return packs;
 }
 
+// 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(slcMarkdown, artifactType) {
+  if (!slcMarkdown) return {};
+  const upperType = artifactType.trim().toUpperCase();
+  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" ? 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();
@@ -11079,11 +11199,44 @@ function detectProjectPedagogy(frameworkText, styleGuideText, explicitPedagogy)
   return "5e";
 }
 async function getLessonMetadata(storage, projectId, lessonId) {
-  const framework = await storage.readSotDocument(projectId, "CURRICULUM_FRAMEWORK.md") || "";
   const parts = lessonId.split("_");
   const unitCode = parts[0] || "U01";
   const moduleCode = parts.length >= 2 ? `${parts[0]}_${parts[1]}` : `${unitCode}_M01`;
   const lessonCode = lessonId;
+  let planStr = null;
+  try {
+    planStr = await storage.readSotDocument(projectId, "CURRICULUM_PLAN.json") || await storage.readArtifact(projectId, "_sot/CURRICULUM_PLAN.json") || await storage.readArtifact(projectId, "CURRICULUM_PLAN.json");
+  } catch {
+  }
+  if (planStr) {
+    try {
+      const plan = JSON.parse(planStr);
+      if (Array.isArray(plan.sessions)) {
+        const session = plan.sessions.find((s) => s.id === lessonId);
+        if (session) {
+          const lessonTitle2 = session.title || `Lesson ${lessonId}`;
+          const keywords = Array.isArray(session.new_keywords) && session.new_keywords.length > 0 ? ` T\u1EEB kh\xF3a: ${session.new_keywords.join(", ")}` : "";
+          const objective2 = session.prose_objective || session.title || "";
+          const concept2 = objective2 ? `${objective2}.${keywords}` : session.title || "Core Technical Competency";
+          const prerequisites2 = session.anchor_type ? `Anchor: ${session.anchor_type}` : "None";
+          const depth = Array.isArray(session.depth_assignments) ? session.depth_assignments[0]?.depth : session.depth_assignments?.knowledge_depth;
+          const bloomLevel2 = depth === "sio" ? "Create" : depth === "cio" ? "Apply" : "Understand";
+          return {
+            unitCode: session.unit_id || unitCode,
+            moduleCode,
+            lessonCode,
+            lessonTitle: lessonTitle2,
+            concept: `M\u1EE5c ti\xEAu bu\u1ED5i h\u1ECDc: ${concept2}`,
+            prerequisites: prerequisites2,
+            bloomLevel: bloomLevel2
+          };
+        }
+      }
+    } catch (planErr) {
+      console.warn(`[getLessonMetadata] Error parsing CURRICULUM_PLAN.json for ${projectId}:`, planErr);
+    }
+  }
+  const framework = await storage.readSotDocument(projectId, "CURRICULUM_FRAMEWORK.md") || "";
   let lessonTitle = `Lesson ${lessonId}`;
   let concept = "Core Technical Competency";
   let prerequisites = "None";
@@ -11128,15 +11281,24 @@ async function getLessonMetadata(storage, projectId, lessonId) {
     }
     if (found) break;
   }
-  return {
-    unitCode,
-    moduleCode,
-    lessonCode,
-    lessonTitle,
-    concept: objective ? `${concept}. M\u1EE5c ti\xEAu bu\u1ED5i h\u1ECDc: ${objective}` : concept,
-    prerequisites: deliverable ? `${prerequisites}. S\u1EA3n ph\u1EA9m hands-on c\u1EE7a bu\u1ED5i: ${deliverable}` : prerequisites,
-    bloomLevel
-  };
+  if (found) {
+    return {
+      unitCode,
+      moduleCode,
+      lessonCode,
+      lessonTitle,
+      concept: objective ? `${concept}. M\u1EE5c ti\xEAu bu\u1ED5i h\u1ECDc: ${objective}` : concept,
+      prerequisites: deliverable ? `${prerequisites}. S\u1EA3n ph\u1EA9m hands-on c\u1EE7a bu\u1ED5i: ${deliverable}` : prerequisites,
+      bloomLevel
+    };
+  }
+  throw new exports.CurriculumError({
+    errorCode: "ERR_LESSON_NOT_IN_SOT",
+    lessonId,
+    message: `ERR_LESSON_NOT_IN_SOT: B\xE0i h\u1ECDc "${lessonId}" kh\xF4ng t\u1ED3n t\u1EA1i trong CURRICULUM_PLAN.json ho\u1EB7c CURRICULUM_FRAMEWORK.md c\u1EE7a d\u1EF1 \xE1n "${projectId}".`,
+    suggestedAction: "\u0110\u1ED3ng b\u1ED9 CURRICULUM_PLAN r\u1ED3i ch\u1EA1y l\u1EA1i",
+    retryable: false
+  });
 }
 function buildFrameworkExcerptForLesson(framework, lessonId) {
   if (!framework) return "";
@@ -11178,7 +11340,7 @@ ${nextRow}`
   ].filter(Boolean);
   return parts.join("\n\n") || framework.slice(0, 1500);
 }
-function buildLessonPrompt(pedagogy, lessonCode, unitCode, lessonTitle, concept, bloomLevel, dateStr) {
+function buildLessonPrompt(pedagogy, lessonCode, unitCode, lessonTitle, concept, bloomLevel, dateStr, targetLanguage = "vi", sectionLanguageContract) {
   const commonFrontmatter = `id: "LESSON_${lessonCode}"
 title: "${lessonTitle}"
 created_by: "Curriculum OS Builder"
@@ -11198,8 +11360,9 @@ template_required_sections:
   - "Artifact Contract"
   - "B. Lesson Flow"
   - "Artifact Linkage"`;
+  let prompt = "";
   if (pedagogy === "edp") {
-    return `You are @content (Educational Content Editor & EDP Engineering Design Process Specialist).
+    prompt = `You are @content (Educational Content Editor & EDP Engineering Design Process Specialist).
 Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_EDP_template.md\` standards for:
 - Lesson Code: ${lessonCode}
 - Title: ${lessonTitle}
@@ -11248,9 +11411,8 @@ Linkage ledger mapping all satellite artifacts (\`ACT_...\`, \`QUIZ_...\`, \`SLI
 
 3. Ensure all sample code and schemas are 100% syntax-valid and executable.
 4. Output 100% clean Markdown directly.`;
-  }
-  if (pedagogy === "pbl" || pedagogy === "general") {
-    return `You are @content (Educational Content Editor & PBL/General Pedagogy Specialist).
+  } else if (pedagogy === "pbl" || pedagogy === "general") {
+    prompt = `You are @content (Educational Content Editor & PBL/General Pedagogy Specialist).
 Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_GENERAL_template.md\` standards for:
 - Lesson Code: ${lessonCode}
 - Title: ${lessonTitle}
@@ -11297,8 +11459,8 @@ type: "LESSON_GENERAL"
 Linkage ledger mapping all satellite artifacts (\`ACT_...\`, \`QUIZ_...\`, \`SLIDE_...\`).
 
 3. Output 100% clean Markdown directly.`;
-  }
-  return `You are @content (Educational Content Editor & 5E Instructional Model Specialist).
+  } else {
+    prompt = `You are @content (Educational Content Editor & 5E Instructional Model Specialist).
 Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_5E_template.md\` standards for:
 - Lesson Code: ${lessonCode}
 - Title: ${lessonTitle}
@@ -11346,6 +11508,18 @@ Linkage ledger mapping all satellite artifacts (\`GUIDE_...\`, \`SLIDE_...\`, \`
 
 3. Ensure all sample code and syntax are 100% verified and runnable.
 4. Output 100% clean Markdown directly.`;
+  }
+  const langDirective = buildLanguageDirective(targetLanguage);
+  const headingDirective = buildHeadingDirective(
+    pedagogy === "edp" ? "LESSON_EDP" : pedagogy === "general" || pedagogy === "pbl" ? "LESSON_GENERAL" : "LESSON_5E",
+    sectionLanguageContract,
+    targetLanguage
+  );
+  return `${prompt}
+
+${langDirective}${headingDirective ? `
+
+${headingDirective}` : ""}`;
 }
 async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   const {
@@ -11376,6 +11550,20 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   const styleGuide = await storage.readSotDocument(projectId, "CONTENT_STYLE_GUIDE.md") || "";
   const refPack = await storage.readSotDocument(projectId, "REFERENCE_PACK.md") || "";
   await storage.readSotDocument(projectId, "LEARNER_PROFILE.md") || "";
+  const slcMarkdown = options.sectionLanguageContract || await storage.readSotDocument(projectId, "SECTION_LANGUAGE_CONTRACT.md") || "";
+  let targetLang = options.targetLanguage;
+  if (!targetLang) {
+    try {
+      const planRaw = await storage.readArtifact(projectId, "_sot/CURRICULUM_PLAN.json");
+      if (planRaw) {
+        const p = JSON.parse(planRaw);
+        targetLang = p?.translation?.target_language;
+      }
+    } catch {
+    }
+  }
+  targetLang = targetLang || "vi";
+  const languageDirective = buildLanguageDirective(targetLang);
   let expositionContext = "";
   let sessionSliceContext = "";
   try {
@@ -11445,7 +11633,9 @@ Khi n\u1ED9i dung c\u1EA7n minh h\u1ECDa (diagram quy tr\xECnh, s\u01A1 \u0111\u
       lessonTitle,
       concept,
       bloomLevel,
-      dateStr
+      dateStr,
+      targetLang,
+      slcMarkdown
     ) + mediaDirective;
     const rawLesson = await runCurriculumAIInference(
       [{ role: "user", content: lessonPrompt }],
@@ -11786,7 +11976,11 @@ template_required_sections:
      - ### Phase 3: Debugging & Testing
    - ## [REQUIRED] 3-Tier Differentiation (Bronze/Silver/Gold tasks)
    - ## [REQUIRED] Reflection (Discussion question)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("ACT", slcMarkdown, targetLang)}`;
     const rawAct = await runCurriculumAIInference(
       [{ role: "user", content: actPrompt }],
       satelliteContext,
@@ -11858,7 +12052,11 @@ template_required_sections:
    - ## [REQUIRED] Multiple-Choice Question Bank (\u22655 scenario-based 4-option questions with: Question text, A/B/C/D options, Correct answer, Bloom level, Detailed distractor rationale)
    - ## [REQUIRED] Code Analysis / Debugging Question (1 deep code tracing question requiring students to predict output or identify bugs)
    - ## [REQUIRED] Competency Rubric (4-tier matrix: Developing \u2192 Proficient \u2192 Advanced \u2192 Exemplary)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
     const rawQuiz = await runCurriculumAIInference(
       [{ role: "user", content: quizPrompt }],
       satelliteContext,
@@ -11937,7 +12135,11 @@ Mandatory Canvas & Presentation Invariants:
   * COLD CALL / CHECK: Specific diagnostic question to ask students.
   * SCAFFOLDING / GOTCHA: Guidance for students who get stuck.
   * PACING: Recommended minutes for the slide.
-- Output 100% valid Marp Markdown.`;
+- Output 100% valid Marp Markdown.
+
+${languageDirective}
+
+${buildHeadingDirective("SLIDE", slcMarkdown, targetLang)}`;
     const rawSlide = await runCurriculumAIInference(
       [{ role: "user", content: slidePrompt }],
       satelliteContext,
@@ -12004,7 +12206,11 @@ template_contract: "artifact-template-v1"
    - ## [REQUIRED] Facilitation Script & Timeline (Phase-by-phase teacher moves, inquiry questions, transitions)
    - ## [REQUIRED] Common Misconceptions & Diagnostic Remediation Matrix
    - ## [REQUIRED] Differentiated Support Strategies (Support scaffolds vs Extension challenges)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("GUIDE", slcMarkdown, targetLang)}`;
     const rawGuide = await runCurriculumAIInference(
       [{ role: "user", content: guidePrompt }],
       satelliteContext,
@@ -12063,7 +12269,11 @@ template_contract: "artifact-template-v1"
    - ## [REQUIRED] Visual Mental Model / Architecture Diagram (Mermaid or ASCII diagram)
    - ## [REQUIRED] Step-by-Step Practical Quick-Start Guide
    - ## [REQUIRED] Self-Check Diagnostic Checklist (Can-do statements for student self-assessment)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("HANDOUT", slcMarkdown, targetLang)}`;
     const rawHandout = await runCurriculumAIInference(
       [{ role: "user", content: handoutPrompt }],
       satelliteContext,
@@ -12126,7 +12336,11 @@ template_contract: "artifact-template-v1"
    - ## [REQUIRED] Part 3: Code Analysis & Bug Hunting Challenge
    - ## [REQUIRED] Part 4: Synthesis & Problem-Solving Application
    - ## [REQUIRED] Part 5: Self-Reflection & Learning Log
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("WKS", slcMarkdown, targetLang)}`;
     const rawWks = await runCurriculumAIInference(
       [{ role: "user", content: wksPrompt }],
       satelliteContext,
@@ -12193,7 +12407,11 @@ template_required_sections:
    - ## [REQUIRED] Verified Reference Solution Code (100% syntactically valid, production-ready, fully commented)
    - ## [REQUIRED] Automated Test / Verification Script (How to compile, flash, or unit test)
    - ## [REQUIRED] Common Syntax & Runtime Pitfalls Matrix
-3. Output 100% clean Markdown directly with runnable code snippets \u2014 NO outer code fences around the document.`;
+3. Output 100% clean Markdown directly with runnable code snippets \u2014 NO outer code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("CODE", slcMarkdown, targetLang)}`;
     const rawCode = await runCurriculumAIInference(
       [{ role: "user", content: codePrompt }],
       satelliteContext,
@@ -12259,7 +12477,11 @@ template_contract: "artifact-template-v1"
    - ### 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
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("EXT", slcMarkdown, targetLang)}`;
     const rawExt = await runCurriculumAIInference(
       [{ role: "user", content: extPrompt }],
       satelliteContext,
@@ -16903,8 +17125,10 @@ exports.buildDiagnosticQuizPrompt = buildDiagnosticQuizPrompt;
 exports.buildExpositionContext = buildExpositionContext;
 exports.buildExtensionPrompt = buildExtensionPrompt;
 exports.buildHandoutPrompt = buildHandoutPrompt;
+exports.buildHeadingDirective = buildHeadingDirective;
 exports.buildImagePrompt = buildImagePrompt;
 exports.buildJudgePrompt = buildJudgePrompt;
+exports.buildLanguageDirective = buildLanguageDirective;
 exports.buildLessonMasterPrompt = buildLessonMasterPrompt;
 exports.buildProjectInstructionPrompt = buildProjectInstructionPrompt;
 exports.buildSelfLabPrompt = buildSelfLabPrompt;
@@ -16937,6 +17161,7 @@ exports.executeCurriculumCommand = executeCurriculumCommand;
 exports.exportAllProjectQuizzes = exportAllProjectQuizzes;
 exports.expositionCacheKey = expositionCacheKey;
 exports.extractScopeSequenceRows = extractScopeSequenceRows;
+exports.extractSectionHeadingsFromSLC = extractSectionHeadingsFromSLC;
 exports.extractSessionSlice = extractSessionSlice;
 exports.extractStreamChunk = extractStreamChunk;
 exports.extractThoughtAndContent = extractThoughtAndContent;
@@ -17003,6 +17228,7 @@ exports.researcherTools = researcherTools;
 exports.resolveGateSettings = resolveGateSettings;
 exports.resolveStandardsPacks = resolveStandardsPacks;
 exports.resolveStreamBudget = resolveStreamBudget;
+exports.resolveTargetLanguageCode = resolveTargetLanguageCode;
 exports.resolveTranslationTargets = resolveTranslationTargets;
 exports.reviewerTools = reviewerTools;
 exports.runCurriculumAIInference = runCurriculumAIInference;
@@ -17026,6 +17252,7 @@ exports.streamLayerPrefillWithFallback = streamLayerPrefillWithFallback;
 exports.streamLessonMasterFlow = streamLessonMasterFlow;
 exports.streamSelfLabFlow = streamSelfLabFlow;
 exports.stripLlmJsonWrappers = stripLlmJsonWrappers;
+exports.targetLanguageDisplayName = targetLanguageDisplayName;
 exports.techSmeTools = techSmeTools;
 exports.topoSort = topoSort;
 exports.uploadAssetToBucket = uploadAssetToBucket;