@thanh01.pmt/curriculum-kit 1.0.2 → 1.0.3

package/dist/workflow/index.d.cts

@@ -1,4 +1,4 @@
-export { I as ApprovalPayload, y as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, L as ExecuteWithRateLimitOptions, z as GateSettings, G as GenerateMasterLessonStepInput, Q as GenerateRoadmapWorkflowInput, J as JudgeMasterLessonStepInput, q as JudgeSatelliteStepInput, N as MilestoneWorkflowInput, O as MilestoneWorkflowResult, e as RepairMasterLessonStepInput, R as ResolvedGateSettings, T as RoadmapWorkflowSummary, t as SaveMilestoneArtifactsInput, u as SavedMilestoneResult, H as approvalPayloadSchema, V as executeSingleArtifactStep, F as gateModeFor, f as generateActivityStep, h as generateCodeLabStep, k as generateDiagnosticQuizStep, p as generateExtensionStep, m as generateHandoutStep, d as generateMasterLessonStep, P as generateMilestoneWorkflow, U as generateRoadmapWorkflow, i as generateSelfLabStep, W as generateSingleArtifactWorkflow, l as generateSlidesStep, o as generateTeacherGuideStep, n as generateWorksheetStep, j as judgeMasterLessonStep, s as judgeSatelliteStep, K as lessonApprovalHook, B as parseGateSettings, w as publishToGitStep, x as publishToSupabaseStep, r as repairMasterLessonStep, E as resolveGateSettings, v as saveMilestoneToWorkspaceStep, M as withRateLimitBackoff } from '../index-PDw11tpD.cjs';
+export { I as ApprovalPayload, y as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, L as ExecuteWithRateLimitOptions, z as GateSettings, G as GenerateMasterLessonStepInput, Q as GenerateRoadmapWorkflowInput, J as JudgeMasterLessonStepInput, q as JudgeSatelliteStepInput, N as MilestoneWorkflowInput, O as MilestoneWorkflowResult, e as RepairMasterLessonStepInput, R as ResolvedGateSettings, T as RoadmapWorkflowSummary, t as SaveMilestoneArtifactsInput, u as SavedMilestoneResult, H as approvalPayloadSchema, V as executeSingleArtifactStep, F as gateModeFor, f as generateActivityStep, h as generateCodeLabStep, k as generateDiagnosticQuizStep, p as generateExtensionStep, m as generateHandoutStep, d as generateMasterLessonStep, P as generateMilestoneWorkflow, U as generateRoadmapWorkflow, i as generateSelfLabStep, W as generateSingleArtifactWorkflow, l as generateSlidesStep, o as generateTeacherGuideStep, n as generateWorksheetStep, j as judgeMasterLessonStep, s as judgeSatelliteStep, K as lessonApprovalHook, B as parseGateSettings, w as publishToGitStep, x as publishToSupabaseStep, r as repairMasterLessonStep, E as resolveGateSettings, v as saveMilestoneToWorkspaceStep, M as withRateLimitBackoff } from '../index-BIhxrUEa.cjs';
 import '../schemas/index.cjs';
 import 'zod';
 import '../provider-factory-DH3udYlN.cjs';

package/dist/workflow/index.d.ts

@@ -1,4 +1,4 @@
-export { I as ApprovalPayload, y as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, L as ExecuteWithRateLimitOptions, z as GateSettings, G as GenerateMasterLessonStepInput, Q as GenerateRoadmapWorkflowInput, J as JudgeMasterLessonStepInput, q as JudgeSatelliteStepInput, N as MilestoneWorkflowInput, O as MilestoneWorkflowResult, e as RepairMasterLessonStepInput, R as ResolvedGateSettings, T as RoadmapWorkflowSummary, t as SaveMilestoneArtifactsInput, u as SavedMilestoneResult, H as approvalPayloadSchema, V as executeSingleArtifactStep, F as gateModeFor, f as generateActivityStep, h as generateCodeLabStep, k as generateDiagnosticQuizStep, p as generateExtensionStep, m as generateHandoutStep, d as generateMasterLessonStep, P as generateMilestoneWorkflow, U as generateRoadmapWorkflow, i as generateSelfLabStep, W as generateSingleArtifactWorkflow, l as generateSlidesStep, o as generateTeacherGuideStep, n as generateWorksheetStep, j as judgeMasterLessonStep, s as judgeSatelliteStep, K as lessonApprovalHook, B as parseGateSettings, w as publishToGitStep, x as publishToSupabaseStep, r as repairMasterLessonStep, E as resolveGateSettings, v as saveMilestoneToWorkspaceStep, M as withRateLimitBackoff } from '../index-BAUtASfr.js';
+export { I as ApprovalPayload, y as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, L as ExecuteWithRateLimitOptions, z as GateSettings, G as GenerateMasterLessonStepInput, Q as GenerateRoadmapWorkflowInput, J as JudgeMasterLessonStepInput, q as JudgeSatelliteStepInput, N as MilestoneWorkflowInput, O as MilestoneWorkflowResult, e as RepairMasterLessonStepInput, R as ResolvedGateSettings, T as RoadmapWorkflowSummary, t as SaveMilestoneArtifactsInput, u as SavedMilestoneResult, H as approvalPayloadSchema, V as executeSingleArtifactStep, F as gateModeFor, f as generateActivityStep, h as generateCodeLabStep, k as generateDiagnosticQuizStep, p as generateExtensionStep, m as generateHandoutStep, d as generateMasterLessonStep, P as generateMilestoneWorkflow, U as generateRoadmapWorkflow, i as generateSelfLabStep, W as generateSingleArtifactWorkflow, l as generateSlidesStep, o as generateTeacherGuideStep, n as generateWorksheetStep, j as judgeMasterLessonStep, s as judgeSatelliteStep, K as lessonApprovalHook, B as parseGateSettings, w as publishToGitStep, x as publishToSupabaseStep, r as repairMasterLessonStep, E as resolveGateSettings, v as saveMilestoneToWorkspaceStep, M as withRateLimitBackoff } from '../index-BvWC_xXe.js';
 import '../schemas/index.js';
 import 'zod';
 import '../provider-factory-DH3udYlN.js';

package/dist/workflow/index.mjs

@@ -1,5 +1,5 @@
 import fs from 'fs';
-import path from 'path';
+import path4 from 'path';
 import { generateObject } from 'ai';
 import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import { createOpenAI } from '@ai-sdk/openai';
@@ -128,14 +128,14 @@ function resolveApiKey(keyName, explicitKey) {
   try {
     const currentDir = process.cwd();
     const envPaths = [
-      path.resolve(currentDir, ".env.local"),
-      path.resolve(currentDir, ".env"),
-      path.resolve(currentDir, "apps/web/.env.local"),
-      path.resolve(currentDir, "packages/learnwell-platform/.env"),
-      path.resolve(currentDir, "..", ".env.local"),
-      path.resolve(currentDir, "..", ".env"),
-      path.resolve(currentDir, "../..", ".env.local"),
-      path.resolve(currentDir, "../..", ".env")
+      path4.resolve(currentDir, ".env.local"),
+      path4.resolve(currentDir, ".env"),
+      path4.resolve(currentDir, "apps/web/.env.local"),
+      path4.resolve(currentDir, "packages/learnwell-platform/.env"),
+      path4.resolve(currentDir, "..", ".env.local"),
+      path4.resolve(currentDir, "..", ".env"),
+      path4.resolve(currentDir, "../..", ".env.local"),
+      path4.resolve(currentDir, "../..", ".env")
     ];
     for (const envPath of envPaths) {
       if (fs.existsSync(envPath)) {
@@ -4574,10 +4574,10 @@ ${answerKeySection}
 var LocalWorkspaceManager = class {
   baseDir;
   constructor(baseDir) {
-    this.baseDir = baseDir || path.resolve(process.cwd(), "output", "workspace-jobs");
+    this.baseDir = baseDir || path4.resolve(process.cwd(), "output", "workspace-jobs");
   }
   getJobDirectory(jobId) {
-    return path.join(this.baseDir, jobId);
+    return path4.join(this.baseDir, jobId);
   }
   async initJobWorkspace(jobId, initialInfo) {
     const jobDir = this.getJobDirectory(jobId);
@@ -4600,9 +4600,9 @@ var LocalWorkspaceManager = class {
   }
   async saveArtifact(jobId, milestoneSlug, filename, content, artifactType) {
     const jobDir = this.getJobDirectory(jobId);
-    const targetDir = path.join(jobDir, milestoneSlug);
+    const targetDir = path4.join(jobDir, milestoneSlug);
     await fs2.mkdir(targetDir, { recursive: true });
-    const filePath = path.join(targetDir, filename);
+    const filePath = path4.join(targetDir, filename);
     await fs2.writeFile(filePath, content, "utf-8");
     const stat = await fs2.stat(filePath);
     const manifest = await this.getManifest(jobId);
@@ -4610,7 +4610,7 @@ var LocalWorkspaceManager = class {
       manifest.artifacts.push({
         milestoneId: milestoneSlug,
         artifactType,
-        filePath: path.relative(jobDir, filePath),
+        filePath: path4.relative(jobDir, filePath),
         sizeBytes: stat.size,
         createdAt: (/* @__PURE__ */ new Date()).toISOString()
       });
@@ -4620,7 +4620,7 @@ var LocalWorkspaceManager = class {
     return filePath;
   }
   async getManifest(jobId) {
-    const manifestPath = path.join(this.getJobDirectory(jobId), "manifest.json");
+    const manifestPath = path4.join(this.getJobDirectory(jobId), "manifest.json");
     try {
       const data = await fs2.readFile(manifestPath, "utf-8");
       return JSON.parse(data);
@@ -4629,7 +4629,7 @@ var LocalWorkspaceManager = class {
     }
   }
   async saveManifest(jobId, manifest) {
-    const manifestPath = path.join(this.getJobDirectory(jobId), "manifest.json");
+    const manifestPath = path4.join(this.getJobDirectory(jobId), "manifest.json");
     manifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     await fs2.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
   }
@@ -4670,12 +4670,12 @@ async function publishToGitHub(options) {
     async function scanDir(currentDir) {
       const entries = await fs2.readdir(currentDir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = path.join(currentDir, entry.name);
+        const fullPath = path4.join(currentDir, entry.name);
         if (entry.isDirectory()) {
           await scanDir(fullPath);
         } else if (entry.isFile() && !entry.name.startsWith(".")) {
           const content = await fs2.readFile(fullPath, "utf-8");
-          const relPath = path.relative(options.localJobDir, fullPath);
+          const relPath = path4.relative(options.localJobDir, fullPath);
           filesToUpload.push({ path: relPath, content });
         }
       }
@@ -5892,16 +5892,18 @@ init_errors();
 
 // src/services/lessonProductionService.ts
 var __filename$1 = typeof import.meta?.url === "string" ? fileURLToPath(import.meta.url) : "";
-var _resolvedDir = __filename$1 ? path.dirname(__filename$1) : typeof __dirname !== "undefined" ? __dirname : process.cwd();
+var _resolvedDir = __filename$1 ? path4.dirname(__filename$1) : typeof __dirname !== "undefined" ? __dirname : process.cwd();
 function loadCurriculumTemplate(templateName) {
   const candidatePaths = [
-    path.resolve(process.cwd(), "_templates", templateName),
-    path.resolve(process.cwd(), "packages/curriculum-kit/docs/refs/templates", templateName),
-    path.resolve(process.cwd(), "docs/refs/templates", templateName),
-    path.resolve(_resolvedDir, "../docs/refs/templates", templateName),
-    path.resolve(_resolvedDir, "../../docs/refs/templates", templateName),
-    path.resolve(_resolvedDir, "../../../docs/refs/templates", templateName),
-    path.resolve(_resolvedDir, "../../../../the-ultimate-curriculum-agent-os/_templates", templateName)
+    path4.resolve("/Users/tonypham/MEGA/WebApp/WIP/learnwell-platform/packages/curriculum-kit/docs/refs/templates", templateName),
+    path4.resolve(process.cwd(), "packages/curriculum-kit/docs/refs/templates", templateName),
+    path4.resolve(process.cwd(), "_templates", templateName),
+    path4.resolve(process.cwd(), "docs/refs/templates", templateName),
+    path4.resolve(_resolvedDir, "../docs/refs/templates", templateName),
+    path4.resolve(_resolvedDir, "../../docs/refs/templates", templateName),
+    path4.resolve(_resolvedDir, "../../../docs/refs/templates", templateName),
+    path4.resolve("/Users/tonypham/MEGA/WebApp/content-gen/the-ultimate-curriculum-agent-os/_templates", templateName),
+    path4.resolve(_resolvedDir, "../../../../the-ultimate-curriculum-agent-os/_templates", templateName)
   ];
   for (const p of candidatePaths) {
     if (fs.existsSync(p)) {
@@ -5917,11 +5919,14 @@ function loadCurriculumTemplate(templateName) {
 
 // src/services/singleArtifactService.ts
 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":
@@ -5962,6 +5967,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) {
@@ -5974,24 +5981,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"}"
@@ -5999,7 +6032,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)}
 ` : ""}
@@ -6013,15 +6052,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 {
@@ -6060,6 +6094,248 @@ 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 a VISUAL 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 comprehensive presenter notes in `<!-- Presenter Notes: ... -->` at the bottom, giving the teacher the exact verbal talking points, analogies, and pacing tips." : "- Optional brief presenter notes."}
+4. **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.
+5. **2-COLUMN / SPLIT LAYOUT**:
+   - Use <div class="columns"><div>...</div><div>...</div></div> for side-by-side concept vs. code or problem vs. solution comparisons.
+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 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/workflow/workflows/singleArtifactWorkflow.ts
 async function executeSingleArtifactStep(request) {