@thanh01.pmt/curriculum-kit 1.2.1 → 1.4.0

package/dist/workflow/index.cjs

@@ -6258,6 +6258,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);
@@ -6291,12 +6292,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);
@@ -6313,6 +6315,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");
   }
@@ -6321,14 +6326,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)
@@ -6444,6 +6449,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) -->`;
+}
 init_errors();
 
 // src/services/languageDirective.ts
@@ -7025,6 +7042,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;