@thanh01.pmt/curriculum-kit 1.4.20 → 1.4.21

package/dist/index.cjs

@@ -1513,7 +1513,8 @@ function buildSlideBatchPrompt(params) {
     skillPrompt,
     language = "Vietnamese",
     languageDirective = "",
-    headingDirective = ""
+    headingDirective = "",
+    groundContext = ""
   } = params;
   const slidesSpec = clusterSlides.map((s) => `
 - Slide ${s.slideIndex} [Phase: ${s.lessonPhase}] -> Layout: "${s.layoutId}"
@@ -1526,7 +1527,11 @@ function buildSlideBatchPrompt(params) {
   const systemPrompt = `
 ${skillPrompt}
 
----
+${groundContext ? `---
+### PROJECT GROUND CONTEXT (framework, style guide, glossary, canonical knowledge \u2014 author from these):
+${groundContext}
+
+---` : ""}
 ### OPERATIONAL GROUND RULES FOR CHUNK GENERATION:
 ${languageDirective}
 ${headingDirective}
@@ -1604,6 +1609,7 @@ __export(slideProductionWorkflow_exports, {
   HybridPipelineError: () => exports.HybridPipelineError,
   SlideBlueprintArraySchema: () => exports.SlideBlueprintArraySchema,
   SlideBlueprintItemSchema: () => exports.SlideBlueprintItemSchema,
+  emitUsage: () => emitUsage,
   executeSlideProductionWorkflow: () => executeSlideProductionWorkflow,
   extractJsonArray: () => extractJsonArray,
   validateHybridDeckSlides: () => validateHybridDeckSlides
@@ -1656,15 +1662,28 @@ function validateHybridDeckSlides(slides, blueprint) {
   });
   return v.slice(0, 10);
 }
+function emitUsage(usage, onProgress) {
+  if (!onProgress || !usage) return;
+  const promptTokens = usage.promptTokens ?? usage.inputTokens ?? 0;
+  const completionTokens = usage.completionTokens ?? usage.outputTokens ?? 0;
+  if (promptTokens === 0 && completionTokens === 0) return;
+  onProgress("@illustrator", JSON.stringify({
+    promptTokens,
+    completionTokens,
+    totalTokens: usage.totalTokens ?? promptTokens + completionTokens,
+    reasoningTokens: usage.reasoningTokens ?? 0
+  }), { type: "usage" });
+}
 async function inferTextJson(schema, systemPrompt, userPrompt, options, label) {
   const model = getAIModel(options.modelOptions);
   try {
-    const { text, finishReason } = await ai.generateText({
+    const { text, finishReason, usage } = await ai.generateText({
       model,
       system: systemPrompt || void 0,
       prompt: userPrompt,
       maxOutputTokens: options.maxOutputTokens ?? 65536
     });
+    emitUsage(usage, options.onProgress);
     const extracted = extractJsonArray(text);
     if (!("value" in extracted) || extracted.value === void 0) {
       console.warn(
@@ -1685,12 +1704,13 @@ async function inferTextJson(schema, systemPrompt, userPrompt, options, label) {
 async function inferStructured(schema, systemPrompt, userPrompt, options, label) {
   try {
     const model = getAIModel(options.modelOptions);
-    const { object } = await ai.generateObject({
+    const { object, usage } = await ai.generateObject({
       model,
       schema,
       system: systemPrompt || void 0,
       prompt: userPrompt
     });
+    emitUsage(usage, options.onProgress);
     const validated = schema.safeParse(object);
     if (validated.success) return validated.data;
     console.warn(
@@ -1705,7 +1725,9 @@ async function inferStructured(schema, systemPrompt, userPrompt, options, label)
     const messages = [
       { role: "user", content: [systemPrompt, userPrompt].filter(Boolean).join("\n\n") }
     ];
-    const raw = await runCurriculumAIInference(messages, options.satelliteContext || "", options.runnerOptions);
+    const raw = await runCurriculumAIInference(messages, options.satelliteContext || "", options.runnerOptions, (token, type) => {
+      if (type === "usage") options.onProgress?.("@illustrator", token, { type: "usage" });
+    });
     const fenceMatch = raw.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
     const candidate = (fenceMatch ? fenceMatch[1] : raw).trim();
     let parsed;
@@ -1738,7 +1760,7 @@ function normalizeBlueprintItems(items) {
   }));
 }
 function buildHybridDeckPrompts(params) {
-  const { lessonFlow, blueprint, skillPrompt, language, languageDirective, headingDirective } = params;
+  const { lessonFlow, blueprint, skillPrompt, language, languageDirective, headingDirective, groundContext } = params;
   const blueprintText = JSON.stringify(
     blueprint.map((s) => ({
       slideIndex: s.slideIndex,
@@ -1757,6 +1779,7 @@ function buildHybridDeckPrompts(params) {
 ${p.content}`).join("\n\n") : lessonFlow.rawContent;
   const systemPrompt = [
     skillPrompt,
+    groundContext || "",
     languageDirective,
     headingDirective,
     `
@@ -1821,7 +1844,8 @@ async function runHybridPipeline(ctx) {
     skillPrompt,
     language,
     languageDirective,
-    headingDirective
+    headingDirective,
+    groundContext: options.groundContext
   });
   let slides = null;
   let lastViolations = [];
@@ -1970,7 +1994,8 @@ ${p.content}`).join("\n\n") : lessonFlow.rawContent.slice(0, 3500);
         skillPrompt,
         language,
         languageDirective,
-        headingDirective
+        headingDirective,
+        groundContext: options.groundContext
       });
       try {
         const batchSlides = await pRetry__default.default(
@@ -9312,6 +9337,21 @@ var STANDARD_SOT_FILES = [
   "ART_DIRECTION.md",
   "ALIGNMENT_MATRIX.md"
 ];
+function atomicWriteFileSync(targetPath, content) {
+  const dir = path3__default.default.dirname(targetPath);
+  if (!fs2__default.default.existsSync(dir)) fs2__default.default.mkdirSync(dir, { recursive: true });
+  const tmpPath = path3__default.default.join(dir, `.${path3__default.default.basename(targetPath)}.${process.pid}.${Date.now()}.${crypto__default.default.randomBytes(4).toString("hex")}.tmp`);
+  try {
+    fs2__default.default.writeFileSync(tmpPath, content, "utf-8");
+    fs2__default.default.renameSync(tmpPath, targetPath);
+  } catch (err) {
+    try {
+      if (fs2__default.default.existsSync(tmpPath)) fs2__default.default.unlinkSync(tmpPath);
+    } catch {
+    }
+    throw err;
+  }
+}
 var FileSystemCurriculumAdapter = class {
   baseDir;
   constructor(options = {}) {
@@ -9450,7 +9490,7 @@ var FileSystemCurriculumAdapter = class {
         if (oldContent !== content) {
           const historyDir = path3__default.default.join(projectDir, ".history", relPath);
           fs2__default.default.mkdirSync(historyDir, { recursive: true });
-          fs2__default.default.writeFileSync(path3__default.default.join(historyDir, `${Date.now()}.md`), oldContent, "utf-8");
+          atomicWriteFileSync(path3__default.default.join(historyDir, `${Date.now()}.md`), oldContent);
           const versions = fs2__default.default.readdirSync(historyDir).filter((f) => f.endsWith(".md")).sort();
           while (versions.length > 10) {
             fs2__default.default.unlinkSync(path3__default.default.join(historyDir, versions.shift()));
@@ -9460,19 +9500,15 @@ var FileSystemCurriculumAdapter = class {
         console.warn("[FileSystemCurriculumAdapter] version history snapshot failed:", histErr?.message || histErr);
       }
     }
-    fs2__default.default.writeFileSync(targetPath, content, "utf-8");
+    atomicWriteFileSync(targetPath, content);
     const filename = path3__default.default.basename(relPath);
     const match = filename.match(/(LESSON|ACT|QUIZ|SLIDE|GUIDE|HANDOUT|WKS|EXT)_(U\d+_M\d+_L\d+)\.md/i);
     if (match) {
       const lessonId = match[2].toUpperCase();
-      const lessonsDir = path3__default.default.join(projectDir, "lessons", lessonId);
-      if (!fs2__default.default.existsSync(lessonsDir)) {
-        fs2__default.default.mkdirSync(lessonsDir, { recursive: true });
-      }
-      fs2__default.default.writeFileSync(path3__default.default.join(lessonsDir, filename), content, "utf-8");
+      atomicWriteFileSync(path3__default.default.join(projectDir, "lessons", lessonId, filename), content);
       const legacyContentDir = path3__default.default.join(projectDir, "_content", lessonId);
       if (fs2__default.default.existsSync(legacyContentDir)) {
-        fs2__default.default.writeFileSync(path3__default.default.join(legacyContentDir, filename), content, "utf-8");
+        atomicWriteFileSync(path3__default.default.join(legacyContentDir, filename), content);
       }
     }
   }
@@ -9563,7 +9599,7 @@ ${lessonTable}
     }
     const stateFile = path3__default.default.join(pipelineDir, "state.json");
     state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    fs2__default.default.writeFileSync(stateFile, JSON.stringify(state, null, 2), "utf-8");
+    atomicWriteFileSync(stateFile, JSON.stringify(state, null, 2));
   }
   async updateArtifactState(projectId, taskId, artifactType, update) {
     const current = await this.getPipelineState(projectId);
@@ -11263,6 +11299,13 @@ var DEFAULT_LESSON_PRIORITIES = [
   "Learning Objectives & Evidence",
   "Activity Sequence"
 ];
+var SATELLITE_LESSON_PRIORITIES = [
+  "Artifact Contract",
+  "A. Lesson Design Plan",
+  "B. Lesson Flow",
+  "Learning Objectives & Evidence",
+  "Activity Sequence"
+];
 var DEFAULT_KX_PRIORITIES = [
   "Key Terms",
   "Concept Narratives",
@@ -26094,6 +26137,21 @@ ${renderHorizonPromptBlock(horizon)}`;
   } catch (hErr) {
     console.warn(`[produceSingleLesson] Notice: Curriculum Horizon extraction:`, hErr?.message || hErr);
   }
+  const buildGroundTruthBlock = () => {
+    const parts = [];
+    if (expositionContext) {
+      parts.push(`### KNOWLEDGE_EXPOSITION (CANONICAL KNOWLEDGE \u2014 teach from this, do not contradict)
+${expositionContext}`);
+    }
+    if (effectiveRefPack) {
+      parts.push(`### REFERENCE PACK GROUND TRUTH
+${effectiveRefPack}`);
+    }
+    return parts.length > 0 ? `
+
+[GROUND TRUTH]:
+${parts.join("\n\n")}` : "";
+  };
   const glossaryBlock = glossaryContext ? `
 
 [GLOSSARY TERMS (use these exact definitions)]:
@@ -26101,21 +26159,14 @@ ${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}
+  const assembleCommonContext = (sg) => `${baseContextPrefix}
 
 [CONTENT STYLE GUIDE EXCERPT]:
-${sg}
-
-[REFERENCE PACK GROUND TRUTH]:
-${ref}${standardsBlock}${glossaryBlock}${expositionBlock}${sessionSliceBlock}${horizonBlock}`;
-  let commonContext = assembleCommonContext(effectiveRefPack, effectiveStyleGuide);
+${sg}${standardsBlock}${glossaryBlock}${buildGroundTruthBlock()}${sessionSliceBlock}${horizonBlock}`;
+  let commonContext = assembleCommonContext(effectiveStyleGuide);
   const MAX_COMPOSITE_PROMPT_CHARS = 3e4;
   const runnerOptions = options.customInference ? { customInference: options.customInference } : {};
   if (commonContext.length > MAX_COMPOSITE_PROMPT_CHARS && effectiveRefPack.length > 1e3) {
@@ -26126,14 +26177,14 @@ ${ref}${standardsBlock}${glossaryBlock}${expositionBlock}${sessionSliceBlock}${h
       ],
       budget: 1e3
     }).excerpt;
-    commonContext = assembleCommonContext(effectiveRefPack, effectiveStyleGuide);
+    commonContext = assembleCommonContext(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);
+    commonContext = assembleCommonContext(effectiveStyleGuide);
   }
   onProgress?.("@content", `[CONTEXT] Composite prompt ready (${commonContext.length} chars, adaptive budget <= ${MAX_COMPOSITE_PROMPT_CHARS})`, {
     type: "progress",
@@ -26484,7 +26535,7 @@ ${currentContent}` }],
     });
   }
   const lessonExcerptResult = buildSectionAwareExcerpt(lessonContent, {
-    priorities: DEFAULT_LESSON_PRIORITIES,
+    priorities: SATELLITE_LESSON_PRIORITIES,
     budget: 12e3,
     sectionLanguageContract: slcMarkdown,
     artifactType: "LESSON"
@@ -26674,6 +26725,7 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
       } catch {
       }
       const { executeSlideProductionWorkflow: executeSlideProductionWorkflow2 } = await Promise.resolve().then(() => (init_slideProductionWorkflow(), slideProductionWorkflow_exports));
+      const slideGroundContext = `${commonContext}${symbolLedgerBlock}`;
       const workflowResult = await executeSlideProductionWorkflow2({
         lessonMarkdown: lessonContent || "",
         lessonCode,
@@ -26682,6 +26734,7 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
         language: targetLang || "Vietnamese",
         languageDirective,
         headingDirective: buildHeadingDirective("SLIDE", slcMarkdown, targetLang),
+        groundContext: slideGroundContext,
         satelliteContext,
         runnerOptions,
         onProgress: (agent, msg, meta) => {
@@ -26690,7 +26743,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" }], slideCount: 0};
+      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);
       producedArtifacts.push(`SLIDE_${lessonCode}.md`);
       if (deckJson) {
@@ -26710,21 +26763,45 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
           }
         }
       }
-      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]`);
+      const structuralOk = Boolean(validation.valid && (validation.score ?? 100) >= 80);
+      const structuralScore = validation.score ?? (structuralOk ? 95 : 50);
+      const gateMode = gateModeFor(gates, "SLIDE");
+      if (!structuralOk) {
+        await storage.updateArtifactState(projectId, lessonCode, "SLIDE", {
+          state: "rejected",
+          generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          contentHash: computeContentHash(markdownWrapper),
+          review: {
+            decision: "NEEDS_REVISION",
+            reviewedBy: "@heuristic-linter",
+            reviewedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            score: structuralScore,
+            critique: `HTML Slide Deck failed schema validation: ${(validation.issues || []).map((i) => i.message).join("; ")}`
+          }
+        });
+        onProgress?.("@reviewer", `\u26A0\uFE0F SLIDE structural pre-check FAILED (${structuralScore}/100) [html-deck schema issues]`);
+      } else {
+        await storage.updateArtifactState(projectId, lessonCode, "SLIDE", {
+          state: gateMode === "LLM_JUDGE" ? "pending" : "completed",
+          generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          contentHash: computeContentHash(markdownWrapper)
+        });
+        onProgress?.("@reviewer", gateMode === "LLM_JUDGE" ? `\u2705 SLIDE structural pre-check PASS (${structuralScore}/100) \u2014 handing content review to LLM-as-Judge gate` : `\u2705 SLIDE structural pre-check PASS (${structuralScore}/100) [gate=${gateMode}, no LLM judge]`);
+        const deckTextForJudge = Array.isArray(deckJson?.slides) ? deckJson.slides.map((s, i) => {
+          const slotLines = Object.entries(s.slots || {}).map(([k, v]) => {
+            if (Array.isArray(v)) return `- ${k}:
+${v.map((item) => typeof item === "object" ? `  - ${JSON.stringify(item)}` : `  - ${item}`).join("\n")}`;
+            if (v && typeof v === "object") return `- ${k}: ${JSON.stringify(v, null, 1)}`;
+            return `- ${k}: ${v}`;
+          }).join("\n");
+          return `## Slide ${i + 1} [${s.layoutId}]
+${slotLines}
+
+Presenter Notes:
+${s.notes || "(none)"}`;
+        }).join("\n\n") : String(markdownWrapper);
+        await judgeSat("SLIDE", deckTextForJudge);
+      }
     } else {
       const canonicalSlideTemplate = loadCurriculumTemplate("SLIDE_template.md");
       const templateScaffold = canonicalSlideTemplate || `---
@@ -31873,6 +31950,7 @@ exports.RoadmapInputSchema = RoadmapInputSchema;
 exports.RotationStationSchema = RotationStationSchema;
 exports.RubricCriteriaSchema = RubricCriteriaSchema;
 exports.RubricSchema = RubricSchema;
+exports.SATELLITE_LESSON_PRIORITIES = SATELLITE_LESSON_PRIORITIES;
 exports.SCIENCE_LAB_TEMPLATE = SCIENCE_LAB_TEMPLATE;
 exports.SELF_LAB_TEMPLATE = SELF_LAB_TEMPLATE;
 exports.SLIDE_CANONICAL_METHODOLOGY = SLIDE_CANONICAL_METHODOLOGY;
@@ -31922,6 +32000,7 @@ exports.analystTools = analystTools;
 exports.analyzeProjectCreationIntent = analyzeProjectCreationIntent;
 exports.assertAcyclic = assertAcyclic;
 exports.assessorTools = assessorTools;
+exports.atomicWriteFileSync = atomicWriteFileSync;
 exports.auditCurriculumQualityFlow = auditCurriculumQualityFlow;
 exports.auditQualityReport = auditQualityReport;
 exports.buildActivityPrompt = buildActivityPrompt;
@@ -31969,6 +32048,7 @@ exports.createStreamChunkExtractor = createStreamChunkExtractor;
 exports.curateMediaLedger = curateMediaLedger;
 exports.designerTools = designerTools;
 exports.detectProjectPedagogy = detectProjectPedagogy;
+exports.emitUsage = emitUsage;
 exports.ensureExpositionForLesson = ensureExpositionForLesson;
 exports.ensureKnowledgeExposition = ensureKnowledgeExposition;
 exports.evaluateStandardsCoverage = evaluateStandardsCoverage;