@plasius/learning 0.2.22 → 0.2.24

package/README.md

@@ -9,11 +9,11 @@ The package does **not** provide HTTP handlers, persistence, authentication, Tok
 The initial immutable catalog is exported as
 `JUNIOR_CODER_ROBOT_RESCUE_PATH_V1`, and its uniformly priced successor remains
 available as `JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1`. Path `1.2.0` upgrades Road
-Hopper Rally; path `1.3.0` is exported as
-`JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3` and selected by
-`JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT`. It also upgrades Paddle Pulse to
-module `2.0.0`; the other seventeen modules retain their prior immutable
-versions. Each path
+Hopper Rally, path `1.3.0` adds Paddle Pulse `2.0.0`, and path `1.4.0` is
+exported as `JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4` and selected by
+`JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT`. It advances Road Hopper Rally to the
+evidence-led module `2.1.0`; the other eighteen module records retain their
+prior immutable versions. Each path
 contains 19 independently sellable, self-contained project modules:
 
 - 8 original arcade game modules;
@@ -22,16 +22,18 @@ contains 19 independently sellable, self-contained project modules:
 - 3 web application modules.
 
 All catalogs remain in `pilot-grant-only` commercial state. The immutable
-`1.1.0` modules, Road Hopper Rally `2.0.0` and Paddle Pulse `2.0.0` each cost 50 Tokens (50,000 subunits), carrying a
+`1.1.0` modules, Road Hopper Rally `2.1.0` and Paddle Pulse `2.0.0` each cost 50 Tokens (50,000 subunits), carrying a
 non-redeemable £5 reference value. Price metadata is not authorization to
 enable public checkout.
 
-Road Hopper Rally `2.0.0` is a 450-minute, six-mission catalog record whose
-54-stage course, starter project, deterministic runtime, original assets and
-assessment definitions live in `@plasius/learning-road-hopper-rally@1.0.0`.
-The catalog pins the exact `ROAD_HOPPER_RALLY_COURSE_V2` export and its canonical
-SHA-256 digest through `ExternalLearningContentReferenceV1`; it does not import
-or bundle the executable content package.
+Road Hopper Rally `2.1.0` is a 450-minute, six-mission catalog record whose
+54 evidence-led activities, starter project, deterministic runtime, original
+assets and assessment definitions live in
+`@plasius/learning-road-hopper-rally@1.1.0`. The catalog pins the exact
+`ROAD_HOPPER_RALLY_COURSE_V3` export, schema `3` and its canonical SHA-256 digest
+through `ExternalLearningContentReferenceV1`; it does not import or bundle the
+executable content package. Road Hopper `2.0.0` and its package `1.0.0`
+reference remain available unchanged for rollback and existing consumers.
 
 Paddle Pulse `2.0.0` is a 360-minute, six-mission catalog record whose 54-stage
 course, declarative program contracts, deterministic 60 Hz engine and protected
@@ -62,11 +64,11 @@ fields before use:
 
 ```ts
 import {
-  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1,
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2,
   isExternalLearningContentReferenceV1,
 } from "@plasius/learning";
 
-if (!isExternalLearningContentReferenceV1(ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1)) {
+if (!isExternalLearningContentReferenceV1(ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2)) {
   throw new Error("Invalid external learning content reference");
 }
 ```
@@ -424,18 +426,27 @@ npm run build
 npm run pack:check
 ```
 
-Node.js 24 is required. Public pull-request code is validated on an isolated
-GitHub-hosted Linux runner with read-only workflow permissions. Main-branch CI
-and both release jobs explicitly select the approved
-`Public CI - Quarantined` self-hosted runner group. `CI_RUNNER_GROUP` /
-`CI_RUNNER_LABELS` and `CD_RUNNER_GROUP` / `CD_RUNNER_LABELS` are reserved for
-governed operator configuration. The organisation group remains restricted to
-allowlisted `main` workflows and selected repositories. Release coverage and
-the CycloneDX SBOM are retained even when an external coverage or provenance
-service is unavailable. Release tags and GitHub Releases use a current-repository
-GitHub App token with explicit Contents and Workflows write permissions; npm
-publication continues to use only the protected `NPM_TOKEN`. Both release jobs
-install a checksum-pinned GitHub CLI under `RUNNER_TEMP`, so runner images do
-not need a mutable system-wide `gh` installation. Publication checks out the
-verified current release-branch HEAD, including the workflow tooling used by a
-`bump=none` recovery.
+Node.js 24 is required. Public pull-request and main-branch code is validated
+on isolated GitHub-hosted Linux runners with read-only workflow permissions.
+Final npm
+publication runs only on a GitHub-hosted runner from the protected `production`
+environment so npm can validate its short-lived OIDC identity and record
+provenance; it has no long-lived npm write-token fallback. Release coverage and
+the CycloneDX SBOM are retained even when an external coverage service is
+unavailable. Release tags and GitHub Releases use a current-repository GitHub
+App token with explicit Contents and Workflows write permissions. Publication
+checks out the verified current release-branch HEAD, including the workflow
+tooling used by a `bump=none` recovery.
+<!-- BEGIN PLASIUS RELEASE INTEGRITY -->
+## Release integrity
+
+Production package publication runs only from `.github/workflows/cd.yml` on
+protected `main`. The job verifies that the prepared commit is still the
+current main commit and has an exact successful `ci.yml` push result before it
+mutates release state. Public package CI runs on GitHub-hosted capacity so it
+cannot execute on company-managed runners. npm publication runs on
+GitHub-hosted Node.js 24 with
+npm 11.5.1 or newer, uses the protected `production` environment and
+short-lived npm OIDC with provenance, and has no long-lived npm write-token
+fallback. Rollback disables CD; it never rewrites published package history.
+<!-- END PLASIUS RELEASE INTEGRITY -->

package/dist/index.cjs

@@ -33,11 +33,13 @@ __export(index_exports, {
   JUNIOR_CODER_MODULE_PRICE_V1_1: () => JUNIOR_CODER_MODULE_PRICE_V1_1,
   JUNIOR_CODER_PADDLE_PULSE_V2: () => JUNIOR_CODER_PADDLE_PULSE_V2,
   JUNIOR_CODER_ROAD_HOPPER_RALLY_V2: () => JUNIOR_CODER_ROAD_HOPPER_RALLY_V2,
+  JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1: () => JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1,
   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,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3,
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4,
   METEOR_SHIELD_MISSION_ONE_AUTHORING_V1: () => METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1: () => MISSION_AUTHORING_CONTRACT_VERSION_V1,
   OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1: () => OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1,
@@ -47,6 +49,7 @@ __export(index_exports, {
   RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1: () => RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1,
   RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1: () => RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
   ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1: () => ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1,
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2: () => ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2,
   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,
   ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1: () => ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1,
@@ -659,6 +662,13 @@ var ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1 = Object.freeze({
   schemaVersion: "2",
   sha256: "1a20741beba028004e0be527d05aae2b2881082d3b578e0d62308a59bf1323f0"
 });
+var ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2 = Object.freeze({
+  packageName: "@plasius/learning-road-hopper-rally",
+  packageVersion: "1.1.0",
+  exportName: "ROAD_HOPPER_RALLY_COURSE_V3",
+  schemaVersion: "3",
+  sha256: "f73b90f5f0e483b96724f978f2977435a5e6a1333f5f45fd0fc803b55ad21187"
+});
 var roadHopperV1_1 = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
   (entry) => entry.id === "junior-coder.road-hopper-rally"
 );
@@ -769,6 +779,29 @@ var JUNIOR_CODER_ROAD_HOPPER_RALLY_V2 = {
   ],
   externalContent: ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1
 };
+var ROAD_HOPPER_RALLY_V2_1_MISSION_TITLES = [
+  "Map the Rally Route",
+  "Move the Hopper",
+  "Build the Traffic Rally",
+  "Ride the Rescue River",
+  "Score the Rescue",
+  "Road Hopper Rally Challenge"
+];
+var JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1 = {
+  ...JUNIOR_CODER_ROAD_HOPPER_RALLY_V2,
+  version: "2.1.0",
+  contentRevision: "2026-08-24.1",
+  summary: "Build Road Hopper Rally through 54 evidence-led activities: predict, edit, run, inspect, repair, explain and prove each deterministic game system.",
+  missions: JUNIOR_CODER_ROAD_HOPPER_RALLY_V2.missions.map((mission2, index) => ({
+    ...mission2,
+    title: ROAD_HOPPER_RALLY_V2_1_MISSION_TITLES[index]
+  })),
+  assessment: {
+    ...JUNIOR_CODER_ROAD_HOPPER_RALLY_V2.assessment,
+    version: "2.1.0"
+  },
+  externalContent: ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2
+};
 var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2 = {
   ...JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
   version: "1.2.0",
@@ -892,7 +925,12 @@ var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3 = {
   version: "1.3.0",
   modules: JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2.modules.map((entry) => entry.id === JUNIOR_CODER_PADDLE_PULSE_V2.id ? JUNIOR_CODER_PADDLE_PULSE_V2 : entry)
 };
-var JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3;
+var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4 = {
+  ...JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3,
+  version: "1.4.0",
+  modules: JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3.modules.map((entry) => entry.id === JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1.id ? JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1 : entry)
+};
+var JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4;
 
 // src/contracts.ts
 var EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1 = "1";
@@ -7277,11 +7315,13 @@ ${summary}`);
   JUNIOR_CODER_MODULE_PRICE_V1_1,
   JUNIOR_CODER_PADDLE_PULSE_V2,
   JUNIOR_CODER_ROAD_HOPPER_RALLY_V2,
+  JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3,
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4,
   METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1,
   OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1,
@@ -7291,6 +7331,7 @@ ${summary}`);
   RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1,
   RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
   ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1,
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
   ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
   ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1,