@plasius/learning 0.2.20 → 0.2.22

package/README.md

@@ -7,22 +7,39 @@ The package does **not** provide HTTP handlers, persistence, authentication, Tok
 ## Junior Coder catalog
 
 The initial immutable catalog is exported as
-`JUNIOR_CODER_ROBOT_RESCUE_PATH_V1`. The current uniformly priced pilot
-catalog is exported as `JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1`, with
-`JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT` available to adapters that
-intentionally follow published successors. Each contains 19 independently
-sellable, self-contained project modules:
+`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
+contains 19 independently sellable, self-contained project modules:
 
 - 8 original arcade game modules;
 - 5 simulator-backed robotics modules;
 - 3 constrained Vibe Coding modules;
 - 3 web application modules.
 
-Both catalogs remain in `pilot-grant-only` commercial state. The immutable
-`1.1.0` modules each cost 50 Tokens (50,000 subunits), carrying a
+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
 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.
+
+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
+assessment live in `@plasius/learning-paddle-pulse@0.1.0`. The catalog pins the
+exact `PADDLE_PULSE_MODULE_V2` export, schema `2` and canonical SHA-256 digest
+without importing the package. Paddle Pulse `1.1.0` and its mission-authoring
+export remain available unchanged.
+
 ## Install
 
 ```bash
@@ -40,6 +57,20 @@ import {
 assertValidLearningPath(JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT);
 ```
 
+Consumers resolving external course content must verify all five reference
+fields before use:
+
+```ts
+import {
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1,
+  isExternalLearningContentReferenceV1,
+} from "@plasius/learning";
+
+if (!isExternalLearningContentReferenceV1(ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1)) {
+  throw new Error("Invalid external learning content reference");
+}
+```
+
 ## Calculate an assessment
 
 ```ts
@@ -54,6 +85,37 @@ const result = calculateAssessment(rubric, [
 console.log(result.score, result.completed);
 ```
 
+## Bind contextual and spoken help
+
+Contextual-help identifiers are immutable module/manifest references rather
+than free-form learner text. Voice consent is separate from general AI consent,
+and version one permits private-edge transcription only.
+
+```ts
+import {
+  CONTEXTUAL_HELP_CONTRACT_VERSION_V1,
+  assertValidContextualHelpIdentifier,
+  type ContextualHelpIdentifierV1,
+} from "@plasius/learning";
+
+const help: ContextualHelpIdentifierV1 = {
+  schemaVersion: "1",
+  contractVersion: CONTEXTUAL_HELP_CONTRACT_VERSION_V1,
+  kind: "command",
+  moduleId: "junior-coder.road-hopper-rally",
+  moduleVersion: "1.1.0",
+  manifestVersion: "1.0.0",
+  helpId: "command.draw-lane",
+};
+
+assertValidContextualHelpIdentifier(help);
+```
+
+The package also exports `GuardianVoiceConsentV1`,
+`VoiceHelpAvailabilityV1`, bounded voice question metadata/results and
+`CanonicalSpokenHelpDescriptorV1`. It does not record audio, persist consent,
+call a transcription or synthesis provider, or evaluate runtime rollout flags.
+
 ## Validate a Guardian-approved static project
 
 The publishing contracts cover only immutable evidence and safe render models.
@@ -272,6 +334,8 @@ assertValidMissionAuthoringBundle(
 ## Contract rules
 
 - Published IDs and versions are immutable.
+- External course content uses exact package and export names, a stable semantic
+  version and a lower-case canonical SHA-256 digest; version ranges are invalid.
 - Reference prices are product-copy metadata and never create cash redemption
   rights.
 - A module entitlement must bind to an exact module version.

package/dist/index.cjs

@@ -22,20 +22,31 @@ var index_exports = {};
 __export(index_exports, {
   ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1: () => ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1,
   BEACON_BOT_MISSION_ONE_AUTHORING_V1: () => BEACON_BOT_MISSION_ONE_AUTHORING_V1,
+  CONTEXTUAL_HELP_CONTRACT_VERSION_V1: () => CONTEXTUAL_HELP_CONTRACT_VERSION_V1,
+  CONTEXTUAL_HELP_KINDS_V1: () => CONTEXTUAL_HELP_KINDS_V1,
+  CONTEXTUAL_VOICE_INTENTS_V1: () => CONTEXTUAL_VOICE_INTENTS_V1,
+  CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1: () => CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1,
   CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1: () => CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1,
   DANCE_ROVER_MISSION_ONE_AUTHORING_V1: () => DANCE_ROVER_MISSION_ONE_AUTHORING_V1,
+  EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1: () => EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1,
   JUNIOR_CODER_MISSION_STAGE_ORDER_V1: () => JUNIOR_CODER_MISSION_STAGE_ORDER_V1,
   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_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,
   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,
+  PADDLE_PULSE_EXTERNAL_CONTENT_V1: () => PADDLE_PULSE_EXTERNAL_CONTENT_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,
   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_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,
@@ -51,12 +62,19 @@ __export(index_exports, {
   VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1: () => VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1,
   VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1: () => VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1,
   VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1: () => VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1,
+  assertValidCanonicalSpokenHelpDescriptor: () => assertValidCanonicalSpokenHelpDescriptor,
+  assertValidContextualHelpIdentifier: () => assertValidContextualHelpIdentifier,
+  assertValidContextualVoiceQuestionMetadata: () => assertValidContextualVoiceQuestionMetadata,
+  assertValidContextualVoiceQuestionResult: () => assertValidContextualVoiceQuestionResult,
+  assertValidGuardianVoiceConsent: () => assertValidGuardianVoiceConsent,
   assertValidLearningPath: () => assertValidLearningPath,
   assertValidMissionAuthoringBundle: () => assertValidMissionAuthoringBundle,
   assertValidStaticProjectGuardianApproval: () => assertValidStaticProjectGuardianApproval,
   assertValidStaticProjectPublication: () => assertValidStaticProjectPublication,
   assertValidStaticProjectSnapshot: () => assertValidStaticProjectSnapshot,
+  assertValidVoiceHelpAvailability: () => assertValidVoiceHelpAvailability,
   calculateAssessment: () => calculateAssessment,
+  isExternalLearningContentReferenceV1: () => isExternalLearningContentReferenceV1,
   validateAssessmentRubric: () => validateAssessmentRubric,
   validateLearningPath: () => validateLearningPath,
   validateMissionAuthoringBundle: () => validateMissionAuthoringBundle,
@@ -634,11 +652,410 @@ var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1 = {
     }
   }))
 };
-var JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1;
+var ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1 = Object.freeze({
+  packageName: "@plasius/learning-road-hopper-rally",
+  packageVersion: "1.0.0",
+  exportName: "ROAD_HOPPER_RALLY_COURSE_V2",
+  schemaVersion: "2",
+  sha256: "1a20741beba028004e0be527d05aae2b2881082d3b578e0d62308a59bf1323f0"
+});
+var roadHopperV1_1 = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (entry) => entry.id === "junior-coder.road-hopper-rally"
+);
+var ROAD_HOPPER_RALLY_V2_MISSIONS = [
+  {
+    id: "board",
+    title: "Build the Rally Board",
+    concepts: ["coordinate grids", "arrays", "entity state", "rendering"],
+    statement: "Create the road, median, river and five distinct home bays in board.js.",
+    sideAdventure: "Design an original high-contrast board palette without changing its mechanics."
+  },
+  {
+    id: "hopper",
+    title: "Move the Hopper",
+    concepts: ["events", "bounded movement", "keyboard input", "touch input", "respawning"],
+    statement: "Implement four-direction tile movement, bounds, equivalent inputs and respawning in hopper.js.",
+    sideAdventure: "Add an accessible movement status phrase for every successful hop."
+  },
+  {
+    id: "traffic",
+    title: "Create Rally Traffic",
+    concepts: ["spawning", "fixed-step updates", "wrapping", "collision detection", "difficulty"],
+    statement: "Implement five deterministic traffic lanes, collisions, lives and difficulty in traffic.js.",
+    sideAdventure: "Invent an original vehicle type while preserving the entity and collision limits."
+  },
+  {
+    id: "river",
+    title: "Cross the Moving River",
+    concepts: ["moving platforms", "carrying", "hazards", "state machines", "off-screen bounds"],
+    statement: "Implement logs, carrying, water deaths, diving platforms and edge hazards in river.js.",
+    sideAdventure: "Create an original visual warning for a platform that is about to dive."
+  },
+  {
+    id: "rules",
+    title: "Add Rally Rules",
+    concepts: ["timers", "lives", "scoring", "bonuses", "levels", "game over"],
+    statement: "Implement homes, occupied and blocked bays, timer, scoring, bonuses and level progression in rules.js.",
+    sideAdventure: "Tune a practice-speed preset that keeps every rule deterministic."
+  },
+  {
+    id: "game",
+    title: "Complete Road Hopper Rally",
+    concepts: ["system assembly", "pause and restart", "alternating players", "audio", "accessibility", "testing"],
+    statement: "Assemble the systems, accessibility modes and alternating-player finale in game.js, then pass the protected challenge.",
+    sideAdventure: "Polish the finished game with original captions, visual cues and reduced-motion feedback."
+  }
+];
+var JUNIOR_CODER_ROAD_HOPPER_RALLY_V2 = {
+  ...roadHopperV1_1,
+  version: "2.0.0",
+  contentRevision: "2026-08-11.1",
+  summary: "Recreate the systems behind a classic road-and-river crossing game using original Road Hopper Rally code, art, audio and presentation.",
+  estimatedMinutes: 450,
+  tools: [
+    "JavaScript",
+    "QuickJS sandbox",
+    "Deterministic 30 Hz engine",
+    "Road Hopper renderer"
+  ],
+  concepts: [
+    "coordinates",
+    "arrays and entity state",
+    "events and input",
+    "fixed-step update and render",
+    "spawning and movement",
+    "collision detection",
+    "state machines",
+    "timers, lives and scoring",
+    "difficulty progression",
+    "audio integration",
+    "debugging",
+    "deterministic testing"
+  ],
+  missions: ROAD_HOPPER_RALLY_V2_MISSIONS.map((missionDefinition, index) => ({
+    id: `road-hopper-rally-mission-${index + 1}-${missionDefinition.id}`,
+    title: missionDefinition.title,
+    estimatedMinutes: 75,
+    concepts: [...missionDefinition.concepts],
+    goals: [
+      {
+        id: `road-hopper-rally-v2-${missionDefinition.id}`,
+        statement: missionDefinition.statement,
+        evidence: "assessment"
+      }
+    ],
+    sideAdventure: missionDefinition.sideAdventure
+  })),
+  assessment: {
+    version: "2.0.0",
+    completionScore: 80,
+    criteria: [
+      { id: "road-hopper-v2-structure", label: "All six bounded JavaScript files compile and assemble.", dimension: "structure", points: 20, mandatory: true, visibility: "visible" },
+      { id: "road-hopper-v2-road", label: "Board, input and traffic behaviours pass deterministic scenarios.", dimension: "behaviour", points: 15, mandatory: true, visibility: "visible" },
+      { id: "road-hopper-v2-river", label: "River platforms, carrying and hazards pass deterministic scenarios.", dimension: "behaviour", points: 15, mandatory: true, visibility: "visible" },
+      { id: "road-hopper-v2-rules", label: "Homes, timer, lives, scoring, bonuses and levels behave correctly.", dimension: "behaviour", points: 20, mandatory: true, visibility: "visible" },
+      { id: "road-hopper-v2-final", label: "The complete game passes the server-only protected final challenge.", dimension: "resilience", points: 20, mandatory: true, visibility: "protected" },
+      { id: "road-hopper-v2-safety", label: "The project stays within the sandbox, resource and privacy boundaries.", dimension: "safety", points: 10, mandatory: true, visibility: "visible" }
+    ]
+  },
+  badges: [
+    {
+      id: "road-hopper-rally-v2-complete",
+      title: "Road Hopper Rally Champion",
+      evidence: "module-score",
+      tradeable: false,
+      tokenConvertible: false
+    }
+  ],
+  externalContent: ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1
+};
+var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2 = {
+  ...JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
+  version: "1.2.0",
+  modules: JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.map((entry) => entry.id === JUNIOR_CODER_ROAD_HOPPER_RALLY_V2.id ? JUNIOR_CODER_ROAD_HOPPER_RALLY_V2 : entry)
+};
+var PADDLE_PULSE_EXTERNAL_CONTENT_V1 = Object.freeze({
+  packageName: "@plasius/learning-paddle-pulse",
+  packageVersion: "0.1.0",
+  exportName: "PADDLE_PULSE_MODULE_V2",
+  schemaVersion: "2",
+  sha256: "19f3666bdb523a3faf069341b0bc748996b3db282f89171e3c9f0a373a8c8f7e"
+});
+var paddlePulseV1_1 = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (entry) => entry.id === "junior-coder.paddle-pulse"
+);
+var PADDLE_PULSE_V2_MISSIONS = [
+  {
+    id: "court-coordinates",
+    title: "Court & Coordinates",
+    concepts: ["coordinates", "canvas primitives", "game loops", "bounds"],
+    statement: "Build a responsive 640 \xD7 480 logical court with a bounded paddle and ball.",
+    sideAdventure: "Create an original high-contrast court palette without changing its geometry."
+  },
+  {
+    id: "paddle-controls",
+    title: "Paddle Controls",
+    concepts: ["input state", "Pointer Events", "keyboard input", "clamping"],
+    statement: "Implement equivalent Arrow/A/D and direct horizontal pointer-drag controls.",
+    sideAdventure: "Add a semantic movement trace that does not rely on animation."
+  },
+  {
+    id: "ball-motion",
+    title: "Ball Motion & Bounces",
+    concepts: ["velocity", "fixed timesteps", "reflection", "contact normals", "paddle angles"],
+    statement: "Implement deterministic ball motion plus controlled wall and paddle reflections.",
+    sideAdventure: "Design a reduced-motion trajectory inspector for one rally."
+  },
+  {
+    id: "bricks-collisions",
+    title: "Bricks & Collisions",
+    concepts: ["arrays", "loops", "brick grids", "AABB collision", "resolution"],
+    statement: "Create an original brick grid whose bricks score once and disappear on impact.",
+    sideAdventure: "Invent a new visual brick pattern using the same bounded collision rules."
+  },
+  {
+    id: "score-lives-states",
+    title: "Score, Lives & States",
+    concepts: ["state machines", "invariants", "scoring", "lives", "HUD state"],
+    statement: "Implement serve, pause, life loss, level clear, game over, score and HUD states.",
+    sideAdventure: "Add a printable state-transition table for a facilitator or screen-reader user."
+  },
+  {
+    id: "levels-final-game",
+    title: "Levels, Sound & Final Game",
+    concepts: ["level data", "difficulty", "responsive rendering", "accessible audio", "testing"],
+    statement: "Assemble multiple original levels, optional generated cues and the integrated final game.",
+    sideAdventure: "After completion, add an optional original power-up without changing core assessment."
+  }
+];
+var JUNIOR_CODER_PADDLE_PULSE_V2 = {
+  ...paddlePulseV1_1,
+  version: "2.0.0",
+  contentRevision: "2026-08-11.1",
+  summary: "Build an original Plasius brick-breaker while learning rendering, equivalent input, deterministic physics, collisions, score, lives, states, levels, accessible sound and testing.",
+  estimatedMinutes: 360,
+  tools: [
+    "JavaScript",
+    "QuickJS sandbox",
+    "Deterministic 60 Hz engine",
+    "Responsive Paddle Pulse renderer"
+  ],
+  concepts: [
+    "coordinates and rendering",
+    "game loops and fixed timesteps",
+    "keyboard and pointer input",
+    "velocity and reflection",
+    "collision detection and resolution",
+    "arrays and brick grids",
+    "scoring, lives and state machines",
+    "level data and difficulty",
+    "accessible generated audio",
+    "debugging and deterministic testing"
+  ],
+  missions: PADDLE_PULSE_V2_MISSIONS.map((missionDefinition, index) => ({
+    id: `paddle-pulse-mission-${index + 1}-${missionDefinition.id}`,
+    title: missionDefinition.title,
+    estimatedMinutes: 60,
+    concepts: [...missionDefinition.concepts],
+    goals: [{
+      id: `paddle-pulse-v2-${missionDefinition.id}`,
+      statement: missionDefinition.statement,
+      evidence: "assessment"
+    }],
+    sideAdventure: missionDefinition.sideAdventure
+  })),
+  assessment: {
+    version: "2.0.0",
+    completionScore: 80,
+    criteria: [
+      { id: "paddle-pulse-v2-court", label: "The logical court, paddle and initial scene are finite, responsive and bounded.", dimension: "structure", points: 20, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-controls", label: "Keyboard and pointer paths produce equivalent clamped paddle input.", dimension: "behaviour", points: 15, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-motion", label: "Ball motion and wall/paddle reflections pass deterministic trajectories.", dimension: "behaviour", points: 15, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-bricks", label: "Brick face, corner and adjacent impacts resolve without double-scoring.", dimension: "behaviour", points: 20, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-states", label: "Score, lives, serve, pause, level-clear and game-over transitions preserve invariants.", dimension: "resilience", points: 10, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-final", label: "Multiple original levels and the integrated game pass protected deterministic scenarios.", dimension: "resilience", points: 10, mandatory: false, visibility: "protected" },
+      { id: "paddle-pulse-v2-safety", label: "Source, commands, runtime resources and assessment remain inside sandbox limits.", dimension: "safety", points: 10, mandatory: true, visibility: "visible" }
+    ]
+  },
+  badges: [
+    { id: "paddle-pulse-v2-court-builder", title: "Court Builder", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-paddle-pilot", title: "Paddle Pilot", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-rally-master", title: "Rally Master", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-brick-breaker", title: "Brick Breaker", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-game-keeper", title: "Game Keeper", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-complete", title: "Paddle Pulse Champion", evidence: "module-score", tradeable: false, tokenConvertible: false }
+  ],
+  externalContent: PADDLE_PULSE_EXTERNAL_CONTENT_V1
+};
+var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3 = {
+  ...JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2,
+  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;
 
 // src/contracts.ts
+var EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1 = "1";
 var MISSION_AUTHORING_CONTRACT_VERSION_V1 = "1.0.0";
 
+// src/contextual-help.ts
+var CONTEXTUAL_HELP_CONTRACT_VERSION_V1 = "1.0.0";
+var CONTEXTUAL_HELP_KINDS_V1 = Object.freeze([
+  "command",
+  "visual-block",
+  "generated-code",
+  "assessment-diagnostic"
+]);
+var CONTEXTUAL_VOICE_INTENTS_V1 = Object.freeze([
+  "describe-command",
+  "describe-inputs",
+  "show-example",
+  "explain-assessment-failure",
+  "suggest-next-experiment",
+  "repeat",
+  "stop",
+  "unresolved"
+]);
+var CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1 = Object.freeze([
+  "open-help",
+  "insert-example",
+  "show-inputs",
+  "show-assessment-evidence",
+  "try-next-experiment",
+  "repeat",
+  "stop",
+  "type-question"
+]);
+var OPAQUE_ID = /^[a-z0-9]+(?:[._:-][a-z0-9]+)*$/u;
+var SEMVER = /^[0-9]+\.[0-9]+\.[0-9]+(?:[-+][A-Za-z0-9.-]+)?$/u;
+var SHA_256 = /^sha256:[a-f0-9]{64}$/u;
+var LOCALE = /^[a-z]{2,3}(?:-[A-Z]{2})?$/u;
+var MEDIA_TYPE = /^audio\/[a-z0-9.+-]+$/u;
+function containsDisallowedControlCharacter(value) {
+  return [...value].some((character) => {
+    const code = character.codePointAt(0) ?? 0;
+    return code <= 8 || code === 11 || code === 12 || code >= 14 && code <= 31 || code === 127;
+  });
+}
+function requireOpaqueId(value, label, maximum = 160) {
+  if (value.length === 0 || value.length > maximum || !OPAQUE_ID.test(value)) {
+    throw new Error(`${label} must be a bounded opaque identifier.`);
+  }
+}
+function requireSemver(value, label) {
+  if (!SEMVER.test(value)) {
+    throw new Error(`${label} must be an immutable semantic version.`);
+  }
+}
+function requireIsoTimestamp(value, label) {
+  if (!/^\d{4}-\d{2}-\d{2}T/u.test(value) || !Number.isFinite(Date.parse(value))) {
+    throw new Error(`${label} must be an ISO-8601 timestamp.`);
+  }
+}
+function assertValidContextualHelpIdentifier(value) {
+  if (value.schemaVersion !== "1") {
+    throw new Error("schemaVersion must be 1.");
+  }
+  if (value.contractVersion !== CONTEXTUAL_HELP_CONTRACT_VERSION_V1) {
+    throw new Error("contractVersion is unsupported.");
+  }
+  if (!CONTEXTUAL_HELP_KINDS_V1.includes(value.kind)) {
+    throw new Error("kind is unsupported.");
+  }
+  requireOpaqueId(value.moduleId, "moduleId");
+  requireSemver(value.moduleVersion, "moduleVersion");
+  requireSemver(value.manifestVersion, "manifestVersion");
+  requireOpaqueId(value.helpId, "helpId");
+}
+function assertValidGuardianVoiceConsent(value) {
+  if (value.schemaVersion !== "1") {
+    throw new Error("schemaVersion must be 1.");
+  }
+  requireOpaqueId(value.actorAccountId, "actorAccountId");
+  requireOpaqueId(value.subjectAccountId, "subjectAccountId");
+  requireSemver(value.policyVersion, "policyVersion");
+  if (value.state !== "granted" && value.state !== "withdrawn") {
+    throw new Error("state must be granted or withdrawn.");
+  }
+  if (value.permittedProcessingRoute !== "private-edge-only") {
+    throw new Error("permittedProcessingRoute must be private-edge-only.");
+  }
+  requireIsoTimestamp(value.recordedAt, "recordedAt");
+}
+function assertValidContextualVoiceQuestionMetadata(value) {
+  assertValidContextualHelpIdentifier(value.help);
+  if (!LOCALE.test(value.locale)) throw new Error("locale is invalid.");
+  if (!MEDIA_TYPE.test(value.mediaType)) throw new Error("mediaType is invalid.");
+  if (!Number.isInteger(value.durationMs) || value.durationMs < 1 || value.durationMs > 1e4) {
+    throw new Error("durationMs must be between 1 and 10000.");
+  }
+  if (!Number.isInteger(value.audioBytes) || value.audioBytes < 1 || value.audioBytes > 2097152) {
+    throw new Error("audioBytes must be between 1 and 2097152.");
+  }
+  if (value.assessmentEvidenceId !== void 0) {
+    requireOpaqueId(value.assessmentEvidenceId, "assessmentEvidenceId");
+  }
+}
+function assertValidVoiceHelpAvailability(value) {
+  if (value.schemaVersion !== "1") throw new Error("schemaVersion must be 1.");
+  if (value.questionProcessingRoute !== "private-edge-only") {
+    throw new Error("questionProcessingRoute must be private-edge-only.");
+  }
+  if (value.guardianVoiceConsentRequired !== true) {
+    throw new Error("guardianVoiceConsentRequired must remain true.");
+  }
+  if (value.maximumRecordingDurationMs !== 1e4 || value.maximumAudioBytes !== 2097152 || value.rawAudioRetention !== "request-memory-only" || value.transcriptRetention !== "request-memory-only") {
+    throw new Error("Voice limits and transient retention are immutable in version one.");
+  }
+  if (value.microphoneAvailable !== (value.microphoneReason === "available")) {
+    throw new Error("microphoneReason must match microphone availability.");
+  }
+}
+function assertValidCanonicalSpokenHelpDescriptor(value) {
+  if (value.schemaVersion !== "1") throw new Error("schemaVersion must be 1.");
+  assertValidContextualHelpIdentifier(value.help);
+  requireOpaqueId(value.canonicalTextId, "canonicalTextId");
+  if (!SHA_256.test(value.authoritativeTextDigest)) {
+    throw new Error("authoritativeTextDigest must be a SHA-256 digest.");
+  }
+  if (!LOCALE.test(value.locale)) throw new Error("locale is invalid.");
+  requireOpaqueId(value.voiceProfile, "voiceProfile");
+  requireSemver(value.pronunciationVersion, "pronunciationVersion");
+  if (value.utteranceClass !== "system-generic" || value.sharingScope !== "global" || value.reuse !== "exact-only" || value.containsPersonalData !== false || value.containsLearnerContent !== false) {
+    throw new Error("Canonical spoken help must use global system-generic exact-only reuse.");
+  }
+}
+function assertValidContextualVoiceQuestionResult(value) {
+  if (value.schemaVersion !== "1") throw new Error("schemaVersion must be 1.");
+  assertValidContextualHelpIdentifier(value.help);
+  if (!CONTEXTUAL_VOICE_INTENTS_V1.includes(value.intent)) {
+    throw new Error("intent is unsupported.");
+  }
+  if (value.transcriptRetention !== "request-memory-only") {
+    throw new Error("transcriptRetention must be request-memory-only.");
+  }
+  if (value.status !== "resolved" && value.status !== "suggestions" && value.status !== "stopped") {
+    throw new Error("status is unsupported.");
+  }
+  if (value.transientTranscript.length > 500 || containsDisallowedControlCharacter(value.transientTranscript)) {
+    throw new Error("transientTranscript is invalid.");
+  }
+  if (value.answer) {
+    requireOpaqueId(value.answer.helpId, "answer.helpId");
+    if (value.answer.source !== "module-documentation" && value.answer.source !== "assessment-evidence" && value.answer.source !== "authored-fallback" || value.answer.text.length === 0 || value.answer.text.length > 800 || containsDisallowedControlCharacter(value.answer.text)) {
+      throw new Error("answer.text is invalid.");
+    }
+  }
+  if (value.suggestedActions.some(
+    (action) => !CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1.includes(action)
+  )) {
+    throw new Error("suggestedActions contains an unsupported action.");
+  }
+  if (value.mayAssignScore !== false || value.mayAwardReward !== false || value.mayPublish !== false || value.mayControlHardware !== false) {
+    throw new Error("mayAssignScore, reward, publish and hardware authority must remain false.");
+  }
+}
+
 // src/publishing.ts
 var STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1 = "1.0.0";
 var STATIC_PROJECT_SCANNER_VERSION_V1 = "junior-coder-static-scan-v1";
@@ -6670,6 +7087,16 @@ var ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1 = {
 
 // src/validation.ts
 var CANONICAL_TOKEN_SUBUNITS = /^(0|[1-9][0-9]*)$/u;
+var EXACT_PACKAGE_NAME = /^@plasius\/[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/u;
+var EXACT_SEMVER = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/u;
+var EXPORT_NAME = /^[A-Za-z_$][A-Za-z0-9_$]*$/u;
+var CONTENT_SCHEMA_VERSION = /^(0|[1-9][0-9]*)$/u;
+var SHA256 = /^[a-f0-9]{64}$/u;
+function isExternalLearningContentReferenceV1(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  return Object.keys(value).length === 5 && typeof candidate.packageName === "string" && EXACT_PACKAGE_NAME.test(candidate.packageName) && typeof candidate.packageVersion === "string" && EXACT_SEMVER.test(candidate.packageVersion) && typeof candidate.exportName === "string" && EXPORT_NAME.test(candidate.exportName) && typeof candidate.schemaVersion === "string" && CONTENT_SCHEMA_VERSION.test(candidate.schemaVersion) && typeof candidate.sha256 === "string" && SHA256.test(candidate.sha256);
+}
 function issue(code, message, path, moduleId) {
   return { code, message, path, ...moduleId ? { moduleId } : {} };
 }
@@ -6784,6 +7211,17 @@ function validateModule(module3, moduleIndex) {
       )
     );
   }
+  const externalContent = module3.externalContent;
+  if (externalContent && !isExternalLearningContentReferenceV1(externalContent)) {
+    issues.push(
+      issue(
+        "invalid-external-content-reference",
+        "External content must use an exact @plasius package, stable semantic version, named export, schema version and lower-case SHA-256 digest.",
+        `${base}.externalContent`,
+        module3.id
+      )
+    );
+  }
   return issues;
 }
 function validateLearningPath(path) {
@@ -6828,20 +7266,31 @@ ${summary}`);
 0 && (module.exports = {
   ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1,
   BEACON_BOT_MISSION_ONE_AUTHORING_V1,
+  CONTEXTUAL_HELP_CONTRACT_VERSION_V1,
+  CONTEXTUAL_HELP_KINDS_V1,
+  CONTEXTUAL_VOICE_INTENTS_V1,
+  CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1,
   CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1,
   DANCE_ROVER_MISSION_ONE_AUTHORING_V1,
+  EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1,
   JUNIOR_CODER_MISSION_STAGE_ORDER_V1,
   JUNIOR_CODER_MODULE_PRICE_V1_1,
+  JUNIOR_CODER_PADDLE_PULSE_V2,
+  JUNIOR_CODER_ROAD_HOPPER_RALLY_V2,
   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,
   METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1,
   OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1,
+  PADDLE_PULSE_EXTERNAL_CONTENT_V1,
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
   PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1,
   RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1,
   RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
   ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
   ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1,
@@ -6857,12 +7306,19 @@ ${summary}`);
   VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1,
   VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1,
   VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1,
+  assertValidCanonicalSpokenHelpDescriptor,
+  assertValidContextualHelpIdentifier,
+  assertValidContextualVoiceQuestionMetadata,
+  assertValidContextualVoiceQuestionResult,
+  assertValidGuardianVoiceConsent,
   assertValidLearningPath,
   assertValidMissionAuthoringBundle,
   assertValidStaticProjectGuardianApproval,
   assertValidStaticProjectPublication,
   assertValidStaticProjectSnapshot,
+  assertValidVoiceHelpAvailability,
   calculateAssessment,
+  isExternalLearningContentReferenceV1,
   validateAssessmentRubric,
   validateLearningPath,
   validateMissionAuthoringBundle,