@thanh01.pmt/curriculum-kit 1.0.2 → 1.0.4

package/dist/{index-PDw11tpD.d.cts → index-BIhxrUEa.d.cts}

@@ -15,6 +15,11 @@ interface SingleArtifactRequest {
     targetAge?: string;
     scaffoldingLevel?: ScaffoldingLevel;
     hardwarePlatform?: string[];
+    gradeLevel?: string;
+    studentCount?: string;
+    language?: string;
+    extraContext?: string;
+    config?: Record<string, any>;
     contextSot?: {
         framework?: string;
         learnerProfile?: string;
@@ -44,7 +49,7 @@ interface SingleArtifactResult {
 /**
  * Maps artifact type to default canonical filename and responsible agent persona
  */
-declare function getArtifactMetadata(type: ArtifactType, lessonId?: string): {
+declare function getArtifactMetadata(type: ArtifactType, lessonId?: string, pedagogy?: string): {
     filename: string;
     persona: string;
     templateFile: string;

package/dist/{index-BAUtASfr.d.ts → index-BvWC_xXe.d.ts}

@@ -15,6 +15,11 @@ interface SingleArtifactRequest {
     targetAge?: string;
     scaffoldingLevel?: ScaffoldingLevel;
     hardwarePlatform?: string[];
+    gradeLevel?: string;
+    studentCount?: string;
+    language?: string;
+    extraContext?: string;
+    config?: Record<string, any>;
     contextSot?: {
         framework?: string;
         learnerProfile?: string;
@@ -44,7 +49,7 @@ interface SingleArtifactResult {
 /**
  * Maps artifact type to default canonical filename and responsible agent persona
  */
-declare function getArtifactMetadata(type: ArtifactType, lessonId?: string): {
+declare function getArtifactMetadata(type: ArtifactType, lessonId?: string, pedagogy?: string): {
     filename: string;
     persona: string;
     templateFile: string;

package/dist/index.cjs

@@ -9340,12 +9340,14 @@ var __filename2 = typeof (typeof document === 'undefined' ? require('u' + 'rl').
 var _resolvedDir = __filename2 ? path3__default.default.dirname(__filename2) : typeof __dirname !== "undefined" ? __dirname : process.cwd();
 function loadCurriculumTemplate(templateName) {
   const candidatePaths = [
-    path3__default.default.resolve(process.cwd(), "_templates", templateName),
+    path3__default.default.resolve("/Users/tonypham/MEGA/WebApp/WIP/learnwell-platform/packages/curriculum-kit/docs/refs/templates", templateName),
     path3__default.default.resolve(process.cwd(), "packages/curriculum-kit/docs/refs/templates", templateName),
+    path3__default.default.resolve(process.cwd(), "_templates", templateName),
     path3__default.default.resolve(process.cwd(), "docs/refs/templates", templateName),
     path3__default.default.resolve(_resolvedDir, "../docs/refs/templates", templateName),
     path3__default.default.resolve(_resolvedDir, "../../docs/refs/templates", templateName),
     path3__default.default.resolve(_resolvedDir, "../../../docs/refs/templates", templateName),
+    path3__default.default.resolve("/Users/tonypham/MEGA/WebApp/content-gen/the-ultimate-curriculum-agent-os/_templates", templateName),
     path3__default.default.resolve(_resolvedDir, "../../../../the-ultimate-curriculum-agent-os/_templates", templateName)
   ];
   for (const p of candidatePaths) {
@@ -10210,21 +10212,27 @@ footer: "Curriculum OS \u2022 ${lessonCode} (${pedagogyLabel})"
 
 MANDATORY 12-14 SLIDE MICRO-CYCLE STRUCTURE (Delimited by '---'):
 1. **Slide 1 [Title & Mission]:** ${lessonCode}: ${lessonTitle} + Real-world inquiry hook
-2. **Slide 2 [Agenda & Roadmap]:** Timing and milestone breakdown (${pedagogyLabel})
-3. **Slide 3 [Warm-Up / Prior Knowledge]:** Prerequisite recall and mental model activator
-4. **Slide 4 [High-Stakes Hook Scenario]:** Authentic engineering/domain crisis scenario
-5. **Slide 5 [Core Concept 1: Mental Model]:** Principle definition, core terminology, and analogy
-6. **Slide 6 [Architecture & Visual Flow]:** Clean Mermaid diagram (flowchart or sequenceDiagram)
-7. **Slide 7 [Core Concept 2: Syntax / Mechanism Anatomy]:** Breakdown of mechanics and key rules
-8. **Slide 8 [Executable Blueprint / Demonstration]:** Annotated runnable code or structured domain walkthrough
-9. **Slide 9 [Guided Practice: Try It Now]:** 3-5 minute active check (I Do -> We Do)
-10. **Slide 10 [Integrated Hands-On Lab]:** 3-tier differentiated challenge (Bronze / Silver / Gold)
-11. **Slide 11 [Traffic Light Checkpoint & Pitfalls]:** Formative self-check & top 2 student misconceptions
-12. **Slide 12 [Exit Ticket & Metacognition]:** Scenario-based check + 1 reflection question
-13. **Slide 13 [Summary & Next Steps]:** 3 core takeaways and preview of next milestone
-
-Rules:
-- No empty slides or shallow bullet lists. Every slide must contain substantive pedagogical value, diagrams, or runnable snippets.
+2. **Slide 2 [Agenda & Roadmap]:** Timing and milestone breakdown table (${pedagogyLabel})
+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 6-10 lines 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.`;
     const rawSlide = await runCurriculumAIInference(
       [{ role: "user", content: slidePrompt }],
@@ -10770,11 +10778,14 @@ async function produceBatchLessons(storage, projectId, lessonIds, options = {})
 // src/services/singleArtifactService.ts
 init_streamRunner();
 init_errors();
-function getArtifactMetadata(type, lessonId) {
+function getArtifactMetadata(type, lessonId, pedagogy) {
   const id = lessonId || "ON_DEMAND";
   switch (type) {
-    case "lesson":
-      return { filename: `LESSON_${id}.md`, persona: "@content", templateFile: "LESSON_5E_template.md" };
+    case "lesson": {
+      const p = (pedagogy || "").toLowerCase();
+      const templateFile = p === "edp" ? "LESSON_EDP_template.md" : p === "general" ? "LESSON_GENERAL_template.md" : "LESSON_5E_template.md";
+      return { filename: `LESSON_${id}.md`, persona: "@content", templateFile };
+    }
     case "slide":
       return { filename: `SLIDE_${id}.md`, persona: "@illustrator", templateFile: "SLIDE_template.md" };
     case "act":
@@ -10815,6 +10826,8 @@ function getArtifactMetadata(type, lessonId) {
       return { filename: `REVIEW_GAME_${id}.md`, persona: "@assessor", templateFile: "REVIEW_GAME_template.md" };
     case "graphic_organizer":
       return { filename: `GRAPHIC_ORGANIZER_${id}.md`, persona: "@illustrator", templateFile: "GRAPHIC_ORGANIZER_template.md" };
+    default:
+      return { filename: `ARTIFACT_${id}.md`, persona: "@content", templateFile: "LESSON_5E_template.md" };
   }
 }
 async function generateSingleArtifact(req) {
@@ -10827,24 +10840,50 @@ async function generateSingleArtifact(req) {
     targetAge = "14-18 years old (High School / Early College)",
     scaffoldingLevel = "balanced",
     hardwarePlatform = ["MacBook Lab (macOS 14+ / Swift 6)"],
+    gradeLevel,
+    studentCount,
+    language = "Vietnamese",
+    extraContext,
+    config,
     contextSot = {},
     options = {},
     onChunk
   } = req;
-  const meta = getArtifactMetadata(artifactType, lessonId);
-  const templateContent = loadCurriculumTemplate(meta.templateFile);
+  const meta = getArtifactMetadata(artifactType, lessonId, pedagogy || config?.pedagogicalModel);
   const displayTitle = lessonTitle || topic;
+  const loadedTemplate = loadCurriculumTemplate(meta.templateFile);
+  const templateContent = loadedTemplate || getDefaultFallbackTemplate(artifactType, displayTitle, lessonId || "ON_DEMAND");
   const hwStr = hardwarePlatform.join(", ");
+  const selectedDevices = (config?.devices || (hardwarePlatform[0]?.toLowerCase().includes("paper") ? "paper-only" : "laptop")).toLowerCase();
+  const isBilingual = language.toLowerCase().includes("bilingual") || language.toLowerCase().includes("song");
+  const isVietnamese = !isBilingual && language.toLowerCase().includes("viet");
+  const langRule = isBilingual ? `1. AUTHORING LANGUAGE: Bilingual (Vietnamese - English). Headings and core conceptual definitions should be presented in Vietnamese with English technical terms in parentheses. Explanations and instructional text are in Vietnamese. Key code terms, comments, and challenge summaries are presented bilingually.` : isVietnamese ? `1. AUTHORING LANGUAGE: Vietnamese for all instructional text, explanations, questions, rubrics, and presenter notes. Programming code, syntax keywords, and standard API identifiers remain in standard English (with Vietnamese explanation comments/notes).` : `1. AUTHORING LANGUAGE: 100% English (Plan C Canonical Specification).`;
+  const isPaperOnly = selectedDevices === "paper-only" || hwStr.toLowerCase().includes("paper") || hwStr.toLowerCase().includes("print-ready");
+  const deviceRule = isPaperOnly ? `
+- \u{1F4C4} PAPER-ONLY / NO-DEVICE ENVIRONMENT: The learning space has NO computers or screens. All exercises, worksheets, task cards, exit tickets, and code analyses MUST be 100% printable. Provide write-in blank boxes, printed code snippets with line numbers, tracing tables, and physical manipulative instructions.` : selectedDevices === "tablet" || selectedDevices === "smartphone" ? `
+- \u{1F4F1} MOBILE/TABLET ENVIRONMENT: Activities should be optimized for touch interfaces and mobile/tablet sandboxes (e.g. Swift Playgrounds, Web IDEs, tap/touch interactions).` : `
+- \u{1F4BB} LAPTOP/DESKTOP ENVIRONMENT: Full keyboard, terminal, multi-file code editing, and browser developer tooling are available.`;
+  const classDynamicsRule = studentCount ? `
+- \u{1F465} CLASS SIZE LOGISTICS: Class has exactly ${studentCount} students. Structure group sizes, pair-programming pairs, station rotations, and material distribution to realistically accommodate ${studentCount} students without bottlenecks.` : "";
+  const scaffoldingRule = scaffoldingLevel === "foundation" ? `
+- \u{1FA9C} FOUNDATION SCAFFOLDING: High instructional support. Provide step-by-step numbered breakdowns, concrete real-world analogies, hints for every problem, scaffolded starter code/fill-in-the-blanks, and frequent check-for-understanding prompts.` : scaffoldingLevel === "advanced" ? `
+- \u{1F680} ADVANCED CHALLENGE: Minimal scaffolding. Focus on deeper system architecture, edge case handling, computational complexity, performance optimization, and open-ended extension challenges.` : `
+- \u2696\uFE0F BALANCED SCAFFOLDING: Balanced approach combining structured teacher guidance with independent inquiry and problem solving.`;
+  const extraContextRule = extraContext ? `
+- \u{1F3AF} CRITICAL USER INSTRUCTIONS (MANDATORY): "${extraContext}". You MUST directly reflect and satisfy every point of this user guidance in the generated artifact!` : "";
+  const artifactSpecializedPrompt = getArtifactSpecializedInvariants(artifactType, {
+    ...req,
+    studentCount});
   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()}".
 
 ### CORE OPERATIONAL INVARIANTS:
-1. AUTHORING LANGUAGE: 100% English (Plan C Canonical Specification).
+${langRule}
 2. NON-MOCK CODE INVARIANT: Any code snippet provided MUST be 100% syntactically valid, idiomatic, and executable without placeholders or fake functions.
 3. PEDAGOGICAL GROUNDING: Strictly align with the ${pedagogy.toUpperCase()} model, Bloom's Revised Taxonomy, and IEEE/ACM CS2023 guidelines.
-4. SCAFFOLDING LEVEL: "${scaffoldingLevel.toUpperCase()}" (Foundation: High support & concrete analogies; Balanced: Application & problem solving; Advanced: Systems architecture & concurrency invariants).
-5. TARGET AUDIENCE: ${targetAge} on ${hwStr}.
-6. OUTPUT INTEGRITY: Output clean Markdown starting directly with YAML frontmatter. Do not wrap entire response in triple backticks.`;
+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}`;
   const userPrompt = `### CONTEXT GROUND TRUTH:
 - Topic / Concept Domain: "${topic}"
 - Lesson ID: "${lessonId || "ON_DEMAND"}"
@@ -10852,7 +10891,13 @@ Your task is to author a canonical, publication-grade learning artifact of type
 - Pedagogy: "${pedagogy.toUpperCase()}"
 - Scaffolding Level: "${scaffoldingLevel}"
 - Hardware Environment: "${hwStr}"
-
+${gradeLevel ? `- Target Grade Level: "${gradeLevel}"
+` : ""}${studentCount ? `- Class Size: "${studentCount} students"
+` : ""}- Target Language: "${language}"
+${selectedDevices ? `- Device Mode: "${selectedDevices}"
+` : ""}${extraContext ? `- User Specific Guidance & Requirements: "${extraContext}"
+` : ""}${config ? `- Full Task Config: ${JSON.stringify(config)}
+` : ""}
 ${contextSot.framework ? `### SOT CURRICULUM FRAMEWORK:
 ${contextSot.framework.slice(0, 1500)}
 ` : ""}
@@ -10866,15 +10911,10 @@ ${contextSot.handout.slice(0, 1e3)}
 ### MANDATORY CANONICAL TEMPLATE CONTRACT:
 Use the following reference template structure as the exact specification:
 
-${templateContent || `---
-id: "${lessonId || "ON_DEMAND"}"
-title: "${displayTitle}"
-type: "${artifactType.toUpperCase()}"
----
-# ${displayTitle}`}
+${templateContent}
 
 ### TASK INSTRUCTION:
-Generate the complete, thorough, production-grade "${artifactType.toUpperCase()}" artifact for "${displayTitle}". Ensure all [REQUIRED] sections are fully developed with realistic, detailed engineering content.`;
+Generate the complete, thorough, publication-grade "${artifactType.toUpperCase()}" artifact for "${displayTitle}". Ensure all [REQUIRED] sections are fully developed with realistic, detailed pedagogical and technical content. Strictly follow the specialized invariants for "${artifactType.toUpperCase()}".`;
   let accumulatedContent = "";
   let accumulatedThought = "";
   try {
@@ -10913,6 +10953,253 @@ Generate the complete, thorough, production-grade "${artifactType.toUpperCase()}
     });
   }
 }
+function getArtifactSpecializedInvariants(type, req) {
+  const cfg = req.config || {};
+  const isPaperOnly = cfg.devices === "paper-only" || req.hardwarePlatform?.some((h) => h.toLowerCase().includes("paper"));
+  const studentCount = req.studentCount || "25";
+  switch (type) {
+    case "slide": {
+      const slideCount = cfg.slideCount || 10;
+      const presentationStyle = cfg.presentationStyle || "modern";
+      const presentationDuration = cfg.presentationDuration || 45;
+      const includeSpeakerNotes = cfg.includeSpeakerNotes !== false;
+      return `
+### \u{1F3AC} SLIDE PRESENTATION & MARP ARCHITECTURE INVARIANTS:
+1. **SLIDE COUNT & TIMING TARGET**:
+   - Generate EXACTLY ${slideCount} slides separated by \`---\` horizontal rules.
+   - Pacing: Target total duration is ${presentationDuration} minutes (~${Math.round(Number(presentationDuration) / Number(slideCount))} mins per slide).
+   - Visual Style: "${presentationStyle.toUpperCase()}". Maintain high visual clarity, contrasting accents, and executive polish.
+2. **STRICT CONCISENESS & 6x6 RULE (ABSOLUTELY NO TEXT WALLS)**:
+   - A slide is an INTERACTIVE PROJECTION CANVAS, NOT a textbook or lesson plan!
+   - Maximum 4\u20136 bullet points per slide.
+   - Maximum 8\u201312 words per bullet point. Forbid dense multi-sentence paragraphs on the slide surface.
+3. **SPEAKER NOTES FOR ALL SPOKEN WORDS (<!-- Presenter Notes: ... -->)**:
+   ${includeSpeakerNotes ? `- MANDATORY: Every single slide MUST contain structured presenter notes in \`<!-- Presenter Notes: ... -->\` at the bottom:
+     - SCRIPT: 60-90s teacher talk track with intuitive analogies.
+     - COLD CALL / CHECK: Diagnostic question to ask students.
+     - SCAFFOLDING / GOTCHA: How to resolve student misconceptions.
+     - PACING: Recommended minutes for the slide.` : "- Optional brief presenter notes."}
+4. **2-COLUMN & CALLOUT CARD LAYOUTS**:
+   - Use \`<div class="columns"><div>...</div><div>...</div></div>\` for comparisons, code vs. mechanics, or side-by-side tasks.
+   - Use \`<div class="card">\`, \`<div class="card highlight">\`, \`<div class="card warning">\`, and \`<div class="card success">\` for scannable chunking.
+5. **CLICK-TO-REVEAL SYSTEM**:
+   - Use \`<!-- clicks -->\` before bulleted lists (\`<ul>\` or \`<ol>\`) for incremental click-to-reveal.
+   - Use \`<!-- click -->\` before answers, code reveals, or key callouts.
+6. **CONCISE CODE SNIPPETS**:
+   - Maximum 6\u201310 lines of clean code per snippet with inline comments. Never paste whole files.
+7. **MERMAID VISUALS**:
+   - Use Mermaid flowcharts (\`graph TD\` or \`graph LR\`) or sequence diagrams for workflows and control loops.`;
+    }
+    case "tiered_practice": {
+      const techStack = cfg.techStack || (req.hardwarePlatform?.[0] || "Modern Programming Language");
+      const includeUnitTests = cfg.includeUnitTests !== false;
+      return `
+### \u{1FA9C} TIERED PRACTICE ARCHITECTURE INVARIANTS (3-TIER ADAPTIVE):
+- Target Technology Stack: "${techStack}"
+${includeUnitTests ? "- Automated Testing: Include explicit executable Unit Tests / Assertions for verifying Bronze, Silver, and Gold tiers." : ""}
+1. **3 EXPLICIT RIGOR TIERS**:
+   - **\u{1F949} Tier 1 (Bronze / C\u01A1 b\u1EA3n)**: 70% starter boilerplate / 30% fill-in. Direct recall, scaffolded fill-in-the-blanks, single-concept recognition with starter hints.
+   - **\u{1F948} Tier 2 (Silver / Ti\xEAu chu\u1EA9n)**: 30% starter boilerplate / 70% implementation. Independent multi-step problem solving, bug identification, synthesis of 2+ concepts.
+   - **\u{1F947} Tier 3 (Gold / Th\u1EED th\xE1ch)**: 0% code / open architecture. Edge case handling, algorithmic optimization, open-ended architectural design or extension.
+2. **COMPLETE WORKED SOLUTIONS & ANSWER KEYS**:
+   - Provide step-by-step worked solutions for every problem across all 3 tiers.
+3. **SELF-DIAGNOSTIC RUBRIC**:
+   - Include a clear student rubric with criteria for when a student is ready to level up from Bronze \u2794 Silver \u2794 Gold.`;
+    }
+    case "exit_ticket": {
+      const questionCount = cfg.questionCount || 3;
+      const diagnosticFocus = cfg.diagnosticFocus || "misconceptions";
+      return `
+### \u{1F39F}\uFE0F EXIT TICKET ARCHITECTURE INVARIANTS:
+1. **EXACTLY ${questionCount} TARGETED ITEMS (3\u20135 MINUTE DURATION)**:
+   - Item 1: Quick diagnostic checking mastery of the core objective.
+   - Item 2: Application with diagnostic trap focusing on: "${diagnosticFocus}".
+   - Item 3: Metacognitive self-check (Confidence rating 1\u20135 + "Explain what is still fuzzy").
+2. **TEACHER DIAGNOSTIC INTERVENTION GUIDE**:
+   - Provide a quick lookup table: "If student chooses/writes X \u2794 Misconception is Y \u2794 Quick remedy is Z".${isPaperOnly ? "\n3. **PRINTABLE CUT-OUT FORMAT**: Include student name/date line and cut-border dashed line." : ""}`;
+    }
+    case "quiz": {
+      const questionCount = cfg.questionCount || 5;
+      const questionTypes = Array.isArray(cfg.questionTypes) ? cfg.questionTypes.join(", ") : cfg.questionTypes || "multiple_choice";
+      const diagnosticFocus = cfg.diagnosticFocus || "balanced";
+      return `
+### \u{1F4DD} BLOOM-ALIGNED QUIZ ARCHITECTURE INVARIANTS:
+1. **EXACTLY ${questionCount} QUESTIONS (${questionTypes.toUpperCase()})**:
+   - Diagnostic emphasis: "${diagnosticFocus}".
+   - 40% Remember/Understand (Conceptual foundations).
+   - 40% Apply/Analyze (Bug finding, code tracing, scenario application).
+   - 20% Evaluate/Create (Algorithmic reasoning, trade-off evaluation).
+2. **HIGH-QUALITY DISTRACTORS WITH RATIONALE**:
+   - For every multiple choice item, explain WHY each incorrect option is a plausible misconception and WHY the key is correct.
+3. **COMPLETE ANSWER KEY & SCORING RUBRIC**:
+   - Explicit point distribution, partial credit guidelines, and sample ideal answers for open-ended questions.`;
+    }
+    case "task_cards": {
+      const cardCount = cfg.cardCount || 12;
+      const cardUsage = cfg.cardUsage || "stations";
+      return `
+### \u{1F4CB} TASK CARDS ARCHITECTURE INVARIANTS:
+1. **SET OF EXACTLY ${cardCount} NUMBERED CARDS (Optimized for ${cardUsage.toUpperCase()})**:
+   - Clearly mark each card: Card # (1 to ${cardCount}), Difficulty (Foundation / Standard / Challenge), and Target Skill.
+2. **STUDENT RECORDING SHEET (B\u1EA2NG GHI \u0110\xC1P \xC1N)**:
+   - Include a structured printable grid where students record answers for Cards 1\u2013${cardCount}.
+3. **TEACHER MASTER KEY**:
+   - Quick reference key with verified answers and explanations.${isPaperOnly ? "\n4. **PRINT-READY CARD BORDERS**: Layout with clean visual borders ready for physical printing and cutting." : ""}`;
+    }
+    case "graphic_organizer": {
+      const diagramType = cfg.diagramType || "concept_map";
+      const includeFillIn = cfg.includeFillInExercise !== false;
+      return `
+### \u{1F4CA} GRAPHIC ORGANIZER ARCHITECTURE INVARIANTS:
+1. **VISUAL MODEL TYPE: "${diagramType.toUpperCase()}"**:
+   - Structure a clear cognitive thinking tool: Concept Map, Flowchart, Venn Diagram, Hierarchy Tree, or Cause-Effect Matrix.
+2. **VALID MERMAID SYNTAX**:
+   - Embed complete, 100% syntactically correct Mermaid diagrams showing the knowledge structure.
+3. **ACTIVE STUDENT INTERACTION PROMPTS**:
+   ${includeFillIn ? "- Include interactive fill-in-the-blank nodes and connection articulation challenges." : "- Include synthesis and reflection prompts based on the visual model."}`;
+    }
+    case "choice_board": {
+      const gridSize = cfg.gridSize || "3x3";
+      const completionRule = cfg.completionRule || "row_column_diagonal";
+      return `
+### \u{1F3AF} CHOICE BOARD ARCHITECTURE INVARIANTS (UDL ${gridSize.toUpperCase()} MATRIX):
+1. **${gridSize.toUpperCase()} MENU (UDL MULTIPLE MEANS OF EXPRESSION)**:
+   - Option tasks spanning practical coding, architectural diagrams, analytical writing, and real-world scenarios.
+2. **COMPLETION CONTRACT: "${completionRule.toUpperCase()}"**:
+   - Explicit rule (e.g. Tic-Tac-Toe 3-in-a-row/column/diagonal, or Point Bounty system).
+3. **UNIFIED EVALUATION RUBRIC**:
+   - Consistent grading criteria applicable across all task choices on the board.`;
+    }
+    case "station_rotation": {
+      const stationCount = cfg.stationCount || 3;
+      const stationDuration = cfg.stationDuration || 15;
+      return `
+### \u{1F504} STATION ROTATION ARCHITECTURE INVARIANTS:
+1. **EXACTLY ${stationCount} STATIONS SCALED FOR ${studentCount} STUDENTS**:
+   - Group size: ~${Math.ceil(Number(studentCount) / Number(stationCount)) || 7} students per group.
+   - Distinct station roles: Teacher-Led Small Group, Independent Practical Lab, Collaborative / Unplugged Peer Challenge.
+2. **TIMING & TRANSITIONS (${stationDuration} MINS/STATION)**:
+   - ${stationDuration} minutes per station + 3-minute structured rotation protocol.
+3. **STATION DELIVERABLES & ACCOUNTABILITY**:
+   - Clear check-in deliverable required at each station to ensure on-task accountability.`;
+    }
+    case "act":
+    case "codelab":
+    case "science_lab": {
+      const techStack = cfg.techStack || (req.hardwarePlatform?.[0] || "Modern Programming Language");
+      const includeUnitTests = cfg.includeUnitTests !== false;
+      return `
+### \u{1F4BB} HANDS-ON LAB & CODE ACTIVITY ARCHITECTURE INVARIANTS:
+- Technology Stack: "${techStack}"
+${includeUnitTests ? "- Unit Testing: Provide automated assertions or test runner checks." : ""}
+1. **100% RUNNABLE CODE / RIGOROUS PROCEDURE**:
+   - Absolutely no fake APIs, mock functions, or non-executable pseudocode.
+2. **STRUCTURED LAB PHASES**:
+   - Objective & Environmental Prerequisites.
+   - Starter Skeleton Code with clear \`// TODO [Student Task]\` comments.
+   - Step-by-step Guided Challenges (Level 1 \u2794 Level 2 \u2794 Level 3).
+   - Automated Verification / Test Cases.
+   - Complete Reference Solution with design explanation.`;
+    }
+    case "bell_ringer":
+      return `
+### \u{1F514} BELL RINGER ARCHITECTURE INVARIANTS (3\u20135 MIN WARM-UP):
+1. **3 QUICK HOOK QUESTIONS**:
+   - 2 rapid-fire recall questions activating previous knowledge.
+   - 1 curiosity hook question bridging into today's core topic.
+2. **60-SECOND TEACHER REVIEW KEY**:
+   - Quick-glance answer key for instant whole-class review.`;
+    case "review_game":
+      return `
+### \u{1F3AE} REVIEW GAME ARCHITECTURE INVARIANTS:
+1. **GAMIFIED STRUCTURE**:
+   - Jeopardy-style board (3\u20134 Categories x 3 Point Values: 100 / 200 / 300) OR 3-Round Interactive Trivia.
+2. **CLEAR RULES & TEAM DYNAMICS**:
+   - Team scoring rules, buzz-in protocol, and tie-breaker challenge.
+3. **COMPLETE QUESTION & ANSWER DECK**:
+   - Verified answers and point values for the host/teacher.`;
+    case "guide": {
+      const lessonDuration = cfg.lessonDuration || 90;
+      return `
+### \u{1F4D6} TEACHER GUIDE ARCHITECTURE INVARIANTS (${lessonDuration} MINS LESSON):
+1. **MINUTE-BY-MINUTE PACING TIMELINE**:
+   - Pacing broken down for ${lessonDuration} minutes (Hook, Modeling, Guided Practice, Independent Practice, Debrief).
+2. **SOCRATIC QUESTIONS & PROMPTS**:
+   - Cold-call questions with anticipated student misconceptions and remediation scripts.
+3. **DIFFERENTIATION STRATEGIES**:
+   - Specific adaptations for students needing support vs. high-flyers needing extension.`;
+    }
+    case "worksheet":
+    case "handout":
+      return `
+### \u{1F4D1} WORKSHEET / HANDOUT ARCHITECTURE INVARIANTS:
+1. **I DO \u2794 WE DO \u2794 YOU DO SCAFFOLDING**:
+   - Part 1 (I Do): Fully worked and annotated example.
+   - Part 2 (We Do): Guided problem with fill-in hints and scaffolding scaffolds.
+   - Part 3 (You Do): Independent mastery challenge.
+2. **SELF-CHECK RUBRIC**:
+   - End-of-worksheet self-evaluation checklist.${isPaperOnly ? "\n3. **PRINTABLE WORKSPACES**: Include spacious, clean write-in boxes and workspace for calculations/code." : ""}`;
+    case "rubric": {
+      const rubricScale = cfg.rubricScale || "4_levels";
+      return `
+### \u{1F4CA} ANALYTIC RUBRIC ARCHITECTURE INVARIANTS (${rubricScale.toUpperCase()} SCALE):
+1. **RIGOROUS PROFICIENCY LEVELS**:
+   - 4 Proficiency Levels: Level 4 (Exemplary) | Level 3 (Proficient) | Level 2 (Developing) | Level 1 (Beginning).
+2. **CONCRETE OBSERVABLE CRITERIA**:
+   - Each cell MUST describe concrete, observable behavioral evidence, not vague words like "good" or "average".`;
+    }
+    case "glossary":
+      return `
+### \u{1F4DA} TECHNICAL GLOSSARY ARCHITECTURE INVARIANTS:
+1. **COMPREHENSIVE TERM PROFILES**:
+   - For every key term: Technical Definition, Real-world Analogy, Code Syntax Example, and Common Misconception.`;
+    case "bom":
+      return `
+### \u{1F4E6} BILL OF MATERIALS (BOM) ARCHITECTURE INVARIANTS:
+1. **CLASS-SCALED INVENTORY FOR ${studentCount} STUDENTS**:
+   - Exact quantities calculated for ${studentCount} students.
+   - Component specifications, estimated unit cost, and affordable alternatives.`;
+    case "lesson": {
+      const lessonDuration = cfg.lessonDuration || 90;
+      const pedagogicalModel = cfg.pedagogicalModel || req.pedagogy || "5e";
+      return `
+### \u{1F393} CANONICAL LESSON PLAN INVARIANTS (${pedagogicalModel.toUpperCase()} MODEL, ${lessonDuration} MINS):
+1. **A. LESSON DESIGN PLAN**:
+   - Learning Objectives (Bloom-aligned) & Observable Student Evidence.
+   - Activity Sequence mapping every phase with timing totaling ${lessonDuration} minutes.
+   - Resource Map & Assessment Map with explicit Artifact Contracts.
+2. **B. LESSON FLOW**:
+   - Detailed teacher moves, student actions, scripted key questions, and check-for-understanding points for every activity phase.`;
+    }
+    default:
+      return "";
+  }
+}
+function getDefaultFallbackTemplate(type, title, id) {
+  const upperType = type.toUpperCase();
+  return `---
+id: "${id}"
+title: "${title}"
+type: "${upperType}"
+version: "1.0.0"
+date: "${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
+---
+
+# ${title}
+
+## 1. Overview & Learning Objectives
+<!-- [REQUIRED] State 2-3 measurable, Bloom-aligned learning objectives -->
+
+## 2. Core Pedagogical Content
+<!-- [REQUIRED] Provide the core educational substance, questions, problems, and diagrams -->
+
+## 3. Practice & Differentiation
+<!-- [REQUIRED] Tiered support, worked examples, and challenges -->
+
+## 4. Assessment & Answer Key
+<!-- [REQUIRED] Complete solutions, rubrics, and diagnostic teacher feedback -->
+`;
+}
 
 // src/services/projectCreationService.ts
 init_streamRunner();