@thanh01.pmt/curriculum-kit 1.1.0 → 1.2.1

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"() {
@@ -5379,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) {
@@ -5518,13 +5571,13 @@ Evaluate the candidate artifact across these 6 dimensions:
    - 0 pts: Missing critical sections.
 
 5. **Technical & Conceptual Accuracy (15 pts):**
-   - 15 pts: Code snippets, logic flows, architectural descriptions, and Mermaid diagrams are conceptually sound, valid, and free of syntax hallucinations.
+   - 15 pts: Code snippets, logic flows, architectural descriptions, and Mermaid diagrams are conceptually sound and valid. If \`canonicalExposition\` or \`[KNOWLEDGE_EXPOSITION]\` is provided, content strictly adheres to canonical concepts without contradicting definitions or examples.
    - 8 pts: Minor syntax inaccuracies or unidiomatic code that does not break core concepts.
-   - 0 pts: Severe technical hallucinations, broken logic, or invalid diagrams.
+   - 0 pts: Severe technical hallucinations, broken logic, invalid diagrams, or direct contradiction of canonical exposition knowledge.
 
 6. **Contract Consistency & Zero-Drift (10 pts):**
-   - 10 pts: Satellite artifact strictly adheres to the scope, tech stack, and objectives of Lesson ${lessonId} without introducing unrelated topics.
-   - 0-5 pts: Scope drift or topic divergence detected.
+   - 10 pts: Satellite artifact strictly adheres to the scope, tech stack, and objectives of Lesson ${lessonId} without introducing unrelated topics. If \`canonicalLessonExcerpt\` is present in candidate JSON, all satellite phases/activities strictly operationalize the master Lesson Flow and Activity Sequence without inventing divergent timelines.
+   - 0-5 pts: Scope drift, topic divergence, or disjoint activity sequence detected compared to master lesson.
 
 ## VERDICT RULES
 - **PASS:** Score >= 80 AND Language Adherence = true AND Standards Alignment >= 12 (when STANDARDS GROUND TRUTH is present).
@@ -9711,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) {
@@ -9817,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);
@@ -11113,9 +11377,19 @@ function buildLanguageDirective(targetLanguage) {
 - DO NOT mix in paragraphs, tables, or titles written in any other language. Strict adherence is required.${exampleLine ? `
 ${exampleLine}` : ""}`;
 }
-function extractSectionHeadingsFromSLC(slcMarkdown, artifactType) {
-  if (!slcMarkdown) return {};
+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_]+)/);
@@ -11598,7 +11872,50 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   }
   const pedagogy = detectProjectPedagogy(framework, styleGuide, options.pedagogy);
   const pedagogyLabel = pedagogy.toUpperCase();
-  const commonContext = `PROJECT & ACADEMIC CONTEXT:
+  let glossaryContext = "";
+  try {
+    const glossaryRaw = await storage.readArtifact(projectId, "_sot/GLOSSARY.json");
+    if (glossaryRaw) {
+      let allTerms = [];
+      try {
+        allTerms = JSON.parse(glossaryRaw).terms ?? [];
+      } catch {
+      }
+      let scopedTermsSet = null;
+      const planRaw = await storage.readArtifact(projectId, "_sot/CURRICULUM_PLAN.json");
+      if (planRaw) {
+        try {
+          const plan = JSON.parse(planRaw);
+          const sessionScope = plan.glossary_scope?.find((g) => g.session_id === lessonCode);
+          if (sessionScope?.terms?.length) {
+            scopedTermsSet = new Set(sessionScope.terms.map((t) => t.toLowerCase()));
+          }
+        } catch {
+        }
+      }
+      const relevantTerms = scopedTermsSet ? allTerms.filter((g) => scopedTermsSet.has(g.term.toLowerCase())) : allTerms.slice(0, 10);
+      if (relevantTerms.length > 0) {
+        const lines = relevantTerms.map(
+          (t) => `- **${t.term}**: ${t.definition || ""}${t.example ? ` (e.g. \`${t.example}\`)` : ""}`
+        );
+        glossaryContext = buildSectionAwareExcerpt(lines.join("\n"), { budget: 800 }).excerpt;
+      }
+    }
+  } catch {
+  }
+  let effectiveStyleGuide = styleGuide ? buildSectionAwareExcerpt(styleGuide, {
+    priorities: ["Voice & Tone", "Standard Terminology (Glossary)", "Lesson Content Standards"],
+    budget: 2e3
+  }).excerpt : "";
+  let effectiveRefPack = 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 baseContextPrefix = `PROJECT & ACADEMIC CONTEXT:
 - Project ID: ${projectId}
 - Pedagogical Model: ${pedagogyLabel}
 - Lesson Code: ${lessonCode}
@@ -11608,13 +11925,51 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
 - Target Bloom Level: ${bloomLevel}
 
 [CURRICULUM FRAMEWORK EXCERPT]:
-${buildFrameworkExcerptForLesson(framework, lessonId)}
+${buildFrameworkExcerptForLesson(framework, lessonId)}`;
+  const glossaryBlock = glossaryContext ? `
+
+[GLOSSARY TERMS (use these exact definitions)]:
+${glossaryContext}` : "";
+  const standardsBlock = standardsContext ? `
+
+${standardsContext}` : "";
+  const expositionBlock = expositionContext ? `
+
+[KNOWLEDGE_EXPOSITION (CANONICAL KNOWLEDGE \u2014 teach from this, do not contradict)]:
+${expositionContext}` : "";
+  const sessionSliceBlock = sessionSliceContext ? `
+
+${sessionSliceContext}` : "";
+  const assembleCommonContext = (ref, sg) => `${baseContextPrefix}
 
 [CONTENT STYLE GUIDE EXCERPT]:
-${styleGuide.slice(0, 1500)}
+${sg}
 
 [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 : ""}`;
+${ref}${standardsBlock}${glossaryBlock}${expositionBlock}${sessionSliceBlock}`;
+  let commonContext = assembleCommonContext(effectiveRefPack, effectiveStyleGuide);
+  const MAX_COMPOSITE_PROMPT_CHARS = 3e4;
+  if (commonContext.length > MAX_COMPOSITE_PROMPT_CHARS && effectiveRefPack.length > 1e3) {
+    effectiveRefPack = buildSectionAwareExcerpt(refPack, {
+      priorities: [
+        "Technical Overview & Architecture Blueprint",
+        "Hardware Pinout & Wiring Configuration Matrix"
+      ],
+      budget: 1e3
+    }).excerpt;
+    commonContext = assembleCommonContext(effectiveRefPack, effectiveStyleGuide);
+  }
+  if (commonContext.length > MAX_COMPOSITE_PROMPT_CHARS && effectiveStyleGuide.length > 1e3) {
+    effectiveStyleGuide = buildSectionAwareExcerpt(styleGuide, {
+      priorities: ["Voice & Tone", "Standard Terminology (Glossary)"],
+      budget: 1e3
+    }).excerpt;
+    commonContext = assembleCommonContext(effectiveRefPack, effectiveStyleGuide);
+  }
+  onProgress?.("@content", `[CONTEXT] Composite prompt ready (${commonContext.length} chars, adaptive budget <= ${MAX_COMPOSITE_PROMPT_CHARS})`, {
+    type: "progress",
+    promptChars: commonContext.length
+  });
   const producedArtifacts = [];
   const lessonRelPath = `_content/${unitCode}/LESSON_${lessonCode}.md`;
   const existingLessonContent = await storage.readArtifact(projectId, lessonRelPath);
@@ -11734,14 +12089,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: effectiveStyleGuide || void 0,
+          canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
         }),
         standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
       });
@@ -11783,7 +12139,7 @@ ${yamlBlock.trim()}
           onProgress?.("@repair", `\u{1F527} Repair round ${round}/${MAX_REPAIR_ROUNDS} for LESSON_${lessonCode} (judge score ${currentResult.score}/100)...`);
           const repairedRaw = await runCurriculumAIInference(
             [{ role: "user", content: `You previously authored \`LESSON_${lessonCode}.md\` and the academic Judge REJECTED it with the critique below.
-Rewrite the COMPLETE corrected document: fix every listed issue, keep the mandatory structure, frontmatter and all approved sections. Output 100% clean Markdown only.
+Rewrite the COMPLETE corrected document in language "${targetLang}": fix every listed issue, preserve exact frontmatter and mandatory sections (Objectives, Activity Sequence, Lesson Flow). Output 100% clean Markdown only.
 
 JUDGE CRITIQUE:
 ${repairFeedback}
@@ -11801,19 +12157,26 @@ ${currentContent}` }],
             break;
           }
           const repairLint = lintAndSanitizeArtifact(repairedRaw, `LESSON_${lessonCode}.md`);
-          currentContent = repairLint.autoFixedContent || repairedRaw;
+          const candidateContent = repairLint.autoFixedContent || repairedRaw;
+          const hasFrontmatter = /^---\s*\r?\n[\s\S]*?\r?\n---/m.test(candidateContent);
+          if (!hasFrontmatter || candidateContent.length < Math.min(800, currentContent.length * 0.4)) {
+            onProgress?.("@repair", `\u26A0\uFE0F Repair round ${round} dropped critical structure (length or frontmatter missing) \u2014 rejecting repaired draft, retaining previous`);
+            break;
+          }
+          currentContent = candidateContent;
           onProgress?.("@reviewer", `\u{1F916} Re-judging repaired LESSON_${lessonCode} (round ${round})...`);
           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: effectiveStyleGuide || void 0,
+              canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
             }),
             standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
           });
@@ -11934,10 +12297,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\`...`);
@@ -12006,19 +12393,7 @@ ${buildHeadingDirective("ACT", slcMarkdown, targetLang)}`;
       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)) {
@@ -12082,64 +12457,25 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
       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.
-
-${languageDirective}
-
-${buildHeadingDirective("SLIDE", slcMarkdown, targetLang)}`;
+---`;
+    const slidePrompt = buildMarpMarkdownSlidePrompt({
+      lessonCode,
+      templateScaffold,
+      languageDirective,
+      headingDirective: buildHeadingDirective("SLIDE", slcMarkdown, targetLang)
+    });
     const rawSlide = await runCurriculumAIInference(
       [{ role: "user", content: slidePrompt }],
       satelliteContext,
@@ -12165,19 +12501,7 @@ ${buildHeadingDirective("SLIDE", slcMarkdown, targetLang)}`;
       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)) {
@@ -12227,19 +12551,7 @@ ${buildHeadingDirective("GUIDE", slcMarkdown, targetLang)}`;
         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`;
@@ -12290,19 +12602,7 @@ ${buildHeadingDirective("HANDOUT", slcMarkdown, targetLang)}`;
         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`;
@@ -12357,19 +12657,7 @@ ${buildHeadingDirective("WKS", slcMarkdown, targetLang)}`;
         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`;
@@ -12433,19 +12721,7 @@ ${buildHeadingDirective("CODE", slcMarkdown, targetLang)}`;
         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`;
@@ -12498,19 +12774,7 @@ ${buildHeadingDirective("EXT", slcMarkdown, targetLang)}`;
         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})!`);
@@ -12576,12 +12840,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;
@@ -12704,6 +12978,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) {
@@ -12783,9 +13138,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" ? `
@@ -12806,7 +13176,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}
@@ -12815,6 +13186,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"}"
@@ -12832,14 +13208,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}
 ` : ""}
-${contextSot.lessonPlan ? `### SOT CANONICAL LESSON PLAN:
-${contextSot.lessonPlan.slice(0, 1500)}
+${frameworkExcerpt ? `### SOT CURRICULUM FRAMEWORK:
+${frameworkExcerpt}
 ` : ""}
-${contextSot.handout ? `### SOT STUDENT HANDOUT:
-${contextSot.handout.slice(0, 1e3)}
+${lessonPlanExcerpt ? `### SOT CANONICAL LESSON PLAN:
+${lessonPlanExcerpt}
+` : ""}
+${handoutExcerpt ? `### SOT STUDENT HANDOUT:
+${handoutExcerpt}
 ` : ""}
 
 ### MANDATORY CANONICAL TEMPLATE CONTRACT:
@@ -12928,9 +13307,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) {
@@ -12972,9 +13358,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 {
@@ -16926,6 +17319,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;
@@ -16970,6 +17364,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;
@@ -17069,6 +17465,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;
@@ -17123,14 +17520,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;
@@ -17146,6 +17547,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;
@@ -17213,6 +17615,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;
@@ -17256,6 +17659,7 @@ exports.targetLanguageDisplayName = targetLanguageDisplayName;
 exports.techSmeTools = techSmeTools;
 exports.topoSort = topoSort;
 exports.uploadAssetToBucket = uploadAssetToBucket;
+exports.validateArtifactDependencies = validateArtifactDependencies;
 exports.validateCurriculumPlan = validateCurriculumPlan;
 exports.validateFrameworkPack = validateFrameworkPack;
 exports.validateMarkdownTables = validateMarkdownTables;