@thanh01.pmt/curriculum-kit 1.0.0

package/dist/publishers/index.mjs

@@ -0,0 +1,561 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { Octokit } from '@octokit/rest';
+import { createClient } from '@supabase/supabase-js';
+
+// src/publishers/localWorkspaceManager.ts
+var LocalWorkspaceManager = class {
+  baseDir;
+  constructor(baseDir) {
+    this.baseDir = baseDir || path.resolve(process.cwd(), "output", "workspace-jobs");
+  }
+  getJobDirectory(jobId) {
+    return path.join(this.baseDir, jobId);
+  }
+  async initJobWorkspace(jobId, initialInfo) {
+    const jobDir = this.getJobDirectory(jobId);
+    await fs.mkdir(jobDir, { recursive: true });
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const manifest = {
+      jobId,
+      courseTitle: initialInfo.courseTitle,
+      topic: initialInfo.topic,
+      language: initialInfo.language,
+      status: "IN_PROGRESS",
+      totalMilestones: initialInfo.totalMilestones,
+      completedMilestones: 0,
+      createdAt: now,
+      updatedAt: now,
+      artifacts: []
+    };
+    await this.saveManifest(jobId, manifest);
+    return jobDir;
+  }
+  async saveArtifact(jobId, milestoneSlug, filename, content, artifactType) {
+    const jobDir = this.getJobDirectory(jobId);
+    const targetDir = path.join(jobDir, milestoneSlug);
+    await fs.mkdir(targetDir, { recursive: true });
+    const filePath = path.join(targetDir, filename);
+    await fs.writeFile(filePath, content, "utf-8");
+    const stat = await fs.stat(filePath);
+    const manifest = await this.getManifest(jobId);
+    if (manifest) {
+      manifest.artifacts.push({
+        milestoneId: milestoneSlug,
+        artifactType,
+        filePath: path.relative(jobDir, filePath),
+        sizeBytes: stat.size,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      manifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      await this.saveManifest(jobId, manifest);
+    }
+    return filePath;
+  }
+  async getManifest(jobId) {
+    const manifestPath = path.join(this.getJobDirectory(jobId), "manifest.json");
+    try {
+      const data = await fs.readFile(manifestPath, "utf-8");
+      return JSON.parse(data);
+    } catch {
+      return null;
+    }
+  }
+  async saveManifest(jobId, manifest) {
+    const manifestPath = path.join(this.getJobDirectory(jobId), "manifest.json");
+    manifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
+  }
+  async markMilestoneCompleted(jobId) {
+    const manifest = await this.getManifest(jobId);
+    if (manifest) {
+      manifest.completedMilestones += 1;
+      if (manifest.completedMilestones >= manifest.totalMilestones) {
+        manifest.status = "COMPLETED";
+      }
+      await this.saveManifest(jobId, manifest);
+    }
+  }
+  async markJobFailed(jobId, errorMsg) {
+    const manifest = await this.getManifest(jobId);
+    if (manifest) {
+      manifest.status = "FAILED";
+      manifest.error = errorMsg;
+      await this.saveManifest(jobId, manifest);
+    }
+  }
+};
+async function publishToGitHub(options) {
+  const token = options.githubToken || process.env.GITHUB_TOKEN;
+  if (!token) {
+    return {
+      success: false,
+      branch: options.branch || "main",
+      publishedFilesCount: 0,
+      error: "Missing GITHUB_TOKEN in environment or options"
+    };
+  }
+  const octokit = new Octokit({ auth: token });
+  const targetBranch = options.branch || `generated/course-${options.jobId}`;
+  let publishedFilesCount = 0;
+  try {
+    const filesToUpload = [];
+    async function scanDir(currentDir) {
+      const entries = await fs.readdir(currentDir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path.join(currentDir, entry.name);
+        if (entry.isDirectory()) {
+          await scanDir(fullPath);
+        } else if (entry.isFile() && !entry.name.startsWith(".")) {
+          const content = await fs.readFile(fullPath, "utf-8");
+          const relPath = path.relative(options.localJobDir, fullPath);
+          filesToUpload.push({ path: relPath, content });
+        }
+      }
+    }
+    await scanDir(options.localJobDir);
+    if (filesToUpload.length === 0) {
+      return {
+        success: false,
+        branch: targetBranch,
+        publishedFilesCount: 0,
+        error: "No files found in workspace to upload"
+      };
+    }
+    const baseBranch = "main";
+    let baseTreeSha;
+    let baseCommitSha;
+    try {
+      const { data: refData } = await octokit.git.getRef({
+        owner: options.owner,
+        repo: options.repo,
+        ref: `heads/${baseBranch}`
+      });
+      baseCommitSha = refData.object.sha;
+      const { data: commitData } = await octokit.git.getCommit({
+        owner: options.owner,
+        repo: options.repo,
+        commit_sha: baseCommitSha
+      });
+      baseTreeSha = commitData.tree.sha;
+    } catch (e) {
+      return {
+        success: false,
+        branch: targetBranch,
+        publishedFilesCount: 0,
+        error: `Failed to fetch base branch ${baseBranch}: ${e.message}`
+      };
+    }
+    const treeItems = [];
+    for (const file of filesToUpload) {
+      const { data: blobData } = await octokit.git.createBlob({
+        owner: options.owner,
+        repo: options.repo,
+        content: Buffer.from(file.content).toString("base64"),
+        encoding: "base64"
+      });
+      treeItems.push({
+        path: file.path,
+        mode: "100644",
+        type: "blob",
+        sha: blobData.sha
+      });
+      publishedFilesCount++;
+    }
+    const { data: newTree } = await octokit.git.createTree({
+      owner: options.owner,
+      repo: options.repo,
+      base_tree: baseTreeSha,
+      tree: treeItems
+    });
+    const message = options.commitMessage || `feat(curriculum): publish generated course artifacts [job:${options.jobId}]`;
+    const { data: newCommit } = await octokit.git.createCommit({
+      owner: options.owner,
+      repo: options.repo,
+      message,
+      tree: newTree.sha,
+      parents: [baseCommitSha]
+    });
+    try {
+      await octokit.git.createRef({
+        owner: options.owner,
+        repo: options.repo,
+        ref: `refs/heads/${targetBranch}`,
+        sha: newCommit.sha
+      });
+    } catch {
+      await octokit.git.updateRef({
+        owner: options.owner,
+        repo: options.repo,
+        ref: `heads/${targetBranch}`,
+        sha: newCommit.sha,
+        force: true
+      });
+    }
+    let prUrl = void 0;
+    if (options.createPullRequest && targetBranch !== baseBranch) {
+      try {
+        const { data: prData } = await octokit.pulls.create({
+          owner: options.owner,
+          repo: options.repo,
+          title: `[Curriculum AI] Generated Curriculum (${options.jobId})`,
+          head: targetBranch,
+          base: baseBranch,
+          body: `Automated curriculum generation output from job \`${options.jobId}\`.
+Contains ${publishedFilesCount} files.`
+        });
+        prUrl = prData.html_url;
+      } catch {
+      }
+    }
+    return {
+      success: true,
+      commitSha: newCommit.sha,
+      branch: targetBranch,
+      pullRequestUrl: prUrl,
+      publishedFilesCount
+    };
+  } catch (error) {
+    return {
+      success: false,
+      branch: targetBranch,
+      publishedFilesCount,
+      error: error.message || String(error)
+    };
+  }
+}
+async function publishToSupabase(options) {
+  const supabaseUrl = options.supabaseUrl || process.env.NEXT_PUBLIC_SUPABASE_URL || process.env.SUPABASE_URL;
+  const serviceKey = options.supabaseServiceKey || process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
+  if (!supabaseUrl || !serviceKey) {
+    return {
+      success: false,
+      syncedMilestonesCount: 0,
+      uploadedAssetsCount: 0,
+      error: "Missing SUPABASE_URL or SUPABASE_SERVICE_ROLE_KEY"
+    };
+  }
+  const supabase = createClient(supabaseUrl, serviceKey);
+  options.bucketName || "learning_resources";
+  try {
+    const { data: lpData, error: lpError } = await supabase.from("learning_paths").upsert(
+      {
+        code: `LP-${options.jobId}`,
+        title: options.courseTitle,
+        description: `Auto-generated curriculum on ${options.topic}`,
+        language: options.language,
+        metadata: {
+          jobId: options.jobId,
+          topic: options.topic,
+          totalMilestones: options.milestones.length,
+          generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+        }
+      },
+      { onConflict: "code" }
+    ).select("id").single();
+    const learningPathId = lpData?.id;
+    let syncedMilestonesCount = 0;
+    for (const [index, m] of options.milestones.entries()) {
+      const { error: lessonError } = await supabase.from("lessons").upsert(
+        {
+          code: `L-${options.jobId}-${m.milestoneId}`,
+          title: m.milestoneName,
+          order_index: index + 1,
+          learning_path_id: learningPathId,
+          metadata: {
+            milestoneId: m.milestoneId,
+            lessonSlug: m.lessonSlug,
+            summary: m.summary
+          }
+        },
+        { onConflict: "code" }
+      );
+      if (!lessonError) {
+        syncedMilestonesCount++;
+      }
+    }
+    return {
+      success: true,
+      learningPathId,
+      syncedMilestonesCount,
+      uploadedAssetsCount: 0
+    };
+  } catch (error) {
+    return {
+      success: false,
+      syncedMilestonesCount: 0,
+      uploadedAssetsCount: 0,
+      error: error.message || String(error)
+    };
+  }
+}
+async function uploadAssetToBucket(filePath, storagePath, options) {
+  const supabaseUrl = options?.supabaseUrl || process.env.NEXT_PUBLIC_SUPABASE_URL || process.env.SUPABASE_URL;
+  const serviceKey = options?.supabaseServiceKey || process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
+  if (!supabaseUrl || !serviceKey) {
+    return { success: false, error: "Missing Supabase credentials" };
+  }
+  const supabase = createClient(supabaseUrl, serviceKey);
+  const bucketName = options?.bucketName || "course-materials";
+  try {
+    const fileBuffer = await fs.readFile(filePath);
+    const { error: uploadError } = await supabase.storage.from(bucketName).upload(storagePath, fileBuffer, { upsert: true });
+    if (uploadError) {
+      return { success: false, error: uploadError.message };
+    }
+    const { data } = supabase.storage.from(bucketName).getPublicUrl(storagePath);
+    return { success: true, publicUrl: data.publicUrl };
+  } catch (error) {
+    return { success: false, error: error.message || String(error) };
+  }
+}
+
+// src/publishers/packagingService.ts
+function parseQuizMarkdown(content, lessonId) {
+  const questions = [];
+  const lines = content.split("\n");
+  let currentQuestion = null;
+  let qCounter = 1;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    const qMatch = line.match(/^(?:###\s*)?(?:Câu|\*\*Câu|Question|\*\*Question|\d+\.)\s*(\d+)?[:\.]?\s*(.*)/i);
+    if (qMatch && (line.includes("?") || line.includes(":") || line.startsWith("###") || line.startsWith("**C\xE2u"))) {
+      if (currentQuestion && currentQuestion.questionText && currentQuestion.options) {
+        questions.push({
+          lessonId,
+          questionNumber: currentQuestion.questionNumber || qCounter++,
+          questionText: currentQuestion.questionText,
+          options: currentQuestion.options,
+          correctAnswer: currentQuestion.correctAnswer || "A",
+          explanation: currentQuestion.explanation || "",
+          timeLimitSeconds: 60
+        });
+      }
+      currentQuestion = {
+        lessonId,
+        questionNumber: qMatch[1] ? parseInt(qMatch[1]) : qCounter,
+        questionText: qMatch[2] ? qMatch[2].replace(/\*\*/g, "").trim() : line.replace(/^###|\*\*/g, "").trim(),
+        options: { A: "", B: "", C: "", D: "" },
+        correctAnswer: "A",
+        explanation: "",
+        timeLimitSeconds: 60
+      };
+      continue;
+    }
+    if (!currentQuestion) continue;
+    const optMatch = line.match(/^[-*]?\s*([A-D])[\.\)]\s*(.*)/i);
+    if (optMatch) {
+      const optKey = optMatch[1].toUpperCase();
+      let optText = optMatch[2].trim();
+      if (optText.includes("(\u0110\xE1p \xE1n \u0111\xFAng)") || optText.includes("\u2705") || optText.includes("(Correct)")) {
+        currentQuestion.correctAnswer = optKey;
+        optText = optText.replace(/\(Đáp án đúng\)|\(Correct\)|✅/g, "").trim();
+      }
+      if (currentQuestion.options) {
+        currentQuestion.options[optKey] = optText;
+      }
+      continue;
+    }
+    const ansMatch = line.match(/(?:Đáp án đúng|Đáp án|Correct Answer|Answer)[:\s\*]+([A-D])/i);
+    if (ansMatch) {
+      currentQuestion.correctAnswer = ansMatch[1].toUpperCase();
+      continue;
+    }
+    const expMatch = line.match(/(?:Giải thích|Explanation)[:\s\*]+(.*)/i);
+    if (expMatch) {
+      currentQuestion.explanation = expMatch[1].replace(/\*\*/g, "").trim();
+      continue;
+    }
+  }
+  if (currentQuestion && currentQuestion.questionText && currentQuestion.options) {
+    questions.push({
+      lessonId,
+      questionNumber: currentQuestion.questionNumber || qCounter,
+      questionText: currentQuestion.questionText,
+      options: currentQuestion.options,
+      correctAnswer: currentQuestion.correctAnswer || "A",
+      explanation: currentQuestion.explanation || "",
+      timeLimitSeconds: 60
+    });
+  }
+  return questions;
+}
+function formatQuizzesToCsv(questions, format = "kahoot") {
+  if (format === "kahoot") {
+    const header2 = "Question,Answer 1,Answer 2,Answer 3,Answer 4,Time limit (sec),Correct answer(s)\n";
+    const rows2 = questions.map((q) => {
+      const cleanQ = `"${q.questionText.replace(/"/g, '""')}"`;
+      const a1 = `"${(q.options.A || "").replace(/"/g, '""')}"`;
+      const a2 = `"${(q.options.B || "").replace(/"/g, '""')}"`;
+      const a3 = `"${(q.options.C || "").replace(/"/g, '""')}"`;
+      const a4 = `"${(q.options.D || "").replace(/"/g, '""')}"`;
+      const correctIndex = q.correctAnswer === "A" ? 1 : q.correctAnswer === "B" ? 2 : q.correctAnswer === "C" ? 3 : 4;
+      return `${cleanQ},${a1},${a2},${a3},${a4},${q.timeLimitSeconds || 60},${correctIndex}`;
+    }).join("\n");
+    return header2 + rows2;
+  }
+  if (format === "quizizz") {
+    const header2 = "Question Text,Question Type,Option 1,Option 2,Option 3,Option 4,Option 5,Correct Answer,Time in seconds\n";
+    const rows2 = questions.map((q) => {
+      const cleanQ = `"${q.questionText.replace(/"/g, '""')}"`;
+      const a1 = `"${(q.options.A || "").replace(/"/g, '""')}"`;
+      const a2 = `"${(q.options.B || "").replace(/"/g, '""')}"`;
+      const a3 = `"${(q.options.C || "").replace(/"/g, '""')}"`;
+      const a4 = `"${(q.options.D || "").replace(/"/g, '""')}"`;
+      const correctIndex = q.correctAnswer === "A" ? 1 : q.correctAnswer === "B" ? 2 : q.correctAnswer === "C" ? 3 : 4;
+      return `${cleanQ},Multiple Choice,${a1},${a2},${a3},${a4},,${correctIndex},${q.timeLimitSeconds || 60}`;
+    }).join("\n");
+    return header2 + rows2;
+  }
+  const header = "Lesson ID,Question Number,Question Text,Option A,Option B,Option C,Option D,Correct Answer,Explanation\n";
+  const rows = questions.map((q) => {
+    return `"${q.lessonId}",${q.questionNumber},"${q.questionText.replace(/"/g, '""')}","${(q.options.A || "").replace(/"/g, '""')}","${(q.options.B || "").replace(/"/g, '""')}","${(q.options.C || "").replace(/"/g, '""')}","${(q.options.D || "").replace(/"/g, '""')}","${q.correctAnswer}","${(q.explanation || "").replace(/"/g, '""')}"`;
+  }).join("\n");
+  return header + rows;
+}
+async function exportAllProjectQuizzes(storage, projectId, format = "kahoot") {
+  const lessons = await storage.listLessons(projectId);
+  const allQuestions = [];
+  for (const l of lessons) {
+    const unitCode = l.lessonId.split("_")[0] || "U01";
+    const possiblePaths = [
+      `_content/${unitCode}/QUIZ_${l.lessonId}.md`,
+      `lessons/${l.lessonId}/QUIZ_${l.lessonId}.md`,
+      `QUIZ_${l.lessonId}.md`
+    ];
+    for (const p of possiblePaths) {
+      const content = await storage.readArtifact(projectId, p);
+      if (content) {
+        const parsed = parseQuizMarkdown(content, l.lessonId);
+        allQuestions.push(...parsed);
+        break;
+      }
+    }
+  }
+  const csv = formatQuizzesToCsv(allQuestions, format);
+  await storage.saveArtifact(projectId, `_released/quizzes_${format}.csv`, csv);
+  await storage.saveArtifact(projectId, `_released/QUIZ_BANK.json`, JSON.stringify(allQuestions, null, 2));
+  return { csv, questions: allQuestions };
+}
+async function buildDeliveryPackages(storage, projectId, onProgress) {
+  onProgress?.("@packager", "\u{1F4E6} B\u1EAFt \u0111\u1EA7u quy tr\xECnh ki\u1EC3m tra ch\u1EA5t l\u01B0\u1EE3ng v\xE0 ph\xE2n ph\u1ED1i 4 G\xF3i B\xE0n Giao...");
+  const statusReport = await storage.getProjectStatus(projectId);
+  await storage.readSotDocument(projectId, "CURRICULUM_FRAMEWORK.md") || "";
+  const brief = await storage.readSotDocument(projectId, "PROJECT_BRIEF.md") || "";
+  const dateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  onProgress?.("@assessor", "\u{1F4CA} \u0110ang tr\xEDch xu\u1EA5t to\xE0n b\u1ED9 ng\xE2n h\xE0ng c\xE2u h\u1ECFi tr\u1EAFc nghi\u1EC7m sang chu\u1EA9n Kahoot & Canvas CSV...");
+  const { csv: quizzesCsv, questions: quizzesJson } = await exportAllProjectQuizzes(storage, projectId, "kahoot");
+  onProgress?.("@packager", "\u{1F468}\u200D\u{1F3EB} \u0110ang l\u1EAFp r\xE1p Teacher Pack (Gi\xE1o \xE1n, K\u1EBF ho\u1EA1ch b\xE0i d\u1EA1y, L\u1EDDi tho\u1EA1i)...");
+  const teacherHandbook = `---
+id: "${projectId.toUpperCase()}-TEACHER-HANDBOOK"
+title: "Teacher Handbook: ${projectId.toUpperCase()}"
+type: "HANDBOOK"
+phase: "P4"
+date: "${dateStr}"
+---
+
+# \u{1F468}\u200D\u{1F3EB} TEACHER HANDBOOK & SCRIPT GUIDE
+
+## 1. T\u1ED5ng Quan Kh\xF3a H\u1ECDc
+${brief.slice(0, 1e3)}
+
+## 2. Khung Ph\xE2n B\u1ED5 S\u01B0 Ph\u1EA1m 5E & Th\u1EDDi Gian Gi\u1EA3ng D\u1EA1y
+- M\u1ED7i bu\u1ED5i h\u1ECDc chu\u1EA9n h\xF3a 90 ph\xFAt.
+- Tu\xE2n th\u1EE7 nghi\xEAm ng\u1EB7t ti\u1EBFn tr\xECnh: Engage (10m) $\\rightarrow$ Explore (20m) $\\rightarrow$ Explain (25m) $\\rightarrow$ Elaborate (25m) $\\rightarrow$ Evaluate (10m).
+
+## 3. Danh M\u1EE5c B\xE0i Gi\u1EA3ng (Lesson Plans)
+${statusReport.lessons.map((l) => `- \`LESSON_${l.lessonId}.md\``).join("\n") || "- \u0110ang c\u1EADp nh\u1EADt"}
+`;
+  await storage.saveArtifact(projectId, `_released/teacher_pack/TEACHER_HANDBOOK.md`, teacherHandbook);
+  onProgress?.("@packager", "\u{1F9D1}\u200D\u{1F393} \u0110ang \u0111\xF3ng g\xF3i Student Pack (Slide b\xE0i gi\u1EA3ng, Lab th\u1EF1c h\xE0nh, Phi\u1EBFu h\u1ECDc t\u1EADp)...");
+  const studentSyllabus = `---
+id: "${projectId.toUpperCase()}-STUDENT-SYLLABUS"
+title: "Student Syllabus: ${projectId.toUpperCase()}"
+type: "SYLLABUS"
+phase: "P4"
+date: "${dateStr}"
+---
+
+# \u{1F9D1}\u200D\u{1F393} H\u1ED2 S\u01A0 H\u1ECCC T\u1EACP & L\u1ED8 TR\xCCNH TH\u1EF0C H\xC0NH
+
+## 1. M\u1EE5c Ti\xEAu N\u0103ng L\u1EF1c \u0110\u1EA7u Ra
+H\u1ECDc vi\xEAn sau khi ho\xE0n th\xE0nh kh\xF3a h\u1ECDc s\u1EBD l\xE0m ch\u1EE7 to\xE0n di\u1EC7n c\xE1c k\u1EF9 n\u0103ng v\xE0 ki\u1EBFn th\u1EE9c \u0111\xE3 \u0111\u1ECBnh ngh\u0129a trong \u0111\u1ED3 th\u1ECB tri th\u1EE9c.
+
+## 2. Danh M\u1EE5c Slide & Lab Th\u1EF1c H\xE0nh
+${statusReport.lessons.map((l) => `- **${l.lessonId}:** Slide \`SLIDE_${l.lessonId}.md\` + Lab \`ACT_${l.lessonId}.md\``).join("\n") || "- \u0110ang c\u1EADp nh\u1EADt"}
+`;
+  await storage.saveArtifact(projectId, `_released/student_pack/STUDENT_SYLLABUS.md`, studentSyllabus);
+  onProgress?.("@packager", "\u{1F468}\u200D\u{1F469}\u200D\u{1F467} \u0110ang l\u1EADp B\xE1o c\xE1o B\xE0n giao Ph\u1EE5 huynh (Parent Pack)...");
+  const parentOverview = `---
+id: "${projectId.toUpperCase()}-PARENT-OVERVIEW"
+title: "Parent Overview: ${projectId.toUpperCase()}"
+type: "REPORT"
+phase: "P4"
+date: "${dateStr}"
+---
+
+# \u{1F468}\u200D\u{1F469}\u200D\u{1F467} B\xC1O C\xC1O TI\u1EBEN \u0110\u1ED8 & K\u1EBE HO\u1EA0CH H\u1ECCC T\u1EACP D\xC0NH CHO PH\u1EE4 HUYNH
+
+- **T\xEAn ch\u01B0\u01A1ng tr\xECnh:** ${projectId.toUpperCase()}
+- **Th\u1EDDi l\u01B0\u1EE3ng:** ${statusReport.totalLessons} b\xE0i h\u1ECDc (Chu\u1EA9n 90 ph\xFAt/bu\u1ED5i).
+- **M\u1EE5c ti\xEAu ph\xE1t tri\u1EC3n:** Gi\xFAp h\u1ECDc sinh l\xE0m ch\u1EE7 t\u01B0 duy gi\u1EA3i quy\u1EBFt v\u1EA5n \u0111\u1EC1, t\u1EF1 tay ph\xE1t tri\u1EC3n c\xE1c \u0111\u1ED3 \xE1n c\xF4ng ngh\u1EC7 th\u1EF1c t\u1EBF v\xE0 t\u1EF1 tin tr\u01B0\u1EDBc c\xE1c k\u1EF3 thi \u0111\xE1nh gi\xE1 n\u0103ng l\u1EF1c.
+`;
+  await storage.saveArtifact(projectId, `_released/parent_pack/COURSE_OVERVIEW.md`, parentOverview);
+  onProgress?.("@packager", "\u{1F3E2} \u0110ang ho\xE0n t\u1EA5t Client Pack & Bi\xEAn b\u1EA3n Nghi\u1EC7m thu B\xE0n giao (HANDOVER_DOCUMENT.md)...");
+  const handoverDoc = `---
+id: "${projectId.toUpperCase()}-HANDOVER"
+title: "Handover Document: ${projectId.toUpperCase()}"
+type: "HANDOVER_DOCUMENT"
+created_by: "Curriculum OS Packager"
+phase: "P4"
+deliverable: "P4-T1"
+version: "v1.0"
+date: "${dateStr}"
+template_contract: "artifact-template-v1"
+---
+
+# \u{1F3E2} BI\xCAN B\u1EA2N NGHI\u1EC6M THU & B\xC0N GIAO H\u1ECCC LI\u1EC6U (HANDOVER DOCUMENT)
+
+## 1. Th\xF4ng Tin Nghi\u1EC7m Thu D\u1EF1 \xC1n
+- **M\xE3 d\u1EF1 \xE1n:** \`${projectId}\`
+- **Ng\xE0y nghi\u1EC7m thu b\xE0n giao:** ${dateStr}
+- **\u0110\u01A1n v\u1ECB ph\xE1t tri\u1EC3n:** Curriculum OS Automation Team
+- **Ti\xEAu chu\u1EA9n ch\u1EA5t l\u01B0\u1EE3ng:** 100% Kh\u1EDBp m\u1EE5c ti\xEAu Bloom, Thang \u0111o 5E/EDP, Code s\u1EA1ch kh\xF4ng l\u1ED7i c\xFA ph\xE1p.
+
+## 2. Th\u1ED1ng K\xEA H\u1ECDc Li\u1EC7u B\xE0n Giao
+- **T\xE0i li\u1EC7u N\u1EC1n t\u1EA3ng (SOT):** ${statusReport.sotReadiness.filter((s) => s.exists).length}/7 Files S\u1EB5n s\xE0ng (100%).
+- **T\u1ED5ng s\u1ED1 b\xE0i h\u1ECDc ho\xE0n t\u1EA5t:** ${statusReport.completedCount}/${statusReport.totalLessons} b\xE0i h\u1ECDc.
+- **T\u1ED5ng s\u1ED1 c\xE2u h\u1ECFi tr\u1EAFc nghi\u1EC7m tr\xEDch xu\u1EA5t:** ${quizzesJson.length} c\xE2u h\u1ECFi.
+- **\u0110\u1ECBnh d\u1EA1ng xu\u1EA5t kh\u1EA9u:** Markdown chu\u1EA9n GitHub, Kahoot CSV, Canvas CSV, QUIZ_BANK JSON.
+
+## 3. C\u1EA5u Tr\xFAc 4 G\xF3i B\xE0n Giao \u0110\xE3 \u0110\xF3ng G\xF3i (\`_released/\`)
+- \u{1F4C1} **\`_released/teacher_pack/\`**: \`TEACHER_HANDBOOK.md\` + To\xE0n b\u1ED9 Gi\xE1o \xE1n \`LESSON_*.md\`
+- \u{1F4C1} **\`_released/student_pack/\`**: \`STUDENT_SYLLABUS.md\` + Slide \`SLIDE_*.md\` + Lab \`ACT_*.md\`
+- \u{1F4C1} **\`_released/parent_pack/\`**: \`COURSE_OVERVIEW.md\`
+- \u{1F4C1} **\`_released/client_pack/\`**: 7 Files SOT + \`ALIGNMENT_MATRIX.md\` + \`HANDOVER_DOCUMENT.md\`
+- \u{1F4C1} **\`_released/quizzes_kahoot.csv\`**: Ng\xE2n h\xE0ng tr\u1EAFc nghi\u1EC7m chu\u1EA9n Kahoot.
+- \u{1F4C1} **\`_released/QUIZ_BANK.json\`**: Ng\xE2n h\xE0ng JSON t\u01B0\u01A1ng th\xEDch Interactive Quiz Kit.
+
+---
+- **\u0110\u1EA1i di\u1EC7n \u0110\u01A1n v\u1ECB Ph\xE1t tri\u1EC3n:** @packager (Curriculum OS)
+- **Tr\u1EA1ng th\xE1i:** \u2705 **S\u1EB4N S\xC0NG TRI\u1EC2N KHAI TH\u01AF\u01A0NG M\u1EA0I (COMMERCIAL READY)**
+`;
+  await storage.saveArtifact(projectId, `_released/client_pack/HANDOVER_DOCUMENT.md`, handoverDoc);
+  await storage.saveArtifact(projectId, `HANDOVER_DOCUMENT.md`, handoverDoc);
+  onProgress?.("@packager", `\u{1F389} B\xE0n giao th\xE0nh c\xF4ng to\xE0n b\u1ED9 4 g\xF3i h\u1ECDc li\u1EC7u v\xE0o th\u01B0 m\u1EE5c \`_released/\`!`);
+  return {
+    projectId,
+    handoverDoc,
+    teacherPackFiles: [`_released/teacher_pack/TEACHER_HANDBOOK.md`],
+    studentPackFiles: [`_released/student_pack/STUDENT_SYLLABUS.md`],
+    parentPackFiles: [`_released/parent_pack/COURSE_OVERVIEW.md`],
+    clientPackFiles: [`_released/client_pack/HANDOVER_DOCUMENT.md`, `HANDOVER_DOCUMENT.md`],
+    quizzesCsv,
+    quizzesJson,
+    timestamp: dateStr
+  };
+}
+
+export { LocalWorkspaceManager, buildDeliveryPackages, exportAllProjectQuizzes, formatQuizzesToCsv, parseQuizMarkdown, publishToGitHub, publishToSupabase, uploadAssetToBucket };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map