@thanh01.pmt/curriculum-kit 1.4.24 → 1.4.25

package/dist/index.d.cts

@@ -1076,6 +1076,10 @@ interface SlideProductionWorkflowOptions {
      * already injected into user prompts via parseLessonFlow (no duplication).
      */
     groundContext?: string;
+    /** Canonical PRODUCT_SPEC block (prompt audit S-1): injected into the
+     *  blueprint prompt so deck-wide content decisions see binding platform/
+     *  version facts even though the blueprint call carries no groundContext. */
+    productSpecBlock?: string;
     satelliteContext?: any;
     /** Vercel AI SDK model resolution options (provider/model/apiKey). */
     modelOptions?: ModelResolutionOptions;

package/dist/index.d.ts

@@ -1076,6 +1076,10 @@ interface SlideProductionWorkflowOptions {
      * already injected into user prompts via parseLessonFlow (no duplication).
      */
     groundContext?: string;
+    /** Canonical PRODUCT_SPEC block (prompt audit S-1): injected into the
+     *  blueprint prompt so deck-wide content decisions see binding platform/
+     *  version facts even though the blueprint call carries no groundContext. */
+    productSpecBlock?: string;
     satelliteContext?: any;
     /** Vercel AI SDK model resolution options (provider/model/apiKey). */
     modelOptions?: ModelResolutionOptions;

package/dist/index.mjs

@@ -1324,6 +1324,10 @@ function parseLessonFlow(lessonMarkdown) {
   }
   const durMatch = lessonMarkdown.match(/Estimated Duration:\s*([^\n]+)/i);
   if (durMatch) result.estimatedDuration = durMatch[1].trim();
+  if (!result.lessonTitle) {
+    const h1 = lessonMarkdown.match(/^#\s+(?:LESSON[^:]*:\s*)?(.+)$/m);
+    if (h1 && h1[1]) result.lessonTitle = h1[1].replace(/\*+/g, "").trim();
+  }
   const contractMatch = lessonMarkdown.match(/SLIDE must visualize:?\s*([^\n]+)/i);
   if (contractMatch) result.slideContract = contractMatch[1].trim();
   const actSeqSectionMatch = lessonMarkdown.match(/###\s*(?:\d+\.\s*)?Activity Sequence[\s\S]*?(?=(?:###|\n##\s+|$))/i);
@@ -1405,7 +1409,7 @@ var init_lessonFlowParser = __esm({
 
 // src/ai/prompts/slideBlueprintPrompt.ts
 function buildSlideBlueprintPrompt(params) {
-  const { lessonFlow, targetSlideCount, stylePresetName = "Blue Professional" } = params;
+  const { lessonFlow, targetSlideCount, stylePresetName = "Blue Professional", productSpecBlock } = params;
   const activitiesSummary = lessonFlow.activities.map(
     (a) => `Seq ${a.seq} [${a.phase}]: ${a.purpose} (Teacher: ${a.teacherMove} | Student: ${a.studentAction} | Time: ${a.time})`
   ).join("\n");
@@ -1427,7 +1431,9 @@ ${countGuidance}
 - Target Duration: ${lessonFlow.estimatedDuration}
 - Active Visual Style: "${stylePresetName}"
 ${lessonFlow.slideContract ? `- Slide Artifact Contract: "${lessonFlow.slideContract}"` : ""}
-
+${productSpecBlock ? `
+${productSpecBlock}
+` : ""}
 ### \u{1F5FA}\uFE0F CANONICAL ACTIVITY SEQUENCE:
 ${activitiesSummary || "Standard phased sequence"}
 
@@ -1501,7 +1507,7 @@ function buildSlideBatchPrompt(params) {
     skillPrompt,
     language = "Vietnamese",
     languageDirective = "",
-    headingDirective = "",
+    // deprecated — see interface doc
     groundContext = ""
   } = params;
   const slidesSpec = clusterSlides.map((s) => `
@@ -1522,7 +1528,6 @@ ${groundContext}
 ---` : ""}
 ### OPERATIONAL GROUND RULES FOR CHUNK GENERATION:
 ${languageDirective}
-${headingDirective}
 1. **FOCUS ON CLUSTER ${clusterId}: "${clusterTitle}"**:
    Generate EXACTLY the ${clusterSlides.length} slides requested in the user prompt.
 2. **ZERO ABBREVIATION / NO "// TODO"**:
@@ -1713,7 +1718,7 @@ 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, (token, type) => {
+    const raw = await runCurriculumAIInference(messages, "", options.runnerOptions, (token, type) => {
       if (type === "usage") options.onProgress?.("@illustrator", token, { type: "usage" });
     });
     const fenceMatch = raw.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
@@ -1899,7 +1904,8 @@ async function executeSlideProductionWorkflow(options) {
   const blueprintPrompt = buildSlideBlueprintPrompt({
     lessonFlow,
     targetSlideCount,
-    stylePresetName: stylePreset?.name || "Blue Professional"
+    stylePresetName: stylePreset?.name || "Blue Professional",
+    productSpecBlock: options.productSpecBlock
   });
   let blueprintItems;
   let allGeneratedSlides;
@@ -1982,7 +1988,6 @@ ${p.content}`).join("\n\n") : lessonFlow.rawContent.slice(0, 3500);
         skillPrompt,
         language,
         languageDirective,
-        headingDirective,
         groundContext: options.groundContext
       });
       try {
@@ -11707,19 +11712,30 @@ function extractToolchainFacts(refPack) {
   const factLines = [];
   for (const rawLine of excerpt.split("\n")) {
     const line = rawLine.trim();
-    if (!line || line.startsWith("#")) continue;
-    if (/\d{1,2}(?:\.\d{1,2})?/.test(line) || /Xcode|Swift|macOS|iOS|SDK|Node|Python|JDK|\.NET/i.test(line)) {
-      factLines.push(line.replace(/^[-*•]\s*/, "- "));
-    }
+    if (!line || line.startsWith("#") || line.startsWith("<!--")) continue;
+    if (!/\d{1,2}(?:\.\d{1,2})?/.test(line) && !/Xcode|Swift|macOS|iOS|SDK|Node|Python|JDK|\.NET/i.test(line)) continue;
+    factLines.push(line.replace(/^[*\-•]\s*/, "- "));
     if (factLines.length >= 8) break;
   }
   return factLines;
 }
+function derivePrimaryTechnology(facts, briefing) {
+  const explicit = (briefing?.coreTechnology || briefing?.techStack || "").trim();
+  if (explicit && explicit.length <= 80) return explicit;
+  const found = [];
+  const CANON = ["Swift", "SwiftUI", "macOS", "iOS", "Xcode", "SwiftData", "Node.js", "TypeScript", "Python", "React"];
+  for (const name of CANON) {
+    if (facts.some((f) => f.includes(name)) && !found.includes(name)) found.push(name);
+  }
+  if (found.length > 0) return found.slice(0, 4).join(" + ");
+  const topic = (briefing?.topic || "").trim();
+  return topic && topic.length <= 60 ? topic : "";
+}
 function buildProductSpecBlock(input) {
   const b = input.briefing || {};
-  const platform = (input.overrides?.primaryLanguage || b.coreTechnology || b.techStack || b.topic || "").trim();
-  const hardware = (b.hardwarePlatform || b.studentEquipment || b.classDynamic || "").trim();
   const toolchainFacts = input.refPack ? extractToolchainFacts(input.refPack) : [];
+  const platform = (input.overrides?.primaryLanguage || derivePrimaryTechnology(toolchainFacts, b) || "").trim();
+  const hardware = (b.hardwarePlatform || b.studentEquipment || b.classDynamic || "").trim();
   const lines = [];
   lines.push("[PRODUCT SPEC \u2014 CANONICAL, BINDING FOR EVERY ARTIFACT OF THIS PROJECT]:");
   lines.push("All decisions below are PROJECT-WIDE. Every artifact (LESSON, satellites, KX)");
@@ -11735,7 +11751,7 @@ function buildProductSpecBlock(input) {
   if (input.overrides?.deliverableTemplate) {
     lines.push(`- Deliverable template: ${input.overrides.deliverableTemplate}`);
   }
-  if (toolchainFacts.length > 0) {
+  if (toolchainFacts.length > 0 && !input.skipToolchainList) {
     lines.push("- Toolchain & versions (ground truth):");
     for (const f of toolchainFacts) lines.push(`  ${f}`);
   }
@@ -11863,7 +11879,9 @@ async function ensureKnowledgeExposition(options) {
   const productSpecBlock = buildProductSpecBlock({
     refPack,
     briefing: techStack || hardwarePlatform ? { techStack, hardwarePlatform } : void 0,
-    overrides: options.productSpec
+    overrides: options.productSpec,
+    skipToolchainList: true
+    // same RefPack excerpt already in [GROUND TRUTH]
   });
   const originalUserPrompt = buildUserPrompt(session, plan, glossary, targetLanguage, options.slcMarkdown, refPack) + (productSpecBlock ? "\n\n" + productSpecBlock : "");
   const content = (await llmFn(
@@ -11963,17 +11981,28 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
       const lpRaw = await storage.readSotDocument(projectId, "LEARNER_PROFILE.md");
       if (lpRaw) {
         const hwPatterns = [
+          // "Cơ sở phần cứng (Hardware Ecosystem): Học sinh thực hành trên máy..."
+          // — the audit: the old pattern captured the parenthetical label
+          // "(Hardware Ecosystem):" itself. Capture AFTER the closing paren + colon.
+          /\([^)]*Ecosystem[^)]*\)\s*:\s*([^\n\r]+)/i,
           /(?:Student Equipment|Hardware|Platform|Thiết bị|Thiết bị học tập)\s*(?:\(|:|\*)*\s*([^\n\r]+?)(?:\s*\*\*|[.).]?\s*$)/i,
           /(?:máy|device|machine)\s+([^,.;\n]{4,60}(?:M\d|Intel|PC|computer|mini)[^,.;\n]{0,30})/i
         ];
         for (const p of hwPatterns) {
           const m = lpRaw.match(p);
-          if (m && !hw) {
-            hw = m[1].trim();
+          if (m && m[1] && !hw) {
+            hw = m[1].trim().replace(/\*+/g, "").slice(0, 300);
             break;
           }
         }
       }
+      if (!hw) {
+        const rpRaw = await storage.readSotDocument(projectId, "REFERENCE_PACK.md");
+        if (rpRaw) {
+          const rp = rpRaw.match(/(?:School Lab|Thiết bị lớp học)[^\n]*\*\*([^*]+(?:M\d|Mac)[^*]*)\*\*/i);
+          if (rp && rp[1]) hw = rp[1].trim();
+        }
+      }
     } catch {
     }
   }
@@ -12710,11 +12739,11 @@ function buildSessionSliceContext(plan, lessonCode) {
   lines.push("- Time split: knowledge " + s.knowledge_minutes + "m / practice " + s.practice_minutes + "m / overhead " + s.overhead_minutes + "m");
   lines.push("- Depth assignments: " + s.depth_assignments.map((d) => d.node_id + "=" + d.depth.toUpperCase() + "(" + d.source + ")").join("; "));
   if (s.prerequisite_decisions.length > 0) {
-    lines.push("- Prerequisite decisions [7]:");
+    lines.push("- Prerequisite decisions [" + s.prerequisite_decisions.length + "]:");
     for (const d of s.prerequisite_decisions) lines.push("  * " + d.node_id + ": " + d.decision + " \u2014 " + d.reason);
   }
   if (s.scaffold_decisions.length > 0) {
-    lines.push("- Scaffold decisions [7]:");
+    lines.push("- Scaffold decisions [" + s.scaffold_decisions.length + "]:");
     for (const d of s.scaffold_decisions) lines.push("  * " + d.item + ": " + d.decision + (d.minutes_saved > 0 ? " (saves " + d.minutes_saved + "m)" : "") + " \u2014 " + d.reason);
   }
   lines.push("- Exit evidence: " + s.exit_evidence.join("; "));
@@ -25949,8 +25978,11 @@ function buildFrameworkExcerptForLesson(framework, lessonId) {
   });
   const rowIdx = scopeRows[0] ?? -1;
   const currentRow = rowIdx >= 0 ? lines[rowIdx] : "";
-  const prevRow = rowIdx > 0 && (lines[rowIdx - 1] || "").trim().startsWith("|") ? lines[rowIdx - 1] : "";
-  const nextRow = (lines[rowIdx + 1] || "").trim().startsWith("|") ? lines[rowIdx + 1] : "";
+  const isSeparatorRow = (l) => !!l && /^\s*\|?[\s:|-]+\|?\s*$/.test(l) && l.includes("-");
+  const prevRaw = rowIdx > 0 ? lines[rowIdx - 1] : "";
+  const prevRow = prevRaw.trim().startsWith("|") && !isSeparatorRow(prevRaw) ? prevRaw : "";
+  const nextRaw = lines[rowIdx + 1] || "";
+  const nextRow = nextRaw.trim().startsWith("|") && !isSeparatorRow(nextRaw) ? nextRaw : "";
   const hierStart = lines.findIndex((l) => /Structural Hierarchy/i.test(l));
   let hierarchyBlock = "";
   if (hierStart >= 0) {
@@ -26356,6 +26388,7 @@ ${renderHorizonPromptBlock(horizon)}`;
   } catch (hErr) {
     console.warn(`[produceSingleLesson] Notice: Curriculum Horizon extraction:`, hErr?.message || hErr);
   }
+  let productSpecBlock = "";
   const buildGroundTruthBlock = () => {
     const parts = [];
     if (expositionContext) {
@@ -26366,9 +26399,9 @@ ${expositionContext}`);
       parts.push(`### REFERENCE PACK GROUND TRUTH
 ${effectiveRefPack}`);
     }
-    const productSpec = buildProductSpecBlock({ refPack, briefing: options.briefing });
-    if (productSpec) {
-      parts.push(productSpec);
+    productSpecBlock = buildProductSpecBlock({ refPack, briefing: options.briefing, skipToolchainList: true });
+    if (productSpecBlock) {
+      parts.push(productSpecBlock);
     }
     return parts.length > 0 ? `
 
@@ -26385,10 +26418,17 @@ ${standardsContext}` : "";
   const sessionSliceBlock = sessionSliceContext ? `
 
 ${sessionSliceContext}` : "";
+  const platformGuardrail = buildDomainLexiconGuardrail(
+    options.briefing?.techStack || options.briefing?.coreTechnology,
+    options.briefing?.hardwarePlatform
+  );
+  const guardrailBlock = `
+
+${platformGuardrail}`;
   const assembleCommonContext = (sg) => `${baseContextPrefix}
 
 [CONTENT STYLE GUIDE EXCERPT]:
-${sg}${standardsBlock}${glossaryBlock}${buildGroundTruthBlock()}${sessionSliceBlock}${horizonBlock}`;
+${sg}${standardsBlock}${glossaryBlock}${buildGroundTruthBlock()}${sessionSliceBlock}${horizonBlock}${guardrailBlock}`;
   let commonContext = assembleCommonContext(effectiveStyleGuide);
   const MAX_COMPOSITE_PROMPT_CHARS = 3e4;
   const runnerOptions = options.customInference ? { customInference: options.customInference } : {};
@@ -26914,6 +26954,11 @@ ${buildHeadingDirective("ACT", slcMarkdown, targetLang)}`;
     const quizPrompt = `You are @assessor (Lead Psychometrician & Competency Assessment Specialist).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, author the scenario-based diagnostic question bank: \`QUIZ_${lessonCode}.md\`.
 
+SCOPE & PACING (prompt audit S-6):
+- This is a FORMATIVE CHECKPOINT for ONE 90-minute session, NOT an exam bank.
+- Size the bank to fit the session's Wrap-up (~10 minutes of answering): the MCQ bank, code-tracing question, and rubric together must be completable by a student in that time.
+- Question ONLY concepts inside this session's scope (see SESSION SLICE + ALLOWED DESIGN SPACE in the context).
+
 Mandatory Format Requirements:
 1. EXACT YAML Frontmatter \u2014 copy verbatim, then fill in the blanks:
 ---
@@ -26998,6 +27043,7 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
         languageDirective,
         headingDirective: buildHeadingDirective("SLIDE", slcMarkdown, targetLang),
         groundContext: slideGroundContext,
+        productSpecBlock: productSpecBlock || void 0,
         satelliteContext,
         runnerOptions,
         onProgress: (agent, msg, meta) => {