@plasius/learning 0.2.19 → 0.2.20

package/dist/index.d.cts

@@ -429,6 +429,111 @@ declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: LearningPathVersionV1;
 /** Current pilot catalog for server adapters that intentionally follow releases. */
 declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT: LearningPathVersionV1;
 
+/** Versioned, infrastructure-neutral contracts for Guardian-approved static projects. */
+declare const STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1: "1.0.0";
+declare const STATIC_PROJECT_SCANNER_VERSION_V1: "junior-coder-static-scan-v1";
+declare const STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1: "guardian-static-publication-v1";
+declare const STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1: 90;
+declare const STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1: 8000;
+declare const STATIC_PROJECT_SAFETY_CHECK_IDS_V1: readonly ["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"];
+type StaticProjectSafetyCheckIdV1 = (typeof STATIC_PROJECT_SAFETY_CHECK_IDS_V1)[number];
+type StaticProjectModuleSlugV1 = "adventure-mission-planner" | "creature-care-dashboard" | "robot-mission-control";
+interface StaticProjectSafetyCheckV1 {
+    id: StaticProjectSafetyCheckIdV1;
+    passed: true;
+}
+/** Evidence emitted by the deterministic scanner before adult review. */
+interface StaticProjectSafetyScanV1 {
+    schemaVersion: "1";
+    scannerVersion: typeof STATIC_PROJECT_SCANNER_VERSION_V1;
+    passed: true;
+    checks: StaticProjectSafetyCheckV1[];
+}
+interface AdventureMissionPlannerSafeRenderV1 {
+    kind: "adventure-mission-planner";
+    heading: "Moonbase Missions" | "Forest Rescue Plans" | "Ocean Quest Board";
+    missions: {
+        title: "Find the moon crystal" | "Guide the lost firefly" | "Map the coral garden";
+        day: "Saturday" | "Sunday" | "School holiday";
+    }[];
+    validationMessage: "Choose a day" | "Add a mission title" | "Mission ready!";
+    savedAcrossRestart: true;
+    accessibleSummaryEnabled: true;
+}
+interface CreatureCareDashboardSafeRenderV1 {
+    kind: "creature-care-dashboard";
+    creature: "Moon Moth" | "Cloud Cat" | "Pebble Dragon";
+    status: "Resting" | "Ready to play" | "Snack time";
+    timerSeconds: 5 | 10 | 15;
+    layout: "single" | "cosy-grid" | "wide-grid";
+    reducedMotion: true;
+}
+interface RobotMissionControlSafeRenderV1 {
+    kind: "robot-mission-control";
+    command: "scan" | "hold-position" | "return-to-base";
+    safetyConfirmed: true;
+    telemetryRate: 1 | 2 | 4;
+    chartMode: "line" | "bars" | "text-only";
+    serialSimulation: true;
+    state: "SCANNING" | "HOLDING" | "RETURNING";
+}
+/** The complete public render allow-list. Learner source is never a render model. */
+type StaticProjectSafeRenderV1 = AdventureMissionPlannerSafeRenderV1 | CreatureCareDashboardSafeRenderV1 | RobotMissionControlSafeRenderV1;
+/** Immutable private snapshot awaiting an adult's exact-hash approval. */
+interface StaticProjectSnapshotV1 {
+    schemaVersion: "1";
+    contractVersion: typeof STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1;
+    snapshotId: string;
+    subjectAccountId: string;
+    moduleId: string;
+    moduleSlug: StaticProjectModuleSlugV1;
+    moduleVersion: string;
+    missionId: string;
+    sourceDigest: string;
+    snapshotDigest: string;
+    sourceCharacterCount: number;
+    assessmentScore: number;
+    mandatorySafetyPassed: true;
+    scan: StaticProjectSafetyScanV1;
+    renderModel: StaticProjectSafeRenderV1;
+    state: "pending-review";
+    createdAt: string;
+}
+/** Adult approval is evidence only and cannot mutate the reviewed snapshot. */
+interface StaticProjectGuardianApprovalV1 {
+    schemaVersion: "1";
+    approvalId: string;
+    snapshotId: string;
+    snapshotDigest: string;
+    guardianActorAccountId: string;
+    statementVersion: typeof STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1;
+    approvedAt: string;
+}
+/** An unlisted public pointer whose lifecycle never changes the source snapshot. */
+interface StaticProjectPublicationV1 {
+    schemaVersion: "1";
+    publicationId: string;
+    snapshotId: string;
+    snapshotDigest: string;
+    approvalId: string;
+    randomSlug: string;
+    publicUrl: string;
+    state: "published" | "expired" | "unpublished";
+    publishedAt: string;
+    expiresAt: string;
+    renewedAt?: string;
+    unpublishedAt?: string;
+}
+type StaticProjectContractIssueV1 = "invalid-schema-version" | "invalid-contract-version" | "invalid-identifier" | "invalid-module" | "invalid-version" | "invalid-source-digest" | "invalid-snapshot-digest" | "invalid-source-size" | "assessment-score-incomplete" | "mandatory-safety-missing" | "scan-not-passed" | "scan-checks-incomplete" | "module-render-model-mismatch" | "unsafe-render-model" | "invalid-created-at" | "invalid-approval-statement" | "invalid-approved-at" | "invalid-random-slug" | "invalid-public-url" | "public-url-slug-mismatch" | "published-state-required" | "invalid-published-at" | "invalid-publication-expiry" | "invalid-lifecycle-timestamp";
+/** Validate a snapshot without throwing so authoring and adapters can show every issue. */
+declare function validateStaticProjectSnapshot(value: StaticProjectSnapshotV1): StaticProjectContractIssueV1[];
+/** Fail closed when a persistence or publishing adapter constructs an invalid snapshot. */
+declare function assertValidStaticProjectSnapshot(value: StaticProjectSnapshotV1): void;
+declare function validateStaticProjectGuardianApproval(value: StaticProjectGuardianApprovalV1): StaticProjectContractIssueV1[];
+declare function assertValidStaticProjectGuardianApproval(value: StaticProjectGuardianApprovalV1): void;
+declare function validateStaticProjectPublication(value: StaticProjectPublicationV1): StaticProjectContractIssueV1[];
+declare function assertValidStaticProjectPublication(value: StaticProjectPublicationV1): void;
+
 /** Validate the deterministic 20/50/20/10 assessment authority. */
 declare function validateAssessmentRubric(rubric: AssessmentRubricV1, path?: string, moduleId?: string): LearningValidationIssueV1[];
 
@@ -525,4 +630,4 @@ declare function validateLearningPath(path: LearningPathVersionV1): LearningVali
 /** Fail fast when a path is not safe to publish or consume. */
 declare function assertValidLearningPath(path: LearningPathVersionV1): void;
 
-export { ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1, type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, BEACON_BOT_MISSION_ONE_AUTHORING_V1, type BadgeDefinitionV1, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CommercialStateV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, type LearnerMissionAuthoringV1, type LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningValidationIssueV1, METEOR_SHIELD_MISSION_ONE_AUTHORING_V1, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionBoundedSuggestionV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionFunctionParameterV1, type MissionFunctionReferenceV1, type MissionHardwareAcquisitionScopeV1, type MissionHardwareComponentDisclosureV1, type MissionHardwareDisclosureV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, type MissionPhysicalSafeguardsV1, type MissionReadinessCheckV1, type MissionRewardBindingV1, type MissionSideAdventureV1, type MissionStageCardV1, type MissionStageKindV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1, PADDLE_PULSE_MISSION_ONE_AUTHORING_V1, PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1, type PublishedStaticProjectSnapshotV1, RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1, RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1, ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1, SERVO_CREATURE_MISSION_ONE_AUTHORING_V1, SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1, STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1, type ScoreBandV1, VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1, VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1, VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1, assertValidLearningPath, assertValidMissionAuthoringBundle, calculateAssessment, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle };
+export { ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1, type AdventureMissionPlannerSafeRenderV1, type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, BEACON_BOT_MISSION_ONE_AUTHORING_V1, type BadgeDefinitionV1, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CommercialStateV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type CreatureCareDashboardSafeRenderV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, type LearnerMissionAuthoringV1, type LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningValidationIssueV1, METEOR_SHIELD_MISSION_ONE_AUTHORING_V1, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionBoundedSuggestionV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionFunctionParameterV1, type MissionFunctionReferenceV1, type MissionHardwareAcquisitionScopeV1, type MissionHardwareComponentDisclosureV1, type MissionHardwareDisclosureV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, type MissionPhysicalSafeguardsV1, type MissionReadinessCheckV1, type MissionRewardBindingV1, type MissionSideAdventureV1, type MissionStageCardV1, type MissionStageKindV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1, PADDLE_PULSE_MISSION_ONE_AUTHORING_V1, PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1, type PublishedStaticProjectSnapshotV1, RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1, RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1, ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1, type RobotMissionControlSafeRenderV1, 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, type ScoreBandV1, type StaticProjectContractIssueV1, type StaticProjectGuardianApprovalV1, type StaticProjectModuleSlugV1, type StaticProjectPublicationV1, type StaticProjectSafeRenderV1, type StaticProjectSafetyCheckIdV1, type StaticProjectSafetyCheckV1, type StaticProjectSafetyScanV1, type StaticProjectSnapshotV1, 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, validateStaticProjectGuardianApproval, validateStaticProjectPublication, validateStaticProjectSnapshot };

package/dist/index.d.ts

@@ -429,6 +429,111 @@ declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: LearningPathVersionV1;
 /** Current pilot catalog for server adapters that intentionally follow releases. */
 declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT: LearningPathVersionV1;
 
+/** Versioned, infrastructure-neutral contracts for Guardian-approved static projects. */
+declare const STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1: "1.0.0";
+declare const STATIC_PROJECT_SCANNER_VERSION_V1: "junior-coder-static-scan-v1";
+declare const STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1: "guardian-static-publication-v1";
+declare const STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1: 90;
+declare const STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1: 8000;
+declare const STATIC_PROJECT_SAFETY_CHECK_IDS_V1: readonly ["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"];
+type StaticProjectSafetyCheckIdV1 = (typeof STATIC_PROJECT_SAFETY_CHECK_IDS_V1)[number];
+type StaticProjectModuleSlugV1 = "adventure-mission-planner" | "creature-care-dashboard" | "robot-mission-control";
+interface StaticProjectSafetyCheckV1 {
+    id: StaticProjectSafetyCheckIdV1;
+    passed: true;
+}
+/** Evidence emitted by the deterministic scanner before adult review. */
+interface StaticProjectSafetyScanV1 {
+    schemaVersion: "1";
+    scannerVersion: typeof STATIC_PROJECT_SCANNER_VERSION_V1;
+    passed: true;
+    checks: StaticProjectSafetyCheckV1[];
+}
+interface AdventureMissionPlannerSafeRenderV1 {
+    kind: "adventure-mission-planner";
+    heading: "Moonbase Missions" | "Forest Rescue Plans" | "Ocean Quest Board";
+    missions: {
+        title: "Find the moon crystal" | "Guide the lost firefly" | "Map the coral garden";
+        day: "Saturday" | "Sunday" | "School holiday";
+    }[];
+    validationMessage: "Choose a day" | "Add a mission title" | "Mission ready!";
+    savedAcrossRestart: true;
+    accessibleSummaryEnabled: true;
+}
+interface CreatureCareDashboardSafeRenderV1 {
+    kind: "creature-care-dashboard";
+    creature: "Moon Moth" | "Cloud Cat" | "Pebble Dragon";
+    status: "Resting" | "Ready to play" | "Snack time";
+    timerSeconds: 5 | 10 | 15;
+    layout: "single" | "cosy-grid" | "wide-grid";
+    reducedMotion: true;
+}
+interface RobotMissionControlSafeRenderV1 {
+    kind: "robot-mission-control";
+    command: "scan" | "hold-position" | "return-to-base";
+    safetyConfirmed: true;
+    telemetryRate: 1 | 2 | 4;
+    chartMode: "line" | "bars" | "text-only";
+    serialSimulation: true;
+    state: "SCANNING" | "HOLDING" | "RETURNING";
+}
+/** The complete public render allow-list. Learner source is never a render model. */
+type StaticProjectSafeRenderV1 = AdventureMissionPlannerSafeRenderV1 | CreatureCareDashboardSafeRenderV1 | RobotMissionControlSafeRenderV1;
+/** Immutable private snapshot awaiting an adult's exact-hash approval. */
+interface StaticProjectSnapshotV1 {
+    schemaVersion: "1";
+    contractVersion: typeof STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1;
+    snapshotId: string;
+    subjectAccountId: string;
+    moduleId: string;
+    moduleSlug: StaticProjectModuleSlugV1;
+    moduleVersion: string;
+    missionId: string;
+    sourceDigest: string;
+    snapshotDigest: string;
+    sourceCharacterCount: number;
+    assessmentScore: number;
+    mandatorySafetyPassed: true;
+    scan: StaticProjectSafetyScanV1;
+    renderModel: StaticProjectSafeRenderV1;
+    state: "pending-review";
+    createdAt: string;
+}
+/** Adult approval is evidence only and cannot mutate the reviewed snapshot. */
+interface StaticProjectGuardianApprovalV1 {
+    schemaVersion: "1";
+    approvalId: string;
+    snapshotId: string;
+    snapshotDigest: string;
+    guardianActorAccountId: string;
+    statementVersion: typeof STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1;
+    approvedAt: string;
+}
+/** An unlisted public pointer whose lifecycle never changes the source snapshot. */
+interface StaticProjectPublicationV1 {
+    schemaVersion: "1";
+    publicationId: string;
+    snapshotId: string;
+    snapshotDigest: string;
+    approvalId: string;
+    randomSlug: string;
+    publicUrl: string;
+    state: "published" | "expired" | "unpublished";
+    publishedAt: string;
+    expiresAt: string;
+    renewedAt?: string;
+    unpublishedAt?: string;
+}
+type StaticProjectContractIssueV1 = "invalid-schema-version" | "invalid-contract-version" | "invalid-identifier" | "invalid-module" | "invalid-version" | "invalid-source-digest" | "invalid-snapshot-digest" | "invalid-source-size" | "assessment-score-incomplete" | "mandatory-safety-missing" | "scan-not-passed" | "scan-checks-incomplete" | "module-render-model-mismatch" | "unsafe-render-model" | "invalid-created-at" | "invalid-approval-statement" | "invalid-approved-at" | "invalid-random-slug" | "invalid-public-url" | "public-url-slug-mismatch" | "published-state-required" | "invalid-published-at" | "invalid-publication-expiry" | "invalid-lifecycle-timestamp";
+/** Validate a snapshot without throwing so authoring and adapters can show every issue. */
+declare function validateStaticProjectSnapshot(value: StaticProjectSnapshotV1): StaticProjectContractIssueV1[];
+/** Fail closed when a persistence or publishing adapter constructs an invalid snapshot. */
+declare function assertValidStaticProjectSnapshot(value: StaticProjectSnapshotV1): void;
+declare function validateStaticProjectGuardianApproval(value: StaticProjectGuardianApprovalV1): StaticProjectContractIssueV1[];
+declare function assertValidStaticProjectGuardianApproval(value: StaticProjectGuardianApprovalV1): void;
+declare function validateStaticProjectPublication(value: StaticProjectPublicationV1): StaticProjectContractIssueV1[];
+declare function assertValidStaticProjectPublication(value: StaticProjectPublicationV1): void;
+
 /** Validate the deterministic 20/50/20/10 assessment authority. */
 declare function validateAssessmentRubric(rubric: AssessmentRubricV1, path?: string, moduleId?: string): LearningValidationIssueV1[];
 
@@ -525,4 +630,4 @@ declare function validateLearningPath(path: LearningPathVersionV1): LearningVali
 /** Fail fast when a path is not safe to publish or consume. */
 declare function assertValidLearningPath(path: LearningPathVersionV1): void;
 
-export { ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1, type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, BEACON_BOT_MISSION_ONE_AUTHORING_V1, type BadgeDefinitionV1, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CommercialStateV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, type LearnerMissionAuthoringV1, type LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningValidationIssueV1, METEOR_SHIELD_MISSION_ONE_AUTHORING_V1, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionBoundedSuggestionV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionFunctionParameterV1, type MissionFunctionReferenceV1, type MissionHardwareAcquisitionScopeV1, type MissionHardwareComponentDisclosureV1, type MissionHardwareDisclosureV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, type MissionPhysicalSafeguardsV1, type MissionReadinessCheckV1, type MissionRewardBindingV1, type MissionSideAdventureV1, type MissionStageCardV1, type MissionStageKindV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1, PADDLE_PULSE_MISSION_ONE_AUTHORING_V1, PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1, type PublishedStaticProjectSnapshotV1, RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1, RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1, ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1, SERVO_CREATURE_MISSION_ONE_AUTHORING_V1, SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1, STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1, type ScoreBandV1, VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1, VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1, VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1, assertValidLearningPath, assertValidMissionAuthoringBundle, calculateAssessment, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle };
+export { ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1, type AdventureMissionPlannerSafeRenderV1, type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, BEACON_BOT_MISSION_ONE_AUTHORING_V1, type BadgeDefinitionV1, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CommercialStateV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type CreatureCareDashboardSafeRenderV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, type LearnerMissionAuthoringV1, type LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningValidationIssueV1, METEOR_SHIELD_MISSION_ONE_AUTHORING_V1, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionBoundedSuggestionV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionFunctionParameterV1, type MissionFunctionReferenceV1, type MissionHardwareAcquisitionScopeV1, type MissionHardwareComponentDisclosureV1, type MissionHardwareDisclosureV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, type MissionPhysicalSafeguardsV1, type MissionReadinessCheckV1, type MissionRewardBindingV1, type MissionSideAdventureV1, type MissionStageCardV1, type MissionStageKindV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1, PADDLE_PULSE_MISSION_ONE_AUTHORING_V1, PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1, type PublishedStaticProjectSnapshotV1, RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1, RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1, ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1, type RobotMissionControlSafeRenderV1, 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, type ScoreBandV1, type StaticProjectContractIssueV1, type StaticProjectGuardianApprovalV1, type StaticProjectModuleSlugV1, type StaticProjectPublicationV1, type StaticProjectSafeRenderV1, type StaticProjectSafetyCheckIdV1, type StaticProjectSafetyCheckV1, type StaticProjectSafetyScanV1, type StaticProjectSnapshotV1, 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, validateStaticProjectGuardianApproval, validateStaticProjectPublication, validateStaticProjectSnapshot };

package/dist/index.js

@@ -571,6 +571,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,
@@ -6650,14 +6779,26 @@ export {
   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.js.map