@thanh01.pmt/curriculum-kit 1.4.44 → 1.4.45

package/docs/refs/templates/SECTION_LANGUAGE_CONTRACT_template.md

@@ -0,0 +1,44 @@
+---
+id: "{{ID}}"
+type: "SECTION_LANGUAGE_CONTRACT"
+created_by: "Curriculum OS Builder"
+phase: "P2"
+deliverable: "P2-T4"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+target_language: "{{TARGET_LANGUAGE}}"
+template_contract: "artifact-template-v1"
+template_required_sections:
+  - "Metadata & Scope"
+  - "Section Translation Matrix"
+  - "Validation Rules"
+---
+# SECTION LANGUAGE CONTRACT
+
+## Metadata & Scope
+- **Project:** {{PROJECT_NAME}}
+- **Target output language:** {{TARGET_LANGUAGE_DISPLAY}}
+- **Scope:** heading/label localization for every generated artifact of this project only.
+
+## Section Translation Matrix
+> One row per canonical section key (from each template's
+> `template_required_sections`). The Localized Heading is what the LLM must
+> render verbatim in artifacts; P53 bake applies these rows onto the project's
+> `_templates/` copies. Do not translate technical identifiers.
+
+| Artifact | Canonical Section Key | Localized Heading ({{TARGET_LANGUAGE}}) |
+|---|---|---|
+| LESSON | A. Lesson Design Plan | [localized] |
+| LESSON | B. Lesson Flow | [localized] |
+| ACT | Computational Thinking Focus | [localized] |
+| QUIZ | Assessment Objectives | [localized] |
+<!-- Repeat per artifact type and section key. -->
+
+## Validation Rules
+- Every canonical key in a template's `template_required_sections` MUST have
+  exactly one row here before bake (missing row → that section keeps its
+  canonical English heading).
+- Keys MUST match the template contract after ordinal/marker stripping
+  (`1. ` and `[REQUIRED]` ignored).
+- Localized headings MUST NOT contain contract markers or CJK glyphs outside
+  the target language script rules.

package/docs/refs/templates/SELF_LAB_template.md

@@ -7,6 +7,13 @@ difficulty: "{{DIFFICULTY}}"
 estimated_minutes: {{ESTIMATED_MINUTES}}
 tech_stack: {{TECH_STACK}}
 ---
+template_required_sections:
+  - "📋 Mission Briefing & Environment Setup"
+  - "🛫 Preflight Checklist"
+  - "🎯 Progressive Challenges (3-Tier Differentiation)"
+  - "🔍 Self-Learner Troubleshooting Matrix"
+  - "🏁 Final Lab Submission & Mastery Checklist"
+---
 
 # 🚀 Self-Paced Hands-On Lab: {{TITLE}}
 

package/docs/refs/templates/SLIDE_template.md

@@ -5,6 +5,29 @@ paginate: true
 header: "{{HEADER_TITLE}}"
 footer: "LearnWell Platform | {{LESSON_ID}}"
 ---
+template_required_sections:
+  - "🗺️ Agenda & Milestone Journey Map"
+  - "⚡ Warm-Up: Diagnostic Quick-Fire"
+  - "🧠 Prior Knowledge Recall"
+  - "🎯 Hook Scenario: The Engineering Dilemma"
+  - "⚠️ System Failure in Production:"
+  - "💡 The Core Mental Model"
+  - "📝 Implementation Blueprint"
+  - "🔍 Anatomy & Mechanics"
+  - "🚀 Quick Micro-Practice: Try It Now (3 Mins)"
+  - "🥉 Starter Hint:"
+  - "⏱️ Pacing & Success Check:"
+  - "🛠️ Integrated Hands-On Lab: Capstone Mission"
+  - "🎯 Mission Objective:"
+  - "🚦 Formative Checkpoint: Status Calibration"
+  - "🟢 Green Light (Ready to Accelerate)"
+  - "🟡 Yellow Light (Need Quick Assist)"
+  - "🔴 Red Light (Blocked)"
+  - "🎟️ Exit Ticket & Metacognition (5 Mins)"
+  - "🏁 Summary & Key Takeaways"
+  - "🏆 Core Rules to Remember:"
+  - "🔮 Next Milestone Preview:"
+---
 
 <!-- Slide 1: Title & Inquiry Mission Hook -->
 # 🚀 {{TITLE}}

package/docs/refs/templates/STATION_ROTATION_template.md

@@ -10,18 +10,18 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Station Architecture & Timer Overview"
-  - "Station 1: Teacher-Led Small Group (Deep Dive)"
-  - "Station 2: Collaborative Hands-On Lab (Peer Pair)"
-  - "Station 3: Independent Digital Practice (Async Code)"
-  - "Station 4: Offline Modeling & Architecture (Whiteboard)"
-  - "Station Recording Sheet & Rotation Bell Protocol"
+  - "Station 1: Teacher-Led Small Group (Guided Inquiry)"
+  - "Station 2: Collaborative Hands-On Lab (Pair Programming)"
+  - "Station 3: Independent Digital Practice (Self-Paced Code Lab)"
+  - "Station 4: Offline Modeling & Architecture (No Screens)"
+  - "Station Recording Sheet (Student Passport)"
 ---
 <!-- INJECT_BODY -->
 
 # STATION ROTATION LESSON PACK: [LESSON TITLE]
 _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
-## [REQUIRED] Station Architecture & Timer Overview
+## Station Architecture & Timer Overview
 - **Classroom Layout:** 4 designated physical zones with clear signage and materials.
 - **Rotation Time:** 15 minutes per station + 2 minutes clean transition buffer.
 - **Audience Grouping:** Heterogeneous groups of 4-6 students rotating simultaneously.
@@ -38,7 +38,7 @@ _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
 ---
 
-## [REQUIRED] Station 1: Teacher-Led Small Group (Guided Inquiry)
+## Station 1: Teacher-Led Small Group (Guided Inquiry)
 - **Goal:** Direct coaching, conceptual check, and resolving misconceptions in real-time.
 - **Teacher Script & Inquiry Questions:**
   - *"Look at this code on the monitor. If we call this function 100 times concurrently, what invariant breaks?"*
@@ -47,7 +47,7 @@ _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
 ---
 
-## [REQUIRED] Station 2: Collaborative Hands-On Lab (Pair Programming)
+## Station 2: Collaborative Hands-On Lab (Pair Programming)
 - **Goal:** Students work in pairs (Driver / Navigator) to solve a 2-stage challenge.
 - **Task Materials:** Pre-loaded project on workstation `Station2_PairChallenge.xcodeproj`.
 - **Protocol:** Switch Driver/Navigator roles at the 7-minute audio chime.
@@ -55,7 +55,7 @@ _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
 ---
 
-## [REQUIRED] Station 3: Independent Digital Practice (Self-Paced Code Lab)
+## Station 3: Independent Digital Practice (Self-Paced Code Lab)
 - **Goal:** Autonomy and individual mastery verification.
 - **Student Instructions:**
   1. Open Interactive Code Runner / LMS assignment module.
@@ -64,14 +64,14 @@ _Unit: U[X] | Module: M[X.X] | Format: 4 Stations x 15 Mins (Total 60-75 Mins)_
 
 ---
 
-## [REQUIRED] Station 4: Offline Modeling & Architecture (No Screens)
+## Station 4: Offline Modeling & Architecture (No Screens)
 - **Goal:** Cognitive unloading and physical spatial reasoning.
 - **Materials:** Whiteboard markers, physical Task Cards deck, and laminated architecture templates.
 - **Task:** Hand-draw the data-flow flowchart or match physical cards connecting UI Event $\rightarrow$ State Mutation $\rightarrow$ Screen Re-render.
 
 ---
 
-## [REQUIRED] Station Recording Sheet (Student Passport)
+## Station Recording Sheet (Student Passport)
 | Station | Task Completed | Signature / Verification Stamp | 1 Key Insight Learned |
 | :---: | :--- | :--- | :--- |
 | **1 (Teacher)** | Debugging Probe Discussion | [Teacher Stamp] | |

package/docs/refs/templates/TASK_CARDS_template.md

@@ -10,9 +10,9 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Deck Overview & Print Instructions"
-  - "Task Cards 1 to 4 (Foundational Concepts)"
-  - "Task Cards 5 to 8 (Code Diagnosis & Debugging)"
-  - "Task Cards 9 to 12 (Application & Synthesis)"
+  - "Set A: Foundational Concepts (Cards 1–4)"
+  - "Set B: Code Diagnosis & Debugging (Cards 5–8)"
+  - "Set C: Application & Synthesis (Cards 9–12)"
   - "Teacher Answer Key & Scoring Matrix"
 ---
 <!-- INJECT_BODY -->
@@ -20,14 +20,14 @@ template_required_sections:
 # PRINTABLE TASK CARDS PACK: [LESSON TITLE]
 _Unit: U[X] | Module: M[X.X] | Total Cards: 12-16 Cards | Usage: Centers, Fast Finishers, Small Group Review_
 
-## [REQUIRED] Deck Overview & Print Instructions
+## Deck Overview & Print Instructions
 - **Card Format:** 4 cards per page (A4 layout with cutting guidelines and QR code link).
 - **Target Skills:** Conceptual Understanding, Code Tracing, Bug Hunting, Architectural Reasoning.
 - **Scoring System:** Bronze Cards (1 pt), Silver Cards (2 pts), Gold Cards (3 pts).
 
 ---
 
-## [REQUIRED] Set A: Foundational Concepts (Cards 1–4)
+## Set A: Foundational Concepts (Cards 1–4)
 
 ```
 ┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
@@ -50,7 +50,7 @@ _Unit: U[X] | Module: M[X.X] | Total Cards: 12-16 Cards | Usage: Centers, Fast F
 
 ---
 
-## [REQUIRED] Set B: Code Diagnosis & Debugging (Cards 5–8)
+## Set B: Code Diagnosis & Debugging (Cards 5–8)
 
 ```
 ┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
@@ -74,7 +74,7 @@ _Unit: U[X] | Module: M[X.X] | Total Cards: 12-16 Cards | Usage: Centers, Fast F
 
 ---
 
-## [REQUIRED] Set C: Application & Synthesis (Cards 9–12)
+## Set C: Application & Synthesis (Cards 9–12)
 
 ```
 ┌──────────────────────────────────────────────┬──────────────────────────────────────────────┐
@@ -94,7 +94,7 @@ _Unit: U[X] | Module: M[X.X] | Total Cards: 12-16 Cards | Usage: Centers, Fast F
 
 ---
 
-## [REQUIRED] Teacher Answer Key & Scoring Matrix
+## Teacher Answer Key & Scoring Matrix
 | Card ID | Correct Answer / Solution Blueprint | Max Points |
 | :---: | :--- | :---: |
 | **01** | `@State` owns private source of truth; `@Binding` creates a 2-way reference without owning storage. | 1 pt |

package/docs/refs/templates/TIERED_PRACTICE_template.md

@@ -10,18 +10,22 @@ date: "{{DATE}}"
 template_contract: "artifact-template-v1"
 template_required_sections:
   - "Computational Objective & Tier Matrix"
-  - "Bronze Tier (Foundational Scaffolding)"
-  - "Silver Tier (Independent Application)"
-  - "Gold Tier (Enrichment & Optimization)"
-  - "Automated Test Verification Matrix"
-  - "Answer Key & Mentor Hints"
+  - "🥉 Bronze Tier: Foundational Scaffolding (Baseline for All)"
+  - "Starter Code & Fill-in Slots:"
+  - "🥈 Silver Tier: Independent Application (Target Mastery)"
+  - "Specification & Requirements:"
+  - "Implementation Target:"
+  - "🥇 Gold Tier: Enrichment & Optimization (Open Extension)"
+  - "Constraints & Invariants:"
+  - "Automated Test Verification Matrix & Mentor Hints"
+  - "Mentor Debugging Cheatsheet:"
 ---
 <!-- INJECT_BODY -->
 
 # 3-TIER DIFFERENTIATED PRACTICE LAB: [LESSON TITLE]
 _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Mode: Adaptive Lab_
 
-## [REQUIRED] Computational Objective & Tier Matrix
+## Computational Objective & Tier Matrix
 > *Principle: All students MUST achieve Bronze; Silver is target mastery; Gold is for gifted/accelerated learners.*
 
 | Tier Level | Cognitive Target (Bloom) | Scaffolding Ratio | Success Criteria |
@@ -32,7 +36,7 @@ _Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX] | Mode: Adaptive Lab_
 
 ---
 
-## [REQUIRED] 🥉 Bronze Tier: Foundational Scaffolding (Baseline for All)
+## 🥉 Bronze Tier: Foundational Scaffolding (Baseline for All)
 - **Target Audience:** All learners (mandatory milestone).
 - **Guiding Prompt:** [Clear, unambiguous instruction with concrete references to Handout].
 
@@ -62,7 +66,7 @@ struct [BronzeComponentView]: View {
 
 ---
 
-## [REQUIRED] 🥈 Silver Tier: Independent Application (Target Mastery)
+## 🥈 Silver Tier: Independent Application (Target Mastery)
 - **Target Audience:** Learners who completed Bronze without mentor intervention.
 - **Guiding Prompt:** [Add dynamic logic, validation, state mutations, or multiple interactive elements].
 
@@ -82,7 +86,7 @@ struct [SilverComponentView]: View {
 
 ---
 
-## [REQUIRED] 🥇 Gold Tier: Enrichment & Optimization (Open Extension)
+## 🥇 Gold Tier: Enrichment & Optimization (Open Extension)
 - **Target Audience:** Advanced learners finished ahead of schedule.
 - **Architectural Challenge:** [E.g., "Decouple state into an isolated Actor / ViewModel with async/await Debounce or Cache invalidation"].
 
@@ -92,7 +96,7 @@ struct [SilverComponentView]: View {
 
 ---
 
-## [REQUIRED] Automated Test Verification Matrix & Mentor Hints
+## Automated Test Verification Matrix & Mentor Hints
 ```swift
 // XCTest / Unit Test Suite for Instant Auto-Grading
 final class [ArtifactTestSuite]: XCTestCase {

package/docs/refs/templates/UPDATE_ROADMAP_template.md

@@ -8,6 +8,13 @@ deliverable: "{{DELIVERABLE_CODE}}"
 version: "{{VERSION}}"
 date: "{{DATE}}"
 ---
+template_required_sections:
+  - "Update Triggers"
+  - "Planned Releases"
+  - "📌 Short-term: Update v1.1 (Post-Pilot)"
+  - "📌 Long-term: Version v2.0 (Next Academic Year)"
+  - "Resources & Archiving"
+---
 
 # CURRICULUM UPDATE ROADMAP
 

package/docs/refs/templates/WKS_template.md

@@ -15,14 +15,13 @@ template_required_sections:
   - "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
+## Part 1: Knowledge Check
 > Warm-up — prior-knowledge retrieval. Link back to the previous lesson.
 
 1. **Fill in the blanks:**
@@ -34,7 +33,7 @@ template_required_sections:
    | 1. [Concept A] | 1 - __ | a. [Meaning A] |
    | 2. [Concept B] | 2 - __ | b. [Meaning B] |
 
-## [REQUIRED] Part 2: Concept Tracing & Diagram Fill-in
+## Part 2: Concept Tracing & Diagram Fill-in
 > Trace data/control flow through this lesson's core mechanism. Fill the
 > Mermaid/ASCII diagram blanks.
 
@@ -46,7 +45,7 @@ graph LR
 
 - **Trace question:** [What flows from stage to stage? What transforms?]
 
-## [REQUIRED] Part 3: Code Analysis & Bug Hunting Challenge
+## 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.
 
@@ -58,13 +57,13 @@ graph LR
 - **Why it fails:** [Student explanation]
 - **Fix:** [Student correction]
 
-## [REQUIRED] Part 4: Synthesis & Problem-Solving Application
+## 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
+## 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]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanh01.pmt/curriculum-kit",
-  "version": "1.4.44",
+  "version": "1.4.45",
   "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",