@thanh01.pmt/curriculum-kit 1.4.35 → 1.4.37

package/dist/standards/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FrameworkPack, g as FrameworkStatement } from '../standardsCoverageGate-DR5YTtlt.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-DR5YTtlt.cjs';
+import { F as FrameworkPack, g as FrameworkStatement } from '../standardsCoverageGate-49pJq5t8.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-49pJq5t8.cjs';
 import { SupabaseClient } from '@supabase/supabase-js';
 import 'zod';
 

package/dist/standards/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FrameworkPack, g as FrameworkStatement } from '../standardsCoverageGate-DR5YTtlt.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-DR5YTtlt.js';
+import { F as FrameworkPack, g as FrameworkStatement } from '../standardsCoverageGate-49pJq5t8.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-49pJq5t8.js';
 import { SupabaseClient } from '@supabase/supabase-js';
 import 'zod';
 

package/dist/workflow/index.cjs

@@ -2394,6 +2394,50 @@ var ScaffoldDecisionEntrySchema = zod.z.object({
   minutes_saved: zod.z.number().int().nonnegative().default(0),
   reason: zod.z.string().min(3)
 });
+var ZpdVerdictSchema = zod.z.enum(["OK", "TOO_MANY_NEW", "NO_ZPD_BRIDGE"]);
+var SessionZpdStatusSchema = zod.z.object({
+  verdict: ZpdVerdictSchema,
+  new_concept_count: zod.z.number().int().nonnegative().default(0),
+  known_concept_count: zod.z.number().int().nonnegative().default(0),
+  issues: zod.z.array(zod.z.string()).default([])
+});
+var ConceptSpiralEncounterSchema = zod.z.object({
+  concept_code: zod.z.string(),
+  session_id: LessonCodeSchema,
+  encounter_index: zod.z.number().int().positive(),
+  bloom_cap: BloomLevelSchema,
+  depth: DepthLevelSchema
+});
+var WalkingSkeletonSchema = zod.z.object({
+  epitome_unit_id: zod.z.string().default("U01"),
+  epitome_deliverables: zod.z.array(zod.z.string()).default([]),
+  elaborations: zod.z.array(zod.z.object({
+    unit_id: zod.z.string(),
+    focus_area: zod.z.string(),
+    elaborates_on: zod.z.array(zod.z.string()).default([])
+  })).default([])
+});
+var MasteryGateSchema = zod.z.object({
+  phase_or_unit_id: zod.z.string(),
+  gate_name: zod.z.string(),
+  exit_criteria: zod.z.array(zod.z.string()).min(1),
+  next_unit_id: zod.z.string(),
+  remediation: zod.z.object({
+    trigger: zod.z.literal("FAIL_GATE_CRITERIA"),
+    focus_minutes: zod.z.number().int().default(15),
+    action: zod.z.string()
+  })
+});
+var ConceptPrerequisiteEdgeSchema = zod.z.object({
+  concept_code: zod.z.string(),
+  requires: zod.z.string(),
+  source: zod.z.enum(["MASTER_TREE", "INFERRED", "CONCEPT_LEVEL_PREREQ"]).default("CONCEPT_LEVEL_PREREQ"),
+  confidence: zod.z.number().min(0).max(1).default(0.8),
+  rationale: zod.z.string().default(""),
+  structure_supported: zod.z.boolean().default(true),
+  needs_review: zod.z.boolean().default(false),
+  hub: zod.z.boolean().default(false)
+});
 var SessionPlanSchema = zod.z.object({
   id: LessonCodeSchema,
   unit_id: zod.z.string().regex(/^U\d{2}$/),
@@ -2414,7 +2458,14 @@ var SessionPlanSchema = zod.z.object({
   scaffold_decisions: zod.z.array(ScaffoldDecisionEntrySchema).default([]),
   // What the student can demonstrate after this session — feeds exit tickets.
   exit_evidence: zod.z.array(zod.z.string()).min(1),
-  differentiation: zod.z.object({ bronze: zod.z.string(), silver: zod.z.string(), gold: zod.z.string() })
+  differentiation: zod.z.object({ bronze: zod.z.string(), silver: zod.z.string(), gold: zod.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 = zod.z.object({
   policy: zod.z.enum(["after_artifact", "end_of_unit", "at_publish", "native"]).default("native"),
@@ -2469,6 +2520,11 @@ zod.z.object({
   // [2]
   sessions: zod.z.array(SessionPlanSchema).min(1),
   // [3][4][5][6]
+  // P50: Macro-pedagogical course structures
+  walking_skeleton: WalkingSkeletonSchema.optional(),
+  mastery_gates: zod.z.array(MasteryGateSchema).default([]),
+  concept_spiral_progression: zod.z.array(ConceptSpiralEncounterSchema).default([]),
+  concept_prerequisites: zod.z.array(ConceptPrerequisiteEdgeSchema).default([]),
   glossary_scope: zod.z.array(zod.z.object({
     session_id: LessonCodeSchema,
     terms: zod.z.array(zod.z.string())
@@ -19054,7 +19110,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
       }));
     }
   }
@@ -19202,12 +19259,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
@@ -19223,6 +19284,8 @@ function renderHorizonPromptBlock(horizon) {
     totalLessons,
     targetTitle,
     targetKeywords,
+    zpdStatus,
+    spiralProgression,
     compactMasterySet,
     detailedBridge,
     boundaryPeek
@@ -19230,6 +19293,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;
@@ -19565,6 +19641,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) {