@thanh01.pmt/curriculum-kit 1.4.11 → 1.4.12

package/dist/index.cjs

@@ -2,6 +2,7 @@
 
 var fs2 = require('fs');
 var path3 = require('path');
+var jsonrepair = require('jsonrepair');
 var zod = require('zod');
 var google = require('@ai-sdk/google');
 var openai = require('@ai-sdk/openai');
@@ -12,7 +13,6 @@ var fsPromises = require('fs/promises');
 var crypto = require('crypto');
 var supabaseJs = require('@supabase/supabase-js');
 var url = require('url');
-var jsonrepair = require('jsonrepair');
 var rest = require('@octokit/rest');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -1174,6 +1174,488 @@ var init_artifactLinter = __esm({
   "src/pipeline/artifactLinter.ts"() {
   }
 });
+
+// src/parsers/lessonFlowParser.ts
+function parseLessonFlow(lessonMarkdown) {
+  const result = {
+    lessonId: "",
+    lessonTitle: "",
+    pedagogicalModel: "5e",
+    estimatedDuration: "90 mins",
+    activities: [],
+    phases: [],
+    rawContent: lessonMarkdown
+  };
+  if (!lessonMarkdown || typeof lessonMarkdown !== "string") {
+    return result;
+  }
+  const fmMatch = lessonMarkdown.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (fmMatch) {
+    const fm = fmMatch[1];
+    const idMatch = fm.match(/id:\s*["']?([^"'\n]+)["']?/i);
+    if (idMatch) result.lessonId = idMatch[1].trim();
+    const titleMatch = fm.match(/title:\s*["']?([^"'\n]+)["']?/i);
+    if (titleMatch) result.lessonTitle = titleMatch[1].trim();
+    const typeMatch = fm.match(/type:\s*["']?([^"'\n]+)["']?/i);
+    if (typeMatch) {
+      const t = typeMatch[1].toLowerCase();
+      if (t.includes("edp")) result.pedagogicalModel = "edp";
+      else if (t.includes("pbl")) result.pedagogicalModel = "pbl";
+      else if (t.includes("cra")) result.pedagogicalModel = "cra";
+      else if (t.includes("5e")) result.pedagogicalModel = "5e";
+      else result.pedagogicalModel = typeMatch[1].trim();
+    }
+  }
+  const durMatch = lessonMarkdown.match(/Estimated Duration:\s*([^\n]+)/i);
+  if (durMatch) result.estimatedDuration = durMatch[1].trim();
+  const contractMatch = lessonMarkdown.match(/SLIDE must visualize:?\s*([^\n]+)/i);
+  if (contractMatch) result.slideContract = contractMatch[1].trim();
+  const actSeqSectionMatch = lessonMarkdown.match(/###\s*(?:\d+\.\s*)?Activity Sequence[\s\S]*?(?=(?:###|\n##\s+|$))/i);
+  if (actSeqSectionMatch) {
+    const tableText = actSeqSectionMatch[0];
+    const lines = tableText.split("\n");
+    let inTable = false;
+    let headerParsed = false;
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed.startsWith("|") && trimmed.endsWith("|")) {
+        if (!inTable) {
+          inTable = true;
+          continue;
+        }
+        if (trimmed.includes("---")) {
+          headerParsed = true;
+          continue;
+        }
+        if (headerParsed) {
+          const cells = trimmed.split("|").map((c) => c.trim()).filter((_, idx, arr) => idx > 0 && idx < arr.length - 1);
+          if (cells.length >= 7) {
+            const seqNum = parseInt(cells[0], 10) || result.activities.length + 1;
+            result.activities.push({
+              seq: seqNum,
+              phase: cells[1] || `Phase ${seqNum}`,
+              activityType: cells[2] || "",
+              actor: cells[3] || "",
+              purpose: cells[4] || "",
+              studentAction: cells[5] || "",
+              teacherMove: cells[6] || "",
+              time: cells[9] || cells[cells.length - 2] || "",
+              artifactContract: cells[cells.length - 1] || ""
+            });
+          }
+        }
+      } else if (inTable && trimmed.length > 0 && !trimmed.startsWith(">")) {
+        inTable = false;
+      }
+    }
+  }
+  const flowMatch = lessonMarkdown.match(/##\s*\[?REQUIRED\]?\s*B\.\s*Lesson Flow([\s\S]*?)$/i);
+  const flowSection = flowMatch ? flowMatch[1] : lessonMarkdown;
+  const phaseRegex = /###\s*(?:(\d+)\.\s*)?([^\n—\-]+)(?:[—\-]\s*\[?([^\]\n]+)\]?)?\s*\n([\s\S]*?)(?=(?:###\s*(?:\d+\.)?|$))/gi;
+  let pMatch;
+  while ((pMatch = phaseRegex.exec(flowSection)) !== null) {
+    const rawPhaseName = pMatch[2].trim();
+    const timing = pMatch[3]?.trim();
+    const content = pMatch[4].trim();
+    const codeSnippets = [];
+    const codeRegex = /```(?:[a-zA-Z0-9_\-]+)?\s*\n([\s\S]*?)```/g;
+    let cMatch;
+    while ((cMatch = codeRegex.exec(content)) !== null) {
+      if (!cMatch[1].includes("graph TD") && !cMatch[1].includes("graph LR")) {
+        codeSnippets.push(cMatch[1].trim());
+      }
+    }
+    const mermaidDiagrams = [];
+    const mermaidRegex = /```mermaid\s*\n([\s\S]*?)```/g;
+    let mMatch;
+    while ((mMatch = mermaidRegex.exec(content)) !== null) {
+      mermaidDiagrams.push(mMatch[1].trim());
+    }
+    result.phases.push({
+      phaseName: rawPhaseName,
+      title: rawPhaseName,
+      timing,
+      content,
+      codeSnippets,
+      mermaidDiagrams
+    });
+  }
+  return result;
+}
+var init_lessonFlowParser = __esm({
+  "src/parsers/lessonFlowParser.ts"() {
+  }
+});
+
+// src/ai/prompts/slideBlueprintPrompt.ts
+function buildSlideBlueprintPrompt(params) {
+  const { lessonFlow, targetSlideCount = 20, stylePresetName = "Blue Professional" } = params;
+  const activitiesSummary = lessonFlow.activities.map(
+    (a) => `Seq ${a.seq} [${a.phase}]: ${a.purpose} (Teacher: ${a.teacherMove} | Student: ${a.studentAction} | Time: ${a.time})`
+  ).join("\n");
+  const phasesSummary = lessonFlow.phases.map(
+    (p) => `Phase "${p.phaseName}" (${p.timing || "Standard"}):
+${p.content.slice(0, 500)}...`
+  ).join("\n\n");
+  return `
+You are @illustrator, Chief Slide Architect for the Course Builder OS.
+Your task is to analyze the canonical LESSON plan and architect an authoritative, high-fidelity **SLIDE BLUEPRINT** of EXACTLY ${targetSlideCount} slides.
+
+### \u{1F3DB}\uFE0F PEDAGOGICAL GROUND TRUTH (FROM CANONICAL LESSON):
+- Lesson Title: "${lessonFlow.lessonTitle}"
+- Pedagogical Framework: "${lessonFlow.pedagogicalModel.toUpperCase()}"
+- Target Duration: ${lessonFlow.estimatedDuration}
+- Active Visual Style: "${stylePresetName}"
+${lessonFlow.slideContract ? `- Slide Artifact Contract: "${lessonFlow.slideContract}"` : ""}
+
+### \u{1F5FA}\uFE0F CANONICAL ACTIVITY SEQUENCE:
+${activitiesSummary || "Standard phased sequence"}
+
+### \u{1F4D6} LESSON FLOW EXCERPT:
+${phasesSummary || lessonFlow.rawContent.slice(0, 3e3)}
+
+---
+
+### \u{1F3AF} ARCHITECTURAL RULES (STRICTLY INVARIANT):
+1. **PEDAGOGICAL FIDELITY (1-TO-1 PROJECTION)**:
+   - The slide sequence MUST follow the EXACT flow of the LESSON phases (${lessonFlow.pedagogicalModel.toUpperCase()}).
+   - Do NOT invent artificial phases that do not exist in the lesson plan.
+   - For example:
+     * If 5E: Engage (slides 1-4) -> Explore (slides 5-8) -> Explain (slides 9-13) -> Elaborate (slides 14-17) -> Evaluate (slides 18-20).
+     * If EDP: Ask/Problem (slides 1-4) -> Imagine & Plan (slides 5-8) -> Create & Prototype (slides 9-14) -> Test & Debug (slides 15-17) -> Improve & Share (slides 18-20).
+     * If PBL: Driving Question (slides 1-4) -> Inquiry (slides 5-9) -> Milestone Sprint (slides 10-15) -> Review & Exhibition (slides 16-20).
+
+2. **CHUNKY CLUSTERS (3 TO 4 CLUSTERS)**:
+   - Group the ${targetSlideCount} slides into 3 to 4 natural clusters (each cluster contains 4 to 6 slides).
+   - Each cluster corresponds to a major pedagogical transition in the lesson.
+
+3. **SEMANTIC LAYOUT SLOTS (CHOOSE FROM VERIFIED TEMPLATES)**:
+   Use one of these valid layoutIds for each slide:
+   - \`hero-cover\`: Title, subtitle, topic badge, metadata.
+   - \`split-concept-code\`: Left side explanation/bullets, right side prominent code card or diagram.
+   - \`two-columns-compare\`: Side-by-side comparison (Before vs After, Scratch vs Swift, Theory vs Practice).
+   - \`three-cards-grid\`: 3 architectural pillars, components, or principles.
+   - \`timeline-steps\`: Step-by-step workflow, pipeline sequence, or execution trace.
+   - \`metric-callout\`: High-impact statistical or performance highlight.
+   - \`checkpoint-quiz\`: Formative diagnostic question with multiple choice.
+   - \`tiered-practice-3cards\`: Bronze, Silver, Gold hands-on challenge specs.
+   - \`summary-takeaways\`: Final recap, key rules, and next milestone.
+
+---
+
+### \u{1F4E4} OUTPUT FORMAT:
+Output ONLY a valid JSON array of ${targetSlideCount} objects. Do NOT include markdown text outside the JSON.
+Format:
+\`\`\`json
+[
+  {
+    "slideIndex": 1,
+    "clusterId": 1,
+    "clusterTitle": "Opening & Hook",
+    "lessonPhase": "Engage",
+    "layoutId": "hero-cover",
+    "title": "Title of Slide 1",
+    "pedagogicalGoal": "Specific learning goal of this slide",
+    "contentFocus": ["Bullet 1 focus", "Bullet 2 focus"],
+    "codeSnippetIntent": "Description of code snippet to show, if any",
+    "visualIntent": "Description of visual diagram to display, if any"
+  }
+]
+\`\`\`
+`.trim();
+}
+var init_slideBlueprintPrompt = __esm({
+  "src/ai/prompts/slideBlueprintPrompt.ts"() {
+  }
+});
+
+// src/ai/prompts/slideBatchPrompt.ts
+function buildSlideBatchPrompt(params) {
+  const {
+    clusterId,
+    clusterTitle,
+    clusterSlides,
+    lessonFlow,
+    lessonExcerpt,
+    skillPrompt,
+    language = "Vietnamese",
+    languageDirective = "",
+    headingDirective = ""
+  } = params;
+  const slidesSpec = clusterSlides.map((s) => `
+- Slide ${s.slideIndex} [Phase: ${s.lessonPhase}] -> Layout: "${s.layoutId}"
+  Title: "${s.title}"
+  Pedagogical Goal: ${s.pedagogicalGoal}
+  Key Bullet Targets: ${s.contentFocus.join("; ")}
+  ${s.codeSnippetIntent ? `Code Focus: ${s.codeSnippetIntent}` : ""}
+  ${s.visualIntent ? `Visual Focus: ${s.visualIntent}` : ""}
+`).join("\n");
+  const systemPrompt = `
+${skillPrompt}
+
+---
+### OPERATIONAL GROUND RULES FOR CHUNK GENERATION:
+${languageDirective}
+${headingDirective}
+1. **FOCUS ON CLUSTER ${clusterId}: "${clusterTitle}"**:
+   Generate EXACTLY the ${clusterSlides.length} slides requested in the user prompt.
+2. **ZERO ABBREVIATION / NO "// TODO"**:
+   All code snippets MUST be real, fully authored, compilable code relevant to ${lessonFlow.lessonTitle}. Never write placeholders, stubs, or "<CODE>".
+3. **MANDATORY 3-PART PRESENTER NOTES ON EVERY SLIDE**:
+   Every slide object MUST have a "notes" field formatted with:
+   - SCRIPT: 60-90s spoken teacher talk track with an intuitive analogy.
+   - COLD CALL / CHECK: One targeted question to check for student understanding.
+   - SCAFFOLDING / GOTCHA: One common misconception or bug to watch out for.
+4. **OUTPUT FORMAT**:
+   Output ONLY a valid JSON array of ${clusterSlides.length} slide objects.
+`.trim();
+  const userPrompt = `
+### LESSON GROUND TRUTH:
+- Lesson Title: "${lessonFlow.lessonTitle}"
+- Target Duration: ${lessonFlow.estimatedDuration}
+- Pedagogy: "${lessonFlow.pedagogicalModel.toUpperCase()}"
+- Language: "${language}"
+
+### LESSON PHASE CONTENT (SOURCE OF TRUTH):
+${lessonExcerpt || lessonFlow.rawContent.slice(0, 4e3)}
+
+---
+
+### REQUIRED SLIDES TO GENERATE FOR THIS CLUSTER:
+${slidesSpec}
+
+---
+
+### OUTPUT SCHEMA:
+Output a single JSON array of slide objects strictly matching the layout slots:
+\`\`\`json
+[
+  {
+    "id": "slide-${clusterSlides[0]?.slideIndex || 1}",
+    "layoutId": "${clusterSlides[0]?.layoutId || "split-concept-code"}",
+    "title": "${clusterSlides[0]?.title || "Slide Title"}",
+    "slots": {
+      "lead": "One clear, punchy subtitle or thesis statement",
+      "bullets": [
+        "First key insight (8-12 words max)",
+        "Second key insight (8-12 words max)",
+        "Third key insight (8-12 words max)"
+      ],
+      "code": "// Executable code here",
+      "codeLanguage": "swift",
+      "codeHighlight": "1-3",
+      "card1Title": "...",
+      "card1Desc": "..."
+    },
+    "notes": "SCRIPT: ...\\nCOLD CALL: ...\\nSCAFFOLDING: ..."
+  }
+]
+\`\`\`
+`.trim();
+  return { systemPrompt, userPrompt };
+}
+var init_slideBatchPrompt = __esm({
+  "src/ai/prompts/slideBatchPrompt.ts"() {
+  }
+});
+
+// src/services/slideProductionWorkflow.ts
+var slideProductionWorkflow_exports = {};
+__export(slideProductionWorkflow_exports, {
+  executeSlideProductionWorkflow: () => executeSlideProductionWorkflow
+});
+function extractCleanJson(raw) {
+  const fenceMatch = raw.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
+  const candidate = fenceMatch ? fenceMatch[1] : raw;
+  return candidate.trim();
+}
+async function executeSlideProductionWorkflow(options) {
+  const {
+    lessonMarkdown,
+    lessonCode,
+    lessonTitle,
+    targetSlideCount = 20,
+    stylePresetId = "blue-professional",
+    language = "Vietnamese",
+    languageDirective = "",
+    headingDirective = "",
+    satelliteContext,
+    runnerOptions,
+    onProgress
+  } = options;
+  let presentationKitSkills = null;
+  let presentationKitCore = null;
+  try {
+    presentationKitSkills = await import('@thanh01.pmt/presentation-kit/skills');
+  } catch {
+  }
+  try {
+    presentationKitCore = await import('@thanh01.pmt/presentation-kit');
+  } catch {
+  }
+  onProgress?.("@illustrator", `[1/4] Ph\xE2n t\xEDch m\u1EA1ch b\xE0i gi\u1EA3ng LESSON & L\u1EADp D\xE0n \xFD ${targetSlideCount} Slides...`);
+  const lessonFlow = parseLessonFlow(lessonMarkdown);
+  const stylePreset = presentationKitSkills?.getStylePreset ? presentationKitSkills.getStylePreset(stylePresetId) : { name: "Blue Professional" };
+  const blueprintPrompt = buildSlideBlueprintPrompt({
+    lessonFlow,
+    targetSlideCount,
+    stylePresetName: stylePreset?.name || "Blue Professional"
+  });
+  const rawBlueprint = await runCurriculumAIInference(
+    [{ role: "user", content: blueprintPrompt }],
+    satelliteContext,
+    runnerOptions,
+    (chunk, type) => {
+      onProgress?.("@illustrator", chunk, { type: type || "content", artifactType: "SLIDE" });
+    }
+  );
+  let blueprintItems = [];
+  try {
+    blueprintItems = JSON.parse(extractCleanJson(rawBlueprint));
+  } catch {
+    try {
+      blueprintItems = JSON.parse(jsonrepair.jsonrepair(extractCleanJson(rawBlueprint)));
+    } catch (e) {
+      console.warn(`[SlideProductionWorkflow] Failed parsing blueprint JSON, constructing fallback:`, e);
+      blueprintItems = Array.from({ length: targetSlideCount }, (_, i) => ({
+        slideIndex: i + 1,
+        clusterId: Math.floor(i / 5) + 1,
+        clusterTitle: `Cluster ${Math.floor(i / 5) + 1}`,
+        lessonPhase: lessonFlow.phases[Math.min(i, lessonFlow.phases.length - 1)]?.phaseName || "Content",
+        layoutId: i === 0 ? "hero-cover" : i === targetSlideCount - 1 ? "summary-takeaways" : "split-concept-code",
+        title: `Slide ${i + 1}: ${lessonTitle}`,
+        pedagogicalGoal: `Teach step ${i + 1} of ${lessonTitle}`,
+        contentFocus: ["Key point 1", "Key point 2", "Key point 3"]
+      }));
+    }
+  }
+  const clustersMap = /* @__PURE__ */ new Map();
+  for (const item of blueprintItems) {
+    const cId = item.clusterId || Math.floor((item.slideIndex - 1) / 5) + 1;
+    if (!clustersMap.has(cId)) clustersMap.set(cId, []);
+    clustersMap.get(cId).push(item);
+  }
+  const clusters = Array.from(clustersMap.entries()).sort(([a], [b]) => a - b);
+  const allGeneratedSlides = [];
+  const skillPrompt = presentationKitSkills?.getFrontendSlidesSkillPrompt ? presentationKitSkills.getFrontendSlidesSkillPrompt({ stylePresetId }) : "";
+  let clusterIdx = 0;
+  for (const [cId, clusterSlides] of clusters) {
+    clusterIdx++;
+    const clusterTitle = clusterSlides[0]?.clusterTitle || `Giai \u0111o\u1EA1n ${clusterIdx}`;
+    onProgress?.("@illustrator", `[2/4] Sinh chi ti\u1EBFt C\u1EE5m ${clusterIdx}/${clusters.length}: "${clusterTitle}" (${clusterSlides.length} slides)...`);
+    const clusterPhaseNames = new Set(clusterSlides.map((s) => s.lessonPhase.toLowerCase()));
+    const matchingPhases = lessonFlow.phases.filter(
+      (p) => clusterPhaseNames.has(p.phaseName.toLowerCase())
+    );
+    const lessonExcerpt = matchingPhases.length > 0 ? matchingPhases.map((p) => `### ${p.phaseName}
+${p.content}`).join("\n\n") : lessonFlow.rawContent.slice(0, 3500);
+    const { systemPrompt, userPrompt } = buildSlideBatchPrompt({
+      clusterId: cId,
+      clusterTitle,
+      clusterSlides,
+      lessonFlow,
+      lessonExcerpt,
+      skillPrompt,
+      language,
+      languageDirective,
+      headingDirective
+    });
+    const rawBatch = await runCurriculumAIInference(
+      [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: userPrompt }
+      ],
+      satelliteContext,
+      runnerOptions,
+      (chunk, type) => {
+        onProgress?.("@illustrator", chunk, { type: type || "content", artifactType: "SLIDE" });
+      }
+    );
+    let batchSlides = [];
+    try {
+      batchSlides = JSON.parse(extractCleanJson(rawBatch));
+    } catch {
+      try {
+        batchSlides = JSON.parse(jsonrepair.jsonrepair(extractCleanJson(rawBatch)));
+      } catch (err) {
+        console.warn(`[SlideProductionWorkflow] Batch ${cId} JSON parse failed, synthesizing slides:`, err);
+        batchSlides = clusterSlides.map((s) => ({
+          id: `slide-${s.slideIndex}`,
+          layoutId: s.layoutId,
+          title: s.title,
+          slots: {
+            lead: s.pedagogicalGoal,
+            bullets: s.contentFocus,
+            code: s.codeSnippetIntent || "// Executable demo code"
+          },
+          notes: `SCRIPT: Spoken explanation for ${s.title}.
+COLD CALL: What happens when this logic runs?
+SCAFFOLDING: Ensure proper syntax and indentation.`
+        }));
+      }
+    }
+    if (Array.isArray(batchSlides)) {
+      allGeneratedSlides.push(...batchSlides);
+    }
+  }
+  onProgress?.("@illustrator", `[3/4] Chu\u1EA9n h\xF3a b\u1ED1 c\u1EE5c v\xE0 bi\xEAn d\u1ECBch 1920\xD71080 Stage Deck (${allGeneratedSlides.length} slides)...`);
+  const normalizer = presentationKitCore?.normalizeSlideSlots;
+  const normalizedSlides = allGeneratedSlides.map((s, idx) => {
+    const base = normalizer ? normalizer(s) : s;
+    if (!base.id) base.id = `slide-${idx + 1}`;
+    return base;
+  });
+  const deckJson = {
+    id: `deck-${lessonCode}`,
+    title: lessonTitle,
+    theme: stylePresetId,
+    slides: normalizedSlides
+  };
+  let compiledHtml;
+  const compiler = presentationKitCore?.compileHtmlDeck;
+  if (compiler) {
+    try {
+      const compiled = compiler(deckJson);
+      if (compiled?.html) {
+        compiledHtml = compiled.html;
+      }
+    } catch (compErr) {
+      console.warn(`[SlideProductionWorkflow] Failed compiling HTML deck:`, compErr);
+    }
+  }
+  const markdownWrapper = `---
+id: "SLIDE_${lessonCode}"
+title: "${lessonTitle}"
+type: "SLIDE"
+format: "html-deck"
+engine: "html"
+phase: "P2"
+deliverable: "P2-T09"
+version: "v2.0"
+date: "${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
+---
+
+\`\`\`json
+${JSON.stringify(deckJson, null, 2)}
+\`\`\`
+`;
+  onProgress?.("@illustrator", `[4/4] Ho\xE0n t\u1EA5t b\u1ED9 tr\xECnh chi\u1EBFu HTML 20 trang \u0111\u1EA1t chu\u1EA9n Fixed 16:9 Stage!`);
+  return {
+    deckJson,
+    compiledHtml,
+    markdownWrapper,
+    blueprint: blueprintItems,
+    slideCount: normalizedSlides.length
+  };
+}
+var init_slideProductionWorkflow = __esm({
+  "src/services/slideProductionWorkflow.ts"() {
+    init_lessonFlowParser();
+    init_slideBlueprintPrompt();
+    init_slideBatchPrompt();
+    init_streamRunner();
+  }
+});
 var LearningObjectiveRowSchema = zod.z.object({
   code: zod.z.string().describe('LO code, e.g. "LO1"'),
   objective: zod.z.string().describe("Bloom-tagged learning objective"),
@@ -25340,104 +25822,25 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
         presentationKitCore = await import('@thanh01.pmt/presentation-kit');
       } catch {
       }
-      const slidePrompt = buildHtmlDeckSlidePrompt({
+      const { executeSlideProductionWorkflow: executeSlideProductionWorkflow2 } = await Promise.resolve().then(() => (init_slideProductionWorkflow(), slideProductionWorkflow_exports));
+      const workflowResult = await executeSlideProductionWorkflow2({
+        lessonMarkdown: lessonContent || "",
         lessonCode,
         lessonTitle,
-        pedagogyLabel,
+        targetSlideCount: 20,
+        stylePresetId: "blue-professional",
+        language: targetLang || "Vietnamese",
         languageDirective,
         headingDirective: buildHeadingDirective("SLIDE", slcMarkdown, targetLang),
-        glossaryBlock: glossaryContext ? `[GLOSSARY TERMS (use these exact definitions)]:
-${glossaryContext}` : void 0,
-        customContract: presentationKitAi?.SLIDE_HTML_PROMPT_CONTRACT
-      });
-      const rawSlide = await runCurriculumAIInference(
-        [{ role: "user", content: slidePrompt }],
         satelliteContext,
         runnerOptions,
-        (chunk, type) => {
-          options.onProgress?.("@illustrator", chunk, { type: type || "content", artifactType: "SLIDE" });
+        onProgress: (agent, msg, meta) => {
+          options.onProgress?.(agent, msg, meta || { type: "content", artifactType: "SLIDE" });
         }
-      );
-      if (!rawSlide || rawSlide.startsWith("\u26A0\uFE0F") || rawSlide.length < 200) {
-        throw createAiInferenceError({
-          errorCode: "ERR_AI_RESPONSE_MALFORMED",
-          agent: "@illustrator",
-          artifactType: "SLIDE",
-          lessonId: lessonCode,
-          message: `Agent @illustrator failed to author valid HTML Slides for ${lessonCode}.`,
-          rawError: rawSlide || "Empty AI response"
-        });
-      }
-      let deckJson = null;
-      const extractCleanJson = (str) => {
-        const fenceMatch = str.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
-        const candidate = fenceMatch ? fenceMatch[1] : str;
-        return candidate.trim();
-      };
-      const normalizeDeckSlides = (deck) => {
-        const normalizer = presentationKitCore?.normalizeSlideSlots || presentationKitAi?.normalizeSlideSlots;
-        if (deck && Array.isArray(deck.slides) && normalizer) {
-          deck.slides = deck.slides.map((s) => normalizer(s));
-        }
-        return deck;
-      };
-      try {
-        deckJson = JSON.parse(extractCleanJson(rawSlide));
-        deckJson = normalizeDeckSlides(deckJson);
-      } catch {
-        try {
-          const { jsonrepair: jsonrepair2 } = await import('jsonrepair');
-          deckJson = JSON.parse(jsonrepair2(extractCleanJson(rawSlide)));
-          deckJson = normalizeDeckSlides(deckJson);
-        } catch {
-        }
-      }
-      let validation = presentationKitAi?.validateHtmlSlideDeck ? presentationKitAi.validateHtmlSlideDeck(deckJson, true) : deckJson && Array.isArray(deckJson.slides) ? { valid: true, score: 95, issues: [], slideCount: deckJson.slides.length, notesCoveragePercent: 100 } : { valid: false, score: 0, issues: [{ message: "Malformed JSON slide deck" }], slideCount: 0, notesCoveragePercent: 0 };
-      if (!validation.valid && presentationKitAi?.validateHtmlSlideDeck) {
-        const repairIssues = (validation.issues || []).map((i) => `- Slide ${i.slideIndex ?? "?"}: ${i.message}`).join("\n");
-        onProgress?.("@illustrator", `\u26A0\uFE0F HTML slide deck failed schema validation \u2014 retrying once with targeted repair feedback...`);
-        const repairPrompt = `Your previous slide deck failed strict schema validation:
-${repairIssues}
-
-Fix ALL issues and output the complete corrected JSON object strictly matching the schema:`;
-        const repairedRaw = await runCurriculumAIInference(
-          [{ role: "user", content: repairPrompt }],
-          satelliteContext,
-          runnerOptions,
-          (chunk, type) => {
-            options.onProgress?.("@illustrator", chunk, { type: type || "content", artifactType: "SLIDE" });
-          }
-        );
-        try {
-          deckJson = JSON.parse(extractCleanJson(repairedRaw));
-          deckJson = normalizeDeckSlides(deckJson);
-          validation = presentationKitAi.validateHtmlSlideDeck(deckJson, true);
-        } catch {
-          try {
-            const { jsonrepair: jsonrepair2 } = await import('jsonrepair');
-            deckJson = JSON.parse(jsonrepair2(extractCleanJson(repairedRaw)));
-            deckJson = normalizeDeckSlides(deckJson);
-            validation = presentationKitAi.validateHtmlSlideDeck(deckJson, true);
-          } catch {
-          }
-        }
-      }
-      const markdownWrapper = `---
-id: "SLIDE_${lessonCode}"
-title: "${titleHeader(lessonTitle)}"
-type: "SLIDE"
-format: "html-deck"
-engine: "html"
-phase: "P2"
-deliverable: "P2-T09"
-version: "v1.0"
-date: "${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
----
-
-\`\`\`json
-${JSON.stringify(deckJson || {}, null, 2)}
-\`\`\`
-`;
+      });
+      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};
       await storage.saveArtifact(projectId, slideRelPath, markdownWrapper);
       producedArtifacts.push(`SLIDE_${lessonCode}.md`);
       if (deckJson) {
@@ -28075,6 +28478,9 @@ function isTranslationDue(target, context) {
   const total = context.totalLessonsByUnit[unit] ?? 0;
   return total > 0 && done >= total;
 }
+
+// src/services/index.ts
+init_slideProductionWorkflow();
 var LocalWorkspaceManager = class {
   baseDir;
   constructor(baseDir) {
@@ -30669,6 +31075,7 @@ exports.ensureExpositionForLesson = ensureExpositionForLesson;
 exports.ensureKnowledgeExposition = ensureKnowledgeExposition;
 exports.evaluateStandardsCoverage = evaluateStandardsCoverage;
 exports.executeCurriculumCommand = executeCurriculumCommand;
+exports.executeSlideProductionWorkflow = executeSlideProductionWorkflow;
 exports.exportAllProjectQuizzes = exportAllProjectQuizzes;
 exports.expositionCacheKey = expositionCacheKey;
 exports.extractScopeSequenceRows = extractScopeSequenceRows;