@plasius/learning 0.2.0 → 0.2.1

package/dist/index.d.ts

@@ -218,6 +218,103 @@ interface PublishedStaticProjectSnapshotV1 {
     state: "pending-review" | "published" | "expired" | "unpublished";
     expiresAt: string;
 }
+/** Canonical learner journey shared by interactive and printable adapters. */
+declare const MISSION_AUTHORING_CONTRACT_VERSION_V1: "1.0.0";
+type MissionStageKindV1 = "learn" | "predict" | "build" | "run" | "assess" | "inspect" | "fix" | "explain" | "reward";
+type MissionArtifactKindV1 = "starter-code" | "starter-assets" | "sample-data" | "printable" | "facilitator-note" | "answer-key" | "protected-test";
+/** Metadata only: storage and authorized delivery remain adapter concerns. */
+interface MissionArtifactReferenceV1 {
+    id: string;
+    kind: MissionArtifactKindV1;
+    audience: CourseMaterialAudienceV1;
+    solutionBearing: boolean;
+}
+interface MissionReadinessCheckV1 {
+    id: string;
+    prompt: string;
+    scored: false;
+}
+interface MissionStageCardV1 {
+    kind: MissionStageKindV1;
+    instruction: string;
+    artifactIds: string[];
+}
+interface MissionAuthoringGoalV1 {
+    id: string;
+    statement: string;
+    visibility: "visible" | "protected";
+    criterionIds: string[];
+    completionRequired: boolean;
+    aiRequired: boolean;
+}
+type MissionInteractionModeV1 = "keyboard" | "pointer" | "drag" | "audio" | "colour" | "motion" | "text" | "shape" | "symbol" | "reduced-motion";
+interface MissionInteractionRequirementV1 {
+    id: string;
+    description: string;
+    primaryMode: MissionInteractionModeV1;
+    alternativeIds: string[];
+}
+interface MissionAccessibilityAlternativeV1 {
+    id: string;
+    modes: MissionInteractionModeV1[];
+    equivalentOutcome: true;
+    description: string;
+}
+type MissionEvidenceKindV1 = "assessment-result" | "learner-explanation" | "project-snapshot" | "adult-signoff";
+type MissionEvidenceRetentionV1 = "attempt" | "entitlement" | "adult-signoff";
+interface MissionEvidenceRequirementV1 {
+    id: string;
+    goalIds: string[];
+    kind: MissionEvidenceKindV1;
+    retention: MissionEvidenceRetentionV1;
+    containsPersonalData: false;
+}
+interface MissionSideAdventureV1 {
+    id: string;
+    prompt: string;
+    completionRequired: false;
+}
+interface MissionRewardBindingV1 {
+    id: string;
+    badgeId: string;
+    goalIds: string[];
+    deterministic: true;
+    random: false;
+    tokenConvertible: false;
+}
+/** The only mission projection safe to return to a learner. */
+interface LearnerMissionAuthoringV1 {
+    estimatedMinutes: number;
+    stages: MissionStageCardV1[];
+    readinessChecks: MissionReadinessCheckV1[];
+    artifacts: MissionArtifactReferenceV1[];
+    goals: MissionAuthoringGoalV1[];
+    interactions: MissionInteractionRequirementV1[];
+    accessibilityAlternatives: MissionAccessibilityAlternativeV1[];
+    evidenceRequirements: MissionEvidenceRequirementV1[];
+    sideAdventures: MissionSideAdventureV1[];
+    rewardBindings: MissionRewardBindingV1[];
+}
+/** Protected authoring data must never be projected through learner APIs. */
+interface FacilitatorMissionAuthoringV1 {
+    artifacts: MissionArtifactReferenceV1[];
+    protectedGoals: MissionAuthoringGoalV1[];
+    prompts: string[];
+}
+/** Additive authoring detail keyed to one immutable catalog mission. */
+interface MissionAuthoringBundleV1 {
+    version: string;
+    moduleId: string;
+    moduleVersion: string;
+    missionId: string;
+    learner: LearnerMissionAuthoringV1;
+    facilitator: FacilitatorMissionAuthoringV1;
+}
+interface MissionAuthoringValidationIssueV1 {
+    code: "bundle-version-mismatch" | "module-reference-mismatch" | "mission-reference-mismatch" | "invalid-duration" | "missing-stage" | "duplicate-stage" | "stage-order" | "missing-readiness-check" | "scored-readiness-check" | "missing-starter-artifact" | "learner-artifact-leak" | "facilitator-artifact-leak" | "unknown-artifact" | "duplicate-id" | "missing-visible-goal" | "missing-protected-goal" | "invalid-goal-projection" | "duplicate-goal-id" | "unknown-criterion" | "criterion-visibility-mismatch" | "rubric-total" | "rubric-dimension-total" | "duplicate-criterion-id" | "missing-mandatory-safety" | "missing-safety-evidence" | "ai-dependent-completion" | "inaccessible-interaction" | "unknown-accessibility-alternative" | "non-equivalent-accessibility-alternative" | "missing-evidence" | "unknown-evidence-goal" | "personal-data-evidence" | "missing-side-adventure" | "mandatory-side-adventure" | "invalid-reward";
+    message: string;
+    path: string;
+}
 interface LearningValidationIssueV1 {
     code: "duplicate-module-id" | "duplicate-module-slug" | "module-not-self-contained" | "paid-prerequisite" | "missing-materials" | "facilitator-material-leak" | "learner-material-leak" | "invalid-token-subunits" | "invalid-reference-price" | "rubric-total" | "rubric-dimension-total" | "duplicate-criterion-id" | "missing-mandatory-safety" | "missing-hardware-items" | "invalid-agent-authority" | "missing-missions";
     message: string;
@@ -259,9 +356,23 @@ 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;
 
+/** Validate the deterministic 20/50/20/10 assessment authority. */
+declare function validateAssessmentRubric(rubric: AssessmentRubricV1, path?: string, moduleId?: string): LearningValidationIssueV1[];
+
+declare const JUNIOR_CODER_MISSION_STAGE_ORDER_V1: readonly ["learn", "predict", "build", "run", "assess", "inspect", "fix", "explain", "reward"];
+/**
+ * Validate learner/facilitator authoring against one immutable catalog module.
+ * The complete issue set is returned so authoring tools can fix errors in one pass.
+ */
+declare function validateMissionAuthoringBundle(bundle: MissionAuthoringBundleV1, module: LearningModuleVersionV1): MissionAuthoringValidationIssueV1[];
+/** Fail fast for CI and immutable authoring registration. */
+declare function assertValidMissionAuthoringBundle(bundle: MissionAuthoringBundleV1, module: LearningModuleVersionV1): void;
+/** Original first-mission exemplar; no protected content appears in learner data. */
+declare const ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1: MissionAuthoringBundleV1;
+
 /** Return every catalog issue without throwing, suitable for authoring tools. */
 declare function validateLearningPath(path: LearningPathVersionV1): LearningValidationIssueV1[];
 /** Fail fast when a path is not safe to publish or consume. */
 declare function assertValidLearningPath(path: LearningPathVersionV1): void;
 
-export { type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, type BadgeDefinitionV1, type CommercialStateV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type GuardianAiConsentV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, 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 LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningValidationIssueV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, type PublishedStaticProjectSnapshotV1, type ScoreBandV1, assertValidLearningPath, calculateAssessment, validateLearningPath };
+export { type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, type BadgeDefinitionV1, type CommercialStateV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, 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, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, 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, type PublishedStaticProjectSnapshotV1, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, type ScoreBandV1, assertValidLearningPath, assertValidMissionAuthoringBundle, calculateAssessment, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle };