@thanh01.pmt/curriculum-kit 1.0.21 → 1.1.0

package/dist/index.d.cts

@@ -132,6 +132,8 @@ interface ProduceLessonOptions {
     artifactScope?: string[];
     force?: boolean;
     pedagogy?: PedagogicalModel;
+    targetLanguage?: string;
+    sectionLanguageContract?: string;
     /** Chiến lược batch (chỉ produceBatchLessons dùng). */
     batchStrategy?: 'depth_first_lesson' | 'breadth_first_artifact';
     /**
@@ -615,13 +617,29 @@ declare function isTranslationDue(target: TranslationTarget, context: {
     publishRequested: boolean;
 }): boolean;
 
+/**
+ * Language Directive and Section Language Contract (SLC) resolution for Curriculum Generation.
+ */
+declare function resolveTargetLanguageCode(language?: string | null): string;
+declare function targetLanguageDisplayName(code: string): string;
+declare function buildLanguageDirective(targetLanguage?: string | null): string;
+/**
+ * Parses markdown table or lines from SECTION_LANGUAGE_CONTRACT.md to extract
+ * mapping for a specific artifact type.
+ */
+declare function extractSectionHeadingsFromSLC(slcMarkdown: string | undefined | null, artifactType: string): Record<string, string>;
+/**
+ * Builds the heading directive block to instruct LLM on verbatim section headings.
+ */
+declare function buildHeadingDirective(artifactType: string, slcMarkdown?: string | null, targetLanguage?: string): string;
+
 /**
  * Curriculum OS - Standardized Error Taxonomy & Traceability System
  *
  * Provides typed, structured, and traceable error codes for all pipeline failures,
  * API exceptions, safeguard blocks, and contract violations.
  */
-type CurriculumErrorCode = 'ERR_AI_NO_API_KEY' | 'ERR_AI_RATE_LIMIT' | 'ERR_AI_AUTH_FAILED' | 'ERR_AI_NETWORK_TIMEOUT' | 'ERR_AI_RESPONSE_MALFORMED' | 'ERR_AI_ALL_PROVIDERS_FAILED' | 'ERR_SOT_MISSING' | 'ERR_SOT_INVALID_SCHEMA' | 'ERR_TASK_GATE_BLOCKED' | 'ERR_METERED_LIMIT_EXCEEDED' | 'ERR_SCHEMA_CONTRACT_VIOLATION' | 'ERR_STORAGE_IO_FAILED';
+type CurriculumErrorCode = 'ERR_AI_NO_API_KEY' | 'ERR_AI_RATE_LIMIT' | 'ERR_AI_AUTH_FAILED' | 'ERR_AI_NETWORK_TIMEOUT' | 'ERR_AI_RESPONSE_MALFORMED' | 'ERR_AI_ALL_PROVIDERS_FAILED' | 'ERR_SOT_MISSING' | 'ERR_SOT_INVALID_SCHEMA' | 'ERR_TASK_GATE_BLOCKED' | 'ERR_METERED_LIMIT_EXCEEDED' | 'ERR_SCHEMA_CONTRACT_VIOLATION' | 'ERR_STORAGE_IO_FAILED' | 'ERR_LESSON_NOT_IN_SOT';
 interface CurriculumErrorDetail {
     errorCode: CurriculumErrorCode;
     agent?: string;
@@ -957,4 +975,4 @@ declare function getSlideLayoutPresetById(id: string): SlideLayoutPreset | undef
  */
 declare function getSlideLayoutPresetsByCategory(category: SlideLayoutCategory): SlideLayoutPreset[];
 
-export { ACT_TEMPLATE, AIProviderName, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdge, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type ExtractedStreamChunk, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, HANDOUT_TEMPLATE, ICurriculumStorage, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, type SlashCommandDefinition, SlideDeck, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, SmartResumeContext, type StreamAbortHandle, type StreamBudget, type StreamChunkExtractor, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, expositionCacheKey, extractScopeSequenceRows, extractSessionSlice, extractStreamChunk, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, topoSort };
+export { ACT_TEMPLATE, AIProviderName, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdge, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type ExtractedStreamChunk, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, HANDOUT_TEMPLATE, ICurriculumStorage, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, type SlashCommandDefinition, SlideDeck, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, SmartResumeContext, type StreamAbortHandle, type StreamBudget, type StreamChunkExtractor, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildHeadingDirective, buildLanguageDirective, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, expositionCacheKey, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStreamChunk, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort };

package/dist/index.d.ts

@@ -132,6 +132,8 @@ interface ProduceLessonOptions {
     artifactScope?: string[];
     force?: boolean;
     pedagogy?: PedagogicalModel;
+    targetLanguage?: string;
+    sectionLanguageContract?: string;
     /** Chiến lược batch (chỉ produceBatchLessons dùng). */
     batchStrategy?: 'depth_first_lesson' | 'breadth_first_artifact';
     /**
@@ -615,13 +617,29 @@ declare function isTranslationDue(target: TranslationTarget, context: {
     publishRequested: boolean;
 }): boolean;
 
+/**
+ * Language Directive and Section Language Contract (SLC) resolution for Curriculum Generation.
+ */
+declare function resolveTargetLanguageCode(language?: string | null): string;
+declare function targetLanguageDisplayName(code: string): string;
+declare function buildLanguageDirective(targetLanguage?: string | null): string;
+/**
+ * Parses markdown table or lines from SECTION_LANGUAGE_CONTRACT.md to extract
+ * mapping for a specific artifact type.
+ */
+declare function extractSectionHeadingsFromSLC(slcMarkdown: string | undefined | null, artifactType: string): Record<string, string>;
+/**
+ * Builds the heading directive block to instruct LLM on verbatim section headings.
+ */
+declare function buildHeadingDirective(artifactType: string, slcMarkdown?: string | null, targetLanguage?: string): string;
+
 /**
  * Curriculum OS - Standardized Error Taxonomy & Traceability System
  *
  * Provides typed, structured, and traceable error codes for all pipeline failures,
  * API exceptions, safeguard blocks, and contract violations.
  */
-type CurriculumErrorCode = 'ERR_AI_NO_API_KEY' | 'ERR_AI_RATE_LIMIT' | 'ERR_AI_AUTH_FAILED' | 'ERR_AI_NETWORK_TIMEOUT' | 'ERR_AI_RESPONSE_MALFORMED' | 'ERR_AI_ALL_PROVIDERS_FAILED' | 'ERR_SOT_MISSING' | 'ERR_SOT_INVALID_SCHEMA' | 'ERR_TASK_GATE_BLOCKED' | 'ERR_METERED_LIMIT_EXCEEDED' | 'ERR_SCHEMA_CONTRACT_VIOLATION' | 'ERR_STORAGE_IO_FAILED';
+type CurriculumErrorCode = 'ERR_AI_NO_API_KEY' | 'ERR_AI_RATE_LIMIT' | 'ERR_AI_AUTH_FAILED' | 'ERR_AI_NETWORK_TIMEOUT' | 'ERR_AI_RESPONSE_MALFORMED' | 'ERR_AI_ALL_PROVIDERS_FAILED' | 'ERR_SOT_MISSING' | 'ERR_SOT_INVALID_SCHEMA' | 'ERR_TASK_GATE_BLOCKED' | 'ERR_METERED_LIMIT_EXCEEDED' | 'ERR_SCHEMA_CONTRACT_VIOLATION' | 'ERR_STORAGE_IO_FAILED' | 'ERR_LESSON_NOT_IN_SOT';
 interface CurriculumErrorDetail {
     errorCode: CurriculumErrorCode;
     agent?: string;
@@ -957,4 +975,4 @@ declare function getSlideLayoutPresetById(id: string): SlideLayoutPreset | undef
  */
 declare function getSlideLayoutPresetsByCategory(category: SlideLayoutCategory): SlideLayoutPreset[];
 
-export { ACT_TEMPLATE, AIProviderName, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdge, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type ExtractedStreamChunk, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, HANDOUT_TEMPLATE, ICurriculumStorage, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, type SlashCommandDefinition, SlideDeck, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, SmartResumeContext, type StreamAbortHandle, type StreamBudget, type StreamChunkExtractor, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, expositionCacheKey, extractScopeSequenceRows, extractSessionSlice, extractStreamChunk, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, topoSort };
+export { ACT_TEMPLATE, AIProviderName, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdge, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type ExtractedStreamChunk, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, HANDOUT_TEMPLATE, ICurriculumStorage, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, type SlashCommandDefinition, SlideDeck, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, SmartResumeContext, type StreamAbortHandle, type StreamBudget, type StreamChunkExtractor, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildHeadingDirective, buildLanguageDirective, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, expositionCacheKey, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStreamChunk, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort };

package/dist/index.mjs

@@ -2421,9 +2421,20 @@ var SessionPlanSchema = z.object({
   differentiation: z.object({ bronze: z.string(), silver: z.string(), gold: z.string() })
 });
 var TranslationPolicySchema = z.object({
-  policy: z.enum(["after_artifact", "end_of_unit", "at_publish"]).default("at_publish"),
+  policy: z.enum(["after_artifact", "end_of_unit", "at_publish", "native"]).default("native"),
   target_language: z.string().nullable().default(null)
-});
+}).refine(
+  (data) => {
+    if (data.policy === "native") {
+      return typeof data.target_language === "string" && data.target_language.trim().length > 0;
+    }
+    return true;
+  },
+  {
+    message: "When translation policy is 'native', target_language must be a non-empty string",
+    path: ["target_language"]
+  }
+);
 var CoverageReportSchema = z.object({
   assigned_node_ids: z.array(z.string()),
   unassigned_node_ids: z.array(z.string()),
@@ -8626,12 +8637,15 @@ var SupabaseCurriculumAdapter = class {
       } catch {
       }
     }
+    if (relPathOrIdentifier.includes(".md") || relPathOrIdentifier.includes(".json") || relPathOrIdentifier.includes("/")) {
+      return null;
+    }
     const lessonMatch = relPathOrIdentifier.match(/U\d+_M\d+_L\d+/i);
     if (lessonMatch) {
       const lessonId = lessonMatch[0].toUpperCase();
       const unitCode = lessonId.split("_")[0] || "U01";
       const lower = relPathOrIdentifier.toLowerCase();
-      let artifactPrefix = "LESSON";
+      let artifactPrefix = null;
       if (lower.includes("act") || lower.includes("lab") || lower.includes("th\u1EF1c h\xE0nh")) {
         artifactPrefix = "ACT";
       } else if (lower.includes("quiz") || lower.includes("tr\u1EAFc nghi\u1EC7m") || lower.includes("\u0111\xE1nh gi\xE1")) {
@@ -8640,8 +8654,31 @@ var SupabaseCurriculumAdapter = class {
         artifactPrefix = "SLIDE";
       } else if (lower.includes("guide") || lower.includes("h\u01B0\u1EDBng d\u1EABn")) {
         artifactPrefix = "GUIDE";
+      } else if (lower.includes("wks") || lower.includes("worksheet") || lower.includes("phi\u1EBFu b\xE0i t\u1EADp")) {
+        artifactPrefix = "WKS";
+      } else if (lower.includes("handout") || lower.includes("t\xE0i li\u1EC7u")) {
+        artifactPrefix = "HANDOUT";
+      } else if (lower.includes("code")) {
+        artifactPrefix = "CODE";
+      } else if (lower.includes("ext") || lower.includes("extension") || lower.includes("m\u1EDF r\u1ED9ng")) {
+        artifactPrefix = "EXT";
+      } else if (lower.includes("exp") || lower.includes("exposition") || lower.includes("t\u1EF1 h\u1ECDc") || lower.includes("ki\u1EBFn th\u1EE9c n\u1EC1n")) {
+        artifactPrefix = "EXPOSITION";
+      } else if (lower.includes("rubric")) {
+        artifactPrefix = "RUBRIC";
+      } else if (lower.includes("bom")) {
+        artifactPrefix = "BOM";
+      } else if (lower.includes("lesson") || lower.includes("gi\xE1o \xE1n") || lower.includes("5e")) {
+        artifactPrefix = "LESSON";
+      }
+      if (!artifactPrefix) {
+        return null;
       }
-      const candidatePaths = [
+      const candidatePaths = artifactPrefix === "EXPOSITION" ? [
+        `${projectId}/_sot/expositions/${lessonId}.md`,
+        `${projectId}/_content/${unitCode}/EXPOSITION_${lessonId}.md`,
+        `${projectId}/lessons/${lessonId}/EXPOSITION_${lessonId}.md`
+      ] : [
         `${projectId}/_content/${unitCode}/${artifactPrefix}_${lessonId}.md`,
         `${projectId}/lessons/${lessonId}/${artifactPrefix}_${lessonId}.md`,
         `${projectId}/${artifactPrefix}_${lessonId}.md`
@@ -9818,6 +9855,7 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
   });
   return { relPath: result.relPath, context: buildExpositionContext(result.content), reused: result.reused };
 }
+init_errors();
 var asArr = (v) => Array.isArray(v) ? v : [];
 var asStr = (v, dflt = "") => typeof v === "string" ? v : dflt;
 var asNum = (v, dflt) => typeof v === "number" && Number.isFinite(v) ? v : dflt;
@@ -10460,7 +10498,15 @@ function extractSessionSlice(plan, lessonCode) {
 }
 function buildSessionSliceContext(plan, lessonCode) {
   const s = plan.sessions.find((x) => x.id === lessonCode);
-  if (!s) return "";
+  if (!s) {
+    throw new CurriculumError({
+      errorCode: "ERR_LESSON_NOT_IN_SOT",
+      message: `Session "${lessonCode}" not found in CURRICULUM_PLAN.json (${plan.plan_hash})`,
+      suggestedAction: "\u0110\u1ED3ng b\u1ED9 CURRICULUM_PLAN r\u1ED3i ch\u1EA1y l\u1EA1i",
+      retryable: false,
+      lessonId: lessonCode
+    });
+  }
   const lines = [];
   lines.push("[SESSION SLICE (from CURRICULUM_PLAN " + plan.plan_hash + ")]");
   lines.push("- Objective: " + s.prose_objective);
@@ -11027,6 +11073,80 @@ function resolveStandardsPacks(packIds) {
   return packs;
 }
 
+// src/services/languageDirective.ts
+function resolveTargetLanguageCode(language) {
+  const raw = String(language || "vi").trim().toLowerCase();
+  if (raw.startsWith("vi")) return "vi";
+  if (raw.startsWith("en")) return "en";
+  return raw || "vi";
+}
+function targetLanguageDisplayName(code) {
+  const map = {
+    vi: "Vietnamese (Ti\u1EBFng Vi\u1EC7t)",
+    en: "English (US)"
+  };
+  return map[code] || code;
+}
+function buildLanguageDirective(targetLanguage) {
+  const code = resolveTargetLanguageCode(targetLanguage);
+  const name = targetLanguageDisplayName(code);
+  const perLanguageExamples = {
+    vi: `- V\xED d\u1EE5 ti\xEAu \u0111\u1EC1 b\xE0i h\u1ECDc \u0111\xFAng chu\u1EA9n: "B\xE0i 1: Kh\xE1m ph\xE1 m\u1EA1ch \u0111i\u1EC7n c\u01A1 b\u1EA3n", "B\xE0i 2: \u0110i\u1EC1u khi\u1EC3n \u0111\xE8n LED nh\u1EA5p nh\xE1y" \u2014 KH\xD4NG d\xF9ng ti\xEAu \u0111\u1EC1 ti\u1EBFng Anh.`,
+    en: `- Example compliant lesson title: "Lesson 1: Exploring Basic Circuits" \u2014 natural, idiomatic English throughout.`
+  };
+  const exampleLine = perLanguageExamples[code] || "";
+  return `MANDATORY LANGUAGE DIRECTIVE (TARGET OUTPUT LANGUAGE: ${name}):
+- The TARGET OUTPUT LANGUAGE for this course is ${name}. You MUST author the ENTIRE document in ${name}.
+- All section titles, table headers, table cells, lesson names, learning objectives, pedagogical narratives, and cognitive analyses MUST be written in natural, fluent, academic ${name}.
+- Technical identifiers, code keywords (e.g. setup(), loop(), pinMode()), standard protocols (I2C, SPI, UART, GPIO), and component model numbers (ESP32, Arduino Uno) remain in standard technical notation, but all surrounding explanations MUST be in ${name}.
+- DO NOT mix in paragraphs, tables, or titles written in any other language. Strict adherence is required.${exampleLine ? `
+${exampleLine}` : ""}`;
+}
+function extractSectionHeadingsFromSLC(slcMarkdown, artifactType) {
+  if (!slcMarkdown) return {};
+  const upperType = artifactType.trim().toUpperCase();
+  const blocks = slcMarkdown.split(/\n(?=#{2,3}\s+[A-Z0-9_]+)/g);
+  for (const block of blocks) {
+    const headerMatch = block.match(/^#{2,3}\s+([A-Z0-9_]+)/);
+    if (!headerMatch) continue;
+    const blockType = headerMatch[1].trim().toUpperCase();
+    if (blockType === upperType || upperType.startsWith("LESSON") && blockType.startsWith("LESSON")) {
+      const mapping = {};
+      const lines = block.split("\n");
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("|") && !trimmed.includes("---")) {
+          const cells = trimmed.split("|").map((c) => c.trim()).filter((_, idx, arr) => idx > 0 && idx < arr.length - 1);
+          if (cells.length >= 2 && !cells[0].toLowerCase().includes("canonical") && !cells[1].toLowerCase().includes("localized")) {
+            mapping[cells[0]] = cells[1];
+          }
+        } else {
+          const bullet = line.match(/^[-*]\s+([^:]+):\s+(.+)$/);
+          if (bullet) {
+            mapping[bullet[1].trim()] = bullet[2].trim();
+          }
+        }
+      }
+      if (Object.keys(mapping).length > 0) return mapping;
+    }
+  }
+  return {};
+}
+function buildHeadingDirective(artifactType, slcMarkdown, targetLanguage = "vi") {
+  const headings = extractSectionHeadingsFromSLC(slcMarkdown, artifactType);
+  if (Object.keys(headings).length === 0) {
+    return "";
+  }
+  const lines = Object.entries(headings).map(
+    ([canonical, localized]) => `  - "${canonical}" -> Use Display Heading: "${localized}"`
+  );
+  return `MANDATORY SECTION HEADINGS FROM SECTION_LANGUAGE_CONTRACT:
+- The YAML frontmatter \`template_required_sections\` MUST preserve the exact English canonical keys.
+- In the markdown body, section headers MUST use the EXACT Localized Display Labels below (do NOT translate or paraphrase):
+${lines.join("\n")}
+- For example: if canonical section is "Computational Thinking Focus", your heading must be "## [REQUIRED] ${headings["Computational Thinking Focus"] || "Computational Thinking Focus"}".`;
+}
+
 // src/services/lessonProductionService.ts
 var __filename2 = typeof import.meta?.url === "string" ? fileURLToPath(import.meta.url) : "";
 var _resolvedDir = __filename2 ? path3.dirname(__filename2) : typeof __dirname !== "undefined" ? __dirname : process.cwd();
@@ -11068,11 +11188,44 @@ function detectProjectPedagogy(frameworkText, styleGuideText, explicitPedagogy)
   return "5e";
 }
 async function getLessonMetadata(storage, projectId, lessonId) {
-  const framework = await storage.readSotDocument(projectId, "CURRICULUM_FRAMEWORK.md") || "";
   const parts = lessonId.split("_");
   const unitCode = parts[0] || "U01";
   const moduleCode = parts.length >= 2 ? `${parts[0]}_${parts[1]}` : `${unitCode}_M01`;
   const lessonCode = lessonId;
+  let planStr = null;
+  try {
+    planStr = await storage.readSotDocument(projectId, "CURRICULUM_PLAN.json") || await storage.readArtifact(projectId, "_sot/CURRICULUM_PLAN.json") || await storage.readArtifact(projectId, "CURRICULUM_PLAN.json");
+  } catch {
+  }
+  if (planStr) {
+    try {
+      const plan = JSON.parse(planStr);
+      if (Array.isArray(plan.sessions)) {
+        const session = plan.sessions.find((s) => s.id === lessonId);
+        if (session) {
+          const lessonTitle2 = session.title || `Lesson ${lessonId}`;
+          const keywords = Array.isArray(session.new_keywords) && session.new_keywords.length > 0 ? ` T\u1EEB kh\xF3a: ${session.new_keywords.join(", ")}` : "";
+          const objective2 = session.prose_objective || session.title || "";
+          const concept2 = objective2 ? `${objective2}.${keywords}` : session.title || "Core Technical Competency";
+          const prerequisites2 = session.anchor_type ? `Anchor: ${session.anchor_type}` : "None";
+          const depth = Array.isArray(session.depth_assignments) ? session.depth_assignments[0]?.depth : session.depth_assignments?.knowledge_depth;
+          const bloomLevel2 = depth === "sio" ? "Create" : depth === "cio" ? "Apply" : "Understand";
+          return {
+            unitCode: session.unit_id || unitCode,
+            moduleCode,
+            lessonCode,
+            lessonTitle: lessonTitle2,
+            concept: `M\u1EE5c ti\xEAu bu\u1ED5i h\u1ECDc: ${concept2}`,
+            prerequisites: prerequisites2,
+            bloomLevel: bloomLevel2
+          };
+        }
+      }
+    } catch (planErr) {
+      console.warn(`[getLessonMetadata] Error parsing CURRICULUM_PLAN.json for ${projectId}:`, planErr);
+    }
+  }
+  const framework = await storage.readSotDocument(projectId, "CURRICULUM_FRAMEWORK.md") || "";
   let lessonTitle = `Lesson ${lessonId}`;
   let concept = "Core Technical Competency";
   let prerequisites = "None";
@@ -11117,15 +11270,24 @@ async function getLessonMetadata(storage, projectId, lessonId) {
     }
     if (found) break;
   }
-  return {
-    unitCode,
-    moduleCode,
-    lessonCode,
-    lessonTitle,
-    concept: objective ? `${concept}. M\u1EE5c ti\xEAu bu\u1ED5i h\u1ECDc: ${objective}` : concept,
-    prerequisites: deliverable ? `${prerequisites}. S\u1EA3n ph\u1EA9m hands-on c\u1EE7a bu\u1ED5i: ${deliverable}` : prerequisites,
-    bloomLevel
-  };
+  if (found) {
+    return {
+      unitCode,
+      moduleCode,
+      lessonCode,
+      lessonTitle,
+      concept: objective ? `${concept}. M\u1EE5c ti\xEAu bu\u1ED5i h\u1ECDc: ${objective}` : concept,
+      prerequisites: deliverable ? `${prerequisites}. S\u1EA3n ph\u1EA9m hands-on c\u1EE7a bu\u1ED5i: ${deliverable}` : prerequisites,
+      bloomLevel
+    };
+  }
+  throw new CurriculumError({
+    errorCode: "ERR_LESSON_NOT_IN_SOT",
+    lessonId,
+    message: `ERR_LESSON_NOT_IN_SOT: B\xE0i h\u1ECDc "${lessonId}" kh\xF4ng t\u1ED3n t\u1EA1i trong CURRICULUM_PLAN.json ho\u1EB7c CURRICULUM_FRAMEWORK.md c\u1EE7a d\u1EF1 \xE1n "${projectId}".`,
+    suggestedAction: "\u0110\u1ED3ng b\u1ED9 CURRICULUM_PLAN r\u1ED3i ch\u1EA1y l\u1EA1i",
+    retryable: false
+  });
 }
 function buildFrameworkExcerptForLesson(framework, lessonId) {
   if (!framework) return "";
@@ -11167,7 +11329,7 @@ ${nextRow}`
   ].filter(Boolean);
   return parts.join("\n\n") || framework.slice(0, 1500);
 }
-function buildLessonPrompt(pedagogy, lessonCode, unitCode, lessonTitle, concept, bloomLevel, dateStr) {
+function buildLessonPrompt(pedagogy, lessonCode, unitCode, lessonTitle, concept, bloomLevel, dateStr, targetLanguage = "vi", sectionLanguageContract) {
   const commonFrontmatter = `id: "LESSON_${lessonCode}"
 title: "${lessonTitle}"
 created_by: "Curriculum OS Builder"
@@ -11187,8 +11349,9 @@ template_required_sections:
   - "Artifact Contract"
   - "B. Lesson Flow"
   - "Artifact Linkage"`;
+  let prompt = "";
   if (pedagogy === "edp") {
-    return `You are @content (Educational Content Editor & EDP Engineering Design Process Specialist).
+    prompt = `You are @content (Educational Content Editor & EDP Engineering Design Process Specialist).
 Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_EDP_template.md\` standards for:
 - Lesson Code: ${lessonCode}
 - Title: ${lessonTitle}
@@ -11237,9 +11400,8 @@ Linkage ledger mapping all satellite artifacts (\`ACT_...\`, \`QUIZ_...\`, \`SLI
 
 3. Ensure all sample code and schemas are 100% syntax-valid and executable.
 4. Output 100% clean Markdown directly.`;
-  }
-  if (pedagogy === "pbl" || pedagogy === "general") {
-    return `You are @content (Educational Content Editor & PBL/General Pedagogy Specialist).
+  } else if (pedagogy === "pbl" || pedagogy === "general") {
+    prompt = `You are @content (Educational Content Editor & PBL/General Pedagogy Specialist).
 Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_GENERAL_template.md\` standards for:
 - Lesson Code: ${lessonCode}
 - Title: ${lessonTitle}
@@ -11286,8 +11448,8 @@ type: "LESSON_GENERAL"
 Linkage ledger mapping all satellite artifacts (\`ACT_...\`, \`QUIZ_...\`, \`SLIDE_...\`).
 
 3. Output 100% clean Markdown directly.`;
-  }
-  return `You are @content (Educational Content Editor & 5E Instructional Model Specialist).
+  } else {
+    prompt = `You are @content (Educational Content Editor & 5E Instructional Model Specialist).
 Author the comprehensive Master Lesson Plan adhering strictly to \`LESSON_5E_template.md\` standards for:
 - Lesson Code: ${lessonCode}
 - Title: ${lessonTitle}
@@ -11335,6 +11497,18 @@ Linkage ledger mapping all satellite artifacts (\`GUIDE_...\`, \`SLIDE_...\`, \`
 
 3. Ensure all sample code and syntax are 100% verified and runnable.
 4. Output 100% clean Markdown directly.`;
+  }
+  const langDirective = buildLanguageDirective(targetLanguage);
+  const headingDirective = buildHeadingDirective(
+    pedagogy === "edp" ? "LESSON_EDP" : pedagogy === "general" || pedagogy === "pbl" ? "LESSON_GENERAL" : "LESSON_5E",
+    sectionLanguageContract,
+    targetLanguage
+  );
+  return `${prompt}
+
+${langDirective}${headingDirective ? `
+
+${headingDirective}` : ""}`;
 }
 async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   const {
@@ -11365,6 +11539,20 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   const styleGuide = await storage.readSotDocument(projectId, "CONTENT_STYLE_GUIDE.md") || "";
   const refPack = await storage.readSotDocument(projectId, "REFERENCE_PACK.md") || "";
   await storage.readSotDocument(projectId, "LEARNER_PROFILE.md") || "";
+  const slcMarkdown = options.sectionLanguageContract || await storage.readSotDocument(projectId, "SECTION_LANGUAGE_CONTRACT.md") || "";
+  let targetLang = options.targetLanguage;
+  if (!targetLang) {
+    try {
+      const planRaw = await storage.readArtifact(projectId, "_sot/CURRICULUM_PLAN.json");
+      if (planRaw) {
+        const p = JSON.parse(planRaw);
+        targetLang = p?.translation?.target_language;
+      }
+    } catch {
+    }
+  }
+  targetLang = targetLang || "vi";
+  const languageDirective = buildLanguageDirective(targetLang);
   let expositionContext = "";
   let sessionSliceContext = "";
   try {
@@ -11434,7 +11622,9 @@ Khi n\u1ED9i dung c\u1EA7n minh h\u1ECDa (diagram quy tr\xECnh, s\u01A1 \u0111\u
       lessonTitle,
       concept,
       bloomLevel,
-      dateStr
+      dateStr,
+      targetLang,
+      slcMarkdown
     ) + mediaDirective;
     const rawLesson = await runCurriculumAIInference(
       [{ role: "user", content: lessonPrompt }],
@@ -11775,7 +11965,11 @@ template_required_sections:
      - ### Phase 3: Debugging & Testing
    - ## [REQUIRED] 3-Tier Differentiation (Bronze/Silver/Gold tasks)
    - ## [REQUIRED] Reflection (Discussion question)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("ACT", slcMarkdown, targetLang)}`;
     const rawAct = await runCurriculumAIInference(
       [{ role: "user", content: actPrompt }],
       satelliteContext,
@@ -11847,7 +12041,11 @@ template_required_sections:
    - ## [REQUIRED] Multiple-Choice Question Bank (\u22655 scenario-based 4-option questions with: Question text, A/B/C/D options, Correct answer, Bloom level, Detailed distractor rationale)
    - ## [REQUIRED] Code Analysis / Debugging Question (1 deep code tracing question requiring students to predict output or identify bugs)
    - ## [REQUIRED] Competency Rubric (4-tier matrix: Developing \u2192 Proficient \u2192 Advanced \u2192 Exemplary)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
     const rawQuiz = await runCurriculumAIInference(
       [{ role: "user", content: quizPrompt }],
       satelliteContext,
@@ -11926,7 +12124,11 @@ Mandatory Canvas & Presentation Invariants:
   * COLD CALL / CHECK: Specific diagnostic question to ask students.
   * SCAFFOLDING / GOTCHA: Guidance for students who get stuck.
   * PACING: Recommended minutes for the slide.
-- Output 100% valid Marp Markdown.`;
+- Output 100% valid Marp Markdown.
+
+${languageDirective}
+
+${buildHeadingDirective("SLIDE", slcMarkdown, targetLang)}`;
     const rawSlide = await runCurriculumAIInference(
       [{ role: "user", content: slidePrompt }],
       satelliteContext,
@@ -11993,7 +12195,11 @@ template_contract: "artifact-template-v1"
    - ## [REQUIRED] Facilitation Script & Timeline (Phase-by-phase teacher moves, inquiry questions, transitions)
    - ## [REQUIRED] Common Misconceptions & Diagnostic Remediation Matrix
    - ## [REQUIRED] Differentiated Support Strategies (Support scaffolds vs Extension challenges)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("GUIDE", slcMarkdown, targetLang)}`;
     const rawGuide = await runCurriculumAIInference(
       [{ role: "user", content: guidePrompt }],
       satelliteContext,
@@ -12052,7 +12258,11 @@ template_contract: "artifact-template-v1"
    - ## [REQUIRED] Visual Mental Model / Architecture Diagram (Mermaid or ASCII diagram)
    - ## [REQUIRED] Step-by-Step Practical Quick-Start Guide
    - ## [REQUIRED] Self-Check Diagnostic Checklist (Can-do statements for student self-assessment)
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("HANDOUT", slcMarkdown, targetLang)}`;
     const rawHandout = await runCurriculumAIInference(
       [{ role: "user", content: handoutPrompt }],
       satelliteContext,
@@ -12115,7 +12325,11 @@ template_contract: "artifact-template-v1"
    - ## [REQUIRED] Part 3: Code Analysis & Bug Hunting Challenge
    - ## [REQUIRED] Part 4: Synthesis & Problem-Solving Application
    - ## [REQUIRED] Part 5: Self-Reflection & Learning Log
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("WKS", slcMarkdown, targetLang)}`;
     const rawWks = await runCurriculumAIInference(
       [{ role: "user", content: wksPrompt }],
       satelliteContext,
@@ -12182,7 +12396,11 @@ template_required_sections:
    - ## [REQUIRED] Verified Reference Solution Code (100% syntactically valid, production-ready, fully commented)
    - ## [REQUIRED] Automated Test / Verification Script (How to compile, flash, or unit test)
    - ## [REQUIRED] Common Syntax & Runtime Pitfalls Matrix
-3. Output 100% clean Markdown directly with runnable code snippets \u2014 NO outer code fences around the document.`;
+3. Output 100% clean Markdown directly with runnable code snippets \u2014 NO outer code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("CODE", slcMarkdown, targetLang)}`;
     const rawCode = await runCurriculumAIInference(
       [{ role: "user", content: codePrompt }],
       satelliteContext,
@@ -12248,7 +12466,11 @@ template_contract: "artifact-template-v1"
    - ### Challenge 2: [Name] (Difficulty: \u2B50\u2B50\u2B50\u2B50) \u2014 Advanced Architectural Constraints & Edge Cases
    - ### Challenge 3: [Name] (Difficulty: \u2B50\u2B50\u2B50\u2B50\u2B50) \u2014 Extension Milestones (Level 1: Ninja \u2192 Level 2: Guru \u2192 Level 3: Master)
    - ## [REQUIRED] Metacognitive Deep Dive & Engineering Trade-offs
-3. Output 100% clean Markdown directly \u2014 NO code fences around the document.`;
+3. Output 100% clean Markdown directly \u2014 NO code fences around the document.
+
+${languageDirective}
+
+${buildHeadingDirective("EXT", slcMarkdown, targetLang)}`;
     const rawExt = await runCurriculumAIInference(
       [{ role: "user", content: extPrompt }],
       satelliteContext,
@@ -16692,6 +16914,6 @@ function renderMediaPlaceholder(entry) {
   return `> \u{1F5BC}\uFE0F [\u1EA2nh \u0111ang ch\u1EDD: ${entry.name} \u2014 s\u1EBD \u0111\u01B0\u1EE3c t\u1EA1o sau khi duy\u1EC7t media]`;
 }
 
-export { ACT_TEMPLATE, ARTIFACT_EXECUTION_ORDER, AcademicAuditor, ActiveLearningWorkflowSchema, ActivityLabSchema, ActivitySeqRowSchema, ActivityStepSchema, ArtifactContractRowSchema, AssessmentMapRowSchema, AssessmentObjectiveSchema, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BUNDLED_STANDARDS_PACK_IDS, BellRingerDaySchema, BellRingerSchema, BloomHintSchema, BloomLevelSchema, BloomTaxonomyEvaluator, BronzeTierSchema, CERConclusionSchema, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CardTierEnum, ChoiceBoardRubricRowSchema, ChoiceBoardSchema, ChoiceRuleSchema, ChoiceSquareSchema, ClassificationSchema, CodeHardwareFeasibilityEvaluator, CodeLabSchema, CodeSnippetSchema, CompetencyRubricRowSchema, ComputationalThinkingSchema, ConstructiveAlignmentEvaluator, CoreConceptSchema, CourseObjectiveSchema, CoverageReportSchema, CrossArtifactDriftEvaluator, CurriculumArtifactSchema, CurriculumError, CurriculumPlanSchema, CurriculumQualityReportSchema, DEFAULT_ARTIFACT_STREAM_IDLE_MS, DEFAULT_ARTIFACT_STREAM_TOTAL_MS, DEFAULT_ENABLED_PROVIDERS, DEFAULT_GATE_SETTINGS, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdgeSchema, DepthAssignmentSchema, DepthLevelSchema, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuestionSchema, DiagnosticQuizSchema, EDPPhaseEnum, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, EntryLevelSchema, ExitTicketBugHuntSchema, ExitTicketMetacognitionSchema, ExitTicketQuickItemSchema, ExitTicketRecallPromptSchema, ExitTicketSchema, ExperimentalDesignSchema, ExpositionApprovalError, ExtensionChallengeSchema, ExtensionSchema, FileSystemCurriculumAdapter, FiveEFlowPhaseSchema, FiveEInstructionalEvaluator, FiveEPhaseEnum, FrameworkMappingSchema, FrameworkPackManifestSchema, FrameworkPackSchema, FrameworkStatementSchema, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, GlossaryQuickRefRowSchema, GlossarySchema, GlossaryTermSchema, GoldTierSchema, GradeBandSchema, GraphicOrganizerItemSchema, GraphicOrganizerSchema, HANDOUT_TEMPLATE, HandoutSchema, HandoutSectionSchema, InstructionSectionSchema, InstructionStepSchema, JudgeCriterionSchema, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, LLMJudgeEngine, LabTierTaskSchema, LearningObjectiveInputSchema, LearningObjectiveRowSchema, LessonFlowPhaseSchema, LessonPlan5ESchema, LessonPlanEDPSchema, LessonPlanSchema, LessonSectionSchema, LocalWorkspaceManager, MappingKindSchema, MarpSlideSchema, MediaError, MediaLedger, MentorCheatsheetSchema, MilestoneInputSchema, MisconceptionEvaluator, MisconceptionSchema, ModelPolicyResolver, NVIDIA_MODELS, NodeKindSchema, OrganizerTypeEnum, PROJECT_INSTRUCTION_TEMPLATE, PhaseInputSchema, PlanConstraintsSchema, PlannerInputSchema, PlanningGraphSchema, PlanningNodeSchema, PrerequisiteDecisionEntrySchema, PrerequisiteDecisionSchema, ProductGoalSchema, ProgressiveHintsSchema, ProjectGraphSchema, ProjectInstructionSchema, ProjectProfileSchema, QUIZ_TEMPLATE, QualityAuditVerdictSchema, QuizOptionSchema, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, RecordProvenanceSchema, ResourceMapRowSchema, ReviewGameExportRowSchema, ReviewGameQuestionSchema, ReviewGameSchema, RoadmapInputSchema, RotationStationSchema, RubricCriteriaSchema, RubricSchema, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STANDARD_SOT_FILES, STATION_ROTATION_TEMPLATE, ScaffoldDecisionEntrySchema, ScaffoldDecisionSchema, ScienceLabSchema, ScoringRubricRowSchema, SelfLabSchema, SelfPacedBundleSchema, SelfPacedChallengeSchema, SessionPlanSchema, SilverTierSchema, SlideDeckSchema, StandardizedTermRowSchema, StandardsRegistryAdapter, StationRecordRowSchema, StationRotationSchema, StationTypeEnum, SupabaseCurriculumAdapter, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TaskCardSchema, TaskCardsSchema, TeacherGuideSchema, TeachingScriptPhaseSchema, TierLevelEnum, TierObjectiveSchema, TieredPracticeSchema, TranslationPolicySchema, TroubleshootingEntrySchema, TroubleshootingRowSchema, UnitPlanSchema, UserJourneySchema, WORKSHEET_TEMPLATE, WorksheetItemSchema, WorksheetItemTypeEnum, WorksheetPartSchema, WorksheetSchema, activityTools, analystTools, analyzeProjectCreationIntent, assertAcyclic, assessorTools, auditCurriculumQualityFlow, auditQualityReport, buildActivityPrompt, buildCodeLabPrompt, buildCurriculumContext, buildCurriculumPlan, buildDeliveryPackages, buildDiagnosticQuizPrompt, buildExpositionContext, buildExtensionPrompt, buildHandoutPrompt, buildImagePrompt, buildJudgePrompt, buildLessonMasterPrompt, buildProjectInstructionPrompt, buildSelfLabPrompt, buildSessionSliceContext, buildSlidesPrompt, buildStandardStackMarkdown, buildStandardsContext, buildStandardsContextBlock, buildTeacherGuidePrompt, buildWorksheetPrompt, closeTruncatedJson, computeContentHash, computePackingSpec, conductPreliminaryResearch, contentTools, convertRoadmapToFoundationSot, createAiInferenceError, createCurriculumStorage, createIdleAbortController, createStreamAbortController, createStreamAbortSignal, createStreamChunkExtractor, curateMediaLedger, designerTools, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, evaluateStandardsCoverage, executeCurriculumCommand, exportAllProjectQuizzes, expositionCacheKey, extractScopeSequenceRows, extractSessionSlice, extractStreamChunk, extractThoughtAndContent, formatQuizzesToCsv, fulfillMediaLedger, gateModeFor, generateActivityFlow, generateCodeLabFlow, generateDiagnosticQuizFlow, generateEducationalImage, generateExtensionFlow, generateHandoutFlow, generateLessonMasterFlow, generateMilestoneCurriculumBundle, generatePhase1SotArtifacts, generatePhase2SotArtifacts, generateProjectInstruction, generateProjectInstructionFlow, generateRoadmapCurriculum, generateSelfLabFlow, generateSelfPacedBundle, generateSingleArtifact, generateSlidesFlow, generateTeacherGuideFlow, generateWorksheetFlow, getAIModel, getArtifactMetadata, getDesignatedFallbackChain, getDesignatedFallbackConfig, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, illustratorTools, importRoadmapToProject, ingestProjectGraphIntoProject, initializeProjectInStorage, injectMediaIntoMarkdown, isExpositionFresh, isModelAllowed, isProviderEnabled, isTranslationDue, lintAndSanitizeArtifact, lintCurriculumFramework, lintFrameworkPack, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, packagerTools, parseGateSettings, parseQuizMarkdown, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, publishToGitHub, publishToSupabase, rankGenCandidates, renderFrameworkFromPlan, renderMediaPlaceholder, researcherTools, resolveGateSettings, resolveStandardsPacks, resolveStreamBudget, resolveTranslationTargets, reviewerTools, runCurriculumAIInference, safeParseJson, searchEducationalImages, searchEducationalVideos, selectStatementsForLesson, serializeActivityToMarkdown, serializeCodeLabToMarkdown, serializeDiagnosticQuizToMarkdown, serializeHandoutToMarkdown, serializeLessonToMarkdown, serializeProjectInstructionToMarkdown, serializeSelfLabToMarkdown, slugifyProjectName, streamCurriculumAIInference, streamCurriculumAIInferenceWithTools, streamDiagnosticQuizFlow, streamLLMWithFallback, streamLayerPrefillWithFallback, streamLessonMasterFlow, streamSelfLabFlow, stripLlmJsonWrappers, techSmeTools, topoSort, uploadAssetToBucket, validateCurriculumPlan, validateFrameworkPack, validateMarkdownTables, validateMermaidSyntax, withAutoRepair };
+export { ACT_TEMPLATE, ARTIFACT_EXECUTION_ORDER, AcademicAuditor, ActiveLearningWorkflowSchema, ActivityLabSchema, ActivitySeqRowSchema, ActivityStepSchema, ArtifactContractRowSchema, AssessmentMapRowSchema, AssessmentObjectiveSchema, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BUNDLED_STANDARDS_PACK_IDS, BellRingerDaySchema, BellRingerSchema, BloomHintSchema, BloomLevelSchema, BloomTaxonomyEvaluator, BronzeTierSchema, CERConclusionSchema, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CardTierEnum, ChoiceBoardRubricRowSchema, ChoiceBoardSchema, ChoiceRuleSchema, ChoiceSquareSchema, ClassificationSchema, CodeHardwareFeasibilityEvaluator, CodeLabSchema, CodeSnippetSchema, CompetencyRubricRowSchema, ComputationalThinkingSchema, ConstructiveAlignmentEvaluator, CoreConceptSchema, CourseObjectiveSchema, CoverageReportSchema, CrossArtifactDriftEvaluator, CurriculumArtifactSchema, CurriculumError, CurriculumPlanSchema, CurriculumQualityReportSchema, DEFAULT_ARTIFACT_STREAM_IDLE_MS, DEFAULT_ARTIFACT_STREAM_TOTAL_MS, DEFAULT_ENABLED_PROVIDERS, DEFAULT_GATE_SETTINGS, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdgeSchema, DepthAssignmentSchema, DepthLevelSchema, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuestionSchema, DiagnosticQuizSchema, EDPPhaseEnum, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, EntryLevelSchema, ExitTicketBugHuntSchema, ExitTicketMetacognitionSchema, ExitTicketQuickItemSchema, ExitTicketRecallPromptSchema, ExitTicketSchema, ExperimentalDesignSchema, ExpositionApprovalError, ExtensionChallengeSchema, ExtensionSchema, FileSystemCurriculumAdapter, FiveEFlowPhaseSchema, FiveEInstructionalEvaluator, FiveEPhaseEnum, FrameworkMappingSchema, FrameworkPackManifestSchema, FrameworkPackSchema, FrameworkStatementSchema, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, GlossaryQuickRefRowSchema, GlossarySchema, GlossaryTermSchema, GoldTierSchema, GradeBandSchema, GraphicOrganizerItemSchema, GraphicOrganizerSchema, HANDOUT_TEMPLATE, HandoutSchema, HandoutSectionSchema, InstructionSectionSchema, InstructionStepSchema, JudgeCriterionSchema, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, LLMJudgeEngine, LabTierTaskSchema, LearningObjectiveInputSchema, LearningObjectiveRowSchema, LessonFlowPhaseSchema, LessonPlan5ESchema, LessonPlanEDPSchema, LessonPlanSchema, LessonSectionSchema, LocalWorkspaceManager, MappingKindSchema, MarpSlideSchema, MediaError, MediaLedger, MentorCheatsheetSchema, MilestoneInputSchema, MisconceptionEvaluator, MisconceptionSchema, ModelPolicyResolver, NVIDIA_MODELS, NodeKindSchema, OrganizerTypeEnum, PROJECT_INSTRUCTION_TEMPLATE, PhaseInputSchema, PlanConstraintsSchema, PlannerInputSchema, PlanningGraphSchema, PlanningNodeSchema, PrerequisiteDecisionEntrySchema, PrerequisiteDecisionSchema, ProductGoalSchema, ProgressiveHintsSchema, ProjectGraphSchema, ProjectInstructionSchema, ProjectProfileSchema, QUIZ_TEMPLATE, QualityAuditVerdictSchema, QuizOptionSchema, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, RecordProvenanceSchema, ResourceMapRowSchema, ReviewGameExportRowSchema, ReviewGameQuestionSchema, ReviewGameSchema, RoadmapInputSchema, RotationStationSchema, RubricCriteriaSchema, RubricSchema, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STANDARD_SOT_FILES, STATION_ROTATION_TEMPLATE, ScaffoldDecisionEntrySchema, ScaffoldDecisionSchema, ScienceLabSchema, ScoringRubricRowSchema, SelfLabSchema, SelfPacedBundleSchema, SelfPacedChallengeSchema, SessionPlanSchema, SilverTierSchema, SlideDeckSchema, StandardizedTermRowSchema, StandardsRegistryAdapter, StationRecordRowSchema, StationRotationSchema, StationTypeEnum, SupabaseCurriculumAdapter, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TaskCardSchema, TaskCardsSchema, TeacherGuideSchema, TeachingScriptPhaseSchema, TierLevelEnum, TierObjectiveSchema, TieredPracticeSchema, TranslationPolicySchema, TroubleshootingEntrySchema, TroubleshootingRowSchema, UnitPlanSchema, UserJourneySchema, WORKSHEET_TEMPLATE, WorksheetItemSchema, WorksheetItemTypeEnum, WorksheetPartSchema, WorksheetSchema, activityTools, analystTools, analyzeProjectCreationIntent, assertAcyclic, assessorTools, auditCurriculumQualityFlow, auditQualityReport, buildActivityPrompt, buildCodeLabPrompt, buildCurriculumContext, buildCurriculumPlan, buildDeliveryPackages, buildDiagnosticQuizPrompt, buildExpositionContext, buildExtensionPrompt, buildHandoutPrompt, buildHeadingDirective, buildImagePrompt, buildJudgePrompt, buildLanguageDirective, buildLessonMasterPrompt, buildProjectInstructionPrompt, buildSelfLabPrompt, buildSessionSliceContext, buildSlidesPrompt, buildStandardStackMarkdown, buildStandardsContext, buildStandardsContextBlock, buildTeacherGuidePrompt, buildWorksheetPrompt, closeTruncatedJson, computeContentHash, computePackingSpec, conductPreliminaryResearch, contentTools, convertRoadmapToFoundationSot, createAiInferenceError, createCurriculumStorage, createIdleAbortController, createStreamAbortController, createStreamAbortSignal, createStreamChunkExtractor, curateMediaLedger, designerTools, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, evaluateStandardsCoverage, executeCurriculumCommand, exportAllProjectQuizzes, expositionCacheKey, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStreamChunk, extractThoughtAndContent, formatQuizzesToCsv, fulfillMediaLedger, gateModeFor, generateActivityFlow, generateCodeLabFlow, generateDiagnosticQuizFlow, generateEducationalImage, generateExtensionFlow, generateHandoutFlow, generateLessonMasterFlow, generateMilestoneCurriculumBundle, generatePhase1SotArtifacts, generatePhase2SotArtifacts, generateProjectInstruction, generateProjectInstructionFlow, generateRoadmapCurriculum, generateSelfLabFlow, generateSelfPacedBundle, generateSingleArtifact, generateSlidesFlow, generateTeacherGuideFlow, generateWorksheetFlow, getAIModel, getArtifactMetadata, getDesignatedFallbackChain, getDesignatedFallbackConfig, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, illustratorTools, importRoadmapToProject, ingestProjectGraphIntoProject, initializeProjectInStorage, injectMediaIntoMarkdown, isExpositionFresh, isModelAllowed, isProviderEnabled, isTranslationDue, lintAndSanitizeArtifact, lintCurriculumFramework, lintFrameworkPack, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, packagerTools, parseGateSettings, parseQuizMarkdown, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, publishToGitHub, publishToSupabase, rankGenCandidates, renderFrameworkFromPlan, renderMediaPlaceholder, researcherTools, resolveGateSettings, resolveStandardsPacks, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, reviewerTools, runCurriculumAIInference, safeParseJson, searchEducationalImages, searchEducationalVideos, selectStatementsForLesson, serializeActivityToMarkdown, serializeCodeLabToMarkdown, serializeDiagnosticQuizToMarkdown, serializeHandoutToMarkdown, serializeLessonToMarkdown, serializeProjectInstructionToMarkdown, serializeSelfLabToMarkdown, slugifyProjectName, streamCurriculumAIInference, streamCurriculumAIInferenceWithTools, streamDiagnosticQuizFlow, streamLLMWithFallback, streamLayerPrefillWithFallback, streamLessonMasterFlow, streamSelfLabFlow, stripLlmJsonWrappers, targetLanguageDisplayName, techSmeTools, topoSort, uploadAssetToBucket, validateCurriculumPlan, validateFrameworkPack, validateMarkdownTables, validateMermaidSyntax, withAutoRepair };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map