@thanh01.pmt/curriculum-kit 1.4.41 → 1.4.43

package/dist/index.d.ts

@@ -10,8 +10,8 @@ export { A as AutoRepairOptions, a as AutoRepairResult, B as BundleTier, G as Ge
 import { I as ICurriculumStorage, P as ProjectStatusReport, S as SmartResumeContext, Q as QualityAuditReport } from './types-Bgk-C4K2.js';
 export { b as ArtifactLifecycleInfo, A as ArtifactLifecycleState, L as LessonArtifactSummary, c as PipelineState, R as ReviewRecord, a as SotDocument, T as TaskLifecycleState } from './types-Bgk-C4K2.js';
 export { FileSystemCurriculumAdapter, FileSystemStorageOptions, STANDARD_SOT_FILES, StorageFactoryOptions, SupabaseCurriculumAdapter, SupabaseStorageConfig, atomicWriteFileSync, computeContentHash, createCurriculumStorage } from './storage/index.js';
-import { F as FrameworkPack, C as CoverageGateReport } from './standardsCoverageGate-CLnq0d0s.js';
-export { B as BloomHintSchema, a as ClassificationSchema, m as CoverageGateInput, h as FrameworkMapping, d as FrameworkMappingSchema, f as FrameworkPackManifest, b as FrameworkPackManifestSchema, e as FrameworkPackSchema, g as FrameworkStatement, c as FrameworkStatementSchema, G as GradeBandSchema, i as MappingKind, M as MappingKindSchema, P as PackLintIssue, k as PackValidationResult, j as RecordProvenance, R as RecordProvenanceSchema, S as StatementCoverageRow, n as evaluateStandardsCoverage, l as lintFrameworkPack, v as validateFrameworkPack } from './standardsCoverageGate-CLnq0d0s.js';
+import { F as FrameworkPack, C as CoverageGateReport } from './standardsCoverageGate-49pJq5t8.js';
+export { B as BloomHintSchema, a as ClassificationSchema, m as CoverageGateInput, h as FrameworkMapping, d as FrameworkMappingSchema, f as FrameworkPackManifest, b as FrameworkPackManifestSchema, e as FrameworkPackSchema, g as FrameworkStatement, c as FrameworkStatementSchema, G as GradeBandSchema, i as MappingKind, M as MappingKindSchema, P as PackLintIssue, k as PackValidationResult, j as RecordProvenance, R as RecordProvenanceSchema, S as StatementCoverageRow, n as evaluateStandardsCoverage, l as lintFrameworkPack, v as validateFrameworkPack } from './standardsCoverageGate-49pJq5t8.js';
 import { z } from 'zod';
 import { R as ResolvedGateSettings } from './gateSettings-oo5tCUS_.js';
 export { A as ArtifactType, B as BoundaryPeek, b as CurriculumArtifactType, C as CurriculumGateMode, h as CurriculumHorizon, D as DEFAULT_GATE_SETTINGS, f as DetailedLessonBridge, E as ExtractCurriculumHorizonOptions, G as GateSettings, H as HorizonSessionSnapshot, i as HorizonValidationResult, c as ScaffoldingLevel, S as SingleArtifactRequest, a as SingleArtifactResult, k as extractCurriculumHorizon, g as gateModeFor, e as generateSingleArtifact, d as getArtifactMetadata, j as parseAllSessions, p as parseGateSettings, l as renderHorizonPromptBlock, r as resolveGateSettings, v as validateHorizonCompliance } from './gateSettings-oo5tCUS_.js';
@@ -249,16 +249,16 @@ declare const LessonEntitySchema: z.ZodObject<{
         conceptRefs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
     }, "strip", z.ZodTypeAny, {
         code: string;
+        objective: string;
+        evidence: string;
         successCriteria: string;
         standardRefs: string[];
         conceptRefs: string[];
-        objective: string;
-        evidence: string;
     }, {
         code: string;
-        successCriteria: string;
         objective: string;
         evidence: string;
+        successCriteria: string;
         standardRefs?: string[] | undefined;
         conceptRefs?: string[] | undefined;
     }>, "many">>;
@@ -275,7 +275,6 @@ declare const LessonEntitySchema: z.ZodObject<{
         durationMinutes: z.ZodDefault<z.ZodNumber>;
         artifactContract: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        durationMinutes: number;
         seq: number;
         phase: string;
         activityType: string;
@@ -285,6 +284,7 @@ declare const LessonEntitySchema: z.ZodObject<{
         teacherMove: string;
         outputEvidence: string;
         lo: string[];
+        durationMinutes: number;
         artifactContract: string;
     }, {
         seq: number;
@@ -317,17 +317,16 @@ declare const LessonEntitySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     lessonId: string;
     title: string;
+    estimatedDuration: string;
     learningObjectives: {
         code: string;
+        objective: string;
+        evidence: string;
         successCriteria: string;
         standardRefs: string[];
         conceptRefs: string[];
-        objective: string;
-        evidence: string;
     }[];
-    estimatedDuration: string;
     activitySequence: {
-        durationMinutes: number;
         seq: number;
         phase: string;
         activityType: string;
@@ -337,6 +336,7 @@ declare const LessonEntitySchema: z.ZodObject<{
         teacherMove: string;
         outputEvidence: string;
         lo: string[];
+        durationMinutes: number;
         artifactContract: string;
     }[];
     assessmentMap: Record<string, string>[];
@@ -349,15 +349,15 @@ declare const LessonEntitySchema: z.ZodObject<{
 }, {
     lessonId: string;
     title: string;
+    estimatedDuration?: string | undefined;
     learningObjectives?: {
         code: string;
-        successCriteria: string;
         objective: string;
         evidence: string;
+        successCriteria: string;
         standardRefs?: string[] | undefined;
         conceptRefs?: string[] | undefined;
     }[] | undefined;
-    estimatedDuration?: string | undefined;
     activitySequence?: {
         seq: number;
         phase: string;
@@ -493,9 +493,83 @@ interface ActivityAlignmentResult {
 declare function evaluateActivityAlignment(canonicalExcerpt: string | undefined, generatedContent: string, now?: Date): ActivityAlignmentResult;
 
 /**
- * Resolves and loads official canonical templates from docs/refs/templates or _templates/
+ * P52 — Runtime artifact-template loading (single source of truth).
+ *
+ * Restores the curriculum-mcp architecture that was lost when prompt
+ * skeletons were retyped as hardcoded strings inside
+ * `lessonProductionService.ts` (the "mandated duplication" regression):
+ *   - artifact structure lives in template .md files, loaded at RUNTIME;
+ *   - methodology directives stay in the prompt-builder;
+ *   - project-local `_templates/` may override any template (MCP parity).
+ *
+ * A template file = YAML frontmatter (may declare `template_required_sections`,
+ * the canonical contract echoed by generated artifacts) + fill-in body whose
+ * headers the LLM must keep verbatim.
  */
-declare function loadCurriculumTemplate(templateName: string): string;
+interface ResolvedTemplate {
+    /** Fill-in body (frontmatter + leading HTML comments stripped). */
+    content: string;
+    /**
+     * Canonical section contract: template frontmatter
+     * `template_required_sections` when declared, else normalized H2 headings.
+     */
+    sections: string[];
+    /** Absolute path the template was loaded from (telemetry / debugging). */
+    sourcePath: string;
+}
+/**
+ * Strip YAML frontmatter from a template document.
+ * NOTE: HTML comments are intentionally preserved — some templates embed
+ * semantic markers (e.g. ACT's `<!-- [HARDWARE_BOM] -->`) that downstream
+ * extraction pipelines depend on. Only frontmatter is noise here.
+ */
+declare function stripTemplateFrontmatter(raw: string): string;
+/**
+ * Minimal reader for the `template_required_sections:` YAML list.
+ * Deliberately not a full YAML parser — the contract is one flat list of
+ * quoted strings; anything else falls back to H2 extraction.
+ */
+declare function extractRequiredSections(raw: string): string[] | null;
+/** H2 headings of the template body (frontmatter-stripped), normalized. */
+declare function extractBodySections(raw: string): string[];
+/**
+ * Resolve a canonical template by file name. First existing candidate wins:
+ * explicit dir → CURRICULUM_TEMPLATES_DIR → <cwd>/_templates → packaged
+ * dist/templates → repo docs/refs/templates. Returns null when unresolvable
+ * (callers fall back to inline scaffolding, same contract as before).
+ */
+declare function resolveArtifactTemplate(templateName: string, opts?: {
+    templatesDir?: string;
+}): ResolvedTemplate | null;
+/**
+ * Legacy raw-content lookup retained for existing callers
+ * (`singleArtifactService`, SLIDE workflow). Returns the file verbatim —
+ * frontmatter included, byte-compatible with the pre-P52 helper it replaces.
+ * Empty string = not found.
+ */
+declare function loadCurriculumTemplate(templateName: string, templatesDir?: string): string;
+
+interface ArtifactPromptParts {
+    /** Methodology directive — persona, quality bar, anti-duplication rules. */
+    directive: string;
+    /** Canonical template file name (e.g. `CODE_template.md`). */
+    templateFile: string;
+    /** Extra scaffold appended after the template body (optional). */
+    epilogue?: string;
+}
+/**
+ * Compose a satellite prompt: methodology directive + runtime-loaded fill-in
+ * template body. Falls back to `inlineScaffold` when the template file cannot
+ * be resolved (same fail-open contract as the pre-P52 hardcoded prompts).
+ *
+ * The delimiting banner is plain text (not an HTML comment) so the artifact
+ * linter's placeholder scanner can never confuse it with template scaffolding
+ * that leaked into generated content.
+ */
+declare function buildArtifactPrompt(parts: ArtifactPromptParts, opts?: {
+    templatesDir?: string;
+}): string;
+
 type PedagogicalModel = '5e' | 'edp' | 'pbl' | 'general';
 interface ProduceLessonOptions {
     artifactScope?: string[];
@@ -1270,7 +1344,7 @@ declare const SlideBlueprintItemSchema: z.ZodObject<{
     clusterTitle: string | null;
     slideIndex: number;
     lessonPhase: string | null;
-    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    layoutId: "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "tiered-practice-3cards" | "summary-takeaways";
     pedagogicalGoal: string | null;
     contentFocus: string[] | null;
     codeSnippetIntent?: string | null | undefined;
@@ -1278,7 +1352,7 @@ declare const SlideBlueprintItemSchema: z.ZodObject<{
 }, {
     title: string;
     slideIndex: number;
-    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    layoutId: "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "tiered-practice-3cards" | "summary-takeaways";
     clusterId?: number | null | undefined;
     clusterTitle?: string | null | undefined;
     lessonPhase?: string | null | undefined;
@@ -1304,7 +1378,7 @@ declare const SlideBlueprintArraySchema: z.ZodArray<z.ZodObject<{
     clusterTitle: string | null;
     slideIndex: number;
     lessonPhase: string | null;
-    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    layoutId: "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "tiered-practice-3cards" | "summary-takeaways";
     pedagogicalGoal: string | null;
     contentFocus: string[] | null;
     codeSnippetIntent?: string | null | undefined;
@@ -1312,7 +1386,7 @@ declare const SlideBlueprintArraySchema: z.ZodArray<z.ZodObject<{
 }, {
     title: string;
     slideIndex: number;
-    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    layoutId: "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "tiered-practice-3cards" | "summary-takeaways";
     clusterId?: number | null | undefined;
     clusterTitle?: string | null | undefined;
     lessonPhase?: string | null | undefined;
@@ -1373,7 +1447,7 @@ declare const HybridBlueprintItemSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     title: string;
     slideIndex: number;
-    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    layoutId: "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "tiered-practice-3cards" | "summary-takeaways";
     pedagogicalGoal: string | null;
     contentFocus: string[] | null;
     clusterId?: number | null | undefined;
@@ -1384,7 +1458,7 @@ declare const HybridBlueprintItemSchema: z.ZodObject<{
 }, {
     title: string;
     slideIndex: number;
-    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    layoutId: "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "tiered-practice-3cards" | "summary-takeaways";
     clusterId?: number | null | undefined;
     clusterTitle?: string | null | undefined;
     lessonPhase?: string | null | undefined;
@@ -1407,7 +1481,7 @@ declare const HybridBlueprintArraySchema: z.ZodArray<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     title: string;
     slideIndex: number;
-    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    layoutId: "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "tiered-practice-3cards" | "summary-takeaways";
     pedagogicalGoal: string | null;
     contentFocus: string[] | null;
     clusterId?: number | null | undefined;
@@ -1418,7 +1492,7 @@ declare const HybridBlueprintArraySchema: z.ZodArray<z.ZodObject<{
 }, {
     title: string;
     slideIndex: number;
-    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    layoutId: "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "tiered-practice-3cards" | "summary-takeaways";
     clusterId?: number | null | undefined;
     clusterTitle?: string | null | undefined;
     lessonPhase?: string | null | undefined;
@@ -1730,48 +1804,6 @@ declare const ACT_TEMPLATE: string;
  */
 declare const CODE_LAB_TEMPLATE: string;
 
-/**
- * Markdown Template for Student Handout (5-Second Rule Cheat Sheet)
- * 100% English Template Structure (Ported from /Users/tonypham/MEGA/ai-platform/my-mcp/_templates/HANDOUT_template.md)
- */
-declare const HANDOUT_TEMPLATE: string;
-
-/**
- * Markdown Template for Presentation Slides Deck (SLIDE)
- * Powered by Marp — Built on Chunky Micro-Cycle Learning (Learn-Apply-Validate Loops)
- */
-declare const SLIDE_TEMPLATE: string;
-
-/**
- * Markdown Template for Student Worksheet (WKS)
- * 100% English Template Structure (Ported from /Users/tonypham/MEGA/ai-platform/my-mcp/_templates/WKS_template.md)
- */
-declare const WORKSHEET_TEMPLATE: string;
-
-/**
- * Markdown Template for Instructable-style Project Tutorial
- * 100% English Template Structure (Ported from researcher/prompts/tutorial.md & my-mcp)
- */
-declare const PROJECT_INSTRUCTION_TEMPLATE: string;
-
-/**
- * Markdown Template for Assessment Rubric (RUBRIC)
- * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/RUBRIC_template.md
- */
-declare const RUBRIC_TEMPLATE: string;
-
-/**
- * Markdown Template for Teacher Guide (GUIDE)
- * Exact Canonical Template from the-ultimate-curriculum-agent-os/_templates/GUIDE_template.md
- */
-declare const TEACHER_GUIDE_TEMPLATE: string;
-
-/**
- * Markdown Template for Self-Paced Hands-on Lab (SELF_LAB)
- * Features Progressive Hints System (Accordion/Spoilers) & Automated Verification Commands
- */
-declare const SELF_LAB_TEMPLATE: string;
-
 /**
  * Markdown Template for Diagnostic & Active Recall Quiz (QUIZ)
  * Compatible with @thanh01.pmt/interactive-quiz-kit standard
@@ -1779,95 +1811,9 @@ declare const SELF_LAB_TEMPLATE: string;
 declare const QUIZ_TEMPLATE: string;
 
 /**
- * Markdown Template for Extension Challenge (EXT)
- */
-declare const EXT_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"EXT\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T8\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Target Mastery & Acceleration\"\n  - \"Challenge 1\"\n  - \"Challenge 2\"\n  - \"Verification Criteria\"\n---\n<!-- INJECT_BODY -->\n\n# EXTENSION CHALLENGES: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}}_\n\n## [REQUIRED] Target Mastery & Acceleration\n> *Designed for advanced learners who have successfully completed the core lesson requirements ahead of schedule.*\n\n---\n\n## [REQUIRED] Challenge 1: {{CHALLENGE_1_TITLE}} (Difficulty: \u2B50\u2B50\u2B50)\n- **Problem Statement:** {{CHALLENGE_1_DESCRIPTION}}\n- **Architectural Clues & Hints:**\n{{CHALLENGE_1_HINTS}}\n- **Expected Outcome & Deliverable:** {{CHALLENGE_1_OUTCOME}}\n\n---\n\n## [REQUIRED] Challenge 2: {{CHALLENGE_2_TITLE}} (Difficulty: \u2B50\u2B50\u2B50\u2B50)\n- **Problem Statement:** {{CHALLENGE_2_DESCRIPTION}}\n- **Architectural Clues & Hints:**\n{{CHALLENGE_2_HINTS}}\n- **Expected Outcome & Deliverable:** {{CHALLENGE_2_OUTCOME}}\n\n---\n\n## [REQUIRED] Verification Criteria\n- [ ] Code passes all extended unit tests.\n- [ ] No regression introduced into core components.\n- [ ] Demonstrates high-order optimization or architectural separation.\n";
-
-/**
- * Markdown Template for Technical Glossary (GLOSSARY)
- */
-declare const GLOSSARY_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"GLOSSARY\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T9\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Core Technical Terminology\"\n  - \"Conceptual Analogies & Non-examples\"\n  - \"Cross-Technology Crosswalk\"\n---\n<!-- INJECT_BODY -->\n\n# TECHNICAL GLOSSARY & VOCABULARY: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Reference Standard: CS2023_\n\n## [REQUIRED] Core Technical Terminology\n\n| Term / Keyword | Formal Engineering Definition | Code Usage Context | Common Misconception |\n| :--- | :--- | :--- | :--- |\n{{GLOSSARY_TABLE_ROWS}}\n\n---\n\n## [REQUIRED] Conceptual Analogies & Non-examples\n\n{{ANALOGY_SECTIONS}}\n\n---\n\n## [REQUIRED] Cross-Technology Crosswalk (Neutral vs. Specific)\n\n| Universal Concept (Marr Level 1/2) | Target Language Syntax (Level 3) | Alternative Language Equivalent |\n| :--- | :--- | :--- |\n{{CROSSWALK_ROWS}}\n";
-/**
- * Markdown Template for Bill of Materials (BOM)
- */
-declare const BOM_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"BOM\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T6\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Hardware & Sensor Specification\"\n  - \"Software & Environment Invariants\"\n  - \"Procurement & Safety Requirements\"\n---\n<!-- INJECT_BODY -->\n\n# BILL OF MATERIALS & LAB PREREQUISITES: {{TITLE}}\n_Unit: {{UNIT_ID}} | Target Class Size: {{CLASS_SIZE}} Students_\n\n## [REQUIRED] Hardware & Sensor Specification\n\n| Item Code | Component Name | Required Qty per Student/Group | Min Spec / Pinout | Alternative Substitute |\n| :--- | :--- | :--- | :--- | :--- |\n{{HARDWARE_BOM_ROWS}}\n\n---\n\n## [REQUIRED] Software & Environment Invariants\n\n| Tool / Runtime | Required Version | Licensing / Cost | Fallback Offline Mode |\n| :--- | :--- | :--- | :--- |\n{{SOFTWARE_BOM_ROWS}}\n\n---\n\n## [REQUIRED] Procurement & Safety Requirements\n- \u26A0\uFE0F **Voltage & Current Constraints:** {{POWER_CONSTRAINTS}}\n- \uD83D\uDD12 **API Quota & Rate Limits:** {{API_LIMITS}}\n";
-
-/**
- * Markdown Template for Formative Exit Ticket (EXIT_TICKET)
- */
-declare const EXIT_TICKET_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"EXIT_TICKET\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T10\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Target Learning Objectives\"\n  - \"Recall & Conceptual Anchor\"\n  - \"Application & Bug Hunt\"\n  - \"Metacognitive Reflection & Confidence Check\"\n  - \"Scoring & Teacher Intervention Trigger\"\n---\n<!-- INJECT_BODY -->\n\n# FORMATIVE EXIT TICKET: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}} | Estimated Time: 5-7 mins_\n\n## [REQUIRED] Target Learning Objectives\n- **Target LO 1 (ULO):** {{TARGET_LO_1}}\n- **Target LO 2 (CIO/SIO):** {{TARGET_LO_2}}\n\n---\n\n## [REQUIRED] Part 1: Recall & Conceptual Anchor (Prompt 1)\n> *Objective: Test core mental model without allowing rote syntax memorization.*\n\n**Question 1:**  \n{{CONCEPTUAL_QUESTION}}\n\n- **Student Answer Area:**  \n  ```text\n  [Write 1-2 concise sentences explaining the difference in runtime mechanism]\n  ```\n\n---\n\n## [REQUIRED] Part 2: Application & Bug Hunt (Prompt 2)\n> *Objective: Test code diagnosis and precise correction in \u2264 3 lines of modification.*\n\n**Code Snippet:**  \n```{{CODE_LANGUAGE}}\n{{BUGGY_CODE_SNIPPET}}\n```\n\n**Task:**  \n1. **Identify the Compiler/Runtime Error:** {{BUG_SYMPTOM_HINT}}\n2. **Corrected Line:**  \n   ```{{CODE_LANGUAGE}}\n   {{CORRECTED_CODE_SLOT}}\n   ```\n\n---\n\n## [REQUIRED] Part 3: Metacognitive Reflection & Confidence Check (Prompt 3)\n> *Objective: Empower student self-regulation and provide immediate diagnostic signals.*\n\n**Traffic Light Self-Assessment:**  \n- [ ] \uD83D\uDFE2 **Green (Mastered):** \"I can build and explain this concept to a peer without any hints.\"\n- [ ] \uD83D\uDFE1 **Yellow (Needs Practice):** \"I understand the concept but got stuck on syntax or error messages.\"\n- [ ] \uD83D\uDD34 **Red (Blocked):** \"I need help understanding why this architecture is used.\"\n\n**One Lingering Question (Exit Ticket Note):**  \n```text\n[What is one question you still have before leaving today's lab?]\n```\n\n---\n\n## [REQUIRED] Scoring & Teacher Intervention Trigger\n- **Proficiency Threshold:** Green/Yellow check + Correct Answer to Part 2 Bug Hunt.\n- **Intervention Protocol:** {{INTERVENTION_PROTOCOL}}\n";
-
-/**
- * Markdown Template for 3-Tier Differentiated Practice (TIERED_PRACTICE)
- */
-declare const TIERED_PRACTICE_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"TIERED_PRACTICE\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T11\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Computational Objective & Tier Matrix\"\n  - \"Bronze Tier (Foundational Scaffolding)\"\n  - \"Silver Tier (Independent Application)\"\n  - \"Gold Tier (Enrichment & Optimization)\"\n  - \"Automated Test Verification Matrix\"\n  - \"Answer Key & Mentor Hints\"\n---\n<!-- INJECT_BODY -->\n\n# 3-TIER DIFFERENTIATED PRACTICE LAB: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Lesson: {{LESSON_ID}} | Mode: Adaptive Lab_\n\n## [REQUIRED] Computational Objective & Tier Matrix\n\n| Tier Level | Cognitive Target (Bloom) | Scaffolding Ratio | Success Criteria |\n| :--- | :--- | :--- | :--- |\n| \uD83E\uDD49 **Bronze** | Remember / Understand | **70% Starter Code / 30% Fill-in** | Complete basic syntax & pass Baseline Unit Test. |\n| \uD83E\uDD48 **Silver** | Apply / Analyze | **30% Starter Code / 70% Implementation** | Implement business logic, edge-case handling & multi-component binding. |\n| \uD83E\uDD47 **Gold** | Evaluate / Create | **0% Code / Open Architecture** | Optimize performance, refactor with concurrency/state isolation & self-author tests. |\n\n---\n\n## [REQUIRED] \uD83E\uDD49 Bronze Tier: Foundational Scaffolding (Baseline for All)\n- **Target Audience:** All learners (mandatory milestone).\n- **Guiding Prompt:** {{BRONZE_PROMPT}}\n\n### Starter Code & Fill-in Slots:\n```{{CODE_LANGUAGE}}\n{{BRONZE_STARTER_CODE}}\n```\n\n- **Verification Check:** Run test `testBronzeBaseline()` \u2014 Expect status `PASS`.\n\n---\n\n## [REQUIRED] \uD83E\uDD48 Silver Tier: Independent Application (Target Mastery)\n- **Target Audience:** Learners who completed Bronze without mentor intervention.\n- **Guiding Prompt:** {{SILVER_PROMPT}}\n\n### Specification & Requirements:\n{{SILVER_SPECIFICATIONS}}\n\n### Implementation Target:\n```{{CODE_LANGUAGE}}\n{{SILVER_IMPLEMENTATION_SLOT}}\n```\n\n- **Verification Check:** Run test `testSilverLogicAndValidation()` \u2014 Expect status `PASS`.\n\n---\n\n## [REQUIRED] \uD83E\uDD47 Gold Tier: Enrichment & Optimization (Open Extension)\n- **Target Audience:** Advanced learners finished ahead of schedule.\n- **Architectural Challenge:** {{GOLD_CHALLENGE}}\n\n### Constraints & Invariants:\n{{GOLD_CONSTRAINTS}}\n\n---\n\n## [REQUIRED] Automated Test Verification Matrix & Mentor Hints\n```{{CODE_LANGUAGE}}\n{{TEST_HARNESS_CODE}}\n```\n\n### Mentor Debugging Cheatsheet:\n{{MENTOR_DEBUG_CHEATSHEET}}\n";
-/**
- * Markdown Template for 9-Square Choice Board (CHOICE_BOARD)
- */
-declare const CHOICE_BOARD_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"CHOICE_BOARD\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T12\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Learning Goals & Rule of Choice\"\n  - \"The 9-Square Activity Matrix\"\n  - \"Activity Detailed Blueprints\"\n  - \"Universal Assessment Rubric\"\n---\n<!-- INJECT_BODY -->\n\n# 9-SQUARE CHOICE BOARD: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Target Competency: {{CORE_COMPETENCY}}_\n\n## [REQUIRED] Learning Goals & Rule of Choice\n- **Core Concept Anchor:** {{CORE_CONCEPT_ANCHOR}}\n- **Rule of Choice (Tic-Tac-Toe / Point Model):**\n  - *Option A (Tic-Tac-Toe):* Complete 3 activities in a row (Horizontal, Vertical, or Diagonal).\n  - *Option B (Point Balance):* Reach $\\ge 100\\text{ pts}$ (Choose $\\ge 1$ Technical Lab + $\\ge 1$ Explanatory/Visual + $\\ge 1$ Creative Challenge).\n\n---\n\n## [REQUIRED] The 9-Square Activity Matrix\n\n| Column 1: Analytical & Code | Column 2: Visual & Architecture | Column 3: Creative & Applied |\n| :--- | :--- | :--- |\n| **Square 1: {{SQ1_TITLE}} ({{SQ1_PTS}} pts)**<br>{{SQ1_DESC}} | **Square 2: {{SQ2_TITLE}} ({{SQ2_PTS}} pts)**<br>{{SQ2_DESC}} | **Square 3: {{SQ3_TITLE}} ({{SQ3_PTS}} pts)**<br>{{SQ3_DESC}} |\n| **Square 4: {{SQ4_TITLE}} ({{SQ4_PTS}} pts)**<br>{{SQ4_DESC}} | **\u2B50 Square 5: {{SQ5_TITLE}} ({{SQ5_PTS}} pts)**<br>{{SQ5_DESC}} | **Square 6: {{SQ6_TITLE}} ({{SQ6_PTS}} pts)**<br>{{SQ6_DESC}} |\n| **Square 7: {{SQ7_TITLE}} ({{SQ7_PTS}} pts)**<br>{{SQ7_DESC}} | **Square 8: {{SQ8_TITLE}} ({{SQ8_PTS}} pts)**<br>{{SQ8_DESC}} | **Square 9: {{SQ9_TITLE}} ({{SQ9_PTS}} pts)**<br>{{SQ9_DESC}} |\n\n---\n\n## [REQUIRED] Activity Detailed Blueprints\n\n### Detail: Square 1 \u2014 {{SQ1_TITLE}}\n{{SQ1_BLUEPRINT}}\n\n### Detail: Square 2 \u2014 {{SQ2_TITLE}}\n{{SQ2_BLUEPRINT}}\n\n### Detail: \u2B50 Square 5 \u2014 {{SQ5_TITLE}} (Mandatory Center Option)\n{{SQ5_BLUEPRINT}}\n\n---\n\n## [REQUIRED] Universal Assessment Rubric\n| Criteria | Exemplary (4) | Proficient (3) | Developing (2) | Beginning (1) |\n| :--- | :--- | :--- | :--- | :--- |\n| **Technical Accuracy** | 100% executable, idiomatic syntax, zero race conditions. | Compiles and runs; minor non-critical styling issue. | Runs with partial errors or missing edge cases. | Does not compile or contains critical syntax bugs. |\n| **Conceptual Clarity** | Explains architectural trade-offs using rigorous engineering terms. | Explains the \"how\" accurately with basic rationale. | Description is vague or confuses terminology. | Cannot explain how code works. |\n| **Creativity & Autonomy** | Goes beyond specifications with thoughtful UX or performance optimizations. | Fulfills all specified criteria independently. | Needs significant scaffolding hints to complete. | Incomplete submission. |\n";
-
-/**
- * Markdown Template for Science / Code Lab with CER Framework (SCIENCE_LAB)
- */
-declare const SCIENCE_LAB_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"SCIENCE_LAB\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T13\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Guiding Inquiry & Driving Question\"\n  - \"Hypothesis & Experimental Design\"\n  - \"Data Collection & Code Lab Protocol\"\n  - \"CER Scientific Conclusion (Claim, Evidence, Reasoning)\"\n  - \"Peer Review & Verification Protocol\"\n---\n<!-- INJECT_BODY -->\n\n# STEM / CODE INVESTIGATION LAB (CER): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Domain: {{DOMAIN_NAME}}_\n\n## [REQUIRED] Guiding Inquiry & Driving Question\n- **Real-World Driving Question:** {{DRIVING_QUESTION}}\n- **Engineering Phenomenon:** {{ENGINEERING_PHENOMENON}}\n\n---\n\n## [REQUIRED] Hypothesis & Experimental Design\n- **Student Hypothesis Template:**  \n  > *\"If we [Action / Variable Manipulation], then [Predicted Outcome] because [Scientific / Engineering Rationale].\"*\n\n### Controlled Variables:\n- **Independent Variable (Manipulated):** {{INDEPENDENT_VARIABLE}}\n- **Dependent Variable (Measured):** {{DEPENDENT_VARIABLE}}\n- **Control Variables (Constant):** {{CONTROL_VARIABLES}}\n\n---\n\n## [REQUIRED] Data Collection & Code Lab Protocol\n\n### Lab Setup & Instrumentation Code:\n```{{CODE_LANGUAGE}}\n{{BENCHMARK_PROBE_CODE}}\n```\n\n### Data Collection Table:\n| Trial | Variable State | Memory (MB) | Latency (ms) | Error / Anomaly Count |\n| :---: | :--- | :---: | :---: | :---: |\n{{DATA_COLLECTION_ROWS}}\n\n---\n\n## [REQUIRED] CER Scientific Conclusion (Claim, Evidence, Reasoning)\n\n### 1. \uD83D\uDCCC Claim (Kh\u1EB3ng \u0111\u1ECBnh):\n- *Direct answer to the driving question in 1 concise sentence:*  \n  ```text\n  [State clear conclusion based on data]\n  ```\n\n### 2. \uD83D\uDCCA Evidence (B\u1EB1ng ch\u1EE9ng s\u1ED1 li\u1EC7u):\n- *Specific quantitative data points cited directly from the Data Collection Table:*  \n  ```text\n  [Cite concrete numerical metrics and trials]\n  ```\n\n### 3. \uD83E\uDDE0 Reasoning (L\u1EADp lu\u1EADn khoa h\u1ECDc):\n- *Connect the evidence back to the underlying technical principle:*  \n  ```text\n  [Explain why the runtime/hardware behaved this way]\n  ```\n\n---\n\n## [REQUIRED] Peer Review & Verification Protocol\n- **Reproducibility Test:** Exchange code probes with another group to verify if results match within $\\pm 10\\%$ tolerance.\n";
-/**
- * Markdown Template for Printable Task Cards Pack (TASK_CARDS)
- */
-declare const TASK_CARDS_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"TASK_CARDS\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T14\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Deck Overview & Print Instructions\"\n  - \"Task Cards 1 to 4 (Foundational Concepts)\"\n  - \"Task Cards 5 to 8 (Code Diagnosis & Debugging)\"\n  - \"Task Cards 9 to 12 (Application & Synthesis)\"\n  - \"Teacher Answer Key & Scoring Matrix\"\n---\n<!-- INJECT_BODY -->\n\n# PRINTABLE TASK CARDS PACK: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Total Cards: {{CARD_COUNT}} Cards_\n\n## [REQUIRED] Deck Overview & Print Instructions\n- **Card Format:** 4 cards per page (A4 layout with cutting guidelines and QR code link).\n- **Target Skills:** Conceptual Understanding, Code Tracing, Bug Hunting, Architectural Reasoning.\n- **Scoring System:** Bronze Cards (1 pt), Silver Cards (2 pts), Gold Cards (3 pts).\n\n---\n\n## [REQUIRED] Set A: Foundational Concepts (Cards 1\u20134)\n{{TASK_CARDS_SET_A}}\n\n---\n\n## [REQUIRED] Set B: Code Diagnosis & Debugging (Cards 5\u20138)\n{{TASK_CARDS_SET_B}}\n\n---\n\n## [REQUIRED] Set C: Application & Synthesis (Cards 9\u201312)\n{{TASK_CARDS_SET_C}}\n\n---\n\n## [REQUIRED] Teacher Answer Key & Scoring Matrix\n| Card ID | Correct Answer / Solution Blueprint | Max Points |\n| :---: | :--- | :---: |\n{{TASK_CARDS_ANSWER_ROWS}}\n";
-
-/**
- * Markdown Template for Station Rotation Blended Lessons (STATION_ROTATION)
- */
-declare const STATION_ROTATION_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"STATION_ROTATION\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T15\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Station Architecture & Timer Overview\"\n  - \"Station 1: Teacher-Led Small Group (Deep Dive)\"\n  - \"Station 2: Collaborative Hands-On Lab (Peer Pair)\"\n  - \"Station 3: Independent Digital Practice (Async Code)\"\n  - \"Station 4: Offline Modeling & Architecture (Whiteboard)\"\n  - \"Station Recording Sheet & Rotation Bell Protocol\"\n---\n<!-- INJECT_BODY -->\n\n# STATION ROTATION LESSON PACK: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: 4 Stations x 15 Mins_\n\n## [REQUIRED] Station Architecture & Timer Overview\n- **Classroom Layout:** 4 designated physical zones with clear signage and materials.\n- **Rotation Time:** 15 minutes per station + 2 minutes clean transition buffer.\n- **Audience Grouping:** Heterogeneous groups of 4-6 students rotating simultaneously.\n\n---\n\n## [REQUIRED] Station 1: Teacher-Led Small Group (Guided Inquiry)\n- **Goal:** Direct coaching, conceptual check, and resolving misconceptions in real-time.\n- **Teacher Script & Inquiry Questions:**\n{{STATION_1_GUIDANCE}}\n\n---\n\n## [REQUIRED] Station 2: Collaborative Hands-On Lab (Pair Programming)\n- **Goal:** Students work in pairs (Driver / Navigator) to solve a 2-stage challenge.\n- **Task Materials:** {{STATION_2_MATERIALS}}\n- **Success Milestone:** {{STATION_2_MILESTONE}}\n\n---\n\n## [REQUIRED] Station 3: Independent Digital Practice (Self-Paced Code Lab)\n- **Goal:** Autonomy and individual mastery verification.\n- **Student Instructions:**\n{{STATION_3_INSTRUCTIONS}}\n\n---\n\n## [REQUIRED] Station 4: Offline Modeling & Architecture (No Screens)\n- **Goal:** Cognitive unloading and physical spatial reasoning.\n- **Materials:** Whiteboard markers, physical Task Cards deck, and laminated architecture templates.\n- **Task:** {{STATION_4_TASK}}\n\n---\n\n## [REQUIRED] Station Recording Sheet (Student Passport)\n| Station | Task Completed | Signature / Verification Stamp | 1 Key Insight Learned |\n| :---: | :--- | :--- | :--- |\n| **1 (Teacher)** | Debugging Probe Discussion | [Teacher Stamp] | |\n| **2 (Pair Lab)** | Stage 1 & 2 Test Suite | [Peer Signature] | |\n| **3 (Digital)** | Micro-Challenges Token | [Auto Token] | |\n| **4 (Offline)** | Flowchart Diagram Approved | [Mentor Stamp] | |\n";
-/**
- * Markdown Template for Weekly Bell Ringers (BELL_RINGER)
- */
-declare const BELL_RINGER_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"BELL_RINGER\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T16\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Weekly Objective & Schedule\"\n  - \"Monday: Mental Model Recall\"\n  - \"Tuesday: Code Spot-Check\"\n  - \"Wednesday: Bug Hunt & Fix\"\n  - \"Thursday: Architecture Tracing\"\n  - \"Friday: Creative Synthesis & Bridge\"\n  - \"Answer Key & Scoring Guide\"\n---\n<!-- INJECT_BODY -->\n\n# WEEKLY BELL RINGERS (5-DAY WARM-UP PACK): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Time: 3-5 Mins per Session_\n\n## [REQUIRED] Weekly Objective & Schedule\n- **Weekly Core Theme:** {{WEEKLY_THEME}}\n- **Routine Protocol:** Display prompt on projector immediately as students enter.\n\n---\n\n## [REQUIRED] Day 1 (Monday): Mental Model Recall & Analogy\n{{DAY_1_PROMPT}}\n\n---\n\n## [REQUIRED] Day 2 (Tuesday): Rapid Code Tracing\n{{DAY_2_PROMPT}}\n\n---\n\n## [REQUIRED] Day 3 (Wednesday): Quick Bug Hunt (Spot the Defect)\n{{DAY_3_PROMPT}}\n\n---\n\n## [REQUIRED] Day 4 (Thursday): Visual Diagram Tracing\n{{DAY_4_PROMPT}}\n\n---\n\n## [REQUIRED] Day 5 (Friday): Creative Synthesis & Bridge Forward\n{{DAY_5_PROMPT}}\n\n---\n\n## [REQUIRED] Teacher Answer Key & Scoring Guide\n{{TEACHER_ANSWER_KEY}}\n";
-/**
- * Markdown Template for Interactive Review Game (REVIEW_GAME)
- */
-declare const REVIEW_GAME_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"REVIEW_GAME\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T17\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Game Rules & Setup Guide\"\n  - \"Round 1: Speed Round (100-200 Pts)\"\n  - \"Round 2: Code Duel & Debugging (300-400 Pts)\"\n  - \"Round 3: Final Boss Architecture Challenge (500 Pts)\"\n  - \"Kahoot / Quizizz CSV Export Format\"\n---\n<!-- INJECT_BODY -->\n\n# INTERACTIVE REVIEW GAME (QUIZ SHOW PACK): {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Live Classroom Quiz Show_\n\n## [REQUIRED] Game Rules & Setup Guide\n- **Format:** 3 Rounds of progressive difficulty with team buzzers.\n- **Team Size:** 3-5 students per squad.\n\n---\n\n## [REQUIRED] Round 1: Rapid-Fire Speed Round (100\u2013200 Points)\n{{ROUND_1_QUESTIONS}}\n\n---\n\n## [REQUIRED] Round 2: Code Duel & Debugging (300\u2013400 Points)\n{{ROUND_2_CHALLENGES}}\n\n---\n\n## [REQUIRED] Round 3: Final Boss Architecture Challenge (500 Points)\n{{ROUND_3_BOSS_CHALLENGE}}\n\n---\n\n## [REQUIRED] Kahoot / Quizizz CSV Export Format\n```csv\n{{KAHOOT_CSV_CONTENT}}\n```\n";
-/**
- * Markdown Template for Visual Graphic Organizers (GRAPHIC_ORGANIZER)
- */
-declare const GRAPHIC_ORGANIZER_TEMPLATE = "---\nid: \"{{ID}}\"\ntitle: \"{{TITLE}}\"\ntype: \"GRAPHIC_ORGANIZER\"\ncreated_by: \"Curriculum OS Builder\"\nphase: \"{{PHASE}}\"\ndeliverable: \"P3-T18\"\nversion: \"{{VERSION}}\"\ndate: \"{{DATE}}\"\ntemplate_contract: \"artifact-template-v1\"\ntemplate_required_sections:\n  - \"Visual Paradigm Overview\"\n  - \"Organizer 1: Architectural Data Flow (Mermaid Flowchart)\"\n  - \"Organizer 2: Comparative Analysis (Mermaid / Markdown Venn)\"\n  - \"Organizer 3: State Machine & Lifecycle (Mermaid StateDiagram)\"\n  - \"Student Fill-in Worksheet Format\"\n---\n<!-- INJECT_BODY -->\n\n# VISUAL GRAPHIC ORGANIZERS: {{TITLE}}\n_Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Mermaid Diagrams + Printable Handouts_\n\n## [REQUIRED] Visual Paradigm Overview\n- **Cognitive Purpose:** Unload mental processing burden through spatial diagramming.\n\n---\n\n## [REQUIRED] Organizer 1: Architectural Data Flow (Mermaid Flowchart)\n```mermaid\n{{MERMAID_FLOWCHART}}\n```\n\n---\n\n## [REQUIRED] Organizer 2: Comparative Analysis (Venn Diagram / Matrix)\n```mermaid\n{{MERMAID_VENN_OR_MATRIX}}\n```\n\n---\n\n## [REQUIRED] Organizer 3: State Machine & Lifecycle (State Diagram)\n```mermaid\n{{MERMAID_STATE_DIAGRAM}}\n```\n\n---\n\n## [REQUIRED] Student Fill-in Worksheet Format (Offline Handout)\n{{OFFLINE_WORKSHEET_FORMAT}}\n";
-
-/**
- * @learnwell/curriculum-kit — Slide Layout Presets & Single-Page Slide Templates
- *
- * Reusable catalog of production-ready single slide templates with Marp YAML layout comments,
- * presenter notes, and pedagogical structures for curriculum authoring & LLM generation.
- * All content, templates, and examples are strictly authored in English.
- */
-type SlideLayoutCategory = 'cover' | 'content' | 'split' | 'code' | 'metrics' | 'diagram' | 'quote' | 'assessment';
-interface LayoutBoxConfig {
-    id: string;
-    target?: string;
-    pos: [number, number, number, number];
-    fontSize?: string;
-    color?: string;
-    textAlign?: 'left' | 'center' | 'right' | 'justify';
-    style?: string;
-}
-interface SlideLayoutData {
-    boxes: LayoutBoxConfig[];
-}
-interface SlideLayoutPreset {
-    id: string;
-    name: string;
-    category: SlideLayoutCategory;
-    description: string;
-    layout: SlideLayoutData;
-    markdownSnippet: string;
-}
-declare const SLIDE_LAYOUT_PRESETS: SlideLayoutPreset[];
-/**
- * Find a preset by its unique ID
- */
-declare function getSlideLayoutPresetById(id: string): SlideLayoutPreset | undefined;
-/**
- * Filter presets by category
+ * Markdown Template for Self-Paced Hands-on Lab (SELF_LAB)
+ * Features Progressive Hints System (Accordion/Spoilers) & Automated Verification Commands
  */
-declare function getSlideLayoutPresetsByCategory(category: SlideLayoutCategory): SlideLayoutPreset[];
+declare const SELF_LAB_TEMPLATE: string;
 
-export { ACT_TEMPLATE, AIProviderName, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, type ActivityAlignmentResult, ActivityLab, ActivitySeqRow, type ArtifactDependencyRule, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, ChunkType, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConceptPrerequisiteEdge, ConceptSpiralEncounter, ConstructiveAlignmentEvaluator, type ContextInjectionMeta, type ContextRoutingMode, type ContextSourceKey, CoverageGateReport, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_OVERHEAD_RATIO, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DEFAULT_VIETNAMESE_SECTION_HEADINGS, DependencyEdge, type DependencyValidationResult, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, ENVIRONMENT_PROVISIONING_MODELS, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type EnvironmentProvisioningModel, type ExcerptOptions, type ExcerptResult, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type ExtractedJson, type ExtractedStreamChunk, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, GeneratedSlideArraySchema, GeneratedSlideSchema, HANDOUT_TEMPLATE, HybridBlueprintArraySchema, HybridBlueprintItemSchema, HybridDeckSlideArraySchema, HybridDeckSlideSchema, HybridPipelineError, ICurriculumStorage, JUDGE_AUTO_APPROVE_THRESHOLD, JUDGE_ESCALATE_THRESHOLD, LAYER_IDLE_BUDGET_MS, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, type LessonEntity, LessonEntitySchema, LessonPlan, MAX_AUTONOMOUS_REPAIR_TURNS, MAX_IN_SESSION_SETUP_MINUTES, MAX_NEW_CONCEPTS_PER_SESSION_ADULT, MAX_NEW_CONCEPTS_PER_SESSION_K12, MasteryGate, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PrefillProviderEvent, type PreliminaryResearchResult, PrerequisiteDecision, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SATELLITE_LESSON_PRIORITIES, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, STUDENT_FRICTION_MULTIPLIER, type SatContextResult, type SatelliteContextInput, SessionZpdStatus, type SlashCommandDefinition, SlideBlueprintArraySchema, SlideBlueprintItemSchema, SlideDeck, type SlideEngine, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, type SlideProductionWorkflowOptions, type SlideProductionWorkflowResult, SmartResumeContext, type StreamAbortHandle, type StreamBudget, type StreamChunkExtractor, StreamRunnerOptions, type SymbolLedgerResult, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, UnitPlan, type ValidationOptions, WORKSHEET_TEMPLATE, WalkingSkeleton, analyzeProjectCreationIntent, assertAcyclic, assignDepths, auditQualityReport, buildConceptPrerequisites, buildCurriculumContext, buildCurriculumPlan, buildDomainLexiconGuardrail, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonEntityJson, buildLessonExcerpt, buildMasteryGates, buildSatelliteContext, buildSectionAwareExcerpt, buildSessionSliceContext, buildWalkingSkeleton, checkSessionZpd, closeTruncatedJson, computeConceptSpiralProgression, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, dropCyclicConceptEdges, emitUsage, ensureExpositionForLesson, ensureKnowledgeExposition, entityRowAssignedTo, evaluateActivityAlignment, executeCurriculumCommand, executeSlideProductionWorkflow, expositionCacheKey, extractActivityContractRows, extractAssessmentMap, extractJsonArray, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStreamChunk, extractSymbolLedger, extractTieredScaffoldingBlock, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isActivityAlignmentLogOnly, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, normalizeSlcContract, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderAssignedRowsTable, renderEntitySlotsForType, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort, validateArtifactDependencies, validateHybridDeckSlides };
+export { ACT_TEMPLATE, AIProviderName, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, type ActivityAlignmentResult, ActivityLab, ActivitySeqRow, type ArtifactDependencyRule, type ArtifactProductionSpec, type ArtifactPromptParts, type AuditBundleInput, BLOOM_ACTION_VERBS, BloomTaxonomyEvaluator, type BuildContextOptions, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, ChunkType, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConceptPrerequisiteEdge, ConceptSpiralEncounter, ConstructiveAlignmentEvaluator, type ContextInjectionMeta, type ContextRoutingMode, type ContextSourceKey, CoverageGateReport, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_OVERHEAD_RATIO, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DEFAULT_VIETNAMESE_SECTION_HEADINGS, DependencyEdge, type DependencyValidationResult, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, ENVIRONMENT_PROVISIONING_MODELS, EXPOSITION_REL, type EnvironmentProvisioningModel, type ExcerptOptions, type ExcerptResult, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type ExtractedJson, type ExtractedStreamChunk, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, type GenerateExpositionOptions, GeneratedSlideArraySchema, GeneratedSlideSchema, HybridBlueprintArraySchema, HybridBlueprintItemSchema, HybridDeckSlideArraySchema, HybridDeckSlideSchema, HybridPipelineError, ICurriculumStorage, JUDGE_AUTO_APPROVE_THRESHOLD, JUDGE_ESCALATE_THRESHOLD, LAYER_IDLE_BUDGET_MS, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LessonEntity, LessonEntitySchema, LessonPlan, MAX_AUTONOMOUS_REPAIR_TURNS, MAX_IN_SESSION_SETUP_MINUTES, MAX_NEW_CONCEPTS_PER_SESSION_ADULT, MAX_NEW_CONCEPTS_PER_SESSION_K12, MasteryGate, MisconceptionEvaluator, ModelResolutionOptions, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PrefillProviderEvent, type PreliminaryResearchResult, PrerequisiteDecision, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, ResolvedGateSettings, type ResolvedTemplate, SATELLITE_LESSON_PRIORITIES, SELF_LAB_TEMPLATE, STUDENT_FRICTION_MULTIPLIER, type SatContextResult, type SatelliteContextInput, SessionZpdStatus, type SlashCommandDefinition, SlideBlueprintArraySchema, SlideBlueprintItemSchema, SlideDeck, type SlideEngine, type SlideProductionWorkflowOptions, type SlideProductionWorkflowResult, SmartResumeContext, type StreamAbortHandle, type StreamBudget, type StreamChunkExtractor, StreamRunnerOptions, type SymbolLedgerResult, TranslationPolicy, type TranslationTarget, type TranslationTrigger, UnitPlan, type ValidationOptions, WalkingSkeleton, analyzeProjectCreationIntent, assertAcyclic, assignDepths, auditQualityReport, buildArtifactPrompt, buildConceptPrerequisites, buildCurriculumContext, buildCurriculumPlan, buildDomainLexiconGuardrail, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonEntityJson, buildLessonExcerpt, buildMasteryGates, buildSatelliteContext, buildSectionAwareExcerpt, buildSessionSliceContext, buildWalkingSkeleton, checkSessionZpd, closeTruncatedJson, computeConceptSpiralProgression, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, dropCyclicConceptEdges, emitUsage, ensureExpositionForLesson, ensureKnowledgeExposition, entityRowAssignedTo, evaluateActivityAlignment, executeCurriculumCommand, executeSlideProductionWorkflow, expositionCacheKey, extractActivityContractRows, extractAssessmentMap, extractBodySections, extractJsonArray, extractRequiredSections, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStreamChunk, extractSymbolLedger, extractTieredScaffoldingBlock, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isActivityAlignmentLogOnly, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, normalizeSlcContract, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderAssignedRowsTable, renderEntitySlotsForType, renderFrameworkFromPlan, resolveArtifactTemplate, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, stripTemplateFrontmatter, targetLanguageDisplayName, topoSort, validateArtifactDependencies, validateHybridDeckSlides };