@thanh01.pmt/curriculum-kit 1.2.0 → 1.2.1

package/dist/index.mjs

@@ -5560,13 +5560,13 @@ Evaluate the candidate artifact across these 6 dimensions:
    - 0 pts: Missing critical sections.
 
 5. **Technical & Conceptual Accuracy (15 pts):**
-   - 15 pts: Code snippets, logic flows, architectural descriptions, and Mermaid diagrams are conceptually sound, valid, and free of syntax hallucinations.
+   - 15 pts: Code snippets, logic flows, architectural descriptions, and Mermaid diagrams are conceptually sound and valid. If \`canonicalExposition\` or \`[KNOWLEDGE_EXPOSITION]\` is provided, content strictly adheres to canonical concepts without contradicting definitions or examples.
    - 8 pts: Minor syntax inaccuracies or unidiomatic code that does not break core concepts.
-   - 0 pts: Severe technical hallucinations, broken logic, or invalid diagrams.
+   - 0 pts: Severe technical hallucinations, broken logic, invalid diagrams, or direct contradiction of canonical exposition knowledge.
 
 6. **Contract Consistency & Zero-Drift (10 pts):**
-   - 10 pts: Satellite artifact strictly adheres to the scope, tech stack, and objectives of Lesson ${lessonId} without introducing unrelated topics.
-   - 0-5 pts: Scope drift or topic divergence detected.
+   - 10 pts: Satellite artifact strictly adheres to the scope, tech stack, and objectives of Lesson ${lessonId} without introducing unrelated topics. If \`canonicalLessonExcerpt\` is present in candidate JSON, all satellite phases/activities strictly operationalize the master Lesson Flow and Activity Sequence without inventing divergent timelines.
+   - 0-5 pts: Scope drift, topic divergence, or disjoint activity sequence detected compared to master lesson.
 
 ## VERDICT RULES
 - **PASS:** Score >= 80 AND Language Adherence = true AND Standards Alignment >= 12 (when STANDARDS GROUND TRUTH is present).
@@ -11861,11 +11861,42 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   }
   const pedagogy = detectProjectPedagogy(framework, styleGuide, options.pedagogy);
   const pedagogyLabel = pedagogy.toUpperCase();
-  const styleGuideExcerpt = styleGuide ? buildSectionAwareExcerpt(styleGuide, {
+  let glossaryContext = "";
+  try {
+    const glossaryRaw = await storage.readArtifact(projectId, "_sot/GLOSSARY.json");
+    if (glossaryRaw) {
+      let allTerms = [];
+      try {
+        allTerms = JSON.parse(glossaryRaw).terms ?? [];
+      } catch {
+      }
+      let scopedTermsSet = null;
+      const planRaw = await storage.readArtifact(projectId, "_sot/CURRICULUM_PLAN.json");
+      if (planRaw) {
+        try {
+          const plan = JSON.parse(planRaw);
+          const sessionScope = plan.glossary_scope?.find((g) => g.session_id === lessonCode);
+          if (sessionScope?.terms?.length) {
+            scopedTermsSet = new Set(sessionScope.terms.map((t) => t.toLowerCase()));
+          }
+        } catch {
+        }
+      }
+      const relevantTerms = scopedTermsSet ? allTerms.filter((g) => scopedTermsSet.has(g.term.toLowerCase())) : allTerms.slice(0, 10);
+      if (relevantTerms.length > 0) {
+        const lines = relevantTerms.map(
+          (t) => `- **${t.term}**: ${t.definition || ""}${t.example ? ` (e.g. \`${t.example}\`)` : ""}`
+        );
+        glossaryContext = buildSectionAwareExcerpt(lines.join("\n"), { budget: 800 }).excerpt;
+      }
+    }
+  } catch {
+  }
+  let effectiveStyleGuide = styleGuide ? buildSectionAwareExcerpt(styleGuide, {
     priorities: ["Voice & Tone", "Standard Terminology (Glossary)", "Lesson Content Standards"],
     budget: 2e3
   }).excerpt : "";
-  const refPackExcerpt = refPack ? buildSectionAwareExcerpt(refPack, {
+  let effectiveRefPack = refPack ? buildSectionAwareExcerpt(refPack, {
     priorities: [
       "Technical Overview & Architecture Blueprint",
       "Hardware Pinout & Wiring Configuration Matrix",
@@ -11873,7 +11904,7 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
     ],
     budget: 2500
   }).excerpt : "";
-  const commonContext = `PROJECT & ACADEMIC CONTEXT:
+  const baseContextPrefix = `PROJECT & ACADEMIC CONTEXT:
 - Project ID: ${projectId}
 - Pedagogical Model: ${pedagogyLabel}
 - Lesson Code: ${lessonCode}
@@ -11883,13 +11914,51 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
 - Target Bloom Level: ${bloomLevel}
 
 [CURRICULUM FRAMEWORK EXCERPT]:
-${buildFrameworkExcerptForLesson(framework, lessonId)}
+${buildFrameworkExcerptForLesson(framework, lessonId)}`;
+  const glossaryBlock = glossaryContext ? `
+
+[GLOSSARY TERMS (use these exact definitions)]:
+${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}
 
 [CONTENT STYLE GUIDE EXCERPT]:
-${styleGuideExcerpt}
+${sg}
 
 [REFERENCE PACK GROUND TRUTH]:
-${refPackExcerpt}${standardsContext ? "\n\n" + standardsContext : ""}${expositionContext ? "\n\n[KNOWLEDGE_EXPOSITION (CANONICAL KNOWLEDGE \u2014 teach from this, do not contradict)]:\n" + expositionContext : ""}${sessionSliceContext ? "\n\n" + sessionSliceContext : ""}`;
+${ref}${standardsBlock}${glossaryBlock}${expositionBlock}${sessionSliceBlock}`;
+  let commonContext = assembleCommonContext(effectiveRefPack, effectiveStyleGuide);
+  const MAX_COMPOSITE_PROMPT_CHARS = 3e4;
+  if (commonContext.length > MAX_COMPOSITE_PROMPT_CHARS && effectiveRefPack.length > 1e3) {
+    effectiveRefPack = buildSectionAwareExcerpt(refPack, {
+      priorities: [
+        "Technical Overview & Architecture Blueprint",
+        "Hardware Pinout & Wiring Configuration Matrix"
+      ],
+      budget: 1e3
+    }).excerpt;
+    commonContext = assembleCommonContext(effectiveRefPack, 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);
+  }
+  onProgress?.("@content", `[CONTEXT] Composite prompt ready (${commonContext.length} chars, adaptive budget <= ${MAX_COMPOSITE_PROMPT_CHARS})`, {
+    type: "progress",
+    promptChars: commonContext.length
+  });
   const producedArtifacts = [];
   const lessonRelPath = `_content/${unitCode}/LESSON_${lessonCode}.md`;
   const existingLessonContent = await storage.readArtifact(projectId, lessonRelPath);
@@ -12016,7 +12085,7 @@ ${yamlBlock.trim()}
           lessonId: lessonCode,
           title: lessonTitle,
           frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
-          styleGuideExcerpt: styleGuideExcerpt || void 0,
+          styleGuideExcerpt: effectiveStyleGuide || void 0,
           canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
         }),
         standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
@@ -12059,7 +12128,7 @@ ${yamlBlock.trim()}
           onProgress?.("@repair", `\u{1F527} Repair round ${round}/${MAX_REPAIR_ROUNDS} for LESSON_${lessonCode} (judge score ${currentResult.score}/100)...`);
           const repairedRaw = await runCurriculumAIInference(
             [{ role: "user", content: `You previously authored \`LESSON_${lessonCode}.md\` and the academic Judge REJECTED it with the critique below.
-Rewrite the COMPLETE corrected document: fix every listed issue, keep the mandatory structure, frontmatter and all approved sections. Output 100% clean Markdown only.
+Rewrite the COMPLETE corrected document in language "${targetLang}": fix every listed issue, preserve exact frontmatter and mandatory sections (Objectives, Activity Sequence, Lesson Flow). Output 100% clean Markdown only.
 
 JUDGE CRITIQUE:
 ${repairFeedback}
@@ -12077,7 +12146,13 @@ ${currentContent}` }],
             break;
           }
           const repairLint = lintAndSanitizeArtifact(repairedRaw, `LESSON_${lessonCode}.md`);
-          currentContent = repairLint.autoFixedContent || repairedRaw;
+          const candidateContent = repairLint.autoFixedContent || repairedRaw;
+          const hasFrontmatter = /^---\s*\r?\n[\s\S]*?\r?\n---/m.test(candidateContent);
+          if (!hasFrontmatter || candidateContent.length < Math.min(800, currentContent.length * 0.4)) {
+            onProgress?.("@repair", `\u26A0\uFE0F Repair round ${round} dropped critical structure (length or frontmatter missing) \u2014 rejecting repaired draft, retaining previous`);
+            break;
+          }
+          currentContent = candidateContent;
           onProgress?.("@reviewer", `\u{1F916} Re-judging repaired LESSON_${lessonCode} (round ${round})...`);
           const reJudge = await LLMJudgeEngine.evaluateArtifactWithLLM({
             targetArtifactType: "LESSON",
@@ -12089,7 +12164,7 @@ ${currentContent}` }],
               lessonId: lessonCode,
               title: lessonTitle,
               frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
-              styleGuideExcerpt: styleGuideExcerpt || void 0,
+              styleGuideExcerpt: effectiveStyleGuide || void 0,
               canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
             }),
             standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0