@plasius/learning 0.2.6 → 0.2.8

package/README.md

@@ -65,10 +65,12 @@ import {
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
   METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
+  PIXEL_TRAIL_CHALLENGE_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,
+  STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1,
   assertValidMissionAuthoringBundle,
 } from "@plasius/learning";
 
@@ -90,6 +92,12 @@ const meteorShield = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
 const rescueCrewCommander = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
   (module) => module.slug === "rescue-crew-commander",
 );
+const pixelTrailChallenge = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (module) => module.slug === "pixel-trail-challenge",
+);
+const starDefenderSquadron = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (module) => module.slug === "star-defender-squadron",
+);
 
 if (
   !roadHopper ||
@@ -97,7 +105,9 @@ if (
   !skywing ||
   !paddlePulse ||
   !meteorShield ||
-  !rescueCrewCommander
+  !rescueCrewCommander ||
+  !pixelTrailChallenge ||
+  !starDefenderSquadron
 ) {
   throw new Error("Junior Coder module is missing");
 }
@@ -126,6 +136,14 @@ assertValidMissionAuthoringBundle(
   RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
   rescueCrewCommander,
 );
+assertValidMissionAuthoringBundle(
+  PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1,
+  pixelTrailChallenge,
+);
+assertValidMissionAuthoringBundle(
+  STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1,
+  starDefenderSquadron,
+);
 ```
 
 ## Contract rules

package/dist/index.cjs

@@ -28,10 +28,12 @@ __export(index_exports, {
   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,
+  PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1: () => PIXEL_TRAIL_CHALLENGE_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,
+  STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1: () => STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1,
   assertValidLearningPath: () => assertValidLearningPath,
   assertValidMissionAuthoringBundle: () => assertValidMissionAuthoringBundle,
   calculateAssessment: () => calculateAssessment,
@@ -1785,6 +1787,446 @@ var PADDLE_PULSE_MISSION_ONE_AUTHORING_V1 = {
     ]
   }
 };
+var PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1 = {
+  version: MISSION_AUTHORING_CONTRACT_VERSION_V1,
+  moduleId: "junior-coder.pixel-trail-challenge",
+  moduleVersion: "1.1.0",
+  missionId: "pixel-trail-challenge-mission-1",
+  learner: {
+    estimatedMinutes: 20,
+    stages: [
+      {
+        kind: "learn",
+        instruction: "Read what set_direction(), set_trail_limit() and place_energy_orb() do in the private Python preview.",
+        artifactIds: ["pixel-trail-challenge-m1-art"]
+      },
+      {
+        kind: "predict",
+        instruction: "Predict the next grid square and how the trail list will change after one move.",
+        artifactIds: []
+      },
+      {
+        kind: "build",
+        instruction: "Adjust the three documented Python calls so the pixel follows a safe trail toward the energy orb.",
+        artifactIds: ["pixel-trail-challenge-m1-code"]
+      },
+      {
+        kind: "run",
+        instruction: "Use the Run action button to start the private grid preview.",
+        artifactIds: ["pixel-trail-challenge-m1-code"]
+      },
+      {
+        kind: "assess",
+        instruction: "Run the visible and protected deterministic trail checks.",
+        artifactIds: []
+      },
+      {
+        kind: "inspect",
+        instruction: "Compare the highlighted Python line with the first goal that did not pass.",
+        artifactIds: []
+      },
+      {
+        kind: "fix",
+        instruction: "Change one direction, trail or orb setting, run again and inspect the position and list-length telemetry.",
+        artifactIds: ["pixel-trail-challenge-m1-code"]
+      },
+      {
+        kind: "explain",
+        instruction: "Explain how the direction changed the position and why the trail list kept only recent squares.",
+        artifactIds: []
+      },
+      {
+        kind: "reward",
+        instruction: "Collect the evidence-bound badge when the score and private-runtime safety check pass.",
+        artifactIds: []
+      }
+    ],
+    readinessChecks: [
+      {
+        id: "pixel-trail-challenge-m1-find-direction",
+        prompt: "Point to the Python call that chooses the pixel's next direction.",
+        scored: false
+      }
+    ],
+    artifacts: [
+      {
+        id: "pixel-trail-challenge-m1-code",
+        kind: "starter-code",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "pixel-trail-challenge-m1-art",
+        kind: "starter-assets",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "pixel-trail-challenge-m1-printable",
+        kind: "printable",
+        audience: "learner",
+        solutionBearing: false
+      }
+    ],
+    goals: [
+      {
+        id: "pixel-trail-challenge-m1-starts",
+        statement: "The Python settings are valid and the private grid preview starts.",
+        visibility: "visible",
+        criterionIds: ["pixel-trail-challenge-build"],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "pixel-trail-challenge-m1-safe-trail",
+        statement: "The pixel moves in the chosen direction, keeps a bounded trail list and reaches the energy orb.",
+        visibility: "visible",
+        criterionIds: [
+          "pixel-trail-challenge-goal-one",
+          "pixel-trail-challenge-goal-two"
+        ],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "pixel-trail-challenge-m1-private-runtime",
+        statement: "The program stays inside the private Python worker and host-provided grid API.",
+        visibility: "visible",
+        criterionIds: ["pixel-trail-challenge-safety"],
+        completionRequired: true,
+        aiRequired: false
+      }
+    ],
+    interactions: [
+      {
+        id: "pixel-trail-challenge-m1-run-control",
+        description: "Start the private Python grid simulation.",
+        primaryMode: "pointer",
+        alternativeIds: ["pixel-trail-challenge-m1-keyboard-run"]
+      },
+      {
+        id: "pixel-trail-challenge-m1-direction-control",
+        description: "Change the active movement direction with labelled arrow controls or arrow keys.",
+        primaryMode: "keyboard",
+        alternativeIds: []
+      },
+      {
+        id: "pixel-trail-challenge-m1-trail-motion",
+        description: "Observe the pixel, recent trail squares and energy orb on the grid.",
+        primaryMode: "motion",
+        alternativeIds: ["pixel-trail-challenge-m1-telemetry"]
+      }
+    ],
+    accessibilityAlternatives: [
+      {
+        id: "pixel-trail-challenge-m1-keyboard-run",
+        modes: ["keyboard"],
+        equivalentOutcome: true,
+        description: "Press Enter or Space on the play-icon Run button to start the same preview."
+      },
+      {
+        id: "pixel-trail-challenge-m1-telemetry",
+        modes: ["text", "shape", "reduced-motion"],
+        equivalentOutcome: true,
+        description: "Read row, column, direction, trail length and orb status without animation or colour dependence."
+      }
+    ],
+    evidenceRequirements: [
+      {
+        id: "pixel-trail-challenge-m1-assessment",
+        goalIds: [
+          "pixel-trail-challenge-m1-starts",
+          "pixel-trail-challenge-m1-safe-trail",
+          "pixel-trail-challenge-m1-private-runtime"
+        ],
+        kind: "assessment-result",
+        retention: "entitlement",
+        containsPersonalData: false
+      },
+      {
+        id: "pixel-trail-challenge-m1-explanation",
+        goalIds: ["pixel-trail-challenge-m1-safe-trail"],
+        kind: "learner-explanation",
+        retention: "attempt",
+        containsPersonalData: false
+      }
+    ],
+    sideAdventures: [
+      {
+        id: "pixel-trail-challenge-m1-remix",
+        prompt: "Invent an original energy-orb symbol and describe a new safe grid rule for collecting it.",
+        completionRequired: false
+      }
+    ],
+    rewardBindings: [
+      {
+        id: "pixel-trail-challenge-m1-badge",
+        badgeId: "pixel-trail-challenge-mission-complete",
+        goalIds: [
+          "pixel-trail-challenge-m1-starts",
+          "pixel-trail-challenge-m1-safe-trail",
+          "pixel-trail-challenge-m1-private-runtime"
+        ],
+        deterministic: true,
+        random: false,
+        tokenConvertible: false
+      }
+    ]
+  },
+  facilitator: {
+    artifacts: [
+      {
+        id: "pixel-trail-challenge-m1-answer-key",
+        kind: "answer-key",
+        audience: "facilitator",
+        solutionBearing: true
+      },
+      {
+        id: "pixel-trail-challenge-m1-protected-tests",
+        kind: "protected-test",
+        audience: "facilitator",
+        solutionBearing: true
+      }
+    ],
+    protectedGoals: [
+      {
+        id: "pixel-trail-challenge-m1-protected-resilience",
+        statement: "The worker rejects invalid directions, clamps trail capacity and terminates bounded grid simulations before list or collision abuse.",
+        visibility: "protected",
+        criterionIds: [
+          "pixel-trail-challenge-edge-one",
+          "pixel-trail-challenge-edge-two"
+        ],
+        completionRequired: false,
+        aiRequired: false
+      }
+    ],
+    prompts: [
+      "Ask the learner to predict the next row and column before suggesting a Python edit.",
+      "Use the function reference and visible telemetry; never reveal protected coordinates, numeric targets or expected source fragments."
+    ]
+  }
+};
+var STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1 = {
+  version: MISSION_AUTHORING_CONTRACT_VERSION_V1,
+  moduleId: "junior-coder.star-defender-squadron",
+  moduleVersion: "1.1.0",
+  missionId: "star-defender-squadron-mission-1",
+  learner: {
+    estimatedMinutes: 20,
+    stages: [
+      {
+        kind: "learn",
+        instruction: "Read what createSquadron(), setRescueWave(), setShieldHealth() and launchRescueBeam() do in the private JavaScript preview.",
+        artifactIds: ["star-defender-squadron-m1-art"]
+      },
+      {
+        kind: "predict",
+        instruction: "Predict where the squadron and rescue beam will travel, and which health value will change after the wave.",
+        artifactIds: []
+      },
+      {
+        kind: "build",
+        instruction: "Adjust the four documented JavaScript calls so the original squadron launches a safe rescue wave.",
+        artifactIds: ["star-defender-squadron-m1-code"]
+      },
+      {
+        kind: "run",
+        instruction: "Use the Run action button to start the private Star Defender preview.",
+        artifactIds: ["star-defender-squadron-m1-code"]
+      },
+      {
+        kind: "assess",
+        instruction: "Run the visible and protected deterministic squadron checks.",
+        artifactIds: []
+      },
+      {
+        kind: "inspect",
+        instruction: "Compare the highlighted JavaScript line with the first mission goal that did not pass.",
+        artifactIds: []
+      },
+      {
+        kind: "fix",
+        instruction: "Change one squadron, wave, shield or beam setting, then rerun and inspect the entity and health telemetry.",
+        artifactIds: ["star-defender-squadron-m1-code"]
+      },
+      {
+        kind: "explain",
+        instruction: "Explain how the wave pattern moved the entities and how shields protected the rescue mission.",
+        artifactIds: []
+      },
+      {
+        kind: "reward",
+        instruction: "Collect the evidence-bound badge when the score and private-runtime safety check pass.",
+        artifactIds: []
+      }
+    ],
+    readinessChecks: [
+      {
+        id: "star-defender-squadron-m1-find-wave",
+        prompt: "Point to the JavaScript call that chooses the rescue-wave pattern.",
+        scored: false
+      }
+    ],
+    artifacts: [
+      {
+        id: "star-defender-squadron-m1-code",
+        kind: "starter-code",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "star-defender-squadron-m1-art",
+        kind: "starter-assets",
+        audience: "learner",
+        solutionBearing: false
+      },
+      {
+        id: "star-defender-squadron-m1-printable",
+        kind: "printable",
+        audience: "learner",
+        solutionBearing: false
+      }
+    ],
+    goals: [
+      {
+        id: "star-defender-squadron-m1-starts",
+        statement: "The JavaScript settings are valid and the private squadron preview starts.",
+        visibility: "visible",
+        criterionIds: ["star-defender-squadron-build"],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "star-defender-squadron-m1-rescue-wave",
+        statement: "The original squadron follows the chosen pattern, keeps safe shield health and launches a rescue beam.",
+        visibility: "visible",
+        criterionIds: [
+          "star-defender-squadron-goal-one",
+          "star-defender-squadron-goal-two"
+        ],
+        completionRequired: true,
+        aiRequired: false
+      },
+      {
+        id: "star-defender-squadron-m1-private-runtime",
+        statement: "The program stays inside the private JavaScript worker and host-provided space-rescue API.",
+        visibility: "visible",
+        criterionIds: ["star-defender-squadron-safety"],
+        completionRequired: true,
+        aiRequired: false
+      }
+    ],
+    interactions: [
+      {
+        id: "star-defender-squadron-m1-run-control",
+        description: "Start the private JavaScript squadron simulation.",
+        primaryMode: "pointer",
+        alternativeIds: ["star-defender-squadron-m1-keyboard-run"]
+      },
+      {
+        id: "star-defender-squadron-m1-code-control",
+        description: "Edit the documented squadron, wave, shield and beam calls.",
+        primaryMode: "keyboard",
+        alternativeIds: []
+      },
+      {
+        id: "star-defender-squadron-m1-wave-motion",
+        description: "Observe squadron entities, wave paths, shields and the rescue beam.",
+        primaryMode: "motion",
+        alternativeIds: ["star-defender-squadron-m1-telemetry"]
+      }
+    ],
+    accessibilityAlternatives: [
+      {
+        id: "star-defender-squadron-m1-keyboard-run",
+        modes: ["keyboard"],
+        equivalentOutcome: true,
+        description: "Press Enter or Space on the play-icon Run button to start the same preview."
+      },
+      {
+        id: "star-defender-squadron-m1-telemetry",
+        modes: ["text", "shape", "reduced-motion"],
+        equivalentOutcome: true,
+        description: "Read entity count, pattern, shield health, beam state and rescue result without animation or colour dependence."
+      }
+    ],
+    evidenceRequirements: [
+      {
+        id: "star-defender-squadron-m1-assessment",
+        goalIds: [
+          "star-defender-squadron-m1-starts",
+          "star-defender-squadron-m1-rescue-wave",
+          "star-defender-squadron-m1-private-runtime"
+        ],
+        kind: "assessment-result",
+        retention: "entitlement",
+        containsPersonalData: false
+      },
+      {
+        id: "star-defender-squadron-m1-explanation",
+        goalIds: ["star-defender-squadron-m1-rescue-wave"],
+        kind: "learner-explanation",
+        retention: "attempt",
+        containsPersonalData: false
+      }
+    ],
+    sideAdventures: [
+      {
+        id: "star-defender-squadron-m1-remix",
+        prompt: "Invent an original rescue-squadron emblem and describe a new safe wave pattern for a later level.",
+        completionRequired: false
+      }
+    ],
+    rewardBindings: [
+      {
+        id: "star-defender-squadron-m1-badge",
+        badgeId: "star-defender-squadron-mission-complete",
+        goalIds: [
+          "star-defender-squadron-m1-starts",
+          "star-defender-squadron-m1-rescue-wave",
+          "star-defender-squadron-m1-private-runtime"
+        ],
+        deterministic: true,
+        random: false,
+        tokenConvertible: false
+      }
+    ]
+  },
+  facilitator: {
+    artifacts: [
+      {
+        id: "star-defender-squadron-m1-answer-key",
+        kind: "answer-key",
+        audience: "facilitator",
+        solutionBearing: true
+      },
+      {
+        id: "star-defender-squadron-m1-protected-tests",
+        kind: "protected-test",
+        audience: "facilitator",
+        solutionBearing: true
+      }
+    ],
+    protectedGoals: [
+      {
+        id: "star-defender-squadron-m1-protected-resilience",
+        statement: "The worker rejects invalid entity, pattern, health and projectile settings and terminates bounded wave simulations.",
+        visibility: "protected",
+        criterionIds: [
+          "star-defender-squadron-edge-one",
+          "star-defender-squadron-edge-two"
+        ],
+        completionRequired: false,
+        aiRequired: false
+      }
+    ],
+    prompts: [
+      "Ask the learner to predict the squadron path and shield change before suggesting a JavaScript edit.",
+      "Use the function reference and visible telemetry; never reveal protected numeric targets, pattern answers or expected source fragments."
+    ]
+  }
+};
 var RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1 = {
   version: MISSION_AUTHORING_CONTRACT_VERSION_V1,
   moduleId: "junior-coder.rescue-crew-commander",
@@ -2588,10 +3030,12 @@ ${summary}`);
   METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1,
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
+  PIXEL_TRAIL_CHALLENGE_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,
+  STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1,
   assertValidLearningPath,
   assertValidMissionAuthoringBundle,
   calculateAssessment,