@plasius/learning 0.2.4 → 0.2.6

package/README.md

@@ -63,7 +63,9 @@ the exact catalog module that owns its rubric, mission and badges.
 ```ts
 import {
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
+  METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
+  RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
   ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
   SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1,
@@ -82,8 +84,21 @@ const skywing = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
 const paddlePulse = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
   (module) => module.slug === "paddle-pulse",
 );
+const meteorShield = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (module) => module.slug === "meteor-shield",
+);
+const rescueCrewCommander = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (module) => module.slug === "rescue-crew-commander",
+);
 
-if (!roadHopper || !robotMaze || !skywing || !paddlePulse) {
+if (
+  !roadHopper ||
+  !robotMaze ||
+  !skywing ||
+  !paddlePulse ||
+  !meteorShield ||
+  !rescueCrewCommander
+) {
   throw new Error("Junior Coder module is missing");
 }
 
@@ -103,6 +118,14 @@ assertValidMissionAuthoringBundle(
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
   paddlePulse,
 );
+assertValidMissionAuthoringBundle(
+  METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
+  meteorShield,
+);
+assertValidMissionAuthoringBundle(
+  RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
+  rescueCrewCommander,
+);
 ```
 
 ## Contract rules

package/dist/index.cjs

@@ -25,8 +25,10 @@ __export(index_exports, {
   JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
+  METEOR_SHIELD_MISSION_ONE_AUTHORING_V1: () => METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1: () => MISSION_AUTHORING_CONTRACT_VERSION_V1,
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1: () => PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
+  RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1: () => RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_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,
@@ -1783,6 +1785,452 @@ var PADDLE_PULSE_MISSION_ONE_AUTHORING_V1 = {
     ]
   }
 };
+var RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1 = {
+  version: MISSION_AUTHORING_CONTRACT_VERSION_V1,
+  moduleId: "junior-coder.rescue-crew-commander",
+  moduleVersion: "1.1.0",
+  missionId: "rescue-crew-commander-mission-1",
+  learner: {
+    estimatedMinutes: 20,
+    stages: [
+      {
+        kind: "learn",
+        instruction: "Meet the helper, job, route and priority blocks and read what each block does in the synchronized JavaScript view.",
+        artifactIds: ["rescue-crew-commander-m1-art"]
+      },
+      {
+        kind: "predict",
+        instruction: "Predict which helper will act first and which safe route it will follow.",
+        artifactIds: []
+      },
+      {
+        kind: "build",
+        instruction: "Arrange the visual blocks to give each helper one safe rescue job.",
+        artifactIds: ["rescue-crew-commander-m1-program"]
+      },
+      {
+        kind: "run",
+        instruction: "Use the Run action button to watch the crew follow the typed visual program.",
+        artifactIds: ["rescue-crew-commander-m1-program"]
+      },
+      {
+        kind: "assess",
+        instruction: "Run the visible and protected deterministic crew checks.",
+        artifactIds: []
+      },
+      {
+        kind: "inspect",
+        instruction: "Compare the highlighted block with the first goal that did not pass and inspect the matching JavaScript line.",
+        artifactIds: []
+      },
+      {
+        kind: "fix",
+        instruction: "Move or replace one job, route or priority block, then run the mission again.",
+        artifactIds: ["rescue-crew-commander-m1-program"]
+      },
+      {
+        kind: "explain",
+        instruction: "Explain how job order and priority changed the crew state and rescue result.",
+        artifactIds: []
+      },
+      {
+        kind: "reward",
+        instruction: "Collect the evidence-bound badge when the score and private-simulator safety check pass.",
+        artifactIds: []
+      }
+    ],
+    readinessChecks: [
+      {
+        id: "rescue-crew-commander-m1-find-priority",
+        prompt: "Point to the block that decides which helper acts first.",
+        scored: false
+      }
+    ],
+    artifacts: [
+      {
+        id: "rescue-crew-commander-m1-program",
+        kind: "starter-code",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "rescue-crew-commander-m1-art",
+        kind: "starter-assets",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "rescue-crew-commander-m1-printable",
+        kind: "printable",
+        audience: "learner",
+        solutionBearing: false
+      }
+    ],
+    goals: [
+      {
+        id: "rescue-crew-commander-m1-starts",
+        statement: "The typed visual program is structurally valid and starts.",
+        visibility: "visible",
+        criterionIds: ["rescue-crew-commander-build"],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "rescue-crew-commander-m1-safe-jobs",
+        statement: "Every helper receives one suitable job and the highest-priority rescue starts first.",
+        visibility: "visible",
+        criterionIds: [
+          "rescue-crew-commander-goal-one",
+          "rescue-crew-commander-goal-two"
+        ],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "rescue-crew-commander-m1-private-runtime",
+        statement: "The crew stays inside the private simulator and follows only host-provided actions.",
+        visibility: "visible",
+        criterionIds: ["rescue-crew-commander-safety"],
+        completionRequired: true,
+        aiRequired: false
+      }
+    ],
+    interactions: [
+      {
+        id: "rescue-crew-commander-m1-reorder-blocks",
+        description: "Change the order of typed job, route and priority blocks.",
+        primaryMode: "drag",
+        alternativeIds: ["rescue-crew-commander-m1-button-reorder"]
+      },
+      {
+        id: "rescue-crew-commander-m1-run-control",
+        description: "Start the private rescue-crew simulation.",
+        primaryMode: "pointer",
+        alternativeIds: ["rescue-crew-commander-m1-keyboard-run"]
+      },
+      {
+        id: "rescue-crew-commander-m1-crew-motion",
+        description: "Observe helpers change state and follow their assigned routes.",
+        primaryMode: "motion",
+        alternativeIds: ["rescue-crew-commander-m1-status-view"]
+      }
+    ],
+    accessibilityAlternatives: [
+      {
+        id: "rescue-crew-commander-m1-button-reorder",
+        modes: ["keyboard", "pointer"],
+        equivalentOutcome: true,
+        description: "Use labelled Move up and Move down buttons instead of dragging a visual block."
+      },
+      {
+        id: "rescue-crew-commander-m1-keyboard-run",
+        modes: ["keyboard"],
+        equivalentOutcome: true,
+        description: "Press Enter or Space on the play-icon Run button to start the same preview."
+      },
+      {
+        id: "rescue-crew-commander-m1-status-view",
+        modes: ["text", "symbol", "reduced-motion"],
+        equivalentOutcome: true,
+        description: "Read each helper's job, route, priority and state from the status list without animation or colour dependence."
+      }
+    ],
+    evidenceRequirements: [
+      {
+        id: "rescue-crew-commander-m1-assessment",
+        goalIds: [
+          "rescue-crew-commander-m1-starts",
+          "rescue-crew-commander-m1-safe-jobs",
+          "rescue-crew-commander-m1-private-runtime"
+        ],
+        kind: "assessment-result",
+        retention: "entitlement",
+        containsPersonalData: false
+      },
+      {
+        id: "rescue-crew-commander-m1-explanation",
+        goalIds: ["rescue-crew-commander-m1-safe-jobs"],
+        kind: "learner-explanation",
+        retention: "attempt",
+        containsPersonalData: false
+      }
+    ],
+    sideAdventures: [
+      {
+        id: "rescue-crew-commander-m1-remix",
+        prompt: "Invent an original helper role and explain which safe route and priority it should receive.",
+        completionRequired: false
+      }
+    ],
+    rewardBindings: [
+      {
+        id: "rescue-crew-commander-m1-badge",
+        badgeId: "rescue-crew-commander-mission-complete",
+        goalIds: [
+          "rescue-crew-commander-m1-starts",
+          "rescue-crew-commander-m1-safe-jobs",
+          "rescue-crew-commander-m1-private-runtime"
+        ],
+        deterministic: true,
+        random: false,
+        tokenConvertible: false
+      }
+    ]
+  },
+  facilitator: {
+    artifacts: [
+      {
+        id: "rescue-crew-commander-m1-answer-key",
+        kind: "answer-key",
+        audience: "facilitator",
+        solutionBearing: true
+      },
+      {
+        id: "rescue-crew-commander-m1-protected-tests",
+        kind: "protected-test",
+        audience: "facilitator",
+        solutionBearing: true
+      }
+    ],
+    protectedGoals: [
+      {
+        id: "rescue-crew-commander-m1-protected-resilience",
+        statement: "The interpreter rejects unknown blocks, duplicate assignments and programs over the action limit.",
+        visibility: "protected",
+        criterionIds: [
+          "rescue-crew-commander-edge-one",
+          "rescue-crew-commander-edge-two"
+        ],
+        completionRequired: false,
+        aiRequired: false
+      }
+    ],
+    prompts: [
+      "Ask the learner which helper should act first before suggesting a block change.",
+      "Use the block reference, status list and visible goal; never reveal the protected assignment order or expected block sequence."
+    ]
+  }
+};
+var METEOR_SHIELD_MISSION_ONE_AUTHORING_V1 = {
+  version: MISSION_AUTHORING_CONTRACT_VERSION_V1,
+  moduleId: "junior-coder.meteor-shield",
+  moduleVersion: "1.1.0",
+  missionId: "meteor-shield-mission-1",
+  learner: {
+    estimatedMinutes: 20,
+    stages: [
+      {
+        kind: "learn",
+        instruction: "Read how target column, shield energy and launch delay change a rescue defence.",
+        artifactIds: ["meteor-shield-m1-art"]
+      },
+      {
+        kind: "predict",
+        instruction: "Predict which rescue base the shield will protect first.",
+        artifactIds: []
+      },
+      {
+        kind: "build",
+        instruction: "Adjust the three documented settings in the starter JavaScript.",
+        artifactIds: ["meteor-shield-m1-code"]
+      },
+      {
+        kind: "run",
+        instruction: "Use the Run action button to start the private meteor-wave preview.",
+        artifactIds: ["meteor-shield-m1-code"]
+      },
+      {
+        kind: "assess",
+        instruction: "Run the visible and protected deterministic defence 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 energy and target telemetry.",
+        artifactIds: ["meteor-shield-m1-code"]
+      },
+      {
+        kind: "explain",
+        instruction: "Explain how targeting and launch timing affected the remaining shield energy.",
+        artifactIds: []
+      },
+      {
+        kind: "reward",
+        instruction: "Collect the evidence-bound badge when the score and safety check pass.",
+        artifactIds: []
+      }
+    ],
+    readinessChecks: [
+      {
+        id: "meteor-shield-m1-find-energy",
+        prompt: "Point to the setting that limits how many shields can launch.",
+        scored: false
+      }
+    ],
+    artifacts: [
+      {
+        id: "meteor-shield-m1-code",
+        kind: "starter-code",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "meteor-shield-m1-art",
+        kind: "starter-assets",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "meteor-shield-m1-printable",
+        kind: "printable",
+        audience: "learner",
+        solutionBearing: false
+      }
+    ],
+    goals: [
+      {
+        id: "meteor-shield-m1-starts",
+        statement: "The JavaScript settings are valid and the private preview starts.",
+        visibility: "visible",
+        criterionIds: ["meteor-shield-build"],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "meteor-shield-m1-resource-defence",
+        statement: "A shield launches toward the selected meteor while keeping enough energy for the next wave.",
+        visibility: "visible",
+        criterionIds: [
+          "meteor-shield-goal-one",
+          "meteor-shield-goal-two"
+        ],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "meteor-shield-m1-private-runtime",
+        statement: "The game stays inside the private educational preview boundary.",
+        visibility: "visible",
+        criterionIds: ["meteor-shield-safety"],
+        completionRequired: true,
+        aiRequired: false
+      }
+    ],
+    interactions: [
+      {
+        id: "meteor-shield-m1-run-control",
+        description: "Start the private meteor-wave simulation.",
+        primaryMode: "pointer",
+        alternativeIds: ["meteor-shield-m1-keyboard-run"]
+      },
+      {
+        id: "meteor-shield-m1-target-control",
+        description: "Move the targeting reticle between rescue columns and launch a shield.",
+        primaryMode: "keyboard",
+        alternativeIds: []
+      },
+      {
+        id: "meteor-shield-m1-wave-motion",
+        description: "Observe meteors and shield pulses crossing the rescue zone.",
+        primaryMode: "motion",
+        alternativeIds: ["meteor-shield-m1-telemetry"]
+      }
+    ],
+    accessibilityAlternatives: [
+      {
+        id: "meteor-shield-m1-keyboard-run",
+        modes: ["keyboard"],
+        equivalentOutcome: true,
+        description: "Press Enter or Space on the play-icon Run button to start the same preview."
+      },
+      {
+        id: "meteor-shield-m1-telemetry",
+        modes: ["text", "reduced-motion"],
+        equivalentOutcome: true,
+        description: "Use target column, wave, distance and energy text instead of projectile animation."
+      }
+    ],
+    evidenceRequirements: [
+      {
+        id: "meteor-shield-m1-assessment",
+        goalIds: [
+          "meteor-shield-m1-starts",
+          "meteor-shield-m1-resource-defence",
+          "meteor-shield-m1-private-runtime"
+        ],
+        kind: "assessment-result",
+        retention: "entitlement",
+        containsPersonalData: false
+      },
+      {
+        id: "meteor-shield-m1-explanation",
+        goalIds: ["meteor-shield-m1-resource-defence"],
+        kind: "learner-explanation",
+        retention: "attempt",
+        containsPersonalData: false
+      }
+    ],
+    sideAdventures: [
+      {
+        id: "meteor-shield-m1-remix",
+        prompt: "Invent an original rescue-base signal and describe the safe game event that activates it.",
+        completionRequired: false
+      }
+    ],
+    rewardBindings: [
+      {
+        id: "meteor-shield-m1-badge",
+        badgeId: "meteor-shield-mission-complete",
+        goalIds: [
+          "meteor-shield-m1-starts",
+          "meteor-shield-m1-resource-defence",
+          "meteor-shield-m1-private-runtime"
+        ],
+        deterministic: true,
+        random: false,
+        tokenConvertible: false
+      }
+    ]
+  },
+  facilitator: {
+    artifacts: [
+      {
+        id: "meteor-shield-m1-answer-key",
+        kind: "answer-key",
+        audience: "facilitator",
+        solutionBearing: true
+      },
+      {
+        id: "meteor-shield-m1-protected-tests",
+        kind: "protected-test",
+        audience: "facilitator",
+        solutionBearing: true
+      }
+    ],
+    protectedGoals: [
+      {
+        id: "meteor-shield-m1-protected-resilience",
+        statement: "The runtime clamps unsafe resources and terminates bounded projectile simulations.",
+        visibility: "protected",
+        criterionIds: [
+          "meteor-shield-edge-one",
+          "meteor-shield-edge-two"
+        ],
+        completionRequired: false,
+        aiRequired: false
+      }
+    ],
+    prompts: [
+      "Ask the learner which setting controls a limited resource before suggesting a code edit.",
+      "Use visible telemetry and the 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",
@@ -2137,8 +2585,10 @@ ${summary}`);
   JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
+  METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1,
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
+  RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
   ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
   SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1,