@thanh01.pmt/curriculum-kit 1.2.0 → 1.3.0

package/dist/{gateSettings-Buk_MSML.d.cts → gateSettings-L3FR2-MO.d.cts}

@@ -13,6 +13,7 @@ interface SingleArtifactRequest {
     studentCount?: string;
     language?: string;
     sectionLanguageContract?: Record<string, Record<string, string>> | string;
+    slidesEngine?: 'html' | 'marp';
     failClosedContext?: boolean;
     extraContext?: string;
     config?: Record<string, any>;

package/dist/{gateSettings-Buk_MSML.d.ts → gateSettings-L3FR2-MO.d.ts}

@@ -13,6 +13,7 @@ interface SingleArtifactRequest {
     studentCount?: string;
     language?: string;
     sectionLanguageContract?: Record<string, Record<string, string>> | string;
+    slidesEngine?: 'html' | 'marp';
     failClosedContext?: boolean;
     extraContext?: string;
     config?: Record<string, any>;

package/dist/index.cjs

@@ -5432,6 +5432,54 @@ ${input.languageDirective}
 
 ${input.headingDirective}`.trim();
 }
+function buildHtmlDeckSlidePrompt(input) {
+  const contract = input.customContract || `## HTML SLIDE ENGINE \u2014 AGENT GENERATION CONTRACT
+You generate structured slide decks for the LearnWell HTML Slide Presentation Engine.
+Your output MUST be a single, valid JSON object matching the Slide Deck JSON schema below.
+
+### \u{1F3A8} Available Layout Presets (Use layoutId):
+1. **hero-cover**: Title/Cover slide with title, subtitle, presenter, date, tag.
+2. **two-column-split**: Side-by-side comparison (col1Title, col1Items[], col2Title, col2Items[]).
+3. **code-explainer**: Code walkthrough with filename, language, code, highlightLines, annotations[].
+4. **metrics-3-card**: 3 key stat cards (card1Title, card1Val, card1Desc, card2..., card3...).
+5. **process-flow**: Step-by-step pipeline (steps: [{ label, desc, status }]).
+6. **quiz-checkpoint**: Quick multiple choice question (question, options[], answerIdx, explanation).
+7. **tiered-practice-3cards**: Differentiated tiers (foundation, standard, challenge cards).
+8. **takeaways-summary**: Summary review with bullet takeaways.
+
+### \u{1F399}\uFE0F Mandatory 3-Part Presenter Notes on EVERY slide:
+Every slide MUST include notes with:
+- Talk Track: 2-3 sentences speaking script
+- Cold-Call: 1 check question
+- Scaffolding Tip: 1 analogy or hint
+
+### Output JSON Format:
+\`\`\`json
+{
+  "title": "${input.lessonTitle}",
+  "theme": "ocean",
+  "slides": [
+    {
+      "layoutId": "hero-cover",
+      "slots": { "title": "${input.lessonTitle}", "subtitle": "..." },
+      "notes": "Talk Track: ...\\nCold-Call: ...\\nScaffolding Tip: ..."
+    }
+  ]
+}
+\`\`\``;
+  return `You are @illustrator & @content (Interactive HTML Slide Deck Presentation Architects).
+Based on Master Lesson Plan \`LESSON_${input.lessonCode}.md\`, pedagogical model (${input.pedagogyLabel}), and the HTML SLIDE ENGINE CONTRACT below, author the complete, highly engaging HTML presentation deck in JSON format: \`SLIDE_${input.lessonCode}\`.
+
+${contract}
+
+${input.languageDirective}
+
+${input.headingDirective}${input.glossaryBlock ? `
+
+${input.glossaryBlock}` : ""}
+
+Output ONLY the raw JSON object. Do not include extra conversational text or markdown code fences.`.trim();
+}
 
 // src/ai/prompts/teacherGuidePrompt.ts
 function buildTeacherGuidePrompt(input) {
@@ -5571,13 +5619,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).
@@ -11872,11 +11920,42 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   }
   const pedagogy = detectProjectPedagogy(framework, styleGuide, options.pedagogy);
   const pedagogyLabel = pedagogy.toUpperCase();
-  const styleGuideExcerpt = styleGuide ? buildSectionAwareExcerpt(styleGuide, {
+  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 : "";
-  const refPackExcerpt = refPack ? buildSectionAwareExcerpt(refPack, {
+  let effectiveRefPack = refPack ? buildSectionAwareExcerpt(refPack, {
     priorities: [
       "Technical Overview & Architecture Blueprint",
       "Hardware Pinout & Wiring Configuration Matrix",
@@ -11884,7 +11963,7 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
     ],
     budget: 2500
   }).excerpt : "";
-  const commonContext = `PROJECT & ACADEMIC CONTEXT:
+  const baseContextPrefix = `PROJECT & ACADEMIC CONTEXT:
 - Project ID: ${projectId}
 - Pedagogical Model: ${pedagogyLabel}
 - Lesson Code: ${lessonCode}
@@ -11894,13 +11973,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]:
-${styleGuideExcerpt}
+${sg}
 
 [REFERENCE PACK GROUND TRUTH]:
-${refPackExcerpt}${standardsContext ? "\n\n" + standardsContext : ""}${expositionContext ? "\n\n[KNOWLEDGE_EXPOSITION (CANONICAL KNOWLEDGE \u2014 teach from this, do not contradict)]:\n" + expositionContext : ""}${sessionSliceContext ? "\n\n" + sessionSliceContext : ""}`;
+${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);
@@ -12027,7 +12144,7 @@ ${yamlBlock.trim()}
           lessonId: lessonCode,
           title: lessonTitle,
           frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
-          styleGuideExcerpt: styleGuideExcerpt || void 0,
+          styleGuideExcerpt: effectiveStyleGuide || void 0,
           canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
         }),
         standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
@@ -12070,7 +12187,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}
@@ -12088,7 +12205,13 @@ ${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",
@@ -12100,7 +12223,7 @@ ${currentContent}` }],
               lessonId: lessonCode,
               title: lessonTitle,
               frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
-              styleGuideExcerpt: styleGuideExcerpt || void 0,
+              styleGuideExcerpt: effectiveStyleGuide || void 0,
               canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
             }),
             standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
@@ -12387,46 +12510,175 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
   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 templateScaffold = canonicalSlideTemplate || `---
+    const isHtmlEngine = options.slidesEngine === "html";
+    if (isHtmlEngine) {
+      let presentationKitAi = null;
+      try {
+        presentationKitAi = await import('@thanh01.pmt/presentation-kit/ai');
+      } catch {
+      }
+      const slidePrompt = buildHtmlDeckSlidePrompt({
+        lessonCode,
+        lessonTitle,
+        pedagogyLabel,
+        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,
+        {},
+        (chunk, type) => {
+          options.onProgress?.("@illustrator", chunk, { type: 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();
+      };
+      try {
+        deckJson = JSON.parse(extractCleanJson(rawSlide));
+      } catch {
+        try {
+          const { jsonrepair: jsonrepair2 } = await import('jsonrepair');
+          deckJson = JSON.parse(jsonrepair2(extractCleanJson(rawSlide)));
+        } 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,
+          {},
+          (chunk, type) => {
+            options.onProgress?.("@illustrator", chunk, { type: type || "content", artifactType: "SLIDE" });
+          }
+        );
+        try {
+          deckJson = JSON.parse(extractCleanJson(repairedRaw));
+          validation = presentationKitAi.validateHtmlSlideDeck(deckJson, true);
+        } catch {
+          try {
+            const { jsonrepair: jsonrepair2 } = await import('jsonrepair');
+            deckJson = JSON.parse(jsonrepair2(extractCleanJson(repairedRaw)));
+            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)}
+\`\`\`
+`;
+      await storage.saveArtifact(projectId, slideRelPath, markdownWrapper);
+      producedArtifacts.push(`SLIDE_${lessonCode}.md`);
+      if (deckJson) {
+        const deckJsonStr = JSON.stringify(deckJson, null, 2);
+        await storage.saveArtifact(projectId, `_content/${unitCode}/SLIDE_${lessonCode}.deck.json`, deckJsonStr);
+        producedArtifacts.push(`SLIDE_${lessonCode}.deck.json`);
+        if (presentationKitAi?.compileHtmlDeck) {
+          try {
+            const compiled = presentationKitAi.compileHtmlDeck(deckJson);
+            if (compiled?.html) {
+              await storage.saveArtifact(projectId, `_content/${unitCode}/SLIDE_${lessonCode}.html`, compiled.html);
+              producedArtifacts.push(`SLIDE_${lessonCode}.html`);
+            }
+          } catch (compErr) {
+            console.warn(`[produceSingleLesson] Failed compiling HTML deck for ${lessonCode}:`, compErr);
+          }
+        }
+      }
+      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]`);
+    } else {
+      const canonicalSlideTemplate = loadCurriculumTemplate("SLIDE_template.md");
+      const templateScaffold = canonicalSlideTemplate || `---
 marp: true
 theme: default
 paginate: true
 header: "${titleHeader(lessonTitle)}"
 footer: "Curriculum OS \u2022 ${lessonCode} (${pedagogyLabel})"
 ---`;
-    const slidePrompt = buildMarpMarkdownSlidePrompt({
-      lessonCode,
-      templateScaffold,
-      languageDirective,
-      headingDirective: buildHeadingDirective("SLIDE", slcMarkdown, targetLang)
-    });
-    const rawSlide = await runCurriculumAIInference(
-      [{ role: "user", content: slidePrompt }],
-      satelliteContext,
-      {},
-      (chunk, type) => {
-        options.onProgress?.("@illustrator", chunk, { type: type || "content", artifactType: "SLIDE" });
+      const slidePrompt = buildMarpMarkdownSlidePrompt({
+        lessonCode,
+        templateScaffold,
+        languageDirective,
+        headingDirective: buildHeadingDirective("SLIDE", slcMarkdown, targetLang)
+      });
+      const rawSlide = await runCurriculumAIInference(
+        [{ role: "user", content: slidePrompt }],
+        satelliteContext,
+        {},
+        (chunk, type) => {
+          options.onProgress?.("@illustrator", chunk, { type: 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 Slides for ${lessonCode}.`,
+          rawError: rawSlide || "Empty AI response"
+        });
       }
-    );
-    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 Slides for ${lessonCode}.`,
-        rawError: rawSlide || "Empty AI response"
+      await storage.saveArtifact(projectId, slideRelPath, rawSlide);
+      await storage.updateArtifactState(projectId, lessonCode, "SLIDE", {
+        state: "completed",
+        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        contentHash: computeContentHash(rawSlide)
       });
+      producedArtifacts.push(`SLIDE_${lessonCode}.md`);
+      await judgeSat("SLIDE", rawSlide);
     }
-    await storage.saveArtifact(projectId, slideRelPath, rawSlide);
-    await storage.updateArtifactState(projectId, lessonCode, "SLIDE", {
-      state: "completed",
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      contentHash: computeContentHash(rawSlide)
-    });
-    producedArtifacts.push(`SLIDE_${lessonCode}.md`);
-    await judgeSat("SLIDE", rawSlide);
   }
   const guideRelPath = `_content/${unitCode}/GUIDE_${lessonCode}.md`;
   if (artifactScope.includes("GUIDE") && (!await storage.readArtifact(projectId, guideRelPath) || force)) {
@@ -13369,6 +13621,24 @@ function getArtifactSpecializedInvariants(type, req) {
   const studentCount = req.studentCount || "25";
   switch (type) {
     case "slide": {
+      if (req.slidesEngine === "html") {
+        return `
+### \u{1F3AC} INTERACTIVE HTML SLIDE ENGINE CONTRACT:
+You generate structured slide decks for the LearnWell HTML Slide Presentation Engine.
+Output a single valid JSON object matching: { "title": "...", "theme": "ocean", "slides": [{ "layoutId": "hero-cover", "slots": { ... }, "notes": "..." }] }
+
+Layout Presets available:
+- hero-cover (title, subtitle, presenter, date, tag)
+- two-column-split (col1Title, col1Items[], col2Title, col2Items[])
+- code-explainer (filename, language, code, highlightLines, annotations[])
+- metrics-3-card (card1Title, card1Val, card1Desc, ...)
+- process-flow (steps: [{ label, desc, status }])
+- quiz-checkpoint (question, options[], answerIdx, explanation)
+- tiered-practice-3cards (foundation, standard, challenge cards)
+- takeaways-summary (takeaways: bullet points)
+
+Mandatory Presenter Notes on every slide with Talk Track, Cold-Call, and Scaffolding Tip.`;
+      }
       const slideCount = cfg.slideCount || 10;
       const presentationStyle = cfg.presentationStyle || "modern";
       const presentationDuration = cfg.presentationDuration || 45;
@@ -17449,6 +17719,7 @@ exports.buildExpositionExcerpt = buildExpositionExcerpt;
 exports.buildExtensionPrompt = buildExtensionPrompt;
 exports.buildHandoutPrompt = buildHandoutPrompt;
 exports.buildHeadingDirective = buildHeadingDirective;
+exports.buildHtmlDeckSlidePrompt = buildHtmlDeckSlidePrompt;
 exports.buildImagePrompt = buildImagePrompt;
 exports.buildJudgePrompt = buildJudgePrompt;
 exports.buildLanguageDirective = buildLanguageDirective;