@plasius/learning 0.2.24 → 0.3.0

package/dist/index.js

@@ -847,497 +847,210 @@ var JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4
 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.`);
-  }
+// src/rubric-validation.ts
+var DIMENSION_TOTALS = {
+  structure: 20,
+  behaviour: 50,
+  resilience: 20,
+  safety: 10
+};
+function rubricIssue(code, message, path, moduleId) {
+  return { code, message, path, ...moduleId ? { moduleId } : {} };
 }
-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 validateAssessmentRubric(rubric2, path = "assessment", moduleId) {
+  const issues = [];
+  const criterionIds = /* @__PURE__ */ new Set();
+  const dimensionTotals = {
+    structure: 0,
+    behaviour: 0,
+    resilience: 0,
+    safety: 0
+  };
+  let rubricTotal = 0;
+  for (const criterion of rubric2.criteria) {
+    rubricTotal += criterion.points;
+    dimensionTotals[criterion.dimension] += criterion.points;
+    if (criterionIds.has(criterion.id)) {
+      issues.push(
+        rubricIssue(
+          "duplicate-criterion-id",
+          `Duplicate assessment criterion ${criterion.id}.`,
+          `${path}.criteria`,
+          moduleId
+        )
+      );
+    }
+    criterionIds.add(criterion.id);
   }
-}
-function assertValidContextualHelpIdentifier(value) {
-  if (value.schemaVersion !== "1") {
-    throw new Error("schemaVersion must be 1.");
+  if (rubricTotal !== 100) {
+    issues.push(
+      rubricIssue(
+        "rubric-total",
+        `Assessment rubric totals ${rubricTotal}; expected 100.`,
+        `${path}.criteria`,
+        moduleId
+      )
+    );
   }
-  if (value.contractVersion !== CONTEXTUAL_HELP_CONTRACT_VERSION_V1) {
-    throw new Error("contractVersion is unsupported.");
+  for (const [dimension, expected] of Object.entries(DIMENSION_TOTALS)) {
+    if (dimensionTotals[dimension] !== expected) {
+      issues.push(
+        rubricIssue(
+          "rubric-dimension-total",
+          `${dimension} criteria total ${dimensionTotals[dimension]}; expected ${expected}.`,
+          `${path}.criteria`,
+          moduleId
+        )
+      );
+    }
   }
-  if (!CONTEXTUAL_HELP_KINDS_V1.includes(value.kind)) {
-    throw new Error("kind is unsupported.");
+  if (!rubric2.criteria.some(
+    (criterion) => criterion.dimension === "safety" && criterion.mandatory
+  )) {
+    issues.push(
+      rubricIssue(
+        "missing-mandatory-safety",
+        "Every module requires a mandatory safety criterion.",
+        `${path}.criteria`,
+        moduleId
+      )
+    );
   }
-  requireOpaqueId(value.moduleId, "moduleId");
-  requireSemver(value.moduleVersion, "moduleVersion");
-  requireSemver(value.manifestVersion, "manifestVersion");
-  requireOpaqueId(value.helpId, "helpId");
+  return issues;
 }
-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");
+
+// src/mission-authoring.ts
+var JUNIOR_CODER_MISSION_STAGE_ORDER_V1 = [
+  "learn",
+  "predict",
+  "build",
+  "run",
+  "assess",
+  "inspect",
+  "fix",
+  "explain",
+  "reward"
+];
+var LEARNER_STARTER_KINDS = /* @__PURE__ */ new Set([
+  "starter-code",
+  "starter-assets",
+  "sample-data"
+]);
+var LEARNER_FORBIDDEN_KINDS = /* @__PURE__ */ new Set([
+  "facilitator-note",
+  "answer-key",
+  "protected-test"
+]);
+var SINGLE_MODE_REQUIRES_ALTERNATIVE = /* @__PURE__ */ new Set([
+  "pointer",
+  "drag",
+  "audio",
+  "colour",
+  "motion"
+]);
+function authoringIssue(code, message, path) {
+  return { code, message, path };
 }
-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 reportDuplicateIds(ids, path) {
+  const seen = /* @__PURE__ */ new Set();
+  const issues = [];
+  for (const id2 of ids) {
+    if (seen.has(id2)) {
+      issues.push(
+        authoringIssue("duplicate-id", `Duplicate authored ID ${id2}.`, path)
+      );
+    }
+    seen.add(id2);
   }
+  return issues;
 }
-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.");
+function validateMissionAuthoringBundle(bundle, module2) {
+  const issues = [];
+  if (bundle.version !== MISSION_AUTHORING_CONTRACT_VERSION_V1) {
+    issues.push(
+      authoringIssue(
+        "bundle-version-mismatch",
+        `Unsupported mission authoring version ${bundle.version}.`,
+        "version"
+      )
+    );
   }
-  if (value.microphoneAvailable !== (value.microphoneReason === "available")) {
-    throw new Error("microphoneReason must match microphone availability.");
+  if (bundle.moduleId !== module2.id || bundle.moduleVersion !== module2.version) {
+    issues.push(
+      authoringIssue(
+        "module-reference-mismatch",
+        `Bundle ${bundle.moduleId}@${bundle.moduleVersion} does not match ${module2.id}@${module2.version}.`,
+        "moduleId"
+      )
+    );
   }
-}
-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 (!module2.missions.some((mission2) => mission2.id === bundle.missionId)) {
+    issues.push(
+      authoringIssue(
+        "mission-reference-mismatch",
+        `Mission ${bundle.missionId} does not exist in module ${module2.id}.`,
+        "missionId"
+      )
+    );
   }
-  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.");
+  const learner = bundle.learner;
+  const facilitator = bundle.facilitator;
+  if (learner.estimatedMinutes < 15 || learner.estimatedMinutes > 25) {
+    issues.push(
+      authoringIssue(
+        "invalid-duration",
+        "A mission must last between 15 and 25 minutes.",
+        "learner.estimatedMinutes"
+      )
+    );
   }
-}
-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";
-var STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1 = "guardian-static-publication-v1";
-var STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1 = 90;
-var STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1 = 8e3;
-var STATIC_PROJECT_SAFETY_CHECK_IDS_V1 = [
-  "allow-listed-source",
-  "no-personal-details",
-  "no-external-network",
-  "no-executable-markup",
-  "no-transmitting-forms",
-  "no-uploads-or-embeds",
-  "no-trackers-or-advertising",
-  "no-account-identifiers"
-];
-var DIGEST_PATTERN = /^sha256:[a-f0-9]{64}$/u;
-var IDENTIFIER_PATTERN = /^(?:account|approval|publication|snapshot)_[A-Za-z0-9_-]{20,128}$/u;
-var VERSION_PATTERN = /^[0-9]+\.[0-9]+\.[0-9]+(?:[-+][A-Za-z0-9.-]+)?$/u;
-var RANDOM_SLUG_PATTERN = /^[A-Za-z0-9_-]{40,128}$/u;
-function validDate(value) {
-  return typeof value === "string" && Number.isFinite(Date.parse(value));
-}
-function allSafetyChecksPresent(scan) {
-  if (!Array.isArray(scan.checks) || scan.checks.length !== STATIC_PROJECT_SAFETY_CHECK_IDS_V1.length) {
-    return false;
-  }
-  const supplied = new Set(scan.checks.map((check) => check.id));
-  return STATIC_PROJECT_SAFETY_CHECK_IDS_V1.every((id) => supplied.has(id)) && scan.checks.every((check) => check.passed === true);
-}
-function safeAdventureRender(value) {
-  const headings = ["Moonbase Missions", "Forest Rescue Plans", "Ocean Quest Board"];
-  const titles = ["Find the moon crystal", "Guide the lost firefly", "Map the coral garden"];
-  const days = ["Saturday", "Sunday", "School holiday"];
-  const messages = ["Choose a day", "Add a mission title", "Mission ready!"];
-  return headings.includes(value.heading) && Array.isArray(value.missions) && value.missions.length >= 1 && value.missions.length <= 3 && value.missions.every((mission2) => titles.includes(mission2.title) && days.includes(mission2.day)) && messages.includes(value.validationMessage) && value.savedAcrossRestart === true && value.accessibleSummaryEnabled === true;
-}
-function safeCreatureRender(value) {
-  return ["Moon Moth", "Cloud Cat", "Pebble Dragon"].includes(value.creature) && ["Resting", "Ready to play", "Snack time"].includes(value.status) && [5, 10, 15].includes(value.timerSeconds) && ["single", "cosy-grid", "wide-grid"].includes(value.layout) && value.reducedMotion === true;
-}
-function safeRobotRender(value) {
-  return ["scan", "hold-position", "return-to-base"].includes(value.command) && value.safetyConfirmed === true && [1, 2, 4].includes(value.telemetryRate) && ["line", "bars", "text-only"].includes(value.chartMode) && value.serialSimulation === true && ["SCANNING", "HOLDING", "RETURNING"].includes(value.state);
-}
-function validateStaticProjectSnapshot(value) {
-  const issues = [];
-  if (value.schemaVersion !== "1") issues.push("invalid-schema-version");
-  if (value.contractVersion !== STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1) {
-    issues.push("invalid-contract-version");
-  }
-  if (!IDENTIFIER_PATTERN.test(value.snapshotId) || !IDENTIFIER_PATTERN.test(value.subjectAccountId)) {
-    issues.push("invalid-identifier");
-  }
-  if (!value.moduleId.startsWith("junior-coder.") || value.moduleId !== `junior-coder.${value.moduleSlug}`) {
-    issues.push("invalid-module");
-  }
-  if (!VERSION_PATTERN.test(value.moduleVersion)) issues.push("invalid-version");
-  if (!DIGEST_PATTERN.test(value.sourceDigest)) issues.push("invalid-source-digest");
-  if (!DIGEST_PATTERN.test(value.snapshotDigest)) issues.push("invalid-snapshot-digest");
-  if (!Number.isInteger(value.sourceCharacterCount) || value.sourceCharacterCount < 1 || value.sourceCharacterCount > STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1) {
-    issues.push("invalid-source-size");
-  }
-  if (!Number.isInteger(value.assessmentScore) || value.assessmentScore < 80 || value.assessmentScore > 100) {
-    issues.push("assessment-score-incomplete");
-  }
-  if (value.mandatorySafetyPassed !== true) issues.push("mandatory-safety-missing");
-  if (value.scan?.passed !== true || value.scan?.scannerVersion !== STATIC_PROJECT_SCANNER_VERSION_V1) {
-    issues.push("scan-not-passed");
-  }
-  if (!value.scan || !allSafetyChecksPresent(value.scan)) issues.push("scan-checks-incomplete");
-  if (value.moduleSlug !== value.renderModel?.kind) issues.push("module-render-model-mismatch");
-  const renderSafe = value.renderModel?.kind === "adventure-mission-planner" ? safeAdventureRender(value.renderModel) : value.renderModel?.kind === "creature-care-dashboard" ? safeCreatureRender(value.renderModel) : value.renderModel?.kind === "robot-mission-control" ? safeRobotRender(value.renderModel) : false;
-  if (!renderSafe) issues.push("unsafe-render-model");
-  if (value.state !== "pending-review" || !validDate(value.createdAt)) issues.push("invalid-created-at");
-  return [...new Set(issues)];
-}
-function assertValidStaticProjectSnapshot(value) {
-  const issues = validateStaticProjectSnapshot(value);
-  if (issues.length > 0) throw new Error(`Invalid static project snapshot: ${issues.join(", ")}`);
-}
-function validateStaticProjectGuardianApproval(value) {
-  const issues = [];
-  if (value.schemaVersion !== "1") issues.push("invalid-schema-version");
-  if (!IDENTIFIER_PATTERN.test(value.approvalId) || !IDENTIFIER_PATTERN.test(value.snapshotId) || !IDENTIFIER_PATTERN.test(value.guardianActorAccountId)) {
-    issues.push("invalid-identifier");
-  }
-  if (!DIGEST_PATTERN.test(value.snapshotDigest)) issues.push("invalid-snapshot-digest");
-  if (value.statementVersion !== STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1) {
-    issues.push("invalid-approval-statement");
-  }
-  if (!validDate(value.approvedAt)) issues.push("invalid-approved-at");
-  return [...new Set(issues)];
-}
-function assertValidStaticProjectGuardianApproval(value) {
-  const issues = validateStaticProjectGuardianApproval(value);
-  if (issues.length > 0) throw new Error(`Invalid static project approval: ${issues.join(", ")}`);
-}
-function validateStaticProjectPublication(value) {
-  const issues = [];
-  if (value.schemaVersion !== "1") issues.push("invalid-schema-version");
-  if (!IDENTIFIER_PATTERN.test(value.publicationId) || !IDENTIFIER_PATTERN.test(value.snapshotId) || !IDENTIFIER_PATTERN.test(value.approvalId)) {
-    issues.push("invalid-identifier");
-  }
-  if (!DIGEST_PATTERN.test(value.snapshotDigest)) issues.push("invalid-snapshot-digest");
-  if (!RANDOM_SLUG_PATTERN.test(value.randomSlug)) issues.push("invalid-random-slug");
-  let parsedUrl;
-  try {
-    parsedUrl = new URL(value.publicUrl);
-  } catch {
-    parsedUrl = void 0;
-  }
-  if (!parsedUrl || parsedUrl.protocol !== "https:" || parsedUrl.username || parsedUrl.password) {
-    issues.push("invalid-public-url");
-  }
-  if (!parsedUrl?.pathname.endsWith(`/${value.randomSlug}`)) issues.push("public-url-slug-mismatch");
-  if (value.state !== "published") issues.push("published-state-required");
-  if (!validDate(value.publishedAt)) issues.push("invalid-published-at");
-  if (!validDate(value.expiresAt) || validDate(value.publishedAt) && Date.parse(value.expiresAt) <= Date.parse(value.publishedAt)) {
-    issues.push("invalid-publication-expiry");
-  }
-  if (value.renewedAt !== void 0 && !validDate(value.renewedAt) || value.unpublishedAt !== void 0 && !validDate(value.unpublishedAt)) {
-    issues.push("invalid-lifecycle-timestamp");
-  }
-  return [...new Set(issues)];
-}
-function assertValidStaticProjectPublication(value) {
-  const issues = validateStaticProjectPublication(value);
-  if (issues.length > 0) throw new Error(`Invalid static project publication: ${issues.join(", ")}`);
-}
-
-// src/rubric-validation.ts
-var DIMENSION_TOTALS = {
-  structure: 20,
-  behaviour: 50,
-  resilience: 20,
-  safety: 10
-};
-function rubricIssue(code, message, path, moduleId) {
-  return { code, message, path, ...moduleId ? { moduleId } : {} };
-}
-function validateAssessmentRubric(rubric2, path = "assessment", moduleId) {
-  const issues = [];
-  const criterionIds = /* @__PURE__ */ new Set();
-  const dimensionTotals = {
-    structure: 0,
-    behaviour: 0,
-    resilience: 0,
-    safety: 0
-  };
-  let rubricTotal = 0;
-  for (const criterion of rubric2.criteria) {
-    rubricTotal += criterion.points;
-    dimensionTotals[criterion.dimension] += criterion.points;
-    if (criterionIds.has(criterion.id)) {
+  const stageKinds = learner.stages.map((stage) => stage.kind);
+  for (const requiredStage of JUNIOR_CODER_MISSION_STAGE_ORDER_V1) {
+    const count = stageKinds.filter((stage) => stage === requiredStage).length;
+    if (count === 0) {
       issues.push(
-        rubricIssue(
-          "duplicate-criterion-id",
-          `Duplicate assessment criterion ${criterion.id}.`,
-          `${path}.criteria`,
-          moduleId
+        authoringIssue(
+          "missing-stage",
+          `Mission stage ${requiredStage} is required.`,
+          "learner.stages"
+        )
+      );
+    } else if (count > 1) {
+      issues.push(
+        authoringIssue(
+          "duplicate-stage",
+          `Mission stage ${requiredStage} appears more than once.`,
+          "learner.stages"
         )
       );
     }
-    criterionIds.add(criterion.id);
   }
-  if (rubricTotal !== 100) {
+  if (stageKinds.length === JUNIOR_CODER_MISSION_STAGE_ORDER_V1.length && stageKinds.some(
+    (stage, index) => stage !== JUNIOR_CODER_MISSION_STAGE_ORDER_V1[index]
+  )) {
     issues.push(
-      rubricIssue(
-        "rubric-total",
-        `Assessment rubric totals ${rubricTotal}; expected 100.`,
-        `${path}.criteria`,
-        moduleId
+      authoringIssue(
+        "stage-order",
+        "Mission stages must follow the canonical learner journey.",
+        "learner.stages"
       )
     );
   }
-  for (const [dimension, expected] of Object.entries(DIMENSION_TOTALS)) {
-    if (dimensionTotals[dimension] !== expected) {
-      issues.push(
-        rubricIssue(
-          "rubric-dimension-total",
-          `${dimension} criteria total ${dimensionTotals[dimension]}; expected ${expected}.`,
-          `${path}.criteria`,
-          moduleId
-        )
-      );
-    }
+  if (learner.readinessChecks.length === 0) {
+    issues.push(
+      authoringIssue(
+        "missing-readiness-check",
+        "At least one unscored readiness check is required.",
+        "learner.readinessChecks"
+      )
+    );
   }
-  if (!rubric2.criteria.some(
-    (criterion) => criterion.dimension === "safety" && criterion.mandatory
-  )) {
+  if (learner.readinessChecks.some((check) => check.scored !== false)) {
     issues.push(
-      rubricIssue(
-        "missing-mandatory-safety",
-        "Every module requires a mandatory safety criterion.",
-        `${path}.criteria`,
-        moduleId
-      )
-    );
-  }
-  return issues;
-}
-
-// src/mission-authoring.ts
-var JUNIOR_CODER_MISSION_STAGE_ORDER_V1 = [
-  "learn",
-  "predict",
-  "build",
-  "run",
-  "assess",
-  "inspect",
-  "fix",
-  "explain",
-  "reward"
-];
-var LEARNER_STARTER_KINDS = /* @__PURE__ */ new Set([
-  "starter-code",
-  "starter-assets",
-  "sample-data"
-]);
-var LEARNER_FORBIDDEN_KINDS = /* @__PURE__ */ new Set([
-  "facilitator-note",
-  "answer-key",
-  "protected-test"
-]);
-var SINGLE_MODE_REQUIRES_ALTERNATIVE = /* @__PURE__ */ new Set([
-  "pointer",
-  "drag",
-  "audio",
-  "colour",
-  "motion"
-]);
-function authoringIssue(code, message, path) {
-  return { code, message, path };
-}
-function reportDuplicateIds(ids, path) {
-  const seen = /* @__PURE__ */ new Set();
-  const issues = [];
-  for (const id of ids) {
-    if (seen.has(id)) {
-      issues.push(
-        authoringIssue("duplicate-id", `Duplicate authored ID ${id}.`, path)
-      );
-    }
-    seen.add(id);
-  }
-  return issues;
-}
-function validateMissionAuthoringBundle(bundle, module2) {
-  const issues = [];
-  if (bundle.version !== MISSION_AUTHORING_CONTRACT_VERSION_V1) {
-    issues.push(
-      authoringIssue(
-        "bundle-version-mismatch",
-        `Unsupported mission authoring version ${bundle.version}.`,
-        "version"
-      )
-    );
-  }
-  if (bundle.moduleId !== module2.id || bundle.moduleVersion !== module2.version) {
-    issues.push(
-      authoringIssue(
-        "module-reference-mismatch",
-        `Bundle ${bundle.moduleId}@${bundle.moduleVersion} does not match ${module2.id}@${module2.version}.`,
-        "moduleId"
-      )
-    );
-  }
-  if (!module2.missions.some((mission2) => mission2.id === bundle.missionId)) {
-    issues.push(
-      authoringIssue(
-        "mission-reference-mismatch",
-        `Mission ${bundle.missionId} does not exist in module ${module2.id}.`,
-        "missionId"
-      )
-    );
-  }
-  const learner = bundle.learner;
-  const facilitator = bundle.facilitator;
-  if (learner.estimatedMinutes < 15 || learner.estimatedMinutes > 25) {
-    issues.push(
-      authoringIssue(
-        "invalid-duration",
-        "A mission must last between 15 and 25 minutes.",
-        "learner.estimatedMinutes"
-      )
-    );
-  }
-  const stageKinds = learner.stages.map((stage) => stage.kind);
-  for (const requiredStage of JUNIOR_CODER_MISSION_STAGE_ORDER_V1) {
-    const count = stageKinds.filter((stage) => stage === requiredStage).length;
-    if (count === 0) {
-      issues.push(
-        authoringIssue(
-          "missing-stage",
-          `Mission stage ${requiredStage} is required.`,
-          "learner.stages"
-        )
-      );
-    } else if (count > 1) {
-      issues.push(
-        authoringIssue(
-          "duplicate-stage",
-          `Mission stage ${requiredStage} appears more than once.`,
-          "learner.stages"
-        )
-      );
-    }
-  }
-  if (stageKinds.length === JUNIOR_CODER_MISSION_STAGE_ORDER_V1.length && stageKinds.some(
-    (stage, index) => stage !== JUNIOR_CODER_MISSION_STAGE_ORDER_V1[index]
-  )) {
-    issues.push(
-      authoringIssue(
-        "stage-order",
-        "Mission stages must follow the canonical learner journey.",
-        "learner.stages"
-      )
-    );
-  }
-  if (learner.readinessChecks.length === 0) {
-    issues.push(
-      authoringIssue(
-        "missing-readiness-check",
-        "At least one unscored readiness check is required.",
-        "learner.readinessChecks"
-      )
-    );
-  }
-  if (learner.readinessChecks.some((check) => check.scored !== false)) {
-    issues.push(
-      authoringIssue(
-        "scored-readiness-check",
-        "Readiness checks must not affect the deterministic score.",
-        "learner.readinessChecks"
+      authoringIssue(
+        "scored-readiness-check",
+        "Readiness checks must not affect the deterministic score.",
+        "learner.readinessChecks"
       )
     );
   }
@@ -7034,6 +6747,526 @@ var ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1 = {
   }
 };
 
+// src/course-contracts.ts
+var LEARNING_COURSE_STAGE_ORDER = JUNIOR_CODER_MISSION_STAGE_ORDER_V1;
+var LEARNING_COURSE_LIMITS = Object.freeze({
+  missions: 6,
+  stagesPerMission: 9,
+  projectFiles: 8,
+  sourceCharactersPerFile: 64e3,
+  sourceCharactersPerProject: 96e3
+});
+var ID = /^[a-z0-9][a-z0-9.-]{0,159}$/u;
+var FILE_PATH = /^[a-z0-9][a-z0-9_-]{0,63}\.(?:js|py|cpp|html|css|json)$/u;
+var VERSION = /^\d+\.\d+\.\d+$/u;
+var LANGUAGES = ["javascript", "python", "cpp", "html", "css", "blocks", "json"];
+var CATEGORIES = ["game", "robot", "vibe", "web-app"];
+var PLACEHOLDER = /\b(?:TODO|TBD|coming soon|placeholder|lorem ipsum)\b/iu;
+var record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var text = (value, minimum = 1, maximum = 8e3) => typeof value === "string" && value.trim().length >= minimum && value.length <= maximum;
+var id = (value) => typeof value === "string" && ID.test(value);
+var integer = (value, minimum, maximum) => typeof value === "number" && Number.isSafeInteger(value) && value >= minimum && value <= maximum;
+var exactKeys = (value, keys2) => Object.keys(value).length === keys2.length && keys2.every((key) => Object.hasOwn(value, key));
+var LearningCourseInputError = class extends Error {
+  constructor() {
+    super("Invalid learning course input.");
+    this.name = "LearningCourseInputError";
+  }
+};
+function fileDefinitions(value) {
+  return Array.isArray(value) && value.length >= 1 && value.length <= LEARNING_COURSE_LIMITS.projectFiles && value.every((file) => record(file) && exactKeys(file, ["path", "language", "maximumCharacters"]) && typeof file.path === "string" && FILE_PATH.test(file.path) && typeof file.language === "string" && LANGUAGES.includes(file.language) && integer(file.maximumCharacters, 1, LEARNING_COURSE_LIMITS.sourceCharactersPerFile)) && new Set(value.map((file) => file.path)).size === value.length;
+}
+function parseLearningProject(course, value) {
+  if (!fileDefinitions(course.projectFiles) || !record(value) || !exactKeys(value, ["files"]) || !Array.isArray(value.files) || value.files.length !== course.projectFiles.length) throw new LearningCourseInputError();
+  const files = [];
+  const seen = /* @__PURE__ */ new Set();
+  let characters = 0;
+  for (const file of value.files) {
+    if (!record(file) || !exactKeys(file, ["path", "source"]) || typeof file.path !== "string" || typeof file.source !== "string" || seen.has(file.path)) throw new LearningCourseInputError();
+    const definition = course.projectFiles.find((candidate) => candidate.path === file.path);
+    if (!definition || file.source.length > definition.maximumCharacters || file.source.includes("\0")) throw new LearningCourseInputError();
+    characters += file.source.length;
+    if (characters > LEARNING_COURSE_LIMITS.sourceCharactersPerProject) throw new LearningCourseInputError();
+    seen.add(file.path);
+    files.push({ path: file.path, source: file.source });
+  }
+  return { files: course.projectFiles.map((definition) => files.find((file) => file.path === definition.path)) };
+}
+function parseLearningCourseDraft(course, value) {
+  if (!record(value) || !exactKeys(value, ["schemaVersion", "moduleVersion", "activeStageId", "project"]) || value.schemaVersion !== "1" || value.moduleVersion !== course.moduleVersion || typeof value.activeStageId !== "string" || !course.missions.some((mission2) => mission2.stages.some((stage) => stage.id === value.activeStageId))) throw new LearningCourseInputError();
+  return {
+    schemaVersion: "1",
+    moduleVersion: course.moduleVersion,
+    activeStageId: value.activeStageId,
+    project: parseLearningProject(course, value.project)
+  };
+}
+function parseLearningSaveSlotId(value) {
+  if (value === "auto" || typeof value === "string" && /^[1-9]$/u.test(value)) return value;
+  throw new LearningCourseInputError();
+}
+function validateLearningCourse(value) {
+  const issues = [];
+  const add = (code, path) => {
+    issues.push({ code, path });
+  };
+  if (!record(value)) return [{ code: "invalid-manifest", path: "$" }];
+  if (!exactKeys(value, [
+    "schemaVersion",
+    "moduleId",
+    "moduleVersion",
+    "slug",
+    "title",
+    "summary",
+    "runtimeId",
+    "category",
+    "estimatedMinutes",
+    "completionAssessmentId",
+    "projectFiles",
+    "starterProject",
+    "reference",
+    "missions",
+    "completionBadge"
+  ]) || value.schemaVersion !== "1" || !id(value.moduleId) || !id(value.slug) || !id(value.runtimeId) || !text(value.moduleVersion) || !VERSION.test(value.moduleVersion) || typeof value.category !== "string" || !CATEGORIES.includes(value.category) || !text(value.title, 3, 160) || !text(value.summary, 40, 2e3) || !integer(value.estimatedMinutes, 60, 3600) || !id(value.completionAssessmentId) || !record(value.completionBadge) || !exactKeys(value.completionBadge, ["id", "title"]) || !id(value.completionBadge.id) || !text(value.completionBadge.title, 3, 160)) add("invalid-manifest", "$");
+  if (!fileDefinitions(value.projectFiles)) add("invalid-project", "projectFiles");
+  else {
+    try {
+      parseLearningProject({ projectFiles: value.projectFiles }, value.starterProject);
+    } catch {
+      add("invalid-project", "starterProject");
+    }
+  }
+  if (!Array.isArray(value.reference) || value.reference.length < 1 || value.reference.length > 80 || value.reference.some((entry) => !record(entry) || !exactKeys(entry, ["name", "signature", "description", "example"]) || !text(entry.name) || !text(entry.signature) || !text(entry.description, 20) || !text(entry.example))) add("incomplete-content", "reference");
+  if (!Array.isArray(value.missions)) {
+    add("mission-count", "missions");
+    return issues;
+  }
+  if (value.missions.length !== LEARNING_COURSE_LIMITS.missions) add("mission-count", "missions");
+  if (value.missions.length > LEARNING_COURSE_LIMITS.missions) return issues;
+  const seen = /* @__PURE__ */ new Set();
+  const checkId = (candidate, path) => {
+    if (!id(candidate)) add("invalid-manifest", path);
+    else if (seen.has(candidate)) add("duplicate-id", path);
+    else seen.add(candidate);
+  };
+  let minutes = 0;
+  value.missions.forEach((mission2, missionIndex) => {
+    const path = `missions[${missionIndex}]`;
+    if (!record(mission2)) {
+      add("invalid-manifest", path);
+      return;
+    }
+    checkId(mission2.id, `${path}.id`);
+    checkId(mission2.assessmentId, `${path}.assessmentId`);
+    if (!exactKeys(mission2, ["id", "title", "concepts", "estimatedMinutes", "goals", "assessmentId", "stages", "extension"]) || !text(mission2.title, 3, 160) || !integer(mission2.estimatedMinutes, 10, 600) || !Array.isArray(mission2.concepts) || mission2.concepts.length < 1 || mission2.concepts.length > 12 || mission2.concepts.some((concept) => !text(concept, 2, 120)) || !Array.isArray(mission2.goals) || mission2.goals.length < 1 || mission2.goals.length > 12 || mission2.goals.some((goal) => !text(goal, 20, 2e3)) || !text(mission2.extension, 30, 2e3)) add("incomplete-content", path);
+    if (typeof mission2.estimatedMinutes === "number") minutes += mission2.estimatedMinutes;
+    if (!Array.isArray(mission2.stages) || mission2.stages.length !== LEARNING_COURSE_LIMITS.stagesPerMission) {
+      add("stage-order", `${path}.stages`);
+      return;
+    }
+    mission2.stages.forEach((stage, stageIndex) => {
+      const stagePath = `${path}.stages[${stageIndex}]`;
+      if (!record(stage)) {
+        add("invalid-manifest", stagePath);
+        return;
+      }
+      checkId(stage.id, `${stagePath}.id`);
+      if (stage.kind !== LEARNING_COURSE_STAGE_ORDER[stageIndex]) add("stage-order", stagePath);
+      if (!exactKeys(stage, ["id", "kind", "title", "instruction", "help"]) || !text(stage.title, 3, 160) || !text(stage.instruction, 40) || !text(stage.help, 30) || typeof stage.instruction === "string" && PLACEHOLDER.test(stage.instruction)) add("incomplete-content", stagePath);
+    });
+  });
+  if (minutes !== value.estimatedMinutes) add("invalid-manifest", "estimatedMinutes");
+  return issues;
+}
+function parseLearningCourse(value) {
+  if (validateLearningCourse(value).length) throw new LearningCourseInputError();
+  return structuredClone(value);
+}
+
+// src/course-progress.ts
+var DIGEST = /^[a-f0-9]{64}$/u;
+var REFERENCE = /^[a-z0-9][a-z0-9.-]{0,159}$/u;
+var stages = (course) => course.missions.flatMap((mission2) => mission2.stages);
+var record2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var keys = (value, expected) => Object.keys(value).length === expected.length && expected.every((key) => Object.hasOwn(value, key));
+var identifier = (value) => typeof value === "string" && REFERENCE.test(value);
+var digest = (value) => typeof value === "string" && DIGEST.test(value);
+function validResult(value) {
+  if (!record2(value) || !keys(value, ["score", "band", "completed", "passedCriterionIds", "failedCriterionIds", "failedMandatoryCriterionIds"]) || typeof value.score !== "number" || !Number.isInteger(value.score) || value.score < 0 || value.score > 100) return false;
+  const arrays = [value.passedCriterionIds, value.failedCriterionIds, value.failedMandatoryCriterionIds];
+  if (arrays.some((items) => !Array.isArray(items) || items.length > 64 || !items.every(identifier) || new Set(items).size !== items.length)) return false;
+  const passed = value.passedCriterionIds;
+  const failed = value.failedCriterionIds;
+  const mandatory = value.failedMandatoryCriterionIds;
+  const band = value.score >= 95 ? "mastered" : value.score >= 80 ? "mission-complete" : value.score >= 60 ? "nearly-there" : "keep-exploring";
+  return value.band === band && value.completed === (value.score >= 80 && mandatory.length === 0) && !passed.some((id2) => failed.includes(id2)) && mandatory.every((id2) => failed.includes(id2));
+}
+function assertProgress(course, progress) {
+  const ordered = stages(course);
+  if (progress.schemaVersion !== "1" || progress.moduleId !== course.moduleId || progress.moduleVersion !== course.moduleVersion || !Array.isArray(progress.completedStageIds) || progress.completedStageIds.length > ordered.length || progress.completedStageIds.some((id2, index) => id2 !== ordered[index].id) || !Array.isArray(progress.completedMissionIds) || progress.completedMissionIds.length !== Math.floor(progress.completedStageIds.length / 9) || progress.completedMissionIds.some((id2, index) => id2 !== course.missions[index].id) || !Array.isArray(progress.assessments) || progress.assessments.length > 7 || progress.assessments.some((item) => {
+    if (!record2(item) || !keys(item, ["missionId", "assessmentId", "referenceId", "sourceDigest", "result"]) || !identifier(item.referenceId) || !digest(item.sourceDigest) || !validResult(item.result)) return true;
+    const mission2 = course.missions.find((candidate) => candidate.id === item.missionId);
+    return item.missionId === "final" ? progress.completedMissionIds.length !== 6 || item.assessmentId !== course.completionAssessmentId : !mission2 || item.assessmentId !== mission2.assessmentId;
+  }) || new Set(progress.assessments.map((item) => item.missionId)).size !== progress.assessments.length || new Set(progress.assessments.map((item) => item.referenceId)).size !== progress.assessments.length) throw new LearningCourseInputError();
+  if (progress.completion !== null && (!record2(progress.completion) || !keys(progress.completion, ["referenceId", "sourceDigest", "bestScore"]) || progress.completedMissionIds.length !== 6 || !identifier(progress.completion.referenceId) || !digest(progress.completion.sourceDigest) || !Number.isInteger(progress.completion.bestScore) || progress.completion.bestScore < 80 || progress.completion.bestScore > 100)) throw new LearningCourseInputError();
+}
+function parseLearningCourseProgress(course, value) {
+  if (!record2(value) || !keys(value, ["schemaVersion", "moduleId", "moduleVersion", "completedStageIds", "completedMissionIds", "assessments", "completion"])) throw new LearningCourseInputError();
+  assertProgress(course, value);
+  return structuredClone(value);
+}
+function createLearningCourseProgress(course) {
+  if (validateLearningCourse(course).length) throw new LearningCourseInputError();
+  return {
+    schemaVersion: "1",
+    moduleId: course.moduleId,
+    moduleVersion: course.moduleVersion,
+    completedStageIds: [],
+    completedMissionIds: [],
+    assessments: [],
+    completion: null
+  };
+}
+function resolveLearningCourseStage(course, progress, requestedId) {
+  assertProgress(course, progress);
+  const ordered = stages(course);
+  const maximum = Math.min(progress.completedStageIds.length, ordered.length - 1);
+  const requestedIndex = ordered.findIndex((stage) => stage.id === requestedId);
+  return requestedIndex >= 0 && requestedIndex <= maximum ? requestedId : ordered[maximum].id;
+}
+function recordLearningCourseAssessment(course, progress, authority) {
+  assertProgress(course, progress);
+  const final = authority.missionId === "final";
+  const missionIndex = course.missions.findIndex((mission2) => mission2.id === authority.missionId);
+  if (!DIGEST.test(authority.sourceDigest) || !REFERENCE.test(authority.referenceId) || (final ? progress.completedMissionIds.length !== course.missions.length : missionIndex < 0 || missionIndex > progress.completedMissionIds.length) || authority.assessmentId !== (final ? course.completionAssessmentId : course.missions[missionIndex]?.assessmentId) || authority.rubric.version !== course.moduleVersion || authority.rubric.criteria.length > 64 || authority.checks.length > 64 || authority.checks.some((check) => typeof check.passed !== "boolean") || validateAssessmentRubric(authority.rubric).length) throw new LearningCourseInputError();
+  let result;
+  try {
+    result = calculateAssessment(authority.rubric, authority.checks);
+  } catch {
+    throw new LearningCourseInputError();
+  }
+  const assessment = {
+    missionId: authority.missionId,
+    assessmentId: authority.assessmentId,
+    referenceId: authority.referenceId,
+    sourceDigest: authority.sourceDigest,
+    result
+  };
+  const duplicate = progress.assessments.find((item) => item.referenceId === authority.referenceId);
+  if (duplicate && JSON.stringify(duplicate) !== JSON.stringify(assessment)) throw new LearningCourseInputError();
+  const next = structuredClone(progress);
+  next.assessments = [...next.assessments.filter((item) => item.missionId !== authority.missionId), assessment];
+  if (final && result.completed) {
+    next.completion = next.completion ? { ...next.completion, bestScore: Math.max(next.completion.bestScore, result.score) } : { referenceId: authority.referenceId, sourceDigest: authority.sourceDigest, bestScore: result.score };
+  }
+  return next;
+}
+function completeVerifiedLearningActivity(course, progress, proof) {
+  assertProgress(course, progress);
+  if (proof.accepted !== true || !DIGEST.test(proof.sourceDigest)) throw new LearningCourseInputError();
+  const ordered = stages(course);
+  const index = ordered.findIndex((stage2) => stage2.id === proof.stageId);
+  if (index < 0 || index > progress.completedStageIds.length) throw new LearningCourseInputError();
+  if (index < progress.completedStageIds.length) return structuredClone(progress);
+  const stage = ordered[index];
+  const mission2 = course.missions[Math.floor(index / 9)];
+  if (["assess", "inspect", "fix", "reward"].includes(stage.kind)) {
+    const assessment = progress.assessments.find((item) => item.missionId === mission2.id);
+    if (!assessment || assessment.sourceDigest !== proof.sourceDigest || (stage.kind === "fix" || stage.kind === "reward") && !assessment.result.completed) throw new LearningCourseInputError();
+  }
+  const next = structuredClone(progress);
+  next.completedStageIds.push(proof.stageId);
+  if (stage.kind === "reward") next.completedMissionIds.push(mission2.id);
+  return next;
+}
+
+// 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";
+var STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1 = "guardian-static-publication-v1";
+var STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1 = 90;
+var STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1 = 8e3;
+var STATIC_PROJECT_SAFETY_CHECK_IDS_V1 = [
+  "allow-listed-source",
+  "no-personal-details",
+  "no-external-network",
+  "no-executable-markup",
+  "no-transmitting-forms",
+  "no-uploads-or-embeds",
+  "no-trackers-or-advertising",
+  "no-account-identifiers"
+];
+var DIGEST_PATTERN = /^sha256:[a-f0-9]{64}$/u;
+var IDENTIFIER_PATTERN = /^(?:account|approval|publication|snapshot)_[A-Za-z0-9_-]{20,128}$/u;
+var VERSION_PATTERN = /^[0-9]+\.[0-9]+\.[0-9]+(?:[-+][A-Za-z0-9.-]+)?$/u;
+var RANDOM_SLUG_PATTERN = /^[A-Za-z0-9_-]{40,128}$/u;
+function validDate(value) {
+  return typeof value === "string" && Number.isFinite(Date.parse(value));
+}
+function allSafetyChecksPresent(scan) {
+  if (!Array.isArray(scan.checks) || scan.checks.length !== STATIC_PROJECT_SAFETY_CHECK_IDS_V1.length) {
+    return false;
+  }
+  const supplied = new Set(scan.checks.map((check) => check.id));
+  return STATIC_PROJECT_SAFETY_CHECK_IDS_V1.every((id2) => supplied.has(id2)) && scan.checks.every((check) => check.passed === true);
+}
+function safeAdventureRender(value) {
+  const headings = ["Moonbase Missions", "Forest Rescue Plans", "Ocean Quest Board"];
+  const titles = ["Find the moon crystal", "Guide the lost firefly", "Map the coral garden"];
+  const days = ["Saturday", "Sunday", "School holiday"];
+  const messages = ["Choose a day", "Add a mission title", "Mission ready!"];
+  return headings.includes(value.heading) && Array.isArray(value.missions) && value.missions.length >= 1 && value.missions.length <= 3 && value.missions.every((mission2) => titles.includes(mission2.title) && days.includes(mission2.day)) && messages.includes(value.validationMessage) && value.savedAcrossRestart === true && value.accessibleSummaryEnabled === true;
+}
+function safeCreatureRender(value) {
+  return ["Moon Moth", "Cloud Cat", "Pebble Dragon"].includes(value.creature) && ["Resting", "Ready to play", "Snack time"].includes(value.status) && [5, 10, 15].includes(value.timerSeconds) && ["single", "cosy-grid", "wide-grid"].includes(value.layout) && value.reducedMotion === true;
+}
+function safeRobotRender(value) {
+  return ["scan", "hold-position", "return-to-base"].includes(value.command) && value.safetyConfirmed === true && [1, 2, 4].includes(value.telemetryRate) && ["line", "bars", "text-only"].includes(value.chartMode) && value.serialSimulation === true && ["SCANNING", "HOLDING", "RETURNING"].includes(value.state);
+}
+function validateStaticProjectSnapshot(value) {
+  const issues = [];
+  if (value.schemaVersion !== "1") issues.push("invalid-schema-version");
+  if (value.contractVersion !== STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1) {
+    issues.push("invalid-contract-version");
+  }
+  if (!IDENTIFIER_PATTERN.test(value.snapshotId) || !IDENTIFIER_PATTERN.test(value.subjectAccountId)) {
+    issues.push("invalid-identifier");
+  }
+  if (!value.moduleId.startsWith("junior-coder.") || value.moduleId !== `junior-coder.${value.moduleSlug}`) {
+    issues.push("invalid-module");
+  }
+  if (!VERSION_PATTERN.test(value.moduleVersion)) issues.push("invalid-version");
+  if (!DIGEST_PATTERN.test(value.sourceDigest)) issues.push("invalid-source-digest");
+  if (!DIGEST_PATTERN.test(value.snapshotDigest)) issues.push("invalid-snapshot-digest");
+  if (!Number.isInteger(value.sourceCharacterCount) || value.sourceCharacterCount < 1 || value.sourceCharacterCount > STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1) {
+    issues.push("invalid-source-size");
+  }
+  if (!Number.isInteger(value.assessmentScore) || value.assessmentScore < 80 || value.assessmentScore > 100) {
+    issues.push("assessment-score-incomplete");
+  }
+  if (value.mandatorySafetyPassed !== true) issues.push("mandatory-safety-missing");
+  if (value.scan?.passed !== true || value.scan?.scannerVersion !== STATIC_PROJECT_SCANNER_VERSION_V1) {
+    issues.push("scan-not-passed");
+  }
+  if (!value.scan || !allSafetyChecksPresent(value.scan)) issues.push("scan-checks-incomplete");
+  if (value.moduleSlug !== value.renderModel?.kind) issues.push("module-render-model-mismatch");
+  const renderSafe = value.renderModel?.kind === "adventure-mission-planner" ? safeAdventureRender(value.renderModel) : value.renderModel?.kind === "creature-care-dashboard" ? safeCreatureRender(value.renderModel) : value.renderModel?.kind === "robot-mission-control" ? safeRobotRender(value.renderModel) : false;
+  if (!renderSafe) issues.push("unsafe-render-model");
+  if (value.state !== "pending-review" || !validDate(value.createdAt)) issues.push("invalid-created-at");
+  return [...new Set(issues)];
+}
+function assertValidStaticProjectSnapshot(value) {
+  const issues = validateStaticProjectSnapshot(value);
+  if (issues.length > 0) throw new Error(`Invalid static project snapshot: ${issues.join(", ")}`);
+}
+function validateStaticProjectGuardianApproval(value) {
+  const issues = [];
+  if (value.schemaVersion !== "1") issues.push("invalid-schema-version");
+  if (!IDENTIFIER_PATTERN.test(value.approvalId) || !IDENTIFIER_PATTERN.test(value.snapshotId) || !IDENTIFIER_PATTERN.test(value.guardianActorAccountId)) {
+    issues.push("invalid-identifier");
+  }
+  if (!DIGEST_PATTERN.test(value.snapshotDigest)) issues.push("invalid-snapshot-digest");
+  if (value.statementVersion !== STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1) {
+    issues.push("invalid-approval-statement");
+  }
+  if (!validDate(value.approvedAt)) issues.push("invalid-approved-at");
+  return [...new Set(issues)];
+}
+function assertValidStaticProjectGuardianApproval(value) {
+  const issues = validateStaticProjectGuardianApproval(value);
+  if (issues.length > 0) throw new Error(`Invalid static project approval: ${issues.join(", ")}`);
+}
+function validateStaticProjectPublication(value) {
+  const issues = [];
+  if (value.schemaVersion !== "1") issues.push("invalid-schema-version");
+  if (!IDENTIFIER_PATTERN.test(value.publicationId) || !IDENTIFIER_PATTERN.test(value.snapshotId) || !IDENTIFIER_PATTERN.test(value.approvalId)) {
+    issues.push("invalid-identifier");
+  }
+  if (!DIGEST_PATTERN.test(value.snapshotDigest)) issues.push("invalid-snapshot-digest");
+  if (!RANDOM_SLUG_PATTERN.test(value.randomSlug)) issues.push("invalid-random-slug");
+  let parsedUrl;
+  try {
+    parsedUrl = new URL(value.publicUrl);
+  } catch {
+    parsedUrl = void 0;
+  }
+  if (!parsedUrl || parsedUrl.protocol !== "https:" || parsedUrl.username || parsedUrl.password) {
+    issues.push("invalid-public-url");
+  }
+  if (!parsedUrl?.pathname.endsWith(`/${value.randomSlug}`)) issues.push("public-url-slug-mismatch");
+  if (value.state !== "published") issues.push("published-state-required");
+  if (!validDate(value.publishedAt)) issues.push("invalid-published-at");
+  if (!validDate(value.expiresAt) || validDate(value.publishedAt) && Date.parse(value.expiresAt) <= Date.parse(value.publishedAt)) {
+    issues.push("invalid-publication-expiry");
+  }
+  if (value.renewedAt !== void 0 && !validDate(value.renewedAt) || value.unpublishedAt !== void 0 && !validDate(value.unpublishedAt)) {
+    issues.push("invalid-lifecycle-timestamp");
+  }
+  return [...new Set(issues)];
+}
+function assertValidStaticProjectPublication(value) {
+  const issues = validateStaticProjectPublication(value);
+  if (issues.length > 0) throw new Error(`Invalid static project publication: ${issues.join(", ")}`);
+}
+
 // 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;
@@ -7232,6 +7465,9 @@ export {
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4,
+  LEARNING_COURSE_LIMITS,
+  LEARNING_COURSE_STAGE_ORDER,
+  LearningCourseInputError,
   METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1,
   OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1,
@@ -7269,8 +7505,18 @@ export {
   assertValidStaticProjectSnapshot,
   assertValidVoiceHelpAvailability,
   calculateAssessment,
+  completeVerifiedLearningActivity,
+  createLearningCourseProgress,
   isExternalLearningContentReferenceV1,
+  parseLearningCourse,
+  parseLearningCourseDraft,
+  parseLearningCourseProgress,
+  parseLearningProject,
+  parseLearningSaveSlotId,
+  recordLearningCourseAssessment,
+  resolveLearningCourseStage,
   validateAssessmentRubric,
+  validateLearningCourse,
   validateLearningPath,
   validateMissionAuthoringBundle,
   validateStaticProjectGuardianApproval,