@thanh01.pmt/curriculum-kit 1.4.37 → 1.4.38

package/dist/index.cjs

@@ -1532,6 +1532,8 @@ function parseLessonFlow(lessonMarkdown) {
               purpose: cells[4] || "",
               studentAction: cells[5] || "",
               teacherMove: cells[6] || "",
+              outputEvidence: cells[7] || "",
+              lo: (cells[8] || "").replace(/\*/g, "").split(/[,;/\s]+/).map((s) => s.trim()).filter(Boolean),
               time: cells[9] || cells[cells.length - 2] || "",
               artifactContract: cells[cells.length - 1] || ""
             });
@@ -26448,6 +26450,195 @@ function extractStandardRefs(text) {
   return Array.from(new Set(matches));
 }
 
+// src/parsers/lessonEntity.ts
+init_lessonFlowParser();
+var LessonEntitySchema = zod.z.object({
+  lessonId: zod.z.string(),
+  title: zod.z.string(),
+  pedagogyModel: zod.z.string().default("5e"),
+  estimatedDuration: zod.z.string().default(""),
+  learningObjectives: zod.z.array(LearningObjectiveRowSchema).default([]),
+  activitySequence: zod.z.array(ActivitySeqRowSchema).default([]),
+  /** Header→cell rows straight from the A4 Assessment Map table (headers vary by template). */
+  assessmentMap: zod.z.array(zod.z.record(zod.z.string())).default([]),
+  tieredScaffolding: zod.z.object({ bronze: zod.z.string().default(""), silver: zod.z.string().default(""), gold: zod.z.string().default("") }).default({ bronze: "", silver: "", gold: "" })
+});
+var stripMd = (s) => s.replace(/\*\*/g, "").replace(/`/g, "").trim();
+function splitRow(line) {
+  return line.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
+}
+function toActivitySeqRows(md) {
+  const flow = parseLessonFlow(md);
+  const rows = [];
+  for (const a of flow.activities) {
+    const parsed = ActivitySeqRowSchema.safeParse({
+      seq: a.seq,
+      phase: a.phase,
+      activityType: a.activityType,
+      actor: a.actor,
+      purpose: a.purpose,
+      studentAction: a.studentAction,
+      teacherMove: a.teacherMove,
+      outputEvidence: a.outputEvidence,
+      lo: a.lo,
+      durationMinutes: parseInt((a.time || "").replace(/[^0-9]/g, ""), 10) || 10,
+      artifactContract: a.artifactContract
+    });
+    if (parsed.success) rows.push(parsed.data);
+  }
+  return rows;
+}
+function parseLearningObjectives(md) {
+  const rows = [];
+  let inLO = false;
+  let headerSeen = false;
+  for (const line of md.split("\n")) {
+    const h = line.match(/^#{2,4}\s+(.*)$/);
+    if (h) {
+      if (/learning\s+objectives/i.test(h[1] ?? "")) inLO = true;
+      else if (inLO) break;
+      continue;
+    }
+    if (!inLO) continue;
+    const t = line.trim();
+    if (!t.startsWith("|")) continue;
+    if (/^[\s|:-]+$/.test(t)) continue;
+    const cells = splitRow(t);
+    if (cells.length < 4) continue;
+    if (!headerSeen) {
+      headerSeen = true;
+      continue;
+    }
+    const parsed = LearningObjectiveRowSchema.safeParse({
+      code: stripMd(cells[0] ?? ""),
+      objective: stripMd(cells[1] ?? ""),
+      evidence: stripMd(cells[2] ?? ""),
+      successCriteria: stripMd(cells[3] ?? ""),
+      standardRefs: cells[4] ?? "" ? cells[4].split(/[\s,;]+/).filter(Boolean) : [],
+      conceptRefs: []
+    });
+    if (parsed.success) rows.push(parsed.data);
+  }
+  return rows;
+}
+function parseAssessmentMap(md) {
+  const rows = [];
+  let inMap = false;
+  let headers = [];
+  for (const line of md.split("\n")) {
+    const h = line.match(/^#{2,4}\s+(.*)$/);
+    if (h) {
+      if (/assessment\s*map/i.test(h[1] ?? "")) inMap = true;
+      else if (inMap) break;
+      continue;
+    }
+    if (!inMap) continue;
+    const t = line.trim();
+    if (!t.startsWith("|")) continue;
+    if (/^[\s|:-]+$/.test(t)) continue;
+    const cells = splitRow(t);
+    if (headers.length === 0) {
+      headers = cells;
+      continue;
+    }
+    const row = {};
+    headers.forEach((hdr, i) => {
+      row[hdr] = stripMd(cells[i] ?? "");
+    });
+    rows.push(row);
+  }
+  return rows;
+}
+function parseTieredScaffolding(md) {
+  const lines = md.split("\n");
+  let capture = null;
+  for (const line of lines) {
+    const h = line.match(/^#{2,4}\s+(.*)$/);
+    if (h) {
+      const isTier = /elaborate|tiered|scaffold/i.test(h[1] ?? "");
+      if (capture && !isTier) break;
+      if (isTier) capture = [];
+      continue;
+    }
+    if (capture) capture.push(line);
+  }
+  const body = (capture ?? []).join("\n");
+  const grab = (label) => {
+    const m = body.match(new RegExp(`(?:\\ud83e\\udd49|\\ud83e\\udd48|\\ud83e\\udd47)?\\s*\\*\\*${label}:\\*\\*\\s*([^\\n]+)`, "i"));
+    return m ? m[1].trim() : "";
+  };
+  return { bronze: grab("Bronze"), silver: grab("Silver"), gold: grab("Gold") };
+}
+function buildLessonEntityJson(lessonMarkdown) {
+  const md = lessonMarkdown || "";
+  if (!md.trim()) return null;
+  const flow = parseLessonFlow(md);
+  const fm = md.match(/^---\s*\n([\s\S]*?)\n---/)?.[1] ?? "";
+  const activitySequence = toActivitySeqRows(md);
+  const learningObjectives = parseLearningObjectives(md);
+  if (activitySequence.length === 0 && learningObjectives.length === 0) return null;
+  const parsed = LessonEntitySchema.safeParse({
+    lessonId: flow.lessonId || (fm.match(/id:\s*["']?([^"'\n]+)["']?/i)?.[1]?.trim() ?? ""),
+    title: flow.lessonTitle,
+    pedagogyModel: flow.pedagogicalModel,
+    estimatedDuration: flow.estimatedDuration,
+    learningObjectives,
+    activitySequence,
+    assessmentMap: parseAssessmentMap(md),
+    tieredScaffolding: parseTieredScaffolding(md)
+  });
+  return parsed.success ? parsed.data : null;
+}
+function renderEntitySlotsForType(entity, artifactType, maxChars = 8e3) {
+  const type = (artifactType || "").toUpperCase().trim();
+  const parts = [];
+  const wantActivities = ["ACT", "GUIDE", "SLIDE", "WKS", "QUIZ"].includes(type);
+  const wantObjectives = type !== "CODE";
+  const wantAssessment = ["QUIZ", "WKS"].includes(type);
+  const wantTiers = ["ACT", "CODE", "EXT", "WKS"].includes(type);
+  if (wantObjectives && entity.learningObjectives.length > 0) {
+    parts.push(
+      "### Learning Objectives & Evidence\n" + entity.learningObjectives.map((o) => `- ${o.code}: ${o.objective} \u2192 Evidence: ${o.evidence} | Pass: ${o.successCriteria}`).join("\n")
+    );
+  }
+  if (wantActivities && entity.activitySequence.length > 0) {
+    const header = "| Seq | Phase | Activity | Actor | Student Action | Teacher Move | Output/Evidence | LO | Mins | Artifact Contract |";
+    const rows = [];
+    for (const a of entity.activitySequence) {
+      const r = `| ${a.seq} | ${a.phase} | ${a.activityType} | ${a.actor} | ${a.studentAction} | ${a.teacherMove} | ${a.outputEvidence} | ${a.lo.join(",")} | ${a.durationMinutes} | ${a.artifactContract} |`;
+      if (parts.join("\n\n").length + r.length > maxChars) break;
+      rows.push(r);
+    }
+    if (rows.length > 0) {
+      parts.push("### Activity Sequence\n" + [header, "|---|---|---|---|---|---|---|---|---|---|", ...rows].join("\n"));
+    }
+  }
+  if (wantAssessment && entity.assessmentMap.length > 0) {
+    const lines = entity.assessmentMap.map((r) => Object.entries(r).map(([k, v]) => `${k}: ${v}`).join(" | "));
+    parts.push("### Assessment Map (assess exactly these)\n" + lines.join("\n"));
+  }
+  const t = entity.tieredScaffolding;
+  if (wantTiers && (t.bronze || t.silver || t.gold)) {
+    parts.push(
+      "### Tiered task ladder\n" + [t.bronze && `- Bronze: ${t.bronze}`, t.silver && `- Silver: ${t.silver}`, t.gold && `- Gold: ${t.gold}`].filter(Boolean).join("\n")
+    );
+  }
+  return parts.join("\n\n").slice(0, maxChars);
+}
+function entityRowAssignedTo(row, artifactType) {
+  const norm2 = (s) => s.toLowerCase().replace(/[^a-z0-9]/g, "");
+  const wanted = norm2(artifactType);
+  return row.artifactContract.split(/[,;/]/).map((c) => norm2(c)).some((c) => c === wanted || c.length > 3 && (c.includes(wanted) || wanted.includes(c)));
+}
+function renderAssignedRowsTable(entity, artifactType, maxChars = 1500) {
+  const rows = entity.activitySequence.filter((r) => entityRowAssignedTo(r, artifactType));
+  if (rows.length === 0) return "";
+  const header = "| Seq | Phase | Activity | Actor | Student Action | Teacher Move | Output/Evidence | LO | Mins | Artifact Contract |";
+  const sep = "|---|---|---|---|---|---|---|---|---|---|";
+  const body = rows.map((a) => `| ${a.seq} | ${a.phase} | ${a.activityType} | ${a.actor} | ${a.studentAction} | ${a.teacherMove} | ${a.outputEvidence} | ${a.lo.join(",")} | ${a.durationMinutes} | ${a.artifactContract} |`);
+  return [header, sep, ...body].join("\n").slice(0, maxChars);
+}
+
 // src/services/contextSlots.ts
 var LESSON_SLOT_BUDGETS = {
   ACT: { budget: 8e3 },
@@ -26567,6 +26758,7 @@ function buildSatelliteContext(input) {
     slcMarkdown,
     symbolLedgerBlock,
     pedagogyLabel,
+    lessonEntity,
     mode = "legacy"
   } = input;
   const type = (artifactType || "").toUpperCase().trim();
@@ -26611,30 +26803,57 @@ ${kxExcerpt.excerpt}`);
   }
   if (!KX_ONLY_TYPES.has(type)) {
     const spec = LESSON_SLOT_BUDGETS[type] ?? { budget: 12e3 };
-    const excerpt = buildSectionAwareExcerpt(lessonContent, {
-      priorities: spec.priorities ?? ["Artifact Contract", "A. Lesson Design Plan", "B. Lesson Flow", "Learning Objectives & Evidence", "Activity Sequence"],
-      budget: spec.budget,
-      sectionLanguageContract: slcMarkdown,
-      artifactType: "LESSON"
-    });
-    const excerptBlock = `
+    let usedEntity = false;
+    if (lessonEntity) {
+      const slots = renderEntitySlotsForType(lessonEntity, type, spec.budget);
+      if (slots) {
+        const slotBlock = `
+
+[LESSON ENTITY SLOTS (structured JSON source \u2014 canonical)]:
+${slots}`;
+        parts.push(slotBlock);
+        excerptSlot = slotBlock;
+        blocks.push(blockMeta("lessonEntity:" + type, "LESSON_JSON", slots, true));
+        usedEntity = true;
+      } else {
+        issues.push(`lesson-entity:empty-slots:${type}`);
+      }
+    }
+    if (!usedEntity) {
+      const excerpt = buildSectionAwareExcerpt(lessonContent, {
+        priorities: spec.priorities ?? ["Artifact Contract", "A. Lesson Design Plan", "B. Lesson Flow", "Learning Objectives & Evidence", "Activity Sequence"],
+        budget: spec.budget,
+        sectionLanguageContract: slcMarkdown,
+        artifactType: "LESSON"
+      });
+      const excerptBlock = `
 
 [CANONICAL LESSON PLAN (scoped for ${type})]:
 ${excerpt.excerpt}`;
-    parts.push(excerptBlock);
-    excerptSlot = excerptBlock;
-    blocks.push(blockMeta("lessonExcerpt:" + type, "LESSON", excerpt.excerpt, excerpt.verified, excerpt.issues));
-    if (!excerpt.verified) issues.push(...excerpt.issues.map((i) => `lesson:${i}`));
-    if (type === "QUIZ" || type === "WKS") {
-      const am = extractAssessmentMap(lessonContent, 1200);
-      if (am) {
-        parts.push(`
+      parts.push(excerptBlock);
+      excerptSlot = excerptBlock;
+      blocks.push(blockMeta("lessonExcerpt:" + type, "LESSON", excerpt.excerpt, excerpt.verified, excerpt.issues));
+      if (!excerpt.verified) issues.push(...excerpt.issues.map((i) => `lesson:${i}`));
+      if (type === "QUIZ" || type === "WKS") {
+        if (lessonEntity && lessonEntity.assessmentMap.length > 0) {
+          const amJson = lessonEntity.assessmentMap.map((r) => Object.entries(r).map(([k, v]) => `${k}: ${v}`).join(" | ")).join("\n");
+          parts.push(`
+
+[ASSESSMENT MAP (criteria anchor \u2014 assess exactly these)]:
+${amJson}`);
+          blocks.push(blockMeta("assessmentMap:" + type, "LESSON_JSON", amJson, true));
+        } else {
+          const am = extractAssessmentMap(lessonContent, 1200);
+          if (am) {
+            parts.push(`
 
 [ASSESSMENT MAP (criteria anchor \u2014 assess exactly these)]:
 ${am}`);
-        blocks.push(blockMeta("assessmentMap:" + type, "LESSON", am, true));
-      } else {
-        issues.push(`assessment-map:unresolved:${type}`);
+            blocks.push(blockMeta("assessmentMap:" + type, "LESSON", am, true));
+          } else {
+            issues.push(`assessment-map:unresolved:${type}`);
+          }
+        }
       }
     }
     if (symbolLedgerBlock) {
@@ -26642,14 +26861,27 @@ ${am}`);
       blocks.push(blockMeta("symbolLedger", "LESSON", symbolLedgerBlock, true));
     }
   } else {
-    const contractRows = extractActivityContractRows(lessonContent, type === "CODE" ? "CODE_LAB" : type, 1500);
-    const tierBlock = type === "CODE" || type === "EXT" ? extractTieredScaffoldingBlock(lessonContent, 900) : "";
-    const mini = [
-      contractRows ? `### Activity Sequence rows assigned to ${type} (canonical \u2014 do not invent a different task):
-${contractRows}` : "",
-      tierBlock ? `### Tiered task ladder (from LESSON Elaborate phase):
-${tierBlock}` : ""
-    ].filter(Boolean).join("\n\n");
+    const miniParts = [];
+    if (lessonEntity) {
+      const rowsTable = renderAssignedRowsTable(lessonEntity, type === "CODE" ? "CODE_LAB" : type, 1500);
+      if (rowsTable) miniParts.push(`### Activity Sequence rows assigned to ${type} (canonical \u2014 do not invent a different task):
+${rowsTable}`);
+      const t = lessonEntity.tieredScaffolding;
+      if ((type === "CODE" || type === "EXT") && (t.bronze || t.silver || t.gold)) {
+        miniParts.push(
+          "### Tiered task ladder (from LESSON Elaborate phase):\n" + [t.bronze && `- Bronze: ${t.bronze}`, t.silver && `- Silver: ${t.silver}`, t.gold && `- Gold: ${t.gold}`].filter(Boolean).join("\n")
+        );
+      }
+    }
+    if (miniParts.length === 0) {
+      const contractRows = extractActivityContractRows(lessonContent, type === "CODE" ? "CODE_LAB" : type, 1500);
+      const tierBlock = type === "CODE" || type === "EXT" ? extractTieredScaffoldingBlock(lessonContent, 900) : "";
+      if (contractRows) miniParts.push(`### Activity Sequence rows assigned to ${type} (canonical \u2014 do not invent a different task):
+${contractRows}`);
+      if (tierBlock) miniParts.push(`### Tiered task ladder (from LESSON Elaborate phase):
+${tierBlock}`);
+    }
+    const mini = miniParts.join("\n\n");
     if (mini) {
       const miniBlock = `
 
@@ -27343,7 +27575,9 @@ ${sg}${standardsBlock}${glossaryBlock}${buildGroundTruthBlock(includeKx)}${sessi
   });
   const producedArtifacts = [];
   const lessonRelPath = `_content/${unitCode}/LESSON_${lessonCode}.md`;
+  const lessonEntityRelPath = `_content/${unitCode}/LESSON_${lessonCode}.json`;
   const existingLessonContent = await storage.readArtifact(projectId, lessonRelPath);
+  let lessonEntity = buildLessonEntityJson(existingLessonContent || "");
   let lessonContent = existingLessonContent || "";
   if (artifactScope.includes("LESSON") && (!existingLessonContent || force || isStaleVsPlan(existingLessonContent))) {
     if (existingLessonContent && !force && isStaleVsPlan(existingLessonContent)) {
@@ -27419,7 +27653,12 @@ Fix ALL issues above and output the complete corrected document.` }],
     } else {
       lessonContent = lintReport.autoFixedContent || rawLesson;
     }
-    await storage.saveArtifact(projectId, lessonRelPath, stampPlanHash(lessonContent));
+    const stampedLesson = stampPlanHash(lessonContent);
+    await storage.saveArtifact(projectId, lessonRelPath, stampedLesson);
+    lessonEntity = buildLessonEntityJson(stampedLesson);
+    if (lessonEntity) {
+      await storage.saveArtifact(projectId, lessonEntityRelPath, JSON.stringify({ planHash: currentPlanHash ?? null, entity: lessonEntity }, null, 2));
+    }
     producedArtifacts.push(`LESSON_${lessonCode}.md`);
   }
   const contentHash = lessonContent ? computeContentHash(lessonContent) : void 0;
@@ -27741,6 +27980,7 @@ ${currentContent}` }],
         slcMarkdown,
         symbolLedgerBlock,
         pedagogyLabel,
+        lessonEntity,
         mode: routingMode
       });
       satelliteContexts[key] = built.context;
@@ -33287,6 +33527,7 @@ exports.LLMJudgeEngine = LLMJudgeEngine;
 exports.LabTierTaskSchema = LabTierTaskSchema;
 exports.LearningObjectiveInputSchema = LearningObjectiveInputSchema;
 exports.LearningObjectiveRowSchema = LearningObjectiveRowSchema;
+exports.LessonEntitySchema = LessonEntitySchema;
 exports.LessonFlowPhaseSchema = LessonFlowPhaseSchema;
 exports.LessonPlan5ESchema = LessonPlan5ESchema;
 exports.LessonPlanEDPSchema = LessonPlanEDPSchema;
@@ -33406,6 +33647,7 @@ exports.buildHtmlDeckSlidePrompt = buildHtmlDeckSlidePrompt;
 exports.buildImagePrompt = buildImagePrompt;
 exports.buildJudgePrompt = buildJudgePrompt;
 exports.buildLanguageDirective = buildLanguageDirective;
+exports.buildLessonEntityJson = buildLessonEntityJson;
 exports.buildLessonExcerpt = buildLessonExcerpt;
 exports.buildLessonMasterPrompt = buildLessonMasterPrompt;
 exports.buildMarpMarkdownSlidePrompt = buildMarpMarkdownSlidePrompt;
@@ -33444,6 +33686,7 @@ exports.dropCyclicConceptEdges = dropCyclicConceptEdges;
 exports.emitUsage = emitUsage;
 exports.ensureExpositionForLesson = ensureExpositionForLesson;
 exports.ensureKnowledgeExposition = ensureKnowledgeExposition;
+exports.entityRowAssignedTo = entityRowAssignedTo;
 exports.evaluateActivityAlignment = evaluateActivityAlignment;
 exports.evaluateStandardsCoverage = evaluateStandardsCoverage;
 exports.executeCurriculumCommand = executeCurriculumCommand;
@@ -33523,6 +33766,8 @@ exports.produceSingleLesson = produceSingleLesson;
 exports.publishToGitHub = publishToGitHub;
 exports.publishToSupabase = publishToSupabase;
 exports.rankGenCandidates = rankGenCandidates;
+exports.renderAssignedRowsTable = renderAssignedRowsTable;
+exports.renderEntitySlotsForType = renderEntitySlotsForType;
 exports.renderFrameworkFromPlan = renderFrameworkFromPlan;
 exports.renderHorizonPromptBlock = renderHorizonPromptBlock;
 exports.renderMediaPlaceholder = renderMediaPlaceholder;