@thanh01.pmt/curriculum-kit 1.4.21 → 1.4.22

package/dist/index.d.cts

@@ -655,6 +655,9 @@ interface GenerateExpositionOptions {
     slcMarkdown?: Record<string, Record<string, string>> | string | null;
     techStack?: string;
     hardwarePlatform?: string;
+    /** REFERENCE_PACK.md raw content — technical ground truth (versions, APIs).
+     *  5-Whys RC-vacuum: without it the KX model regresses to pretrained facts. */
+    refPack?: string;
 }
 interface ExpositionResult {
     relPath: string;

package/dist/index.d.ts

@@ -655,6 +655,9 @@ interface GenerateExpositionOptions {
     slcMarkdown?: Record<string, Record<string, string>> | string | null;
     techStack?: string;
     hardwarePlatform?: string;
+    /** REFERENCE_PACK.md raw content — technical ground truth (versions, APIs).
+     *  5-Whys RC-vacuum: without it the KX model regresses to pretrained facts. */
+    refPack?: string;
 }
 interface ExpositionResult {
     relPath: string;

package/dist/index.mjs

@@ -11507,6 +11507,21 @@ function normalizeHeading(str) {
   return str.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^\w\s]/g, " ").replace(/\s+/g, " ").trim();
 }
 function findCanonicalFuzzy(norm) {
+  if (norm.includes("toolchain") || norm.includes("moi truong phat trien") || norm.includes("cong cu") || norm.includes("version") || norm.includes("phan mem") || norm.includes("development environment") || norm.includes("technical overview") || norm.includes("kien truc")) {
+    return "Technical Overview & Architecture Blueprint";
+  }
+  if (norm.includes("pinout") || norm.includes("phan cung") || norm.includes("hardware") || norm.includes("wiring") || norm.includes("ket noi")) {
+    return "Hardware Pinout & Wiring Configuration Matrix";
+  }
+  if (norm.includes("pedagog") || norm.includes("phuong phap") || norm.includes("day hoc") || norm.includes("su pham")) {
+    return "Core Pedagogical Concept Anchor & Real-World Domain Bridge";
+  }
+  if (norm.includes("standard") || norm.includes("tieu chuan") || norm.includes("csta") || norm.includes("cs2023") || norm.includes("chuan academic")) {
+    return "Standards Alignment";
+  }
+  if (norm.includes("roadmap") || norm.includes("lo trinh") || norm.includes("milestone") || norm.includes("giai doan")) {
+    return void 0;
+  }
   if (norm.includes("symbol") || norm.includes("identifier ledger") || norm.includes("dinh danh")) {
     return "Symbol & Identifier Ledger";
   }
@@ -11643,7 +11658,7 @@ function buildSystemPrompt(targetLanguage = "vi", techStack, hardwarePlatform) {
     langDirective
   ].join("\n");
 }
-function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMarkdown) {
+function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMarkdown, refPack) {
   const depthLines = session.depth_assignments.map((d) => "- " + d.node_id + " [" + d.depth.toUpperCase() + "]: " + DEPTH_RULES[d.depth]).join("\n");
   const termLines = glossary.map((g) => "- " + g.term + (g.definition ? " \u2014 " + g.definition : "") + (g.example ? " (example: " + g.example + ")" : "")).join("\n");
   const langCode = resolveTargetLanguageCode(targetLanguage);
@@ -11656,6 +11671,28 @@ function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMark
   const hQuestions = headings["Self-Check Questions"] || (langCode === "vi" ? "C\xE2u h\u1ECFi T\u1EF1 ki\u1EC3m tra" : "Self-Check Questions");
   const skeleton = `## ${hScope} / ## ${hTerms} / ## ${hNarratives} / ## ${hExamples} / ## ${hMistakes} / ## ${hQuestions}`;
   const headingDirective = buildHeadingDirective("KNOWLEDGE_EXPOSITION", slcMarkdown, targetLanguage);
+  let refPackBlock = "";
+  if (refPack && refPack.trim()) {
+    const refExcerpt = buildSectionAwareExcerpt(refPack, {
+      priorities: [
+        "Technical Overview & Architecture Blueprint",
+        "Hardware Pinout & Wiring Configuration Matrix",
+        "Standards Alignment"
+      ],
+      budget: 2500
+    }).excerpt;
+    if (refExcerpt) {
+      refPackBlock = [
+        "",
+        "[GROUND TRUTH \u2014 BINDING, from REFERENCE_PACK.md]:",
+        "Tool versions, APIs, and platform facts below are CANONICAL. Do NOT",
+        "contradict them; do NOT substitute versions from memory. If a fact you",
+        "need is not stated here, stay generic rather than inventing specifics.",
+        "",
+        refExcerpt
+      ].join("\n");
+    }
+  }
   return [
     "Session: " + session.id + " \u2014 " + session.title,
     "Objective: " + session.prose_objective,
@@ -11668,6 +11705,7 @@ function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMark
     "",
     "Glossary terms (definitions are canonical):",
     termLines || "(none provided \u2014 write definitions and mark them for glossary sync)",
+    refPackBlock,
     "",
     "Section skeleton to fill (replace ONLY the {{placeholders}}):",
     skeleton,
@@ -11676,7 +11714,7 @@ function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMark
   ].filter(Boolean).join("\n");
 }
 async function ensureKnowledgeExposition(options) {
-  const { projectId, lessonCode, plan, glossary, llmFn, storage, techStack, hardwarePlatform } = options;
+  const { projectId, lessonCode, plan, glossary, llmFn, storage, techStack, hardwarePlatform, refPack } = options;
   const session = plan.sessions.find((s) => s.id === lessonCode);
   if (!session) throw new Error("Session " + lessonCode + " not found in plan " + plan.plan_id);
   const existing = await storage.readArtifact(projectId, EXPOSITION_REL(lessonCode));
@@ -11690,9 +11728,11 @@ async function ensureKnowledgeExposition(options) {
     throw new ExpositionApprovalError("Approval hash " + plan.approval.plan_hash + " does not match current plan hash " + plan.plan_hash + " \u2014 re-approve after plan changes");
   }
   const targetLanguage = options.targetLanguage || plan.translation?.target_language || "vi";
+  const originalSystemPrompt = buildSystemPrompt(targetLanguage, techStack, hardwarePlatform);
+  const originalUserPrompt = buildUserPrompt(session, plan, glossary, targetLanguage, options.slcMarkdown, refPack);
   const content = (await llmFn(
-    buildSystemPrompt(targetLanguage, techStack, hardwarePlatform),
-    buildUserPrompt(session, plan, glossary, targetLanguage, options.slcMarkdown)
+    originalSystemPrompt,
+    originalUserPrompt
   )).trim();
   if (content.length < 200) {
     throw new Error("EXPOSITION too short for " + lessonCode + " (" + content.length + " chars) \u2014 refusing to save");
@@ -11725,8 +11765,16 @@ async function ensureKnowledgeExposition(options) {
     };
     let verdict = await judgeOnce(finalContent);
     if (verdict.verdict !== "APPROVED") {
-      const repairPrompt = finalContent + "\n\nJUDGE CRITIQUE (fix ALL issues, output the COMPLETE corrected document):\n" + verdict.critique;
-      finalContent = (await llmFn(buildSystemPrompt(), repairPrompt)).trim();
+      const repairPrompt = [
+        originalUserPrompt,
+        "",
+        "--- YOUR PREVIOUS DRAFT (REJECTED, fix ALL issues below) ---",
+        finalContent,
+        "",
+        "--- JUDGE CRITIQUE (fix ALL issues, output the COMPLETE corrected document) ---",
+        verdict.critique
+      ].join("\n");
+      finalContent = (await llmFn(originalSystemPrompt, repairPrompt)).trim();
       verdict = await judgeOnce(finalContent);
     }
     if (verdict.verdict !== "APPROVED") {
@@ -11767,12 +11815,27 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
     try {
       const lpRaw = await storage.readSotDocument(projectId, "LEARNER_PROFILE.md");
       if (lpRaw) {
-        const hwMatch = lpRaw.match(/(?:Student Equipment|Hardware|Platform|Thiết bị)[:\s*`]+([^\n\r]+)/i);
-        if (hwMatch && !hw) hw = hwMatch[1].trim();
+        const hwPatterns = [
+          /(?: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();
+            break;
+          }
+        }
       }
     } catch {
     }
   }
+  let refPackContent;
+  try {
+    refPackContent = await storage.readSotDocument(projectId, "REFERENCE_PACK.md") || void 0;
+  } catch {
+    refPackContent = void 0;
+  }
   const { runCurriculumAIInference: runCurriculumAIInference2 } = await Promise.resolve().then(() => (init_streamRunner(), streamRunner_exports));
   const targetLang = options.targetLanguage || plan.translation?.target_language || "vi";
   const result = await ensureKnowledgeExposition({
@@ -11784,6 +11847,7 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
     slcMarkdown: options.slcMarkdown,
     techStack: tech,
     hardwarePlatform: hw,
+    refPack: refPackContent,
     llmFn: async (systemPrompt, userPrompt) => {
       const runnerOpts = options.customInference ? { customInference: options.customInference } : {};
       const out = await runCurriculumAIInference2(
@@ -26082,11 +26146,16 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   }).excerpt : "";
   let effectiveRefPack = refPack ? buildSectionAwareExcerpt(refPack, {
     priorities: [
+      // Toolchain/version matrix FIRST — the most-frequently-hallucinated
+      // facts are tool versions ("Xcode 15" vs ground truth "Xcode 16").
+      // The bilingual fuzzy matcher in contextBuilder resolves these keys
+      // even when the generated RefPack headings are Vietnamese.
       "Technical Overview & Architecture Blueprint",
       "Hardware Pinout & Wiring Configuration Matrix",
+      "Standards Alignment",
       "Core Pedagogical Concept Anchor & Real-World Domain Bridge"
     ],
-    budget: 2500
+    budget: 3500
   }).excerpt : "";
   const baseContextPrefix = `PROJECT & ACADEMIC CONTEXT:
 - Project ID: ${projectId}