@plasius/learning 0.2.1 → 0.2.3

package/README.md

@@ -64,19 +64,37 @@ the exact catalog module that owns its rubric, mission and badges.
 import {
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
+  ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
+  SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1,
   assertValidMissionAuthoringBundle,
 } from "@plasius/learning";
 
 const roadHopper = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
   (module) => module.slug === "road-hopper-rally",
 );
+const robotMaze = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (module) => module.slug === "robot-maze-dash",
+);
+const skywing = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (module) => module.slug === "skywing-sprint",
+);
 
-if (!roadHopper) throw new Error("Road Hopper Rally is missing");
+if (!roadHopper || !robotMaze || !skywing) {
+  throw new Error("Junior Coder module is missing");
+}
 
 assertValidMissionAuthoringBundle(
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
   roadHopper,
 );
+assertValidMissionAuthoringBundle(
+  ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
+  robotMaze,
+);
+assertValidMissionAuthoringBundle(
+  SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1,
+  skywing,
+);
 ```
 
 ## Contract rules
@@ -92,6 +110,9 @@ assertValidMissionAuthoringBundle(
   → explain → reward`, and readiness checks never affect the score.
 - Learner evidence and rewards can bind only to visible goals; protected goal
   IDs stay in the facilitator projection.
+- Visual-programming missions must provide an equivalent labelled control for
+  every drag interaction so learners can complete the same work with keyboard
+  or pointer buttons.
 - Rubric criteria total exactly 100 points.
 - Completion requires a score of at least 80 and every mandatory criterion.
 - Module agents may explain evidence and propose a bounded next step, but cannot assign scores or rewards.

package/dist/index.cjs

@@ -27,6 +27,8 @@ __export(index_exports, {
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1: () => MISSION_AUTHORING_CONTRACT_VERSION_V1,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1: () => ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
+  ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1: () => ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
+  SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1: () => SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1,
   assertValidLearningPath: () => assertValidLearningPath,
   assertValidMissionAuthoringBundle: () => assertValidMissionAuthoringBundle,
   calculateAssessment: () => calculateAssessment,
@@ -1126,6 +1128,440 @@ function assertValidMissionAuthoringBundle(bundle, module3) {
   throw new Error(`Invalid mission authoring bundle:
 ${summary}`);
 }
+var ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1 = {
+  version: MISSION_AUTHORING_CONTRACT_VERSION_V1,
+  moduleId: "junior-coder.robot-maze-dash",
+  moduleVersion: "1.1.0",
+  missionId: "robot-maze-dash-mission-1",
+  learner: {
+    estimatedMinutes: 20,
+    stages: [
+      {
+        kind: "learn",
+        instruction: "Meet the move, turn-left and turn-right action blocks and read what each command does.",
+        artifactIds: ["robot-maze-dash-m1-art"]
+      },
+      {
+        kind: "predict",
+        instruction: "Predict where the robot will stop after it follows the blocks from top to bottom.",
+        artifactIds: []
+      },
+      {
+        kind: "build",
+        instruction: "Arrange the action blocks so the rescue robot can reach the beacon.",
+        artifactIds: ["robot-maze-dash-m1-program"]
+      },
+      {
+        kind: "run",
+        instruction: "Use the Run action button to watch the robot follow your visual program.",
+        artifactIds: ["robot-maze-dash-m1-program"]
+      },
+      {
+        kind: "assess",
+        instruction: "Run the visible and protected deterministic mission checks.",
+        artifactIds: []
+      },
+      {
+        kind: "inspect",
+        instruction: "Compare the highlighted block with the first goal that did not pass.",
+        artifactIds: []
+      },
+      {
+        kind: "fix",
+        instruction: "Move, add or remove one action block, then run the mission again.",
+        artifactIds: ["robot-maze-dash-m1-program"]
+      },
+      {
+        kind: "explain",
+        instruction: "Explain how the order of your blocks changed the robot path.",
+        artifactIds: []
+      },
+      {
+        kind: "reward",
+        instruction: "Collect the evidence-bound badge when the score and safety check pass.",
+        artifactIds: []
+      }
+    ],
+    readinessChecks: [
+      {
+        id: "robot-maze-dash-m1-read-order",
+        prompt: "Point to the first action the robot will follow.",
+        scored: false
+      }
+    ],
+    artifacts: [
+      {
+        id: "robot-maze-dash-m1-program",
+        kind: "starter-code",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "robot-maze-dash-m1-art",
+        kind: "starter-assets",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "robot-maze-dash-m1-printable",
+        kind: "printable",
+        audience: "learner",
+        solutionBearing: false
+      }
+    ],
+    goals: [
+      {
+        id: "robot-maze-dash-m1-starts",
+        statement: "The visual program is structurally valid and starts.",
+        visibility: "visible",
+        criterionIds: ["robot-maze-dash-build"],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "robot-maze-dash-m1-reaches-beacon",
+        statement: "The robot follows the action order and reaches the rescue beacon.",
+        visibility: "visible",
+        criterionIds: [
+          "robot-maze-dash-goal-one",
+          "robot-maze-dash-goal-two"
+        ],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "robot-maze-dash-m1-safe-preview",
+        statement: "The robot stays inside the private maze simulator boundary.",
+        visibility: "visible",
+        criterionIds: ["robot-maze-dash-safety"],
+        completionRequired: true,
+        aiRequired: false
+      }
+    ],
+    interactions: [
+      {
+        id: "robot-maze-dash-m1-reorder-blocks",
+        description: "Change the order of visual action blocks.",
+        primaryMode: "drag",
+        alternativeIds: ["robot-maze-dash-m1-button-reorder"]
+      },
+      {
+        id: "robot-maze-dash-m1-run-control",
+        description: "Start the private maze simulation.",
+        primaryMode: "pointer",
+        alternativeIds: ["robot-maze-dash-m1-keyboard-run"]
+      }
+    ],
+    accessibilityAlternatives: [
+      {
+        id: "robot-maze-dash-m1-button-reorder",
+        modes: ["keyboard", "pointer"],
+        equivalentOutcome: true,
+        description: "Use labelled Move up and Move down buttons instead of dragging a block."
+      },
+      {
+        id: "robot-maze-dash-m1-keyboard-run",
+        modes: ["keyboard"],
+        equivalentOutcome: true,
+        description: "Start the same simulation by pressing Enter or Space on the Run button."
+      }
+    ],
+    evidenceRequirements: [
+      {
+        id: "robot-maze-dash-m1-assessment",
+        goalIds: [
+          "robot-maze-dash-m1-starts",
+          "robot-maze-dash-m1-reaches-beacon",
+          "robot-maze-dash-m1-safe-preview"
+        ],
+        kind: "assessment-result",
+        retention: "entitlement",
+        containsPersonalData: false
+      },
+      {
+        id: "robot-maze-dash-m1-explanation",
+        goalIds: ["robot-maze-dash-m1-reaches-beacon"],
+        kind: "learner-explanation",
+        retention: "attempt",
+        containsPersonalData: false
+      }
+    ],
+    sideAdventures: [
+      {
+        id: "robot-maze-dash-m1-remix",
+        prompt: "Invent a different safe route and describe which action block must change first.",
+        completionRequired: false
+      }
+    ],
+    rewardBindings: [
+      {
+        id: "robot-maze-dash-m1-badge",
+        badgeId: "robot-maze-dash-mission-complete",
+        goalIds: [
+          "robot-maze-dash-m1-starts",
+          "robot-maze-dash-m1-reaches-beacon",
+          "robot-maze-dash-m1-safe-preview"
+        ],
+        deterministic: true,
+        random: false,
+        tokenConvertible: false
+      }
+    ]
+  },
+  facilitator: {
+    artifacts: [
+      {
+        id: "robot-maze-dash-m1-answer-key",
+        kind: "answer-key",
+        audience: "facilitator",
+        solutionBearing: true
+      },
+      {
+        id: "robot-maze-dash-m1-protected-tests",
+        kind: "protected-test",
+        audience: "facilitator",
+        solutionBearing: true
+      }
+    ],
+    protectedGoals: [
+      {
+        id: "robot-maze-dash-m1-protected-bounds",
+        statement: "The interpreter stops safely at walls, bounds and its action limit.",
+        visibility: "protected",
+        criterionIds: [
+          "robot-maze-dash-edge-one",
+          "robot-maze-dash-edge-two"
+        ],
+        completionRequired: false,
+        aiRequired: false
+      }
+    ],
+    prompts: [
+      "Ask the learner to point to the first action block before suggesting a change.",
+      "Use the command reference and visible goal; never reveal the protected route or expected block list."
+    ]
+  }
+};
+var SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1 = {
+  version: MISSION_AUTHORING_CONTRACT_VERSION_V1,
+  moduleId: "junior-coder.skywing-sprint",
+  moduleVersion: "1.1.0",
+  missionId: "skywing-sprint-mission-1",
+  learner: {
+    estimatedMinutes: 20,
+    stages: [
+      {
+        kind: "learn",
+        instruction: "Read how lift, gravity and gate-gap functions change Skywing's flight.",
+        artifactIds: ["skywing-sprint-m1-art"]
+      },
+      {
+        kind: "predict",
+        instruction: "Predict whether Skywing will rise or fall after one lift pulse.",
+        artifactIds: []
+      },
+      {
+        kind: "build",
+        instruction: "Adjust the three documented settings in the starter JavaScript.",
+        artifactIds: ["skywing-sprint-m1-code"]
+      },
+      {
+        kind: "run",
+        instruction: "Use the Run action button to start the private flight preview.",
+        artifactIds: ["skywing-sprint-m1-code"]
+      },
+      {
+        kind: "assess",
+        instruction: "Run the visible and protected deterministic flight checks.",
+        artifactIds: []
+      },
+      {
+        kind: "inspect",
+        instruction: "Compare the highlighted setting with the first goal that did not pass.",
+        artifactIds: []
+      },
+      {
+        kind: "fix",
+        instruction: "Change one setting, run again and observe the flight telemetry.",
+        artifactIds: ["skywing-sprint-m1-code"]
+      },
+      {
+        kind: "explain",
+        instruction: "Explain how lift and gravity changed Skywing's vertical speed.",
+        artifactIds: []
+      },
+      {
+        kind: "reward",
+        instruction: "Collect the evidence-bound badge when the score and safety check pass.",
+        artifactIds: []
+      }
+    ],
+    readinessChecks: [
+      {
+        id: "skywing-sprint-m1-predict-velocity",
+        prompt: "Point to the setting that changes Skywing's upward push.",
+        scored: false
+      }
+    ],
+    artifacts: [
+      {
+        id: "skywing-sprint-m1-code",
+        kind: "starter-code",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "skywing-sprint-m1-art",
+        kind: "starter-assets",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "skywing-sprint-m1-printable",
+        kind: "printable",
+        audience: "learner",
+        solutionBearing: false
+      }
+    ],
+    goals: [
+      {
+        id: "skywing-sprint-m1-starts",
+        statement: "The JavaScript settings are valid and the private preview starts.",
+        visibility: "visible",
+        criterionIds: ["skywing-sprint-build"],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "skywing-sprint-m1-safe-flight",
+        statement: "Lift and gravity create a controllable flight through the rescue gate.",
+        visibility: "visible",
+        criterionIds: [
+          "skywing-sprint-goal-one",
+          "skywing-sprint-goal-two"
+        ],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "skywing-sprint-m1-private-runtime",
+        statement: "The game stays inside the private educational preview boundary.",
+        visibility: "visible",
+        criterionIds: ["skywing-sprint-safety"],
+        completionRequired: true,
+        aiRequired: false
+      }
+    ],
+    interactions: [
+      {
+        id: "skywing-sprint-m1-run-control",
+        description: "Start the private flight simulation.",
+        primaryMode: "pointer",
+        alternativeIds: ["skywing-sprint-m1-keyboard-run"]
+      },
+      {
+        id: "skywing-sprint-m1-flight-control",
+        description: "Send a lift pulse while the preview is running.",
+        primaryMode: "keyboard",
+        alternativeIds: []
+      },
+      {
+        id: "skywing-sprint-m1-flight-motion",
+        description: "Observe Skywing moving through the animated gate preview.",
+        primaryMode: "motion",
+        alternativeIds: ["skywing-sprint-m1-reduced-motion"]
+      }
+    ],
+    accessibilityAlternatives: [
+      {
+        id: "skywing-sprint-m1-keyboard-run",
+        modes: ["keyboard"],
+        equivalentOutcome: true,
+        description: "Press Enter or Space on the play-icon Run button to start the same preview."
+      },
+      {
+        id: "skywing-sprint-m1-reduced-motion",
+        modes: ["text"],
+        equivalentOutcome: true,
+        description: "Use the position, velocity and gate-status text instead of animation."
+      }
+    ],
+    evidenceRequirements: [
+      {
+        id: "skywing-sprint-m1-assessment",
+        goalIds: [
+          "skywing-sprint-m1-starts",
+          "skywing-sprint-m1-safe-flight",
+          "skywing-sprint-m1-private-runtime"
+        ],
+        kind: "assessment-result",
+        retention: "entitlement",
+        containsPersonalData: false
+      },
+      {
+        id: "skywing-sprint-m1-explanation",
+        goalIds: ["skywing-sprint-m1-safe-flight"],
+        kind: "learner-explanation",
+        retention: "attempt",
+        containsPersonalData: false
+      }
+    ],
+    sideAdventures: [
+      {
+        id: "skywing-sprint-m1-remix",
+        prompt: "Invent a new gate name and choose one setting to make the flight gentler.",
+        completionRequired: false
+      }
+    ],
+    rewardBindings: [
+      {
+        id: "skywing-sprint-m1-badge",
+        badgeId: "skywing-sprint-mission-complete",
+        goalIds: [
+          "skywing-sprint-m1-starts",
+          "skywing-sprint-m1-safe-flight",
+          "skywing-sprint-m1-private-runtime"
+        ],
+        deterministic: true,
+        random: false,
+        tokenConvertible: false
+      }
+    ]
+  },
+  facilitator: {
+    artifacts: [
+      {
+        id: "skywing-sprint-m1-answer-key",
+        kind: "answer-key",
+        audience: "facilitator",
+        solutionBearing: true
+      },
+      {
+        id: "skywing-sprint-m1-protected-tests",
+        kind: "protected-test",
+        audience: "facilitator",
+        solutionBearing: true
+      }
+    ],
+    protectedGoals: [
+      {
+        id: "skywing-sprint-m1-protected-resilience",
+        statement: "The runtime clamps unsafe values and terminates bounded simulations.",
+        visibility: "protected",
+        criterionIds: [
+          "skywing-sprint-edge-one",
+          "skywing-sprint-edge-two"
+        ],
+        completionRequired: false,
+        aiRequired: false
+      }
+    ],
+    prompts: [
+      "Ask the learner which direction a positive velocity moves Skywing before suggesting a setting change.",
+      "Use the visible telemetry and function reference; never reveal protected numeric targets or expected source fragments."
+    ]
+  }
+};
 var ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1 = {
   version: MISSION_AUTHORING_CONTRACT_VERSION_V1,
   moduleId: "junior-coder.road-hopper-rally",
@@ -1482,6 +1918,8 @@ ${summary}`);
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
+  ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
+  SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1,
   assertValidLearningPath,
   assertValidMissionAuthoringBundle,
   calculateAssessment,