@thanh01.pmt/curriculum-kit 1.2.1 → 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) {
@@ -12462,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)) {
@@ -13444,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;
@@ -17524,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;