@thanh01.pmt/curriculum-kit 1.4.41 → 1.4.43

package/docs/refs/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/docs/refs/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanh01.pmt/curriculum-kit",
-  "version": "1.4.41",
+  "version": "1.4.43",
   "description": "A high-fidelity AI curriculum & content generation engine powered by Vercel AI SDK, Zod, and Bloom-aligned pedagogical standards.",
   "author": "Thanh Pham <https://github.com/thanh01pmt>",
   "license": "MIT",
@@ -56,14 +56,16 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "docs/refs/templates"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run clean && tsup",
+    "build": "npm run clean && tsup && node scripts/copy-templates.mjs && node scripts/verify-packaging.mjs",
+    "postpack": "node scripts/verify-packaging.mjs",
     "lint": "eslint . --ext .ts",
     "test": "vitest run",
     "test:academic": "vitest run src/__tests__/academic",