@thanh01.pmt/curriculum-kit 1.4.8 → 1.4.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tony Pham
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -8417,13 +8417,16 @@ function computeContentHash(content) {
   return "sha256:" + crypto__default.default.createHash("sha256").update(content.trim(), "utf-8").digest("hex");
 }
 var STANDARD_SOT_FILES = [
-  "PROJECT_BRIEF.md",
   "LEARNER_PROFILE.md",
+  "PROJECT_BRIEF.md",
+  "REFERENCE_PACK.md",
+  "PROJECT_GRAPH.json",
+  "HYBRID_GRAPH.json",
+  "SECTION_LANGUAGE_CONTRACT.md",
   "CURRICULUM_FRAMEWORK.md",
-  "PROJECT_STATUS.md",
   "CONTENT_STYLE_GUIDE.md",
   "ART_DIRECTION.md",
-  "REFERENCE_PACK.md"
+  "ALIGNMENT_MATRIX.md"
 ];
 var FileSystemCurriculumAdapter = class {
   baseDir;
@@ -8465,19 +8468,33 @@ var FileSystemCurriculumAdapter = class {
   async listSotDocuments(projectId) {
     const projectDir = this.getProjectDir(projectId);
     const sotDir = path3__default.default.join(projectDir, "_sot");
-    return STANDARD_SOT_FILES.map((filename) => {
+    const discoveredFiles = new Set(STANDARD_SOT_FILES);
+    if (fs2__default.default.existsSync(sotDir)) {
+      try {
+        const diskFiles = fs2__default.default.readdirSync(sotDir);
+        for (const f of diskFiles) {
+          if (f.startsWith(".") || f.endsWith(".review.json")) continue;
+          const fullPath = path3__default.default.join(sotDir, f);
+          if (fs2__default.default.statSync(fullPath).isFile()) {
+            discoveredFiles.add(f);
+          }
+        }
+      } catch {
+      }
+    }
+    return Array.from(discoveredFiles).map((filename) => {
       const p = fs2__default.default.existsSync(path3__default.default.join(sotDir, filename)) ? path3__default.default.join(sotDir, filename) : fs2__default.default.existsSync(path3__default.default.join(projectDir, filename)) ? path3__default.default.join(projectDir, filename) : null;
       if (p && fs2__default.default.existsSync(p)) {
         const stats = fs2__default.default.statSync(p);
         return {
-          name: filename.replace(".md", "").replace(/_/g, " "),
+          name: filename.replace(/\.(md|json)$/i, "").replace(/_/g, " "),
           filename,
           exists: true,
           sizeBytes: stats.size
         };
       }
       return {
-        name: filename.replace(".md", "").replace(/_/g, " "),
+        name: filename.replace(/\.(md|json)$/i, "").replace(/_/g, " "),
         filename,
         exists: false,
         sizeBytes: 0
@@ -8723,11 +8740,23 @@ var SupabaseCurriculumAdapter = class {
     return null;
   }
   async listSotDocuments(projectId) {
+    const discoveredFiles = new Set(STANDARD_SOT_FILES);
+    try {
+      const { data, error } = await this.client.storage.from(this.bucketName).list(`${projectId}/_sot`);
+      if (!error && data) {
+        for (const item of data) {
+          if (item.name && !item.name.startsWith(".") && !item.name.endsWith(".review.json")) {
+            discoveredFiles.add(item.name);
+          }
+        }
+      }
+    } catch {
+    }
     const results = [];
-    for (const filename of STANDARD_SOT_FILES) {
+    for (const filename of discoveredFiles) {
       const content = await this.readSotDocument(projectId, filename);
       results.push({
-        name: filename.replace(".md", "").replace(/_/g, " "),
+        name: filename.replace(/\.(md|json)$/i, "").replace(/_/g, " "),
         filename,
         exists: !!content,
         content: content || void 0,
@@ -9104,10 +9133,12 @@ async function auditQualityReport(storage, projectId) {
   computedScore += Math.round(bloomPassCount / total * 20);
   computedScore += Math.round(Math.min(syntaxExecutableCount, total) / total * 20);
   computedScore += Math.round(scopeCompletenessCount / total * 20);
+  const sotCompletedCount = status.sotReadiness.filter((s) => s.exists).length;
+  const sotTotalCount = status.sotReadiness.length;
   if (sotReady) {
-    details.push("\u2705 N\u1EC1n t\u1EA3ng SOT (7/7 t\xE0i li\u1EC7u) s\u1EB5n s\xE0ng.");
+    details.push(`\u2705 N\u1EC1n t\u1EA3ng SOT (${sotCompletedCount}/${sotTotalCount} t\xE0i li\u1EC7u) s\u1EB5n s\xE0ng.`);
   } else {
-    details.push("\u26A0\uFE0F C\u1EA7n ho\xE0n thi\u1EC7n \u0111\u1EA7y \u0111\u1EE7 t\xE0i li\u1EC7u SOT c\u01A1 s\u1EDF.");
+    details.push(`\u26A0\uFE0F C\u1EA7n ho\xE0n thi\u1EC7n \u0111\u1EA7y \u0111\u1EE7 t\xE0i li\u1EC7u SOT c\u01A1 s\u1EDF (${sotCompletedCount}/${sotTotalCount}).`);
   }
   details.push(`\u{1F3AF} Ph\u1EA1m vi h\u1ECDc li\u1EC7u theo SOT (Artifact Scope): [${artifactScope.join(", ")}].`);
   if (pedagogy5EPass) {
@@ -9123,7 +9154,7 @@ async function auditQualityReport(storage, projectId) {
   details.push(`\u2705 \u0110\u1ED9 ph\u1EE7 \u0111\u1EA7y \u0111\u1EE7 c\xE1c h\u1ECDc li\u1EC7u trong Artifact Scope: ${scopeCompletenessCount}/${total} b\xE0i h\u1ECDc.`);
   const rawMarkdownReport = `## \u{1F6E1}\uFE0F B\xC1O C\xC1O KI\u1EC2M \u0110\u1ECANH CH\u1EA4T L\u01AF\u1EE2NG (QUALITY AUDIT): \`${projectId.toUpperCase()}\`
 - **\u0110i\u1EC3m th\u1EA9m \u0111\u1ECBnh ch\u1EA5t l\u01B0\u1EE3ng:** **${computedScore}/100**
-- **Tr\u1EA1ng th\xE1i SOT:** ${sotReady ? "\u2705 7/7 File SOT ho\xE0n t\u1EA5t" : "\u26A0\uFE0F C\u1EA7n b\u1ED5 sung t\xE0i li\u1EC7u SOT thi\u1EBFu"}.
+- **Tr\u1EA1ng th\xE1i SOT:** ${sotReady ? `\u2705 ${sotCompletedCount}/${sotTotalCount} File SOT ho\xE0n t\u1EA5t` : `\u26A0\uFE0F C\u1EA7n b\u1ED5 sung t\xE0i li\u1EC7u SOT thi\u1EBFu (${sotCompletedCount}/${sotTotalCount})`}.
 - **Ph\u1EA1m vi h\u1ECDc li\u1EC7u (SOT Artifact Scope):** \`${artifactScope.join(", ")}\`
 - **C\u1EA5u tr\xFAc S\u01B0 ph\u1EA1m (5E / EDP):** ${pedagogy5ECount}/${total} b\xE0i h\u1ECDc \u0111\u1EA1t chu\u1EA9n ph\xE2n pha.
 - **Thang \u0111o nh\u1EADn th\u1EE9c Bloom:** ${bloomPassCount}/${total} b\xE0i h\u1ECDc \u0111\u1EA1t ma tr\u1EADn m\u1EE5c ti\xEAu.
@@ -9225,7 +9256,9 @@ function extractScopeSequenceRows(framework) {
     const trimmed = line.trim();
     if (!trimmed.startsWith("|")) continue;
     const lower = trimmed.toLowerCase();
-    if (lower.includes("lesson code") && lower.includes("learning objective")) {
+    const hasCodeCol = lower.includes("lesson code") || lower.includes("m\xE3 b\xE0i") || lower.includes("m\xE3 b\xE0i h\u1ECDc");
+    const hasObjCol = lower.includes("learning objective") || lower.includes("m\u1EE5c ti\xEAu") || lower.includes("m\u1EE5c ti\xEAu h\u1ECDc t\u1EADp");
+    if (hasCodeCol && hasObjCol) {
       headerFound = true;
       continue;
     }
@@ -27870,6 +27903,7 @@ var pad22 = (n) => String(n).padStart(2, "0");
 var esc = (s) => s.replace(/\|/g, "/").replace(/\n/g, " ").trim();
 var BLOOM_OF_DEPTH = { ulo: "Understand", cio: "Apply", sio: "Create" };
 function renderFrameworkFromPlan(plan, meta) {
+  const isVi = meta.targetLanguage === "vi";
   const dateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   const totalSessions = plan.sessions.length;
   const totalMinutes = plan.sessions.reduce(
@@ -27887,10 +27921,16 @@ function renderFrameworkFromPlan(plan, meta) {
     const depthTops = [...new Set(s.depth_assignments.map((d) => d.depth))].map((d) => BLOOM_OF_DEPTH[d] ?? "Apply");
     const bloom = depthTops[depthTops.length - 1] ?? "Apply";
     const keyConcepts = s.new_keywords.length > 0 ? s.new_keywords.join(", ") : s.depth_assignments.map((d) => d.node_id).join(", ");
-    const prereq = s.prerequisite_decisions.length > 0 ? s.prerequisite_decisions.filter((p) => p.decision === "taught_in_prior_lesson").length + " prior-taught, " + s.prerequisite_decisions.filter((p) => p.decision === "recap_in_lesson").length + " recap" : "None";
+    const prereq = s.prerequisite_decisions.length > 0 ? s.prerequisite_decisions.filter((p) => p.decision === "taught_in_prior_lesson").length + " prior-taught, " + s.prerequisite_decisions.filter((p) => p.decision === "recap_in_lesson").length + " recap" : isVi ? "Kh\xF4ng" : "None";
     const duration = s.knowledge_minutes + s.practice_minutes + s.overhead_minutes;
     return "| " + pad22(i + 1) + " | " + s.id + " | " + esc(s.title) + " | " + s.unit_id + " | " + s.unit_id + "_M01 | " + esc(s.prose_objective) + " | " + esc(keyConcepts) + " | " + esc(s.exit_evidence[0] ?? "") + " | " + esc(prereq) + " | " + bloom + " | " + duration + " |";
   }).join("\n");
+  const courseOverviewHeader = isVi ? "## [REQUIRED] T\u1ED5ng quan Kh\xF3a h\u1ECDc" : "## [REQUIRED] Course Overview";
+  const globalObjectivesHeader = isVi ? "## [REQUIRED] M\u1EE5c ti\xEAu H\u1ECDc t\u1EADp To\xE0n di\u1EC7n" : "## [REQUIRED] Global Learning Objectives";
+  const structuralHierarchyHeader = isVi ? "## [REQUIRED] C\u1EA5u tr\xFAc Kh\xF3a h\u1ECDc (Unit & Module)" : "## [REQUIRED] Structural Hierarchy (Unit & Module)";
+  const scopeSequenceHeader = isVi ? "## [REQUIRED] Ph\u1EA1m vi & Tr\xECnh t\u1EF1 Chi ti\u1EBFt (Scope & Sequence)" : "## [REQUIRED] Scope & Sequence (Detailed Roadmap)";
+  const standardFormatHeader = isVi ? "## [REQUIRED] C\u1EA5u tr\xFAc B\xE0i h\u1ECDc Chu\u1EA9n" : "## [REQUIRED] Standard Lesson Format";
+  const scopeTableHeader = isVi ? "| # | Lesson Code | Title | Unit | Module | Learning Objective (H\u1ECDc sinh l\xE0m \u0111\u01B0\u1EE3c g\xEC...) | Key Concepts (H\u1ECDc g\xEC) | Hands-on Deliverable (S\u1EA3n ph\u1EA9m bu\u1ED5i h\u1ECDc) | Prerequisites | Bloom | Duration (mins) |" : "| # | Lesson Code | Title | Unit | Module | Learning Objective (Students will be able to...) | Key Concepts (Hoc gi) | Hands-on Deliverable (Lam duoc gi) | Prerequisites | Bloom | Duration (mins) |";
   return [
     "---",
     'id: "CURRICULUM-FRAMEWORK"',
@@ -27912,7 +27952,7 @@ function renderFrameworkFromPlan(plan, meta) {
     "",
     "_Projection of CURRICULUM_PLAN (hash " + plan.plan_hash + "). Approving this framework approves the per-session SCOPE recorded in the plan._",
     "",
-    "## [REQUIRED] Course Overview",
+    courseOverviewHeader,
     "- **Official Course Name:** " + esc(meta.courseName),
     meta.shortDescription ? "- **Short Description:** " + esc(meta.shortDescription) : "",
     "- **Total Units:** " + plan.units.length,
@@ -27920,20 +27960,20 @@ function renderFrameworkFromPlan(plan, meta) {
     "- **Total Duration:** ~" + totalHours + " hours (" + totalSessions + " sessions x " + plan.constraints.session_duration_minutes + " min).",
     "- **Entry Level:** " + plan.constraints.entry_level + " (age band " + plan.constraints.age_band[0] + "-" + plan.constraints.age_band[1] + ").",
     "",
-    "## [REQUIRED] Global Learning Objectives",
+    globalObjectivesHeader,
     ...plan.course.objectives.map((o, i) => i + 1 + ". **[" + o.bloom + "]:** " + esc(o.statement)),
     "",
-    "## [REQUIRED] Structural Hierarchy (Unit & Module)",
+    structuralHierarchyHeader,
     "| Unit | Module | Lessons | Module Objective | Lesson Codes |",
     "|---|---|:---:|---|---|",
     hierarchyRows || "| (none) | | | | |",
     "",
-    "## [REQUIRED] Scope & Sequence (Detailed Roadmap)",
-    "| # | Lesson Code | Title | Unit | Module | Learning Objective (Students will be able to...) | Key Concepts (Hoc gi) | Hands-on Deliverable (Lam duoc gi) | Prerequisites | Bloom | Duration (mins) |",
+    scopeSequenceHeader,
+    scopeTableHeader,
     "|:---:|:---:|---|---|---|---|---|---|---|:---:|:---:|",
     scopeRows || "| 01 | U01_M01_L01 | (empty plan) | U01 | U01_M01 | - | - | - | None | Understand | " + plan.constraints.session_duration_minutes + " |",
     "",
-    "## [REQUIRED] Standard Lesson Format",
+    standardFormatHeader,
     "- **Session duration:** " + plan.constraints.session_duration_minutes + " minutes (overhead " + String(plan.sessions[0]?.overhead_minutes ?? 0) + " min).",
     "- **Knowledge/practice split per session:** see plan JSON (knowledge_minutes / practice_minutes).",
     "- **Pedagogical flow:** 5E (Engage / Explore / Explain / Elaborate / Evaluate) unless policy overrides.",