@plasius/learning 0.2.25 → 0.4.0

package/README.md

@@ -42,6 +42,47 @@ exact `PADDLE_PULSE_MODULE_V2` export, schema `2` and canonical SHA-256 digest
 without importing the package. Paddle Pulse `1.1.0` and its mission-authoring
 export remain available unchanged.
 
+## Complete course and account-save contracts
+
+Complete learner curricula are separate lazy entry points. Import
+`{ course, practice }` from `@plasius/learning/courses/robot-maze-dash` for the
+Robot Maze `2.0.0` course: six distinct missions, 54 guided activities, a bounded
+visual starter project, function references, formative concept checks, debugging
+guidance and extensions. Formative answers are learner-safe teaching material;
+they are not protected runtime assessments or completion authority. Hosts verify
+responses, run protected checks and persist evidence independently.
+The root exports `CoursePracticeQuestion` as a type without importing lesson data.
+
+The runtime is supplied separately by `@plasius/learning-runtime`; this package
+does not execute the project or declare host readiness. The seventeen-course
+programme remains in development. This additive content does not alter immutable
+catalogue/pricing records or enable a public host rollout. New hosts compose
+their existing access controls with an independently disabled complete-course
+flag and must validate the full learner journey before enabling it.
+
+`LearningCourseV1` defines six missions with nine activities each, editable project
+files, learner guidance and a capstone assessment identifier. Use
+`validateLearningCourse` or `parseLearningCourse` for publication and loading.
+Structural validity is only one acceptance gate; authored content, working runtime
+and learner-journey evidence must also be verified for each course.
+
+`parseLearningCourseDraft` accepts only the declared project files, content version
+and navigation. It rejects account identifiers, scores, completion and evidence.
+`parseLearningSaveSlotId` accepts `auto` and manual slots `1`–`9`. Source limits are
+64,000 characters per file and 96,000 total across at most eight declared files.
+
+The pure progression functions `createLearningCourseProgress`,
+`completeVerifiedLearningActivity`, `recordLearningCourseAssessment`,
+`parseLearningCourseProgress` and `resolveLearningCourseStage` support host-owned
+state. They are **not browser mutation DTOs**. Hosts validate each activity, run
+protected deterministic checks, bind source digests and references to the signed-in
+account, and supply conditional/idempotent storage. Repair/reward need passing
+current-source evidence; completion additionally needs a passing capstone after
+all six missions. Loading a project cannot restore or manufacture progress.
+
+These contracts do not supply the seventeen full course implementations, execute
+learner code, save records or grant access. See [ADR 0009](docs/adrs/adr-0009-complete-course-project-and-progress-contracts.md).
+
 ## Install
 
 ```bash