@thanh01.pmt/curriculum-kit 1.4.20 → 1.4.22

package/dist/index.cjs

@@ -1513,7 +1513,8 @@ function buildSlideBatchPrompt(params) {
     skillPrompt,
     language = "Vietnamese",
     languageDirective = "",
-    headingDirective = ""
+    headingDirective = "",
+    groundContext = ""
   } = params;
   const slidesSpec = clusterSlides.map((s) => `
 - Slide ${s.slideIndex} [Phase: ${s.lessonPhase}] -> Layout: "${s.layoutId}"
@@ -1526,7 +1527,11 @@ function buildSlideBatchPrompt(params) {
   const systemPrompt = `
 ${skillPrompt}
 
----
+${groundContext ? `---
+### PROJECT GROUND CONTEXT (framework, style guide, glossary, canonical knowledge \u2014 author from these):
+${groundContext}
+
+---` : ""}
 ### OPERATIONAL GROUND RULES FOR CHUNK GENERATION:
 ${languageDirective}
 ${headingDirective}
@@ -1604,6 +1609,7 @@ __export(slideProductionWorkflow_exports, {
   HybridPipelineError: () => exports.HybridPipelineError,
   SlideBlueprintArraySchema: () => exports.SlideBlueprintArraySchema,
   SlideBlueprintItemSchema: () => exports.SlideBlueprintItemSchema,
+  emitUsage: () => emitUsage,
   executeSlideProductionWorkflow: () => executeSlideProductionWorkflow,
   extractJsonArray: () => extractJsonArray,
   validateHybridDeckSlides: () => validateHybridDeckSlides
@@ -1656,15 +1662,28 @@ function validateHybridDeckSlides(slides, blueprint) {
   });
   return v.slice(0, 10);
 }
+function emitUsage(usage, onProgress) {
+  if (!onProgress || !usage) return;
+  const promptTokens = usage.promptTokens ?? usage.inputTokens ?? 0;
+  const completionTokens = usage.completionTokens ?? usage.outputTokens ?? 0;
+  if (promptTokens === 0 && completionTokens === 0) return;
+  onProgress("@illustrator", JSON.stringify({
+    promptTokens,
+    completionTokens,
+    totalTokens: usage.totalTokens ?? promptTokens + completionTokens,
+    reasoningTokens: usage.reasoningTokens ?? 0
+  }), { type: "usage" });
+}
 async function inferTextJson(schema, systemPrompt, userPrompt, options, label) {
   const model = getAIModel(options.modelOptions);
   try {
-    const { text, finishReason } = await ai.generateText({
+    const { text, finishReason, usage } = await ai.generateText({
       model,
       system: systemPrompt || void 0,
       prompt: userPrompt,
       maxOutputTokens: options.maxOutputTokens ?? 65536
     });
+    emitUsage(usage, options.onProgress);
     const extracted = extractJsonArray(text);
     if (!("value" in extracted) || extracted.value === void 0) {
       console.warn(
@@ -1685,12 +1704,13 @@ async function inferTextJson(schema, systemPrompt, userPrompt, options, label) {
 async function inferStructured(schema, systemPrompt, userPrompt, options, label) {
   try {
     const model = getAIModel(options.modelOptions);
-    const { object } = await ai.generateObject({
+    const { object, usage } = await ai.generateObject({
       model,
       schema,
       system: systemPrompt || void 0,
       prompt: userPrompt
     });
+    emitUsage(usage, options.onProgress);
     const validated = schema.safeParse(object);
     if (validated.success) return validated.data;
     console.warn(
@@ -1705,7 +1725,9 @@ async function inferStructured(schema, systemPrompt, userPrompt, options, label)
     const messages = [
       { role: "user", content: [systemPrompt, userPrompt].filter(Boolean).join("\n\n") }
     ];
-    const raw = await runCurriculumAIInference(messages, options.satelliteContext || "", options.runnerOptions);
+    const raw = await runCurriculumAIInference(messages, options.satelliteContext || "", options.runnerOptions, (token, type) => {
+      if (type === "usage") options.onProgress?.("@illustrator", token, { type: "usage" });
+    });
     const fenceMatch = raw.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
     const candidate = (fenceMatch ? fenceMatch[1] : raw).trim();
     let parsed;
@@ -1738,7 +1760,7 @@ function normalizeBlueprintItems(items) {
   }));
 }
 function buildHybridDeckPrompts(params) {
-  const { lessonFlow, blueprint, skillPrompt, language, languageDirective, headingDirective } = params;
+  const { lessonFlow, blueprint, skillPrompt, language, languageDirective, headingDirective, groundContext } = params;
   const blueprintText = JSON.stringify(
     blueprint.map((s) => ({
       slideIndex: s.slideIndex,
@@ -1757,6 +1779,7 @@ function buildHybridDeckPrompts(params) {
 ${p.content}`).join("\n\n") : lessonFlow.rawContent;
   const systemPrompt = [
     skillPrompt,
+    groundContext || "",
     languageDirective,
     headingDirective,
     `
@@ -1821,7 +1844,8 @@ async function runHybridPipeline(ctx) {
     skillPrompt,
     language,
     languageDirective,
-    headingDirective
+    headingDirective,
+    groundContext: options.groundContext
   });
   let slides = null;
   let lastViolations = [];
@@ -1970,7 +1994,8 @@ ${p.content}`).join("\n\n") : lessonFlow.rawContent.slice(0, 3500);
         skillPrompt,
         language,
         languageDirective,
-        headingDirective
+        headingDirective,
+        groundContext: options.groundContext
       });
       try {
         const batchSlides = await pRetry__default.default(
@@ -9312,6 +9337,21 @@ var STANDARD_SOT_FILES = [
   "ART_DIRECTION.md",
   "ALIGNMENT_MATRIX.md"
 ];
+function atomicWriteFileSync(targetPath, content) {
+  const dir = path3__default.default.dirname(targetPath);
+  if (!fs2__default.default.existsSync(dir)) fs2__default.default.mkdirSync(dir, { recursive: true });
+  const tmpPath = path3__default.default.join(dir, `.${path3__default.default.basename(targetPath)}.${process.pid}.${Date.now()}.${crypto__default.default.randomBytes(4).toString("hex")}.tmp`);
+  try {
+    fs2__default.default.writeFileSync(tmpPath, content, "utf-8");
+    fs2__default.default.renameSync(tmpPath, targetPath);
+  } catch (err) {
+    try {
+      if (fs2__default.default.existsSync(tmpPath)) fs2__default.default.unlinkSync(tmpPath);
+    } catch {
+    }
+    throw err;
+  }
+}
 var FileSystemCurriculumAdapter = class {
   baseDir;
   constructor(options = {}) {
@@ -9450,7 +9490,7 @@ var FileSystemCurriculumAdapter = class {
         if (oldContent !== content) {
           const historyDir = path3__default.default.join(projectDir, ".history", relPath);
           fs2__default.default.mkdirSync(historyDir, { recursive: true });
-          fs2__default.default.writeFileSync(path3__default.default.join(historyDir, `${Date.now()}.md`), oldContent, "utf-8");
+          atomicWriteFileSync(path3__default.default.join(historyDir, `${Date.now()}.md`), oldContent);
           const versions = fs2__default.default.readdirSync(historyDir).filter((f) => f.endsWith(".md")).sort();
           while (versions.length > 10) {
             fs2__default.default.unlinkSync(path3__default.default.join(historyDir, versions.shift()));
@@ -9460,19 +9500,15 @@ var FileSystemCurriculumAdapter = class {
         console.warn("[FileSystemCurriculumAdapter] version history snapshot failed:", histErr?.message || histErr);
       }
     }
-    fs2__default.default.writeFileSync(targetPath, content, "utf-8");
+    atomicWriteFileSync(targetPath, content);
     const filename = path3__default.default.basename(relPath);
     const match = filename.match(/(LESSON|ACT|QUIZ|SLIDE|GUIDE|HANDOUT|WKS|EXT)_(U\d+_M\d+_L\d+)\.md/i);
     if (match) {
       const lessonId = match[2].toUpperCase();
-      const lessonsDir = path3__default.default.join(projectDir, "lessons", lessonId);
-      if (!fs2__default.default.existsSync(lessonsDir)) {
-        fs2__default.default.mkdirSync(lessonsDir, { recursive: true });
-      }
-      fs2__default.default.writeFileSync(path3__default.default.join(lessonsDir, filename), content, "utf-8");
+      atomicWriteFileSync(path3__default.default.join(projectDir, "lessons", lessonId, filename), content);
       const legacyContentDir = path3__default.default.join(projectDir, "_content", lessonId);
       if (fs2__default.default.existsSync(legacyContentDir)) {
-        fs2__default.default.writeFileSync(path3__default.default.join(legacyContentDir, filename), content, "utf-8");
+        atomicWriteFileSync(path3__default.default.join(legacyContentDir, filename), content);
       }
     }
   }
@@ -9563,7 +9599,7 @@ ${lessonTable}
     }
     const stateFile = path3__default.default.join(pipelineDir, "state.json");
     state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    fs2__default.default.writeFileSync(stateFile, JSON.stringify(state, null, 2), "utf-8");
+    atomicWriteFileSync(stateFile, JSON.stringify(state, null, 2));
   }
   async updateArtifactState(projectId, taskId, artifactType, update) {
     const current = await this.getPipelineState(projectId);
@@ -11263,6 +11299,13 @@ var DEFAULT_LESSON_PRIORITIES = [
   "Learning Objectives & Evidence",
   "Activity Sequence"
 ];
+var SATELLITE_LESSON_PRIORITIES = [
+  "Artifact Contract",
+  "A. Lesson Design Plan",
+  "B. Lesson Flow",
+  "Learning Objectives & Evidence",
+  "Activity Sequence"
+];
 var DEFAULT_KX_PRIORITIES = [
   "Key Terms",
   "Concept Narratives",
@@ -11476,6 +11519,21 @@ 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("toolchain") || norm.includes("moi truong phat trien") || norm.includes("cong cu") || norm.includes("version") || norm.includes("phan mem") || norm.includes("development environment") || norm.includes("technical overview") || norm.includes("kien truc")) {
+    return "Technical Overview & Architecture Blueprint";
+  }
+  if (norm.includes("pinout") || norm.includes("phan cung") || norm.includes("hardware") || norm.includes("wiring") || norm.includes("ket noi")) {
+    return "Hardware Pinout & Wiring Configuration Matrix";
+  }
+  if (norm.includes("pedagog") || norm.includes("phuong phap") || norm.includes("day hoc") || norm.includes("su pham")) {
+    return "Core Pedagogical Concept Anchor & Real-World Domain Bridge";
+  }
+  if (norm.includes("standard") || norm.includes("tieu chuan") || norm.includes("csta") || norm.includes("cs2023") || norm.includes("chuan academic")) {
+    return "Standards Alignment";
+  }
+  if (norm.includes("roadmap") || norm.includes("lo trinh") || norm.includes("milestone") || norm.includes("giai doan")) {
+    return void 0;
+  }
   if (norm.includes("symbol") || norm.includes("identifier ledger") || norm.includes("dinh danh")) {
     return "Symbol & Identifier Ledger";
   }
@@ -11612,7 +11670,7 @@ function buildSystemPrompt(targetLanguage = "vi", techStack, hardwarePlatform) {
     langDirective
   ].join("\n");
 }
-function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMarkdown) {
+function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMarkdown, refPack) {
   const depthLines = session.depth_assignments.map((d) => "- " + d.node_id + " [" + d.depth.toUpperCase() + "]: " + DEPTH_RULES[d.depth]).join("\n");
   const termLines = glossary.map((g) => "- " + g.term + (g.definition ? " \u2014 " + g.definition : "") + (g.example ? " (example: " + g.example + ")" : "")).join("\n");
   const langCode = resolveTargetLanguageCode(targetLanguage);
@@ -11625,6 +11683,28 @@ function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMark
   const hQuestions = headings["Self-Check Questions"] || (langCode === "vi" ? "C\xE2u h\u1ECFi T\u1EF1 ki\u1EC3m tra" : "Self-Check Questions");
   const skeleton = `## ${hScope} / ## ${hTerms} / ## ${hNarratives} / ## ${hExamples} / ## ${hMistakes} / ## ${hQuestions}`;
   const headingDirective = buildHeadingDirective("KNOWLEDGE_EXPOSITION", slcMarkdown, targetLanguage);
+  let refPackBlock = "";
+  if (refPack && refPack.trim()) {
+    const refExcerpt = buildSectionAwareExcerpt(refPack, {
+      priorities: [
+        "Technical Overview & Architecture Blueprint",
+        "Hardware Pinout & Wiring Configuration Matrix",
+        "Standards Alignment"
+      ],
+      budget: 2500
+    }).excerpt;
+    if (refExcerpt) {
+      refPackBlock = [
+        "",
+        "[GROUND TRUTH \u2014 BINDING, from REFERENCE_PACK.md]:",
+        "Tool versions, APIs, and platform facts below are CANONICAL. Do NOT",
+        "contradict them; do NOT substitute versions from memory. If a fact you",
+        "need is not stated here, stay generic rather than inventing specifics.",
+        "",
+        refExcerpt
+      ].join("\n");
+    }
+  }
   return [
     "Session: " + session.id + " \u2014 " + session.title,
     "Objective: " + session.prose_objective,
@@ -11637,6 +11717,7 @@ function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMark
     "",
     "Glossary terms (definitions are canonical):",
     termLines || "(none provided \u2014 write definitions and mark them for glossary sync)",
+    refPackBlock,
     "",
     "Section skeleton to fill (replace ONLY the {{placeholders}}):",
     skeleton,
@@ -11645,7 +11726,7 @@ function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMark
   ].filter(Boolean).join("\n");
 }
 async function ensureKnowledgeExposition(options) {
-  const { projectId, lessonCode, plan, glossary, llmFn, storage, techStack, hardwarePlatform } = options;
+  const { projectId, lessonCode, plan, glossary, llmFn, storage, techStack, hardwarePlatform, refPack } = options;
   const session = plan.sessions.find((s) => s.id === lessonCode);
   if (!session) throw new Error("Session " + lessonCode + " not found in plan " + plan.plan_id);
   const existing = await storage.readArtifact(projectId, EXPOSITION_REL(lessonCode));
@@ -11659,9 +11740,11 @@ async function ensureKnowledgeExposition(options) {
     throw new ExpositionApprovalError("Approval hash " + plan.approval.plan_hash + " does not match current plan hash " + plan.plan_hash + " \u2014 re-approve after plan changes");
   }
   const targetLanguage = options.targetLanguage || plan.translation?.target_language || "vi";
+  const originalSystemPrompt = buildSystemPrompt(targetLanguage, techStack, hardwarePlatform);
+  const originalUserPrompt = buildUserPrompt(session, plan, glossary, targetLanguage, options.slcMarkdown, refPack);
   const content = (await llmFn(
-    buildSystemPrompt(targetLanguage, techStack, hardwarePlatform),
-    buildUserPrompt(session, plan, glossary, targetLanguage, options.slcMarkdown)
+    originalSystemPrompt,
+    originalUserPrompt
   )).trim();
   if (content.length < 200) {
     throw new Error("EXPOSITION too short for " + lessonCode + " (" + content.length + " chars) \u2014 refusing to save");
@@ -11694,8 +11777,16 @@ async function ensureKnowledgeExposition(options) {
     };
     let verdict = await judgeOnce(finalContent);
     if (verdict.verdict !== "APPROVED") {
-      const repairPrompt = finalContent + "\n\nJUDGE CRITIQUE (fix ALL issues, output the COMPLETE corrected document):\n" + verdict.critique;
-      finalContent = (await llmFn(buildSystemPrompt(), repairPrompt)).trim();
+      const repairPrompt = [
+        originalUserPrompt,
+        "",
+        "--- YOUR PREVIOUS DRAFT (REJECTED, fix ALL issues below) ---",
+        finalContent,
+        "",
+        "--- JUDGE CRITIQUE (fix ALL issues, output the COMPLETE corrected document) ---",
+        verdict.critique
+      ].join("\n");
+      finalContent = (await llmFn(originalSystemPrompt, repairPrompt)).trim();
       verdict = await judgeOnce(finalContent);
     }
     if (verdict.verdict !== "APPROVED") {
@@ -11736,12 +11827,27 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
     try {
       const lpRaw = await storage.readSotDocument(projectId, "LEARNER_PROFILE.md");
       if (lpRaw) {
-        const hwMatch = lpRaw.match(/(?:Student Equipment|Hardware|Platform|Thiết bị)[:\s*`]+([^\n\r]+)/i);
-        if (hwMatch && !hw) hw = hwMatch[1].trim();
+        const hwPatterns = [
+          /(?:Student Equipment|Hardware|Platform|Thiết bị|Thiết bị học tập)\s*(?:\(|:|\*)*\s*([^\n\r]+?)(?:\s*\*\*|[.).]?\s*$)/i,
+          /(?:máy|device|machine)\s+([^,.;\n]{4,60}(?:M\d|Intel|PC|computer|mini)[^,.;\n]{0,30})/i
+        ];
+        for (const p of hwPatterns) {
+          const m = lpRaw.match(p);
+          if (m && !hw) {
+            hw = m[1].trim();
+            break;
+          }
+        }
       }
     } catch {
     }
   }
+  let refPackContent;
+  try {
+    refPackContent = await storage.readSotDocument(projectId, "REFERENCE_PACK.md") || void 0;
+  } catch {
+    refPackContent = void 0;
+  }
   const { runCurriculumAIInference: runCurriculumAIInference2 } = await Promise.resolve().then(() => (init_streamRunner(), streamRunner_exports));
   const targetLang = options.targetLanguage || plan.translation?.target_language || "vi";
   const result = await ensureKnowledgeExposition({
@@ -11753,6 +11859,7 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
     slcMarkdown: options.slcMarkdown,
     techStack: tech,
     hardwarePlatform: hw,
+    refPack: refPackContent,
     llmFn: async (systemPrompt, userPrompt) => {
       const runnerOpts = options.customInference ? { customInference: options.customInference } : {};
       const out = await runCurriculumAIInference2(
@@ -26051,11 +26158,16 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   }).excerpt : "";
   let effectiveRefPack = refPack ? buildSectionAwareExcerpt(refPack, {
     priorities: [
+      // Toolchain/version matrix FIRST — the most-frequently-hallucinated
+      // facts are tool versions ("Xcode 15" vs ground truth "Xcode 16").
+      // The bilingual fuzzy matcher in contextBuilder resolves these keys
+      // even when the generated RefPack headings are Vietnamese.
       "Technical Overview & Architecture Blueprint",
       "Hardware Pinout & Wiring Configuration Matrix",
+      "Standards Alignment",
       "Core Pedagogical Concept Anchor & Real-World Domain Bridge"
     ],
-    budget: 2500
+    budget: 3500
   }).excerpt : "";
   const baseContextPrefix = `PROJECT & ACADEMIC CONTEXT:
 - Project ID: ${projectId}
@@ -26094,6 +26206,21 @@ ${renderHorizonPromptBlock(horizon)}`;
   } catch (hErr) {
     console.warn(`[produceSingleLesson] Notice: Curriculum Horizon extraction:`, hErr?.message || hErr);
   }
+  const buildGroundTruthBlock = () => {
+    const parts = [];
+    if (expositionContext) {
+      parts.push(`### KNOWLEDGE_EXPOSITION (CANONICAL KNOWLEDGE \u2014 teach from this, do not contradict)
+${expositionContext}`);
+    }
+    if (effectiveRefPack) {
+      parts.push(`### REFERENCE PACK GROUND TRUTH
+${effectiveRefPack}`);
+    }
+    return parts.length > 0 ? `
+
+[GROUND TRUTH]:
+${parts.join("\n\n")}` : "";
+  };
   const glossaryBlock = glossaryContext ? `
 
 [GLOSSARY TERMS (use these exact definitions)]:
@@ -26101,21 +26228,14 @@ ${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}
+  const assembleCommonContext = (sg) => `${baseContextPrefix}
 
 [CONTENT STYLE GUIDE EXCERPT]:
-${sg}
-
-[REFERENCE PACK GROUND TRUTH]:
-${ref}${standardsBlock}${glossaryBlock}${expositionBlock}${sessionSliceBlock}${horizonBlock}`;
-  let commonContext = assembleCommonContext(effectiveRefPack, effectiveStyleGuide);
+${sg}${standardsBlock}${glossaryBlock}${buildGroundTruthBlock()}${sessionSliceBlock}${horizonBlock}`;
+  let commonContext = assembleCommonContext(effectiveStyleGuide);
   const MAX_COMPOSITE_PROMPT_CHARS = 3e4;
   const runnerOptions = options.customInference ? { customInference: options.customInference } : {};
   if (commonContext.length > MAX_COMPOSITE_PROMPT_CHARS && effectiveRefPack.length > 1e3) {
@@ -26126,14 +26246,14 @@ ${ref}${standardsBlock}${glossaryBlock}${expositionBlock}${sessionSliceBlock}${h
       ],
       budget: 1e3
     }).excerpt;
-    commonContext = assembleCommonContext(effectiveRefPack, effectiveStyleGuide);
+    commonContext = assembleCommonContext(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);
+    commonContext = assembleCommonContext(effectiveStyleGuide);
   }
   onProgress?.("@content", `[CONTEXT] Composite prompt ready (${commonContext.length} chars, adaptive budget <= ${MAX_COMPOSITE_PROMPT_CHARS})`, {
     type: "progress",
@@ -26484,7 +26604,7 @@ ${currentContent}` }],
     });
   }
   const lessonExcerptResult = buildSectionAwareExcerpt(lessonContent, {
-    priorities: DEFAULT_LESSON_PRIORITIES,
+    priorities: SATELLITE_LESSON_PRIORITIES,
     budget: 12e3,
     sectionLanguageContract: slcMarkdown,
     artifactType: "LESSON"
@@ -26674,6 +26794,7 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
       } catch {
       }
       const { executeSlideProductionWorkflow: executeSlideProductionWorkflow2 } = await Promise.resolve().then(() => (init_slideProductionWorkflow(), slideProductionWorkflow_exports));
+      const slideGroundContext = `${commonContext}${symbolLedgerBlock}`;
       const workflowResult = await executeSlideProductionWorkflow2({
         lessonMarkdown: lessonContent || "",
         lessonCode,
@@ -26682,6 +26803,7 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
         language: targetLang || "Vietnamese",
         languageDirective,
         headingDirective: buildHeadingDirective("SLIDE", slcMarkdown, targetLang),
+        groundContext: slideGroundContext,
         satelliteContext,
         runnerOptions,
         onProgress: (agent, msg, meta) => {
@@ -26690,7 +26812,7 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
       });
       let deckJson = workflowResult.deckJson;
       const markdownWrapper = workflowResult.markdownWrapper;
-      let validation = presentationKitAi?.validateHtmlSlideDeck ? presentationKitAi.validateHtmlSlideDeck(deckJson, true) : deckJson && Array.isArray(deckJson.slides) ? { valid: true, score: 95, issues: [], slideCount: deckJson.slides.length} : { valid: false, score: 0, issues: [{ message: "Malformed JSON slide deck" }], slideCount: 0};
+      let validation = presentationKitAi?.validateHtmlSlideDeck ? presentationKitAi.validateHtmlSlideDeck(deckJson, true) : deckJson && Array.isArray(deckJson.slides) ? { valid: true, score: 95, issues: [], slideCount: deckJson.slides.length} : { valid: false, score: 0, issues: [{ message: "Malformed JSON slide deck" }]};
       await storage.saveArtifact(projectId, slideRelPath, markdownWrapper);
       producedArtifacts.push(`SLIDE_${lessonCode}.md`);
       if (deckJson) {
@@ -26710,21 +26832,45 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
           }
         }
       }
-      const passed = Boolean(validation.valid && (validation.score ?? 100) >= 80);
-      const score = validation.score ?? (passed ? 95 : 50);
-      await storage.updateArtifactState(projectId, lessonCode, "SLIDE", {
-        state: passed ? "approved" : "rejected",
-        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        contentHash: computeContentHash(markdownWrapper),
-        review: {
-          decision: passed ? "APPROVED" : "NEEDS_REVISION",
-          reviewedBy: "@agent-as-judge",
-          reviewedAt: (/* @__PURE__ */ new Date()).toISOString(),
-          score,
-          critique: passed ? `HTML Slide Deck passed strict schema validation (${score}/100, ${validation.slideCount ?? deckJson?.slides?.length ?? 0} slides). Auto-approved.` : `HTML Slide Deck failed schema validation: ${(validation.issues || []).map((i) => i.message).join("; ")}`
-        }
-      });
-      onProgress?.("@reviewer", passed ? `\u2705 SLIDE judge PASS (${score}/100) [html-deck schema validated]` : `\u26A0\uFE0F SLIDE judge NEEDS_REVISION (${score}/100) [html-deck schema issues]`);
+      const structuralOk = Boolean(validation.valid && (validation.score ?? 100) >= 80);
+      const structuralScore = validation.score ?? (structuralOk ? 95 : 50);
+      const gateMode = gateModeFor(gates, "SLIDE");
+      if (!structuralOk) {
+        await storage.updateArtifactState(projectId, lessonCode, "SLIDE", {
+          state: "rejected",
+          generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          contentHash: computeContentHash(markdownWrapper),
+          review: {
+            decision: "NEEDS_REVISION",
+            reviewedBy: "@heuristic-linter",
+            reviewedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            score: structuralScore,
+            critique: `HTML Slide Deck failed schema validation: ${(validation.issues || []).map((i) => i.message).join("; ")}`
+          }
+        });
+        onProgress?.("@reviewer", `\u26A0\uFE0F SLIDE structural pre-check FAILED (${structuralScore}/100) [html-deck schema issues]`);
+      } else {
+        await storage.updateArtifactState(projectId, lessonCode, "SLIDE", {
+          state: gateMode === "LLM_JUDGE" ? "pending" : "completed",
+          generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          contentHash: computeContentHash(markdownWrapper)
+        });
+        onProgress?.("@reviewer", gateMode === "LLM_JUDGE" ? `\u2705 SLIDE structural pre-check PASS (${structuralScore}/100) \u2014 handing content review to LLM-as-Judge gate` : `\u2705 SLIDE structural pre-check PASS (${structuralScore}/100) [gate=${gateMode}, no LLM judge]`);
+        const deckTextForJudge = Array.isArray(deckJson?.slides) ? deckJson.slides.map((s, i) => {
+          const slotLines = Object.entries(s.slots || {}).map(([k, v]) => {
+            if (Array.isArray(v)) return `- ${k}:
+${v.map((item) => typeof item === "object" ? `  - ${JSON.stringify(item)}` : `  - ${item}`).join("\n")}`;
+            if (v && typeof v === "object") return `- ${k}: ${JSON.stringify(v, null, 1)}`;
+            return `- ${k}: ${v}`;
+          }).join("\n");
+          return `## Slide ${i + 1} [${s.layoutId}]
+${slotLines}
+
+Presenter Notes:
+${s.notes || "(none)"}`;
+        }).join("\n\n") : String(markdownWrapper);
+        await judgeSat("SLIDE", deckTextForJudge);
+      }
     } else {
       const canonicalSlideTemplate = loadCurriculumTemplate("SLIDE_template.md");
       const templateScaffold = canonicalSlideTemplate || `---
@@ -31873,6 +32019,7 @@ exports.RoadmapInputSchema = RoadmapInputSchema;
 exports.RotationStationSchema = RotationStationSchema;
 exports.RubricCriteriaSchema = RubricCriteriaSchema;
 exports.RubricSchema = RubricSchema;
+exports.SATELLITE_LESSON_PRIORITIES = SATELLITE_LESSON_PRIORITIES;
 exports.SCIENCE_LAB_TEMPLATE = SCIENCE_LAB_TEMPLATE;
 exports.SELF_LAB_TEMPLATE = SELF_LAB_TEMPLATE;
 exports.SLIDE_CANONICAL_METHODOLOGY = SLIDE_CANONICAL_METHODOLOGY;
@@ -31922,6 +32069,7 @@ exports.analystTools = analystTools;
 exports.analyzeProjectCreationIntent = analyzeProjectCreationIntent;
 exports.assertAcyclic = assertAcyclic;
 exports.assessorTools = assessorTools;
+exports.atomicWriteFileSync = atomicWriteFileSync;
 exports.auditCurriculumQualityFlow = auditCurriculumQualityFlow;
 exports.auditQualityReport = auditQualityReport;
 exports.buildActivityPrompt = buildActivityPrompt;
@@ -31969,6 +32117,7 @@ exports.createStreamChunkExtractor = createStreamChunkExtractor;
 exports.curateMediaLedger = curateMediaLedger;
 exports.designerTools = designerTools;
 exports.detectProjectPedagogy = detectProjectPedagogy;
+exports.emitUsage = emitUsage;
 exports.ensureExpositionForLesson = ensureExpositionForLesson;
 exports.ensureKnowledgeExposition = ensureKnowledgeExposition;
 exports.evaluateStandardsCoverage = evaluateStandardsCoverage;