@thanh01.pmt/curriculum-kit 1.4.17 → 1.4.18

package/dist/index.cjs

@@ -10690,6 +10690,8 @@ ${lines.join("\n")}
 
 // src/services/contextBuilder.ts
 var DEFAULT_LESSON_PRIORITIES = [
+  "Symbol & Identifier Ledger",
+  "Artifact Contract",
   "A. Lesson Design Plan",
   "B. Lesson Flow",
   "Learning Objectives & Evidence",
@@ -10908,6 +10910,12 @@ 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("symbol") || norm.includes("identifier ledger") || norm.includes("dinh danh")) {
+    return "Symbol & Identifier Ledger";
+  }
+  if (norm.includes("artifact contract") || norm.includes("hop dong hoc lieu")) {
+    return "Artifact Contract";
+  }
   if (norm.includes("lesson design plan") || norm.includes("ke hoach thiet ke")) {
     return "A. Lesson Design Plan";
   }
@@ -10958,6 +10966,39 @@ function deriveArtifactTypeFromFileName(fileName) {
   const token = base.match(/^([A-Z][A-Z0-9_]*?)(?=_|$)/);
   return token ? token[1] : void 0;
 }
+function extractSymbolLedger(lessonMarkdown) {
+  const result = {
+    keySymbols: [],
+    rawBlock: ""
+  };
+  if (!lessonMarkdown) return result;
+  const ledgerMatch = lessonMarkdown.match(/###?\s*(?:Symbol & Identifier Ledger|Bảng Định Danh|Artifact Contract)[\s\S]*?(?=\n##|\n---|$)/i);
+  if (ledgerMatch) {
+    result.rawBlock = ledgerMatch[0].trim();
+  }
+  const structMatch = lessonMarkdown.match(/(?:Primary Struct|Primary Class|Primary Function|Main Component|Primary Module|Struct chính|Class chính|Hàm chính)[:\s*`]+([A-Za-z0-9_]+)/i);
+  if (structMatch) {
+    result.primarySymbol = structMatch[1];
+    result.keySymbols.push(structMatch[1]);
+  } else {
+    const codeStructMatch = lessonMarkdown.match(/(?:struct|class|interface|type|def|function)\s+([A-Za-z0-9_]+)/);
+    if (codeStructMatch) {
+      const sym = codeStructMatch[1];
+      result.primarySymbol = sym;
+      result.keySymbols.push(sym);
+    }
+  }
+  const fileMatch = lessonMarkdown.match(/(?:Entry File|Source File|Target File|Tên file mã nguồn)[:\s*`]+([A-Za-z0-9_\-\.]+\.[a-z0-9_]+)/i);
+  if (fileMatch) {
+    result.entryFileName = fileMatch[1];
+  } else {
+    const codeFileComment = lessonMarkdown.match(/(?:\/\/\s*|#\s*|\/\*\s*)([A-Za-z0-9_\-]+\.[a-zA-Z0-9]+)/);
+    if (codeFileComment) {
+      result.entryFileName = codeFileComment[1];
+    }
+  }
+  return result;
+}
 
 // src/services/knowledgeExpositionService.ts
 var EXPOSITION_REL = (lessonCode) => "_sot/expositions/" + lessonCode + ".md";
@@ -10977,8 +11018,22 @@ var DEPTH_RULES = {
   cio: "Write WHAT + WHY + HOW: include the mechanism, step by step, still technology-independent.",
   sio: "Write WHAT + WHY + HOW + SPECIFIC: include concrete implementations and how the real project keywords are used."
 };
-function buildSystemPrompt(targetLanguage = "vi") {
+function buildDomainLexiconGuardrail(techStack, hardwarePlatform) {
+  const targetTech = (techStack || "").trim();
+  const targetHw = (hardwarePlatform || "").trim();
+  const platformAnchor = [targetTech, targetHw].filter(Boolean).join(" | ");
+  if (!platformAnchor) {
+    return `- \u{1F512} TECHNICAL DOMAIN ANCHOR: Strictly adhere to the declared curriculum domain. Use ONLY native, standard, idiomatic syntax and mechanisms. Strictly FORBIDDEN from using foreign paradigms, cross-domain jargon, or hallucinated APIs.`;
+  }
+  return `- \u{1F512} STRICT DOMAIN & TECHNICAL PLATFORM ANCHOR:
+  \u2022 Declared Platform: "${platformAnchor}"
+  \u2022 NATIVE PARADIGM ONLY: You MUST strictly use standard, idiomatic syntax, conventions, naming patterns, and mental models of "${platformAnchor}".
+  \u2022 ANTI-CONTAMINATION INVARIANT: Strictly FORBIDDEN from importing or using syntax, units, keywords, tags, or concepts from unrelated/foreign ecosystems (e.g., do NOT leak Web/HTML/CSS tags or units into native mobile/embedded stacks, do NOT leak dynamic scripting into statically typed systems, do NOT use hardware/circuit terminology in pure-software courses).
+  \u2022 REAL APIS ONLY: Every method, modifier, property, and API referenced must exist in the standard SDK of "${platformAnchor}".`;
+}
+function buildSystemPrompt(targetLanguage = "vi", techStack, hardwarePlatform) {
   const langDirective = buildLanguageDirective(targetLanguage);
+  const domainGuardrails = buildDomainLexiconGuardrail(techStack, hardwarePlatform);
   return [
     "You write KNOWLEDGE_EXPOSITION: self-study reading material for a student in a teacherless program.",
     "Rules:",
@@ -10987,6 +11042,7 @@ function buildSystemPrompt(targetLanguage = "vi") {
     "3. Respect each concept depth target (ULO/CIO/SIO) \u2014 do not overshoot.",
     "4. Student-facing only: no teacher instructions, no classroom management text.",
     "5. Output the full markdown document following the provided section skeleton exactly (headers and placeholders preserved).",
+    domainGuardrails,
     langDirective
   ].join("\n");
 }
@@ -11023,7 +11079,7 @@ function buildUserPrompt(session, plan, glossary, targetLanguage = "vi", slcMark
   ].filter(Boolean).join("\n");
 }
 async function ensureKnowledgeExposition(options) {
-  const { projectId, lessonCode, plan, glossary, llmFn, storage } = options;
+  const { projectId, lessonCode, plan, glossary, llmFn, storage, techStack, hardwarePlatform } = 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));
@@ -11038,7 +11094,7 @@ async function ensureKnowledgeExposition(options) {
   }
   const targetLanguage = options.targetLanguage || plan.translation?.target_language || "vi";
   const content = (await llmFn(
-    buildSystemPrompt(targetLanguage),
+    buildSystemPrompt(targetLanguage, techStack, hardwarePlatform),
     buildUserPrompt(session, plan, glossary, targetLanguage, options.slcMarkdown)
   )).trim();
   if (content.length < 200) {
@@ -11108,6 +11164,18 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
   }
   const scopedTerms = new Set(plan.glossary_scope.find((g) => g.session_id === lessonCode)?.terms ?? []);
   glossary = glossary.filter((g) => scopedTerms.has(g.term));
+  let hw = options.hardwarePlatform;
+  let tech = options.techStack;
+  if (!hw || !tech) {
+    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();
+      }
+    } catch {
+    }
+  }
   const { runCurriculumAIInference: runCurriculumAIInference2 } = await Promise.resolve().then(() => (init_streamRunner(), streamRunner_exports));
   const targetLang = options.targetLanguage || plan.translation?.target_language || "vi";
   const result = await ensureKnowledgeExposition({
@@ -11117,6 +11185,8 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
     glossary,
     targetLanguage: targetLang,
     slcMarkdown: options.slcMarkdown,
+    techStack: tech,
+    hardwarePlatform: hw,
     llmFn: async (systemPrompt, userPrompt) => {
       const runnerOpts = options.customInference ? { customInference: options.customInference } : {};
       const out = await runCurriculumAIInference2(
@@ -25143,7 +25213,11 @@ type: "LESSON_EDP"
 
 ### 3. Resource Map (Slide, Handout, Starter Code, Lab Tools)
 ### 4. Assessment Map (Rubric criteria, formative checkpoints, remediation paths)
-### 5. Artifact Contract (Detailed specifications for ACT, SLIDE, QUIZ)
+### 5. Artifact Contract & Code Symbol Ledger
+- **Primary Struct / Class / Component:** [Explicit canonical identifier e.g. ProfileCardView]
+- **Entry Source File:** [Explicit file name e.g. ProfileCardView.swift]
+- **Key Functions & State Variables:** [Canonical identifiers used across all student activities]
+- **Artifact Specifications:** [Deliverable requirements for ACT, SLIDE, QUIZ, GUIDE, WKS, CODE, EXT]
 
 ---
 
@@ -25193,7 +25267,11 @@ type: "LESSON_GENERAL"
 
 ### 3. Resource Map
 ### 4. Assessment Map
-### 5. Artifact Contract
+### 5. Artifact Contract & Code Symbol Ledger
+- **Primary Struct / Class / Component:** [Explicit canonical identifier e.g. MainComponent]
+- **Entry Source File:** [Explicit file name e.g. MainComponent.ext]
+- **Key Functions & State Variables:** [Canonical identifiers used across all student activities]
+- **Artifact Specifications:** [Deliverable requirements for ACT, SLIDE, QUIZ, GUIDE, WKS, CODE, EXT]
 
 ---
 
@@ -25241,7 +25319,11 @@ type: "LESSON_5E"
 
 ### 3. Resource Map
 ### 4. Assessment Map
-### 5. Artifact Contract (Detailed specifications for ACT, SLIDE, QUIZ, GUIDE)
+### 5. Artifact Contract & Code Symbol Ledger
+- **Primary Struct / Class / Component:** [Explicit canonical identifier e.g. MainComponent]
+- **Entry Source File:** [Explicit file name e.g. MainComponent.ext]
+- **Key Functions & State Variables:** [Canonical identifiers used across all student activities]
+- **Artifact Specifications:** [Deliverable requirements for ACT, SLIDE, QUIZ, GUIDE, WKS, CODE, EXT]
 
 ---
 
@@ -25816,17 +25898,23 @@ ${currentContent}` }],
     artifactType: "LESSON"
   });
   const lessonExcerpt = lessonExcerptResult.excerpt;
-  const lessonInjectionMeta = {
-    source: "LESSON",
+  ({
     verified: lessonExcerptResult.verified,
     sectionAware: lessonExcerptResult.sectionAware,
     issues: lessonExcerptResult.issues
-  };
-  lessonInjection = lessonInjectionMeta;
+  });
+  const symbolLedger = extractSymbolLedger(lessonContent);
+  const symbolLedgerBlock = symbolLedger.primarySymbol ? `
+
+[MANDATORY CODE SYMBOL REGISTRY (Inherited from LESSON Plan)]:
+- Primary Struct / Class / Component: \`${symbolLedger.primarySymbol}\`
+- Entry Source File: \`${symbolLedger.entryFileName || symbolLedger.primarySymbol}\`
+- Key Identifiers to inherit verbatim: ${symbolLedger.keySymbols.map((s) => `\`${s}\``).join(", ")}
+- INVARIANT: You MUST use these exact identifier names in all code examples, exercises, and test assertions. Do NOT invent new struct/class names!` : "";
   const satelliteContext = `${commonContext}
 
 [CANONICAL LESSON PLAN (${pedagogyLabel})]:
-${lessonExcerpt}`;
+${lessonExcerpt}${symbolLedgerBlock}`;
   const judgeSat = (sat, content) => {
     if (gateModeFor(gates, sat) !== "LLM_JUDGE") return Promise.resolve();
     return judgeSatelliteArtifact({
@@ -26329,6 +26417,14 @@ ${buildHeadingDirective("CODE", slcMarkdown, targetLang)}`;
       c3: "### Challenge 3: [Name] (Difficulty: \u2B50\u2B50\u2B50\u2B50\u2B50) \u2014 Extension Milestones (Level 1: Ninja \u2192 Level 2: Guru \u2192 Level 3: Master)",
       meta: "## [REQUIRED] Metacognitive Deep Dive & Engineering Trade-offs"
     };
+    const lessonIdxMatch = lessonCode.match(/L0*(\d+)/i);
+    const lessonIdx = lessonIdxMatch ? parseInt(lessonIdxMatch[1], 10) : 1;
+    const isEarlyLesson = lessonIdx <= 4;
+    const zpdCeilingPrompt = isEarlyLesson ? `
+4. CRITICAL ZPD SCOPE LOCK (LESSON #${lessonIdx} - FOUNDATIONAL):
+   - This is an early foundational lesson. The extension challenge MUST focus on creative design variations, parameterization, or edge cases of the current lesson concepts ONLY.
+   - STRICTLY FORBIDDEN: NEVER introduce advanced mechanisms from future lessons (No complex event buses, No remote network/API calls, No persistent databases, No async concurrency, No out-of-scope hardware/sensors).` : `
+4. ZPD SCOPE: Focus on architectural edge cases, algorithmic optimization, and synthesis of learned concepts up to Lesson #${lessonIdx}.`;
     const extPrompt = `You are @activity (Lead STEM Specialist & Differentiated Extension Designer).
 Based on Master Lesson Plan \`LESSON_${lessonCode}.md\`, author the advanced extension challenge: \`EXT_${lessonCode}.md\`.
 
@@ -26360,6 +26456,7 @@ ${extHeadings.sub}
    - ${extHeadings.c3}
    - ${extHeadings.meta}
 3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+${zpdCeilingPrompt}
 
 ${languageDirective}
 
@@ -26890,6 +26987,15 @@ async function generateSingleArtifact(req) {
   const artifactSpecializedPrompt = getArtifactSpecializedInvariants(artifactType, {
     ...req,
     studentCount});
+  const techStack = req.config?.techStack || req.hardwarePlatform?.[0] || "Declared Technical Domain";
+  const domainGuardrail = buildDomainLexiconGuardrail(techStack, hwStr);
+  const symbolLedger = contextSot.lessonPlan ? extractSymbolLedger(contextSot.lessonPlan) : null;
+  const symbolLedgerPrompt = symbolLedger?.primarySymbol ? `
+7. MANDATORY CODE SYMBOL REGISTRY (Inherited from Canonical LESSON):
+   - Primary Struct / Class: \`${symbolLedger.primarySymbol}\`
+   - Entry Source File: \`${symbolLedger.entryFileName || symbolLedger.primarySymbol + ".swift"}\`
+   - Key Identifiers to inherit: ${symbolLedger.keySymbols.map((s) => `\`${s}\``).join(", ")}
+   - INVARIANT: You MUST use these exact identifier names in all code examples, exercises, and starter templates. Do NOT invent conflicting struct or class names.` : "";
   const systemPrompt = `You are ${meta.persona}, an expert Curriculum & Pedagogical Specialist in the Curriculum OS Multi-Agent Team.
 Your task is to author a canonical, publication-grade learning artifact of type "${artifactType.toUpperCase()}".
 
@@ -26900,7 +27006,10 @@ ${headingDirective}
 3. PEDAGOGICAL GROUNDING: Strictly align with the ${pedagogy.toUpperCase()} model, Bloom's Revised Taxonomy, and IEEE/ACM CS2023 guidelines.
 4. SCAFFOLDING LEVEL: "${scaffoldingLevel.toUpperCase()}".${scaffoldingRule}
 5. TARGET AUDIENCE: ${gradeLevel ? `Grade ${gradeLevel}, ` : ""}${targetAge} on ${hwStr}.${deviceRule}${classDynamicsRule}${extraContextRule}
-6. OUTPUT INTEGRITY: Output clean Markdown starting directly with YAML frontmatter. Do not wrap entire response in triple backticks.${artifactSpecializedPrompt}${mediaPolicy ? `
+6. DOMAIN & TECH STACK GUARDRAILS:
+${domainGuardrail}
+${symbolLedgerPrompt}
+8. OUTPUT INTEGRITY: Output clean Markdown starting directly with YAML frontmatter. Do not wrap entire response in triple backticks.${artifactSpecializedPrompt}${mediaPolicy ? `
 
 IMAGE PLANNING (media ledger) \u2014 QUOTA GEN: t\u1ED1i \u0111a ${mediaPolicy.maxGenImagesPerArtifact} \u1EA3nh AI cho artifact n\xE0y (\u1EA3nh search kho kh\xF4ng gi\u1EDBi h\u1EA1n).
 Khi n\u1ED9i dung c\u1EA7n minh h\u1ECDa (diagram quy tr\xECnh, s\u01A1 \u0111\u1ED3 kh\xE1i ni\u1EC7m, step-by-step visual), ch\xE8n placeholder \u0111\xFAng format [IMAGE: slug] (slug ch\u1EEF th\u01B0\u1EDDng-g\u1EA1ch ngang, unique trong b\xE0i, vd img-for-loop-diagram) T\u1EA0I \u0110\xDANG CH\u1ED6 c\u1EA7n \u1EA3nh, tr\xEAn d\xF2ng ri\xEAng. KH\xD4NG t\u1EF1 sinh \u1EA3nh, KH\xD4NG d\xF9ng markdown image \u2014 placeholder s\u1EBD \u0111\u01B0\u1EE3c thay b\u1EB1ng \u1EA3nh th\u1EADt sau khi Media Curator duy\u1EC7t. Ch\u1EC9 \u0111\u1EB7t cho \u1EA3nh TH\u1EF0C S\u1EF0 c\u1EA7n thi\u1EBFt.` : ""}`;
@@ -27380,6 +27489,24 @@ ${includeUnitTests ? "- Unit Testing: Provide automated assertions or test runne
 1. **CLASS-SCALED INVENTORY FOR ${studentCount} STUDENTS**:
    - Exact quantities calculated for ${studentCount} students.
    - Component specifications, estimated unit cost, and affordable alternatives.`;
+    case "ext": {
+      const lessonIdxMatch = (req.lessonId || "").match(/L0*(\d+)/i);
+      const lessonIdx = lessonIdxMatch ? parseInt(lessonIdxMatch[1], 10) : 1;
+      const isEarlyLesson = lessonIdx <= 4;
+      const zpdCeilingRule = isEarlyLesson ? `- \u{1F6D1} ZPD COMPLEXITY CEILING (FOUNDATIONAL LESSON #${lessonIdx}):
+  \u2022 SCOPE LOCK: This is an early foundational lesson. The extension challenge MUST focus on creative design variations, parameterization, or edge cases of the current lesson concepts ONLY.
+  \u2022 STRICTLY FORBIDDEN: NEVER introduce advanced mechanisms from future lessons (No complex event buses, No remote network/API calls, No persistent databases, No async concurrency, No out-of-scope hardware/sensors).` : `- \u{1F680} ZPD ADVANCED CHALLENGE (LESSON #${lessonIdx}):
+  \u2022 Focus on architectural edge cases, algorithmic optimization, and synthesis of learned concepts up to Lesson #${lessonIdx}.`;
+      return `
+### \u{1F680} EXTENSION CHALLENGE ARCHITECTURE INVARIANTS:
+${zpdCeilingRule}
+1. **STRUCTURED 3-TIER CHALLENGES**:
+   - Challenge 1 (Mission Briefing): High-stakes real-world scenario applying today's concepts.
+   - Challenge 2 (Architectural Constraints & Edge Cases): Deeper technical rules without violating prerequisite boundaries.
+   - Challenge 3 (Extension Milestones): Progressive milestones (Level 1: Novice \u2192 Level 2: Advanced \u2192 Level 3: Master).
+2. **METACOGNITIVE & ENGINEERING TRADE-OFFS**:
+   - Explicit reflection prompts evaluating architectural choices, code maintainability, and design patterns.`;
+    }
     case "lesson": {
       const lessonDuration = cfg.lessonDuration || 90;
       const pedagogicalModel = cfg.pedagogicalModel || req.pedagogy || "5e";
@@ -31203,6 +31330,7 @@ exports.buildCurriculumContext = buildCurriculumContext;
 exports.buildCurriculumPlan = buildCurriculumPlan;
 exports.buildDeliveryPackages = buildDeliveryPackages;
 exports.buildDiagnosticQuizPrompt = buildDiagnosticQuizPrompt;
+exports.buildDomainLexiconGuardrail = buildDomainLexiconGuardrail;
 exports.buildExpositionContext = buildExpositionContext;
 exports.buildExpositionExcerpt = buildExpositionExcerpt;
 exports.buildExtensionPrompt = buildExtensionPrompt;
@@ -31253,6 +31381,7 @@ exports.extractSectionHeadingsFromSLC = extractSectionHeadingsFromSLC;
 exports.extractSessionSlice = extractSessionSlice;
 exports.extractStandardRefs = extractStandardRefs;
 exports.extractStreamChunk = extractStreamChunk;
+exports.extractSymbolLedger = extractSymbolLedger;
 exports.extractThoughtAndContent = extractThoughtAndContent;
 exports.findStandardStatement = findStandardStatement;
 exports.formatQuizzesToCsv = formatQuizzesToCsv;