@thanh01.pmt/curriculum-kit 1.0.13 → 1.0.15

package/dist/standards/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FrameworkPack, f as FrameworkStatement } from '../standardsCoverageGate-BWAkXY76.cjs';
-export { B as BloomHintSchema, C as ClassificationSchema, k as CoverageGateInput, m as CoverageGateReport, g as FrameworkMapping, c as FrameworkMappingSchema, e as FrameworkPackManifest, a as FrameworkPackManifestSchema, d as FrameworkPackSchema, b as FrameworkStatementSchema, G as GradeBandSchema, h as MappingKind, M as MappingKindSchema, P as PackLintIssue, j as PackValidationResult, i as RecordProvenance, R as RecordProvenanceSchema, S as StatementCoverageRow, n as evaluateStandardsCoverage, l as lintFrameworkPack, v as validateFrameworkPack } from '../standardsCoverageGate-BWAkXY76.cjs';
+import { F as FrameworkPack, g as FrameworkStatement } from '../standardsCoverageGate-CsUNzv6C.cjs';
+export { B as BloomHintSchema, a as ClassificationSchema, m as CoverageGateInput, C as CoverageGateReport, h as FrameworkMapping, d as FrameworkMappingSchema, f as FrameworkPackManifest, b as FrameworkPackManifestSchema, e as FrameworkPackSchema, c as FrameworkStatementSchema, G as GradeBandSchema, i as MappingKind, M as MappingKindSchema, P as PackLintIssue, k as PackValidationResult, j as RecordProvenance, R as RecordProvenanceSchema, S as StatementCoverageRow, n as evaluateStandardsCoverage, l as lintFrameworkPack, v as validateFrameworkPack } from '../standardsCoverageGate-CsUNzv6C.cjs';
 import { SupabaseClient } from '@supabase/supabase-js';
 import 'zod';
 

package/dist/standards/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FrameworkPack, f as FrameworkStatement } from '../standardsCoverageGate-BWAkXY76.js';
-export { B as BloomHintSchema, C as ClassificationSchema, k as CoverageGateInput, m as CoverageGateReport, g as FrameworkMapping, c as FrameworkMappingSchema, e as FrameworkPackManifest, a as FrameworkPackManifestSchema, d as FrameworkPackSchema, b as FrameworkStatementSchema, G as GradeBandSchema, h as MappingKind, M as MappingKindSchema, P as PackLintIssue, j as PackValidationResult, i as RecordProvenance, R as RecordProvenanceSchema, S as StatementCoverageRow, n as evaluateStandardsCoverage, l as lintFrameworkPack, v as validateFrameworkPack } from '../standardsCoverageGate-BWAkXY76.js';
+import { F as FrameworkPack, g as FrameworkStatement } from '../standardsCoverageGate-CsUNzv6C.js';
+export { B as BloomHintSchema, a as ClassificationSchema, m as CoverageGateInput, C as CoverageGateReport, h as FrameworkMapping, d as FrameworkMappingSchema, f as FrameworkPackManifest, b as FrameworkPackManifestSchema, e as FrameworkPackSchema, c as FrameworkStatementSchema, G as GradeBandSchema, i as MappingKind, M as MappingKindSchema, P as PackLintIssue, k as PackValidationResult, j as RecordProvenance, R as RecordProvenanceSchema, S as StatementCoverageRow, n as evaluateStandardsCoverage, l as lintFrameworkPack, v as validateFrameworkPack } from '../standardsCoverageGate-CsUNzv6C.js';
 import { SupabaseClient } from '@supabase/supabase-js';
 import 'zod';
 

package/dist/{standardsCoverageGate-BWAkXY76.d.cts → standardsCoverageGate-CsUNzv6C.d.cts}

@@ -764,4 +764,4 @@ interface CoverageGateReport {
 }
 declare function evaluateStandardsCoverage(input: CoverageGateInput): CoverageGateReport;
 
-export { BloomHintSchema as B, ClassificationSchema as C, type FrameworkPack as F, GradeBandSchema as G, MappingKindSchema as M, type PackLintIssue as P, RecordProvenanceSchema as R, type StatementCoverageRow as S, FrameworkPackManifestSchema as a, FrameworkStatementSchema as b, FrameworkMappingSchema as c, FrameworkPackSchema as d, type FrameworkPackManifest as e, type FrameworkStatement as f, type FrameworkMapping as g, type MappingKind as h, type RecordProvenance as i, type PackValidationResult as j, type CoverageGateInput as k, lintFrameworkPack as l, type CoverageGateReport as m, evaluateStandardsCoverage as n, validateFrameworkPack as v };
+export { BloomHintSchema as B, type CoverageGateReport as C, type FrameworkPack as F, GradeBandSchema as G, MappingKindSchema as M, type PackLintIssue as P, RecordProvenanceSchema as R, type StatementCoverageRow as S, ClassificationSchema as a, FrameworkPackManifestSchema as b, FrameworkStatementSchema as c, FrameworkMappingSchema as d, FrameworkPackSchema as e, type FrameworkPackManifest as f, type FrameworkStatement as g, type FrameworkMapping as h, type MappingKind as i, type RecordProvenance as j, type PackValidationResult as k, lintFrameworkPack as l, type CoverageGateInput as m, evaluateStandardsCoverage as n, validateFrameworkPack as v };

package/dist/{standardsCoverageGate-BWAkXY76.d.ts → standardsCoverageGate-CsUNzv6C.d.ts}

@@ -764,4 +764,4 @@ interface CoverageGateReport {
 }
 declare function evaluateStandardsCoverage(input: CoverageGateInput): CoverageGateReport;
 
-export { BloomHintSchema as B, ClassificationSchema as C, type FrameworkPack as F, GradeBandSchema as G, MappingKindSchema as M, type PackLintIssue as P, RecordProvenanceSchema as R, type StatementCoverageRow as S, FrameworkPackManifestSchema as a, FrameworkStatementSchema as b, FrameworkMappingSchema as c, FrameworkPackSchema as d, type FrameworkPackManifest as e, type FrameworkStatement as f, type FrameworkMapping as g, type MappingKind as h, type RecordProvenance as i, type PackValidationResult as j, type CoverageGateInput as k, lintFrameworkPack as l, type CoverageGateReport as m, evaluateStandardsCoverage as n, validateFrameworkPack as v };
+export { BloomHintSchema as B, type CoverageGateReport as C, type FrameworkPack as F, GradeBandSchema as G, MappingKindSchema as M, type PackLintIssue as P, RecordProvenanceSchema as R, type StatementCoverageRow as S, ClassificationSchema as a, FrameworkPackManifestSchema as b, FrameworkStatementSchema as c, FrameworkMappingSchema as d, FrameworkPackSchema as e, type FrameworkPackManifest as f, type FrameworkStatement as g, type FrameworkMapping as h, type MappingKind as i, type RecordProvenance as j, type PackValidationResult as k, lintFrameworkPack as l, type CoverageGateInput as m, evaluateStandardsCoverage as n, validateFrameworkPack as v };

package/dist/workflow/index.d.cts

@@ -1,8 +1,299 @@
-export { I as ApprovalPayload, y as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, M as ExecuteWithRateLimitOptions, z as GateSettings, G as GenerateMasterLessonStepInput, T as GenerateRoadmapWorkflowInput, J as JudgeMasterLessonStepInput, q as JudgeSatelliteStepInput, O as MilestoneWorkflowInput, P as MilestoneWorkflowResult, e as RepairMasterLessonStepInput, R as ResolvedGateSettings, U as RoadmapWorkflowSummary, t as SaveMilestoneArtifactsInput, u as SavedMilestoneResult, L as approvalHookToken, H as approvalPayloadSchema, W as executeSingleArtifactStep, F as gateModeFor, f as generateActivityStep, h as generateCodeLabStep, k as generateDiagnosticQuizStep, p as generateExtensionStep, m as generateHandoutStep, d as generateMasterLessonStep, Q as generateMilestoneWorkflow, V as generateRoadmapWorkflow, i as generateSelfLabStep, X as generateSingleArtifactWorkflow, l as generateSlidesStep, o as generateTeacherGuideStep, n as generateWorksheetStep, j as judgeMasterLessonStep, s as judgeSatelliteStep, K as lessonApprovalHook, B as parseGateSettings, w as publishToGitStep, x as publishToSupabaseStep, r as repairMasterLessonStep, E as resolveGateSettings, v as saveMilestoneToWorkspaceStep, N as withRateLimitBackoff } from '../index-DhxvfPoW.cjs';
-import '../schemas/index.cjs';
-import 'zod';
-import '../provider-factory-DxzOVEmh.cjs';
+import { MilestoneInput, LessonPlan, CurriculumQualityReport, ActivityLab, CodeLab, SelfLab, DiagnosticQuiz, SlideDeck, Handout, Worksheet, TeacherGuide, Extension, ProjectRoadmap } from '../schemas/index.cjs';
+import { M as ModelResolutionOptions } from '../provider-factory-DxzOVEmh.cjs';
+import { G as GitPublishOptions, a as GitPublishResult, S as SupabasePublishOptions, b as SupabasePublishResult } from '../supabasePublisher-C627qXFT.cjs';
+import { S as SingleArtifactRequest, a as SingleArtifactResult } from '../gateSettings-DKXRztJy.cjs';
+export { b as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, G as GateSettings, R as ResolvedGateSettings, g as gateModeFor, p as parseGateSettings, r as resolveGateSettings } from '../gateSettings-DKXRztJy.cjs';
+import * as workflow from 'workflow';
+import { z } from 'zod';
+import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-CsUNzv6C.cjs';
 import 'ai';
-import '../supabasePublisher-C627qXFT.cjs';
-import 'workflow';
-import '../standardsCoverageGate-BWAkXY76.cjs';
+
+interface GenerateMasterLessonStepInput {
+    milestone: MilestoneInput;
+    language: string;
+    topic?: string;
+    targetAudience?: string;
+    contextContinuity?: string;
+    /** Pre-rendered STANDARDS CONTEXT block (verbatim standard statements). */
+    standardsContext?: string;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateMasterLessonStep(input: GenerateMasterLessonStepInput): Promise<LessonPlan>;
+interface JudgeMasterLessonStepInput {
+    lessonId: string;
+    lesson: LessonPlan;
+    language: string;
+    targetObjectives: Array<{
+        code: string;
+        description: string;
+        bloomLevel: string;
+    }>;
+    /** Verbatim standard statements (canonical ID -> text) for the Standards Alignment judge dimension. */
+    standardStatements?: Record<string, string>;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function judgeMasterLessonStep(input: JudgeMasterLessonStepInput): Promise<CurriculumQualityReport>;
+interface RepairMasterLessonStepInput {
+    milestone: MilestoneInput;
+    language: string;
+    topic?: string;
+    targetAudience?: string;
+    auditReport: CurriculumQualityReport;
+    /** Pre-rendered STANDARDS CONTEXT block — kept across repair so grounding is never lost. */
+    standardsContext?: string;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function repairMasterLessonStep(input: RepairMasterLessonStepInput): Promise<LessonPlan>;
+
+declare function generateActivityStep(options: {
+    lesson: LessonPlan;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<ActivityLab>;
+declare function generateCodeLabStep(options: {
+    lesson: LessonPlan;
+    activity: ActivityLab;
+    language: string;
+    targetTechStack?: string[];
+    modelOptions?: ModelResolutionOptions;
+}): Promise<CodeLab>;
+declare function generateSelfLabStep(options: {
+    milestone: MilestoneInput;
+    language: string;
+    targetTechStack?: string[];
+    modelOptions?: ModelResolutionOptions;
+}): Promise<SelfLab>;
+declare function generateDiagnosticQuizStep(options: {
+    milestone: MilestoneInput;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<DiagnosticQuiz>;
+declare function generateSlidesStep(options: {
+    lesson: LessonPlan;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<SlideDeck>;
+declare function generateHandoutStep(options: {
+    lesson: LessonPlan;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<Handout>;
+declare function generateWorksheetStep(options: {
+    lesson: LessonPlan;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<Worksheet>;
+declare function generateTeacherGuideStep(options: {
+    lesson: LessonPlan;
+    activity: ActivityLab;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<TeacherGuide>;
+declare function generateExtensionStep(options: {
+    lesson: LessonPlan;
+    activity: ActivityLab;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<Extension>;
+
+interface JudgeSatelliteStepInput {
+    artifactType: string;
+    artifactId: string;
+    artifact: unknown;
+    language: string;
+    targetObjectives: Array<{
+        code: string;
+        description: string;
+        bloomLevel: string;
+    }>;
+    standardStatements?: Record<string, string>;
+    modelOptions?: ModelResolutionOptions;
+}
+/**
+ * Gate step for satellite artifacts (LLM_JUDGE mode).
+ * Judges any artifact JSON against the same 6-dimension rubric; returns the report.
+ * The workflow decides what to do with the verdict (log / block / store) — gate config stays the single source of truth.
+ */
+declare function judgeSatelliteStep(input: JudgeSatelliteStepInput): Promise<CurriculumQualityReport>;
+
+interface SaveMilestoneArtifactsInput {
+    jobId: string;
+    milestoneSlug: string;
+    lesson: LessonPlan;
+    activity?: ActivityLab;
+    codeLab?: CodeLab;
+    selfLab?: SelfLab;
+    quiz?: DiagnosticQuiz;
+    slides?: SlideDeck;
+    handout?: Handout;
+    worksheet?: Worksheet;
+    teacherGuide?: TeacherGuide;
+    extension?: Extension;
+    cheatSheetMarkdown?: string;
+    baseWorkspaceDir?: string;
+}
+interface SavedMilestoneResult {
+    milestoneSlug: string;
+    savedFiles: string[];
+}
+declare function saveMilestoneToWorkspaceStep(input: SaveMilestoneArtifactsInput): Promise<SavedMilestoneResult>;
+declare function publishToGitStep(options: GitPublishOptions): Promise<GitPublishResult>;
+declare function publishToSupabaseStep(options: SupabasePublishOptions): Promise<SupabasePublishResult>;
+
+/**
+ * Payload human gửi khi duyệt / từ chối một artifact tại chốt HITL.
+ */
+declare const approvalPayloadSchema: z.ZodObject<{
+    approved: z.ZodBoolean;
+    reviewerName: z.ZodOptional<z.ZodString>;
+    feedback: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    approved: boolean;
+    timestamp?: string | undefined;
+    feedback?: string | undefined;
+    reviewerName?: string | undefined;
+}, {
+    approved: boolean;
+    timestamp?: string | undefined;
+    feedback?: string | undefined;
+    reviewerName?: string | undefined;
+}>;
+type ApprovalPayload = z.infer<typeof approvalPayloadSchema>;
+/**
+ * Durable HITL hook (Vercel Workflow SDK ≥ 4.x).
+ *
+ * - TRONG workflow (`'use workflow'`):  `const decision = await lessonApprovalHook.create({ token })`
+ *   → run suspend với chi phí 0 cho tới khi payload được resume.
+ * - NGOÀI workflow (API route):        `await lessonApprovalHook.resume(token, payload)`
+ *   → ghi payload vào hook, SDK đánh thức run đang suspend.
+ *
+ * Token quy ước: `approval:{projectId}:{lessonId}:{artifactType}` — phía API route
+ * tái tạo được token từ dữ liệu nó có sẵn.
+ */
+declare const lessonApprovalHook: workflow.TypedHook<{
+    approved: boolean;
+    timestamp?: string | undefined;
+    feedback?: string | undefined;
+    reviewerName?: string | undefined;
+}, {
+    approved: boolean;
+    timestamp?: string | undefined;
+    feedback?: string | undefined;
+    reviewerName?: string | undefined;
+}>;
+/** Tái tạo deterministic hook token cho một chốt duyệt artifact. */
+declare function approvalHookToken(projectId: string, lessonId: string, artifactType: string): string;
+
+interface ExecuteWithRateLimitOptions<T> {
+    stepName: string;
+    fn: () => Promise<T>;
+    maxAttempts?: number;
+}
+/**
+ * Wraps async LLM functions to automatically catch 429/503/transient network errors
+ * and throw a durable RetryableError with exponential backoff for Vercel Workflow runtime.
+ */
+declare function withRateLimitBackoff<T>(options: ExecuteWithRateLimitOptions<T>): Promise<T>;
+
+interface MilestoneWorkflowInput {
+    jobId: string;
+    milestone: MilestoneInput;
+    language?: string;
+    topic?: string;
+    targetAudience?: string;
+    techStack?: string[];
+    bundleTier?: 'minimum' | 'full';
+    baseWorkspaceDir?: string;
+    modelOptions?: ModelResolutionOptions;
+    /** Adopted Framework Packs (hydrated from the Standards Registry) for standards-grounded generation. */
+    standardsPacks?: FrameworkPack[];
+    /** Hard-block the milestone when standards coverage FAILs (default: true when packs provided). */
+    enforceStandardsCoverage?: boolean;
+    /** Gate Settings thô (vd: gateModes từ project.config.json) — kit tự chuẩn hoá. */
+    gateSettings?: unknown;
+}
+interface MilestoneWorkflowResult {
+    milestoneId: string;
+    milestoneSlug: string;
+    status: 'SUCCESS' | 'FAILED';
+    savedResult: SavedMilestoneResult;
+    judgeReport?: CurriculumQualityReport;
+    /** Per-artifact-type judge reports for satellites (Gate mode LLM_JUDGE only). */
+    satelliteJudgeReports?: Record<string, CurriculumQualityReport>;
+    /** The resolved gate settings actually applied in this run (for traceability). */
+    gatesResolved?: Record<string, string>;
+    /** Set when a Gate (e.g. HITL rejection) BLOCKED downstream production. */
+    gateBlocked?: {
+        artifactType: string;
+        reason: 'HITL_REJECTED' | 'HITL_REJECTED_V2';
+        feedback?: string;
+    };
+    standardsCoverage?: CoverageGateReport;
+    artifacts: {
+        lesson: LessonPlan;
+        activity?: ActivityLab;
+        codeLab?: CodeLab;
+        selfLab?: SelfLab;
+        quiz?: DiagnosticQuiz;
+        slides?: SlideDeck;
+        handout?: Handout;
+        worksheet?: Worksheet;
+        teacherGuide?: TeacherGuide;
+        extension?: Extension;
+    };
+}
+/**
+ * Child Workflow: Executes fine-grained durable generation for a single Milestone.
+ * Uses Step-level memoization, automatic LLM retries, and parallel satellite generation.
+ */
+declare function generateMilestoneWorkflow(input: MilestoneWorkflowInput): Promise<MilestoneWorkflowResult>;
+
+interface GenerateRoadmapWorkflowInput {
+    jobId?: string;
+    roadmap: ProjectRoadmap;
+    language?: string;
+    bundleTier?: 'minimum' | 'full';
+    batchSize?: number;
+    /** Gate Settings thô (vd: gateModes từ project.config.json) — kit tự chuẩn hoá. */
+    gateSettings?: unknown;
+    baseWorkspaceDir?: string;
+    gitPublishOptions?: Omit<GitPublishOptions, 'jobId' | 'localJobDir'>;
+    supabasePublishOptions?: Omit<SupabasePublishOptions, 'jobId' | 'courseTitle' | 'topic' | 'language' | 'milestones'>;
+    modelOptions?: ModelResolutionOptions;
+}
+interface RoadmapWorkflowSummary {
+    jobId: string;
+    courseTitle: string;
+    topic: string;
+    language: string;
+    totalMilestones: number;
+    successfulMilestones: number;
+    failedMilestones: number;
+    results: Array<{
+        milestoneId: string;
+        status: 'FULFILLED' | 'REJECTED';
+        result?: MilestoneWorkflowResult;
+        error?: string;
+    }>;
+    gitPublishResult?: GitPublishResult;
+    supabasePublishResult?: SupabasePublishResult;
+    workspaceDir: string;
+}
+/**
+ * Parent Workflow: Orchestrates durable generation of an entire Curriculum Roadmap.
+ * Implements Batching (Pattern 1), Failure Isolation, and Dual-Target Publishing (Git + Supabase).
+ */
+declare function generateRoadmapWorkflow(input: GenerateRoadmapWorkflowInput): Promise<RoadmapWorkflowSummary>;
+
+/**
+ * Step-level durable execution for generating a single standalone artifact.
+ */
+declare function executeSingleArtifactStep(request: SingleArtifactRequest): Promise<SingleArtifactResult>;
+/**
+ * Workflow for on-demand single artifact generation.
+ * Supports Vercel Workflow durable execution, step memoization, and automatic retry.
+ */
+declare function generateSingleArtifactWorkflow(request: SingleArtifactRequest): Promise<SingleArtifactResult>;
+
+export { type ApprovalPayload, type ExecuteWithRateLimitOptions, type GenerateMasterLessonStepInput, type GenerateRoadmapWorkflowInput, type JudgeMasterLessonStepInput, type JudgeSatelliteStepInput, type MilestoneWorkflowInput, type MilestoneWorkflowResult, type RepairMasterLessonStepInput, type RoadmapWorkflowSummary, type SaveMilestoneArtifactsInput, type SavedMilestoneResult, approvalHookToken, approvalPayloadSchema, executeSingleArtifactStep, generateActivityStep, generateCodeLabStep, generateDiagnosticQuizStep, generateExtensionStep, generateHandoutStep, generateMasterLessonStep, generateMilestoneWorkflow, generateRoadmapWorkflow, generateSelfLabStep, generateSingleArtifactWorkflow, generateSlidesStep, generateTeacherGuideStep, generateWorksheetStep, judgeMasterLessonStep, judgeSatelliteStep, lessonApprovalHook, publishToGitStep, publishToSupabaseStep, repairMasterLessonStep, saveMilestoneToWorkspaceStep, withRateLimitBackoff };

package/dist/workflow/index.d.ts

@@ -1,8 +1,299 @@
-export { I as ApprovalPayload, y as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, M as ExecuteWithRateLimitOptions, z as GateSettings, G as GenerateMasterLessonStepInput, T as GenerateRoadmapWorkflowInput, J as JudgeMasterLessonStepInput, q as JudgeSatelliteStepInput, O as MilestoneWorkflowInput, P as MilestoneWorkflowResult, e as RepairMasterLessonStepInput, R as ResolvedGateSettings, U as RoadmapWorkflowSummary, t as SaveMilestoneArtifactsInput, u as SavedMilestoneResult, L as approvalHookToken, H as approvalPayloadSchema, W as executeSingleArtifactStep, F as gateModeFor, f as generateActivityStep, h as generateCodeLabStep, k as generateDiagnosticQuizStep, p as generateExtensionStep, m as generateHandoutStep, d as generateMasterLessonStep, Q as generateMilestoneWorkflow, V as generateRoadmapWorkflow, i as generateSelfLabStep, X as generateSingleArtifactWorkflow, l as generateSlidesStep, o as generateTeacherGuideStep, n as generateWorksheetStep, j as judgeMasterLessonStep, s as judgeSatelliteStep, K as lessonApprovalHook, B as parseGateSettings, w as publishToGitStep, x as publishToSupabaseStep, r as repairMasterLessonStep, E as resolveGateSettings, v as saveMilestoneToWorkspaceStep, N as withRateLimitBackoff } from '../index-B8lOdFuz.js';
-import '../schemas/index.js';
-import 'zod';
-import '../provider-factory-DxzOVEmh.js';
+import { MilestoneInput, LessonPlan, CurriculumQualityReport, ActivityLab, CodeLab, SelfLab, DiagnosticQuiz, SlideDeck, Handout, Worksheet, TeacherGuide, Extension, ProjectRoadmap } from '../schemas/index.js';
+import { M as ModelResolutionOptions } from '../provider-factory-DxzOVEmh.js';
+import { G as GitPublishOptions, a as GitPublishResult, S as SupabasePublishOptions, b as SupabasePublishResult } from '../supabasePublisher-C627qXFT.js';
+import { S as SingleArtifactRequest, a as SingleArtifactResult } from '../gateSettings-DKXRztJy.js';
+export { b as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, G as GateSettings, R as ResolvedGateSettings, g as gateModeFor, p as parseGateSettings, r as resolveGateSettings } from '../gateSettings-DKXRztJy.js';
+import * as workflow from 'workflow';
+import { z } from 'zod';
+import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-CsUNzv6C.js';
 import 'ai';
-import '../supabasePublisher-C627qXFT.js';
-import 'workflow';
-import '../standardsCoverageGate-BWAkXY76.js';
+
+interface GenerateMasterLessonStepInput {
+    milestone: MilestoneInput;
+    language: string;
+    topic?: string;
+    targetAudience?: string;
+    contextContinuity?: string;
+    /** Pre-rendered STANDARDS CONTEXT block (verbatim standard statements). */
+    standardsContext?: string;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateMasterLessonStep(input: GenerateMasterLessonStepInput): Promise<LessonPlan>;
+interface JudgeMasterLessonStepInput {
+    lessonId: string;
+    lesson: LessonPlan;
+    language: string;
+    targetObjectives: Array<{
+        code: string;
+        description: string;
+        bloomLevel: string;
+    }>;
+    /** Verbatim standard statements (canonical ID -> text) for the Standards Alignment judge dimension. */
+    standardStatements?: Record<string, string>;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function judgeMasterLessonStep(input: JudgeMasterLessonStepInput): Promise<CurriculumQualityReport>;
+interface RepairMasterLessonStepInput {
+    milestone: MilestoneInput;
+    language: string;
+    topic?: string;
+    targetAudience?: string;
+    auditReport: CurriculumQualityReport;
+    /** Pre-rendered STANDARDS CONTEXT block — kept across repair so grounding is never lost. */
+    standardsContext?: string;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function repairMasterLessonStep(input: RepairMasterLessonStepInput): Promise<LessonPlan>;
+
+declare function generateActivityStep(options: {
+    lesson: LessonPlan;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<ActivityLab>;
+declare function generateCodeLabStep(options: {
+    lesson: LessonPlan;
+    activity: ActivityLab;
+    language: string;
+    targetTechStack?: string[];
+    modelOptions?: ModelResolutionOptions;
+}): Promise<CodeLab>;
+declare function generateSelfLabStep(options: {
+    milestone: MilestoneInput;
+    language: string;
+    targetTechStack?: string[];
+    modelOptions?: ModelResolutionOptions;
+}): Promise<SelfLab>;
+declare function generateDiagnosticQuizStep(options: {
+    milestone: MilestoneInput;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<DiagnosticQuiz>;
+declare function generateSlidesStep(options: {
+    lesson: LessonPlan;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<SlideDeck>;
+declare function generateHandoutStep(options: {
+    lesson: LessonPlan;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<Handout>;
+declare function generateWorksheetStep(options: {
+    lesson: LessonPlan;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<Worksheet>;
+declare function generateTeacherGuideStep(options: {
+    lesson: LessonPlan;
+    activity: ActivityLab;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<TeacherGuide>;
+declare function generateExtensionStep(options: {
+    lesson: LessonPlan;
+    activity: ActivityLab;
+    language: string;
+    modelOptions?: ModelResolutionOptions;
+}): Promise<Extension>;
+
+interface JudgeSatelliteStepInput {
+    artifactType: string;
+    artifactId: string;
+    artifact: unknown;
+    language: string;
+    targetObjectives: Array<{
+        code: string;
+        description: string;
+        bloomLevel: string;
+    }>;
+    standardStatements?: Record<string, string>;
+    modelOptions?: ModelResolutionOptions;
+}
+/**
+ * Gate step for satellite artifacts (LLM_JUDGE mode).
+ * Judges any artifact JSON against the same 6-dimension rubric; returns the report.
+ * The workflow decides what to do with the verdict (log / block / store) — gate config stays the single source of truth.
+ */
+declare function judgeSatelliteStep(input: JudgeSatelliteStepInput): Promise<CurriculumQualityReport>;
+
+interface SaveMilestoneArtifactsInput {
+    jobId: string;
+    milestoneSlug: string;
+    lesson: LessonPlan;
+    activity?: ActivityLab;
+    codeLab?: CodeLab;
+    selfLab?: SelfLab;
+    quiz?: DiagnosticQuiz;
+    slides?: SlideDeck;
+    handout?: Handout;
+    worksheet?: Worksheet;
+    teacherGuide?: TeacherGuide;
+    extension?: Extension;
+    cheatSheetMarkdown?: string;
+    baseWorkspaceDir?: string;
+}
+interface SavedMilestoneResult {
+    milestoneSlug: string;
+    savedFiles: string[];
+}
+declare function saveMilestoneToWorkspaceStep(input: SaveMilestoneArtifactsInput): Promise<SavedMilestoneResult>;
+declare function publishToGitStep(options: GitPublishOptions): Promise<GitPublishResult>;
+declare function publishToSupabaseStep(options: SupabasePublishOptions): Promise<SupabasePublishResult>;
+
+/**
+ * Payload human gửi khi duyệt / từ chối một artifact tại chốt HITL.
+ */
+declare const approvalPayloadSchema: z.ZodObject<{
+    approved: z.ZodBoolean;
+    reviewerName: z.ZodOptional<z.ZodString>;
+    feedback: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    approved: boolean;
+    timestamp?: string | undefined;
+    feedback?: string | undefined;
+    reviewerName?: string | undefined;
+}, {
+    approved: boolean;
+    timestamp?: string | undefined;
+    feedback?: string | undefined;
+    reviewerName?: string | undefined;
+}>;
+type ApprovalPayload = z.infer<typeof approvalPayloadSchema>;
+/**
+ * Durable HITL hook (Vercel Workflow SDK ≥ 4.x).
+ *
+ * - TRONG workflow (`'use workflow'`):  `const decision = await lessonApprovalHook.create({ token })`
+ *   → run suspend với chi phí 0 cho tới khi payload được resume.
+ * - NGOÀI workflow (API route):        `await lessonApprovalHook.resume(token, payload)`
+ *   → ghi payload vào hook, SDK đánh thức run đang suspend.
+ *
+ * Token quy ước: `approval:{projectId}:{lessonId}:{artifactType}` — phía API route
+ * tái tạo được token từ dữ liệu nó có sẵn.
+ */
+declare const lessonApprovalHook: workflow.TypedHook<{
+    approved: boolean;
+    timestamp?: string | undefined;
+    feedback?: string | undefined;
+    reviewerName?: string | undefined;
+}, {
+    approved: boolean;
+    timestamp?: string | undefined;
+    feedback?: string | undefined;
+    reviewerName?: string | undefined;
+}>;
+/** Tái tạo deterministic hook token cho một chốt duyệt artifact. */
+declare function approvalHookToken(projectId: string, lessonId: string, artifactType: string): string;
+
+interface ExecuteWithRateLimitOptions<T> {
+    stepName: string;
+    fn: () => Promise<T>;
+    maxAttempts?: number;
+}
+/**
+ * Wraps async LLM functions to automatically catch 429/503/transient network errors
+ * and throw a durable RetryableError with exponential backoff for Vercel Workflow runtime.
+ */
+declare function withRateLimitBackoff<T>(options: ExecuteWithRateLimitOptions<T>): Promise<T>;
+
+interface MilestoneWorkflowInput {
+    jobId: string;
+    milestone: MilestoneInput;
+    language?: string;
+    topic?: string;
+    targetAudience?: string;
+    techStack?: string[];
+    bundleTier?: 'minimum' | 'full';
+    baseWorkspaceDir?: string;
+    modelOptions?: ModelResolutionOptions;
+    /** Adopted Framework Packs (hydrated from the Standards Registry) for standards-grounded generation. */
+    standardsPacks?: FrameworkPack[];
+    /** Hard-block the milestone when standards coverage FAILs (default: true when packs provided). */
+    enforceStandardsCoverage?: boolean;
+    /** Gate Settings thô (vd: gateModes từ project.config.json) — kit tự chuẩn hoá. */
+    gateSettings?: unknown;
+}
+interface MilestoneWorkflowResult {
+    milestoneId: string;
+    milestoneSlug: string;
+    status: 'SUCCESS' | 'FAILED';
+    savedResult: SavedMilestoneResult;
+    judgeReport?: CurriculumQualityReport;
+    /** Per-artifact-type judge reports for satellites (Gate mode LLM_JUDGE only). */
+    satelliteJudgeReports?: Record<string, CurriculumQualityReport>;
+    /** The resolved gate settings actually applied in this run (for traceability). */
+    gatesResolved?: Record<string, string>;
+    /** Set when a Gate (e.g. HITL rejection) BLOCKED downstream production. */
+    gateBlocked?: {
+        artifactType: string;
+        reason: 'HITL_REJECTED' | 'HITL_REJECTED_V2';
+        feedback?: string;
+    };
+    standardsCoverage?: CoverageGateReport;
+    artifacts: {
+        lesson: LessonPlan;
+        activity?: ActivityLab;
+        codeLab?: CodeLab;
+        selfLab?: SelfLab;
+        quiz?: DiagnosticQuiz;
+        slides?: SlideDeck;
+        handout?: Handout;
+        worksheet?: Worksheet;
+        teacherGuide?: TeacherGuide;
+        extension?: Extension;
+    };
+}
+/**
+ * Child Workflow: Executes fine-grained durable generation for a single Milestone.
+ * Uses Step-level memoization, automatic LLM retries, and parallel satellite generation.
+ */
+declare function generateMilestoneWorkflow(input: MilestoneWorkflowInput): Promise<MilestoneWorkflowResult>;
+
+interface GenerateRoadmapWorkflowInput {
+    jobId?: string;
+    roadmap: ProjectRoadmap;
+    language?: string;
+    bundleTier?: 'minimum' | 'full';
+    batchSize?: number;
+    /** Gate Settings thô (vd: gateModes từ project.config.json) — kit tự chuẩn hoá. */
+    gateSettings?: unknown;
+    baseWorkspaceDir?: string;
+    gitPublishOptions?: Omit<GitPublishOptions, 'jobId' | 'localJobDir'>;
+    supabasePublishOptions?: Omit<SupabasePublishOptions, 'jobId' | 'courseTitle' | 'topic' | 'language' | 'milestones'>;
+    modelOptions?: ModelResolutionOptions;
+}
+interface RoadmapWorkflowSummary {
+    jobId: string;
+    courseTitle: string;
+    topic: string;
+    language: string;
+    totalMilestones: number;
+    successfulMilestones: number;
+    failedMilestones: number;
+    results: Array<{
+        milestoneId: string;
+        status: 'FULFILLED' | 'REJECTED';
+        result?: MilestoneWorkflowResult;
+        error?: string;
+    }>;
+    gitPublishResult?: GitPublishResult;
+    supabasePublishResult?: SupabasePublishResult;
+    workspaceDir: string;
+}
+/**
+ * Parent Workflow: Orchestrates durable generation of an entire Curriculum Roadmap.
+ * Implements Batching (Pattern 1), Failure Isolation, and Dual-Target Publishing (Git + Supabase).
+ */
+declare function generateRoadmapWorkflow(input: GenerateRoadmapWorkflowInput): Promise<RoadmapWorkflowSummary>;
+
+/**
+ * Step-level durable execution for generating a single standalone artifact.
+ */
+declare function executeSingleArtifactStep(request: SingleArtifactRequest): Promise<SingleArtifactResult>;
+/**
+ * Workflow for on-demand single artifact generation.
+ * Supports Vercel Workflow durable execution, step memoization, and automatic retry.
+ */
+declare function generateSingleArtifactWorkflow(request: SingleArtifactRequest): Promise<SingleArtifactResult>;
+
+export { type ApprovalPayload, type ExecuteWithRateLimitOptions, type GenerateMasterLessonStepInput, type GenerateRoadmapWorkflowInput, type JudgeMasterLessonStepInput, type JudgeSatelliteStepInput, type MilestoneWorkflowInput, type MilestoneWorkflowResult, type RepairMasterLessonStepInput, type RoadmapWorkflowSummary, type SaveMilestoneArtifactsInput, type SavedMilestoneResult, approvalHookToken, approvalPayloadSchema, executeSingleArtifactStep, generateActivityStep, generateCodeLabStep, generateDiagnosticQuizStep, generateExtensionStep, generateHandoutStep, generateMasterLessonStep, generateMilestoneWorkflow, generateRoadmapWorkflow, generateSelfLabStep, generateSingleArtifactWorkflow, generateSlidesStep, generateTeacherGuideStep, generateWorksheetStep, judgeMasterLessonStep, judgeSatelliteStep, lessonApprovalHook, publishToGitStep, publishToSupabaseStep, repairMasterLessonStep, saveMilestoneToWorkspaceStep, withRateLimitBackoff };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanh01.pmt/curriculum-kit",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "A high-fidelity AI curriculum & content generation engine powered by Vercel AI SDK, Zod, and Bloom-aligned pedagogical standards.",
   "author": "Thanh Pham <https://github.com/thanh01pmt>",
   "license": "MIT",