@thanh01.pmt/curriculum-kit 1.3.0 → 1.4.1

package/dist/index.d.cts

@@ -166,12 +166,27 @@ interface ProduceLessonOptions {
     approvedArtifacts?: string[];
     onProgress?: (agent: string, message: string, meta?: any) => void;
 }
+interface ContextInjectionMeta {
+    /** Which canonical source the excerpt came from (e.g. 'KNOWLEDGE_EXPOSITION', 'LESSON'). */
+    source: string;
+    /** True when the builder excerpt passed verify (priority resolution + sufficiency). */
+    verified: boolean;
+    /** True when canonical section resolution contributed to the excerpt. */
+    sectionAware: boolean;
+    /** Structured reasons when verified === false (empty otherwise). */
+    issues: string[];
+}
 interface ProduceLessonResult {
     lessonId: string;
     pedagogy: PedagogicalModel;
     producedArtifacts: string[];
     pausedForReview: boolean;
     gateStatus?: string;
+    /** P43 Cụm 5: observability for context injection — surfaced by every path
+     *  (queue, standalone, batch) so callers can record telemetry / execution
+     *  history without re-parsing. */
+    contextInjection?: ContextInjectionMeta;
+    promptChars?: number;
 }
 /**
  * Detects pedagogical model from SOT (Framework, Style Guide, or Brief)
@@ -587,6 +602,7 @@ declare function ensureExpositionForLesson(storage: ICurriculumStorage, projectI
     relPath: string;
     context: string;
     reused: boolean;
+    rawContent?: string;
 } | null>;
 
 /**
@@ -649,6 +665,12 @@ interface ExcerptOptions {
     sectionLanguageContract?: Record<string, Record<string, string>> | string;
     /** File name or artifact type hint (e.g. 'LESSON', 'KNOWLEDGE_EXPOSITION'). */
     artifactType?: string;
+    /**
+     * Source file name (e.g. `LESSON_U03_M01_L06.md`) — artifact type derived
+     * from it when `artifactType` is not given. Matches the web app's builder
+     * option so both call-sites share one contract.
+     */
+    fileName?: string;
     /** Min chars below which the excerpt is flagged as insufficient (default 400). */
     minContentChars?: number;
 }
@@ -1047,4 +1069,4 @@ declare function getSlideLayoutPresetById(id: string): SlideLayoutPreset | undef
  */
 declare function getSlideLayoutPresetsByCategory(category: SlideLayoutCategory): SlideLayoutPreset[];
 
-export { ACT_TEMPLATE, AIProviderName, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, 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, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, type ContextSourceKey, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdge, type DependencyValidationResult, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExcerptOptions, type ExcerptResult, 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, type ValidationOptions, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonExcerpt, buildSectionAwareExcerpt, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, 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, normalizeSlcContract, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort, validateArtifactDependencies };
+export { ACT_TEMPLATE, AIProviderName, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, 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, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, type ContextInjectionMeta, type ContextSourceKey, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdge, type DependencyValidationResult, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExcerptOptions, type ExcerptResult, 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, type ValidationOptions, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonExcerpt, buildSectionAwareExcerpt, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, 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, normalizeSlcContract, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort, validateArtifactDependencies };

package/dist/index.d.ts

@@ -166,12 +166,27 @@ interface ProduceLessonOptions {
     approvedArtifacts?: string[];
     onProgress?: (agent: string, message: string, meta?: any) => void;
 }
+interface ContextInjectionMeta {
+    /** Which canonical source the excerpt came from (e.g. 'KNOWLEDGE_EXPOSITION', 'LESSON'). */
+    source: string;
+    /** True when the builder excerpt passed verify (priority resolution + sufficiency). */
+    verified: boolean;
+    /** True when canonical section resolution contributed to the excerpt. */
+    sectionAware: boolean;
+    /** Structured reasons when verified === false (empty otherwise). */
+    issues: string[];
+}
 interface ProduceLessonResult {
     lessonId: string;
     pedagogy: PedagogicalModel;
     producedArtifacts: string[];
     pausedForReview: boolean;
     gateStatus?: string;
+    /** P43 Cụm 5: observability for context injection — surfaced by every path
+     *  (queue, standalone, batch) so callers can record telemetry / execution
+     *  history without re-parsing. */
+    contextInjection?: ContextInjectionMeta;
+    promptChars?: number;
 }
 /**
  * Detects pedagogical model from SOT (Framework, Style Guide, or Brief)
@@ -587,6 +602,7 @@ declare function ensureExpositionForLesson(storage: ICurriculumStorage, projectI
     relPath: string;
     context: string;
     reused: boolean;
+    rawContent?: string;
 } | null>;
 
 /**
@@ -649,6 +665,12 @@ interface ExcerptOptions {
     sectionLanguageContract?: Record<string, Record<string, string>> | string;
     /** File name or artifact type hint (e.g. 'LESSON', 'KNOWLEDGE_EXPOSITION'). */
     artifactType?: string;
+    /**
+     * Source file name (e.g. `LESSON_U03_M01_L06.md`) — artifact type derived
+     * from it when `artifactType` is not given. Matches the web app's builder
+     * option so both call-sites share one contract.
+     */
+    fileName?: string;
     /** Min chars below which the excerpt is flagged as insufficient (default 400). */
     minContentChars?: number;
 }
@@ -1047,4 +1069,4 @@ declare function getSlideLayoutPresetById(id: string): SlideLayoutPreset | undef
  */
 declare function getSlideLayoutPresetsByCategory(category: SlideLayoutCategory): SlideLayoutPreset[];
 
-export { ACT_TEMPLATE, AIProviderName, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, 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, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, type ContextSourceKey, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdge, type DependencyValidationResult, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExcerptOptions, type ExcerptResult, 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, type ValidationOptions, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonExcerpt, buildSectionAwareExcerpt, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, 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, normalizeSlcContract, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort, validateArtifactDependencies };
+export { ACT_TEMPLATE, AIProviderName, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, 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, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, type ContextInjectionMeta, type ContextSourceKey, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DependencyEdge, type DependencyValidationResult, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExcerptOptions, type ExcerptResult, 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, type ValidationOptions, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonExcerpt, buildSectionAwareExcerpt, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, 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, normalizeSlcContract, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort, validateArtifactDependencies };

package/dist/index.mjs

@@ -9830,7 +9830,9 @@ function buildSectionAwareExcerpt(markdown, opts = {}) {
     };
   }
   const slcMap = normalizeSlcContract(opts.sectionLanguageContract);
-  const sections = parseMarkdownSections(source, slcMap, opts.artifactType);
+  const effectiveArtifactType = opts.artifactType || deriveArtifactTypeFromFileName(opts.fileName);
+  const sections = parseMarkdownSections(source, slcMap, effectiveArtifactType);
+  const metaBlock = buildMetaBlock(source, effectiveArtifactType);
   if (sections.length === 0) {
     issues.push("parse:no-sections");
     const excerpt2 = truncateByBudget(source, budget);
@@ -9864,12 +9866,13 @@ function buildSectionAwareExcerpt(markdown, opts = {}) {
     const block = `## ${heading}
 
 ${trimmedBody}`;
-    if (used + block.length > budget && blocks.length > 0) return false;
+    if (used + block.length > budget && used > 0) return false;
     blocks.push(block);
     used += block.length;
     includedSections.push(key);
     return true;
   };
+  blocks.push(metaBlock);
   let sectionAware = false;
   for (const key of priorities) {
     const sec = byCanonical.get(key);
@@ -9886,6 +9889,9 @@ ${trimmedBody}`;
     if (used >= budget) break;
     if (!tryAdd(sec.cleanTitle, sec.body, sec.cleanTitle)) break;
   }
+  if (includedSections.length === 0 && unmatched.length > 0) {
+    issues.push("parse:no-canonical-resolution");
+  }
   if (priorities.length > 0 && !priorities.some((k) => includedSections.includes(k))) {
     issues.push("parse:no-priority-resolution");
   }
@@ -9894,14 +9900,14 @@ ${trimmedBody}`;
     excerpt = truncateByBudget(excerpt, budget);
   }
   const effectiveMinChars = Math.min(minContentChars, source.length);
-  if (excerpt.length < effectiveMinChars) {
+  if (excerpt.length - metaBlock.length < effectiveMinChars) {
     issues.push("content:insufficient");
   }
-  const verified = !issues.includes("parse:no-priority-resolution") && excerpt.length >= effectiveMinChars;
+  const verified = !issues.includes("parse:no-priority-resolution") && !issues.includes("parse:no-canonical-resolution") && excerpt.length - metaBlock.length >= effectiveMinChars;
   return {
     excerpt,
     verified,
-    sectionAware: sectionAware || priorities.length === 0 && sections.length > 0,
+    sectionAware: sectionAware || unmatched.length === 0,
     includedSections,
     issues,
     tokenEstimate: Math.round(excerpt.length / 4)
@@ -10017,6 +10023,26 @@ function truncateByBudget(source, budget) {
   if (fenceCount % 2 === 1) cut += "\n```";
   return cut;
 }
+function buildMetaBlock(source, artifactType) {
+  const fm = source.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
+  const pick = (key) => {
+    if (!fm) return "";
+    const m = fm[1].match(new RegExp(`^${key}:\\s*"?([^"\\n]+)"?`, "m"));
+    return (m?.[1] || "").trim();
+  };
+  const id = pick("id");
+  const title = pick("title");
+  const type = pick("type") || artifactType || "";
+  return `<!-- SOURCE: ${type || "ARTIFACT"} | ${id || "unknown"}${title ? ` \u2014 ${title}` : ""} (section-aware excerpt; canonical knowledge, do not contradict) -->`;
+}
+function deriveArtifactTypeFromFileName(fileName) {
+  if (!fileName) return void 0;
+  const base = fileName.replace(/\.md$/i, "");
+  const multiWord = base.match(/^(KNOWLEDGE_EXPOSITION|SECTION_LANGUAGE_CONTRACT|CONTENT_STYLE_GUIDE|CURRICULUM_FRAMEWORK|LEARNER_PROFILE|PROJECT_BRIEF|REFERENCE_PACK|CURRICULUM_PLAN)/i);
+  if (multiWord) return multiWord[1].toUpperCase();
+  const token = base.match(/^([A-Z][A-Z0-9_]*?)(?=_|$)/);
+  return token ? token[1] : void 0;
+}
 
 // src/services/knowledgeExpositionService.ts
 var EXPOSITION_REL = (lessonCode) => "_sot/expositions/" + lessonCode + ".md";
@@ -10165,7 +10191,7 @@ async function ensureExpositionForLesson(storage, projectId, lessonCode, options
     storage,
     gates: options.gates
   });
-  return { relPath: result.relPath, context: buildExpositionContext(result.content), reused: result.reused };
+  return { relPath: result.relPath, context: buildExpositionContext(result.content), reused: result.reused, rawContent: result.content };
 }
 init_errors();
 var asArr = (v) => Array.isArray(v) ? v : [];
@@ -11876,6 +11902,8 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
   targetLang = targetLang || "vi";
   const languageDirective = buildLanguageDirective(targetLang);
   let expositionContext = "";
+  let expositionInjection;
+  let lessonInjection;
   let sessionSliceContext = "";
   try {
     const exposition = await ensureExpositionForLesson(storage, projectId, lessonCode, {
@@ -11883,7 +11911,18 @@ async function produceSingleLesson(storage, projectId, lessonId, options = {}) {
       force: options.force
     });
     if (exposition) {
-      expositionContext = exposition.context;
+      const expoExcerpt = buildExpositionExcerpt(exposition.rawContent || exposition.context, {
+        budget: 6e3,
+        sectionLanguageContract: slcMarkdown,
+        artifactType: "KNOWLEDGE_EXPOSITION"
+      });
+      expositionContext = expoExcerpt.excerpt || exposition.context;
+      expositionInjection = {
+        source: "KNOWLEDGE_EXPOSITION",
+        verified: expoExcerpt.verified,
+        sectionAware: expoExcerpt.sectionAware,
+        issues: expoExcerpt.issues
+      };
       onProgress?.("@content", `[EXPOSITION] ${exposition.reused ? "Reused" : "Generated"} \`\${exposition.relPath}\` (plan-driven knowledge source)...`);
     } else {
       onProgress?.("@content", "[EXPOSITION] No CURRICULUM_PLAN.json \u2014 running legacy knowledge flow (no plan-driven exposition).");
@@ -12123,6 +12162,7 @@ ${yamlBlock.trim()}
       };
       var injectYamlReviewMetadata = injectYamlReviewMetadata2;
       const judgeObjectives = parseLessonObjectives(lessonContent, concept, bloomLevel);
+      const judgeExpositionExcerpt = expositionContext ? buildExpositionExcerpt(expositionContext, { budget: 3e3, sectionLanguageContract: slcMarkdown, artifactType: "KNOWLEDGE_EXPOSITION" }).excerpt : void 0;
       const judgeResult = await LLMJudgeEngine.evaluateArtifactWithLLM({
         targetArtifactType: "LESSON",
         lessonId: lessonCode,
@@ -12134,7 +12174,7 @@ ${yamlBlock.trim()}
           title: lessonTitle,
           frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
           styleGuideExcerpt: effectiveStyleGuide || void 0,
-          canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
+          canonicalExposition: judgeExpositionExcerpt
         }),
         standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
       });
@@ -12189,6 +12229,16 @@ ${currentContent}` }],
               options.onProgress?.("@repair", chunk, { type: type || "content", artifactType: "LESSON" });
             }
           );
+          const repairedExcerptCheck = buildSectionAwareExcerpt(repairedRaw, {
+            priorities: DEFAULT_LESSON_PRIORITIES,
+            budget: 12e3,
+            sectionLanguageContract: slcMarkdown,
+            artifactType: "LESSON"
+          });
+          if (repairedExcerptCheck.issues.includes("parse:no-priority-resolution")) {
+            onProgress?.("@repair", `\u26A0\uFE0F Repair round ${round} lost mandatory section structure (no priority section resolved) \u2014 rejecting repaired draft, retaining previous`);
+            break;
+          }
           if (!repairedRaw || repairedRaw.startsWith("\u26A0\uFE0F") || repairedRaw.length < 200) {
             onProgress?.("@repair", `\u26A0\uFE0F Repair round ${round} produced invalid output \u2014 stopping repair loop`);
             break;
@@ -12213,7 +12263,7 @@ ${currentContent}` }],
               title: lessonTitle,
               frameworkExcerpt: framework ? buildFrameworkExcerptForLesson(framework, lessonId) : void 0,
               styleGuideExcerpt: effectiveStyleGuide || void 0,
-              canonicalExposition: expositionContext ? expositionContext.slice(0, 3e3) : void 0
+              canonicalExposition: expositionContext ? buildExpositionExcerpt(expositionContext, { budget: 3e3, sectionLanguageContract: slcMarkdown, artifactType: "KNOWLEDGE_EXPOSITION" }).excerpt : void 0
             }),
             standardStatements: Object.keys(standardStatements).length > 0 ? standardStatements : void 0
           });
@@ -12271,7 +12321,9 @@ ${currentContent}` }],
             pedagogy,
             producedArtifacts,
             pausedForReview: true,
-            gateStatus: "judge_needs_revision"
+            gateStatus: "judge_needs_revision",
+            contextInjection: expositionInjection || lessonInjection,
+            promptChars: commonContext.length
           };
         }
       }
@@ -12294,7 +12346,9 @@ ${currentContent}` }],
         pedagogy,
         producedArtifacts,
         pausedForReview: true,
-        gateStatus: "judge_error"
+        gateStatus: "judge_error",
+        contextInjection: expositionInjection,
+        promptChars: commonContext.length
       };
     }
   }
@@ -12324,7 +12378,9 @@ ${currentContent}` }],
       pedagogy,
       producedArtifacts,
       pausedForReview: true,
-      gateStatus: "awaiting_approval"
+      gateStatus: "awaiting_approval",
+      contextInjection: expositionInjection,
+      promptChars: commonContext.length
     };
   }
   if (isLessonApproved && currentLessonInfo?.state !== "approved") {
@@ -12341,6 +12397,13 @@ ${currentContent}` }],
     artifactType: "LESSON"
   });
   const lessonExcerpt = lessonExcerptResult.excerpt;
+  const lessonInjectionMeta = {
+    source: "LESSON",
+    verified: lessonExcerptResult.verified,
+    sectionAware: lessonExcerptResult.sectionAware,
+    issues: lessonExcerptResult.issues
+  };
+  lessonInjection = lessonInjectionMeta;
   const satelliteContext = `${commonContext}
 
 [CANONICAL LESSON PLAN (${pedagogyLabel})]:
@@ -12980,7 +13043,9 @@ ${buildHeadingDirective("EXT", slcMarkdown, targetLang)}`;
     lessonId: lessonCode,
     pedagogy,
     producedArtifacts,
-    pausedForReview: false
+    pausedForReview: false,
+    contextInjection: lessonInjection && lessonInjection.verified ? expositionInjection || lessonInjection : lessonInjection || expositionInjection,
+    promptChars: commonContext.length
   };
 }
 function parseLessonObjectives(lessonContent, concept, bloomLevel) {