@thanh01.pmt/curriculum-kit 1.4.37 → 1.4.39

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] || ""
             });
@@ -2839,11 +2841,51 @@ var ExtensionSchema = zod.z.object({
 });
 var QualityAuditVerdictSchema = zod.z.enum(["PASS", "NEEDS_REVISION", "FAIL"]);
 var JudgeCriterionSchema = zod.z.object({
-  name: zod.z.string().describe("Criterion name, e.g. Bloom Alignment, Code Validity, Word Count Gate, Language Adherence"),
+  name: zod.z.string().describe("Criterion name, e.g. Bloom Alignment, Code Validity, Word Count Gate, Language Adherence, Step Incrementality"),
   passed: zod.z.boolean(),
   score: zod.z.number().min(0).max(100).describe("Score out of 100"),
   feedback: zod.z.string().describe("Constructive feedback or citation of issues")
 });
+var ActionableRepairActionSchema = zod.z.enum([
+  "SPLIT_STEP",
+  "REVISE_PROVISIONING",
+  "INSERT_RECAP",
+  "ADJUST_TIME_BUDGET",
+  "SUBSTITUTE_FALLBACK",
+  "REVISE_EXIT_EVIDENCE"
+]);
+var ActionableRepairPromptSchema = zod.z.object({
+  action: ActionableRepairActionSchema,
+  targetId: zod.z.string().describe("ID of the session, feature, or step requiring repair, e.g. U01_M01_L02 or F1-S3"),
+  severity: zod.z.enum(["CRITICAL", "WARNING", "INFO"]).default("WARNING"),
+  rationale: zod.z.string().describe("Pedagogical or technical rationale for why this repair is mandated"),
+  instruction: zod.z.string().describe("Exact, actionable text instruction for the planner/generator in the next turn")
+});
+var ProjectGraphAuditSchema = zod.z.object({
+  schema_version: zod.z.number().default(1),
+  projectId: zod.z.string(),
+  overallVerdict: QualityAuditVerdictSchema,
+  totalScore: zod.z.number().min(0).max(100),
+  toolchainFeasibility: JudgeCriterionSchema.describe("Installation friction, admin rights, IDE/compiler matrix"),
+  provisioningStrategy: JudgeCriterionSchema.describe("Clear model for heavy runtimes: Pre-installed lab, Cloud instance, or Dedicated setup"),
+  hardwareRuntimeEnvelope: JudgeCriterionSchema.describe("Memory/Flash limits, pinout conflicts, hardware platform alignment"),
+  timeToHelloWorld: JudgeCriterionSchema.describe("Student time to achieve first working feedback loop (target <= 15 mins)"),
+  actionableRepairs: zod.z.array(ActionableRepairPromptSchema).default([])
+});
+var MacroPedagogyPlanAuditSchema = zod.z.object({
+  schema_version: zod.z.number().default(1),
+  planHash: zod.z.string(),
+  overallVerdict: QualityAuditVerdictSchema,
+  totalScore: zod.z.number().min(0).max(100),
+  autoApproved: zod.z.boolean().default(false).describe("True if totalScore >= 85 and overallVerdict is PASS"),
+  stepIncrementality: JudgeCriterionSchema.describe("Single leap principle: <= 1 new syntax or 1 new algorithm per step"),
+  zpdSaturation: JudgeCriterionSchema.describe("Vygotsky ZPD: <= 2 new concepts per session (K-12) / 3 (Adults), with prior anchor"),
+  frictionAdjustedBudget: JudgeCriterionSchema.describe("Student time multiplier (2.5x): total content <= 85% session minutes"),
+  epitomeViability: JudgeCriterionSchema.describe("Reigeluth Walking Skeleton: Unit 1 produces an end-to-end runnable MVP"),
+  exitEvidenceSpecificity: JudgeCriterionSchema.describe("Tangible, measurable student deliverable for every session"),
+  actionableRepairs: zod.z.array(ActionableRepairPromptSchema).default([]),
+  summary: zod.z.string().describe("High-level executive evaluation summary")
+});
 var CurriculumQualityReportSchema = zod.z.object({
   targetArtifactType: zod.z.string().describe("Type of artifact audited, e.g. LESSON, ACT, CODE, WKS, SLIDE"),
   lessonId: zod.z.string(),
@@ -2851,7 +2893,8 @@ var CurriculumQualityReportSchema = zod.z.object({
   totalScore: zod.z.number().min(0).max(100),
   languageAdherencePassed: zod.z.boolean().describe("True if content strictly matches the requested target language"),
   criteria: zod.z.array(JudgeCriterionSchema).min(3),
-  actionableRepairPrompts: zod.z.array(zod.z.string()).default([]).describe("Concrete instruction prompts to fix detected issues in the next repair turn")
+  actionableRepairPrompts: zod.z.array(zod.z.string()).default([]).describe("Concrete instruction prompts to fix detected issues in the next repair turn"),
+  structuredRepairs: zod.z.array(ActionableRepairPromptSchema).optional()
 });
 var ProjectProfileSchema = zod.z.object({
   id: zod.z.string().optional(),
@@ -6735,6 +6778,111 @@ Please return a single JSON object matching these exact keys:
 - "actionableRepairPrompts": string[]
 `.trim();
 }
+function buildCurriculumPlanJudgePrompt(input) {
+  const { planJson, briefingContext, expectedLanguage = "Vietnamese", linterFindings = [] } = input;
+  return `
+# System Methodology: Principal Curriculum SME & Macro-Pedagogical Quality Judge (@sme_judge)
+
+You are the **Lead Curriculum Architect & Classroom Practicum SME**. Your role is to rigorously evaluate a candidate \`CURRICULUM_PLAN\` (Schema v3) against empirical pedagogical science, cognitive load capacity, and real classroom delivery constraints.
+
+## COURSE BRIEFING & TARGET CONSTRAINTS
+${briefingContext}
+
+${linterFindings.length > 0 ? `## DETERMINISTIC PRE-LINT FINDINGS (0-TOKEN LINTER)
+The deterministic structural linter detected the following issues in advance:
+${linterFindings.map((f) => `- [${f.severity}] ${f.id}: ${f.title} \u2014 ${f.description}`).join("\n")}
+Consider these deterministic findings when scoring and issuing actionable repair prescriptions.` : ""}
+
+## CANDIDATE CURRICULUM PLAN JSON
+\`\`\`json
+${planJson}
+\`\`\`
+
+## EVALUATION RUBRICS & 5 CRITICAL DIMENSIONS (TOTAL 100 POINTS)
+
+1. **Step Incrementality & Single Leap Principle (20 pts):**
+   - 20 pts: Every session introduces at most ONE new syntax or algorithmic concept. No massive cognitive leaps (e.g. going from basic variables directly to asynchronous networking).
+   - 10 pts: Minor leap detected in 1 session that can be mitigated with starter code.
+   - 0 pts: Severe cognitive gap (e.g. multiple compound paradigms combined in one session).
+
+2. **Vygotsky ZPD Saturation & Cognitive Capacity (20 pts):**
+   - 20 pts: New concept count <= 2 per session (K-12) / 3 (Adults), with explicit prior concept anchor or recap slot.
+   - 10 pts: Session introduces 3 concepts without adequate bridge.
+   - 0 pts: Severe overload (>3 new concepts in a single session) or unanchored concepts.
+
+3. **Classroom Friction-Adjusted Time Budget (20 pts):**
+   - 20 pts: Incorporates 2.5x student friction multiplier. Total content minutes <= 85% of session duration (15% overhead reserved). No step > 76 minutes.
+   - 10 pts: Content is slightly packed, leaving < 10% buffer time.
+   - 0 pts: Overpacked content that will cause students to run out of time in a standard classroom.
+
+4. **Reigeluth Walking Skeleton & Milestone Agency (20 pts):**
+   - 20 pts: Unit 1 culminates in an end-to-end runnable MVP (Epitome). Subsequent units provide modular elaborations.
+   - 10 pts: Walking skeleton present but delayed to Unit 2.
+   - 0 pts: Pure theoretical silo teaching where no working product appears until the end of the course.
+
+5. **Exit Evidence Specificity (20 pts):**
+   - 20 pts: Every session produces an explicit, tangible, user-visible deliverable (e.g. running UI screen, passing test suite, physical LED sequence).
+   - 10 pts: Some sessions have generic deliverables ("completed practice exercise").
+   - 0 pts: Vague or absent deliverables ("student understands topic").
+
+## DECISION RULES
+- **PASS & AUTO-APPROVE:** Total Score >= 85 AND overallVerdict is "PASS" AND no CRITICAL actionable repairs.
+- **NEEDS_REVISION:** Total Score between 70 and 84, or fixable flaws. Prescribe concrete structured \`actionableRepairs\` (\`SPLIT_STEP\`, \`INSERT_RECAP\`, \`ADJUST_TIME_BUDGET\`, \`REVISE_EXIT_EVIDENCE\`).
+- **FAIL:** Total Score < 70, structural collapse, or unbridgeable pedagogical gaps.
+
+## OUTPUT FORMAT
+Return a valid JSON object matching the MacroPedagogyPlanAuditSchema.
+`.trim();
+}
+function buildProjectGraphJudgePrompt(input) {
+  const { bundleJson, briefingContext, linterFindings = [] } = input;
+  return `
+# System Methodology: Lead Systems Engineer & Lab Infrastructure Auditor (@infra_judge)
+
+You are the **Lead Lab Systems Engineer**. Your role is to rigorously evaluate a candidate \`PROJECT_GRAPH\` and its associated \`technology_scope\` against real-world lab environment feasibility, toolchain friction, and hardware constraints.
+
+## COURSE BRIEFING & INFRASTRUCTURE CONSTRAINTS
+${briefingContext}
+
+${linterFindings.length > 0 ? `## DETERMINISTIC PRE-LINT FINDINGS
+${linterFindings.map((f) => `- [${f.severity}] ${f.id}: ${f.title} \u2014 ${f.description}`).join("\n")}` : ""}
+
+## CANDIDATE PROJECT GRAPH BUNDLE JSON
+\`\`\`json
+${bundleJson}
+\`\`\`
+
+## EVALUATION RUBRICS & 4 DIMENSIONS (TOTAL 100 POINTS)
+
+1. **Toolchain & Installation Feasibility (25 pts):**
+   - 25 pts: Toolchain installs cleanly without complex admin rights, OS friction, or fragile build scripts.
+   - 10 pts: Toolchain requires moderate admin setup, suitable for guided lab but risky for BYOD.
+   - 0 pts: High-friction setup that frequently breaks in student environments.
+
+2. **Environment Provisioning Strategy (25 pts):**
+   - 25 pts: Heavy technologies (PostgreSQL, Docker, ROS2, etc.) declare an explicit, realistic provisioning model (\`PRE_INSTALLED_LAB\`, \`CLOUD_MANAGED\`, or \`DEDICATED_SETUP\`). Core course topics are NEVER downgraded; instead, proper infrastructure is specified.
+   - 10 pts: Heavy tech used with ambiguous provisioning plan.
+   - 0 pts: Heavy tech dumped on students with no provisioning strategy, causing setup collapse.
+
+3. **Hardware & Runtime Envelope (25 pts):**
+   - 25 pts: Code, libraries, and algorithms fit comfortably within target device RAM, Flash, and pinout budget (<= 75% envelope).
+   - 10 pts: Memory or resource limits are tight.
+   - 0 pts: Guaranteed hardware crash or pinout conflict.
+
+4. **Time to Hello World (25 pts):**
+   - 25 pts: First working runnable milestone achieved in <= 15 minutes of student effort.
+   - 10 pts: First milestone takes 20-30 minutes.
+   - 0 pts: Student spends the entire first session on environment configuration without seeing running code.
+
+## DECISION RULES
+- **PASS:** Score >= 85 AND overallVerdict is "PASS".
+- **NEEDS_REVISION:** Score between 70 and 84. Prescribe structured actionable repairs.
+- **FAIL:** Score < 70 or critical environment blocker.
+
+## OUTPUT FORMAT
+Return a valid JSON object matching ProjectGraphAuditSchema.
+`.trim();
+}
 
 // src/ai/prompts/projectInstructionPrompt.ts
 function buildProjectInstructionPrompt(input) {
@@ -7176,6 +7324,23 @@ async function generateExtensionFlow(input) {
 
 // src/ai/flows/auditCurriculumQualityFlow.ts
 init_provider_factory();
+
+// src/constants/pedagogy.ts
+var STUDENT_FRICTION_MULTIPLIER = 2.5;
+var MAX_NEW_CONCEPTS_PER_SESSION_K12 = 2;
+var MAX_NEW_CONCEPTS_PER_SESSION_ADULT = 3;
+var DEFAULT_OVERHEAD_RATIO = 0.15;
+var MAX_IN_SESSION_SETUP_MINUTES = 15;
+var ENVIRONMENT_PROVISIONING_MODELS = [
+  "PRE_INSTALLED_LAB",
+  "CLOUD_MANAGED",
+  "DEDICATED_SETUP"
+];
+var JUDGE_AUTO_APPROVE_THRESHOLD = 85;
+var JUDGE_ESCALATE_THRESHOLD = 70;
+var MAX_AUTONOMOUS_REPAIR_TURNS = 3;
+
+// src/ai/flows/auditCurriculumQualityFlow.ts
 async function auditCurriculumQualityFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildJudgePrompt({
@@ -7191,6 +7356,43 @@ async function auditCurriculumQualityFlow(input) {
     schema: CurriculumQualityReportSchema,
     prompt: `${prompt}
 
+Respond with a valid JSON object matching the schema.`
+  });
+  return object;
+}
+async function auditCurriculumPlanFlow(input) {
+  const model = getAIModel(input.modelOptions);
+  const prompt = buildCurriculumPlanJudgePrompt({
+    planJson: input.planJson,
+    briefingContext: input.briefingContext,
+    expectedLanguage: input.expectedLanguage,
+    linterFindings: input.linterFindings
+  });
+  const { object } = await ai.generateObject({
+    model,
+    schema: MacroPedagogyPlanAuditSchema,
+    prompt: `${prompt}
+
+Respond with a valid JSON object matching the schema.`
+  });
+  const autoApproved = object.totalScore >= JUDGE_AUTO_APPROVE_THRESHOLD && object.overallVerdict === "PASS";
+  return {
+    ...object,
+    autoApproved
+  };
+}
+async function auditProjectGraphFlow(input) {
+  const model = getAIModel(input.modelOptions);
+  const prompt = buildProjectGraphJudgePrompt({
+    bundleJson: input.bundleJson,
+    briefingContext: input.briefingContext,
+    linterFindings: input.linterFindings
+  });
+  const { object } = await ai.generateObject({
+    model,
+    schema: ProjectGraphAuditSchema,
+    prompt: `${prompt}
+
 Respond with a valid JSON object matching the schema.`
   });
   return object;
@@ -26448,6 +26650,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 +26958,7 @@ function buildSatelliteContext(input) {
     slcMarkdown,
     symbolLedgerBlock,
     pedagogyLabel,
+    lessonEntity,
     mode = "legacy"
   } = input;
   const type = (artifactType || "").toUpperCase().trim();
@@ -26611,30 +27003,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 +27061,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 +27775,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 +27853,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 +28180,7 @@ ${currentContent}` }],
         slcMarkdown,
         symbolLedgerBlock,
         pedagogyLabel,
+        lessonEntity,
         mode: routingMode
       });
       satelliteContexts[key] = built.context;
@@ -31545,6 +31985,113 @@ var DeterministicStructuralLinter = class {
     } else if (plan.mastery_gates && plan.mastery_gates.length > 0) {
       strengths.push(`${plan.mastery_gates.length} inter-unit Mastery Gates defined with remediation protocols.`);
     }
+    const maxContentMinutes = Math.floor(
+      (plan.constraints?.session_duration_minutes || 90) * (1 - DEFAULT_OVERHEAD_RATIO)
+    );
+    for (const s of plan.sessions) {
+      const contentMins = (s.knowledge_minutes || 0) + (s.practice_minutes || 0);
+      if (contentMins > maxContentMinutes + 2) {
+        score -= 5;
+        findings.push({
+          id: `PLAN_OVERSIZED_SESSION_${s.id}`,
+          dimension: "CONSTRUCTIVE_ALIGNMENT",
+          severity: "MINOR",
+          title: `Content Minutes Exceeded in Session ${s.id}`,
+          description: `Session planned for ${contentMins} content minutes exceeds the ${maxContentMinutes}m budget (15% overhead reserve).`,
+          remediationAdvice: `Reduce knowledge or practice minutes to fit within ${maxContentMinutes} minutes.`,
+          affectedElement: s.id
+        });
+      }
+      if (!s.exit_evidence || s.exit_evidence.length === 0 || !s.exit_evidence[0] || s.exit_evidence[0].trim().length < 3) {
+        score -= 5;
+        findings.push({
+          id: `PLAN_VAGUE_EXIT_EVIDENCE_${s.id}`,
+          dimension: "CONSTRUCTIVE_ALIGNMENT",
+          severity: "MINOR",
+          title: `Vague or Missing Exit Evidence in Session ${s.id}`,
+          description: `Session lacks a concrete, measurable user-visible deliverable.`,
+          remediationAdvice: `Specify an explicit exit evidence deliverable (e.g. running UI screen, passing test, or hardware actuation).`,
+          affectedElement: s.id
+        });
+      }
+    }
+    score = Math.max(0, Math.min(100, score));
+    const passed = score >= 80 && !findings.some((f) => f.severity === "CRITICAL");
+    return { passed, score, findings, strengths };
+  }
+  /**
+   * Validates structural and environment feasibility invariants for a Project Graph bundle.
+   */
+  static lintProjectGraph(bundle, expectedSessions = 12) {
+    const findings = [];
+    const strengths = [];
+    let score = 100;
+    const graph = bundle?.project_graph;
+    const scope = bundle?.technology_scope;
+    if (!graph || !Array.isArray(graph.features) || graph.features.length === 0) {
+      score -= 40;
+      findings.push({
+        id: "GRAPH_MISSING_FEATURES",
+        dimension: "CROSS_ARTIFACT_ZERO_DRIFT",
+        severity: "CRITICAL",
+        title: "Missing Features in Project Graph",
+        description: "Project graph has no features array or empty features.",
+        remediationAdvice: "Declare at least 3 progressive features with concrete steps."
+      });
+      return { passed: false, score: Math.max(0, score), findings, strengths };
+    }
+    const allSteps = graph.features.flatMap((f) => f.steps || []);
+    if (allSteps.length === 0) {
+      score -= 30;
+      findings.push({
+        id: "GRAPH_EMPTY_STEPS",
+        dimension: "CROSS_ARTIFACT_ZERO_DRIFT",
+        severity: "CRITICAL",
+        title: "Empty Steps in Project Graph",
+        description: "Features contain no executable steps.",
+        remediationAdvice: "Add 2 to 4 concrete steps per feature."
+      });
+    }
+    for (const step of allSteps) {
+      const est = step.effort?.estimated_minutes || 0;
+      if (est > 76) {
+        score -= 10;
+        findings.push({
+          id: `GRAPH_OVERSIZED_STEP_${step.id || "step"}`,
+          dimension: "CONSTRUCTIVE_ALIGNMENT",
+          severity: "MAJOR",
+          title: `Step ${step.id || step.name} Exceeds Content Budget`,
+          description: `Step requires ${est} minutes, which exceeds the 76-minute single-session ceiling.`,
+          remediationAdvice: `Split step into two sequential sub-steps to prevent artificial session fragmentation.`,
+          affectedElement: step.id
+        });
+      }
+    }
+    const allTechStrings = [
+      scope?.platform || "",
+      ...Array.isArray(scope?.libraries_and_apis) ? scope.libraries_and_apis : [],
+      ...Array.isArray(scope?.toolchain) ? scope.toolchain : [],
+      JSON.stringify(graph.project?.tech_stack || {})
+    ].join(" ").toLowerCase();
+    const heavyKeywords = ["postgres", "postgresql", "docker", "kubernetes", "ros2", "oracle", "sql server"];
+    const hasHeavyTech = heavyKeywords.some((k) => allTechStrings.includes(k));
+    if (hasHeavyTech) {
+      const declaredStrategy = scope?.provisioning_strategy || scope?.provisioning_model || graph.project?.provisioning_strategy;
+      const isValidStrategy = ENVIRONMENT_PROVISIONING_MODELS.includes(declaredStrategy);
+      if (!isValidStrategy) {
+        score -= 15;
+        findings.push({
+          id: "GRAPH_UNPROVISIONED_HEAVY_TECH",
+          dimension: "CONSTRUCTIVE_ALIGNMENT",
+          severity: "MAJOR",
+          title: "Heavy Technology Without Declared Lab Provisioning Strategy",
+          description: `Course uses heavy/server technology without declaring a valid provisioning strategy (PRE_INSTALLED_LAB, CLOUD_MANAGED, or DEDICATED_SETUP).`,
+          remediationAdvice: `Specify provisioning_strategy as PRE_INSTALLED_LAB, CLOUD_MANAGED, or DEDICATED_SETUP to ensure classroom feasibility.`
+        });
+      } else {
+        strengths.push(`Heavy technology stack backed by explicit provisioning model: ${declaredStrategy}`);
+      }
+    }
     score = Math.max(0, Math.min(100, score));
     const passed = score >= 80 && !findings.some((f) => f.severity === "CRITICAL");
     return { passed, score, findings, strengths };
@@ -33187,6 +33734,8 @@ exports.ACT_TEMPLATE = ACT_TEMPLATE;
 exports.ARTIFACT_DEPENDENCY_ROUTING = ARTIFACT_DEPENDENCY_ROUTING;
 exports.ARTIFACT_EXECUTION_ORDER = ARTIFACT_EXECUTION_ORDER;
 exports.AcademicAuditor = AcademicAuditor;
+exports.ActionableRepairActionSchema = ActionableRepairActionSchema;
+exports.ActionableRepairPromptSchema = ActionableRepairPromptSchema;
 exports.ActiveLearningWorkflowSchema = ActiveLearningWorkflowSchema;
 exports.ActivityLabSchema = ActivityLabSchema;
 exports.ActivitySeqRowSchema = ActivitySeqRowSchema;
@@ -33233,6 +33782,7 @@ exports.DEFAULT_ENABLED_PROVIDERS = DEFAULT_ENABLED_PROVIDERS;
 exports.DEFAULT_GATE_SETTINGS = DEFAULT_GATE_SETTINGS;
 exports.DEFAULT_KX_PRIORITIES = DEFAULT_KX_PRIORITIES;
 exports.DEFAULT_LESSON_PRIORITIES = DEFAULT_LESSON_PRIORITIES;
+exports.DEFAULT_OVERHEAD_RATIO = DEFAULT_OVERHEAD_RATIO;
 exports.DEFAULT_STREAM_IDLE_MS = DEFAULT_STREAM_IDLE_MS;
 exports.DEFAULT_STREAM_TOTAL_MS = DEFAULT_STREAM_TOTAL_MS;
 exports.DEFAULT_VIETNAMESE_SECTION_HEADINGS = DEFAULT_VIETNAMESE_SECTION_HEADINGS;
@@ -33244,6 +33794,7 @@ exports.DeterministicStructuralLinter = DeterministicStructuralLinter;
 exports.DiagnosticQuestionSchema = DiagnosticQuestionSchema;
 exports.DiagnosticQuizSchema = DiagnosticQuizSchema;
 exports.EDPPhaseEnum = EDPPhaseEnum;
+exports.ENVIRONMENT_PROVISIONING_MODELS = ENVIRONMENT_PROVISIONING_MODELS;
 exports.EXIT_TICKET_TEMPLATE = EXIT_TICKET_TEMPLATE;
 exports.EXPOSITION_REL = EXPOSITION_REL;
 exports.EXT_TEMPLATE = EXT_TEMPLATE;
@@ -33279,6 +33830,8 @@ exports.HandoutSchema = HandoutSchema;
 exports.HandoutSectionSchema = HandoutSectionSchema;
 exports.InstructionSectionSchema = InstructionSectionSchema;
 exports.InstructionStepSchema = InstructionStepSchema;
+exports.JUDGE_AUTO_APPROVE_THRESHOLD = JUDGE_AUTO_APPROVE_THRESHOLD;
+exports.JUDGE_ESCALATE_THRESHOLD = JUDGE_ESCALATE_THRESHOLD;
 exports.JudgeCriterionSchema = JudgeCriterionSchema;
 exports.LAYER_IDLE_BUDGET_MS = LAYER_IDLE_BUDGET_MS;
 exports.LAYER_TOTAL_BUDGET_MS = LAYER_TOTAL_BUDGET_MS;
@@ -33287,12 +33840,18 @@ exports.LLMJudgeEngine = LLMJudgeEngine;
 exports.LabTierTaskSchema = LabTierTaskSchema;
 exports.LearningObjectiveInputSchema = LearningObjectiveInputSchema;
 exports.LearningObjectiveRowSchema = LearningObjectiveRowSchema;
+exports.LessonEntitySchema = LessonEntitySchema;
 exports.LessonFlowPhaseSchema = LessonFlowPhaseSchema;
 exports.LessonPlan5ESchema = LessonPlan5ESchema;
 exports.LessonPlanEDPSchema = LessonPlanEDPSchema;
 exports.LessonPlanSchema = LessonPlanSchema;
 exports.LessonSectionSchema = LessonSectionSchema;
 exports.LocalWorkspaceManager = LocalWorkspaceManager;
+exports.MAX_AUTONOMOUS_REPAIR_TURNS = MAX_AUTONOMOUS_REPAIR_TURNS;
+exports.MAX_IN_SESSION_SETUP_MINUTES = MAX_IN_SESSION_SETUP_MINUTES;
+exports.MAX_NEW_CONCEPTS_PER_SESSION_ADULT = MAX_NEW_CONCEPTS_PER_SESSION_ADULT;
+exports.MAX_NEW_CONCEPTS_PER_SESSION_K12 = MAX_NEW_CONCEPTS_PER_SESSION_K12;
+exports.MacroPedagogyPlanAuditSchema = MacroPedagogyPlanAuditSchema;
 exports.MappingKindSchema = MappingKindSchema;
 exports.MarpSlideSchema = MarpSlideSchema;
 exports.MasteryGateSchema = MasteryGateSchema;
@@ -33315,6 +33874,7 @@ exports.PrerequisiteDecisionEntrySchema = PrerequisiteDecisionEntrySchema;
 exports.PrerequisiteDecisionSchema = PrerequisiteDecisionSchema;
 exports.ProductGoalSchema = ProductGoalSchema;
 exports.ProgressiveHintsSchema = ProgressiveHintsSchema;
+exports.ProjectGraphAuditSchema = ProjectGraphAuditSchema;
 exports.ProjectGraphSchema = ProjectGraphSchema;
 exports.ProjectInstructionSchema = ProjectInstructionSchema;
 exports.ProjectProfileSchema = ProjectProfileSchema;
@@ -33341,6 +33901,7 @@ exports.SLIDE_TEMPLATE = SLIDE_TEMPLATE;
 exports.STANDARD_REF_REGEX = STANDARD_REF_REGEX;
 exports.STANDARD_SOT_FILES = STANDARD_SOT_FILES;
 exports.STATION_ROTATION_TEMPLATE = STATION_ROTATION_TEMPLATE;
+exports.STUDENT_FRICTION_MULTIPLIER = STUDENT_FRICTION_MULTIPLIER;
 exports.ScaffoldDecisionEntrySchema = ScaffoldDecisionEntrySchema;
 exports.ScaffoldDecisionSchema = ScaffoldDecisionSchema;
 exports.ScienceLabSchema = ScienceLabSchema;
@@ -33387,13 +33948,16 @@ exports.assertAcyclic = assertAcyclic;
 exports.assessorTools = assessorTools;
 exports.assignDepths = assignDepths;
 exports.atomicWriteFileSync = atomicWriteFileSync;
+exports.auditCurriculumPlanFlow = auditCurriculumPlanFlow;
 exports.auditCurriculumQualityFlow = auditCurriculumQualityFlow;
+exports.auditProjectGraphFlow = auditProjectGraphFlow;
 exports.auditQualityReport = auditQualityReport;
 exports.buildActivityPrompt = buildActivityPrompt;
 exports.buildCodeLabPrompt = buildCodeLabPrompt;
 exports.buildConceptPrerequisites = buildConceptPrerequisites;
 exports.buildCurriculumContext = buildCurriculumContext;
 exports.buildCurriculumPlan = buildCurriculumPlan;
+exports.buildCurriculumPlanJudgePrompt = buildCurriculumPlanJudgePrompt;
 exports.buildDeliveryPackages = buildDeliveryPackages;
 exports.buildDiagnosticQuizPrompt = buildDiagnosticQuizPrompt;
 exports.buildDomainLexiconGuardrail = buildDomainLexiconGuardrail;
@@ -33406,10 +33970,12 @@ exports.buildHtmlDeckSlidePrompt = buildHtmlDeckSlidePrompt;
 exports.buildImagePrompt = buildImagePrompt;
 exports.buildJudgePrompt = buildJudgePrompt;
 exports.buildLanguageDirective = buildLanguageDirective;
+exports.buildLessonEntityJson = buildLessonEntityJson;
 exports.buildLessonExcerpt = buildLessonExcerpt;
 exports.buildLessonMasterPrompt = buildLessonMasterPrompt;
 exports.buildMarpMarkdownSlidePrompt = buildMarpMarkdownSlidePrompt;
 exports.buildMasteryGates = buildMasteryGates;
+exports.buildProjectGraphJudgePrompt = buildProjectGraphJudgePrompt;
 exports.buildProjectInstructionPrompt = buildProjectInstructionPrompt;
 exports.buildSatelliteContext = buildSatelliteContext;
 exports.buildSectionAwareExcerpt = buildSectionAwareExcerpt;
@@ -33444,6 +34010,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 +34090,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;