@thanh01.pmt/curriculum-kit 1.1.0 → 1.2.1

package/dist/ai/index.cjs

@@ -90,6 +90,8 @@ function getSuggestedActionForCode(code) {
       return "N\u1ED9i dung sinh ra thi\u1EBFu c\xE1c ph\u1EA7n b\u1EAFt bu\u1ED9c [REQUIRED]. H\xE3y k\xEDch ho\u1EA1t ki\u1EC3m th\u1EED ho\u1EB7c b\u1EA5m Rerun.";
     case "ERR_STORAGE_IO_FAILED":
       return "L\u1ED7i \u0111\u1ECDc/ghi t\u1EC7p tin tr\xEAn h\u1EC7 th\u1ED1ng l\u01B0u tr\u1EEF. Ki\u1EC3m tra quy\u1EC1n ghi th\u01B0 m\u1EE5c output/projects.";
+    case "ERR_CONTEXT_MISSING":
+      return "Thi\u1EBFu ngu\u1ED3n tri th\u1EE9c b\u1EAFt bu\u1ED9c (KNOWLEDGE_EXPOSITION ho\u1EB7c CANONICAL LESSON) theo Dependency Routing Matrix. Vui l\xF2ng t\u1EA1o ho\u1EB7c \u0111\u1ED3ng b\u1ED9 t\xE0i li\u1EC7u ngu\u1ED3n tr\u01B0\u1EDBc.";
     default:
       return "B\u1EA5m Rerun \u0111\u1EC3 th\u1EED l\u1EA1i ho\u1EB7c ki\u1EC3m tra nh\u1EADt k\xFD h\u1EC7 th\u1ED1ng.";
   }
@@ -107,6 +109,7 @@ function isCodeRetryable(code) {
     case "ERR_TASK_GATE_BLOCKED":
     case "ERR_METERED_LIMIT_EXCEEDED":
     case "ERR_SCHEMA_CONTRACT_VIOLATION":
+    case "ERR_CONTEXT_MISSING":
       return false;
     default:
       return true;
@@ -1851,6 +1854,45 @@ Return a single valid JSON object matching SlideDeckSchema with these exact keys
   }
 `.trim();
 }
+var SLIDE_CANONICAL_METHODOLOGY = `
+MANDATORY 12-14 SLIDE MICRO-CYCLE STRUCTURE (Delimited by '---'):
+1. **Slide 1 [Title & Mission]:** Real-world inquiry hook and overarching build mission
+2. **Slide 2 [Agenda & Roadmap]:** Timing and milestone breakdown table
+3. **Slide 3 [Warm-Up / Prior Knowledge]:** 2-column recall + 60-second diagnostic challenge card
+4. **Slide 4 [High-Stakes Hook Scenario]:** Authentic engineering/domain crisis card + dilemma constraint
+5. **Slide 5 [Core Concept 1: Mental Model]:** Definition, intuitive everyday analogy, and golden rule card
+6. **Slide 6 [Architecture & Visual Flow]:** Clean Mermaid diagram (flowchart or sequenceDiagram) + 3 flow steps
+7. **Slide 7 [Core Concept 2: Syntax / Mechanism Anatomy]:** Side-by-side runnable code + anatomy breakdown & syntax trap card
+8. **Slide 8 [Guided Practice: Try It Now]:** 3-minute active desk task card with starter hint and success criteria
+9. **Slide 9 [Integrated Hands-On Lab]:** 3-tier differentiated challenge cards (Bronze / Silver / Gold) + gotcha alert card
+10. **Slide 10 [Traffic Light Checkpoint & Pitfalls]:** Formative self-check cards (\u{1F7E2}/\u{1F7E1}/\u{1F534}) & diagnostic test question
+11. **Slide 11 [Exit Ticket & Metacognition]:** 2 scenario-based check questions + 1 metacognitive reflection prompt
+12. **Slide 12 [Summary & Next Steps]:** 3 core golden rules + preview card of next upcoming milestone
+
+Mandatory Canvas & Presentation Invariants:
+- A slide is an INTERACTIVE PROJECTION CANVAS, NOT a textbook! Absolutely NO dense paragraphs or walls of text.
+- Follow the 6x6 rule: Maximum 4-6 bullet points per slide, maximum 8-12 words per bullet.
+- Structure slides using \`<div class="columns"><div>...</div><div>...</div></div>\` and \`<div class="card">\`, \`<div class="card highlight">\`, \`<div class="card warning">\`, \`<div class="card success">\`.
+- MANDATORY PRESENTER NOTES ON EVERY SLIDE: Every slide MUST end with \`<!-- Presenter Notes: ... -->\` containing:
+  * SCRIPT: 60-90s teacher talk track with intuitive analogies.
+  * COLD CALL / CHECK: Specific diagnostic question to ask students.
+  * SCAFFOLDING / GOTCHA: Guidance for students who get stuck.
+  * PACING: Recommended minutes for the slide.
+- Output 100% valid Marp Markdown.
+`.trim();
+function buildMarpMarkdownSlidePrompt(input) {
+  return `You are @illustrator & @content (Pedagogical Slide Deck Presentation Specialists).
+Based on Master Lesson Plan \`LESSON_${input.lessonCode}.md\`, lesson context, and the MARP SLIDE TEMPLATE below, author the complete, highly engaging Marp presentation deck: \`SLIDE_${input.lessonCode}.md\`.
+
+[MARP SLIDE TEMPLATE SCAFFOLD]:
+${input.templateScaffold}
+
+${SLIDE_CANONICAL_METHODOLOGY}
+
+${input.languageDirective}
+
+${input.headingDirective}`.trim();
+}
 
 // src/ai/prompts/teacherGuidePrompt.ts
 function buildTeacherGuidePrompt(input) {
@@ -1990,13 +2032,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).
@@ -4986,6 +5028,7 @@ exports.DEFAULT_ENABLED_PROVIDERS = DEFAULT_ENABLED_PROVIDERS;
 exports.LLMJudgeEngine = LLMJudgeEngine;
 exports.ModelPolicyResolver = ModelPolicyResolver;
 exports.NVIDIA_MODELS = NVIDIA_MODELS;
+exports.SLIDE_CANONICAL_METHODOLOGY = SLIDE_CANONICAL_METHODOLOGY;
 exports.activityTools = activityTools;
 exports.analystTools = analystTools;
 exports.assessorTools = assessorTools;
@@ -4997,6 +5040,7 @@ exports.buildExtensionPrompt = buildExtensionPrompt;
 exports.buildHandoutPrompt = buildHandoutPrompt;
 exports.buildJudgePrompt = buildJudgePrompt;
 exports.buildLessonMasterPrompt = buildLessonMasterPrompt;
+exports.buildMarpMarkdownSlidePrompt = buildMarpMarkdownSlidePrompt;
 exports.buildProjectInstructionPrompt = buildProjectInstructionPrompt;
 exports.buildSelfLabPrompt = buildSelfLabPrompt;
 exports.buildSlidesPrompt = buildSlidesPrompt;