@thanh01.pmt/curriculum-kit 1.4.8 → 1.4.10

package/dist/index.d.cts

@@ -365,6 +365,8 @@ interface LayerPrefillOptions {
     timeoutMs?: number;
     /** Idle (no-data) budget override for this prefill run (ms). */
     idleTimeoutMs?: number;
+    /** Optional parent abort signal (e.g. from HTTP request) to stop immediately on client disconnect. */
+    signal?: AbortSignal;
 }
 interface PreliminaryResearchResult {
     groundTruthSummary: string;
@@ -388,7 +390,7 @@ interface StreamBudget {
     /** Abort when the whole stream exceeds this total wall time (ms). 0 disables. */
     totalMs?: number;
 }
-declare const DEFAULT_STREAM_IDLE_MS = 90000;
+declare const DEFAULT_STREAM_IDLE_MS = 180000;
 declare const DEFAULT_STREAM_TOTAL_MS = 480000;
 declare const LAYER_IDLE_BUDGET_MS: Record<number, number>;
 /**
@@ -455,7 +457,7 @@ declare function createStreamChunkExtractor(): StreamChunkExtractor;
  * createStreamChunkExtractor, whose latch is the authoritative dedupe.
  */
 declare function extractStreamChunk(part: any): ExtractedStreamChunk;
-declare function createStreamAbortSignal(budget: Required<StreamBudget>): StreamAbortHandle;
+declare function createStreamAbortSignal(budget: Required<StreamBudget>, parentSignal?: AbortSignal): StreamAbortHandle;
 /**
  * Close an unterminated JSON object/array: append the delimiters that are
  * still open, closing any open string first. Handles streams aborted
@@ -485,7 +487,7 @@ declare function safeParseJson<T = any>(rawText: string | null): T | null;
 /**
  * Multi-tiered resilient streaming inference helper using 100% Vercel AI SDK.
  */
-declare function streamLLMWithFallback(systemPrompt: string, userPrompt: string, apiKeys?: Record<string, string>, onChunk?: LayerChunkCallback, preferredModel?: string, preferredProvider?: AIProviderName, budget?: StreamBudget): Promise<string | null>;
+declare function streamLLMWithFallback(systemPrompt: string, userPrompt: string, apiKeys?: Record<string, string>, onChunk?: LayerChunkCallback, preferredModel?: string, preferredProvider?: AIProviderName, budget?: StreamBudget, signal?: AbortSignal): Promise<string | null>;
 /**
  * Conducts preliminary ecosystem research for a course project.
  */
@@ -540,6 +542,7 @@ declare function buildSessionSliceContext(plan: CurriculumPlan, lessonCode: stri
 interface ProjectionMeta {
     courseName: string;
     shortDescription?: string;
+    targetLanguage?: string;
 }
 declare function renderFrameworkFromPlan(plan: CurriculumPlan, meta: ProjectionMeta): string;
 /** Extract the glossary scope (terms per session) the EXPOSITION service consumes. */

package/dist/index.d.ts

@@ -365,6 +365,8 @@ interface LayerPrefillOptions {
     timeoutMs?: number;
     /** Idle (no-data) budget override for this prefill run (ms). */
     idleTimeoutMs?: number;
+    /** Optional parent abort signal (e.g. from HTTP request) to stop immediately on client disconnect. */
+    signal?: AbortSignal;
 }
 interface PreliminaryResearchResult {
     groundTruthSummary: string;
@@ -388,7 +390,7 @@ interface StreamBudget {
     /** Abort when the whole stream exceeds this total wall time (ms). 0 disables. */
     totalMs?: number;
 }
-declare const DEFAULT_STREAM_IDLE_MS = 90000;
+declare const DEFAULT_STREAM_IDLE_MS = 180000;
 declare const DEFAULT_STREAM_TOTAL_MS = 480000;
 declare const LAYER_IDLE_BUDGET_MS: Record<number, number>;
 /**
@@ -455,7 +457,7 @@ declare function createStreamChunkExtractor(): StreamChunkExtractor;
  * createStreamChunkExtractor, whose latch is the authoritative dedupe.
  */
 declare function extractStreamChunk(part: any): ExtractedStreamChunk;
-declare function createStreamAbortSignal(budget: Required<StreamBudget>): StreamAbortHandle;
+declare function createStreamAbortSignal(budget: Required<StreamBudget>, parentSignal?: AbortSignal): StreamAbortHandle;
 /**
  * Close an unterminated JSON object/array: append the delimiters that are
  * still open, closing any open string first. Handles streams aborted
@@ -485,7 +487,7 @@ declare function safeParseJson<T = any>(rawText: string | null): T | null;
 /**
  * Multi-tiered resilient streaming inference helper using 100% Vercel AI SDK.
  */
-declare function streamLLMWithFallback(systemPrompt: string, userPrompt: string, apiKeys?: Record<string, string>, onChunk?: LayerChunkCallback, preferredModel?: string, preferredProvider?: AIProviderName, budget?: StreamBudget): Promise<string | null>;
+declare function streamLLMWithFallback(systemPrompt: string, userPrompt: string, apiKeys?: Record<string, string>, onChunk?: LayerChunkCallback, preferredModel?: string, preferredProvider?: AIProviderName, budget?: StreamBudget, signal?: AbortSignal): Promise<string | null>;
 /**
  * Conducts preliminary ecosystem research for a course project.
  */
@@ -540,6 +542,7 @@ declare function buildSessionSliceContext(plan: CurriculumPlan, lessonCode: stri
 interface ProjectionMeta {
     courseName: string;
     shortDescription?: string;
+    targetLanguage?: string;
 }
 declare function renderFrameworkFromPlan(plan: CurriculumPlan, meta: ProjectionMeta): string;
 /** Extract the glossary scope (terms per session) the EXPOSITION service consumes. */

package/dist/index.mjs

@@ -8406,13 +8406,16 @@ function computeContentHash(content) {
   return "sha256:" + crypto.createHash("sha256").update(content.trim(), "utf-8").digest("hex");
 }
 var STANDARD_SOT_FILES = [
-  "PROJECT_BRIEF.md",
   "LEARNER_PROFILE.md",
+  "PROJECT_BRIEF.md",
+  "REFERENCE_PACK.md",
+  "PROJECT_GRAPH.json",
+  "HYBRID_GRAPH.json",
+  "SECTION_LANGUAGE_CONTRACT.md",
   "CURRICULUM_FRAMEWORK.md",
-  "PROJECT_STATUS.md",
   "CONTENT_STYLE_GUIDE.md",
   "ART_DIRECTION.md",
-  "REFERENCE_PACK.md"
+  "ALIGNMENT_MATRIX.md"
 ];
 var FileSystemCurriculumAdapter = class {
   baseDir;
@@ -8454,19 +8457,33 @@ var FileSystemCurriculumAdapter = class {
   async listSotDocuments(projectId) {
     const projectDir = this.getProjectDir(projectId);
     const sotDir = path3.join(projectDir, "_sot");
-    return STANDARD_SOT_FILES.map((filename) => {
+    const discoveredFiles = new Set(STANDARD_SOT_FILES);
+    if (fs2.existsSync(sotDir)) {
+      try {
+        const diskFiles = fs2.readdirSync(sotDir);
+        for (const f of diskFiles) {
+          if (f.startsWith(".") || f.endsWith(".review.json")) continue;
+          const fullPath = path3.join(sotDir, f);
+          if (fs2.statSync(fullPath).isFile()) {
+            discoveredFiles.add(f);
+          }
+        }
+      } catch {
+      }
+    }
+    return Array.from(discoveredFiles).map((filename) => {
       const p = fs2.existsSync(path3.join(sotDir, filename)) ? path3.join(sotDir, filename) : fs2.existsSync(path3.join(projectDir, filename)) ? path3.join(projectDir, filename) : null;
       if (p && fs2.existsSync(p)) {
         const stats = fs2.statSync(p);
         return {
-          name: filename.replace(".md", "").replace(/_/g, " "),
+          name: filename.replace(/\.(md|json)$/i, "").replace(/_/g, " "),
           filename,
           exists: true,
           sizeBytes: stats.size
         };
       }
       return {
-        name: filename.replace(".md", "").replace(/_/g, " "),
+        name: filename.replace(/\.(md|json)$/i, "").replace(/_/g, " "),
         filename,
         exists: false,
         sizeBytes: 0
@@ -8712,11 +8729,23 @@ var SupabaseCurriculumAdapter = class {
     return null;
   }
   async listSotDocuments(projectId) {
+    const discoveredFiles = new Set(STANDARD_SOT_FILES);
+    try {
+      const { data, error } = await this.client.storage.from(this.bucketName).list(`${projectId}/_sot`);
+      if (!error && data) {
+        for (const item of data) {
+          if (item.name && !item.name.startsWith(".") && !item.name.endsWith(".review.json")) {
+            discoveredFiles.add(item.name);
+          }
+        }
+      }
+    } catch {
+    }
     const results = [];
-    for (const filename of STANDARD_SOT_FILES) {
+    for (const filename of discoveredFiles) {
       const content = await this.readSotDocument(projectId, filename);
       results.push({
-        name: filename.replace(".md", "").replace(/_/g, " "),
+        name: filename.replace(/\.(md|json)$/i, "").replace(/_/g, " "),
         filename,
         exists: !!content,
         content: content || void 0,
@@ -9093,10 +9122,12 @@ async function auditQualityReport(storage, projectId) {
   computedScore += Math.round(bloomPassCount / total * 20);
   computedScore += Math.round(Math.min(syntaxExecutableCount, total) / total * 20);
   computedScore += Math.round(scopeCompletenessCount / total * 20);
+  const sotCompletedCount = status.sotReadiness.filter((s) => s.exists).length;
+  const sotTotalCount = status.sotReadiness.length;
   if (sotReady) {
-    details.push("\u2705 N\u1EC1n t\u1EA3ng SOT (7/7 t\xE0i li\u1EC7u) s\u1EB5n s\xE0ng.");
+    details.push(`\u2705 N\u1EC1n t\u1EA3ng SOT (${sotCompletedCount}/${sotTotalCount} t\xE0i li\u1EC7u) s\u1EB5n s\xE0ng.`);
   } else {
-    details.push("\u26A0\uFE0F C\u1EA7n ho\xE0n thi\u1EC7n \u0111\u1EA7y \u0111\u1EE7 t\xE0i li\u1EC7u SOT c\u01A1 s\u1EDF.");
+    details.push(`\u26A0\uFE0F C\u1EA7n ho\xE0n thi\u1EC7n \u0111\u1EA7y \u0111\u1EE7 t\xE0i li\u1EC7u SOT c\u01A1 s\u1EDF (${sotCompletedCount}/${sotTotalCount}).`);
   }
   details.push(`\u{1F3AF} Ph\u1EA1m vi h\u1ECDc li\u1EC7u theo SOT (Artifact Scope): [${artifactScope.join(", ")}].`);
   if (pedagogy5EPass) {
@@ -9112,7 +9143,7 @@ async function auditQualityReport(storage, projectId) {
   details.push(`\u2705 \u0110\u1ED9 ph\u1EE7 \u0111\u1EA7y \u0111\u1EE7 c\xE1c h\u1ECDc li\u1EC7u trong Artifact Scope: ${scopeCompletenessCount}/${total} b\xE0i h\u1ECDc.`);
   const rawMarkdownReport = `## \u{1F6E1}\uFE0F B\xC1O C\xC1O KI\u1EC2M \u0110\u1ECANH CH\u1EA4T L\u01AF\u1EE2NG (QUALITY AUDIT): \`${projectId.toUpperCase()}\`
 - **\u0110i\u1EC3m th\u1EA9m \u0111\u1ECBnh ch\u1EA5t l\u01B0\u1EE3ng:** **${computedScore}/100**
-- **Tr\u1EA1ng th\xE1i SOT:** ${sotReady ? "\u2705 7/7 File SOT ho\xE0n t\u1EA5t" : "\u26A0\uFE0F C\u1EA7n b\u1ED5 sung t\xE0i li\u1EC7u SOT thi\u1EBFu"}.
+- **Tr\u1EA1ng th\xE1i SOT:** ${sotReady ? `\u2705 ${sotCompletedCount}/${sotTotalCount} File SOT ho\xE0n t\u1EA5t` : `\u26A0\uFE0F C\u1EA7n b\u1ED5 sung t\xE0i li\u1EC7u SOT thi\u1EBFu (${sotCompletedCount}/${sotTotalCount})`}.
 - **Ph\u1EA1m vi h\u1ECDc li\u1EC7u (SOT Artifact Scope):** \`${artifactScope.join(", ")}\`
 - **C\u1EA5u tr\xFAc S\u01B0 ph\u1EA1m (5E / EDP):** ${pedagogy5ECount}/${total} b\xE0i h\u1ECDc \u0111\u1EA1t chu\u1EA9n ph\xE2n pha.
 - **Thang \u0111o nh\u1EADn th\u1EE9c Bloom:** ${bloomPassCount}/${total} b\xE0i h\u1ECDc \u0111\u1EA1t ma tr\u1EADn m\u1EE5c ti\xEAu.
@@ -9214,7 +9245,9 @@ function extractScopeSequenceRows(framework) {
     const trimmed = line.trim();
     if (!trimmed.startsWith("|")) continue;
     const lower = trimmed.toLowerCase();
-    if (lower.includes("lesson code") && lower.includes("learning objective")) {
+    const hasCodeCol = lower.includes("lesson code") || lower.includes("m\xE3 b\xE0i") || lower.includes("m\xE3 b\xE0i h\u1ECDc");
+    const hasObjCol = lower.includes("learning objective") || lower.includes("m\u1EE5c ti\xEAu") || lower.includes("m\u1EE5c ti\xEAu h\u1ECDc t\u1EADp");
+    if (hasCodeCol && hasObjCol) {
       headerFound = true;
       continue;
     }
@@ -27258,13 +27291,13 @@ var DeterministicPipelineRunner = class {
 
 // src/services/prefillService.ts
 init_streamRunner();
-var DEFAULT_STREAM_IDLE_MS = 9e4;
+var DEFAULT_STREAM_IDLE_MS = 18e4;
 var DEFAULT_STREAM_TOTAL_MS = 48e4;
 var LAYER_IDLE_BUDGET_MS = {
-  1: 9e4,
-  2: 9e4,
+  1: 18e4,
+  2: 18e4,
   3: 18e4
-  // Layer 3 synthesizes all accumulated context + pathways (3 minutes idle protection)
+  // 3 minutes idle protection across all layers for free-tier reasoning models
 };
 var LAYER_TOTAL_BUDGET_MS = {
   1: 48e4,
@@ -27325,10 +27358,20 @@ function extractStreamChunk(part) {
   }
   return {};
 }
-function createStreamAbortSignal(budget) {
+function createStreamAbortSignal(budget, parentSignal) {
   const controller = new AbortController();
   let idleTimer = null;
   let totalTimer = null;
+  const onParentAbort = () => {
+    controller.abort(parentSignal?.reason || new Error("Aborted by parent signal"));
+  };
+  if (parentSignal) {
+    if (parentSignal.aborted) {
+      controller.abort(parentSignal.reason || new Error("Parent signal already aborted"));
+    } else {
+      parentSignal.addEventListener("abort", onParentAbort, { once: true });
+    }
+  }
   const armIdle = () => {
     if (idleTimer) clearTimeout(idleTimer);
     if (budget.idleMs > 0) {
@@ -27355,6 +27398,9 @@ function createStreamAbortSignal(budget) {
     dispose: () => {
       if (idleTimer) clearTimeout(idleTimer);
       if (totalTimer) clearTimeout(totalTimer);
+      if (parentSignal) {
+        parentSignal.removeEventListener("abort", onParentAbort);
+      }
       idleTimer = null;
       totalTimer = null;
     }
@@ -27466,7 +27512,7 @@ function safeParseJson(rawText) {
   }
   return null;
 }
-async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onChunk, preferredModel, preferredProvider, budget) {
+async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onChunk, preferredModel, preferredProvider, budget, signal) {
   const alibabaKey = apiKeys.alibaba || apiKeys.dashscope || process.env.ALIBABA_API_KEY || process.env.DASHSCOPE_API_KEY;
   const nvidiaKey = apiKeys.nvidia || process.env.NVIDIA_API_KEY;
   const deepseekKey = apiKeys.deepseek || process.env.DEEPSEEK_API_KEY;
@@ -27498,7 +27544,6 @@ async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onC
     const nemotronModels = [
       "nvidia/nemotron-3-ultra-550b-a55b",
       "nvidia/nemotron-3.5-lightning-30b-a3b",
-      "nvidia/nemotron-3-super-120b-a12b",
       "nvidia/llama-3.1-nemotron-70b-instruct"
     ].filter((m) => isModelAllowed(m));
     for (const m of nemotronModels) {
@@ -27549,8 +27594,12 @@ THINKING DIRECTIVE: Do ALL your reasoning internally BEFORE emitting output. Do
     totalMs: budget?.totalMs ?? DEFAULT_STREAM_TOTAL_MS
   };
   for (const candidate of candidates) {
+    if (signal?.aborted) {
+      console.log(`[curriculum-kit:VercelAI] AbortSignal already aborted, cancelling candidate loop.`);
+      break;
+    }
     const t0 = Date.now();
-    const abort = createStreamAbortSignal(resolvedBudget);
+    const abort = createStreamAbortSignal(resolvedBudget, signal);
     try {
       const modelInstance = getAIModel({
         provider: candidate.provider,
@@ -27582,6 +27631,13 @@ THINKING DIRECTIVE: Do ALL your reasoning internally BEFORE emitting output. Do
       }
     } catch (e) {
       console.warn(`[curriculum-kit:VercelAI] Candidate ${candidate.provider} (${candidate.model}) failed in ${Date.now() - t0}ms:`, e?.message || e);
+      const isClientAborted = Boolean(
+        signal?.aborted || e?.name === "AbortError" && signal?.aborted || e?.message && (e.message.includes("Controller is already closed") || e.message.includes("The operation was aborted") || e.message.includes("Aborted by parent signal"))
+      );
+      if (isClientAborted) {
+        console.log(`[curriculum-kit:VercelAI] Client aborted or stream closed, halting candidate fallback loop.`);
+        break;
+      }
     } finally {
       abort.dispose();
     }
@@ -27633,7 +27689,8 @@ Return concise JSON matching:
       totalMs: options.timeoutMs,
       model: options.model,
       provider: options.provider
-    })
+    }),
+    options.signal
   );
   let parsedResearch = {
     groundTruthSummary: `Verified ecosystem standards for ${projectName}`,
@@ -27843,7 +27900,8 @@ REQUIREMENT: Synthesize ALL parameters above \u2014 every single line in FULL AC
       totalMs: options.timeoutMs,
       model: options.model,
       provider: options.provider
-    })
+    }),
+    options.signal
   );
   const parsed = safeParseJson(rawContent);
   return {
@@ -27859,6 +27917,7 @@ var pad22 = (n) => String(n).padStart(2, "0");
 var esc = (s) => s.replace(/\|/g, "/").replace(/\n/g, " ").trim();
 var BLOOM_OF_DEPTH = { ulo: "Understand", cio: "Apply", sio: "Create" };
 function renderFrameworkFromPlan(plan, meta) {
+  const isVi = meta.targetLanguage === "vi";
   const dateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   const totalSessions = plan.sessions.length;
   const totalMinutes = plan.sessions.reduce(
@@ -27876,10 +27935,16 @@ function renderFrameworkFromPlan(plan, meta) {
     const depthTops = [...new Set(s.depth_assignments.map((d) => d.depth))].map((d) => BLOOM_OF_DEPTH[d] ?? "Apply");
     const bloom = depthTops[depthTops.length - 1] ?? "Apply";
     const keyConcepts = s.new_keywords.length > 0 ? s.new_keywords.join(", ") : s.depth_assignments.map((d) => d.node_id).join(", ");
-    const prereq = s.prerequisite_decisions.length > 0 ? s.prerequisite_decisions.filter((p) => p.decision === "taught_in_prior_lesson").length + " prior-taught, " + s.prerequisite_decisions.filter((p) => p.decision === "recap_in_lesson").length + " recap" : "None";
+    const prereq = s.prerequisite_decisions.length > 0 ? s.prerequisite_decisions.filter((p) => p.decision === "taught_in_prior_lesson").length + " prior-taught, " + s.prerequisite_decisions.filter((p) => p.decision === "recap_in_lesson").length + " recap" : isVi ? "Kh\xF4ng" : "None";
     const duration = s.knowledge_minutes + s.practice_minutes + s.overhead_minutes;
     return "| " + pad22(i + 1) + " | " + s.id + " | " + esc(s.title) + " | " + s.unit_id + " | " + s.unit_id + "_M01 | " + esc(s.prose_objective) + " | " + esc(keyConcepts) + " | " + esc(s.exit_evidence[0] ?? "") + " | " + esc(prereq) + " | " + bloom + " | " + duration + " |";
   }).join("\n");
+  const courseOverviewHeader = isVi ? "## [REQUIRED] T\u1ED5ng quan Kh\xF3a h\u1ECDc" : "## [REQUIRED] Course Overview";
+  const globalObjectivesHeader = isVi ? "## [REQUIRED] M\u1EE5c ti\xEAu H\u1ECDc t\u1EADp To\xE0n di\u1EC7n" : "## [REQUIRED] Global Learning Objectives";
+  const structuralHierarchyHeader = isVi ? "## [REQUIRED] C\u1EA5u tr\xFAc Kh\xF3a h\u1ECDc (Unit & Module)" : "## [REQUIRED] Structural Hierarchy (Unit & Module)";
+  const scopeSequenceHeader = isVi ? "## [REQUIRED] Ph\u1EA1m vi & Tr\xECnh t\u1EF1 Chi ti\u1EBFt (Scope & Sequence)" : "## [REQUIRED] Scope & Sequence (Detailed Roadmap)";
+  const standardFormatHeader = isVi ? "## [REQUIRED] C\u1EA5u tr\xFAc B\xE0i h\u1ECDc Chu\u1EA9n" : "## [REQUIRED] Standard Lesson Format";
+  const scopeTableHeader = isVi ? "| # | Lesson Code | Title | Unit | Module | Learning Objective (H\u1ECDc sinh l\xE0m \u0111\u01B0\u1EE3c g\xEC...) | Key Concepts (H\u1ECDc g\xEC) | Hands-on Deliverable (S\u1EA3n ph\u1EA9m bu\u1ED5i h\u1ECDc) | Prerequisites | Bloom | Duration (mins) |" : "| # | Lesson Code | Title | Unit | Module | Learning Objective (Students will be able to...) | Key Concepts (Hoc gi) | Hands-on Deliverable (Lam duoc gi) | Prerequisites | Bloom | Duration (mins) |";
   return [
     "---",
     'id: "CURRICULUM-FRAMEWORK"',
@@ -27901,7 +27966,7 @@ function renderFrameworkFromPlan(plan, meta) {
     "",
     "_Projection of CURRICULUM_PLAN (hash " + plan.plan_hash + "). Approving this framework approves the per-session SCOPE recorded in the plan._",
     "",
-    "## [REQUIRED] Course Overview",
+    courseOverviewHeader,
     "- **Official Course Name:** " + esc(meta.courseName),
     meta.shortDescription ? "- **Short Description:** " + esc(meta.shortDescription) : "",
     "- **Total Units:** " + plan.units.length,
@@ -27909,20 +27974,20 @@ function renderFrameworkFromPlan(plan, meta) {
     "- **Total Duration:** ~" + totalHours + " hours (" + totalSessions + " sessions x " + plan.constraints.session_duration_minutes + " min).",
     "- **Entry Level:** " + plan.constraints.entry_level + " (age band " + plan.constraints.age_band[0] + "-" + plan.constraints.age_band[1] + ").",
     "",
-    "## [REQUIRED] Global Learning Objectives",
+    globalObjectivesHeader,
     ...plan.course.objectives.map((o, i) => i + 1 + ". **[" + o.bloom + "]:** " + esc(o.statement)),
     "",
-    "## [REQUIRED] Structural Hierarchy (Unit & Module)",
+    structuralHierarchyHeader,
     "| Unit | Module | Lessons | Module Objective | Lesson Codes |",
     "|---|---|:---:|---|---|",
     hierarchyRows || "| (none) | | | | |",
     "",
-    "## [REQUIRED] Scope & Sequence (Detailed Roadmap)",
-    "| # | Lesson Code | Title | Unit | Module | Learning Objective (Students will be able to...) | Key Concepts (Hoc gi) | Hands-on Deliverable (Lam duoc gi) | Prerequisites | Bloom | Duration (mins) |",
+    scopeSequenceHeader,
+    scopeTableHeader,
     "|:---:|:---:|---|---|---|---|---|---|---|:---:|:---:|",
     scopeRows || "| 01 | U01_M01_L01 | (empty plan) | U01 | U01_M01 | - | - | - | None | Understand | " + plan.constraints.session_duration_minutes + " |",
     "",
-    "## [REQUIRED] Standard Lesson Format",
+    standardFormatHeader,
     "- **Session duration:** " + plan.constraints.session_duration_minutes + " minutes (overhead " + String(plan.sessions[0]?.overhead_minutes ?? 0) + " min).",
     "- **Knowledge/practice split per session:** see plan JSON (knowledge_minutes / practice_minutes).",
     "- **Pedagogical flow:** 5E (Engage / Explore / Explain / Elaborate / Evaluate) unless policy overrides.",