@thanh01.pmt/curriculum-kit 1.0.5 → 1.0.7

package/dist/index.cjs

@@ -14,35 +14,16 @@ var supabaseJs = require('@supabase/supabase-js');
 var url = require('url');
 var jsonrepair = require('jsonrepair');
 var rest = require('@octokit/rest');
-var workflowPkg = require('workflow');
+var workflow = require('workflow');
 
 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 fs2__default = /*#__PURE__*/_interopDefault(fs2);
 var path3__default = /*#__PURE__*/_interopDefault(path3);
 var pLimit__default = /*#__PURE__*/_interopDefault(pLimit);
 var fsPromises__default = /*#__PURE__*/_interopDefault(fsPromises);
 var crypto__default = /*#__PURE__*/_interopDefault(crypto);
-var workflowPkg__namespace = /*#__PURE__*/_interopNamespace(workflowPkg);
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -4261,9 +4242,9 @@ _Unit: {{UNIT_ID}} | Module: {{MODULE_ID}} | Format: Mermaid Diagrams + Printabl
 var SLIDE_LAYOUT_PRESETS = [
   {
     id: "title-hero",
-    name: "B\xECa & Gi\u1EDBi thi\u1EC7u (Title Cover)",
+    name: "Title & Speaker Cover",
     category: "cover",
-    description: "Slide b\xECa m\u1EDF \u0111\u1EA7u \u1EA5n t\u01B0\u1EE3ng v\u1EDBi ti\xEAu \u0111\u1EC1 l\u1EDBn, ph\u1EE5 \u0111\u1EC1 v\xE0 th\xF4ng tin gi\u1EA3ng vi\xEAn.",
+    description: "High-impact opening slide with large title, subtitle, and speaker credentials.",
     layout: {
       boxes: [
         {
@@ -4308,22 +4289,22 @@ var SLIDE_LAYOUT_PRESETS = [
       textAlign: center
 -->
 
-# \u{1F680} Ti\xEAu \u0110\u1EC1 B\xE0i Gi\u1EA3ng Ch\xEDnh
-### Ph\u1EE5 \u0111\u1EC1 ng\u1EAFn g\u1ECDn, truy\u1EC1n c\u1EA3m h\u1EE9ng v\xE0 \u0111\u1ECBnh v\u1ECB m\u1EE5c ti\xEAu
+# \u{1F680} Engineering Scalable Cloud Systems
+### Principles, Bottlenecks, and Real-World Architecture Patterns
 
-**Gi\u1EA3ng vi\xEAn:** Th\u1EA7y Nguy\u1EC5n V\u0103n A | **Th\u1EDDi l\u01B0\u1EE3ng:** 45 ph\xFAt | **C\u1EA5p \u0111\u1ED9:** Trung c\u1EA5p
+**Presenter:** Senior Systems Architect | **Duration:** 45 mins | **Level:** Intermediate
 
 <!--
 Presenter Notes:
-- Ch\xE0o m\u1EEBng h\u1ECDc vi\xEAn, gi\u1EDBi thi\u1EC7u m\u1EE5c ti\xEAu b\xE0i h\u1ECDc h\xF4m nay.
-- Kh\u01A1i g\u1EE3i s\u1EF1 t\xF2 m\xF2 b\u1EB1ng c\xE2u h\u1ECFi m\u1EDF \u0111\u1EA7u v\u1EC1 b\xE0i to\xE1n th\u1EF1c t\u1EBF.
+- Welcome the audience and outline today's primary engineering goals.
+- Spark curiosity with an opening hook about scaling under high concurrency.
 -->`
   },
   {
     id: "two-column-split",
-    name: "So S\xE1nh 2 C\u1ED9t (2-Column Comparison)",
+    name: "Two-Column Comparison",
     category: "split",
-    description: "B\u1ED1 c\u1EE5c chia \u0111\xF4i m\xE0n h\xECnh \u0111\u1EC3 so s\xE1nh ph\u01B0\u01A1ng ph\xE1p c\u0169 vs m\u1EDBi, l\xFD thuy\u1EBFt vs th\u1EF1c t\u1EBF.",
+    description: "Balanced side-by-side comparison for legacy vs modern patterns or pros vs cons.",
     layout: {
       boxes: [
         {
@@ -4358,38 +4339,38 @@ Presenter Notes:
       pos: [670, 150, 530, 510]
 -->
 
-## \u2696\uFE0F So S\xE1nh Kh\xE1i Ni\u1EC7m & Gi\u1EA3i Ph\xE1p
+## \u2696\uFE0F Monolithic Polling vs Event-Driven Architecture
 
 <div class="columns-2">
 <div>
 
-### \u{1F534} C\xE1ch Ti\u1EBFp C\u1EADn C\u0169
-- X\u1EED l\xFD th\u1EE7 c\xF4ng, t\u1ED1n nhi\u1EC1u nh\xE2n l\u1EF1c
-- D\u1EC5 ph\xE1t sinh sai s\u1ED1 do thao t\xE1c l\u1EB7p l\u1EA1i
-- Kh\xF3 m\u1EDF r\u1ED9ng khi t\u1EA3i t\u0103ng \u0111\u1ED9t bi\u1EBFn
+### \u{1F534} Legacy Polling
+- Heavy database CPU overhead on idle cycles
+- High network latency between updates
+- Prone to cascading timeouts during spikes
 
 </div>
 <div>
 
-### \u{1F7E2} Gi\u1EA3i Ph\xE1p T\u1ED1i \u01AFu M\u1EDBi
-- T\u1EF1 \u0111\u1ED9ng h\xF3a ho\xE0n to\xE0n lu\u1ED3ng x\u1EED l\xFD
-- Gi\xE1m s\xE1t tr\u1EA1ng th\xE1i th\u1EDDi gian th\u1EF1c
-- Kh\u1EA3 n\u0103ng co gi\xE3n linh ho\u1EA1t theo nhu c\u1EA7u
+### \u{1F7E2} Event-Driven Streams
+- Real-time event propagation via webhooks
+- Zero idle compute waste with serverless consumers
+- Automatic backpressure and queue isolation
 
 </div>
 </div>
 
 <!--
 Presenter Notes:
-- Nh\u1EA5n m\u1EA1nh \u0111i\u1EC3m ngh\u1EBDn l\u1EDBn nh\u1EA5t \u1EDF c\u1ED9t b\xEAn tr\xE1i.
-- D\u1EABn ch\u1EE9ng s\u1ED1 li\u1EC7u th\u1EF1c t\u1EBF ch\u1EE9ng minh t\xEDnh hi\u1EC7u qu\u1EA3 c\u1EE7a c\u1ED9t ph\u1EA3i.
+- Emphasize the core failure mode of periodic polling under sudden load spikes.
+- Ask the room if anyone has experienced database lockups caused by polling loops.
 -->`
   },
   {
     id: "code-explainer",
-    name: "Gi\u1EA3i Th\xEDch Code (Code Walkthrough)",
+    name: "Code Walkthrough & Analysis",
     category: "code",
-    description: "C\u1ED9t tr\xE1i hi\u1EC3n th\u1ECB code snippet c\xF3 \u0111\xE1nh s\u1ED1, c\u1ED9t ph\u1EA3i gi\u1EA3i th\xEDch t\u1EEBng b\u01B0\u1EDBc ho\u1EA1t \u0111\u1ED9ng.",
+    description: "Syntax-highlighted code block on the left with step-by-step key annotations on the right.",
     layout: {
       boxes: [
         {
@@ -4424,16 +4405,16 @@ Presenter Notes:
       pos: [740, 135, 460, 535]
 -->
 
-## \u{1F4BB} Ph\xE2n T\xEDch C\u1EA5u Tr\xFAc M\xE3 Ngu\u1ED3n
+## \u{1F4BB} Robust Async Transaction Pipeline
 
 <div class="columns-2">
 <div>
 
 \`\`\`ts
-// Kh\u1EDFi t\u1EA1o quy tr\xECnh ki\u1EC3m tra d\u1EEF li\u1EC7u
+// Process payment with idempotency guarantee
 export async function processPayment(order: Order) {
   const isValid = await validateOrder(order);
-  if (!isValid) throw new Error("Invalid");
+  if (!isValid) throw new Error("ValidationFailed");
 
   const receipt = await chargeCard(order);
   return sendConfirmation(receipt);
@@ -4443,25 +4424,26 @@ export async function processPayment(order: Order) {
 </div>
 <div>
 
-### \u{1F50D} 3 \u0110i\u1EC3m C\u1EA7n Ch\xFA \xDD:
-1. **Ki\u1EC3m tra s\u1EDBm (Guard Clause):** Ki\u1EC3m tra t\xEDnh h\u1EE3p l\u1EC7 ngay d\xF2ng 3 \u0111\u1EC3 tr\xE1nh g\u1ECDi h\xE0m t\u1ED1n chi ph\xED.
-2. **B\u1EA5t \u0111\u1ED3ng b\u1ED9 (Async/Await):** \u0110\u1EA3m b\u1EA3o th\u1EE9 t\u1EF1 g\u1ECDi API t\xE0i ch\xEDnh chu\u1EA9n x\xE1c.
-3. **Ph\u1EA3n h\u1ED3i ng\u01B0\u1EDDi d\xF9ng:** Tr\u1EA3 v\u1EC1 bi\xEAn lai ho\xE0n ch\u1EC9nh sau khi giao d\u1ECBch th\xE0nh c\xF4ng.
+### \u{1F50D} Key Engineering Invariants:
+1. **Early Guard Clause:** Validates payload immediately at line 3 before triggering external calls.
+2. **Deterministic Sequence:** Enforces strict order of operations using native \`await\`.
+3. **Audit Trail:** Returns immutable payment receipt upon successful execution.
 
 </div>
 </div>
 
 <!--
 Presenter Notes:
-- Y\xEAu c\u1EA7u h\u1ECDc vi\xEAn x\xE1c \u0111\u1ECBnh d\xF2ng code n\xE0o l\xE0 r\u1EE7i ro nh\u1EA5t n\u1EBFu k\u1EBFt n\u1ED1i m\u1EA1ng b\u1ECB r\u1EDBt.
-- Nh\u1EAFc l\u1EA1i nguy\xEAn t\u1EAFc Fail-Fast trong l\u1EADp tr\xECnh ph\xF2ng th\u1EE7.
+- Walk through lines 1 to 7 sequentially.
+- Cold-call check: "What happens if line 6 throws a network timeout?"
+- Cognitive scaffolding: Highlight the importance of idempotency keys in payment APIs.
 -->`
   },
   {
     id: "metrics-3-card",
-    name: "L\u01B0\u1EDBi 3 Ch\u1EC9 S\u1ED1 (3-Metric Dashboard)",
+    name: "3-Metric Key Results Grid",
     category: "metrics",
-    description: "Hi\u1EC3n th\u1ECB 3 ch\u1EC9 s\u1ED1 quan tr\u1ECDng (KPIs, Benchmarks, Impact) d\u1EA1ng card n\u1ED5i b\u1EADt.",
+    description: "Three high-visibility KPI stat cards for benchmarks, impact, and success criteria.",
     layout: {
       boxes: [
         {
@@ -4506,43 +4488,43 @@ Presenter Notes:
       pos: [860, 165, 340, 485]
 -->
 
-## \u{1F4CA} 3 Ch\u1EC9 S\u1ED1 Th\xE0nh C\xF4ng C\u1EE7a D\u1EF1 \xC1n
+## \u{1F4CA} Performance & Reliability Benchmarks
 
 <div class="columns-3">
 <div>
 
-# \u26A1 99.9%
-### \u0110\u1ED9 S\u1EB5n S\xE0ng (Uptime)
-H\u1EC7 th\u1ED1ng v\u1EADn h\xE0nh li\xEAn t\u1EE5c 24/7 v\u1EDBi kh\u1EA3 n\u0103ng t\u1EF1 ph\u1EE5c h\u1ED3i l\u1ED7i t\u1EE9c th\xEC.
+# \u26A1 99.99%
+### SLA Availability
+High-availability multi-region cluster with automated failover routing.
 
 </div>
 <div>
 
-# \u{1F680} 10x
-### T\u1ED1c \u0110\u1ED9 X\u1EED L\xFD
-R\xFAt ng\u1EAFn th\u1EDDi gian bi\xEAn d\u1ECBch v\xE0 ph\u1EA3n h\u1ED3i ng\u01B0\u1EDDi d\xF9ng t\u1EEB gi\xE2y xu\u1ED1ng mili-gi\xE2y.
+# \u{1F680} 15ms
+### P99 Latency
+Sub-20ms roundtrip response time via distributed edge caching.
 
 </div>
 <div>
 
-# \u{1F6E1}\uFE0F 0
-### L\u1ED7 H\u1ED5ng B\u1EA3o M\u1EADt
-\u0110\u1EA1t chu\u1EA9n \u0111\xE1nh gi\xE1 an to\xE0n OWASP v\xE0 m\xE3 h\xF3a d\u1EEF li\u1EC7u \u0111\u1EA7u cu\u1ED1i.
+# \u{1F6E1}\uFE0F Zero
+### Unhandled Breaches
+Full SOC2 Type II compliance and end-to-end payload encryption.
 
 </div>
 </div>
 
 <!--
 Presenter Notes:
-- Tr\xECnh b\xE0y l\u1EA7n l\u01B0\u1EE3t 3 m\u1EE5c ti\xEAu \u0111o l\u01B0\u1EDDng \u0111\u01B0\u1EE3c c\u1EE7a h\u1EC7 th\u1ED1ng.
-- Nh\u1EA5n m\u1EA1nh ch\u1EC9 s\u1ED1 th\u1EE9 2 l\xE0 tr\u1ECDng t\xE2m k\u1EF9 thu\u1EADt c\u1EE7a b\xE0i h\u1ECDc h\xF4m nay.
+- Highlight the 15ms P99 latency target as the primary technical milestone.
+- Connect these metrics directly to the architecture decisions discussed next.
 -->`
   },
   {
     id: "process-flow",
-    name: "S\u01A1 \u0110\u1ED3 Quy Tr\xECnh (Process / Flowchart)",
+    name: "Architecture & Process Flow",
     category: "diagram",
-    description: "Quy tr\xECnh nhi\u1EC1u b\u01B0\u1EDBc v\u1EDBi s\u01A1 \u0111\u1ED3 Mermaid tr\u1EF1c quan k\xE8m ghi ch\xFA t\xF3m t\u1EAFt.",
+    description: "Multi-stage workflow with responsive Mermaid diagram and phase summaries.",
     layout: {
       boxes: [
         {
@@ -4577,33 +4559,33 @@ Presenter Notes:
       pos: [80, 465, 1120, 205]
 -->
 
-## \u{1F504} Ki\u1EBFn Tr\xFAc Lu\u1ED3ng D\u1EEF Li\u1EC7u 4 B\u01B0\u1EDBc
+## \u{1F504} End-to-End Data Ingestion Pipeline
 
 \`\`\`mermaid
 graph LR
-    A[1. Client Request] --> B[2. API Gateway]
-    B --> C[3. Auth Service]
-    C --> D[4. Database Cluster]
+    A[1. Client Ingress] --> B[2. API Gateway]
+    B --> C[3. Auth Verifier]
+    C --> D[4. Distributed DB]
     style A fill:#0284c7,stroke:#38bdf8,stroke-width:2px,color:#fff
     style B fill:#1e293b,stroke:#64748b,stroke-width:2px,color:#fff
     style C fill:#059669,stroke:#34d399,stroke-width:2px,color:#fff
     style D fill:#7c3aed,stroke:#a78bfa,stroke-width:2px,color:#fff
 \`\`\`
 
-- **Giai \u0111o\u1EA1n 1 & 2:** Ti\u1EBFp nh\u1EADn y\xEAu c\u1EA7u t\u1EEB client, \u0111i\u1EC1u h\u01B0\u1EDBng t\u1EA3i v\xE0 gi\u1EDBi h\u1EA1n t\u1EA7n su\u1EA5t (Rate Limiting).
-- **Giai \u0111o\u1EA1n 3 & 4:** X\xE1c th\u1EF1c token JWT ph\xE2n quy\u1EC1n tr\u01B0\u1EDBc khi truy v\u1EA5n d\u1EEF li\u1EC7u t\u1EEB DB Cluster.
+- **Ingress & Gateway:** Rate-limits traffic and applies reverse-proxy load balancing.
+- **Verification & Storage:** Decodes cryptographic JWT tokens before transactional write commit.
 
 <!--
 Presenter Notes:
-- Tr\u1ECF tr\u1EF1c ti\u1EBFp v\xE0o t\u1EEBng node c\u1EE7a s\u01A1 \u0111\u1ED3 Mermaid khi thuy\u1EBFt tr\xECnh.
-- \u0110\u1EB7t c\xE2u h\u1ECFi: "N\u1EBFu b\u01B0\u1EDBc 3 th\u1EA5t b\u1EA1i th\xEC b\u01B0\u1EDBc 4 c\xF3 \u0111\u01B0\u1EE3c g\u1ECDi kh\xF4ng?"
+- Trace each hop across the diagram from left to right.
+- Ask: "Where should rate limiting be applied to prevent DDoS attacks?"
 -->`
   },
   {
     id: "quote-highlight",
-    name: "Th\xF4ng \u0110i\u1EC7p Then Ch\u1ED1t (Quote / Highlight)",
+    name: "Core Principle & Quote Highlight",
     category: "quote",
-    description: "Tr\xEDch d\u1EABn danh ng\xF4n ho\u1EB7c nguy\xEAn t\u1EAFc v\xE0ng c\u1EA7n ghi nh\u1EDB s\xE2u s\u1EAFc.",
+    description: "Prominent quote callout for fundamental engineering rules or memorable mantras.",
     layout: {
       boxes: [
         {
@@ -4634,23 +4616,23 @@ Presenter Notes:
       fontSize: 1.4rem
 -->
 
-## \u{1F4A1} Nguy\xEAn T\u1EAFc Thi\u1EBFt K\u1EBF C\u1ED1t L\xF5i
+## \u{1F4A1} Foundational Architecture Principle
 
-> "S\u1EF1 \u0111\u01A1n gi\u1EA3n l\xE0 \u0111i\u1EC1u ki\u1EC7n ti\xEAn quy\u1EBFt cho \u0111\u1ED9 tin c\u1EADy. M\u1ED9t ki\u1EBFn tr\xFAc t\u1ED1t l\xE0 khi b\u1EA5t k\u1EF3 l\u1EADp tr\xECnh vi\xEAn m\u1EDBi n\xE0o c\u0169ng c\xF3 th\u1EC3 \u0111\u1ECDc hi\u1EC3u lu\u1ED3ng ho\u1EA1t \u0111\u1ED9ng ch\u1EC9 sau 15 ph\xFAt."
+> "Simplicity is prerequisite for reliability. A well-engineered distributed system is one where a new engineer can understand the request flow within their first hour."
 > 
 > \u2014 **Edsger W. Dijkstra**
 
 <!--
 Presenter Notes:
-- D\u1EEBng l\u1EA1i 5 gi\xE2y im l\u1EB7ng \u0111\u1EC3 c\u1EA3 l\u1EDBp c\xF9ng suy ng\u1EABm v\u1EC1 th\xF4ng \u0111i\u1EC7p.
-- Y\xEAu c\u1EA7u m\u1ED9t h\u1ECDc vi\xEAn chia s\u1EBB suy ngh\u0129 v\u1EC1 c\xE1ch \xE1p d\u1EE5ng nguy\xEAn t\u1EAFc n\xE0y v\xE0o b\xE0i t\u1EADp l\u1EDBn.
+- Pause for 5 seconds of silence to let the quote sink in.
+- Ask: "How do our current architectural choices reflect this principle?"
 -->`
   },
   {
     id: "quiz-checkpoint",
-    name: "Tr\u1EAFc Nghi\u1EC7m T\u01B0\u01A1ng T\xE1c (Quiz Checkpoint)",
+    name: "Interactive Formative Checkpoint",
     category: "assessment",
-    description: "C\xE2u h\u1ECFi t\u01B0\u01A1ng t\xE1c Formative Checkpoint k\xE8m c\xE1c l\u1EF1a ch\u1ECDn A/B/C/D \u0111\u1EC3 l\u1EDBp b\xECnh ch\u1ECDn.",
+    description: "Interactive multiple-choice diagnostic checkpoint with A/B/C/D voting options.",
     layout: {
       boxes: [
         {
@@ -4689,27 +4671,27 @@ Presenter Notes:
       fontSize: 1.15rem
 -->
 
-## \u{1F3AF} Ki\u1EC3m Tra Nhanh: B\u1EA1n \u0110\xE3 Hi\u1EC3u \u0110\xFAng?
+## \u{1F3AF} Formative Checkpoint: Verify Your Understanding
 
-> **C\xE2u h\u1ECFi:** Trong ki\u1EBFn tr\xFAc Microservices, c\u01A1 ch\u1EBF n\xE0o gi\xFAp \u0111\u1EA3m b\u1EA3o tin nh\u1EAFn kh\xF4ng b\u1ECB th\u1EA5t l\u1EA1c khi d\u1ECBch v\u1EE5 nh\u1EADn g\u1EB7p s\u1EF1 c\u1ED1 t\u1EA1m th\u1EDDi?
+> **Question:** In an event-driven architecture, which pattern guarantees that messages are never permanently lost if a downstream consumer crashes?
 
-- **A.** G\u1ECDi API HTTP tr\u1EF1c ti\u1EBFp v\u1EDBi timeout ng\u1EAFn
-- **B.** S\u1EED d\u1EE5ng Message Queue (H\xE0ng \u0111\u1EE3i tin nh\u1EAFn) c\xF3 c\u01A1 ch\u1EBF Retry & DLQ
-- **C.** L\u01B0u t\u1EA1m v\xE0o b\u1ED9 nh\u1EDB RAM c\u1EE7a m\xE1y kh\xE1ch (Client In-Memory Storage)
-- **D.** B\u1ECF qua tin nh\u1EAFn b\u1ECB l\u1ED7i v\xE0 th\xF4ng b\xE1o ng\u01B0\u1EDDi d\xF9ng g\u1EEDi l\u1EA1i t\u1EEB \u0111\u1EA7u
+- **A.** Direct synchronous HTTP request with short 2-second timeout
+- **B.** Persistent Message Broker with Dead-Letter Queue (DLQ) & retry policy
+- **C.** In-memory client RAM cache without persistence
+- **D.** Discarding failed packets and prompting the user to re-submit
 
 <!--
 Presenter Notes:
-- D\xE0nh 30 gi\xE2y cho h\u1ECDc vi\xEAn gi\u01A1 tay ho\u1EB7c b\xECnh ch\u1ECDn \u0111\xE1p \xE1n.
-- \u0110\xE1p \xE1n ch\xEDnh x\xE1c: B.
-- Gi\u1EA3i th\xEDch v\xEC sao \u0111\xE1p \xE1n A v\xE0 C ti\u1EC1m \u1EA9n nguy c\u01A1 m\u1EA5t m\xE1t d\u1EEF li\u1EC7u nghi\xEAm tr\u1ECDng.
+- Give students 30 seconds to vote on option A, B, C, or D.
+- Correct answer: B.
+- Explain why options A and C introduce catastrophic data loss in production.
 -->`
   },
   {
     id: "tiered-practice-3cards",
-    name: "Th\u1EF1c H\xE0nh Ph\xE2n H\xF3a (Tiered Practice)",
+    name: "Tiered Differentiation (Bronze / Silver / Gold)",
     category: "content",
-    description: "3 c\u1EA5p b\u1EADc nhi\u1EC7m v\u1EE5 \u0110\u1ED3ng - B\u1EA1c - V\xE0ng \u0111\u1EC3 h\u1ECDc sinh t\u1EF1 ch\u1ECDn m\u1EE9c th\u1EED th\xE1ch ph\xF9 h\u1EE3p.",
+    description: "Three progressive competency tiers allowing self-paced learning acceleration.",
     layout: {
       boxes: [
         {
@@ -4752,46 +4734,46 @@ Presenter Notes:
       pos: [850, 140, 350, 520]
 -->
 
-## \u{1F6E0}\uFE0F Th\u1EED Th\xE1ch Ph\xE2n H\xF3a 3 C\u1EA5p \u0110\u1ED9 (Tiered Lab)
+## \u{1F6E0}\uFE0F Hands-On Challenge: 3-Tier Differentiation
 
 <div class="columns-3">
 <div>
 
-### \u{1F949} H\u1EA1ng \u0110\u1ED3ng (Bronze)
-- Vi\u1EBFt h\xE0m x\u1EED l\xFD c\u01A1 b\u1EA3n
-- V\u01B0\u1EE3t qua 3 test case m\u1EABu
-- *M\u1EE5c ti\xEAu: \u0110\u1EA1t chu\u1EA9n ki\u1EBFn th\u1EE9c c\u01A1 b\u1EA3n*
+### \u{1F949} Bronze Tier
+- Implement baseline function
+- Pass 3 baseline unit tests
+- *Goal: Foundational mastery*
 
 </div>
 <div>
 
-### \u{1F948} H\u1EA1ng B\u1EA1c (Silver)
-- Th\xEAm ki\u1EC3m tra \u0111i\u1EC1u ki\u1EC7n bi\xEAn
-- T\u1ED1i \u01B0u \u0111\u1ED9 ph\u1EE9c t\u1EA1p thu\u1EADt to\xE1n O(N)
-- *M\u1EE5c ti\xEAu: V\u1EEFng v\xE0ng k\u1EF9 n\u0103ng th\u1EF1c chi\u1EBFn*
+### \u{1F948} Silver Tier
+- Add boundary error handling
+- Enforce O(N) memory complexity
+- *Goal: Production-ready code*
 
 </div>
 <div>
 
-### \u{1F947} H\u1EA1ng V\xE0ng (Gold)
-- Thi\u1EBFt k\u1EBF t\xEDnh n\u0103ng m\u1EDF r\u1ED9ng
-- Vi\u1EBFt Unit Test t\u1EF1 \u0111\u1ED9ng bao ph\u1EE7 90%
-- *M\u1EE5c ti\xEAu: S\xE1ng t\u1EA1o & b\u1EE9t ph\xE1*
+### \u{1F947} Gold Tier
+- Design distributed retry queue
+- Add 95% automated test coverage
+- *Goal: Architectural leadership*
 
 </div>
 </div>
 
 <!--
 Presenter Notes:
-- To\xE0n b\u1ED9 l\u1EDBp \u0111\u1EC1u b\u1EAFt \u0111\u1EA7u t\u1EEB H\u1EA1ng \u0110\u1ED3ng \u0111\u1EC3 \u0111\u1EA3m b\u1EA3o hi\u1EC3u b\xE0i.
-- Khuy\u1EBFn kh\xEDch h\u1ECDc vi\xEAn \u0111\xE3 xong Bronze ch\u1EE7 \u0111\u1ED9ng th\u1EED s\u1EE9c v\u1EDBi Silver v\xE0 Gold.
+- All learners begin at Bronze to establish baseline competency.
+- Accelerate self-directed learners to Silver and Gold as they complete each tier.
 -->`
   },
   {
     id: "agenda-timeline",
-    name: "L\u1ED9 Tr\xECnh Bu\u1ED5i H\u1ECDc (Agenda Table)",
+    name: "Session Agenda & Milestones",
     category: "content",
-    description: "B\u1EA3ng l\u1ED9 tr\xECnh th\u1EDDi gian chi ti\u1EBFt theo t\u1EEBng giai \u0111o\u1EA1n v\xE0 s\u1EA3n ph\u1EA9m \u0111\u1EA7u ra.",
+    description: "Structured time-budgeted agenda mapping stages to measurable deliverables.",
     layout: {
       boxes: [
         {
@@ -4818,25 +4800,25 @@ Presenter Notes:
       pos: [80, 140, 1120, 520]
 -->
 
-## \u{1F5FA}\uFE0F L\u1ED9 Tr\xECnh Ho\u1EA1t \u0110\u1ED9ng & M\u1EE5c Ti\xEAu
+## \u{1F5FA}\uFE0F Milestone Roadmap & Time Budget
 
-| Th\u1EDDi l\u01B0\u1EE3ng | Giai \u0111o\u1EA1n | Tr\u1ECDng t\xE2m ho\u1EA1t \u0111\u1ED9ng | K\u1EBFt qu\u1EA3 \u0111\u1EA1t \u0111\u01B0\u1EE3c |
+| Allocated Time | Session Stage | Core Learning Focus | Deliverable Milestone |
 |:---:|---|---|---|
-| **05'** | Kh\u1EDFi \u0111\u1ED9ng | T\xECnh hu\u1ED1ng th\u1EF1c t\u1EBF & Th\u1EED th\xE1ch | Nh\u1EADn di\u1EC7n b\xE0i to\xE1n c\u1EA7n gi\u1EA3i |
-| **15'** | Kh\xE1m ph\xE1 | Ph\xE2n t\xEDch 2 kh\xE1i ni\u1EC7m c\u1ED1t l\xF5i | Hi\u1EC3u b\u1EA3n ch\u1EA5t thu\u1EADt to\xE1n |
-| **20'** | Th\u1EF1c h\xE0nh | Code Lab t\u1EA1i m\xE1y theo 3 b\u1EADc | Ho\xE0n th\xE0nh t\u1ED1i thi\u1EC3u H\u1EA1ng \u0110\u1ED3ng |
-| **05'** | T\u1ED5ng k\u1EBFt | Tr\u1EAFc nghi\u1EC7m ph\u1EA3n x\u1EA1 & \u0110\xE1nh gi\xE1 | H\u1EC7 th\u1ED1ng h\xF3a to\xE0n b\u1ED9 ki\u1EBFn th\u1EE9c |
+| **05 mins** | Warm-Up | Real-World Scenario & Context | Identify system bottleneck |
+| **15 mins** | Concept Discovery | Core Architectural Patterns | Deconstruct message queue models |
+| **20 mins** | Hands-On Lab | Tiered Code Implementation | Complete Bronze + Silver tasks |
+| **05 mins** | Wrap-Up | Formative Checkpoint & Debrief | Consolidate key principles |
 
 <!--
 Presenter Notes:
-- Gi\u1EDBi thi\u1EC7u t\u1ED5ng quan \u0111\u1EC3 h\u1ECDc vi\xEAn bi\u1EBFt r\xF5 c\u1EA5u tr\xFAc bu\u1ED5i h\u1ECDc v\xE0 ch\u1EE7 \u0111\u1ED9ng ph\xE2n b\u1ED5 th\u1EDDi gian.
+- Walk through the time budget so students understand expectations and pacing.
 -->`
   },
   {
     id: "takeaways-summary",
-    name: "T\u1ED5ng K\u1EBFt C\u1ED1t L\xF5i (Key Takeaways)",
+    name: "Key Takeaways & Wrap-up",
     category: "content",
-    description: "Slide k\u1EBFt lu\u1EADn v\u1EDBi 3 b\xE0i h\u1ECDc \u0111\u1EAFt gi\xE1 nh\u1EA5t v\xE0 h\xE0nh \u0111\u1ED9ng ti\u1EBFp theo.",
+    description: "Three memorable synthesis takeaways with actionable next steps.",
     layout: {
       boxes: [
         {
@@ -4875,18 +4857,18 @@ Presenter Notes:
       fontSize: 1.1rem
 -->
 
-## \u{1F3C1} 3 \u0110i\u1EC1u C\u1EA7n Nh\u1EDB Sau Bu\u1ED5i H\u1ECDc
+## \u{1F3C1} Key Takeaways & Action Items
 
-1. **Hi\u1EC3u b\u1EA3n ch\u1EA5t tr\u01B0\u1EDBc khi vi\u1EBFt m\xE3:** Thu\u1EADt to\xE1n \u0111\xFAng lu\xF4n quan tr\u1ECDng h\u01A1n c\xFA ph\xE1p b\xF3ng b\u1EA9y.
-2. **Ki\u1EC3m so\xE1t \u0111i\u1EC1u ki\u1EC7n bi\xEAn:** 80% l\u1ED7i h\u1EC7 th\u1ED1ng ph\xE1t sinh t\u1EEB c\xE1c d\u1EEF li\u1EC7u \u0111\u1EA7u v\xE0o kh\xF4ng l\u01B0\u1EDDng tr\u01B0\u1EDBc.
-3. **Thi\u1EBFt k\u1EBF h\u01B0\u1EDBng m\xF4-\u0111un:** Chia nh\u1ECF v\u1EA5n \u0111\u1EC1 l\u1EDBn th\xE0nh c\xE1c h\xE0m \u0111\u1ED9c l\u1EADp d\u1EC5 ki\u1EC3m th\u1EED.
+1. **Decouple Before Scaling:** Separate producer rate from consumer processing capacity.
+2. **Design for Failure:** Always configure retries, backoff intervals, and dead-letter queues.
+3. **Measure End-to-End:** Track P99 latency and error rates across all distributed boundaries.
 
-> \u{1F4DD} **Nhi\u1EC7m v\u1EE5 v\u1EC1 nh\xE0:** Ho\xE0n thi\u1EC7n b\xE0i th\u1EF1c h\xE0nh H\u1EA1ng B\u1EA1c v\xE0 chu\u1EA9n b\u1ECB c\xE2u h\u1ECFi cho bu\u1ED5i Review tu\u1EA7n t\u1EDBi.
+> \u{1F4DD} **Next Action Item:** Complete the Silver Tier refactoring challenge before our next peer-review session.
 
 <!--
 Presenter Notes:
-- T\xF3m t\u1EAFt s\xFAc t\xEDch trong 2 ph\xFAt cu\u1ED1i bu\u1ED5i.
-- Tuy\xEAn d\u01B0\u01A1ng c\xE1c b\u1EA1n c\xF3 gi\u1EA3i ph\xE1p xu\u1EA5t s\u1EAFc trong ph\u1EA7n th\u1EF1c h\xE0nh.
+- Deliver a crisp 2-minute wrap-up reinforcing the 3 core takeaways.
+- Acknowledge strong peer collaboration during the hands-on lab.
 -->`
   }
 ];
@@ -9575,14 +9557,14 @@ init_errors();
 
 // 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",
@@ -9590,7 +9572,7 @@ var DEFAULT_GATE_SETTINGS = Object.freeze({
   WKS: "OFF",
   HANDOUT: "OFF",
   EXT: "OFF",
-  CODE: "LLM_JUDGE",
+  CODE: "OFF",
   MEDIA_SCRIPT: "OFF",
   EXIT_TICKET: "OFF"
 });
@@ -11479,9 +11461,10 @@ Fix ALL issues above and output the complete corrected document.` }],
   const taskState = pipelineState.tasks[lessonCode] || {};
   const currentLessonInfo = taskState.LESSON;
   const lessonGate = gateModeFor(gates, "LESSON");
-  let isLessonApproved = lessonGate !== "HITL" || // OFF/LLM_JUDGE: không cần duyệt người
-  currentLessonInfo?.state === "approved" || currentLessonInfo?.review?.decision === "APPROVED" || approvedArtifacts.includes("LESSON") || approvedArtifacts.includes(lessonCode);
-  if (lessonGate === "LLM_JUDGE" && !isLessonApproved && lessonContent) {
+  const humanApproved = currentLessonInfo?.state === "approved" || currentLessonInfo?.review?.decision === "APPROVED" || approvedArtifacts.includes("LESSON") || approvedArtifacts.includes(lessonCode);
+  const needsJudge = lessonGate === "LLM_JUDGE" && !humanApproved;
+  let isLessonApproved = lessonGate === "OFF" || humanApproved;
+  if (needsJudge && lessonContent) {
     onProgress?.("@reviewer", `\u{1F916} Executing LLM-as-Judge academic evaluation on LESSON_${lessonCode}.md...`);
     try {
       let injectYamlReviewMetadata2 = function(content, meta) {
@@ -12520,6 +12503,8 @@ async function generateSingleArtifact(req) {
     extraContext,
     config,
     contextSot = {},
+    mediaPolicy,
+    researchContext,
     options = {},
     onChunk
   } = req;
@@ -12557,7 +12542,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"}"
@@ -12572,6 +12560,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)}
 ` : ""}
@@ -12612,13 +12603,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",
@@ -13374,43 +13523,15 @@ function safeParseJson(rawText) {
     return null;
   }
 }
-async function readSseStream(reader, decoder, onData) {
-  let buffer = "";
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    buffer += decoder.decode(value, { stream: true });
-    const lines = buffer.split("\n");
-    buffer = lines.pop() || "";
-    for (const line of lines) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith(":")) continue;
-      if (trimmed === "data: [DONE]") return;
-      if (trimmed.startsWith("data: ")) {
-        const dataStr = trimmed.slice(6).trim();
-        if (dataStr) onData(dataStr);
-      }
-    }
-  }
-}
 async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onChunk) {
-  apiKeys.alibaba || apiKeys.dashscope || process.env.ALIBABA_API_KEY || process.env.DASHSCOPE_API_KEY;
+  const alibabaKey = apiKeys.alibaba || apiKeys.dashscope || process.env.ALIBABA_API_KEY || process.env.DASHSCOPE_API_KEY;
   const nvidiaKey = apiKeys.nvidia || process.env.NVIDIA_API_KEY;
-  apiKeys.deepseek || process.env.DEEPSEEK_API_KEY;
+  const deepseekKey = apiKeys.deepseek || process.env.DEEPSEEK_API_KEY;
   const openrouterKey = apiKeys.openrouter || process.env.OPENROUTER_API_KEY;
-  apiKeys.gemini || process.env.GEMINI_API_KEY;
+  const geminiKey = apiKeys.gemini || process.env.GEMINI_API_KEY;
   const openrouterPreset = process.env.OPENROUTER_FREE_PRESET || "@preset/coding-free";
-  const messages = [
-    {
-      role: "system",
-      content: `${systemPrompt}
-
-THINKING DIRECTIVE: Keep reasoning concise, structured, and focused strictly on the core pedagogical trade-offs in 4-6 concise bullet points (under 120 words). Then output the JSON immediately.`
-    },
-    { role: "user", content: userPrompt }
-  ];
+  const candidates = [];
   if (openrouterKey && isProviderEnabled("openrouter")) {
-    const t0 = Date.now();
     const orModels = [
       openrouterPreset,
       "openrouter/free",
@@ -13420,174 +13541,82 @@ THINKING DIRECTIVE: Keep reasoning concise, structured, and focused strictly on
       "minimax/minimax-m3:free",
       "cohere/north-mini-code:free"
     ].filter((m) => isModelAllowed(m));
-    const uniqueOrModels = Array.from(new Set(orModels));
-    for (const model of uniqueOrModels) {
-      try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 25e3);
-        const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${openrouterKey}`
-          },
-          body: JSON.stringify({
-            model,
-            messages,
-            stream: true,
-            temperature: 0.3
-          }),
-          signal: controller.signal
-        });
-        clearTimeout(timeout);
-        if (res.ok && res.body) {
-          const reader = res.body.getReader();
-          const decoder = new TextDecoder();
-          let fullContent = "";
-          await readSseStream(reader, decoder, (dataStr) => {
-            try {
-              const parsed = JSON.parse(dataStr);
-              const delta = parsed.choices?.[0]?.delta;
-              if (delta?.content) {
-                fullContent += delta.content;
-                onChunk?.(delta.content, "content");
-              }
-            } catch {
-            }
-          });
-          if (fullContent.trim()) {
-            console.log(`[curriculum-kit:LayerPrefill] \u2705 Tier 1 OpenRouter (${model}) streamed in ${Date.now() - t0}ms`);
-            return fullContent.trim();
-          }
-        }
-      } catch (e) {
-        console.warn(`[curriculum-kit:LayerPrefill] Tier 1 OpenRouter stream failed for ${model} in ${Date.now() - t0}ms:`, e?.message || e);
-      }
+    for (const m of Array.from(new Set(orModels))) {
+      candidates.push({ provider: "openrouter", model: m, apiKey: openrouterKey });
     }
   }
   if (nvidiaKey && isProviderEnabled("nvidia")) {
-    const t0 = Date.now();
     const nemotronModels = [
       "nvidia/nemotron-3-ultra-550b-a55b",
       "nvidia/nemotron-3.5-lightning-30b-a3b",
       "nvidia/nemotron-3-super-120b-a12b",
       "nvidia/llama-3.1-nemotron-70b-instruct"
     ].filter((m) => isModelAllowed(m));
-    for (const model of nemotronModels) {
-      try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 25e3);
-        const res = await fetch("https://integrate.api.nvidia.com/v1/chat/completions", {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${nvidiaKey}`
-          },
-          body: JSON.stringify({
-            model,
-            messages,
-            stream: true,
-            temperature: 0.2
-          }),
-          signal: controller.signal
-        });
-        clearTimeout(timeout);
-        if (res.ok && res.body) {
-          const reader = res.body.getReader();
-          const decoder = new TextDecoder();
-          let fullContent = "";
-          await readSseStream(reader, decoder, (dataStr) => {
-            try {
-              const parsed = JSON.parse(dataStr);
-              const delta = parsed.choices?.[0]?.delta;
-              if (delta?.content) {
-                fullContent += delta.content;
-                onChunk?.(delta.content, "content");
-              }
-            } catch {
-            }
-          });
-          if (fullContent.trim()) {
-            console.log(`[curriculum-kit:LayerPrefill] \u2705 Tier 2 NVIDIA NIM (${model}) streamed in ${Date.now() - t0}ms`);
-            return fullContent.trim();
-          }
-        }
-      } catch (e) {
-        console.warn(`[curriculum-kit:LayerPrefill] Tier 2 NVIDIA NIM stream failed for ${model} in ${Date.now() - t0}ms:`, e?.message || e);
-      }
+    for (const m of nemotronModels) {
+      candidates.push({ provider: "nvidia", model: m, apiKey: nvidiaKey });
+    }
+  }
+  if (alibabaKey && isProviderEnabled("alibaba")) {
+    const aliModels = ["qwen-plus", "qwen-turbo", "qwen3.7-plus"].filter((m) => isModelAllowed(m));
+    for (const m of aliModels) {
+      candidates.push({ provider: "alibaba", model: m, apiKey: alibabaKey });
+    }
+  }
+  if (deepseekKey && isProviderEnabled("deepseek")) {
+    const dsModels = ["deepseek-chat", "deepseek-coder"].filter((m) => isModelAllowed(m));
+    for (const m of dsModels) {
+      candidates.push({ provider: "deepseek", model: m, apiKey: deepseekKey });
+    }
+  }
+  if (geminiKey && (isProviderEnabled("gemini") || isProviderEnabled("google"))) {
+    const gModels = ["gemini-1.5-flash", "gemini-2.0-flash", "gemini-1.5-pro"].filter((m) => isModelAllowed(m));
+    for (const m of gModels) {
+      candidates.push({ provider: "google", model: m, apiKey: geminiKey });
     }
   }
   const fallbackChain = getDesignatedFallbackChain();
   for (const target of fallbackChain) {
-    const { provider, model } = target;
-    if (provider === "nvidia" && nvidiaKey && isProviderEnabled("nvidia")) {
-      try {
-        const res = await fetch("https://integrate.api.nvidia.com/v1/chat/completions", {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${nvidiaKey}`
-          },
-          body: JSON.stringify({
-            model,
-            messages,
-            stream: true,
-            temperature: 0.2
-          })
-        });
-        if (res.ok && res.body) {
-          const reader = res.body.getReader();
-          const decoder = new TextDecoder();
-          let fullContent = "";
-          await readSseStream(reader, decoder, (dataStr) => {
-            try {
-              const parsed = JSON.parse(dataStr);
-              const delta = parsed.choices?.[0]?.delta;
-              if (delta?.content) {
-                fullContent += delta.content;
-                onChunk?.(delta.content, "content");
-              }
-            } catch {
-            }
-          });
-          if (fullContent.trim()) return fullContent.trim();
+    if (!candidates.some((c) => c.provider === target.provider && c.model === target.model)) {
+      candidates.push({
+        provider: target.provider,
+        model: target.model,
+        apiKey: apiKeys[target.provider]
+      });
+    }
+  }
+  const systemInstructions = `${systemPrompt}
+
+THINKING DIRECTIVE: Keep reasoning concise, structured, and focused strictly on the core pedagogical trade-offs in 4-6 concise bullet points (under 120 words). Then output the JSON immediately.`;
+  for (const candidate of candidates) {
+    const t0 = Date.now();
+    try {
+      const modelInstance = getAIModel({
+        provider: candidate.provider,
+        modelName: candidate.model,
+        apiKey: candidate.apiKey
+      });
+      const streamResult = ai.streamText({
+        model: modelInstance,
+        system: systemInstructions,
+        prompt: userPrompt,
+        temperature: 0.2,
+        abortSignal: AbortSignal.timeout(25e3)
+      });
+      let fullContent = "";
+      for await (const part of streamResult.fullStream) {
+        if (part.type === "reasoning-delta") {
+          onChunk?.(part.text, "thought");
+        } else if (part.type === "text-delta") {
+          fullContent += part.text;
+          onChunk?.(part.text, "content");
         }
-      } catch {
       }
-    } else if (provider === "openrouter" && openrouterKey && isProviderEnabled("openrouter")) {
-      try {
-        const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${openrouterKey}`
-          },
-          body: JSON.stringify({
-            model,
-            messages,
-            stream: true,
-            temperature: 0.2
-          })
-        });
-        if (res.ok && res.body) {
-          const reader = res.body.getReader();
-          const decoder = new TextDecoder();
-          let fullContent = "";
-          await readSseStream(reader, decoder, (dataStr) => {
-            try {
-              const parsed = JSON.parse(dataStr);
-              const delta = parsed.choices?.[0]?.delta;
-              if (delta?.content) {
-                fullContent += delta.content;
-                onChunk?.(delta.content, "content");
-              }
-            } catch {
-            }
-          });
-          if (fullContent.trim()) return fullContent.trim();
-        }
-      } catch {
+      if (fullContent.trim()) {
+        console.log(`[curriculum-kit:VercelAI] \u2705 ${candidate.provider} (${candidate.model}) streamed in ${Date.now() - t0}ms`);
+        return fullContent.trim();
       }
+    } catch (e) {
+      console.warn(`[curriculum-kit:VercelAI] Candidate ${candidate.provider} (${candidate.model}) failed in ${Date.now() - t0}ms:`, e?.message || e);
     }
   }
   return null;
@@ -14454,7 +14483,7 @@ template_contract: "artifact-template-v1"
 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;
     }
@@ -14470,7 +14499,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`
       });
     }
@@ -14755,10 +14784,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}`;
+}
 
 // src/standards/standardsCoverageGate.ts
 function resolveStatementRef(ref, packs) {
@@ -15108,9 +15137,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) {
@@ -15130,7 +15159,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) {
@@ -15318,7 +15347,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;
@@ -16740,6 +16769,36 @@ var MediaLedger = class {
   doneCount() {
     return this.listByStatus("done").length;
   }
+  /**
+   * Scan artifact content và seed pending entries cho mọi placeholder [IMAGE: slug].
+   * Được gọi sau khi agent sinh artifact (trước khi Curator duyệt) — đây là cầu nối
+   * duy nhất giữa "agent chèn placeholder" và "sổ cái có entry để Curator/Fulfiller xử".
+   * Idempotent: slug đã có entry active (pending/approved/done) → giữ nguyên;
+   * chỉ re-describe khi entry trước bị rejected/failed.
+   */
+  seedFromArtifact(artifactId, content) {
+    const seeded = [];
+    const re = /\[IMAGE\s*:\s*([a-z0-9][a-z0-9-]*)\s*\]/gi;
+    const seen = /* @__PURE__ */ new Set();
+    let m;
+    while ((m = re.exec(content)) !== null) {
+      const slug = m[1].toLowerCase();
+      if (seen.has(slug)) continue;
+      seen.add(slug);
+      const existing = this.entries.get(slug);
+      const isActive = existing && (existing.status === "pending" || existing.status === "approved" || existing.status === "done");
+      if (isActive) continue;
+      seeded.push(this.upsert({
+        slug,
+        artifactId,
+        name: slug.replace(/^(img-|image-)/, "").replace(/-/g, " "),
+        description: `Placeholder ch\xE8n b\u1EDFi agent trong artifact ${artifactId} \u2014 ch\u1EDD Curator enrich (m\xF4 t\u1EA3 g\u1ED1c ch\u01B0a c\xF3).`,
+        mode: "generate",
+        status: "pending"
+      }));
+    }
+    return seeded;
+  }
 };
 
 // src/media/curator.ts
@@ -17154,6 +17213,7 @@ exports.WorksheetSchema = WorksheetSchema;
 exports.activityTools = activityTools;
 exports.analystTools = analystTools;
 exports.analyzeProjectCreationIntent = analyzeProjectCreationIntent;
+exports.approvalHookToken = approvalHookToken;
 exports.approvalPayloadSchema = approvalPayloadSchema;
 exports.assertAcyclic = assertAcyclic;
 exports.assessorTools = assessorTools;