@thanh01.pmt/curriculum-kit 1.4.49 → 1.4.50

package/dist/index.d.cts

@@ -1123,6 +1123,13 @@ interface PackingSpec {
     contentBudget: number;
     overheadMinutes: number;
     sessionDurationMinutes: number;
+    /** 2026-09-18 RC-2: cognitive budget — max DISTINCT new concepts per
+     * session (Vygotsky ZPD constant). 0 disables the check. The minute
+     * budget alone packs knowledge-dense sessions (observed: 4 concepts in
+     * one 90m K-12 session); flushing early on this budget is a STRUCTURAL
+     * rule — it counts and cuts, it never reorders across prerequisite
+     * edges (teaching order preserved by construction). */
+    maxNewConceptsPerSession?: number;
 }
 declare function computePackingSpec(constraints: PlanConstraints): PackingSpec;
 interface PackedEntry {

package/dist/index.d.ts

@@ -1123,6 +1123,13 @@ interface PackingSpec {
     contentBudget: number;
     overheadMinutes: number;
     sessionDurationMinutes: number;
+    /** 2026-09-18 RC-2: cognitive budget — max DISTINCT new concepts per
+     * session (Vygotsky ZPD constant). 0 disables the check. The minute
+     * budget alone packs knowledge-dense sessions (observed: 4 concepts in
+     * one 90m K-12 session); flushing early on this budget is a STRUCTURAL
+     * rule — it counts and cuts, it never reorders across prerequisite
+     * edges (teaching order preserved by construction). */
+    maxNewConceptsPerSession?: number;
 }
 declare function computePackingSpec(constraints: PlanConstraints): PackingSpec;
 interface PackedEntry {

package/dist/index.mjs

@@ -11018,10 +11018,13 @@ function buildUnitGroupings(graph, orderedIds) {
 }
 function computePackingSpec(constraints) {
   const overheadMinutes = Math.round(constraints.session_duration_minutes * constraints.overhead_ratio);
+  const upperAge = constraints.age_band?.[1];
+  const maxNew = upperAge !== void 0 && upperAge > 15 ? MAX_NEW_CONCEPTS_PER_SESSION_ADULT : MAX_NEW_CONCEPTS_PER_SESSION_K12;
   return {
     contentBudget: constraints.session_duration_minutes - overheadMinutes,
     overheadMinutes,
-    sessionDurationMinutes: constraints.session_duration_minutes
+    sessionDurationMinutes: constraints.session_duration_minutes,
+    maxNewConceptsPerSession: maxNew
   };
 }
 var filledOf = (s) => s.knowledgeMinutes + s.practiceMinutes;
@@ -11104,6 +11107,15 @@ function packUnitSessions(group, nodeById, spec, warnings) {
       continue;
     }
     const minutes = node.estimated_minutes;
+    if (spec.maxNewConceptsPerSession && spec.maxNewConceptsPerSession > 0 && current.entries.length > 0) {
+      const currentConcepts = new Set(current.nodeIds.flatMap((nid) => nodeById.get(nid)?.concept_codes || []));
+      const incoming = nodeById.get(id)?.concept_codes || [];
+      const wouldAdd = incoming.filter((c) => !currentConcepts.has(c)).length;
+      if (currentConcepts.size + wouldAdd > spec.maxNewConceptsPerSession) {
+        warnings.push(`ZPD pack flush: session ${group.key}#${sessions.length + 1} cut at ${currentConcepts.size} new concepts (budget ${spec.maxNewConceptsPerSession})`);
+        flush();
+      }
+    }
     if (current.entries.length > 0 && filled() + minutes > spec.contentBudget) {
       const displaced = cutBackToCheckpoint(current, nodeById, spec, warnings);
       if (displaced.length > 0) {
@@ -11262,12 +11274,12 @@ function checkSessionZpd(sessionIndex, nodeIds, nodeById, allSeenConcepts, allSe
   const knownKeywords = allKeywords.filter((k) => allSeenKeywords.has(k.toLowerCase()) || entryKw.has(k.toLowerCase()));
   const issues = [];
   let verdict = "OK";
-  if (concepts.length > 0 && newConcepts.length > 2) {
+  if (newConcepts.length > MAX_NEW_CONCEPTS_PER_SESSION_K12) {
     verdict = "TOO_MANY_NEW";
-    issues.push(`${newConcepts.length} new concepts exceed ZPD limit (max 2)`);
-  } else if (concepts.length === 0 && newKeywords.length > 4) {
-    verdict = "TOO_MANY_NEW";
-    issues.push(`${newKeywords.length} new keywords exceed ZPD limit (max 4)`);
+    issues.push(`${newConcepts.length} new concepts exceed ZPD limit (max ${MAX_NEW_CONCEPTS_PER_SESSION_K12})`);
+  }
+  if (newKeywords.length > 4) {
+    issues.push(`Evidence for judge: ${newKeywords.length} new keywords in session (noisy proxy, not a gate)`);
   }
   if (sessionIndex > 0) {
     if (concepts.length > 1 && knownConcepts.length === 0) {
@@ -29939,14 +29951,14 @@ var DeterministicStructuralLinter = class {
     let score = 100;
     for (const s of plan.sessions) {
       if (s.zpd_status?.verdict === "TOO_MANY_NEW") {
-        score -= 10;
+        score -= 25;
         findings.push({
           id: `PLAN_TOO_MANY_NEW_${s.id}`,
           dimension: "CONSTRUCTIVE_ALIGNMENT",
-          severity: "MINOR",
+          severity: "CRITICAL",
           title: `Cognitive Overload in Session ${s.id}`,
-          description: s.zpd_status.issues.join("; ") || `Session introduces too many new concepts/keywords, exceeding ZPD capacity.`,
-          remediationAdvice: `Distribute new concepts across multiple sessions or introduce via scaffolding.`,
+          description: s.zpd_status.issues.join("; ") || `Session introduces more new concepts than the ZPD limit allows.`,
+          remediationAdvice: `Split the session: move overflow concepts to a later session (the packer flushes on concept budget automatically).`,
           affectedElement: s.id
         });
       } else if (s.zpd_status?.verdict === "NO_ZPD_BRIDGE") {