@thanh01.pmt/curriculum-kit 1.3.0 → 1.4.0

package/dist/index.cjs

@@ -9842,6 +9842,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);
@@ -9875,12 +9876,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);
@@ -9897,6 +9899,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");
   }
@@ -9905,14 +9910,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)
@@ -10028,6 +10033,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) -->`;
+}
 
 // src/services/knowledgeExpositionService.ts
 var EXPOSITION_REL = (lessonCode) => "_sot/expositions/" + lessonCode + ".md";
@@ -10176,7 +10193,7 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
     storage,
     gates: options.gates
   });
-  return { relPath: result.relPath, context: buildExpositionContext(result.content), reused: result.reused };
+  return { relPath: result.relPath, context: buildExpositionContext(result.content), reused: result.reused, rawContent: result.content };
 }
 init_errors();
 var asArr = (v) => Array.isArray(v) ? v : [];
@@ -11887,6 +11904,8 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   targetLang = targetLang || "vi";
   const languageDirective = buildLanguageDirective(targetLang);
   let expositionContext = "";
+  let expositionInjection;
+  let lessonInjection;
   let sessionSliceContext = "";
   try {
     const exposition = await ensureExpositionForLesson(storage, projectId, lessonCode, {
@@ -11894,7 +11913,18 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
       force: options.force
     });
     if (exposition) {
-      expositionContext = exposition.context;
+      const expoExcerpt = buildExpositionExcerpt(exposition.rawContent || exposition.context, {
+        budget: 6e3,
+        sectionLanguageContract: slcMarkdown,
+        artifactType: "KNOWLEDGE_EXPOSITION"
+      });
+      expositionContext = expoExcerpt.excerpt || exposition.context;
+      expositionInjection = {
+        source: "KNOWLEDGE_EXPOSITION",
+        verified: expoExcerpt.verified,
+        sectionAware: expoExcerpt.sectionAware,
+        issues: expoExcerpt.issues
+      };
       onProgress?.("@content", `[EXPOSITION] ${exposition.reused ? "Reused" : "Generated"} \`\${exposition.relPath}\` (plan-driven knowledge source)...`);
     } else {
       onProgress?.("@content", "[EXPOSITION] No CURRICULUM_PLAN.json \u2014 running legacy knowledge flow (no plan-driven exposition).");
@@ -12134,6 +12164,7 @@ ${yamlBlock.trim()}
       };
       var injectYamlReviewMetadata = injectYamlReviewMetadata2;
       const judgeObjectives = parseLessonObjectives(lessonContent, concept, bloomLevel);
+      const judgeExpositionExcerpt = expositionContext ? buildExpositionExcerpt(expositionContext, { budget: 3e3, sectionLanguageContract: slcMarkdown, artifactType: "KNOWLEDGE_EXPOSITION" }).excerpt : void 0;
       const judgeResult = await LLMJudgeEngine.evaluateArtifactWithLLM({
         targetArtifactType: "LESSON",
         lessonId: lessonCode,
@@ -12145,7 +12176,7 @@ ${yamlBlock.trim()}
           title: lessonTitle,
           frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
           styleGuideExcerpt: effectiveStyleGuide || void 0,
-          canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
+          canonicalExposition: judgeExpositionExcerpt
         }),
         standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
       });
@@ -12200,6 +12231,16 @@ ${currentContent}` }],
               options.onProgress?.("@repair", chunk, { type: type || "content", artifactType: "LESSON" });
             }
           );
+          const repairedExcerptCheck = buildSectionAwareExcerpt(repairedRaw, {
+            priorities: DEFAULT_LESSON_PRIORITIES,
+            budget: 12e3,
+            sectionLanguageContract: slcMarkdown,
+            artifactType: "LESSON"
+          });
+          if (repairedExcerptCheck.issues.includes("parse:no-priority-resolution")) {
+            onProgress?.("@repair", `\u26A0\uFE0F Repair round ${round} lost mandatory section structure (no priority section resolved) \u2014 rejecting repaired draft, retaining previous`);
+            break;
+          }
           if (!repairedRaw || repairedRaw.startsWith("\u26A0\uFE0F") || repairedRaw.length < 200) {
             onProgress?.("@repair", `\u26A0\uFE0F Repair round ${round} produced invalid output \u2014 stopping repair loop`);
             break;
@@ -12224,7 +12265,7 @@ ${currentContent}` }],
               title: lessonTitle,
               frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
               styleGuideExcerpt: effectiveStyleGuide || void 0,
-              canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
+              canonicalExposition: expositionContext ? buildExpositionExcerpt(expositionContext, { budget: 3e3, sectionLanguageContract: slcMarkdown, artifactType: "KNOWLEDGE_EXPOSITION" }).excerpt : void 0
             }),
             standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
           });
@@ -12282,7 +12323,9 @@ ${currentContent}` }],
             pedagogy,
             producedArtifacts,
             pausedForReview: true,
-            gateStatus: "judge_needs_revision"
+            gateStatus: "judge_needs_revision",
+            contextInjection: expositionInjection || lessonInjection,
+            promptChars: commonContext.length
           };
         }
       }
@@ -12305,7 +12348,9 @@ ${currentContent}` }],
         pedagogy,
         producedArtifacts,
         pausedForReview: true,
-        gateStatus: "judge_error"
+        gateStatus: "judge_error",
+        contextInjection: expositionInjection,
+        promptChars: commonContext.length
       };
     }
   }
@@ -12335,7 +12380,9 @@ ${currentContent}` }],
       pedagogy,
       producedArtifacts,
       pausedForReview: true,
-      gateStatus: "awaiting_approval"
+      gateStatus: "awaiting_approval",
+      contextInjection: expositionInjection,
+      promptChars: commonContext.length
     };
   }
   if (isLessonApproved && currentLessonInfo?.state !== "approved") {
@@ -12352,6 +12399,13 @@ ${currentContent}` }],
     artifactType: "LESSON"
   });
   const lessonExcerpt = lessonExcerptResult.excerpt;
+  const lessonInjectionMeta = {
+    source: "LESSON",
+    verified: lessonExcerptResult.verified,
+    sectionAware: lessonExcerptResult.sectionAware,
+    issues: lessonExcerptResult.issues
+  };
+  lessonInjection = lessonInjectionMeta;
   const satelliteContext = `${commonContext}
 
 [CANONICAL LESSON PLAN (${pedagogyLabel})]:
@@ -12991,7 +13045,9 @@ ${buildHeadingDirective("EXT", slcMarkdown, targetLang)}`;
     lessonId: lessonCode,
     pedagogy,
     producedArtifacts,
-    pausedForReview: false
+    pausedForReview: false,
+    contextInjection: lessonInjection && lessonInjection.verified ? expositionInjection || lessonInjection : lessonInjection || expositionInjection,
+    promptChars: commonContext.length
   };
 }
 function parseLessonObjectives(lessonContent, concept, bloomLevel) {