@thanh01.pmt/curriculum-kit 1.4.44 → 1.4.45

package/dist/workflow/index.d.cts

@@ -5,7 +5,7 @@ import { S as SingleArtifactRequest, a as SingleArtifactResult } from '../gateSe
 export { b as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, G as GateSettings, R as ResolvedGateSettings, g as gateModeFor, p as parseGateSettings, r as resolveGateSettings } from '../gateSettings-oo5tCUS_.cjs';
 import * as workflow from 'workflow';
 import { z } from 'zod';
-import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-49pJq5t8.cjs';
+import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-CLnq0d0s.cjs';
 import 'ai';
 
 interface GenerateMasterLessonStepInput {

package/dist/workflow/index.d.ts

@@ -5,7 +5,7 @@ import { S as SingleArtifactRequest, a as SingleArtifactResult } from '../gateSe
 export { b as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, G as GateSettings, R as ResolvedGateSettings, g as gateModeFor, p as parseGateSettings, r as resolveGateSettings } from '../gateSettings-oo5tCUS_.js';
 import * as workflow from 'workflow';
 import { z } from 'zod';
-import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-49pJq5t8.js';
+import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-CLnq0d0s.js';
 import 'ai';
 
 interface GenerateMasterLessonStepInput {

package/dist/workflow/index.mjs

@@ -3,9 +3,9 @@ import path from 'path';
 import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import { createOpenAI } from '@ai-sdk/openai';
 import { createDeepSeek } from '@ai-sdk/deepseek';
+import { fileURLToPath } from 'url';
 import { generateObject } from 'ai';
 import { z } from 'zod';
-import { fileURLToPath } from 'url';
 import { defineHook, getStepMetadata, RetryableError, sleep } from 'workflow';
 import fs3 from 'fs/promises';
 import { Octokit } from '@octokit/rest';
@@ -1127,10 +1127,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.resolve(process.cwd(), "_templates"));
+  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
+    dirs.push(path.resolve(_moduleDir, rel));
+    dirs.push(path.resolve(process.cwd(), rel));
+    dirs.push(path.resolve(process.cwd(), "packages/curriculum-kit", rel));
+  }
+  return dirs;
+}
+function findTemplatePath(templateName, explicitDir) {
+  for (const dir of candidateDirs()) {
+    const p = path.join(dir, templateName);
+    if (!fs2.existsSync(p)) continue;
+    try {
+      fs2.accessSync(p, fs2.constants.R_OK);
+      return p;
+    } catch {
+    }
+  }
+  return null;
+}
+function resolveArtifactTemplate(templateName, opts) {
+  const p = findTemplatePath(templateName);
+  if (!p) return null;
+  try {
+    const raw = fs2.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.readFileSync(p, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function loadAuthoringTemplate(templateName, templatesDir) {
+  const p = findTemplatePath(templateName);
+  if (!p) return "";
+  try {
+    return stripTemplateFrontmatter(fs2.readFileSync(p, "utf-8"));
+  } catch {
+    return "";
+  }
+}
+var KIT_TEMPLATE_FALLBACK_DIRS, _moduleDir;
+var init_templateLoader = __esm({
+  "src/services/templateLoader.ts"() {
+    KIT_TEMPLATE_FALLBACK_DIRS = [
+      // Packaged with the npm bundle (dist/templates) — resolves from node_modules.
+      "templates",
+      // Repo checkout layouts.
+      "docs/refs/templates"
+    ];
+    _moduleDir = (() => {
+      try {
+        if (typeof import.meta !== "undefined" && typeof import.meta.url === "string") {
+          return path.dirname(fileURLToPath(import.meta.url));
+        }
+      } catch {
+      }
+      return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+    })();
+  }
+});
 
 // src/parsers/lessonFlowParser.ts
 var init_lessonFlowParser = __esm({
   "src/parsers/lessonFlowParser.ts"() {
+    init_templateLoader();
   }
 });
 
@@ -2744,72 +2872,9 @@ z.object({
   }),
   phases: 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 import.meta !== "undefined" && typeof import.meta.url === "string") {
-      return path.dirname(fileURLToPath(import.meta.url));
-    }
-  } catch {
-  }
-  return typeof __dirname !== "undefined" ? __dirname : process.cwd();
-})();
-function candidateDirs(explicitDir) {
-  const dirs = [];
-  if (process.env.CURRICULUM_TEMPLATES_DIR) dirs.push(process.env.CURRICULUM_TEMPLATES_DIR);
-  dirs.push(path.resolve(process.cwd(), "_templates"));
-  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
-    dirs.push(path.resolve(_moduleDir, rel));
-    dirs.push(path.resolve(process.cwd(), rel));
-    dirs.push(path.resolve(process.cwd(), "packages/curriculum-kit", rel));
-  }
-  return dirs;
-}
-function findTemplatePath(templateName, explicitDir) {
-  for (const dir of candidateDirs()) {
-    const p = path.join(dir, templateName);
-    if (!fs2.existsSync(p)) continue;
-    try {
-      fs2.accessSync(p, fs2.constants.R_OK);
-      return p;
-    } catch {
-    }
-  }
-  return null;
-}
-function loadCurriculumTemplate(templateName, templatesDir) {
-  const p = findTemplatePath(templateName);
-  if (!p) return "";
-  try {
-    return fs2.readFileSync(p, "utf-8");
-  } catch {
-    return "";
-  }
-}
-function loadAuthoringTemplate(templateName, templatesDir) {
-  const p = findTemplatePath(templateName);
-  if (!p) return "";
-  try {
-    return stripTemplateFrontmatter(fs2.readFileSync(p, "utf-8"));
-  } catch {
-    return "";
-  }
-}
 
 // src/ai/prompts/lessonMasterPrompt.ts
+init_templateLoader();
 function buildLessonMasterPrompt(input) {
   const { milestone, language, topic, targetAudience, contextContinuity, standardsContext } = input;
   const learningObjectives = milestone.learning_objectives || [];
@@ -2911,6 +2976,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");
@@ -3010,6 +3076,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"];
@@ -3416,6 +3483,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"];
@@ -3524,6 +3592,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 || [];
@@ -4073,7 +4142,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}`;
@@ -4117,7 +4186,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}
@@ -4126,13 +4196,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}
@@ -4146,7 +4218,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."}
@@ -4157,7 +4230,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}  
@@ -4250,12 +4324,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}
 
@@ -4263,7 +4341,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}
 
@@ -4318,22 +4398,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.
 
@@ -4408,7 +4494,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:
@@ -18518,6 +18606,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";
@@ -18558,137 +18647,58 @@ function matchesArtifactType(candidate, target) {
   if ((c === "EXT" || c === "EXTENSION") && (t === "EXT" || t === "EXTENSION")) return true;
   return false;
 }
-var DEFAULT_VIETNAMESE_SECTION_HEADINGS = {
-  LEARNER_PROFILE: {
-    "Foundational Info": "Th\xF4ng tin N\u1EC1n t\u1EA3ng",
-    "Entry Level": "Tr\xECnh \u0111\u1ED9 \u0110\u1EA7u v\xE0o",
-    "Learning Context": "B\u1ED1i c\u1EA3nh H\u1ECDc t\u1EADp",
-    "Client Objectives": "M\u1EE5c ti\xEAu Kh\xE1ch h\xE0ng & Chu\u1EA9n \u0111\u1EA7u ra"
-  },
-  PROJECT_BRIEF: {
-    "Project Overview": "T\u1ED5ng quan D\u1EF1 \xE1n",
-    "Audience & Duration": "\u0110\u1ED1i t\u01B0\u1EE3ng & Th\u1EDDi l\u01B0\u1EE3ng",
-    "Learning Roadmap": "L\u1ED9 tr\xECnh H\u1ECDc t\u1EADp & C\u1ED9t m\u1ED1c",
-    "Artifact Scope": "Ph\u1EA1m vi S\u1EA3n ph\u1EA9m H\u1ECDc t\u1EADp"
-  },
-  CURRICULUM_FRAMEWORK: {
-    "Course Overview": "T\u1ED5ng quan Kh\xF3a h\u1ECDc",
-    "Global Learning Objectives": "M\u1EE5c ti\xEAu H\u1ECDc t\u1EADp To\xE0n di\u1EC7n",
-    "Structural Hierarchy (Unit & Module)": "C\u1EA5u tr\xFAc Kh\xF3a h\u1ECDc (Unit & Module)",
-    "Scope & Sequence (Detailed Roadmap)": "Ph\u1EA1m vi & Tr\xECnh t\u1EF1 Chi ti\u1EBFt"
-  },
-  CONTENT_STYLE_GUIDE: {
-    "Voice & Tone": "Gi\u1ECDng v\u0103n & Phong c\xE1ch",
-    "Standard Terminology (Glossary)": "Thu\u1EADt ng\u1EEF Chu\u1EA9n (B\u1EA3ng thu\u1EADt ng\u1EEF)",
-    "Examples & Context Rules": "Quy t\u1EAFc V\xED d\u1EE5 & Ng\u1EEF c\u1EA3nh",
-    "Lesson Content Standards": "Ti\xEAu chu\u1EA9n N\u1ED9i dung B\xE0i h\u1ECDc"
-  },
-  SECTION_LANGUAGE_CONTRACT: {
-    "Metadata & Scope": "Th\xF4ng tin & Ph\u1EA1m vi H\u1EE3p \u0111\u1ED3ng",
-    "Section Translation Matrix": "Ma tr\u1EADn Ti\xEAu \u0111\u1EC1 \u0110a ng\xF4n ng\u1EEF",
-    "Validation Rules": "Quy t\u1EAFc X\xE1c th\u1EF1c & Kh\xF3a Chu\u1EA9n"
-  },
-  KNOWLEDGE_EXPOSITION: {
-    "Session Scope": "Ph\u1EA1m vi Bu\u1ED5i h\u1ECDc",
-    "Key Terms": "Thu\u1EADt ng\u1EEF Then ch\u1ED1t",
-    "Concept Narratives": "Di\u1EC5n gi\u1EA3i Kh\xE1i ni\u1EC7m",
-    "Worked Micro-Examples": "V\xED d\u1EE5 M\u1EABu Chi ti\u1EBFt",
-    "Common Mistakes": "L\u1ED7i Th\u01B0\u1EDDng g\u1EB7p & Kh\u1EAFc ph\u1EE5c",
-    "Self-Check Questions": "C\xE2u h\u1ECFi T\u1EF1 ki\u1EC3m tra"
-  },
-  LESSON: {
-    "A. Lesson Design Plan": "A. K\u1EBF ho\u1EA1ch Thi\u1EBFt k\u1EBF B\xE0i h\u1ECDc",
-    "Learning Objectives & Evidence": "M\u1EE5c ti\xEAu H\u1ECDc t\u1EADp & B\u1EB1ng ch\u1EE9ng N\u0103ng l\u1EF1c",
-    "Activity Sequence": "Chu\u1ED7i Ho\u1EA1t \u0111\u1ED9ng D\u1EA1y & H\u1ECDc",
-    "Resource Map": "B\u1EA3n \u0111\u1ED3 T\xE0i nguy\xEAn & H\u1ECDc li\u1EC7u",
-    "Assessment Map": "B\u1EA3n \u0111\u1ED3 \u0110\xE1nh gi\xE1 N\u0103ng l\u1EF1c",
-    "Artifact Contract": "H\u1EE3p \u0111\u1ED3ng S\u1EA3n ph\u1EA9m \u0110\u1EA7u ra",
-    "B. Lesson Flow": "B. Ti\u1EBFn tr\xECnh Gi\u1EA3ng d\u1EA1y Chi ti\u1EBFt"
-  },
-  ACT: {
-    "Computational Thinking Focus": "Tr\u1ECDng t\xE2m T\u01B0 duy M\xE1y t\xEDnh",
-    "Materials & Setup": "V\u1EADt li\u1EC7u & Chu\u1EA9n b\u1ECB Thi\u1EBFt b\u1ECB",
-    "Constraints & Safety": "R\xE0ng bu\u1ED9c & An to\xE0n Ph\xF2ng th\u1EF1c h\xE0nh",
-    "Active Learning Workflow": "Quy tr\xECnh Ho\u1EA1t \u0111\u1ED9ng Tr\u1EA3i nghi\u1EC7m",
-    "3-Tier Differentiation": "Ph\xE2n h\xF3a H\u1ECDc t\u1EADp 3 T\u1EA7ng",
-    "Reflection": "T\u1ED5ng k\u1EBFt & \u0110\xFAc k\u1EBFt Tr\u1EA3i nghi\u1EC7m"
-  },
-  CODE: {
-    "Technical Overview & Architecture Blueprint": "T\u1ED5ng quan K\u1EF9 thu\u1EADt & B\u1EA3n thi\u1EBFt k\u1EBF Ki\u1EBFn tr\xFAc",
-    "Hardware Pinout & Wiring Configuration Matrix": "S\u01A1 \u0111\u1ED3 Ch\xE2n & Ma tr\u1EADn N\u1ED1i d\xE2y Ph\u1EA7n c\u1EE9ng",
-    "Starter Code Sandbox": "M\xE3 ngu\u1ED3n Kh\u1EDFi \u0111\u1EA7u (Starter Code)",
-    "Verified Reference Solution Code": "M\xE3 ngu\u1ED3n L\u1EDDi gi\u1EA3i Chu\u1EA9n (Reference Solution)",
-    "Automated Test / Verification Script": "K\u1ECBch b\u1EA3n Ki\u1EC3m th\u1EED T\u1EF1 \u0111\u1ED9ng",
-    "Common Syntax & Runtime Pitfalls Matrix": "Ma tr\u1EADn L\u1ED7i C\xFA ph\xE1p & Th\u1EDDi gian ch\u1EA1y Th\u01B0\u1EDDng g\u1EB7p"
-  },
-  CODE_LAB: {
-    "Technical Overview & Architecture Blueprint": "T\u1ED5ng quan K\u1EF9 thu\u1EADt & B\u1EA3n thi\u1EBFt k\u1EBF Ki\u1EBFn tr\xFAc",
-    "Hardware Pinout & Wiring Configuration Matrix": "S\u01A1 \u0111\u1ED3 Ch\xE2n & Ma tr\u1EADn N\u1ED1i d\xE2y Ph\u1EA7n c\u1EE9ng",
-    "Starter Code Sandbox": "M\xE3 ngu\u1ED3n Kh\u1EDFi \u0111\u1EA7u (Starter Code)",
-    "Verified Reference Solution Code": "M\xE3 ngu\u1ED3n L\u1EDDi gi\u1EA3i Chu\u1EA9n (Reference Solution)",
-    "Automated Test / Verification Script": "K\u1ECBch b\u1EA3n Ki\u1EC3m th\u1EED T\u1EF1 \u0111\u1ED9ng",
-    "Common Syntax & Runtime Pitfalls Matrix": "Ma tr\u1EADn L\u1ED7i C\xFA ph\xE1p & Th\u1EDDi gian ch\u1EA1y Th\u01B0\u1EDDng g\u1EB7p"
-  },
-  QUIZ: {
-    "Assessment Objectives": "M\u1EE5c ti\xEAu \u0110\xE1nh gi\xE1",
-    "Multiple-Choice Question Bank": "Ng\xE2n h\xE0ng C\xE2u h\u1ECFi Tr\u1EAFc nghi\u1EC7m",
-    "Code Analysis / Debugging Question": "C\xE2u h\u1ECFi Ph\xE2n t\xEDch M\xE3 ngu\u1ED3n & S\u1EEDa l\u1ED7i",
-    "Competency Rubric": "Thang \u0111o \u0110\xE1nh gi\xE1 N\u0103ng l\u1EF1c (Rubric)"
-  },
-  GUIDE: {
-    "Objectives & Preparation": "M\u1EE5c ti\xEAu & Chu\u1EA9n b\u1ECB Gi\u1EA3ng d\u1EA1y",
-    "Preparation Checklist & Workstation Setup": "Danh m\u1EE5c Ki\u1EC3m tra Chu\u1EA9n b\u1ECB & Tr\u1EA1m Th\u1EF1c h\xE0nh",
-    "Facilitation Script & Timeline": "K\u1ECBch b\u1EA3n \u0110i\u1EC1u ph\u1ED1i & Khung Th\u1EDDi gian",
-    "Common Misconceptions & Diagnostic Remediation Matrix": "Quan ni\u1EC7m Sai l\u1EA7m Th\u01B0\u1EDDng g\u1EB7p & Ma tr\u1EADn Kh\u1EAFc ph\u1EE5c",
-    "Differentiated Support Strategies": "Chi\u1EBFn l\u01B0\u1EE3c H\u1ED7 tr\u1EE3 Ph\xE2n h\xF3a"
-  },
-  HANDOUT: {
-    "Core Concepts": "Kh\xE1i ni\u1EC7m C\u1ED1t l\xF5i",
-    "Core Syntax & Mechanism Cheat Sheet": "B\u1EA3ng Tra c\u1EE9u C\xFA ph\xE1p & C\u01A1 ch\u1EBF Tr\u1ECDng t\xE2m",
-    "Visual Mental Model / Architecture Diagram": "M\xF4 h\xECnh T\u01B0 duy Tr\u1EF1c quan / S\u01A1 \u0111\u1ED3 Ki\u1EBFn tr\xFAc",
-    "Step-by-Step Practical Quick-Start Guide": "H\u01B0\u1EDBng d\u1EABn Th\u1EF1c h\xE0nh T\u1EEBng b\u01B0\u1EDBc",
-    "Self-Check Diagnostic Checklist": "B\u1EA3ng Ki\u1EC3m tra T\u1EF1 ch\u1EA9n \u0111o\xE1n"
-  },
-  WKS: {
-    "Part 1: Knowledge Check": "Ph\u1EA7n 1: Ki\u1EC3m tra Ki\u1EBFn th\u1EE9c",
-    "Part 2: Concept Tracing & Diagram Fill-in": "Ph\u1EA7n 2: L\u1EA7n v\u1EBFt Kh\xE1i ni\u1EC7m & \u0110i\u1EC1n S\u01A1 \u0111\u1ED3",
-    "Part 3: Code Analysis & Bug Hunting Challenge": "Ph\u1EA7n 3: Ph\xE2n t\xEDch M\xE3 & Th\u1EED th\xE1ch S\u0103n l\u1ED7i",
-    "Part 4: Synthesis & Problem-Solving Application": "Ph\u1EA7n 4: T\u1ED5ng h\u1EE3p & \u1EE8ng d\u1EE5ng Gi\u1EA3i quy\u1EBFt V\u1EA5n \u0111\u1EC1",
-    "Part 5: Self-Reflection & Learning Log": "Ph\u1EA7n 5: T\u1EF1 suy ng\u1EABm & Nh\u1EADt k\xFD H\u1ECDc t\u1EADp"
-  },
-  EXT: {
-    "For: Advanced Students / Extra Time": "D\xE0nh cho: H\u1ECDc sinh N\xE2ng cao / Ho\xE0n th\xE0nh S\u1EDBm",
-    "Challenge 1: Mission Briefing & Real-World High-Stakes Scenario": "Th\u1EED th\xE1ch 1: B\u1ED1i c\u1EA3nh Nhi\u1EC7m v\u1EE5 Th\u1EF1c t\u1EBF & K\u1ECBch b\u1EA3n \u1EE8ng d\u1EE5ng",
-    "Challenge 2: Advanced Architectural Constraints & Edge Cases": "Th\u1EED th\xE1ch 2: R\xE0ng bu\u1ED9c Ki\u1EBFn tr\xFAc N\xE2ng cao & Tr\u01B0\u1EDDng h\u1EE3p Bi\xEAn",
-    "Challenge 3: Extension Milestones": "Th\u1EED th\xE1ch 3: C\xE1c M\u1ED1c Nhi\u1EC7m v\u1EE5 N\xE2ng cao",
-    "Metacognitive Deep Dive & Engineering Trade-offs": "Suy ng\u1EABm Si\xEAu nh\u1EADn th\u1EE9c & \u0110\xE1nh \u0111\u1ED5i K\u1EF9 thu\u1EADt"
-  },
-  SLIDE: {
-    "Title & Agenda": "Ti\xEAu \u0111\u1EC1 & M\u1EE5c l\u1EE5c",
-    "Core Concepts": "Kh\xE1i ni\u1EC7m C\u1ED1t l\xF5i",
-    "Guided Demonstration": "H\u01B0\u1EDBng d\u1EABn Th\u1EF1c h\xE0nh & Th\u1ECB ph\u1EA1m",
-    "Hands-on Mission": "Nhi\u1EC7m v\u1EE5 Th\u1EF1c h\xE0nh Tr\u1EA3i nghi\u1EC7m",
-    "Summary & Next Steps": "T\u1ED5ng k\u1EBFt & \u0110\u1ECBnh h\u01B0\u1EDBng Ti\u1EBFp theo"
-  }
+var TEMPLATE_BY_TYPE = {
+  LESSON: "LESSON_5E_template.md",
+  LESSON_5E: "LESSON_5E_template.md",
+  LESSON_EDP: "LESSON_EDP_template.md",
+  LESSON_GENERAL: "LESSON_GENERAL_template.md",
+  ACT: "ACT_template.md",
+  CODE: "CODE_template.md",
+  // JSON-first code lab shares the CODE label set (the serializer renders its
+  // own headings; this lookup only feeds the SLC/directive fallback path).
+  CODE_LAB: "CODE_template.md",
+  QUIZ: "QUIZ_v4.6_template.md",
+  GUIDE: "GUIDE_template.md",
+  HANDOUT: "HANDOUT_template.md",
+  WKS: "WKS_template.md",
+  EXT: "EXT_template.md",
+  SLIDE: "SLIDE_template.md",
+  KNOWLEDGE_EXPOSITION: "KNOWLEDGE_EXPOSITION_template.md",
+  LEARNER_PROFILE: "LEARNER_PROFILE_template.md",
+  PROJECT_BRIEF: "PROJECT_BRIEF_template.md",
+  CURRICULUM_FRAMEWORK: "CURRICULUM_FRAMEWORK_template.md",
+  CONTENT_STYLE_GUIDE: "CONTENT_STYLE_GUIDE_template.md",
+  SECTION_LANGUAGE_CONTRACT: "SECTION_LANGUAGE_CONTRACT_template.md"
 };
+function keepContractEntries(artifactType, mapping) {
+  const templateFile = TEMPLATE_BY_TYPE[artifactType.trim().toUpperCase()];
+  if (!templateFile) return mapping;
+  const resolved = resolveArtifactTemplate(templateFile);
+  if (!resolved) return mapping;
+  const contract = new Set(resolved.sections.map(stripHeadingKey));
+  const kept = {};
+  for (const [k, v] of Object.entries(mapping)) {
+    if (contract.has(stripHeadingKey(k))) kept[k] = v;
+  }
+  return kept;
+}
 function extractSectionHeadingsFromSLC(slcInput, artifactType, targetLanguage = "vi") {
   const upperType = artifactType.trim().toUpperCase();
   const getFallback = () => {
-    if (resolveTargetLanguageCode(targetLanguage) === "vi") {
-      for (const [key, mapping] of Object.entries(DEFAULT_VIETNAMESE_SECTION_HEADINGS)) {
-        if (matchesArtifactType(key, upperType)) {
-          return mapping;
-        }
-      }
-    }
-    return {};
+    const templateFile = TEMPLATE_BY_TYPE[upperType];
+    if (!templateFile) return {};
+    const resolved = resolveArtifactTemplate(templateFile);
+    if (!resolved) return {};
+    return Object.fromEntries(resolved.sections.map((s) => [s, s]));
   };
   if (!slcInput) return getFallback();
   if (typeof slcInput === "object") {
-    if (slcInput[upperType] && Object.keys(slcInput[upperType]).length > 0) return slcInput[upperType];
+    if (slcInput[upperType] && Object.keys(slcInput[upperType]).length > 0) {
+      return keepContractEntries(upperType, slcInput[upperType]);
+    }
     for (const [key, mapping] of Object.entries(slcInput)) {
       if (matchesArtifactType(key, upperType) && Object.keys(mapping).length > 0) {
-        return mapping;
+        return keepContractEntries(upperType, mapping);
       }
     }
     return getFallback();
@@ -18716,24 +18726,33 @@ function extractSectionHeadingsFromSLC(slcInput, artifactType, targetLanguage =
           }
         }
       }
-      if (Object.keys(mapping).length > 0) return mapping;
+      if (Object.keys(mapping).length > 0) return keepContractEntries(upperType, mapping);
     }
   }
   return getFallback();
 }
-function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi") {
-  const headings = extractSectionHeadingsFromSLC(slcMarkdown, artifactType, targetLanguage);
+function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi", opts) {
+  const upperType = artifactType.trim().toUpperCase();
+  const templateFile = TEMPLATE_BY_TYPE[upperType];
+  const resolved = templateFile ? resolveArtifactTemplate(templateFile) : null;
+  const baked = !!resolved && resolved.declaredLang !== "en";
+  const headings = resolved ? Object.fromEntries(
+    resolved.sections.map((s) => [
+      s,
+      baked ? s : extractSectionHeadingsFromSLC(slcMarkdown, upperType, targetLanguage)[s] || s
+    ])
+  ) : extractSectionHeadingsFromSLC(baked ? null : slcMarkdown, upperType, targetLanguage);
   if (Object.keys(headings).length === 0) {
     return "";
   }
   const lines = Object.entries(headings).map(
-    ([canonical, localized]) => `  - "${canonical}" -> Use Display Heading: "${localized}"`
+    ([heading, display]) => heading === display ? `  - "${display}"` : `  - "${heading}" -> Use Display Heading: "${display}"`
   );
-  return `MANDATORY SECTION HEADINGS FROM SECTION_LANGUAGE_CONTRACT:
-- The YAML frontmatter \`template_required_sections\` MUST preserve the exact English canonical keys.
-- In the markdown body, section headers MUST use the EXACT Localized Display Labels below (do NOT translate or paraphrase):
+  return `MANDATORY SECTION HEADINGS (SOURCE: RESOLVED ARTIFACT TEMPLATE):
+- Copy the template's YAML frontmatter \`template_required_sections\` list VERBATIM into the artifact frontmatter \u2014 never translate, reorder, or invent entries.
+- In the markdown body, section headers MUST be exactly the Display Headings below (do NOT translate, paraphrase, or re-marker them):
 ${lines.join("\n")}
-- For example: if canonical section is "Computational Thinking Focus", your heading must be "## [REQUIRED] ${headings["Computational Thinking Focus"] || "Computational Thinking Focus"}".`;
+- Example: if the resolved template's heading is "${Object.values(headings)[0]}", your body heading must be exactly "## ${Object.values(headings)[0]}".`;
 }
 
 // src/services/curriculumHorizon.ts
@@ -19381,6 +19400,9 @@ z.object({
   tieredScaffolding: z.object({ bronze: z.string().default(""), silver: z.string().default(""), gold: z.string().default("") }).default({ bronze: "", silver: "", gold: "" })
 });
 
+// src/services/lessonProductionService.ts
+init_templateLoader();
+
 // src/services/singleArtifactService.ts
 init_errors();