@thanh01.pmt/curriculum-kit 1.0.6 → 1.0.7

package/dist/workflow/index.cjs

@@ -7,7 +7,7 @@ var google = require('@ai-sdk/google');
 var openai = require('@ai-sdk/openai');
 var deepseek = require('@ai-sdk/deepseek');
 var zod = require('zod');
-var workflowPkg = require('workflow');
+var workflow = require('workflow');
 var fs2 = require('fs/promises');
 var rest = require('@octokit/rest');
 var supabaseJs = require('@supabase/supabase-js');
@@ -17,27 +17,8 @@ require('crypto');
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-function _interopNamespace(e) {
-  if (e && e.__esModule) return e;
-  var n = Object.create(null);
-  if (e) {
-    Object.keys(e).forEach(function (k) {
-      if (k !== 'default') {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
-        });
-      }
-    });
-  }
-  n.default = e;
-  return Object.freeze(n);
-}
-
 var fs__default = /*#__PURE__*/_interopDefault(fs);
 var path4__default = /*#__PURE__*/_interopDefault(path4);
-var workflowPkg__namespace = /*#__PURE__*/_interopNamespace(workflowPkg);
 var fs2__default = /*#__PURE__*/_interopDefault(fs2);
 
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -3885,7 +3866,7 @@ Respond with a valid JSON object matching the schema.`
 async function withRateLimitBackoff(options) {
   let attempt = 1;
   try {
-    const meta = workflowPkg.getStepMetadata();
+    const meta = workflow.getStepMetadata();
     if (meta && typeof meta.attempt === "number") {
       attempt = meta.attempt;
     }
@@ -3901,7 +3882,7 @@ async function withRateLimitBackoff(options) {
     if (isRateLimited || isTransientError) {
       const retryAfterSeconds = Math.min(120, Math.pow(2, attempt) * 2);
       const reason = isRateLimited ? "Rate limit exceeded (429)" : `Transient server error (${status || "network"})`;
-      throw new workflowPkg.RetryableError(`[${options.stepName}] ${reason}. Retrying attempt ${attempt + 1}...`, {
+      throw new workflow.RetryableError(`[${options.stepName}] ${reason}. Retrying attempt ${attempt + 1}...`, {
         retryAfter: `${retryAfterSeconds}s`
       });
     }
@@ -4975,14 +4956,14 @@ async function publishToSupabaseStep(options) {
 
 // src/workflow/gateSettings.ts
 var DEFAULT_GATE_SETTINGS = Object.freeze({
-  LEARNER_PROFILE: "HITL",
-  PROJECT_BRIEF: "HITL",
-  REFERENCE_PACK: "HITL",
-  CURRICULUM_FRAMEWORK: "HITL",
-  KNOWLEDGE_EXPOSITION: "LLM_JUDGE",
-  STYLE_GUIDE: "HITL",
-  ART_DIRECTION: "HITL",
-  LESSON: "LLM_JUDGE",
+  LEARNER_PROFILE: "OFF",
+  PROJECT_BRIEF: "OFF",
+  REFERENCE_PACK: "OFF",
+  CURRICULUM_FRAMEWORK: "OFF",
+  KNOWLEDGE_EXPOSITION: "OFF",
+  STYLE_GUIDE: "OFF",
+  ART_DIRECTION: "OFF",
+  LESSON: "OFF",
   ACT: "OFF",
   QUIZ: "OFF",
   SLIDE: "OFF",
@@ -4990,7 +4971,7 @@ var DEFAULT_GATE_SETTINGS = Object.freeze({
   WKS: "OFF",
   HANDOUT: "OFF",
   EXT: "OFF",
-  CODE: "LLM_JUDGE",
+  CODE: "OFF",
   MEDIA_SCRIPT: "OFF",
   EXIT_TICKET: "OFF"
 });
@@ -5051,10 +5032,10 @@ var approvalPayloadSchema = zod.z.object({
   feedback: zod.z.string().optional().describe("Actionable feedback or required changes if rejected"),
   timestamp: zod.z.string().optional().describe("ISO timestamp of the approval action")
 });
-var hookFactory = workflowPkg__namespace.defineHook || workflowPkg__namespace.createHook || ((opts) => opts);
-var lessonApprovalHook = hookFactory({
-  schema: approvalPayloadSchema
-});
+var lessonApprovalHook = workflow.defineHook();
+function approvalHookToken(projectId, lessonId, artifactType) {
+  return `approval:${projectId}:${lessonId}:${artifactType}`;
+}
 var BloomHintSchema = zod.z.object({
   process: zod.z.enum(["Remember", "Understand", "Apply", "Analyze", "Evaluate", "Create"]).describe("Cognitive process axis"),
   knowledge: zod.z.enum(["FACTUAL", "CONCEPTUAL", "PROCEDURAL", "METACOGNITIVE"]).optional().describe("Knowledge dimension axis (optional \u2014 most source standards do not tag it)")
@@ -5657,9 +5638,9 @@ async function generateMilestoneWorkflow(input) {
   } else if (lessonGate === "HITL") {
     const hookToken = "gate:lesson:" + milestoneId;
     console.log("  \u23F8 [Gate] LESSON awaiting HUMAN review (HITL) \u2014 hook " + hookToken);
-    const workflowPkg2 = await import('workflow');
-    const createHook2 = workflowPkg2.createHook;
-    const hook = createHook2({ token: hookToken });
+    const workflowPkg = await import('workflow');
+    const createHook = workflowPkg.createHook;
+    const hook = createHook({ token: hookToken });
     const review = await hook;
     console.log("  \u2705 [Gate] Human verdict: " + (review.approved ? "APPROVED" : "REJECTED") + (review.feedback ? " \u2014 " + review.feedback : ""));
     if (!review.approved) {
@@ -5679,7 +5660,7 @@ async function generateMilestoneWorkflow(input) {
         standardsContext: standardsContext || void 0,
         modelOptions: input.modelOptions
       });
-      const hook2 = createHook2({ token: hookToken + ":v2" });
+      const hook2 = createHook({ token: hookToken + ":v2" });
       const review2 = await hook2;
       console.log("  \u2705 [Gate] Human verdict (v2): " + (review2.approved ? "APPROVED" : "REJECTED"));
       if (!review2.approved) {
@@ -5867,7 +5848,7 @@ async function generateRoadmapWorkflow(input) {
       }
     }
     if (i + batchSize < milestones.length) {
-      await workflowPkg.sleep("2s");
+      await workflow.sleep("2s");
     }
   }
   const successfulMilestones = milestoneOutcomes.filter((m) => m.status === "FULFILLED").length;
@@ -5915,6 +5896,271 @@ init_streamRunner();
 
 // src/services/lessonProductionService.ts
 init_streamRunner();
+
+// src/ai/llmJudgeEngine.ts
+var LLMJudgeEngine = class {
+  /**
+   * Executes genuine LLM-as-Judge evaluation using the audit flow.
+   */
+  static async evaluateArtifactWithLLM(input) {
+    try {
+      const report = await auditCurriculumQualityFlow({
+        targetArtifactType: input.targetArtifactType,
+        lessonId: input.lessonId,
+        expectedLanguage: input.expectedLanguage,
+        targetObjectives: input.targetObjectives,
+        generatedContentJson: input.generatedContentJson,
+        standardStatements: input.standardStatements,
+        modelOptions: input.modelOptions
+      });
+      const passed = report.overallVerdict === "PASS" && report.languageAdherencePassed;
+      const failedCriteria = report.criteria.filter((c) => !c.passed);
+      const passedCriteria = report.criteria.filter((c) => c.passed);
+      return {
+        decision: report.overallVerdict === "PASS" ? "APPROVED" : report.overallVerdict === "NEEDS_REVISION" ? "NEEDS_REVISION" : "REJECTED",
+        score: report.totalScore,
+        passed,
+        evaluatedBy: "@agent-as-judge",
+        critique: passed ? `H\u1ECDc li\u1EC7u ${input.targetArtifactType} cho b\xE0i "${input.lessonId}" \u0111\u1EA1t \u0111i\u1EC3m th\u1EA9m \u0111\u1ECBnh ${report.totalScore}/100. \u0110\u1EE7 \u0111i\u1EC1u ki\u1EC7n ph\xEA duy\u1EC7t.` : `H\u1ECDc li\u1EC7u ${input.targetArtifactType} ch\u01B0a \u0111\u1EA1t y\xEAu c\u1EA7u: ${failedCriteria.map((c) => c.feedback).join("; ")}`,
+        strengths: passedCriteria.map((c) => `${c.name}: ${c.feedback}`),
+        weaknesses: failedCriteria.map((c) => `${c.name}: ${c.feedback}`),
+        autoRepairInstructions: report.actionableRepairPrompts.length > 0 ? report.actionableRepairPrompts.join("\n") : void 0
+      };
+    } catch (err) {
+      return {
+        decision: "NEEDS_REVISION",
+        score: 50,
+        passed: false,
+        evaluatedBy: "@agent-as-judge",
+        critique: `L\u1ED7i trong qu\xE1 tr\xECnh th\u1EA9m \u0111\u1ECBnh LLM: ${err.message || String(err)}`,
+        strengths: [],
+        weaknesses: ["Kh\xF4ng th\u1EC3 ho\xE0n t\u1EA5t th\u1EA9m \u0111\u1ECBnh t\u1EF1 \u0111\u1ED9ng do s\u1EF1 c\u1ED1 k\u1EBFt n\u1ED1i m\xF4 h\xECnh."],
+        autoRepairInstructions: "Ch\u1EA1y l\u1EA1i quy tr\xECnh th\u1EA9m \u0111\u1ECBnh ho\u1EB7c ki\u1EC3m tra c\u1EA5u h\xECnh API keys."
+      };
+    }
+  }
+  /**
+   * Evaluates Gate 1 (SOT Foundation: LEARNER_PROFILE, PROJECT_BRIEF, REFERENCE_PACK)
+   * Calibrated heuristic pre-check.
+   */
+  static evaluateGate1(learnerProfileMarkdown, referencePackMarkdown) {
+    if (!learnerProfileMarkdown?.trim() || !referencePackMarkdown?.trim()) {
+      return {
+        decision: "REJECTED",
+        score: 0,
+        passed: false,
+        evaluatedBy: "@heuristic-linter",
+        critique: "T\u1EC7p SOT r\u1ED7ng ho\u1EB7c kh\xF4ng t\u1ED3n t\u1EA1i.",
+        strengths: [],
+        weaknesses: ["Thi\u1EBFu n\u1ED9i dung t\u1EC7p SOT c\u01A1 s\u1EDF."],
+        autoRepairInstructions: "Kh\u1EDFi t\u1EA1o v\xE0 bi\xEAn so\u1EA1n \u0111\u1EA7y \u0111\u1EE7 LEARNER_PROFILE.md v\xE0 REFERENCE_PACK.md."
+      };
+    }
+    const hasAgeGroup = /(?:độ tuổi|lứa tuổi|age|grade|thcs|tiểu học|k-12|sinh viên|người đi làm)/i.test(learnerProfileMarkdown);
+    const hasPriorKnowledge = /(?:kiến thức nền|nền tảng|prior knowledge|tiên quyết|prerequisite)/i.test(learnerProfileMarkdown);
+    const hasGroundTruth = /(?:reference|csta|apple|ieee|cs2023|nguồn tham khảo|tài liệu chuẩn|rfc|w3c)/i.test(referencePackMarkdown);
+    const hasClientObjectives = /(?:client objectives|mục tiêu|output|chuẩn đầu ra)/i.test(learnerProfileMarkdown);
+    let score = 30;
+    const strengths = [];
+    const weaknesses = [];
+    if (hasAgeGroup) {
+      score += 20;
+      strengths.push("H\u1ED3 s\u01A1 ng\u01B0\u1EDDi h\u1ECDc x\xE1c \u0111\u1ECBnh r\xF5 \u0111\u1ED1i t\u01B0\u1EE3ng v\xE0 l\u1EE9a tu\u1ED5i m\u1EE5c ti\xEAu.");
+    } else {
+      weaknesses.push("Thi\u1EBFu \u0111\u1ECBnh ngh\u0129a r\xF5 r\xE0ng v\u1EC1 \u0111\u1ED1i t\u01B0\u1EE3ng/\u0111\u1ED9 tu\u1ED5i h\u1ECDc vi\xEAn.");
+    }
+    if (hasPriorKnowledge) {
+      score += 20;
+      strengths.push("C\xF3 ph\xE2n t\xEDch ki\u1EBFn th\u1EE9c n\u1EC1n t\u1EA3ng v\xE0 r\xE0o c\u1EA3n nh\u1EADn th\u1EE9c.");
+    } else {
+      weaknesses.push("Ch\u01B0a l\xE0m r\xF5 ki\u1EBFn th\u1EE9c ti\xEAn quy\u1EBFt (Prerequisites).");
+    }
+    if (hasGroundTruth) {
+      score += 20;
+      strengths.push("REFERENCE_PACK tr\xEDch d\u1EABn t\xE0i li\u1EC7u k\u1EF9 thu\u1EADt chu\u1EA9n m\u1EF1c.");
+    } else {
+      weaknesses.push("T\u1EC7p REFERENCE_PACK thi\u1EBFu danh m\u1EE5c t\xE0i li\u1EC7u tham chi\u1EBFu chu\u1EA9n.");
+    }
+    if (hasClientObjectives) {
+      score += 10;
+      strengths.push("C\xF3 x\xE1c \u0111\u1ECBnh r\xF5 m\u1EE5c ti\xEAu \u0111\u1EA7u ra v\xE0 k\u1EF3 v\u1ECDng kh\xE1ch h\xE0ng.");
+    }
+    const passed = score >= 80;
+    return {
+      decision: passed ? "APPROVED" : score >= 60 ? "NEEDS_REVISION" : "REJECTED",
+      score,
+      passed,
+      evaluatedBy: "@heuristic-linter",
+      critique: passed ? "B\u1ED9 t\xE0i li\u1EC7u n\u1EC1n t\u1EA3ng SOT \u0111\u1EA1t chu\u1EA9n c\u1EA5u tr\xFAc. Cho ph\xE9p chuy\u1EC3n sang Phase 2 (Thi\u1EBFt k\u1EBF Khung ch\u01B0\u01A1ng tr\xECnh)." : "T\xE0i li\u1EC7u SOT c\u1EA7n b\u1ED5 sung th\xEAm c\xE1c tr\u01B0\u1EDDng th\xF4ng tin chu\u1EA9n tr\u01B0\u1EDBc khi ph\xE2n r\xE3 b\xE0i h\u1ECDc.",
+      strengths,
+      weaknesses,
+      autoRepairInstructions: passed ? void 0 : "B\u1ED5 sung \u0111\u1EA7y \u0111\u1EE7 th\xF4ng tin l\u1EE9a tu\u1ED5i, ki\u1EBFn th\u1EE9c ti\xEAn quy\u1EBFt v\xE0 \xEDt nh\u1EA5t 2 ngu\u1ED3n t\xE0i li\u1EC7u k\u1EF9 thu\u1EADt chu\u1EA9n v\xE0o REFERENCE_PACK.md."
+    };
+  }
+  /**
+   * Evaluates Gate 2 (Curriculum Framework: Units, Modules, Lessons, Bloom Progression)
+   */
+  static evaluateGate2(frameworkMarkdown, targetUnitCount = 4) {
+    if (!frameworkMarkdown?.trim()) {
+      return {
+        decision: "REJECTED",
+        score: 0,
+        passed: false,
+        evaluatedBy: "@heuristic-linter",
+        critique: "T\u1EC7p CURRICULUM_FRAMEWORK.md r\u1ED7ng.",
+        strengths: [],
+        weaknesses: ["Thi\u1EBFu n\u1ED9i dung khung ch\u01B0\u01A1ng tr\xECnh."]
+      };
+    }
+    const unitMatches = frameworkMarkdown.match(/(?:##\s+(?:Unit\s+\d+|U\d{2})|\|\s*U\d{2}\s*:|\|\s*Unit\s+\d+)/gi) || [];
+    const hasBloom = /(?:bloom|nhận biết|thông hiểu|vận dụng|phân tích|đánh giá|sáng tạo|remember|understand|apply|analyze|evaluate|create)/i.test(frameworkMarkdown);
+    const has5E = /(?:5e|engage|explore|explain|elaborate|evaluate|pbl|edp|hybrid)/i.test(frameworkMarkdown);
+    const hasScopeSequence = /(?:scope & sequence|lộ trình|tiến trình|bài học)/i.test(frameworkMarkdown);
+    let score = 30;
+    const strengths = [];
+    const weaknesses = [];
+    if (unitMatches.length >= targetUnitCount) {
+      score += 25;
+      strengths.push(`Ph\xE2n r\xE3 \u0111\u1EE7 ${unitMatches.length} Units theo \u0111\xFAng y\xEAu c\u1EA7u c\u1EA5u tr\xFAc.`);
+    } else {
+      score += Math.min(20, unitMatches.length * 5);
+      weaknesses.push(`S\u1ED1 l\u01B0\u1EE3ng Unit (${unitMatches.length}) ch\u01B0a \u0111\u1EA1t m\u1EE5c ti\xEAu ${targetUnitCount} Units.`);
+    }
+    if (hasBloom) {
+      score += 20;
+      strengths.push("C\xF3 ph\xE2n b\u1ED5 thang \u0111o Bloom r\xF5 r\xE0ng theo ti\u1EBFn tr\xECnh nh\u1EADn th\u1EE9c.");
+    } else {
+      weaknesses.push("Thi\u1EBFu \xE1nh x\u1EA1 m\u1EE9c \u0111\u1ED9 Bloom trong c\xE1c b\xE0i h\u1ECDc.");
+    }
+    if (has5E) {
+      score += 15;
+      strengths.push("C\u1EA5u tr\xFAc b\xE0i h\u1ECDc \u0111\u1ECBnh h\u01B0\u1EDBng chu\u1EA9n m\xF4 h\xECnh s\u01B0 ph\u1EA1m (5E/PBL/EDP).");
+    }
+    if (hasScopeSequence) {
+      score += 10;
+      strengths.push("C\xF3 b\u1EA3ng Scope & Sequence chi ti\u1EBFt.");
+    }
+    const passed = score >= 80;
+    return {
+      decision: passed ? "APPROVED" : score >= 60 ? "NEEDS_REVISION" : "REJECTED",
+      score,
+      passed,
+      evaluatedBy: "@heuristic-linter",
+      critique: passed ? "Khung ch\u01B0\u01A1ng tr\xECnh \u0111\u1EA1t chu\u1EA9n ki\u1EBFn tr\xFAc ph\xE2n r\xE3. Cho ph\xE9p ti\u1EBFn h\xE0nh s\u1EA3n xu\u1EA5t h\u1ECDc li\u1EC7u." : "C\u1EA7n b\u1ED5 sung chi ti\u1EBFt c\u1EA5u tr\xFAc b\xE0i h\u1ECDc, b\u1EA3ng ph\xE2n r\xE3 v\xE0 m\u1EE9c \u0111\u1ED9 Bloom t\u01B0\u01A1ng \u1EE9ng.",
+      strengths,
+      weaknesses
+    };
+  }
+  /**
+   * Evaluates a produced Lesson Artifact (LESSON, ACT, QUIZ, SLIDE) with heuristic structure checks
+   */
+  static evaluateArtifact(artifactType, content, lessonTitle) {
+    if (!content?.trim() || content.trim().length < 50) {
+      return {
+        decision: "REJECTED",
+        score: 0,
+        passed: false,
+        evaluatedBy: "@heuristic-linter",
+        critique: `N\u1ED9i dung ${artifactType} cho b\xE0i "${lessonTitle}" qu\xE1 ng\u1EAFn ho\u1EB7c r\u1ED7ng.`,
+        strengths: [],
+        weaknesses: ["H\u1ECDc li\u1EC7u kh\xF4ng c\xF3 n\u1ED9i dung th\u1EF1c t\u1EBF."]
+      };
+    }
+    let score = 40;
+    const strengths = [];
+    const weaknesses = [];
+    switch (artifactType.toUpperCase()) {
+      case "LESSON": {
+        const phases = [
+          { name: "Engage", regex: /(?:Engage|Khởi động|Warm-up|Hook|Mở đầu)/i },
+          { name: "Explore", regex: /(?:Explore|Khám phá|Demo|Thử nghiệm)/i },
+          { name: "Explain", regex: /(?:Explain|Giải thích|Core Concepts|Lý thuyết)/i },
+          { name: "Elaborate", regex: /(?:Elaborate|Vận dụng|Guided Practice|Independent Practice|Challenge|Thực hành)/i },
+          { name: "Evaluate", regex: /(?:Evaluate|Đánh giá|Wrap-up|Exit Ticket|Tổng kết)/i }
+        ];
+        let phaseCount = 0;
+        for (const p of phases) {
+          if (p.regex.test(content)) phaseCount++;
+        }
+        score += phaseCount * 10;
+        if (phaseCount >= 4) {
+          strengths.push(`Gi\xE1o \xE1n bao ph\u1EE7 ${phaseCount}/5 pha c\u1EE7a ti\u1EBFn tr\xECnh 5E.`);
+        } else {
+          weaknesses.push(`Gi\xE1o \xE1n ch\u1EC9 c\xF3 ${phaseCount}/5 pha 5E.`);
+        }
+        if (content.length > 500) score += 10;
+        break;
+      }
+      case "ACT": {
+        const hasSteps = /(?:bước|step\s+\d+|hướng dẫn)/i.test(content);
+        const hasCode = /```[\s\S]*?```/.test(content);
+        const hasObjectives = /(?:mục tiêu|objective|yêu cầu)/i.test(content);
+        if (hasSteps) {
+          score += 20;
+          strengths.push("B\xE0i th\u1EF1c h\xE0nh c\xF3 quy tr\xECnh t\u1EEBng b\u01B0\u1EDBc r\xF5 r\xE0ng.");
+        }
+        if (hasCode) {
+          score += 20;
+          strengths.push("C\xF3 m\xE3 ngu\u1ED3n m\u1EABu/l\u1EC7nh th\u1EF1c thi minh h\u1ECDa.");
+        }
+        if (hasObjectives) {
+          score += 10;
+          strengths.push("C\xF3 x\xE1c \u0111\u1ECBnh m\u1EE5c ti\xEAu th\u1EF1c h\xE0nh.");
+        }
+        break;
+      }
+      case "QUIZ": {
+        const hasQuestions = /(?:question\s*\d+|câu\s*\d+|\?)/i.test(content);
+        const hasOptions = /(?:[A-D]\.|\"options\")/i.test(content);
+        const hasExplanation = /(?:explanation|giải thích|vì sao|đáp án)/i.test(content);
+        if (hasQuestions) {
+          score += 20;
+          strengths.push("C\xF3 c\xE2u h\u1ECFi ch\u1EA9n \u0111o\xE1n.");
+        }
+        if (hasOptions) {
+          score += 20;
+          strengths.push("\u0110\u1EA7y \u0111\u1EE7 c\xE1c l\u1EF1a ch\u1ECDn \u0111\xE1p \xE1n.");
+        }
+        if (hasExplanation) {
+          score += 15;
+          strengths.push("C\xF3 ph\u1EA7n gi\u1EA3i th\xEDch \u0111\xE1p \xE1n chi ti\u1EBFt.");
+        }
+        break;
+      }
+      case "SLIDE": {
+        const hasMarp = /(?:marp:\s*true|---\s*\n)/i.test(content);
+        const slideCount = (content.match(/---\s*\n/g) || []).length;
+        if (hasMarp) {
+          score += 25;
+          strengths.push("\u0110\u1ECBnh d\u1EA1ng t\u01B0\u01A1ng th\xEDch Marp Presentation.");
+        }
+        if (slideCount >= 5) {
+          score += 25;
+          strengths.push(`B\u1ED9 slide c\xF3 dung l\u01B0\u1EE3ng h\u1EE3p l\xFD (${slideCount + 1} slides).`);
+        } else {
+          weaknesses.push(`S\u1ED1 l\u01B0\u1EE3ng slide (${slideCount + 1}) c\xF2n qu\xE1 \xEDt.`);
+        }
+        break;
+      }
+      default: {
+        if (content.length > 200) score += 40;
+        break;
+      }
+    }
+    const passed = score >= 80;
+    return {
+      decision: passed ? "APPROVED" : score >= 60 ? "NEEDS_REVISION" : "REJECTED",
+      score: Math.min(100, score),
+      passed,
+      evaluatedBy: "@heuristic-linter",
+      critique: passed ? `H\u1ECDc li\u1EC7u ${artifactType} cho b\xE0i "${lessonTitle}" \u0111\u1EA1t ki\u1EC3m tra c\u1EA5u tr\xFAc (${score}/100).` : `H\u1ECDc li\u1EC7u ${artifactType} c\u1EA7n ho\xE0n thi\u1EC7n th\xEAm c\u1EA5u tr\xFAc \u0111\u1EC3 \u0111\u1EA1t chu\u1EA9n s\u01B0 ph\u1EA1m (${score}/100).`,
+      strengths,
+      weaknesses
+    };
+  }
+};
+
+// src/services/lessonProductionService.ts
 init_errors();
 
 // src/services/lessonProductionService.ts
@@ -6014,6 +6260,8 @@ async function generateSingleArtifact(req) {
     extraContext,
     config,
     contextSot = {},
+    mediaPolicy,
+    researchContext,
     options = {},
     onChunk
   } = req;
@@ -6051,7 +6299,10 @@ ${langRule}
 3. PEDAGOGICAL GROUNDING: Strictly align with the ${pedagogy.toUpperCase()} model, Bloom's Revised Taxonomy, and IEEE/ACM CS2023 guidelines.
 4. SCAFFOLDING LEVEL: "${scaffoldingLevel.toUpperCase()}".${scaffoldingRule}
 5. TARGET AUDIENCE: ${gradeLevel ? `Grade ${gradeLevel}, ` : ""}${targetAge} on ${hwStr}.${deviceRule}${classDynamicsRule}${extraContextRule}
-6. OUTPUT INTEGRITY: Output clean Markdown starting directly with YAML frontmatter. Do not wrap entire response in triple backticks.${artifactSpecializedPrompt}`;
+6. OUTPUT INTEGRITY: Output clean Markdown starting directly with YAML frontmatter. Do not wrap entire response in triple backticks.${artifactSpecializedPrompt}${mediaPolicy ? `
+
+IMAGE PLANNING (media ledger) \u2014 QUOTA GEN: t\u1ED1i \u0111a ${mediaPolicy.maxGenImagesPerArtifact} \u1EA3nh AI cho artifact n\xE0y (\u1EA3nh search kho kh\xF4ng gi\u1EDBi h\u1EA1n).
+Khi n\u1ED9i dung c\u1EA7n minh h\u1ECDa (diagram quy tr\xECnh, s\u01A1 \u0111\u1ED3 kh\xE1i ni\u1EC7m, step-by-step visual), ch\xE8n placeholder \u0111\xFAng format [IMAGE: slug] (slug ch\u1EEF th\u01B0\u1EDDng-g\u1EA1ch ngang, unique trong b\xE0i, vd img-for-loop-diagram) T\u1EA0I \u0110\xDANG CH\u1ED6 c\u1EA7n \u1EA3nh, tr\xEAn d\xF2ng ri\xEAng. KH\xD4NG t\u1EF1 sinh \u1EA3nh, KH\xD4NG d\xF9ng markdown image \u2014 placeholder s\u1EBD \u0111\u01B0\u1EE3c thay b\u1EB1ng \u1EA3nh th\u1EADt sau khi Media Curator duy\u1EC7t. Ch\u1EC9 \u0111\u1EB7t cho \u1EA3nh TH\u1EF0C S\u1EF0 c\u1EA7n thi\u1EBFt.` : ""}`;
   const userPrompt = `### CONTEXT GROUND TRUTH:
 - Topic / Concept Domain: "${topic}"
 - Lesson ID: "${lessonId || "ON_DEMAND"}"
@@ -6066,6 +6317,9 @@ ${selectedDevices ? `- Device Mode: "${selectedDevices}"
 ` : ""}${extraContext ? `- User Specific Guidance & Requirements: "${extraContext}"
 ` : ""}${config ? `- Full Task Config: ${JSON.stringify(config)}
 ` : ""}
+${researchContext ? `### RESEARCH GROUND TRUTH (fact-checked context \u2014 \u01B0u ti\xEAn d\xF9ng, KH\xD4NG b\u1ECBa s\u1ED1 li\u1EC7u):
+${researchContext.slice(0, 4e3)}
+` : ""}
 ${contextSot.framework ? `### SOT CURRICULUM FRAMEWORK:
 ${contextSot.framework.slice(0, 1500)}
 ` : ""}
@@ -6106,13 +6360,171 @@ Generate the complete, thorough, publication-grade "${artifactType.toUpperCase()
       }
     );
     const { thought, content } = extractThoughtAndContent(rawResult);
-    return {
-      artifactType,
-      filename: meta.filename,
-      content: content || accumulatedContent,
-      persona: meta.persona,
-      thought: thought || accumulatedThought
+    const finalContent = content || accumulatedContent;
+    const finalThought = thought || accumulatedThought;
+    const gates = resolveGateSettings(req.gateSettings);
+    const kitGateType = {
+      lesson: "LESSON",
+      slide: "SLIDE",
+      act: "ACT",
+      quiz: "QUIZ",
+      guide: "GUIDE",
+      handout: "HANDOUT",
+      worksheet: "WKS",
+      ext: "EXT",
+      codelab: "CODE",
+      exit_ticket: "EXIT_TICKET"
+    }[artifactType];
+    const gateMode = kitGateType ? gateModeFor(gates, kitGateType) : "OFF";
+    if (gateMode === "OFF") {
+      return { artifactType, filename: meta.filename, content: finalContent, persona: meta.persona, thought: finalThought };
+    }
+    const injectReviewMeta = (doc, metaMap) => {
+      const fm = doc.match(/^---\s*\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+      if (!fm) {
+        return `---
+${Object.entries(metaMap).map(([k, v]) => `${k}: "${v}"`).join("\n")}
+---
+
+${doc}`;
+      }
+      let yaml = fm[1] ?? "";
+      for (const [k, v] of Object.entries(metaMap)) {
+        const re = new RegExp(`^${k}:.*$`, "m");
+        if (re.test(yaml)) yaml = yaml.replace(re, `${k}: "${v}"`);
+        else yaml += `
+${k}: "${v}"`;
+      }
+      return doc.replace(fm[0], `---
+${yaml.trim()}
+---
+`);
     };
+    if (gateMode === "HITL") {
+      return {
+        artifactType,
+        filename: meta.filename,
+        content: injectReviewMeta(finalContent, { review_status: "PENDING_REVIEW", review_decision: "PENDING" }),
+        persona: meta.persona,
+        thought: finalThought,
+        pausedForReview: true,
+        gateStatus: "awaiting_approval"
+      };
+    }
+    const judgeObjectives = [{ code: "A1", description: `Artifact fulfills its pedagogical contract for topic "${topic}" with complete required sections`, bloomLevel: "Analyze" }];
+    try {
+      const verdict = await LLMJudgeEngine.evaluateArtifactWithLLM({
+        targetArtifactType: artifactType.toUpperCase(),
+        lessonId: lessonId || "ON_DEMAND",
+        expectedLanguage: language.toLowerCase().includes("viet") ? "vietnamese" : "english",
+        targetObjectives: judgeObjectives,
+        generatedContentJson: JSON.stringify({ content: finalContent, artifactType, lessonId: lessonId || "ON_DEMAND", title: displayTitle })
+      });
+      const passed = Boolean(verdict.passed) && verdict.score >= 85;
+      if (passed) {
+        return {
+          artifactType,
+          filename: meta.filename,
+          content: injectReviewMeta(finalContent, {
+            review_status: "APPROVED",
+            reviewed_by: "@reviewer (LLM-as-Judge)",
+            review_decision: "APPROVED"
+          }),
+          persona: meta.persona,
+          thought: finalThought,
+          judgeScore: verdict.score,
+          judgeCritique: verdict.critique
+        };
+      }
+      const repairFeedback = [verdict.autoRepairInstructions, ...verdict.weaknesses || []].filter(Boolean).join("\n");
+      const repairedRaw = await streamCurriculumAIInference(
+        [
+          { role: "user", content: `You previously authored \`${meta.filename}\` and the academic Judge REJECTED it with the critique below.
+Rewrite the COMPLETE corrected document: fix every listed issue, keep the mandatory structure, frontmatter and all approved sections. Output 100% clean Markdown only.
+
+JUDGE CRITIQUE:
+${repairFeedback}
+
+CURRENT DOCUMENT:
+${finalContent}` }
+        ],
+        userPrompt,
+        { ...options, systemPersona: systemPrompt },
+        (chunk, type) => {
+          if (onChunk) onChunk(chunk, type === "thought" ? "thought" : "content");
+        }
+      );
+      const repairedExtract = extractThoughtAndContent(repairedRaw);
+      const repaired = repairedExtract.content || repairedRaw;
+      if (repaired && repaired.trim().length > 100) {
+        const reVerdict = await LLMJudgeEngine.evaluateArtifactWithLLM({
+          targetArtifactType: artifactType.toUpperCase(),
+          lessonId: lessonId || "ON_DEMAND",
+          expectedLanguage: language.toLowerCase().includes("viet") ? "vietnamese" : "english",
+          targetObjectives: judgeObjectives,
+          generatedContentJson: JSON.stringify({ content: repaired, artifactType, lessonId: lessonId || "ON_DEMAND", title: displayTitle })
+        });
+        if (reVerdict.passed && reVerdict.score >= 85) {
+          return {
+            artifactType,
+            filename: meta.filename,
+            content: injectReviewMeta(repaired, {
+              review_status: "APPROVED",
+              reviewed_by: "@reviewer (LLM-as-Judge)",
+              review_decision: "APPROVED"
+            }),
+            persona: meta.persona,
+            thought: repairedExtract.thought || "",
+            judgeScore: reVerdict.score,
+            judgeCritique: reVerdict.critique
+          };
+        }
+        return {
+          artifactType,
+          filename: meta.filename,
+          content: injectReviewMeta(repaired, {
+            review_status: "NEEDS_REVISION",
+            reviewed_by: "@reviewer (LLM-as-Judge)",
+            review_decision: "NEEDS_REVISION"
+          }),
+          persona: meta.persona,
+          thought: repairedExtract.thought || "",
+          pausedForReview: true,
+          gateStatus: "judge_needs_revision",
+          judgeScore: reVerdict.score,
+          judgeCritique: reVerdict.critique
+        };
+      }
+      return {
+        artifactType,
+        filename: meta.filename,
+        content: injectReviewMeta(finalContent, {
+          review_status: "NEEDS_REVISION",
+          reviewed_by: "@reviewer (LLM-as-Judge)",
+          review_decision: "NEEDS_REVISION"
+        }),
+        persona: meta.persona,
+        thought: finalThought,
+        pausedForReview: true,
+        gateStatus: "judge_needs_revision",
+        judgeScore: verdict.score,
+        judgeCritique: verdict.critique
+      };
+    } catch (judgeErr) {
+      return {
+        artifactType,
+        filename: meta.filename,
+        content: injectReviewMeta(finalContent, {
+          review_status: "NEEDS_REVISION",
+          review_decision: "NEEDS_REVISION",
+          critique: `Judge unavailable (fail-closed): ${String(judgeErr?.message || judgeErr).slice(0, 300)}`
+        }),
+        persona: meta.persona,
+        thought: finalThought,
+        pausedForReview: true,
+        gateStatus: "judge_error"
+      };
+    }
   } catch (error) {
     throw createAiInferenceError({
       errorCode: "ERR_AI_ALL_PROVIDERS_FAILED",
@@ -6387,6 +6799,7 @@ async function generateSingleArtifactWorkflow(request) {
 }
 
 exports.DEFAULT_GATE_SETTINGS = DEFAULT_GATE_SETTINGS;
+exports.approvalHookToken = approvalHookToken;
 exports.approvalPayloadSchema = approvalPayloadSchema;
 exports.executeSingleArtifactStep = executeSingleArtifactStep;
 exports.gateModeFor = gateModeFor;