@thanh01.pmt/curriculum-kit 1.4.44 → 1.4.46

package/dist/workflow/index.cjs

@@ -5,9 +5,9 @@ var path = require('path');
 var google = require('@ai-sdk/google');
 var openai = require('@ai-sdk/openai');
 var deepseek = require('@ai-sdk/deepseek');
+var url = require('url');
 var ai = require('ai');
 var zod = require('zod');
-var url = require('url');
 var workflow = require('workflow');
 var fs3 = require('fs/promises');
 var rest = require('@octokit/rest');
@@ -1136,10 +1136,138 @@ 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 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 (process.env.CURRICULUM_TEMPLATES_DIR) dirs.push(process.env.CURRICULUM_TEMPLATES_DIR);
+  dirs.push(path__default.default.resolve(process.cwd(), "_templates"));
+  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
+    dirs.push(path__default.default.resolve(_moduleDir, rel));
+    dirs.push(path__default.default.resolve(process.cwd(), rel));
+    dirs.push(path__default.default.resolve(process.cwd(), "packages/curriculum-kit", rel));
+  }
+  return dirs;
+}
+function findTemplatePath(templateName, explicitDir) {
+  for (const dir of candidateDirs()) {
+    const p = path__default.default.join(dir, templateName);
+    if (!fs2__default.default.existsSync(p)) continue;
+    try {
+      fs2__default.default.accessSync(p, fs2__default.default.constants.R_OK);
+      return p;
+    } catch {
+    }
+  }
+  return null;
+}
+function resolveArtifactTemplate(templateName, opts) {
+  const p = findTemplatePath(templateName);
+  if (!p) return null;
+  try {
+    const raw = fs2__default.default.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 loadCurriculumTemplate(templateName, templatesDir) {
+  const p = findTemplatePath(templateName);
+  if (!p) return "";
+  try {
+    return fs2__default.default.readFileSync(p, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function loadAuthoringTemplate(templateName, templatesDir) {
+  const p = findTemplatePath(templateName);
+  if (!p) return "";
+  try {
+    return stripTemplateFrontmatter(fs2__default.default.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 ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) }) !== "undefined" && typeof (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) === "string") {
+          return path__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
+        }
+      } catch {
+      }
+      return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+    })();
+  }
+});
 
 // src/parsers/lessonFlowParser.ts
 var init_lessonFlowParser = __esm({
   "src/parsers/lessonFlowParser.ts"() {
+    init_templateLoader();
   }
 });
 
@@ -2753,72 +2881,9 @@ zod.z.object({
   }),
   phases: zod.z.array(PhaseInputSchema).default([])
 });
-function stripTemplateFrontmatter(raw) {
-  let body = raw;
-  if (body.startsWith("---")) {
-    const end = body.indexOf("\n---", 3);
-    if (end !== -1) body = body.slice(end + 4);
-  }
-  return body.split("\n").filter((l) => l.trim() !== "<!-- INJECT_BODY -->").join("\n").replace(/^\s*\n/, "").trimEnd();
-}
-var KIT_TEMPLATE_FALLBACK_DIRS = [
-  // Packaged with the npm bundle (dist/templates) — resolves from node_modules.
-  "templates",
-  // Repo checkout layouts.
-  "docs/refs/templates"
-];
-var _moduleDir = (() => {
-  try {
-    if (typeof ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) }) !== "undefined" && typeof (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) === "string") {
-      return path__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
-    }
-  } catch {
-  }
-  return typeof __dirname !== "undefined" ? __dirname : process.cwd();
-})();
-function candidateDirs(explicitDir) {
-  const dirs = [];
-  if (process.env.CURRICULUM_TEMPLATES_DIR) dirs.push(process.env.CURRICULUM_TEMPLATES_DIR);
-  dirs.push(path__default.default.resolve(process.cwd(), "_templates"));
-  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
-    dirs.push(path__default.default.resolve(_moduleDir, rel));
-    dirs.push(path__default.default.resolve(process.cwd(), rel));
-    dirs.push(path__default.default.resolve(process.cwd(), "packages/curriculum-kit", rel));
-  }
-  return dirs;
-}
-function findTemplatePath(templateName, explicitDir) {
-  for (const dir of candidateDirs()) {
-    const p = path__default.default.join(dir, templateName);
-    if (!fs2__default.default.existsSync(p)) continue;
-    try {
-      fs2__default.default.accessSync(p, fs2__default.default.constants.R_OK);
-      return p;
-    } catch {
-    }
-  }
-  return null;
-}
-function loadCurriculumTemplate(templateName, templatesDir) {
-  const p = findTemplatePath(templateName);
-  if (!p) return "";
-  try {
-    return fs2__default.default.readFileSync(p, "utf-8");
-  } catch {
-    return "";
-  }
-}
-function loadAuthoringTemplate(templateName, templatesDir) {
-  const p = findTemplatePath(templateName);
-  if (!p) return "";
-  try {
-    return stripTemplateFrontmatter(fs2__default.default.readFileSync(p, "utf-8"));
-  } catch {
-    return "";
-  }
-}
 
 // src/ai/prompts/lessonMasterPrompt.ts
+init_templateLoader();
 function buildLessonMasterPrompt(input) {
   const { milestone, language, topic, targetAudience, contextContinuity, standardsContext } = input;
   const learningObjectives = milestone.learning_objectives || [];
@@ -2920,6 +2985,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");
@@ -3019,6 +3085,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"];
@@ -3425,6 +3492,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"];
@@ -3533,6 +3601,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 || [];
@@ -4082,7 +4151,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}`;
@@ -4126,7 +4195,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}
@@ -4135,13 +4205,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}
@@ -4155,7 +4227,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."}
@@ -4166,7 +4239,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}  
@@ -4259,12 +4333,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}
 
@@ -4272,7 +4350,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}
 
@@ -4327,22 +4407,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.
 
@@ -4417,7 +4503,9 @@ ${proTipsStr}
 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:
@@ -18527,6 +18615,7 @@ var LLMJudgeEngine = class {
 init_errors();
 
 // src/services/languageDirective.ts
+init_templateLoader();
 function resolveTargetLanguageCode(language) {
   const raw = String(language || "vi").trim().toLowerCase();
   if (raw.startsWith("vi")) return "vi";
@@ -18556,193 +18645,46 @@ function buildLanguageDirective(targetLanguage) {
 ${exampleLine}` : ""}
 - CJK / NON-LATIN SCRIPT BAN (ABSOLUTE): NEVER output characters from Chinese (\u6C49\u5B57), Japanese (\u304B\u306A/\u6F22\u5B57), or Korean (\uD55C\uAE00) scripts ANYWHERE in the document \u2014 not even a single glyph spliced inside a ${name} sentence. Observed past violations that are STRICTLY forbidden: \u6392\u67E5, \u5305\u542B, \u5BFC\u81F4, \u662F\u591A\u5C11, \u6280\u672F, \u771F\u673A, \u4F11\u606F, \u7EB8\u8D28. To express such meaning write it fully in ${name} or keep the ENGLISH technical term (e.g. write "t\u1EF1 ki\u1EC3m tra l\u1ED7i" / "self-debugging", "bao g\u1ED3m" / "includes"). A mechanical scanner rejects any document containing even one CJK character.`;
 }
-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"
-  }
+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 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"
 };
-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 extractSectionHeadings(artifactType, opts) {
+  const templateFile = TEMPLATE_BY_TYPE[artifactType.trim().toUpperCase()];
+  if (!templateFile) return {};
+  const resolved = resolveArtifactTemplate(templateFile);
+  if (!resolved) return {};
+  return Object.fromEntries(resolved.sections.map((s) => [s, s]));
 }
-function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi") {
-  const headings = extractSectionHeadingsFromSLC(slcMarkdown, artifactType, targetLanguage);
+function buildHeadingDirective(artifactType, opts) {
+  const headings = extractSectionHeadings(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):
+  const lines = Object.keys(headings).map((heading) => `  - "${heading}"`);
+  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
@@ -19056,9 +18998,8 @@ function buildSectionAwareExcerpt(markdown, opts = {}) {
     };
   }
   const minContentChars = opts.minContentChars !== void 0 ? opts.minContentChars : Math.min(400, source.length);
-  const slcMap = normalizeSlcContract(opts.sectionLanguageContract);
   const effectiveArtifactType = opts.artifactType || deriveArtifactTypeFromFileName(opts.fileName);
-  const sections = parseMarkdownSections(source, slcMap, effectiveArtifactType);
+  const sections = parseMarkdownSections(source);
   const metaBlock = buildMetaBlock(source, effectiveArtifactType);
   if (sections.length === 0) {
     issues.push("parse:no-sections");
@@ -19181,48 +19122,16 @@ function buildLessonExcerpt(markdown, opts = {}) {
     priorities: DEFAULT_LESSON_PRIORITIES
   });
 }
-function normalizeSlcContract(slc) {
-  if (!slc) return void 0;
-  if (typeof slc !== "string") return slc;
-  const out = {};
-  const blocks = slc.split(/\n(?=#{2,3}\s+[A-Z0-9_]+)/g);
-  for (const block of blocks) {
-    const header = block.match(/^#{2,3}\s+([A-Z0-9_]+)/);
-    if (!header?.[1]) continue;
-    const mapping = {};
-    for (const line of block.split("\n")) {
-      const t = line.trim();
-      if (!t.startsWith("|") || t.includes("---")) continue;
-      const cells = t.split("|").map((c) => c.trim()).filter((_, i, a) => i > 0 && i < a.length - 1);
-      const [c0, c1] = cells;
-      if (c0 && c1 && !c0.toLowerCase().includes("canonical") && !c1.toLowerCase().includes("localized")) {
-        mapping[c0] = c1;
-      }
-    }
-    if (Object.keys(mapping).length > 0) out[header[1]] = mapping;
-  }
-  return Object.keys(out).length > 0 ? out : void 0;
-}
-function parseMarkdownSections(markdown, slcMap, artifactType) {
+function parseMarkdownSections(markdown) {
   const sections = [];
   const lines = markdown.split("\n");
   let currentHeading = "";
   let currentBody = [];
-  const reverseMap = /* @__PURE__ */ new Map();
-  if (slcMap) {
-    const maps = artifactType && slcMap[artifactType] ? [slcMap[artifactType]] : Object.values(slcMap);
-    for (const m of maps) {
-      for (const [canonical, localized] of Object.entries(m)) {
-        reverseMap.set(normalizeHeading(localized), canonical);
-        reverseMap.set(normalizeHeading(canonical), canonical);
-      }
-    }
-  }
   const flush = () => {
     if (!currentHeading) return;
     const cleanTitle = currentHeading.replace(/^#{1,4}\s+/, "").trim();
     const norm = normalizeHeading(cleanTitle);
-    const canonicalKey = reverseMap.get(norm) || findCanonicalFuzzy(norm);
+    const canonicalKey = findCanonicalFuzzy(norm);
     sections.push({
       rawHeading: currentHeading,
       cleanTitle,
@@ -19321,7 +19230,7 @@ function buildMetaBlock(source, artifactType) {
 function deriveArtifactTypeFromFileName(fileName) {
   if (!fileName) return void 0;
   const base = fileName.replace(/\.md$/i, "");
-  const multiWord = base.match(/^(KNOWLEDGE_EXPOSITION|SECTION_LANGUAGE_CONTRACT|CONTENT_STYLE_GUIDE|CURRICULUM_FRAMEWORK|LEARNER_PROFILE|PROJECT_BRIEF|REFERENCE_PACK|CURRICULUM_PLAN)/i);
+  const multiWord = base.match(/^(KNOWLEDGE_EXPOSITION|CONTENT_STYLE_GUIDE|CURRICULUM_FRAMEWORK|LEARNER_PROFILE|PROJECT_BRIEF|REFERENCE_PACK|CURRICULUM_PLAN)/i);
   if (multiWord) return multiWord[1].toUpperCase();
   const token = base.match(/^([A-Z][A-Z0-9_]*?)(?=_|$)/);
   return token ? token[1] : void 0;
@@ -19390,6 +19299,9 @@ zod.z.object({
   tieredScaffolding: zod.z.object({ bronze: zod.z.string().default(""), silver: zod.z.string().default(""), gold: zod.z.string().default("") }).default({ bronze: "", silver: "", gold: "" })
 });
 
+// src/services/lessonProductionService.ts
+init_templateLoader();
+
 // src/services/singleArtifactService.ts
 init_errors();
 
@@ -19555,11 +19467,7 @@ async function generateSingleArtifact(req) {
   language.toLowerCase().includes("bilingual") || language.toLowerCase().includes("song");
   const targetLang = resolveTargetLanguageCode(language);
   const langDirective = buildLanguageDirective(language);
-  const headingDirective = buildHeadingDirective(
-    artifactType.toUpperCase(),
-    req.sectionLanguageContract,
-    targetLang
-  );
+  const headingDirective = buildHeadingDirective(artifactType.toUpperCase());
   const availableSources = {
     KNOWLEDGE_EXPOSITION: contextSot.exposition || researchContext,
     CANONICAL_LESSON: contextSot.lessonPlan,
@@ -19626,11 +19534,10 @@ ${symbolLedgerPrompt}
 
 IMAGE PLANNING (media ledger) \u2014 QUOTA GEN: t\u1ED1i \u0111a ${mediaPolicy.maxGenImagesPerArtifact} \u1EA3nh AI cho artifact n\xE0y (\u1EA3nh search kho kh\xF4ng gi\u1EDBi h\u1EA1n).
 Khi n\u1ED9i dung c\u1EA7n minh h\u1ECDa (diagram quy tr\xECnh, s\u01A1 \u0111\u1ED3 kh\xE1i ni\u1EC7m, step-by-step visual), ch\xE8n placeholder \u0111\xFAng format [IMAGE: slug] (slug ch\u1EEF th\u01B0\u1EDDng-g\u1EA1ch ngang, unique trong b\xE0i, vd img-for-loop-diagram) T\u1EA0I \u0110\xDANG CH\u1ED6 c\u1EA7n \u1EA3nh, tr\xEAn d\xF2ng ri\xEAng. KH\xD4NG t\u1EF1 sinh \u1EA3nh, KH\xD4NG d\xF9ng markdown image \u2014 placeholder s\u1EBD \u0111\u01B0\u1EE3c thay b\u1EB1ng \u1EA3nh th\u1EADt sau khi Media Curator duy\u1EC7t. Ch\u1EC9 \u0111\u1EB7t cho \u1EA3nh TH\u1EF0C S\u1EF0 c\u1EA7n thi\u1EBFt.` : ""}`;
-  const slcContract = req.sectionLanguageContract;
-  const frameworkExcerpt = contextSot.framework ? buildSectionAwareExcerpt(contextSot.framework, { budget: 2500, sectionLanguageContract: slcContract }).excerpt : "";
-  const lessonPlanExcerpt = contextSot.lessonPlan ? buildLessonExcerpt(contextSot.lessonPlan, { budget: 8e3, sectionLanguageContract: slcContract, artifactType: "LESSON" }).excerpt : "";
-  const handoutExcerpt = contextSot.handout ? buildSectionAwareExcerpt(contextSot.handout, { budget: 2e3, sectionLanguageContract: slcContract }).excerpt : "";
-  const expositionExcerpt = contextSot.exposition ? buildExpositionExcerpt(contextSot.exposition, { budget: 6e3, sectionLanguageContract: slcContract }).excerpt : "";
+  const frameworkExcerpt = contextSot.framework ? buildSectionAwareExcerpt(contextSot.framework, { budget: 2500 }).excerpt : "";
+  const lessonPlanExcerpt = contextSot.lessonPlan ? buildLessonExcerpt(contextSot.lessonPlan, { budget: 8e3, artifactType: "LESSON" }).excerpt : "";
+  const handoutExcerpt = contextSot.handout ? buildSectionAwareExcerpt(contextSot.handout, { budget: 2e3 }).excerpt : "";
+  const expositionExcerpt = contextSot.exposition ? buildExpositionExcerpt(contextSot.exposition, { budget: 6e3 }).excerpt : "";
   const userPrompt = `### CONTEXT GROUND TRUTH:
 - Topic / Concept Domain: "${topic}"
 - Lesson ID: "${lessonId || "ON_DEMAND"}"