@plasius/learning 0.2.19 → 0.2.20

package/README.md

@@ -54,6 +54,30 @@ const result = calculateAssessment(rubric, [
 console.log(result.score, result.completed);
 ```
 
+## Validate a Guardian-approved static project
+
+The publishing contracts cover only immutable evidence and safe render models.
+HTTP, persistence, identity checks, scanning implementations and hosting remain
+consumer responsibilities. A public renderer must consume the allow-listed
+`renderModel`; it must never execute learner source.
+
+```ts
+import {
+  assertValidStaticProjectGuardianApproval,
+  assertValidStaticProjectPublication,
+  assertValidStaticProjectSnapshot,
+} from "@plasius/learning";
+
+assertValidStaticProjectSnapshot(snapshot);
+assertValidStaticProjectGuardianApproval(approval);
+assertValidStaticProjectPublication(publication);
+```
+
+The version-one contract supports the three launch web projects, requires a
+score of at least 80 plus mandatory safety evidence, records all eight scanner
+checks, binds adult approval to the exact snapshot digest, and requires an
+unlisted HTTPS URL with a random slug and explicit expiry.
+
 ## Validate mission authoring
 
 Mission authoring is additive to the immutable catalog. A bundle contains

package/dist/index.cjs

@@ -42,15 +42,27 @@ __export(index_exports, {
   SERVO_CREATURE_MISSION_ONE_AUTHORING_V1: () => SERVO_CREATURE_MISSION_ONE_AUTHORING_V1,
   SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1: () => SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1,
   STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1: () => STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1,
+  STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1: () => STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1,
+  STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1: () => STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1,
+  STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1: () => STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1,
+  STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1: () => STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1,
+  STATIC_PROJECT_SAFETY_CHECK_IDS_V1: () => STATIC_PROJECT_SAFETY_CHECK_IDS_V1,
+  STATIC_PROJECT_SCANNER_VERSION_V1: () => STATIC_PROJECT_SCANNER_VERSION_V1,
   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,
   assertValidLearningPath: () => assertValidLearningPath,
   assertValidMissionAuthoringBundle: () => assertValidMissionAuthoringBundle,
+  assertValidStaticProjectGuardianApproval: () => assertValidStaticProjectGuardianApproval,
+  assertValidStaticProjectPublication: () => assertValidStaticProjectPublication,
+  assertValidStaticProjectSnapshot: () => assertValidStaticProjectSnapshot,
   calculateAssessment: () => calculateAssessment,
   validateAssessmentRubric: () => validateAssessmentRubric,
   validateLearningPath: () => validateLearningPath,
-  validateMissionAuthoringBundle: () => validateMissionAuthoringBundle
+  validateMissionAuthoringBundle: () => validateMissionAuthoringBundle,
+  validateStaticProjectGuardianApproval: () => validateStaticProjectGuardianApproval,
+  validateStaticProjectPublication: () => validateStaticProjectPublication,
+  validateStaticProjectSnapshot: () => validateStaticProjectSnapshot
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -627,6 +639,135 @@ var JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1
 // src/contracts.ts
 var MISSION_AUTHORING_CONTRACT_VERSION_V1 = "1.0.0";
 
+// 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,
@@ -6707,14 +6848,26 @@ ${summary}`);
   SERVO_CREATURE_MISSION_ONE_AUTHORING_V1,
   SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1,
   STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1,
+  STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1,
+  STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1,
+  STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1,
+  STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1,
+  STATIC_PROJECT_SAFETY_CHECK_IDS_V1,
+  STATIC_PROJECT_SCANNER_VERSION_V1,
   VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1,
   VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1,
   VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1,
   assertValidLearningPath,
   assertValidMissionAuthoringBundle,
+  assertValidStaticProjectGuardianApproval,
+  assertValidStaticProjectPublication,
+  assertValidStaticProjectSnapshot,
   calculateAssessment,
   validateAssessmentRubric,
   validateLearningPath,
-  validateMissionAuthoringBundle
+  validateMissionAuthoringBundle,
+  validateStaticProjectGuardianApproval,
+  validateStaticProjectPublication,
+  validateStaticProjectSnapshot
 });
 //# sourceMappingURL=index.cjs.map