@thanh01.pmt/curriculum-kit 1.4.41 → 1.4.43

package/dist/templates/UPDATE_ROADMAP_template.md

@@ -0,0 +1,53 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "UPDATE_ROADMAP"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "{{DELIVERABLE_CODE}}"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+---
+
+# CURRICULUM UPDATE ROADMAP
+
+_Project: [Course Name / PRJ Code] | Current Version: v[1.0]_
+
+## 1. Update Triggers
+_To avoid time-consuming minor updates, the team will only proceed with updates when the following conditions are met:_
+
+- **[PATCH] Hotfix (Local Correction):**
+  - *Trigger:* Client reports bugs in code, dangerous/non-functional circuit diagrams, or severe typos.
+  - *SLA:* Handled within [X] working days.
+- **[MINOR] Update v1.x (Pedagogical Refinement):**
+  - *Trigger:* Accumulated `PILOT_FEEDBACK` from at least [X] sessions, or after [Y] months of real-world implementation.
+  - *Scope:* Tone adjustment, example changes, activity swaps (No change to Learning Objectives).
+- **[MAJOR] Update v2.x (Comprehensive Upgrade):**
+  - *Trigger:* Client renews contract for a new school year, major changes in national standards, or hardware/software upgrades (e.g., Scratch 3.0 to 4.0).
+  - *Scope:* Re-run process from Phase 1 (Learner Profile & Framework).
+
+---
+
+## 2. Planned Releases
+
+### 📌 Short-term: Update v1.1 (Post-Pilot)
+- **Estimated Release:** [Month/Year, e.g., After Semester 1 ends]
+- **Goal:** Patch difficulty gaps based on actual student feedback. Optimize practical timing.
+- **Main Agent(s):** `@reviewer` (Feedback harvesting), `@content`, `@activity`.
+- **Estimated Duration:** [X] days.
+
+### 📌 Long-term: Version v2.0 (Next Academic Year)
+- **Estimated Release:** [Month/Year, e.g., Preparation for the next academic year]
+- **Goal (Planned):**
+  - Upgrade platform from [Old Platform] to [New Platform].
+  - Add [X] new Modules on [AI/IoT/etc.].
+  - Expand target audience from [Grade X] to [Grade Y].
+- **Main Agent(s):** `@analyst` and `@designer` to rework the Framework.
+- **Estimated Duration:** [X] weeks.
+
+---
+
+## 3. Resources & Archiving
+- The current version (v[1.0]) will be permanently archived at: `_snapshots/S2_v1.0_delivered_[DATE]/`.
+- Clients using v1.0 can continue usage without mandatory upgrades unless hardware requirements change.
+- All change histories are tracked in `CHANGELOG.md`.

package/dist/templates/WKS_template.md

@@ -0,0 +1,71 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "WKS"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T7"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Part 1: Knowledge Check"
+  - "Part 2: Concept Tracing & Diagram Fill-in"
+  - "Part 3: Code Analysis & Bug Hunting Challenge"
+  - "Part 4: Synthesis & Problem-Solving Application"
+  - "Part 5: Self-Reflection & Learning Log"
+---
+
+# WORKSHEET: [LESSON TITLE]
+
+**Student Name:** _______________________  **Class:** _______________  **Date:** _______________
+
+> **For Students:** This document guides you step-by-step through the practical tasks. Read carefully, fill in the blanks, and mark the checkbox [x] once completed. If you encounter errors, refer back to your **HANDOUT**.
+
+## [REQUIRED] Part 1: Knowledge Check
+> Warm-up — prior-knowledge retrieval. Link back to the previous lesson.
+
+1. **Fill in the blanks:**
+   - [Statement with _______________ blanks tied to prior lesson keywords.]
+
+2. **Match the concept:**
+   | Concept | Link | Meaning |
+   |---|---|---|
+   | 1. [Concept A] | 1 - __ | a. [Meaning A] |
+   | 2. [Concept B] | 2 - __ | b. [Meaning B] |
+
+## [REQUIRED] Part 2: Concept Tracing & Diagram Fill-in
+> Trace data/control flow through this lesson's core mechanism. Fill the
+> Mermaid/ASCII diagram blanks.
+
+```mermaid
+graph LR
+  A[[[Fill: stage 1]]] --> B[[[Fill: stage 2]]]
+  B --> C[[[Fill: stage 3]]]
+```
+
+- **Trace question:** [What flows from stage to stage? What transforms?]
+
+## [REQUIRED] Part 3: Code Analysis & Bug Hunting Challenge
+> One complete, runnable snippet containing a real bug from this lesson's
+> Common Mistakes. Students locate, explain, and fix it.
+
+```[language]
+// [Snippet with an embedded lesson bug]
+```
+
+- **Bug located at line:** ______
+- **Why it fails:** [Student explanation]
+- **Fix:** [Student correction]
+
+## [REQUIRED] Part 4: Synthesis & Problem-Solving Application
+> Apply the lesson's skill to a fresh scenario — not a copy of the lab task.
+
+- **Scenario:** [New situation requiring the same skill]
+- **Your solution:** [Workspace / code area]
+
+## [REQUIRED] Part 5: Self-Reflection & Learning Log
+- **I can now…** [Can-do statements mirroring the LESSON LO evidence — checkbox each]
+  - [ ] [Can-do statement 1]
+  - [ ] [Can-do statement 2]
+- **Muddiest point:** [What is still unclear?]

package/dist/workflow/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var fs = require('fs');
-var path4 = require('path');
+var fs5 = require('fs');
+var path = require('path');
 var google = require('@ai-sdk/google');
 var openai = require('@ai-sdk/openai');
 var deepseek = require('@ai-sdk/deepseek');
@@ -11,14 +11,14 @@ var workflow = require('workflow');
 var fs2 = require('fs/promises');
 var rest = require('@octokit/rest');
 var supabaseJs = require('@supabase/supabase-js');
-var url = require('url');
 require('crypto');
+var url = require('url');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var fs__default = /*#__PURE__*/_interopDefault(fs);
-var path4__default = /*#__PURE__*/_interopDefault(path4);
+var fs5__default = /*#__PURE__*/_interopDefault(fs5);
+var path__default = /*#__PURE__*/_interopDefault(path);
 var fs2__default = /*#__PURE__*/_interopDefault(fs2);
 
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -150,18 +150,18 @@ function resolveApiKey(keyName, explicitKey) {
   try {
     const currentDir = process.cwd();
     const envPaths = [
-      path4__default.default.resolve(currentDir, ".env.local"),
-      path4__default.default.resolve(currentDir, ".env"),
-      path4__default.default.resolve(currentDir, "apps/web/.env.local"),
-      path4__default.default.resolve(currentDir, "packages/learnwell-platform/.env"),
-      path4__default.default.resolve(currentDir, "..", ".env.local"),
-      path4__default.default.resolve(currentDir, "..", ".env"),
-      path4__default.default.resolve(currentDir, "../..", ".env.local"),
-      path4__default.default.resolve(currentDir, "../..", ".env")
+      path__default.default.resolve(currentDir, ".env.local"),
+      path__default.default.resolve(currentDir, ".env"),
+      path__default.default.resolve(currentDir, "apps/web/.env.local"),
+      path__default.default.resolve(currentDir, "packages/learnwell-platform/.env"),
+      path__default.default.resolve(currentDir, "..", ".env.local"),
+      path__default.default.resolve(currentDir, "..", ".env"),
+      path__default.default.resolve(currentDir, "../..", ".env.local"),
+      path__default.default.resolve(currentDir, "../..", ".env")
     ];
     for (const envPath of envPaths) {
-      if (fs__default.default.existsSync(envPath)) {
-        const content = fs__default.default.readFileSync(envPath, "utf-8");
+      if (fs5__default.default.existsSync(envPath)) {
+        const content = fs5__default.default.readFileSync(envPath, "utf-8");
         for (const line of content.split("\n")) {
           const trimmed = line.trim();
           if (trimmed && !trimmed.startsWith("#") && trimmed.startsWith(keyName + "=")) {
@@ -3013,6 +3013,37 @@ This lab focuses on the practical implementation of core technical concepts, bri
 {{CHECKLIST_ITEMS}}
 `.trim();
 
+// src/templates/quizTemplate.ts
+var QUIZ_TEMPLATE = `
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "QUIZ"
+language: "{{LANGUAGE}}"
+total_questions: {{TOTAL_QUESTIONS}}
+passing_score_pct: {{PASSING_SCORE_PCT}}
+---
+
+# \u{1F9E0} Diagnostic & Active Recall Quiz: {{TITLE}}
+
+> \u23F1\uFE0F **Recommended Time:** ~10-15 mins  
+> \u{1F3AF} **Passing Score:** {{PASSING_SCORE_PCT}}%  
+> \u{1F4A1} **Purpose:** Test your conceptual understanding, catch hidden misconceptions, and evaluate architectural trade-offs.
+
+---
+
+{{QUESTIONS_SECTION}}
+
+---
+
+## \u{1F511} Comprehensive Answer Key & Deep Explanation (Expand after completing)
+<details>
+<summary><b>\u{1F449} Click to View Full Explanations & Common Pitfall Analysis</b></summary>
+
+{{ANSWER_KEY_SECTION}}
+</details>
+`.trim();
+
 // src/templates/selfLabTemplate.ts
 var SELF_LAB_TEMPLATE = `
 ---
@@ -3184,37 +3215,6 @@ tech_stack: {{TECH_STACK}}
 {{FINAL_CHECKLIST}}
 `.trim();
 
-// src/templates/quizTemplate.ts
-var QUIZ_TEMPLATE = `
----
-id: "{{ID}}"
-title: "{{TITLE}}"
-type: "QUIZ"
-language: "{{LANGUAGE}}"
-total_questions: {{TOTAL_QUESTIONS}}
-passing_score_pct: {{PASSING_SCORE_PCT}}
----
-
-# \u{1F9E0} Diagnostic & Active Recall Quiz: {{TITLE}}
-
-> \u23F1\uFE0F **Recommended Time:** ~10-15 mins  
-> \u{1F3AF} **Passing Score:** {{PASSING_SCORE_PCT}}%  
-> \u{1F4A1} **Purpose:** Test your conceptual understanding, catch hidden misconceptions, and evaluate architectural trade-offs.
-
----
-
-{{QUESTIONS_SECTION}}
-
----
-
-## \u{1F511} Comprehensive Answer Key & Deep Explanation (Expand after completing)
-<details>
-<summary><b>\u{1F449} Click to View Full Explanations & Common Pitfall Analysis</b></summary>
-
-{{ANSWER_KEY_SECTION}}
-</details>
-`.trim();
-
 // src/ai/prompts/lessonMasterPrompt.ts
 function buildLessonMasterPrompt(input) {
   const { milestone, language, topic, targetAudience, contextContinuity, standardsContext } = input;
@@ -4965,10 +4965,10 @@ ${answerKeySection}
 var LocalWorkspaceManager = class {
   baseDir;
   constructor(baseDir) {
-    this.baseDir = baseDir || path4__default.default.resolve(process.cwd(), "output", "workspace-jobs");
+    this.baseDir = baseDir || path__default.default.resolve(process.cwd(), "output", "workspace-jobs");
   }
   getJobDirectory(jobId) {
-    return path4__default.default.join(this.baseDir, jobId);
+    return path__default.default.join(this.baseDir, jobId);
   }
   async initJobWorkspace(jobId, initialInfo) {
     const jobDir = this.getJobDirectory(jobId);
@@ -4991,9 +4991,9 @@ var LocalWorkspaceManager = class {
   }
   async saveArtifact(jobId, milestoneSlug, filename, content, artifactType) {
     const jobDir = this.getJobDirectory(jobId);
-    const targetDir = path4__default.default.join(jobDir, milestoneSlug);
+    const targetDir = path__default.default.join(jobDir, milestoneSlug);
     await fs2__default.default.mkdir(targetDir, { recursive: true });
-    const filePath = path4__default.default.join(targetDir, filename);
+    const filePath = path__default.default.join(targetDir, filename);
     await fs2__default.default.writeFile(filePath, content, "utf-8");
     const stat = await fs2__default.default.stat(filePath);
     const manifest = await this.getManifest(jobId);
@@ -5001,7 +5001,7 @@ var LocalWorkspaceManager = class {
       manifest.artifacts.push({
         milestoneId: milestoneSlug,
         artifactType,
-        filePath: path4__default.default.relative(jobDir, filePath),
+        filePath: path__default.default.relative(jobDir, filePath),
         sizeBytes: stat.size,
         createdAt: (/* @__PURE__ */ new Date()).toISOString()
       });
@@ -5011,7 +5011,7 @@ var LocalWorkspaceManager = class {
     return filePath;
   }
   async getManifest(jobId) {
-    const manifestPath = path4__default.default.join(this.getJobDirectory(jobId), "manifest.json");
+    const manifestPath = path__default.default.join(this.getJobDirectory(jobId), "manifest.json");
     try {
       const data = await fs2__default.default.readFile(manifestPath, "utf-8");
       return JSON.parse(data);
@@ -5020,7 +5020,7 @@ var LocalWorkspaceManager = class {
     }
   }
   async saveManifest(jobId, manifest) {
-    const manifestPath = path4__default.default.join(this.getJobDirectory(jobId), "manifest.json");
+    const manifestPath = path__default.default.join(this.getJobDirectory(jobId), "manifest.json");
     manifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     await fs2__default.default.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
   }
@@ -5061,12 +5061,12 @@ async function publishToGitHub(options) {
     async function scanDir(currentDir) {
       const entries = await fs2__default.default.readdir(currentDir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = path4__default.default.join(currentDir, entry.name);
+        const fullPath = path__default.default.join(currentDir, entry.name);
         if (entry.isDirectory()) {
           await scanDir(fullPath);
         } else if (entry.isFile() && !entry.name.startsWith(".")) {
           const content = await fs2__default.default.readFile(fullPath, "utf-8");
-          const relPath = path4__default.default.relative(options.localJobDir, fullPath);
+          const relPath = path__default.default.relative(options.localJobDir, fullPath);
           filesToUpload.push({ path: relPath, content });
         }
       }
@@ -19786,32 +19786,52 @@ zod.z.object({
   assessmentMap: zod.z.array(zod.z.record(zod.z.string())).default([]),
   tieredScaffolding: zod.z.object({ bronze: zod.z.string().default(""), silver: zod.z.string().default(""), gold: zod.z.string().default("") }).default({ bronze: "", silver: "", gold: "" })
 });
-
-// src/services/lessonProductionService.ts
-var __filename$1 = typeof (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) === "string" && typeof url.fileURLToPath === "function" ? url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))) : "";
-var _resolvedDir = __filename$1 ? path4__default.default.dirname(__filename$1) : typeof __dirname !== "undefined" ? __dirname : process.cwd();
-function loadCurriculumTemplate(templateName) {
-  const candidatePaths = [
-    path4__default.default.resolve("/Users/tonypham/MEGA/WebApp/WIP/learnwell-platform/packages/curriculum-kit/docs/refs/templates", templateName),
-    path4__default.default.resolve(process.cwd(), "packages/curriculum-kit/docs/refs/templates", templateName),
-    path4__default.default.resolve(process.cwd(), "_templates", templateName),
-    path4__default.default.resolve(process.cwd(), "docs/refs/templates", templateName),
-    path4__default.default.resolve(_resolvedDir, "../docs/refs/templates", templateName),
-    path4__default.default.resolve(_resolvedDir, "../../docs/refs/templates", templateName),
-    path4__default.default.resolve(_resolvedDir, "../../../docs/refs/templates", templateName),
-    path4__default.default.resolve("/Users/tonypham/MEGA/WebApp/content-gen/the-ultimate-curriculum-agent-os/_templates", templateName),
-    path4__default.default.resolve(_resolvedDir, "../../../../the-ultimate-curriculum-agent-os/_templates", templateName)
-  ];
-  for (const p of candidatePaths) {
-    if (fs__default.default.existsSync(p)) {
-      try {
-        return fs__default.default.readFileSync(p, "utf-8");
-      } catch {
-      }
+var KIT_TEMPLATE_FALLBACK_DIRS = [
+  // Packaged with the npm bundle (dist/templates) — resolves from node_modules.
+  "templates",
+  // Repo checkout layouts.
+  "docs/refs/templates"
+];
+var _moduleDir = (() => {
+  try {
+    if (typeof ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) }) !== "undefined" && typeof (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) === "string") {
+      return path__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
     }
+  } catch {
+  }
+  return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+})();
+function candidateDirs(explicitDir) {
+  const dirs = [];
+  if (process.env.CURRICULUM_TEMPLATES_DIR) dirs.push(process.env.CURRICULUM_TEMPLATES_DIR);
+  dirs.push(path__default.default.resolve(process.cwd(), "_templates"));
+  for (const rel of KIT_TEMPLATE_FALLBACK_DIRS) {
+    dirs.push(path__default.default.resolve(_moduleDir, rel));
+    dirs.push(path__default.default.resolve(process.cwd(), rel));
+    dirs.push(path__default.default.resolve(process.cwd(), "packages/curriculum-kit", rel));
+  }
+  return dirs;
+}
+function findTemplatePath(templateName, explicitDir) {
+  for (const dir of candidateDirs()) {
+    const p = path__default.default.join(dir, templateName);
+    if (!fs5__default.default.existsSync(p)) continue;
+    try {
+      fs5__default.default.accessSync(p, fs5__default.default.constants.R_OK);
+      return p;
+    } catch {
+    }
+  }
+  return null;
+}
+function loadCurriculumTemplate(templateName, templatesDir) {
+  const p = findTemplatePath(templateName);
+  if (!p) return "";
+  try {
+    return fs5__default.default.readFileSync(p, "utf-8");
+  } catch {
+    return "";
   }
-  console.warn(`[curriculum-kit:loadCurriculumTemplate] \u26A0\uFE0F Template "${templateName}" not found across candidate paths. Falling back to inline structural scaffolding.`);
-  return "";
 }
 
 // src/services/singleArtifactService.ts