@thanh01.pmt/curriculum-kit 1.4.34 → 1.4.36

package/dist/workflow/index.d.cts

@@ -1,11 +1,11 @@
 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-Bv-eIkhg.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-DabOqP6_.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-DabOqP6_.cjs';
+import { S as SingleArtifactRequest, a as SingleArtifactResult } from '../gateSettings-oo5tCUS_.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-oo5tCUS_.cjs';
 import * as workflow from 'workflow';
 import { z } from 'zod';
-import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-DR5YTtlt.cjs';
+import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-49pJq5t8.cjs';
 import 'ai';
 
 interface GenerateMasterLessonStepInput {

package/dist/workflow/index.d.ts

@@ -1,11 +1,11 @@
 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-Bv-eIkhg.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-DabOqP6_.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-DabOqP6_.js';
+import { S as SingleArtifactRequest, a as SingleArtifactResult } from '../gateSettings-oo5tCUS_.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-oo5tCUS_.js';
 import * as workflow from 'workflow';
 import { z } from 'zod';
-import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-DR5YTtlt.js';
+import { F as FrameworkPack, C as CoverageGateReport } from '../standardsCoverageGate-49pJq5t8.js';
 import 'ai';
 
 interface GenerateMasterLessonStepInput {

package/dist/workflow/index.mjs

@@ -2385,6 +2385,50 @@ var ScaffoldDecisionEntrySchema = z.object({
   minutes_saved: z.number().int().nonnegative().default(0),
   reason: z.string().min(3)
 });
+var ZpdVerdictSchema = z.enum(["OK", "TOO_MANY_NEW", "NO_ZPD_BRIDGE"]);
+var SessionZpdStatusSchema = z.object({
+  verdict: ZpdVerdictSchema,
+  new_concept_count: z.number().int().nonnegative().default(0),
+  known_concept_count: z.number().int().nonnegative().default(0),
+  issues: z.array(z.string()).default([])
+});
+var ConceptSpiralEncounterSchema = z.object({
+  concept_code: z.string(),
+  session_id: LessonCodeSchema,
+  encounter_index: z.number().int().positive(),
+  bloom_cap: BloomLevelSchema,
+  depth: DepthLevelSchema
+});
+var WalkingSkeletonSchema = z.object({
+  epitome_unit_id: z.string().default("U01"),
+  epitome_deliverables: z.array(z.string()).default([]),
+  elaborations: z.array(z.object({
+    unit_id: z.string(),
+    focus_area: z.string(),
+    elaborates_on: z.array(z.string()).default([])
+  })).default([])
+});
+var MasteryGateSchema = z.object({
+  phase_or_unit_id: z.string(),
+  gate_name: z.string(),
+  exit_criteria: z.array(z.string()).min(1),
+  next_unit_id: z.string(),
+  remediation: z.object({
+    trigger: z.literal("FAIL_GATE_CRITERIA"),
+    focus_minutes: z.number().int().default(15),
+    action: z.string()
+  })
+});
+var ConceptPrerequisiteEdgeSchema = z.object({
+  concept_code: z.string(),
+  requires: z.string(),
+  source: z.enum(["MASTER_TREE", "INFERRED", "CONCEPT_LEVEL_PREREQ"]).default("CONCEPT_LEVEL_PREREQ"),
+  confidence: z.number().min(0).max(1).default(0.8),
+  rationale: z.string().default(""),
+  structure_supported: z.boolean().default(true),
+  needs_review: z.boolean().default(false),
+  hub: z.boolean().default(false)
+});
 var SessionPlanSchema = z.object({
   id: LessonCodeSchema,
   unit_id: z.string().regex(/^U\d{2}$/),
@@ -2405,7 +2449,14 @@ var SessionPlanSchema = z.object({
   scaffold_decisions: z.array(ScaffoldDecisionEntrySchema).default([]),
   // What the student can demonstrate after this session — feeds exit tickets.
   exit_evidence: z.array(z.string()).min(1),
-  differentiation: z.object({ bronze: z.string(), silver: z.string(), gold: z.string() })
+  differentiation: z.object({ bronze: z.string(), silver: z.string(), gold: z.string() }),
+  // P50: ZPD cognitive load status for this session
+  zpd_status: SessionZpdStatusSchema.default({
+    verdict: "OK",
+    new_concept_count: 0,
+    known_concept_count: 0,
+    issues: []
+  })
 });
 var TranslationPolicySchema = z.object({
   policy: z.enum(["after_artifact", "end_of_unit", "at_publish", "native"]).default("native"),
@@ -2460,6 +2511,11 @@ z.object({
   // [2]
   sessions: z.array(SessionPlanSchema).min(1),
   // [3][4][5][6]
+  // P50: Macro-pedagogical course structures
+  walking_skeleton: WalkingSkeletonSchema.optional(),
+  mastery_gates: z.array(MasteryGateSchema).default([]),
+  concept_spiral_progression: z.array(ConceptSpiralEncounterSchema).default([]),
+  concept_prerequisites: z.array(ConceptPrerequisiteEdgeSchema).default([]),
   glossary_scope: z.array(z.object({
     session_id: LessonCodeSchema,
     terms: z.array(z.string())
@@ -19045,7 +19101,8 @@ function parseAllSessions(plan, frameworkMarkdown) {
         prose_objective: s.prose_objective || s.objective || "",
         new_keywords: Array.isArray(s.new_keywords) ? s.new_keywords : Array.isArray(s.keywords) ? s.keywords : [],
         prerequisite_keywords: Array.isArray(s.prerequisite_keywords) ? s.prerequisite_keywords : [],
-        depth_assignments: Array.isArray(s.depth_assignments) ? s.depth_assignments : []
+        depth_assignments: Array.isArray(s.depth_assignments) ? s.depth_assignments : [],
+        zpd_status: s.zpd_status
       }));
     }
   }
@@ -19193,12 +19250,16 @@ async function extractCurriculumHorizon(opts) {
     title: s.title,
     keywords: s.new_keywords || []
   }));
+  const rawSpirals = Array.isArray(plan?.concept_spiral_progression) ? plan.concept_spiral_progression : [];
+  const sessionSpirals = rawSpirals.filter((e) => e.session_id === targetLessonId);
   return {
     targetLessonId,
     targetLessonIndex: targetIndex + 1,
     totalLessons: sessions.length,
     targetTitle: currentSession.title,
     targetKeywords: currentSession.new_keywords || [],
+    zpdStatus: currentSession.zpd_status,
+    spiralProgression: sessionSpirals,
     compactMasterySet: {
       masteredKeywords,
       masteredConcepts
@@ -19214,6 +19275,8 @@ function renderHorizonPromptBlock(horizon) {
     totalLessons,
     targetTitle,
     targetKeywords,
+    zpdStatus,
+    spiralProgression,
     compactMasterySet,
     detailedBridge,
     boundaryPeek
@@ -19221,6 +19284,19 @@ function renderHorizonPromptBlock(horizon) {
   const lines = [
     `# \u{1F9ED} CURRICULUM HORIZON & SCAFFOLDING MATRIX (Lesson ${targetLessonIndex}/${totalLessons}: "${targetTitle}" [${targetLessonId}])`
   ];
+  if (zpdStatus && zpdStatus.verdict !== "OK") {
+    lines.push(
+      `
+> \u26A0\uFE0F **ZPD COGNITIVE LOAD ALERT (${zpdStatus.verdict}):** ${zpdStatus.issues?.join("; ") || "Scaffolding bridge mandated"}. Introduce minimal new syntax and anchor into known concepts.`
+    );
+  }
+  if (spiralProgression && spiralProgression.length > 0) {
+    const spiralNotes = spiralProgression.map(
+      (sp) => `\`${sp.concept_code}\` (Encounter #${sp.encounter_index}): Bloom Cap [${sp.bloom_cap}], Depth [${sp.depth.toUpperCase()}]`
+    );
+    lines.push(`
+- **\u{1F300} Bruner Spiral Curricula Guidance:** ${spiralNotes.join(" | ")}`);
+  }
   if (compactMasterySet.masteredKeywords.length > 0 || compactMasterySet.masteredConcepts.length > 0) {
     const rawKeywords = compactMasterySet.masteredKeywords;
     const displayedKeywords = rawKeywords.length > 20 ? rawKeywords.slice(-20) : rawKeywords;
@@ -19556,6 +19632,12 @@ function findCanonicalFuzzy(norm) {
   if (norm.includes("worked example") || norm.includes("vi du")) {
     return "Worked Micro-Examples";
   }
+  if (norm.includes("common mistake") || norm.includes("loi thuong gap") || norm.includes("sai lam") || norm.includes("pitfall")) {
+    return "Common Mistakes";
+  }
+  if (norm.includes("self check") || norm.includes("self-check") || norm.includes("tu kiem tra")) {
+    return "Self-Check Questions";
+  }
   return void 0;
 }
 function truncateByBudget(source, budget) {