@plasius/learning 0.2.0 → 0.2.2

package/README.md

@@ -54,6 +54,39 @@ const result = calculateAssessment(rubric, [
 console.log(result.score, result.completed);
 ```
 
+## Validate mission authoring
+
+Mission authoring is additive to the immutable catalog. A bundle contains
+physically separate learner and facilitator projections and is checked against
+the exact catalog module that owns its rubric, mission and badges.
+
+```ts
+import {
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
+  ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
+  ROBOT_MAZE_DASH_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",
+);
+
+if (!roadHopper || !robotMaze) 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,
+);
+```
+
 ## Contract rules
 
 - Published IDs and versions are immutable.
@@ -63,6 +96,13 @@ console.log(result.score, result.completed);
 - `admin-test-grant` is distinct from pilot, support and paid purchase sources;
   consuming services must not attach an economy transaction to it.
 - Learner material never contains facilitator-only solutions or protected tests.
+- Mission stages follow `learn → predict → build → run → assess → inspect → fix
+  → 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.
@@ -70,8 +110,10 @@ console.log(result.score, result.completed);
 
 See [the foundation design](docs/design/junior-coder-catalog-foundation.md),
 [the uniform pricing design](docs/design/junior-coder-uniform-pricing.md),
+[the mission authoring design](docs/design/junior-coder-mission-authoring.md),
 [ADR 0001](docs/adrs/adr-0001-learning-domain-and-catalog-boundary.md), and
-[ADR 0002](docs/adrs/adr-0002-immutable-module-repricing-and-admin-test-source.md).
+[ADR 0002](docs/adrs/adr-0002-immutable-module-repricing-and-admin-test-source.md),
+and [ADR 0003](docs/adrs/adr-0003-mission-authoring-manifests-are-additive-and-separated.md).
 
 ## Development
 
@@ -84,12 +126,13 @@ npm run build
 npm run pack:check
 ```
 
-Node.js 24 is required. Releases are published only through the approved GitHub
-CD workflow on configurable trusted self-hosted runners. Both release jobs
-explicitly select the approved `Public CI - Quarantined` runner group by
-default, with `CD_RUNNER_GROUP` and `CD_RUNNER_LABELS` reserved for governed
-operator configuration. The organisation group remains restricted to
-allowlisted workflows and selected repositories. Release coverage and
+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