@thanh01.pmt/curriculum-kit 1.2.1 → 1.4.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) {
@@ -9794,6 +9842,7 @@ function buildSectionAwareExcerpt(markdown, opts = {}) {
   }
   const slcMap = normalizeSlcContract(opts.sectionLanguageContract);
   const sections = parseMarkdownSections(source, slcMap, opts.artifactType);
+  const metaBlock = buildMetaBlock(source);
   if (sections.length === 0) {
     issues.push("parse:no-sections");
     const excerpt2 = truncateByBudget(source, budget);
@@ -9827,12 +9876,13 @@ function buildSectionAwareExcerpt(markdown, opts = {}) {
     const block = `## ${heading}
 
 ${trimmedBody}`;
-    if (used + block.length > budget && blocks.length > 0) return false;
+    if (used + block.length > budget && used > 0) return false;
     blocks.push(block);
     used += block.length;
     includedSections.push(key);
     return true;
   };
+  blocks.push(metaBlock);
   let sectionAware = false;
   for (const key of priorities) {
     const sec = byCanonical.get(key);
@@ -9849,6 +9899,9 @@ ${trimmedBody}`;
     if (used >= budget) break;
     if (!tryAdd(sec.cleanTitle, sec.body, sec.cleanTitle)) break;
   }
+  if (includedSections.length === 0 && unmatched.length > 0) {
+    issues.push("parse:no-canonical-resolution");
+  }
   if (priorities.length > 0 && !priorities.some((k) => includedSections.includes(k))) {
     issues.push("parse:no-priority-resolution");
   }
@@ -9857,14 +9910,14 @@ ${trimmedBody}`;
     excerpt = truncateByBudget(excerpt, budget);
   }
   const effectiveMinChars = Math.min(minContentChars, source.length);
-  if (excerpt.length < effectiveMinChars) {
+  if (excerpt.length - metaBlock.length < effectiveMinChars) {
     issues.push("content:insufficient");
   }
-  const verified = !issues.includes("parse:no-priority-resolution") && excerpt.length >= effectiveMinChars;
+  const verified = !issues.includes("parse:no-priority-resolution") && !issues.includes("parse:no-canonical-resolution") && excerpt.length - metaBlock.length >= effectiveMinChars;
   return {
     excerpt,
     verified,
-    sectionAware: sectionAware || priorities.length === 0 && sections.length > 0,
+    sectionAware: sectionAware || unmatched.length === 0,
     includedSections,
     issues,
     tokenEstimate: Math.round(excerpt.length / 4)
@@ -9980,6 +10033,18 @@ function truncateByBudget(source, budget) {
   if (fenceCount % 2 === 1) cut += "\n```";
   return cut;
 }
+function buildMetaBlock(source) {
+  const fm = source.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
+  const pick = (key) => {
+    if (!fm) return "";
+    const m = fm[1].match(new RegExp(`^${key}:\\s*"?([^"\\n]+)"?`, "m"));
+    return (m?.[1] || "").trim();
+  };
+  const id = pick("id");
+  const title = pick("title");
+  const type = pick("type");
+  return `<!-- SOURCE: ${type || "ARTIFACT"} | ${id || "unknown"}${title ? ` \u2014 ${title}` : ""} (section-aware excerpt; canonical knowledge, do not contradict) -->`;
+}
 
 // src/services/knowledgeExpositionService.ts
 var EXPOSITION_REL = (lessonCode) => "_sot/expositions/" + lessonCode + ".md";
@@ -10128,7 +10193,7 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
     storage,
     gates: options.gates
   });
-  return { relPath: result.relPath, context: buildExpositionContext(result.content), reused: result.reused };
+  return { relPath: result.relPath, context: buildExpositionContext(result.content), reused: result.reused, rawContent: result.content };
 }
 init_errors();
 var asArr = (v) => Array.isArray(v) ? v : [];
@@ -11839,6 +11904,8 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   targetLang = targetLang || "vi";
   const languageDirective = buildLanguageDirective(targetLang);
   let expositionContext = "";
+  let expositionInjection;
+  let lessonInjection;
   let sessionSliceContext = "";
   try {
     const exposition = await ensureExpositionForLesson(storage, projectId, lessonCode, {
@@ -11846,7 +11913,18 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
       force: options.force
     });
     if (exposition) {
-      expositionContext = exposition.context;
+      const expoExcerpt = buildExpositionExcerpt(exposition.rawContent || exposition.context, {
+        budget: 6e3,
+        sectionLanguageContract: slcMarkdown,
+        artifactType: "KNOWLEDGE_EXPOSITION"
+      });
+      expositionContext = expoExcerpt.excerpt || exposition.context;
+      expositionInjection = {
+        source: "KNOWLEDGE_EXPOSITION",
+        verified: expoExcerpt.verified,
+        sectionAware: expoExcerpt.sectionAware,
+        issues: expoExcerpt.issues
+      };
       onProgress?.("@content", `[EXPOSITION] ${exposition.reused ? "Reused" : "Generated"} \`\${exposition.relPath}\` (plan-driven knowledge source)...`);
     } else {
       onProgress?.("@content", "[EXPOSITION] No CURRICULUM_PLAN.json \u2014 running legacy knowledge flow (no plan-driven exposition).");
@@ -12086,6 +12164,7 @@ ${yamlBlock.trim()}
       };
       var injectYamlReviewMetadata = injectYamlReviewMetadata2;
       const judgeObjectives = parseLessonObjectives(lessonContent, concept, bloomLevel);
+      const judgeExpositionExcerpt = expositionContext ? buildExpositionExcerpt(expositionContext, { budget: 3e3, sectionLanguageContract: slcMarkdown, artifactType: "KNOWLEDGE_EXPOSITION" }).excerpt : void 0;
       const judgeResult = await LLMJudgeEngine.evaluateArtifactWithLLM({
         targetArtifactType: "LESSON",
         lessonId: lessonCode,
@@ -12097,7 +12176,7 @@ ${yamlBlock.trim()}
           title: lessonTitle,
           frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
           styleGuideExcerpt: effectiveStyleGuide || void 0,
-          canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
+          canonicalExposition: judgeExpositionExcerpt
         }),
         standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
       });
@@ -12152,6 +12231,16 @@ ${currentContent}` }],
               options.onProgress?.("@repair", chunk, { type: type || "content", artifactType: "LESSON" });
             }
           );
+          const repairedExcerptCheck = buildSectionAwareExcerpt(repairedRaw, {
+            priorities: DEFAULT_LESSON_PRIORITIES,
+            budget: 12e3,
+            sectionLanguageContract: slcMarkdown,
+            artifactType: "LESSON"
+          });
+          if (repairedExcerptCheck.issues.includes("parse:no-priority-resolution")) {
+            onProgress?.("@repair", `\u26A0\uFE0F Repair round ${round} lost mandatory section structure (no priority section resolved) \u2014 rejecting repaired draft, retaining previous`);
+            break;
+          }
           if (!repairedRaw || repairedRaw.startsWith("\u26A0\uFE0F") || repairedRaw.length < 200) {
             onProgress?.("@repair", `\u26A0\uFE0F Repair round ${round} produced invalid output \u2014 stopping repair loop`);
             break;
@@ -12176,7 +12265,7 @@ ${currentContent}` }],
               title: lessonTitle,
               frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
               styleGuideExcerpt: effectiveStyleGuide || void 0,
-              canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
+              canonicalExposition: expositionContext ? buildExpositionExcerpt(expositionContext, { budget: 3e3, sectionLanguageContract: slcMarkdown, artifactType: "KNOWLEDGE_EXPOSITION" }).excerpt : void 0
             }),
             standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
           });
@@ -12234,7 +12323,9 @@ ${currentContent}` }],
             pedagogy,
             producedArtifacts,
             pausedForReview: true,
-            gateStatus: "judge_needs_revision"
+            gateStatus: "judge_needs_revision",
+            contextInjection: expositionInjection || lessonInjection,
+            promptChars: commonContext.length
           };
         }
       }
@@ -12257,7 +12348,9 @@ ${currentContent}` }],
         pedagogy,
         producedArtifacts,
         pausedForReview: true,
-        gateStatus: "judge_error"
+        gateStatus: "judge_error",
+        contextInjection: expositionInjection,
+        promptChars: commonContext.length
       };
     }
   }
@@ -12287,7 +12380,9 @@ ${currentContent}` }],
       pedagogy,
       producedArtifacts,
       pausedForReview: true,
-      gateStatus: "awaiting_approval"
+      gateStatus: "awaiting_approval",
+      contextInjection: expositionInjection,
+      promptChars: commonContext.length
     };
   }
   if (isLessonApproved && currentLessonInfo?.state !== "approved") {
@@ -12304,6 +12399,13 @@ ${currentContent}` }],
     artifactType: "LESSON"
   });
   const lessonExcerpt = lessonExcerptResult.excerpt;
+  const lessonInjectionMeta = {
+    source: "LESSON",
+    verified: lessonExcerptResult.verified,
+    sectionAware: lessonExcerptResult.sectionAware,
+    issues: lessonExcerptResult.issues
+  };
+  lessonInjection = lessonInjectionMeta;
   const satelliteContext = `${commonContext}
 
 [CANONICAL LESSON PLAN (${pedagogyLabel})]:
@@ -12462,46 +12564,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)) {
@@ -12814,7 +13045,9 @@ ${buildHeadingDirective("EXT", slcMarkdown, targetLang)}`;
     lessonId: lessonCode,
     pedagogy,
     producedArtifacts,
-    pausedForReview: false
+    pausedForReview: false,
+    contextInjection: lessonInjection && lessonInjection.verified ? expositionInjection || lessonInjection : lessonInjection || expositionInjection,
+    promptChars: commonContext.length
   };
 }
 function parseLessonObjectives(lessonContent, concept, bloomLevel) {
@@ -13444,6 +13677,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;
@@ -17524,6 +17775,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;