@thanh01.pmt/curriculum-kit 1.4.18 → 1.4.21

package/dist/{gateSettings-L3FR2-MO.d.cts → gateSettings-DabOqP6_.d.cts}

@@ -1,3 +1,94 @@
+interface DetailedLessonBridge {
+    lessonId: string;
+    lessonIndex: number;
+    title: string;
+    proseObjective?: string;
+    keywords: string[];
+    /** Physical SOT symbol ledger extracted from disk (if physical artifact exists) */
+    symbolLedger?: {
+        primaryStructOrClass?: string;
+        mainEntryFile?: string;
+        keyVariables?: string[];
+    };
+}
+interface BoundaryPeek {
+    lessonId: string;
+    lessonIndex: number;
+    title: string;
+    keywords: string[];
+}
+interface HorizonSessionSnapshot {
+    id: string;
+    order?: number;
+    title: string;
+    prose_objective?: string;
+    new_keywords?: string[];
+    prerequisite_keywords?: string[];
+    depth_assignments?: Array<{
+        node_id: string;
+        depth: 'ulo' | 'cio' | 'sio';
+    }>;
+}
+interface CurriculumHorizon {
+    targetLessonId: string;
+    targetLessonIndex: number;
+    totalLessons: number;
+    targetTitle: string;
+    targetKeywords: string[];
+    /**
+     * TIER 2: Compact Mastery Set (L_1 .. L_{N-3})
+     * Flat deduplicated keyword and concept sets without per-lesson overhead.
+     * Target footprint: ~50-100 tokens.
+     */
+    compactMasterySet: {
+        masteredKeywords: string[];
+        masteredConcepts: string[];
+    };
+    /**
+     * TIER 1: Detailed Bridge (L_{N-2} and L_{N-1})
+     * Full lesson metadata and physical symbol ledger.
+     * Target footprint: ~120-200 tokens.
+     */
+    detailedBridge: DetailedLessonBridge[];
+    /**
+     * BOUNDARY PEEK: L_{N+1} (and optionally L_{N+2})
+     * Upcoming lesson concepts used for positive-only boundary enforcement.
+     * Target footprint: ~30-50 tokens.
+     */
+    boundaryPeek: BoundaryPeek[];
+}
+interface ExtractCurriculumHorizonOptions {
+    plan?: any | null;
+    frameworkMarkdown?: string | null;
+    targetLessonId: string;
+    storage?: any;
+    projectId?: string;
+}
+interface HorizonValidationResult {
+    compliant: boolean;
+    issues: string[];
+    forbiddenMatches: string[];
+}
+/**
+ * Parses all sessions deterministically from either CurriculumPlan JSON or CURRICULUM_FRAMEWORK.md Scope & Sequence.
+ */
+declare function parseAllSessions(plan?: any | null, frameworkMarkdown?: string | null): HorizonSessionSnapshot[];
+/**
+ * Extracts the 3-Tier Curriculum Horizon for a target lesson.
+ * Enforces fail-fast if the target lesson cannot be resolved from the SOT plan or framework.
+ */
+declare function extractCurriculumHorizon(opts: ExtractCurriculumHorizonOptions): Promise<CurriculumHorizon>;
+/**
+ * Serializes the CurriculumHorizon into a token-efficient (~200-350 tokens)
+ * Positive-Only Markdown prompt block.
+ */
+declare function renderHorizonPromptBlock(horizon: CurriculumHorizon): string;
+/**
+ * Validates whether an artifact output adheres to the Curriculum Horizon boundary
+ * (detects accidental future concept leaks).
+ */
+declare function validateHorizonCompliance(artifactContent: string, horizon: CurriculumHorizon): HorizonValidationResult;
+
 type ArtifactType = 'lesson' | 'slide' | 'act' | 'quiz' | 'guide' | 'handout' | 'worksheet' | 'rubric' | 'ext' | 'glossary' | 'codelab' | 'bom' | 'exit_ticket' | 'tiered_practice' | 'choice_board' | 'science_lab' | 'task_cards' | 'station_rotation' | 'bell_ringer' | 'review_game' | 'graphic_organizer';
 type ScaffoldingLevel = 'foundation' | 'balanced' | 'advanced';
 interface SingleArtifactRequest {
@@ -23,6 +114,8 @@ interface SingleArtifactRequest {
         lessonPlan?: string;
         handout?: string;
         exposition?: string;
+        plan?: any;
+        horizon?: CurriculumHorizon;
     };
     /**
      * Media Ledger policy (nếu có): agent chèn placeholder [IMAGE: slug], Curator duyệt,
@@ -120,4 +213,4 @@ declare function resolveGateSettings(raw?: unknown): ResolvedGateSettings;
 /** Mode đã resolve cho 1 artifact type. */
 declare function gateModeFor(resolved: ResolvedGateSettings, type: CurriculumArtifactType): CurriculumGateMode;
 
-export { type ArtifactType as A, type CurriculumGateMode as C, DEFAULT_GATE_SETTINGS as D, type GateSettings as G, type ResolvedGateSettings as R, type SingleArtifactRequest as S, type SingleArtifactResult as a, type CurriculumArtifactType as b, type ScaffoldingLevel as c, getArtifactMetadata as d, generateSingleArtifact as e, gateModeFor as g, parseGateSettings as p, resolveGateSettings as r };
+export { type ArtifactType as A, type BoundaryPeek as B, type CurriculumGateMode as C, DEFAULT_GATE_SETTINGS as D, type ExtractCurriculumHorizonOptions as E, type GateSettings as G, type HorizonSessionSnapshot as H, type ResolvedGateSettings as R, type SingleArtifactRequest as S, type SingleArtifactResult as a, type CurriculumArtifactType as b, type ScaffoldingLevel as c, getArtifactMetadata as d, generateSingleArtifact as e, type DetailedLessonBridge as f, gateModeFor as g, type CurriculumHorizon as h, type HorizonValidationResult as i, parseAllSessions as j, extractCurriculumHorizon as k, renderHorizonPromptBlock as l, parseGateSettings as p, resolveGateSettings as r, validateHorizonCompliance as v };

package/dist/{gateSettings-L3FR2-MO.d.ts → gateSettings-DabOqP6_.d.ts}

@@ -1,3 +1,94 @@
+interface DetailedLessonBridge {
+    lessonId: string;
+    lessonIndex: number;
+    title: string;
+    proseObjective?: string;
+    keywords: string[];
+    /** Physical SOT symbol ledger extracted from disk (if physical artifact exists) */
+    symbolLedger?: {
+        primaryStructOrClass?: string;
+        mainEntryFile?: string;
+        keyVariables?: string[];
+    };
+}
+interface BoundaryPeek {
+    lessonId: string;
+    lessonIndex: number;
+    title: string;
+    keywords: string[];
+}
+interface HorizonSessionSnapshot {
+    id: string;
+    order?: number;
+    title: string;
+    prose_objective?: string;
+    new_keywords?: string[];
+    prerequisite_keywords?: string[];
+    depth_assignments?: Array<{
+        node_id: string;
+        depth: 'ulo' | 'cio' | 'sio';
+    }>;
+}
+interface CurriculumHorizon {
+    targetLessonId: string;
+    targetLessonIndex: number;
+    totalLessons: number;
+    targetTitle: string;
+    targetKeywords: string[];
+    /**
+     * TIER 2: Compact Mastery Set (L_1 .. L_{N-3})
+     * Flat deduplicated keyword and concept sets without per-lesson overhead.
+     * Target footprint: ~50-100 tokens.
+     */
+    compactMasterySet: {
+        masteredKeywords: string[];
+        masteredConcepts: string[];
+    };
+    /**
+     * TIER 1: Detailed Bridge (L_{N-2} and L_{N-1})
+     * Full lesson metadata and physical symbol ledger.
+     * Target footprint: ~120-200 tokens.
+     */
+    detailedBridge: DetailedLessonBridge[];
+    /**
+     * BOUNDARY PEEK: L_{N+1} (and optionally L_{N+2})
+     * Upcoming lesson concepts used for positive-only boundary enforcement.
+     * Target footprint: ~30-50 tokens.
+     */
+    boundaryPeek: BoundaryPeek[];
+}
+interface ExtractCurriculumHorizonOptions {
+    plan?: any | null;
+    frameworkMarkdown?: string | null;
+    targetLessonId: string;
+    storage?: any;
+    projectId?: string;
+}
+interface HorizonValidationResult {
+    compliant: boolean;
+    issues: string[];
+    forbiddenMatches: string[];
+}
+/**
+ * Parses all sessions deterministically from either CurriculumPlan JSON or CURRICULUM_FRAMEWORK.md Scope & Sequence.
+ */
+declare function parseAllSessions(plan?: any | null, frameworkMarkdown?: string | null): HorizonSessionSnapshot[];
+/**
+ * Extracts the 3-Tier Curriculum Horizon for a target lesson.
+ * Enforces fail-fast if the target lesson cannot be resolved from the SOT plan or framework.
+ */
+declare function extractCurriculumHorizon(opts: ExtractCurriculumHorizonOptions): Promise<CurriculumHorizon>;
+/**
+ * Serializes the CurriculumHorizon into a token-efficient (~200-350 tokens)
+ * Positive-Only Markdown prompt block.
+ */
+declare function renderHorizonPromptBlock(horizon: CurriculumHorizon): string;
+/**
+ * Validates whether an artifact output adheres to the Curriculum Horizon boundary
+ * (detects accidental future concept leaks).
+ */
+declare function validateHorizonCompliance(artifactContent: string, horizon: CurriculumHorizon): HorizonValidationResult;
+
 type ArtifactType = 'lesson' | 'slide' | 'act' | 'quiz' | 'guide' | 'handout' | 'worksheet' | 'rubric' | 'ext' | 'glossary' | 'codelab' | 'bom' | 'exit_ticket' | 'tiered_practice' | 'choice_board' | 'science_lab' | 'task_cards' | 'station_rotation' | 'bell_ringer' | 'review_game' | 'graphic_organizer';
 type ScaffoldingLevel = 'foundation' | 'balanced' | 'advanced';
 interface SingleArtifactRequest {
@@ -23,6 +114,8 @@ interface SingleArtifactRequest {
         lessonPlan?: string;
         handout?: string;
         exposition?: string;
+        plan?: any;
+        horizon?: CurriculumHorizon;
     };
     /**
      * Media Ledger policy (nếu có): agent chèn placeholder [IMAGE: slug], Curator duyệt,
@@ -120,4 +213,4 @@ declare function resolveGateSettings(raw?: unknown): ResolvedGateSettings;
 /** Mode đã resolve cho 1 artifact type. */
 declare function gateModeFor(resolved: ResolvedGateSettings, type: CurriculumArtifactType): CurriculumGateMode;
 
-export { type ArtifactType as A, type CurriculumGateMode as C, DEFAULT_GATE_SETTINGS as D, type GateSettings as G, type ResolvedGateSettings as R, type SingleArtifactRequest as S, type SingleArtifactResult as a, type CurriculumArtifactType as b, type ScaffoldingLevel as c, getArtifactMetadata as d, generateSingleArtifact as e, gateModeFor as g, parseGateSettings as p, resolveGateSettings as r };
+export { type ArtifactType as A, type BoundaryPeek as B, type CurriculumGateMode as C, DEFAULT_GATE_SETTINGS as D, type ExtractCurriculumHorizonOptions as E, type GateSettings as G, type HorizonSessionSnapshot as H, type ResolvedGateSettings as R, type SingleArtifactRequest as S, type SingleArtifactResult as a, type CurriculumArtifactType as b, type ScaffoldingLevel as c, getArtifactMetadata as d, generateSingleArtifact as e, type DetailedLessonBridge as f, gateModeFor as g, type CurriculumHorizon as h, type HorizonValidationResult as i, parseAllSessions as j, extractCurriculumHorizon as k, renderHorizonPromptBlock as l, parseGateSettings as p, resolveGateSettings as r, validateHorizonCompliance as v };