@thanh01.pmt/curriculum-kit 1.4.23 → 1.4.24

package/dist/index.cjs

@@ -26203,7 +26203,22 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   const framework = await storage.readSotDocument(projectId, "CURRICULUM_FRAMEWORK.md") || "";
   const styleGuide = await storage.readSotDocument(projectId, "CONTENT_STYLE_GUIDE.md") || "";
   const refPack = await storage.readSotDocument(projectId, "REFERENCE_PACK.md") || "";
+  let currentPlanHash;
+  try {
+    const planRaw0 = await storage.readArtifact(projectId, "_sot/CURRICULUM_PLAN.json");
+    if (planRaw0) currentPlanHash = JSON.parse(planRaw0).plan_hash;
+  } catch {
+  }
   await storage.readSotDocument(projectId, "LEARNER_PROFILE.md") || "";
+  const isStaleVsPlan = (content) => {
+    if (!content || !currentPlanHash) return false;
+    const m = content.match(/plan_hash:\s*"([0-9a-f]+)"/);
+    return !!m && m[1] !== currentPlanHash;
+  };
+  const stampPlanHash = (content) => {
+    if (!currentPlanHash || content.includes('plan_hash: "' + currentPlanHash + '"')) return content;
+    return content + '\n---\nplan_hash: "' + currentPlanHash + '"\n- **Plan reference:** ' + currentPlanHash + "\n";
+  };
   const slcMarkdown = options.sectionLanguageContract || await storage.readSotDocument(projectId, "SECTION_LANGUAGE_CONTRACT.md") || "";
   let targetLang = options.targetLanguage;
   if (!targetLang) {
@@ -26414,7 +26429,10 @@ ${sg}${standardsBlock}${glossaryBlock}${buildGroundTruthBlock()}${sessionSliceBl
   const lessonRelPath = `_content/${unitCode}/LESSON_${lessonCode}.md`;
   const existingLessonContent = await storage.readArtifact(projectId, lessonRelPath);
   let lessonContent = existingLessonContent || "";
-  if (artifactScope.includes("LESSON") && (!existingLessonContent || force)) {
+  if (artifactScope.includes("LESSON") && (!existingLessonContent || force || isStaleVsPlan(existingLessonContent))) {
+    if (existingLessonContent && !force && isStaleVsPlan(existingLessonContent)) {
+      onProgress?.("@content", `[STALENESS] LESSON_${lessonCode} was generated under a different plan_hash \u2014 regenerating against the current plan.`);
+    }
     onProgress?.("@content", `[1/4] Authoring Master Lesson Plan (${pedagogyLabel}): \`LESSON_${lessonCode}.md\` (${lessonTitle})...`);
     const dateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const mediaDirective = options.mediaPolicy && options.mediaPolicy.maxGenImagesPerArtifact > 0 ? `
@@ -26485,7 +26503,7 @@ Fix ALL issues above and output the complete corrected document.` }],
     } else {
       lessonContent = lintReport.autoFixedContent || rawLesson;
     }
-    await storage.saveArtifact(projectId, lessonRelPath, lessonContent);
+    await storage.saveArtifact(projectId, lessonRelPath, stampPlanHash(lessonContent));
     producedArtifacts.push(`LESSON_${lessonCode}.md`);
   }
   const contentHash = lessonContent ? computeContentHash(lessonContent) : void 0;
@@ -26830,7 +26848,8 @@ ${lessonExcerpt}${symbolLedgerBlock}`;
     });
   };
   const actRelPath = `_content/${unitCode}/ACT_${lessonCode}.md`;
-  if (artifactScope.includes("ACT") && (!await storage.readArtifact(projectId, actRelPath) || force)) {
+  const existingAct = await storage.readArtifact(projectId, actRelPath);
+  if (artifactScope.includes("ACT") && (!existingAct || force || isStaleVsPlan(existingAct))) {
     onProgress?.("@activity", `[2/4] Authoring Hands-on Lab: \`ACT_${lessonCode}.md\`...`);
     const actDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const actPrompt = `You are @activity (Lead Hands-on STEM & Laboratory Exercise Designer).
@@ -26890,7 +26909,7 @@ ${buildHeadingDirective("ACT", slcMarkdown, targetLang)}`;
         rawError: rawAct || "Empty AI response"
       });
     }
-    await storage.saveArtifact(projectId, actRelPath, rawAct);
+    await storage.saveArtifact(projectId, actRelPath, stampPlanHash(rawAct));
     await storage.updateArtifactState(projectId, lessonCode, "ACT", {
       state: "completed",
       generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -26900,7 +26919,8 @@ ${buildHeadingDirective("ACT", slcMarkdown, targetLang)}`;
     await judgeSat("ACT", rawAct);
   }
   const quizRelPath = `_content/${unitCode}/QUIZ_${lessonCode}.md`;
-  if (artifactScope.includes("QUIZ") && (!await storage.readArtifact(projectId, quizRelPath) || force)) {
+  const existingQuiz = await storage.readArtifact(projectId, quizRelPath);
+  if (artifactScope.includes("QUIZ") && (!existingQuiz || force || isStaleVsPlan(existingQuiz))) {
     onProgress?.("@assessor", `[3/4] Authoring Assessment Bank: \`QUIZ_${lessonCode}.md\`...`);
     const quizDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const quizPrompt = `You are @assessor (Lead Psychometrician & Competency Assessment Specialist).
@@ -26954,7 +26974,7 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
         rawError: rawQuiz || "Empty AI response"
       });
     }
-    await storage.saveArtifact(projectId, quizRelPath, rawQuiz);
+    await storage.saveArtifact(projectId, quizRelPath, stampPlanHash(rawQuiz));
     await storage.updateArtifactState(projectId, lessonCode, "QUIZ", {
       state: "completed",
       generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -26964,7 +26984,8 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
     await judgeSat("QUIZ", rawQuiz);
   }
   const slideRelPath = `_content/${unitCode}/SLIDE_${lessonCode}.md`;
-  if (artifactScope.includes("SLIDE") && (!await storage.readArtifact(projectId, slideRelPath) || force)) {
+  const existingSlide = await storage.readArtifact(projectId, slideRelPath);
+  if (artifactScope.includes("SLIDE") && (!existingSlide || force || isStaleVsPlan(existingSlide))) {
     onProgress?.("@illustrator", `[4/4] Authoring Presentation Slide Deck: \`SLIDE_${lessonCode}.md\`...`);
     const isHtmlEngine = options.slidesEngine !== "marp";
     if (isHtmlEngine) {
@@ -26998,7 +27019,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" }]};
-      await storage.saveArtifact(projectId, slideRelPath, markdownWrapper);
+      await storage.saveArtifact(projectId, slideRelPath, stampPlanHash(markdownWrapper));
       producedArtifacts.push(`SLIDE_${lessonCode}.md`);
       if (deckJson) {
         const deckJsonStr = JSON.stringify(deckJson, null, 2);
@@ -27089,7 +27110,7 @@ footer: "Curriculum OS \u2022 ${lessonCode} (${pedagogyLabel})"
           rawError: rawSlide || "Empty AI response"
         });
       }
-      await storage.saveArtifact(projectId, slideRelPath, rawSlide);
+      await storage.saveArtifact(projectId, slideRelPath, stampPlanHash(rawSlide));
       await storage.updateArtifactState(projectId, lessonCode, "SLIDE", {
         state: "completed",
         generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -27100,7 +27121,8 @@ footer: "Curriculum OS \u2022 ${lessonCode} (${pedagogyLabel})"
     }
   }
   const guideRelPath = `_content/${unitCode}/GUIDE_${lessonCode}.md`;
-  if (artifactScope.includes("GUIDE") && (!await storage.readArtifact(projectId, guideRelPath) || force)) {
+  const existingGuide = await storage.readArtifact(projectId, guideRelPath);
+  if (artifactScope.includes("GUIDE") && (!existingGuide || force || isStaleVsPlan(existingGuide))) {
     onProgress?.("@content", `Authoring Teacher Guide: \`GUIDE_${lessonCode}.md\`...`, { artifactType: "GUIDE" });
     const guideDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const guidePrompt = `You are @content (Senior Curriculum Developer & Teacher Facilitation Specialist).
@@ -27140,7 +27162,7 @@ ${buildHeadingDirective("GUIDE", slcMarkdown, targetLang)}`;
       }
     );
     if (rawGuide && !rawGuide.startsWith("\u26A0\uFE0F") && rawGuide.length >= 200) {
-      await storage.saveArtifact(projectId, guideRelPath, rawGuide);
+      await storage.saveArtifact(projectId, guideRelPath, stampPlanHash(rawGuide));
       await storage.updateArtifactState(projectId, lessonCode, "GUIDE", {
         state: "completed",
         generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -27151,7 +27173,8 @@ ${buildHeadingDirective("GUIDE", slcMarkdown, targetLang)}`;
     }
   }
   const handoutRelPath = `_content/${unitCode}/HANDOUT_${lessonCode}.md`;
-  if (artifactScope.includes("HANDOUT") && (!await storage.readArtifact(projectId, handoutRelPath) || force)) {
+  const existingHandout = await storage.readArtifact(projectId, handoutRelPath);
+  if (artifactScope.includes("HANDOUT") && (!existingHandout || force || isStaleVsPlan(existingHandout))) {
     onProgress?.("@content", `Authoring Student Handout: \`HANDOUT_${lessonCode}.md\`...`, { artifactType: "HANDOUT" });
     const handoutDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const handoutPrompt = `You are @content (Educational Content Specialist).
@@ -27191,7 +27214,7 @@ ${buildHeadingDirective("HANDOUT", slcMarkdown, targetLang)}`;
       }
     );
     if (rawHandout && !rawHandout.startsWith("\u26A0\uFE0F") && rawHandout.length >= 200) {
-      await storage.saveArtifact(projectId, handoutRelPath, rawHandout);
+      await storage.saveArtifact(projectId, handoutRelPath, stampPlanHash(rawHandout));
       await storage.updateArtifactState(projectId, lessonCode, "HANDOUT", {
         state: "completed",
         generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -27202,7 +27225,8 @@ ${buildHeadingDirective("HANDOUT", slcMarkdown, targetLang)}`;
     }
   }
   const wksRelPath = `_content/${unitCode}/WKS_${lessonCode}.md`;
-  if (artifactScope.includes("WKS") && (!await storage.readArtifact(projectId, wksRelPath) || force)) {
+  const existingWks = await storage.readArtifact(projectId, wksRelPath);
+  if (artifactScope.includes("WKS") && (!existingWks || force || isStaleVsPlan(existingWks))) {
     onProgress?.("@content", `Authoring Student Worksheet: \`WKS_${lessonCode}.md\`...`, { artifactType: "WKS" });
     const wksDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const wksPrompt = `You are @content (Instructional Activity & Worksheet Designer).
@@ -27246,7 +27270,7 @@ ${buildHeadingDirective("WKS", slcMarkdown, targetLang)}`;
       }
     );
     if (rawWks && !rawWks.startsWith("\u26A0\uFE0F") && rawWks.length >= 200) {
-      await storage.saveArtifact(projectId, wksRelPath, rawWks);
+      await storage.saveArtifact(projectId, wksRelPath, stampPlanHash(rawWks));
       await storage.updateArtifactState(projectId, lessonCode, "WKS", {
         state: "completed",
         generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -27257,7 +27281,8 @@ ${buildHeadingDirective("WKS", slcMarkdown, targetLang)}`;
     }
   }
   const codeRelPath = `_content/${unitCode}/CODE_${lessonCode}.md`;
-  if ((artifactScope.includes("CODE") || artifactScope.includes("CODE_LAB")) && (!await storage.readArtifact(projectId, codeRelPath) || force)) {
+  const existingCode = await storage.readArtifact(projectId, codeRelPath);
+  if ((artifactScope.includes("CODE") || artifactScope.includes("CODE_LAB")) && (!existingCode || force || isStaleVsPlan(existingCode))) {
     onProgress?.("@activity", `Authoring Executable Code Lab: \`CODE_${lessonCode}.md\`...`, { artifactType: "CODE" });
     const codeDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const codePrompt = `You are @activity & @tech_sme (Lead Software Engineer & Technical SME).
@@ -27305,7 +27330,7 @@ ${buildHeadingDirective("CODE", slcMarkdown, targetLang)}`;
       }
     );
     if (rawCode && !rawCode.startsWith("\u26A0\uFE0F") && rawCode.length >= 200) {
-      await storage.saveArtifact(projectId, codeRelPath, rawCode);
+      await storage.saveArtifact(projectId, codeRelPath, stampPlanHash(rawCode));
       await storage.updateArtifactState(projectId, lessonCode, "CODE", {
         state: "completed",
         generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -27321,7 +27346,8 @@ ${buildHeadingDirective("CODE", slcMarkdown, targetLang)}`;
     }
   }
   const extRelPath = `_content/${unitCode}/EXT_${lessonCode}.md`;
-  if (artifactScope.includes("EXT") && (!await storage.readArtifact(projectId, extRelPath) || force)) {
+  const existingExt = await storage.readArtifact(projectId, extRelPath);
+  if (artifactScope.includes("EXT") && (!existingExt || force || isStaleVsPlan(existingExt))) {
     onProgress?.("@activity", `Authoring Advanced Extension Challenge: \`EXT_${lessonCode}.md\`...`, { artifactType: "EXT" });
     const extDateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const isVi = targetLang === "vi";
@@ -27391,7 +27417,7 @@ ${buildHeadingDirective("EXT", slcMarkdown, targetLang)}`;
       }
     );
     if (rawExt && !rawExt.startsWith("\u26A0\uFE0F") && rawExt.length >= 200) {
-      await storage.saveArtifact(projectId, extRelPath, rawExt);
+      await storage.saveArtifact(projectId, extRelPath, stampPlanHash(rawExt));
       await storage.updateArtifactState(projectId, lessonCode, "EXT", {
         state: "completed",
         generatedAt: (/* @__PURE__ */ new Date()).toISOString(),