@thanh01.pmt/curriculum-kit 1.0.22 → 1.2.0

package/dist/index.cjs

@@ -85,6 +85,8 @@ function getSuggestedActionForCode(code) {
       return "N\u1ED9i dung sinh ra thi\u1EBFu c\xE1c ph\u1EA7n b\u1EAFt bu\u1ED9c [REQUIRED]. H\xE3y k\xEDch ho\u1EA1t ki\u1EC3m th\u1EED ho\u1EB7c b\u1EA5m Rerun.";
     case "ERR_STORAGE_IO_FAILED":
       return "L\u1ED7i \u0111\u1ECDc/ghi t\u1EC7p tin tr\xEAn h\u1EC7 th\u1ED1ng l\u01B0u tr\u1EEF. Ki\u1EC3m tra quy\u1EC1n ghi th\u01B0 m\u1EE5c output/projects.";
+    case "ERR_CONTEXT_MISSING":
+      return "Thi\u1EBFu ngu\u1ED3n tri th\u1EE9c b\u1EAFt bu\u1ED9c (KNOWLEDGE_EXPOSITION ho\u1EB7c CANONICAL LESSON) theo Dependency Routing Matrix. Vui l\xF2ng t\u1EA1o ho\u1EB7c \u0111\u1ED3ng b\u1ED9 t\xE0i li\u1EC7u ngu\u1ED3n tr\u01B0\u1EDBc.";
     default:
       return "B\u1EA5m Rerun \u0111\u1EC3 th\u1EED l\u1EA1i ho\u1EB7c ki\u1EC3m tra nh\u1EADt k\xFD h\u1EC7 th\u1ED1ng.";
   }
@@ -102,11 +104,23 @@ function isCodeRetryable(code) {
     case "ERR_TASK_GATE_BLOCKED":
     case "ERR_METERED_LIMIT_EXCEEDED":
     case "ERR_SCHEMA_CONTRACT_VIOLATION":
+    case "ERR_CONTEXT_MISSING":
       return false;
     default:
       return true;
   }
 }
+function createContextMissingError(params) {
+  return new exports.CurriculumError({
+    errorCode: "ERR_CONTEXT_MISSING",
+    artifactType: params.artifactType,
+    lessonId: params.lessonId,
+    agent: params.agent,
+    message: `Required context source "${params.missingSource}" is missing for artifact "${params.artifactType}"`,
+    suggestedAction: `Generate or provide the authoritative "${params.missingSource}" source before producing "${params.artifactType}".`,
+    retryable: false
+  });
+}
 exports.CurriculumError = void 0;
 var init_errors = __esm({
   "src/errors/index.ts"() {
@@ -2432,9 +2446,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()),
@@ -5368,6 +5393,45 @@ Return a single valid JSON object matching SlideDeckSchema with these exact keys
   }
 `.trim();
 }
+var SLIDE_CANONICAL_METHODOLOGY = `
+MANDATORY 12-14 SLIDE MICRO-CYCLE STRUCTURE (Delimited by '---'):
+1. **Slide 1 [Title & Mission]:** Real-world inquiry hook and overarching build mission
+2. **Slide 2 [Agenda & Roadmap]:** Timing and milestone breakdown table
+3. **Slide 3 [Warm-Up / Prior Knowledge]:** 2-column recall + 60-second diagnostic challenge card
+4. **Slide 4 [High-Stakes Hook Scenario]:** Authentic engineering/domain crisis card + dilemma constraint
+5. **Slide 5 [Core Concept 1: Mental Model]:** Definition, intuitive everyday analogy, and golden rule card
+6. **Slide 6 [Architecture & Visual Flow]:** Clean Mermaid diagram (flowchart or sequenceDiagram) + 3 flow steps
+7. **Slide 7 [Core Concept 2: Syntax / Mechanism Anatomy]:** Side-by-side runnable code + anatomy breakdown & syntax trap card
+8. **Slide 8 [Guided Practice: Try It Now]:** 3-minute active desk task card with starter hint and success criteria
+9. **Slide 9 [Integrated Hands-On Lab]:** 3-tier differentiated challenge cards (Bronze / Silver / Gold) + gotcha alert card
+10. **Slide 10 [Traffic Light Checkpoint & Pitfalls]:** Formative self-check cards (\u{1F7E2}/\u{1F7E1}/\u{1F534}) & diagnostic test question
+11. **Slide 11 [Exit Ticket & Metacognition]:** 2 scenario-based check questions + 1 metacognitive reflection prompt
+12. **Slide 12 [Summary & Next Steps]:** 3 core golden rules + preview card of next upcoming milestone
+
+Mandatory Canvas & Presentation Invariants:
+- A slide is an INTERACTIVE PROJECTION CANVAS, NOT a textbook! Absolutely NO dense paragraphs or walls of text.
+- Follow the 6x6 rule: Maximum 4-6 bullet points per slide, maximum 8-12 words per bullet.
+- Structure slides using \`<div class="columns"><div>...</div><div>...</div></div>\` and \`<div class="card">\`, \`<div class="card highlight">\`, \`<div class="card warning">\`, \`<div class="card success">\`.
+- MANDATORY PRESENTER NOTES ON EVERY SLIDE: Every slide MUST end with \`<!-- Presenter Notes: ... -->\` containing:
+  * SCRIPT: 60-90s teacher talk track with intuitive analogies.
+  * 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.
+`.trim();
+function buildMarpMarkdownSlidePrompt(input) {
+  return `You are @illustrator & @content (Pedagogical Slide Deck Presentation Specialists).
+Based on Master Lesson Plan \`LESSON_${input.lessonCode}.md\`, lesson context, and the MARP SLIDE TEMPLATE below, author the complete, highly engaging Marp presentation deck: \`SLIDE_${input.lessonCode}.md\`.
+
+[MARP SLIDE TEMPLATE SCAFFOLD]:
+${input.templateScaffold}
+
+${SLIDE_CANONICAL_METHODOLOGY}
+
+${input.languageDirective}
+
+${input.headingDirective}`.trim();
+}
 
 // src/ai/prompts/teacherGuidePrompt.ts
 function buildTeacherGuidePrompt(input) {
@@ -9700,6 +9764,224 @@ function resolveGateSettings(raw) {
 function gateModeFor(resolved, type) {
   return resolved[type] ?? "OFF";
 }
+
+// src/services/contextBuilder.ts
+var DEFAULT_LESSON_PRIORITIES = [
+  "A. Lesson Design Plan",
+  "B. Lesson Flow",
+  "Learning Objectives & Evidence",
+  "Activity Sequence"
+];
+var DEFAULT_KX_PRIORITIES = [
+  "Key Terms",
+  "Concept Narratives",
+  "Worked Micro-Examples"
+];
+function buildSectionAwareExcerpt(markdown, opts = {}) {
+  const budget = opts.budget ?? 12e3;
+  const minContentChars = opts.minContentChars ?? 400;
+  const issues = [];
+  const source = (markdown || "").trim();
+  if (!source) {
+    return {
+      excerpt: "",
+      verified: false,
+      sectionAware: false,
+      includedSections: [],
+      issues: ["empty-source"],
+      tokenEstimate: 0
+    };
+  }
+  const slcMap = normalizeSlcContract(opts.sectionLanguageContract);
+  const sections = parseMarkdownSections(source, slcMap, opts.artifactType);
+  if (sections.length === 0) {
+    issues.push("parse:no-sections");
+    const excerpt2 = truncateByBudget(source, budget);
+    const verified2 = excerpt2.length >= minContentChars;
+    if (excerpt2.length < minContentChars) issues.push("content:insufficient");
+    return {
+      excerpt: excerpt2,
+      verified: verified2,
+      sectionAware: false,
+      includedSections: [],
+      issues,
+      tokenEstimate: Math.round(excerpt2.length / 4)
+    };
+  }
+  const byCanonical = /* @__PURE__ */ new Map();
+  const unmatched = [];
+  for (const s of sections) {
+    if (s.canonicalKey && !byCanonical.has(s.canonicalKey)) {
+      byCanonical.set(s.canonicalKey, s);
+    } else {
+      unmatched.push(s);
+    }
+  }
+  const priorities = opts.priorities ?? DEFAULT_LESSON_PRIORITIES;
+  const includedSections = [];
+  const blocks = [];
+  let used = 0;
+  const tryAdd = (heading, body, key) => {
+    const trimmedBody = body.trim();
+    if (!trimmedBody) return false;
+    const block = `## ${heading}
+
+${trimmedBody}`;
+    if (used + block.length > budget && blocks.length > 0) return false;
+    blocks.push(block);
+    used += block.length;
+    includedSections.push(key);
+    return true;
+  };
+  let sectionAware = false;
+  for (const key of priorities) {
+    const sec = byCanonical.get(key);
+    if (!sec) continue;
+    sectionAware = true;
+    if (!tryAdd(sec.cleanTitle, sec.body, key)) break;
+  }
+  for (const [key, sec] of byCanonical) {
+    if (includedSections.includes(key)) continue;
+    if (used >= budget) break;
+    if (!tryAdd(sec.cleanTitle, sec.body, key)) break;
+  }
+  for (const sec of unmatched) {
+    if (used >= budget) break;
+    if (!tryAdd(sec.cleanTitle, sec.body, sec.cleanTitle)) break;
+  }
+  if (priorities.length > 0 && !priorities.some((k) => includedSections.includes(k))) {
+    issues.push("parse:no-priority-resolution");
+  }
+  let excerpt = blocks.join("\n\n");
+  if (excerpt.length > budget) {
+    excerpt = truncateByBudget(excerpt, budget);
+  }
+  const effectiveMinChars = Math.min(minContentChars, source.length);
+  if (excerpt.length < effectiveMinChars) {
+    issues.push("content:insufficient");
+  }
+  const verified = !issues.includes("parse:no-priority-resolution") && excerpt.length >= effectiveMinChars;
+  return {
+    excerpt,
+    verified,
+    sectionAware: sectionAware || priorities.length === 0 && sections.length > 0,
+    includedSections,
+    issues,
+    tokenEstimate: Math.round(excerpt.length / 4)
+  };
+}
+function buildExpositionExcerpt(markdown, opts = {}) {
+  return buildSectionAwareExcerpt(markdown, {
+    ...opts,
+    priorities: DEFAULT_KX_PRIORITIES
+  });
+}
+function buildLessonExcerpt(markdown, opts = {}) {
+  return buildSectionAwareExcerpt(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) {
+  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 && currentBody.length === 0) return;
+    const cleanTitle = currentHeading.replace(/^#{1,4}\s+/, "").trim();
+    const norm = normalizeHeading(cleanTitle);
+    const canonicalKey = reverseMap.get(norm) || findCanonicalFuzzy(norm);
+    sections.push({
+      rawHeading: currentHeading,
+      cleanTitle,
+      canonicalKey,
+      body: currentBody.join("\n")
+    });
+    currentBody = [];
+  };
+  const hasH2 = lines.some((l) => /^##\s+/.test(l));
+  const headingRegex = hasH2 ? /^##\s+(.*)$/ : /^#{2,3}\s+(.*)$/;
+  for (const line of lines) {
+    const headingMatch = line.match(headingRegex);
+    if (headingMatch) {
+      flush();
+      currentHeading = line.trim();
+    } else {
+      currentBody.push(line);
+    }
+  }
+  flush();
+  return sections;
+}
+function normalizeHeading(str) {
+  return str.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^\w\s]/g, " ").replace(/\s+/g, " ").trim();
+}
+function findCanonicalFuzzy(norm) {
+  if (norm.includes("lesson design plan") || norm.includes("ke hoach thiet ke")) {
+    return "A. Lesson Design Plan";
+  }
+  if (norm.includes("lesson flow") || norm.includes("tien trinh giang day")) {
+    return "B. Lesson Flow";
+  }
+  if (norm.includes("learning objective") || norm.includes("muc tieu bai hoc")) {
+    return "Learning Objectives & Evidence";
+  }
+  if (norm.includes("activity sequence") || norm.includes("chuoi hoat dong")) {
+    return "Activity Sequence";
+  }
+  if (norm.includes("key term") || norm.includes("thuat ngu")) {
+    return "Key Terms";
+  }
+  if (norm.includes("concept narrative") || norm.includes("dien giai khai niem")) {
+    return "Concept Narratives";
+  }
+  if (norm.includes("worked example") || norm.includes("vi du")) {
+    return "Worked Micro-Examples";
+  }
+  return void 0;
+}
+function truncateByBudget(source, budget) {
+  if (source.length <= budget) return source;
+  let cut = source.slice(0, budget);
+  const fenceCount = (cut.match(/^```/gm) || []).length;
+  if (fenceCount % 2 === 1) cut += "\n```";
+  return cut;
+}
+
+// src/services/knowledgeExpositionService.ts
 var EXPOSITION_REL = (lessonCode) => "_sot/expositions/" + lessonCode + ".md";
 var ExpositionApprovalError = class extends Error {
   constructor(message) {
@@ -9806,15 +10088,8 @@ async function ensureKnowledgeExposition(options) {
   return { relPath: EXPOSITION_REL(lessonCode), content: stamped, reused: false, gateMode: gateModeFor(options.gates ?? {}, "KNOWLEDGE_EXPOSITION") };
 }
 function buildExpositionContext(expositionContent, maxChars = 6e3) {
-  const trimmed = expositionContent.trim();
-  if (trimmed.length <= maxChars) return trimmed;
-  const sections = trimmed.split(/\n(?=## )/);
-  let out = sections[0];
-  for (let i = 1; i < sections.length && out.length < maxChars; i++) {
-    const s = sections[i];
-    out += "\n" + s.slice(0, Math.max(400, maxChars - out.length));
-  }
-  return out.slice(0, maxChars);
+  if (!expositionContent || !expositionContent.trim()) return "";
+  return buildExpositionExcerpt(expositionContent, { budget: maxChars }).excerpt;
 }
 function expositionCacheKey(planHash, lessonCode) {
   return crypto.createHash("sha256").update(planHash + "|" + lessonCode).digest("hex").slice(0, 16);
@@ -9855,6 +10130,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;
@@ -10497,7 +10773,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);
@@ -11064,6 +11348,90 @@ 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(slcInput, artifactType) {
+  if (!slcInput) return {};
+  const upperType = artifactType.trim().toUpperCase();
+  if (typeof slcInput === "object") {
+    if (slcInput[upperType]) return slcInput[upperType];
+    for (const [key, mapping] of Object.entries(slcInput)) {
+      if (key.toUpperCase() === upperType || upperType.startsWith("LESSON") && key.toUpperCase().startsWith("LESSON")) {
+        return mapping;
+      }
+    }
+    return {};
+  }
+  const slcMarkdown = slcInput;
+  const blocks = slcMarkdown.split(/\n(?=#{2,3}\s+[A-Z0-9_]+)/g);
+  for (const block of blocks) {
+    const headerMatch = block.match(/^#{2,3}\s+([A-Z0-9_]+)/);
+    if (!headerMatch) continue;
+    const blockType = headerMatch[1].trim().toUpperCase();
+    if (blockType === upperType || upperType.startsWith("LESSON") && blockType.startsWith("LESSON")) {
+      const mapping = {};
+      const lines = block.split("\n");
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("|") && !trimmed.includes("---")) {
+          const cells = trimmed.split("|").map((c) => c.trim()).filter((_, idx, arr) => idx > 0 && idx < arr.length - 1);
+          if (cells.length >= 2 && !cells[0].toLowerCase().includes("canonical") && !cells[1].toLowerCase().includes("localized")) {
+            mapping[cells[0]] = cells[1];
+          }
+        } else {
+          const bullet = line.match(/^[-*]\s+([^:]+):\s+(.+)$/);
+          if (bullet) {
+            mapping[bullet[1].trim()] = bullet[2].trim();
+          }
+        }
+      }
+      if (Object.keys(mapping).length > 0) return mapping;
+    }
+  }
+  return {};
+}
+function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi") {
+  const headings = extractSectionHeadingsFromSLC(slcMarkdown, artifactType);
+  if (Object.keys(headings).length === 0) {
+    return "";
+  }
+  const lines = Object.entries(headings).map(
+    ([canonical, localized]) => `  - "${canonical}" -> Use Display Heading: "${localized}"`
+  );
+  return `MANDATORY SECTION HEADINGS FROM SECTION_LANGUAGE_CONTRACT:
+- The YAML frontmatter \`template_required_sections\` MUST preserve the exact English canonical keys.
+- In the markdown body, section headers MUST use the EXACT Localized Display Labels below (do NOT translate or paraphrase):
+${lines.join("\n")}
+- For example: if canonical section is "Computational Thinking Focus", your heading must be "## [REQUIRED] ${headings["Computational Thinking Focus"] || "Computational Thinking Focus"}".`;
+}
+
 // src/services/lessonProductionService.ts
 var __filename2 = typeof (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) === "string" ? 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();
@@ -11105,11 +11473,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";
@@ -11154,15 +11555,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 "";
@@ -11204,7 +11614,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"
@@ -11224,8 +11634,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}
@@ -11274,9 +11685,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}
@@ -11323,8 +11733,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}
@@ -11372,6 +11782,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 {
@@ -11402,6 +11824,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 {
@@ -11436,6 +11872,18 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   }
   const pedagogy = detectProjectPedagogy(framework, styleGuide, options.pedagogy);
   const pedagogyLabel = pedagogy.toUpperCase();
+  const styleGuideExcerpt = styleGuide ? buildSectionAwareExcerpt(styleGuide, {
+    priorities: ["Voice & Tone", "Standard Terminology (Glossary)", "Lesson Content Standards"],
+    budget: 2e3
+  }).excerpt : "";
+  const refPackExcerpt = refPack ? buildSectionAwareExcerpt(refPack, {
+    priorities: [
+      "Technical Overview & Architecture Blueprint",
+      "Hardware Pinout & Wiring Configuration Matrix",
+      "Core Pedagogical Concept Anchor & Real-World Domain Bridge"
+    ],
+    budget: 2500
+  }).excerpt : "";
   const commonContext = `PROJECT & ACADEMIC CONTEXT:
 - Project ID: ${projectId}
 - Pedagogical Model: ${pedagogyLabel}
@@ -11449,10 +11897,10 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
 ${buildFrameworkExcerptForLesson(framework, lessonId)}
 
 [CONTENT STYLE GUIDE EXCERPT]:
-${styleGuide.slice(0, 1500)}
+${styleGuideExcerpt}
 
 [REFERENCE PACK GROUND TRUTH]:
-${refPack.slice(0, 1e3)}${standardsContext ? "\n\n" + standardsContext : ""}${expositionContext ? "\n\n[KNOWLEDGE_EXPOSITION (CANONICAL KNOWLEDGE \u2014 teach from this, do not contradict)]:\n" + expositionContext : ""}${sessionSliceContext ? "\n\n" + sessionSliceContext : ""}`;
+${refPackExcerpt}${standardsContext ? "\n\n" + standardsContext : ""}${expositionContext ? "\n\n[KNOWLEDGE_EXPOSITION (CANONICAL KNOWLEDGE \u2014 teach from this, do not contradict)]:\n" + expositionContext : ""}${sessionSliceContext ? "\n\n" + sessionSliceContext : ""}`;
   const producedArtifacts = [];
   const lessonRelPath = `_content/${unitCode}/LESSON_${lessonCode}.md`;
   const existingLessonContent = await storage.readArtifact(projectId, lessonRelPath);
@@ -11471,7 +11919,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 }],
@@ -11570,14 +12020,15 @@ ${yamlBlock.trim()}
       const judgeResult = await LLMJudgeEngine.evaluateArtifactWithLLM({
         targetArtifactType: "LESSON",
         lessonId: lessonCode,
-        expectedLanguage: "en",
+        expectedLanguage: targetLang || "en",
         targetObjectives: judgeObjectives,
         generatedContentJson: JSON.stringify({
           lessonContent,
           lessonId: lessonCode,
           title: lessonTitle,
-          frameworkExcerpt: framework ? framework.slice(0, 2500) : void 0,
-          styleGuideExcerpt: styleGuide ? styleGuide.slice(0, 1500) : void 0
+          frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
+          styleGuideExcerpt: styleGuideExcerpt || void 0,
+          canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
         }),
         standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
       });
@@ -11642,14 +12093,15 @@ ${currentContent}` }],
           const reJudge = await LLMJudgeEngine.evaluateArtifactWithLLM({
             targetArtifactType: "LESSON",
             lessonId: lessonCode,
-            expectedLanguage: "en",
+            expectedLanguage: targetLang || "en",
             targetObjectives: parseLessonObjectives(currentContent, concept, bloomLevel),
             generatedContentJson: JSON.stringify({
               lessonContent: currentContent,
               lessonId: lessonCode,
               title: lessonTitle,
-              frameworkExcerpt: framework ? framework.slice(0, 2500) : void 0,
-              styleGuideExcerpt: styleGuide ? styleGuide.slice(0, 1500) : void 0
+              frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
+              styleGuideExcerpt: styleGuideExcerpt || void 0,
+              canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
             }),
             standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
           });
@@ -11770,10 +12222,34 @@ ${currentContent}` }],
       contentHash
     });
   }
+  const lessonExcerptResult = buildSectionAwareExcerpt(lessonContent, {
+    priorities: DEFAULT_LESSON_PRIORITIES,
+    budget: 12e3,
+    sectionLanguageContract: slcMarkdown,
+    artifactType: "LESSON"
+  });
+  const lessonExcerpt = lessonExcerptResult.excerpt;
   const satelliteContext = `${commonContext}
 
 [CANONICAL LESSON PLAN (${pedagogyLabel})]:
-${lessonContent.slice(0, 4e3)}`;
+${lessonExcerpt}`;
+  const judgeSat = (sat, content) => {
+    if (gateModeFor(gates, sat) !== "LLM_JUDGE") return Promise.resolve();
+    return judgeSatelliteArtifact({
+      storage,
+      projectId,
+      lessonCode,
+      sat,
+      content,
+      concept,
+      bloomLevel,
+      standardStatements,
+      onProgress,
+      targetLang,
+      canonicalLessonContent: lessonContent,
+      canonicalLessonExcerpt: lessonExcerpt
+    });
+  };
   const actRelPath = `_content/${unitCode}/ACT_${lessonCode}.md`;
   if (artifactScope.includes("ACT") && (!await storage.readArtifact(projectId, actRelPath) || force)) {
     onProgress?.("@activity", `[2/4] Authoring Hands-on Lab: \`ACT_${lessonCode}.md\`...`);
@@ -11812,7 +12288,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,
@@ -11838,19 +12318,7 @@ template_required_sections:
       contentHash: computeContentHash(rawAct)
     });
     producedArtifacts.push(`ACT_${lessonCode}.md`);
-    if (gateModeFor(gates, "ACT") === "LLM_JUDGE") {
-      await judgeSatelliteArtifact({
-        storage,
-        projectId,
-        lessonCode,
-        sat: "ACT",
-        content: rawAct,
-        concept,
-        bloomLevel,
-        standardStatements,
-        onProgress
-      });
-    }
+    await judgeSat("ACT", rawAct);
   }
   const quizRelPath = `_content/${unitCode}/QUIZ_${lessonCode}.md`;
   if (artifactScope.includes("QUIZ") && (!await storage.readArtifact(projectId, quizRelPath) || force)) {
@@ -11884,7 +12352,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,
@@ -11910,60 +12382,25 @@ template_required_sections:
       contentHash: computeContentHash(rawQuiz)
     });
     producedArtifacts.push(`QUIZ_${lessonCode}.md`);
-    if (gateModeFor(gates, "QUIZ") === "LLM_JUDGE") {
-      await judgeSatelliteArtifact({
-        storage,
-        projectId,
-        lessonCode,
-        sat: "QUIZ",
-        content: rawQuiz,
-        concept,
-        bloomLevel,
-        standardStatements,
-        onProgress
-      });
-    }
+    await judgeSat("QUIZ", rawQuiz);
   }
   const slideRelPath = `_content/${unitCode}/SLIDE_${lessonCode}.md`;
   if (artifactScope.includes("SLIDE") && (!await storage.readArtifact(projectId, slideRelPath) || force)) {
     onProgress?.("@illustrator", `[4/4] Authoring Presentation Slide Deck: \`SLIDE_${lessonCode}.md\`...`);
     const canonicalSlideTemplate = loadCurriculumTemplate("SLIDE_template.md");
-    const slidePrompt = `You are @illustrator & @content (Pedagogical Slide Deck Presentation Specialists).
-Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, lesson context, and the MARP SLIDE TEMPLATE below, author the complete, highly engaging Marp presentation deck: \`SLIDE_${lessonCode}.md\`.
-
-[MARP SLIDE TEMPLATE SCAFFOLD]:
-${canonicalSlideTemplate || `---
+    const templateScaffold = canonicalSlideTemplate || `---
 marp: true
 theme: default
 paginate: true
 header: "${titleHeader(lessonTitle)}"
 footer: "Curriculum OS \u2022 ${lessonCode} (${pedagogyLabel})"
----`}
-
-MANDATORY 12-14 SLIDE MICRO-CYCLE STRUCTURE (Delimited by '---'):
-1. **Slide 1 [Title & Mission]:** ${lessonCode}: ${lessonTitle} + Real-world inquiry hook
-2. **Slide 2 [Agenda & Roadmap]:** Timing and milestone breakdown table (${pedagogyLabel})
-3. **Slide 3 [Warm-Up / Prior Knowledge]:** 2-column recall + 60-second diagnostic challenge card
-4. **Slide 4 [High-Stakes Hook Scenario]:** Authentic engineering/domain crisis card + dilemma constraint
-5. **Slide 5 [Core Concept 1: Mental Model]:** Definition, intuitive everyday analogy, and golden rule card
-6. **Slide 6 [Architecture & Visual Flow]:** Clean Mermaid diagram (flowchart or sequenceDiagram) + 3 flow steps
-7. **Slide 7 [Core Concept 2: Syntax / Mechanism Anatomy]:** Side-by-side 6-10 lines runnable code + anatomy breakdown & syntax trap card
-8. **Slide 8 [Guided Practice: Try It Now]:** 3-minute active desk task card with starter hint and success criteria
-9. **Slide 9 [Integrated Hands-On Lab]:** 3-tier differentiated challenge cards (Bronze / Silver / Gold) + gotcha alert card
-10. **Slide 10 [Traffic Light Checkpoint & Pitfalls]:** Formative self-check cards (\u{1F7E2}/\u{1F7E1}/\u{1F534}) & diagnostic test question
-11. **Slide 11 [Exit Ticket & Metacognition]:** 2 scenario-based check questions + 1 metacognitive reflection prompt
-12. **Slide 12 [Summary & Next Steps]:** 3 core golden rules + preview card of next upcoming milestone
-
-Mandatory Canvas & Presentation Invariants:
-- A slide is an INTERACTIVE PROJECTION CANVAS, NOT a textbook! Absolutely NO dense paragraphs or walls of text.
-- Follow the 6x6 rule: Maximum 4-6 bullet points per slide, maximum 8-12 words per bullet.
-- Structure slides using \`<div class="columns"><div>...</div><div>...</div></div>\` and \`<div class="card">\`, \`<div class="card highlight">\`, \`<div class="card warning">\`, \`<div class="card success">\`.
-- MANDATORY PRESENTER NOTES ON EVERY SLIDE: Every slide MUST end with \`<!-- Presenter Notes: ... -->\` containing:
-  * SCRIPT: 60-90s teacher talk track with intuitive analogies.
-  * 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.`;
+---`;
+    const slidePrompt = buildMarpMarkdownSlidePrompt({
+      lessonCode,
+      templateScaffold,
+      languageDirective,
+      headingDirective: buildHeadingDirective("SLIDE", slcMarkdown, targetLang)
+    });
     const rawSlide = await runCurriculumAIInference(
       [{ role: "user", content: slidePrompt }],
       satelliteContext,
@@ -11989,19 +12426,7 @@ Mandatory Canvas & Presentation Invariants:
       contentHash: computeContentHash(rawSlide)
     });
     producedArtifacts.push(`SLIDE_${lessonCode}.md`);
-    if (gateModeFor(gates, "SLIDE") === "LLM_JUDGE") {
-      await judgeSatelliteArtifact({
-        storage,
-        projectId,
-        lessonCode,
-        sat: "SLIDE",
-        content: rawSlide,
-        concept,
-        bloomLevel,
-        standardStatements,
-        onProgress
-      });
-    }
+    await judgeSat("SLIDE", rawSlide);
   }
   const guideRelPath = `_content/${unitCode}/GUIDE_${lessonCode}.md`;
   if (artifactScope.includes("GUIDE") && (!await storage.readArtifact(projectId, guideRelPath) || force)) {
@@ -12030,7 +12455,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,
@@ -12047,19 +12476,7 @@ template_contract: "artifact-template-v1"
         contentHash: computeContentHash(rawGuide)
       });
       producedArtifacts.push(`GUIDE_${lessonCode}.md`);
-      if (gateModeFor(gates, "GUIDE") === "LLM_JUDGE") {
-        await judgeSatelliteArtifact({
-          storage,
-          projectId,
-          lessonCode,
-          sat: "GUIDE",
-          content: rawGuide,
-          concept,
-          bloomLevel,
-          standardStatements,
-          onProgress
-        });
-      }
+      await judgeSat("GUIDE", rawGuide);
     }
   }
   const handoutRelPath = `_content/${unitCode}/HANDOUT_${lessonCode}.md`;
@@ -12089,7 +12506,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,
@@ -12106,19 +12527,7 @@ template_contract: "artifact-template-v1"
         contentHash: computeContentHash(rawHandout)
       });
       producedArtifacts.push(`HANDOUT_${lessonCode}.md`);
-      if (gateModeFor(gates, "HANDOUT") === "LLM_JUDGE") {
-        await judgeSatelliteArtifact({
-          storage,
-          projectId,
-          lessonCode,
-          sat: "HANDOUT",
-          content: rawHandout,
-          concept,
-          bloomLevel,
-          standardStatements,
-          onProgress
-        });
-      }
+      await judgeSat("HANDOUT", rawHandout);
     }
   }
   const wksRelPath = `_content/${unitCode}/WKS_${lessonCode}.md`;
@@ -12152,7 +12561,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,
@@ -12169,19 +12582,7 @@ template_contract: "artifact-template-v1"
         contentHash: computeContentHash(rawWks)
       });
       producedArtifacts.push(`WKS_${lessonCode}.md`);
-      if (gateModeFor(gates, "WKS") === "LLM_JUDGE") {
-        await judgeSatelliteArtifact({
-          storage,
-          projectId,
-          lessonCode,
-          sat: "WKS",
-          content: rawWks,
-          concept,
-          bloomLevel,
-          standardStatements,
-          onProgress
-        });
-      }
+      await judgeSat("WKS", rawWks);
     }
   }
   const codeRelPath = `_content/${unitCode}/CODE_${lessonCode}.md`;
@@ -12219,7 +12620,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,
@@ -12241,19 +12646,7 @@ template_required_sections:
         contentHash: computeContentHash(rawCode)
       });
       producedArtifacts.push(`CODE_${lessonCode}.md`);
-      if (gateModeFor(gates, "CODE") === "LLM_JUDGE") {
-        await judgeSatelliteArtifact({
-          storage,
-          projectId,
-          lessonCode,
-          sat: "CODE",
-          content: rawCode,
-          concept,
-          bloomLevel,
-          standardStatements,
-          onProgress
-        });
-      }
+      await judgeSat("CODE", rawCode);
     }
   }
   const extRelPath = `_content/${unitCode}/EXT_${lessonCode}.md`;
@@ -12285,7 +12678,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,
@@ -12302,19 +12699,7 @@ template_contract: "artifact-template-v1"
         contentHash: computeContentHash(rawExt)
       });
       producedArtifacts.push(`EXT_${lessonCode}.md`);
-      if (gateModeFor(gates, "EXT") === "LLM_JUDGE") {
-        await judgeSatelliteArtifact({
-          storage,
-          projectId,
-          lessonCode,
-          sat: "EXT",
-          content: rawExt,
-          concept,
-          bloomLevel,
-          standardStatements,
-          onProgress
-        });
-      }
+      await judgeSat("EXT", rawExt);
     }
   }
   onProgress?.("@reviewer", `\u2705 Successfully authored all requested artifacts for \`${lessonCode}\` (${pedagogyLabel})!`);
@@ -12380,12 +12765,22 @@ async function judgeSatelliteArtifact(ctx) {
   const { storage, projectId, lessonCode, sat, content } = ctx;
   try {
     ctx.onProgress?.("@reviewer", `\u{1F916} Judging ${sat}_${lessonCode}...`);
+    const targetObjectives = parseLessonObjectives(
+      ctx.canonicalLessonContent || content,
+      ctx.concept,
+      ctx.bloomLevel
+    );
     const result = await LLMJudgeEngine.evaluateArtifactWithLLM({
       targetArtifactType: sat,
       lessonId: lessonCode,
-      expectedLanguage: "en",
-      targetObjectives: parseLessonObjectives(content, ctx.concept, ctx.bloomLevel),
-      generatedContentJson: JSON.stringify({ content, artifactType: sat, lessonId: lessonCode }),
+      expectedLanguage: ctx.targetLang || "en",
+      targetObjectives,
+      generatedContentJson: JSON.stringify({
+        content,
+        artifactType: sat,
+        lessonId: lessonCode,
+        canonicalLessonExcerpt: ctx.canonicalLessonExcerpt
+      }),
       standardStatements: Object.keys(ctx.standardStatements).length > 0 ? ctx.standardStatements : void 0
     });
     const passed = result.passed && result.score >= 85;
@@ -12508,6 +12903,87 @@ async function produceBatchLessons(storage, projectId, lessonIds, options = {})
 // src/services/singleArtifactService.ts
 init_streamRunner();
 init_errors();
+
+// src/services/contextRouting.ts
+init_errors();
+var ARTIFACT_DEPENDENCY_ROUTING = {
+  LESSON: {
+    required: ["KNOWLEDGE_EXPOSITION", "SESSION_SLICE", "FRAMEWORK_EXCERPT"],
+    optional: ["STYLE_GUIDE", "REFERENCE_PACK"],
+    rationale: "D\u1EA1y theo ki\u1EBFn th\u1EE9c chu\u1EA9n c\u1EE7a plan, ph\xE2n b\u1ED5 m\u1EE5c ti\xEAu v\xE0 khung ch\u01B0\u01A1ng tr\xECnh"
+  },
+  HANDOUT: {
+    required: ["KNOWLEDGE_EXPOSITION"],
+    optional: ["SESSION_SLICE"],
+    rationale: "T\xE0i li\u1EC7u t\u1EF1 h\u1ECDc \u2014 b\xE1m kh\xE1i ni\u1EC7m chu\u1EA9n, kh\xF4ng c\u1EA7n activity timeline"
+  },
+  EXT: {
+    required: ["KNOWLEDGE_EXPOSITION"],
+    optional: ["SESSION_SLICE"],
+    rationale: "Th\u1EED th\xE1ch m\u1EDF r\u1ED9ng chuy\xEAn s\xE2u b\xE1m kh\xE1i ni\u1EC7m"
+  },
+  CODE: {
+    required: ["KNOWLEDGE_EXPOSITION"],
+    optional: ["LESSON_OBJECTIVES"],
+    rationale: "Code lab th\u1EF1c h\xE0nh b\xE1m kh\xE1i ni\u1EC7m k\u1EF9 thu\u1EADt v\xE0 v\xED d\u1EE5 worked examples"
+  },
+  ACT: {
+    required: ["CANONICAL_LESSON"],
+    optional: ["KNOWLEDGE_EXPOSITION", "SESSION_SLICE"],
+    rationale: "STEM Activity Lab b\u1EAFt bu\u1ED9c ph\u1EA3i kh\u1EDBp 100% Activity Sequence v\xE0 Lesson Flow c\u1EE7a LESSON"
+  },
+  WKS: {
+    required: ["CANONICAL_LESSON"],
+    optional: ["KNOWLEDGE_EXPOSITION"],
+    rationale: "Phi\u1EBFu h\u1ECDc t\u1EADp (Worksheet) luy\u1EC7n t\u1EADp theo c\xE1c ch\u1EB7ng ho\u1EA1t \u0111\u1ED9ng c\u1EE7a gi\xE1o \xE1n"
+  },
+  GUIDE: {
+    required: ["CANONICAL_LESSON"],
+    optional: ["SESSION_SLICE"],
+    rationale: "K\u1ECBch b\u1EA3n s\u01B0 ph\u1EA1m gi\xE1o vi\xEAn (Teacher Guide) b\xE1m s\xE1t timeline t\u1EEBng ph\xFAt c\u1EE7a LESSON"
+  },
+  SLIDE: {
+    required: ["CANONICAL_LESSON"],
+    optional: ["KNOWLEDGE_EXPOSITION"],
+    rationale: "Slide b\xE0i gi\u1EA3ng tr\xECnh chi\u1EBFu theo c\u1EA5u tr\xFAc ph\xE2n ph\u1ED1i n\u1ED9i dung c\u1EE7a gi\xE1o \xE1n"
+  },
+  QUIZ: {
+    required: ["KNOWLEDGE_EXPOSITION", "CANONICAL_LESSON"],
+    optional: ["SESSION_SLICE"],
+    rationale: "Ng\xE2n h\xE0ng c\xE2u h\u1ECFi \u0111\xE1nh gi\xE1 c\u1EA3 ki\u1EBFn th\u1EE9c chu\u1EA9n m\u1EF1c (KX) l\u1EABn m\u1EE5c ti\xEAu b\xE0i d\u1EA1y (LESSON)"
+  }
+};
+function validateArtifactDependencies(artifactType, availableSources, opts = {}) {
+  const normType = (artifactType || "").toUpperCase().trim();
+  const rule = ARTIFACT_DEPENDENCY_ROUTING[normType];
+  const failClosed = opts.failClosed ?? true;
+  if (!rule) {
+    return { valid: true, missing: [] };
+  }
+  const missing = [];
+  for (const req of rule.required) {
+    const val = availableSources[req];
+    const isPresent = val !== void 0 && val !== null && (typeof val === "string" ? val.trim().length > 0 : true);
+    if (!isPresent) {
+      missing.push(req);
+    }
+  }
+  if (missing.length > 0) {
+    const err = createContextMissingError({
+      artifactType: normType,
+      missingSource: missing[0],
+      lessonId: opts.lessonId,
+      agent: opts.agent
+    });
+    if (failClosed) {
+      throw err;
+    }
+    return { valid: false, missing, error: err };
+  }
+  return { valid: true, missing: [] };
+}
+
+// src/services/singleArtifactService.ts
 function getArtifactMetadata(type, lessonId, pedagogy) {
   const id = lessonId || "ON_DEMAND";
   switch (type) {
@@ -12587,9 +13063,24 @@ async function generateSingleArtifact(req) {
   const templateContent = loadedTemplate || getDefaultFallbackTemplate(artifactType, displayTitle, lessonId || "ON_DEMAND");
   const hwStr = hardwarePlatform.join(", ");
   const selectedDevices = (config?.devices || (hardwarePlatform[0]?.toLowerCase().includes("paper") ? "paper-only" : "laptop")).toLowerCase();
-  const isBilingual = language.toLowerCase().includes("bilingual") || language.toLowerCase().includes("song");
-  const isVietnamese = !isBilingual && language.toLowerCase().includes("viet");
-  const langRule = isBilingual ? `1. AUTHORING LANGUAGE: Bilingual (Vietnamese - English). Headings and core conceptual definitions should be presented in Vietnamese with English technical terms in parentheses. Explanations and instructional text are in Vietnamese. Key code terms, comments, and challenge summaries are presented bilingually.` : isVietnamese ? `1. AUTHORING LANGUAGE: Vietnamese for all instructional text, explanations, questions, rubrics, and presenter notes. Programming code, syntax keywords, and standard API identifiers remain in standard English (with Vietnamese explanation comments/notes).` : `1. AUTHORING LANGUAGE: 100% English (Plan C Canonical Specification).`;
+  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 availableSources = {
+    KNOWLEDGE_EXPOSITION: contextSot.exposition || researchContext,
+    CANONICAL_LESSON: contextSot.lessonPlan,
+    FRAMEWORK_EXCERPT: contextSot.framework
+  };
+  validateArtifactDependencies(artifactType.toUpperCase(), availableSources, {
+    lessonId,
+    agent: meta.persona,
+    failClosed: req.failClosedContext ?? false
+  });
   const isPaperOnly = selectedDevices === "paper-only" || hwStr.toLowerCase().includes("paper") || hwStr.toLowerCase().includes("print-ready");
   const deviceRule = isPaperOnly ? `
 - \u{1F4C4} PAPER-ONLY / NO-DEVICE ENVIRONMENT: The learning space has NO computers or screens. All exercises, worksheets, task cards, exit tickets, and code analyses MUST be 100% printable. Provide write-in blank boxes, printed code snippets with line numbers, tracing tables, and physical manipulative instructions.` : selectedDevices === "tablet" || selectedDevices === "smartphone" ? `
@@ -12610,7 +13101,8 @@ async function generateSingleArtifact(req) {
 Your task is to author a canonical, publication-grade learning artifact of type "${artifactType.toUpperCase()}".
 
 ### CORE OPERATIONAL INVARIANTS:
-${langRule}
+${langDirective}
+${headingDirective}
 2. NON-MOCK CODE INVARIANT: Any code snippet provided MUST be 100% syntactically valid, idiomatic, and executable without placeholders or fake functions.
 3. PEDAGOGICAL GROUNDING: Strictly align with the ${pedagogy.toUpperCase()} model, Bloom's Revised Taxonomy, and IEEE/ACM CS2023 guidelines.
 4. SCAFFOLDING LEVEL: "${scaffoldingLevel.toUpperCase()}".${scaffoldingRule}
@@ -12619,6 +13111,11 @@ ${langRule}
 
 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 userPrompt = `### CONTEXT GROUND TRUTH:
 - Topic / Concept Domain: "${topic}"
 - Lesson ID: "${lessonId || "ON_DEMAND"}"
@@ -12636,14 +13133,17 @@ ${selectedDevices ? `- Device Mode: "${selectedDevices}"
 ${researchContext ? `### RESEARCH GROUND TRUTH (fact-checked context \u2014 \u01B0u ti\xEAn d\xF9ng, KH\xD4NG b\u1ECBa s\u1ED1 li\u1EC7u):
 ${researchContext.slice(0, 4e3)}
 ` : ""}
-${contextSot.framework ? `### SOT CURRICULUM FRAMEWORK:
-${contextSot.framework.slice(0, 1500)}
+${expositionExcerpt ? `### SOT KNOWLEDGE EXPOSITION (CANONICAL KNOWLEDGE \u2014 teach from this, do not contradict):
+${expositionExcerpt}
+` : ""}
+${frameworkExcerpt ? `### SOT CURRICULUM FRAMEWORK:
+${frameworkExcerpt}
 ` : ""}
-${contextSot.lessonPlan ? `### SOT CANONICAL LESSON PLAN:
-${contextSot.lessonPlan.slice(0, 1500)}
+${lessonPlanExcerpt ? `### SOT CANONICAL LESSON PLAN:
+${lessonPlanExcerpt}
 ` : ""}
-${contextSot.handout ? `### SOT STUDENT HANDOUT:
-${contextSot.handout.slice(0, 1e3)}
+${handoutExcerpt ? `### SOT STUDENT HANDOUT:
+${handoutExcerpt}
 ` : ""}
 
 ### MANDATORY CANONICAL TEMPLATE CONTRACT:
@@ -12732,9 +13232,16 @@ ${yaml.trim()}
       const verdict = await LLMJudgeEngine.evaluateArtifactWithLLM({
         targetArtifactType: artifactType.toUpperCase(),
         lessonId: lessonId || "ON_DEMAND",
-        expectedLanguage: language.toLowerCase().includes("viet") ? "vietnamese" : "english",
+        expectedLanguage: targetLang || "en",
         targetObjectives: judgeObjectives,
-        generatedContentJson: JSON.stringify({ content: finalContent, artifactType, lessonId: lessonId || "ON_DEMAND", title: displayTitle })
+        generatedContentJson: JSON.stringify({
+          content: finalContent,
+          artifactType,
+          lessonId: lessonId || "ON_DEMAND",
+          title: displayTitle,
+          canonicalLessonExcerpt: lessonPlanExcerpt || void 0,
+          canonicalExposition: expositionExcerpt || void 0
+        })
       });
       const passed = Boolean(verdict.passed) && verdict.score >= 85;
       if (passed) {
@@ -12776,9 +13283,16 @@ ${finalContent}` }
         const reVerdict = await LLMJudgeEngine.evaluateArtifactWithLLM({
           targetArtifactType: artifactType.toUpperCase(),
           lessonId: lessonId || "ON_DEMAND",
-          expectedLanguage: language.toLowerCase().includes("viet") ? "vietnamese" : "english",
+          expectedLanguage: targetLang || "en",
           targetObjectives: judgeObjectives,
-          generatedContentJson: JSON.stringify({ content: repaired, artifactType, lessonId: lessonId || "ON_DEMAND", title: displayTitle })
+          generatedContentJson: JSON.stringify({
+            content: repaired,
+            artifactType,
+            lessonId: lessonId || "ON_DEMAND",
+            title: displayTitle,
+            canonicalLessonExcerpt: lessonPlanExcerpt || void 0,
+            canonicalExposition: expositionExcerpt || void 0
+          })
         });
         if (reVerdict.passed && reVerdict.score >= 85) {
           return {
@@ -16730,6 +17244,7 @@ function renderMediaPlaceholder(entry) {
 }
 
 exports.ACT_TEMPLATE = ACT_TEMPLATE;
+exports.ARTIFACT_DEPENDENCY_ROUTING = ARTIFACT_DEPENDENCY_ROUTING;
 exports.ARTIFACT_EXECUTION_ORDER = ARTIFACT_EXECUTION_ORDER;
 exports.AcademicAuditor = AcademicAuditor;
 exports.ActiveLearningWorkflowSchema = ActiveLearningWorkflowSchema;
@@ -16774,6 +17289,8 @@ exports.CurriculumPlanSchema = CurriculumPlanSchema;
 exports.CurriculumQualityReportSchema = CurriculumQualityReportSchema;
 exports.DEFAULT_ENABLED_PROVIDERS = DEFAULT_ENABLED_PROVIDERS;
 exports.DEFAULT_GATE_SETTINGS = DEFAULT_GATE_SETTINGS;
+exports.DEFAULT_KX_PRIORITIES = DEFAULT_KX_PRIORITIES;
+exports.DEFAULT_LESSON_PRIORITIES = DEFAULT_LESSON_PRIORITIES;
 exports.DEFAULT_STREAM_IDLE_MS = DEFAULT_STREAM_IDLE_MS;
 exports.DEFAULT_STREAM_TOTAL_MS = DEFAULT_STREAM_TOTAL_MS;
 exports.DependencyEdgeSchema = DependencyEdgeSchema;
@@ -16873,6 +17390,7 @@ exports.RubricCriteriaSchema = RubricCriteriaSchema;
 exports.RubricSchema = RubricSchema;
 exports.SCIENCE_LAB_TEMPLATE = SCIENCE_LAB_TEMPLATE;
 exports.SELF_LAB_TEMPLATE = SELF_LAB_TEMPLATE;
+exports.SLIDE_CANONICAL_METHODOLOGY = SLIDE_CANONICAL_METHODOLOGY;
 exports.SLIDE_LAYOUT_PRESETS = SLIDE_LAYOUT_PRESETS;
 exports.SLIDE_TEMPLATE = SLIDE_TEMPLATE;
 exports.STANDARD_SOT_FILES = STANDARD_SOT_FILES;
@@ -16927,12 +17445,18 @@ exports.buildCurriculumPlan = buildCurriculumPlan;
 exports.buildDeliveryPackages = buildDeliveryPackages;
 exports.buildDiagnosticQuizPrompt = buildDiagnosticQuizPrompt;
 exports.buildExpositionContext = buildExpositionContext;
+exports.buildExpositionExcerpt = buildExpositionExcerpt;
 exports.buildExtensionPrompt = buildExtensionPrompt;
 exports.buildHandoutPrompt = buildHandoutPrompt;
+exports.buildHeadingDirective = buildHeadingDirective;
 exports.buildImagePrompt = buildImagePrompt;
 exports.buildJudgePrompt = buildJudgePrompt;
+exports.buildLanguageDirective = buildLanguageDirective;
+exports.buildLessonExcerpt = buildLessonExcerpt;
 exports.buildLessonMasterPrompt = buildLessonMasterPrompt;
+exports.buildMarpMarkdownSlidePrompt = buildMarpMarkdownSlidePrompt;
 exports.buildProjectInstructionPrompt = buildProjectInstructionPrompt;
+exports.buildSectionAwareExcerpt = buildSectionAwareExcerpt;
 exports.buildSelfLabPrompt = buildSelfLabPrompt;
 exports.buildSessionSliceContext = buildSessionSliceContext;
 exports.buildSlidesPrompt = buildSlidesPrompt;
@@ -16948,6 +17472,7 @@ exports.conductPreliminaryResearch = conductPreliminaryResearch;
 exports.contentTools = contentTools;
 exports.convertRoadmapToFoundationSot = convertRoadmapToFoundationSot;
 exports.createAiInferenceError = createAiInferenceError;
+exports.createContextMissingError = createContextMissingError;
 exports.createCurriculumStorage = createCurriculumStorage;
 exports.createIdleAbortController = createIdleAbortController;
 exports.createStreamAbortController = createStreamAbortController;
@@ -16963,6 +17488,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;
@@ -17014,6 +17540,7 @@ exports.lintFrameworkPack = lintFrameworkPack;
 exports.loadCurriculumTemplate = loadCurriculumTemplate;
 exports.loadSotTemplate = loadSotTemplate;
 exports.normalizePlanningGraph = normalizePlanningGraph;
+exports.normalizeSlcContract = normalizeSlcContract;
 exports.packagerTools = packagerTools;
 exports.parseGateSettings = parseGateSettings;
 exports.parseQuizMarkdown = parseQuizMarkdown;
@@ -17029,6 +17556,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;
@@ -17052,9 +17580,11 @@ exports.streamLayerPrefillWithFallback = streamLayerPrefillWithFallback;
 exports.streamLessonMasterFlow = streamLessonMasterFlow;
 exports.streamSelfLabFlow = streamSelfLabFlow;
 exports.stripLlmJsonWrappers = stripLlmJsonWrappers;
+exports.targetLanguageDisplayName = targetLanguageDisplayName;
 exports.techSmeTools = techSmeTools;
 exports.topoSort = topoSort;
 exports.uploadAssetToBucket = uploadAssetToBucket;
+exports.validateArtifactDependencies = validateArtifactDependencies;
 exports.validateCurriculumPlan = validateCurriculumPlan;
 exports.validateFrameworkPack = validateFrameworkPack;
 exports.validateMarkdownTables = validateMarkdownTables;