@thanh01.pmt/curriculum-kit 1.4.49 → 1.4.51

package/dist/index.cjs

@@ -11030,10 +11030,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;
@@ -11069,6 +11072,15 @@ function cutBackToCheckpoint(current, nodeById, spec, warnings) {
   current.nodeIds = current.entries.map((e) => e.id);
   return displacedEntries.map((e) => nodeById.get(e.id)).filter((n) => n != null);
 }
+function canCoalesceWithinZpdBudget(curr, next, nodeById, maxNew) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const s of [curr, next]) {
+    for (const nid of s.nodeIds) {
+      for (const c of nodeById.get(nid)?.concept_codes || []) seen.add(c);
+    }
+  }
+  return seen.size <= maxNew;
+}
 function packUnitSessions(group, nodeById, spec, warnings) {
   const sessions = [];
   const fresh = () => ({ groupId: group.key, nodeIds: [], entries: [], knowledgeMinutes: 0, practiceMinutes: 0, oversized: false });
@@ -11116,6 +11128,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) {
@@ -11274,19 +11295,19 @@ 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) {
-      verdict = "NO_ZPD_BRIDGE";
+      if (verdict !== "TOO_MANY_NEW") verdict = "NO_ZPD_BRIDGE";
       issues.push("No known concepts from previous sessions to bridge new learning");
     } else if (concepts.length === 0 && allKeywords.length > 2 && knownKeywords.length === 0) {
-      verdict = "NO_ZPD_BRIDGE";
+      if (verdict !== "TOO_MANY_NEW") verdict = "NO_ZPD_BRIDGE";
       issues.push("No known keywords from previous sessions to bridge new learning");
     }
   }
@@ -11495,7 +11516,8 @@ async function buildCurriculumPlan(rawGraph, options) {
         const currMins = curr.knowledgeMinutes + curr.practiceMinutes;
         const nextMins = next.knowledgeMinutes + next.practiceMinutes;
         const totalContent = currMins + nextMins;
-        if (currMins <= 45 || nextMins <= 45 || totalContent <= spec.contentBudget * 1.5) {
+        const maxNew = spec.maxNewConceptsPerSession ?? Infinity;
+        if ((currMins <= 45 || nextMins <= 45 || totalContent <= spec.contentBudget * 1.5) && canCoalesceWithinZpdBudget(curr, next, nodeById, maxNew)) {
           const scale = totalContent > spec.contentBudget ? spec.contentBudget / totalContent : 1;
           curr.nodeIds.push(...next.nodeIds);
           for (const e of next.entries) {
@@ -11564,9 +11586,13 @@ async function buildCurriculumPlan(rawGraph, options) {
     if (options.llmFn) {
       const sys = "You write ONE concise learning objective sentence (max 40 words) for a training session. Output the sentence only.";
       const usr = "Session: " + lessonCode + " \u2014 " + nodeNames.join("; ") + ". Unit: " + unit.name + ". Course goals: " + (constraints.course_goals.join("; ") || "n/a") + ".";
-      const out = (await options.llmFn(sys, usr)).trim();
-      if (out.length < 10) throw new Error("LLM prose objective too short for " + lessonCode + ': "' + out.slice(0, 40) + '"');
-      proseObjective = out;
+      try {
+        const out = (await options.llmFn(sys, usr)).trim();
+        if (out.length < 10) throw new Error("LLM prose objective too short for " + lessonCode + ': "' + out.slice(0, 40) + '"');
+        proseObjective = out;
+      } catch (e) {
+        warnings.push("prose_objective_llm_failed:" + (e instanceof Error ? e.message.slice(0, 80) : String(e).slice(0, 80)));
+      }
     }
     const ctx = { lessonCode, sessionIndex: i, nodeIds: s.nodeIds, packedMinutes: s.knowledgeMinutes + s.practiceMinutes, contentBudget: spec.contentBudget };
     const nodeKeywords = (ids) => [...new Set(ids.flatMap((id) => nodeById.get(id).keywords))];
@@ -11664,6 +11690,32 @@ ${sessionSummaries}`;
       warnings.push("differentiation_llm_failed:" + (e instanceof Error ? e.message.slice(0, 80) : String(e).slice(0, 80)));
     }
   }
+  if (options.llmFn && sessions.length > 0) {
+    try {
+      const eSys = 'You write OBSERVABLE exit evidence for curriculum sessions. Output ONLY a JSON object mapping session-id to an array of 1-3 short strings. Each string must name what a bystander can SEE or VERIFY at the end of the session: a running screen, a passing test, a saved file, correct printed output, a working interaction. NEVER write "Student understands/explains/applies X" \u2014 describe the artifact or observable result instead. Same language as the session objectives.';
+      const eUsr = `Age band: ${constraints.age_band[0]}-${constraints.age_band[1]}. Entry level: ${constraints.entry_level}.
+Sessions (current exit evidence to improve):
+${sessions.map((s) => `${s.id}|objective: ${s.prose_objective.slice(0, 100)}|current: ${s.exit_evidence.join(" ; ")}`).join("\n")}`;
+      const raw = (await options.llmFn(eSys, eUsr)).trim();
+      const match = raw.match(/\{[\s\S]*\}/);
+      if (match) {
+        const parsed = JSON.parse(match[0]);
+        let upgraded = 0;
+        for (const s of sessions) {
+          const arr = parsed[s.id];
+          if (Array.isArray(arr) && arr.length > 0 && arr.every((x) => typeof x === "string" && x.trim().length >= 8)) {
+            s.exit_evidence = arr.map((x) => x.trim());
+            upgraded++;
+          }
+        }
+        if (upgraded < sessions.length) warnings.push(`exit_evidence_llm_partial:${upgraded}/${sessions.length}`);
+      } else {
+        warnings.push("exit_evidence_llm_unparseable");
+      }
+    } catch (e) {
+      warnings.push("exit_evidence_llm_failed:" + (e instanceof Error ? e.message.slice(0, 80) : String(e).slice(0, 80)));
+    }
+  }
   const glossaryScope = sessions.map((s) => ({
     session_id: s.id,
     terms: [...new Set(s.node_ids.flatMap((id) => nodeById.get(id).keywords))]
@@ -29951,14 +30003,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") {
@@ -31985,6 +32037,7 @@ exports.buildStandardsContextBlock = buildStandardsContextBlock;
 exports.buildTeacherGuidePrompt = buildTeacherGuidePrompt;
 exports.buildWalkingSkeleton = buildWalkingSkeleton;
 exports.buildWorksheetPrompt = buildWorksheetPrompt;
+exports.canCoalesceWithinZpdBudget = canCoalesceWithinZpdBudget;
 exports.checkSessionZpd = checkSessionZpd;
 exports.classifyDepthCandidates = classifyDepthCandidates;
 exports.closeTruncatedJson = closeTruncatedJson;