# Personal workflows, learning and progress Compose subject-controlled personal workflows and learning experiences with explicit consent, replay and progress semantics. Source snapshot: bcc79fcc27c4d801c2119bef81ddcce7b4e86498 ## Bind a personal action to its subject PersonalOS runtime supplies pure authority, autonomy, immutable-event replay and rights primitives. Hosts provide verified identity, clocks, encryption, audit, durable stores and effects. The documented transaction seam binds the command, receipt, event, encrypted snapshot, idempotency result and outbox together. Browser-safe command builders accept exact host-supplied context and preserve the declared policy. Constructing a household delegation or a personal plan does not authorize the new command through its own proposed state. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md ## Choose learning and progress responsibilities LearningJourney provides onboarding, drills, coaching and adaptive journey composition. Existing progress adapters preserve the Date-bearing journey state when crossing into the storage-neutral GamificationRuntime. Gamification evaluates explicit activities, cadence slots, streaks, capped XP and replay using supplied timestamps and participant references. Keep these semantics visible when migrating a learning product: converting storage shapes should not silently change timezone, rounding, recurrence or the meaning of a completed lesson. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md ## Preserve privacy and source meaning Personal domain packages include household, productivity, finance and health responsibilities. Their source scopes should guide what a composed product may expose. The health runtime, for example, requires explicit consent and preserves units, timestamps, source provenance and paginated sync checkpoints; conflicting provider observations remain separate evidence. Such behavior is a data-lifecycle contract, not a clinical interpretation. Product and agent projections should reveal only what the exact subject and current grant permit, including after revocation or a changed connection. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md ## Trace one personal journey Follow a plan, household or consent action from trusted subject input through command construction, transaction and projection. Identify which records support retry and which data is visible to another actor. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md ## Inspect progress conversion Choose an existing learning journey and follow its progress through serialization and the gamification adapter. Compare recurrence boundaries and repeated activities in the maintained tests before changing the stored representation. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md ## Review a withdrawn grant Inspect the rights and consent path when a participant revokes access or a source connection changes. Check that derived projections, assistant context and queued work use the new authority state rather than a previously cached permission. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md ## Packages - [@lssm-tech/integration.personal-os-authos](https://lssm.co/docs/packages/integration.personal-os-authos/): Fail-closed AuthOS and Better Auth session bridge for PersonalOS. - [@lssm-tech/integration.personal-os-state-postgres](https://lssm.co/docs/packages/integration.personal-os-state-postgres/): Subject-bound PostgreSQL event, encrypted projection, rights, and outbox persistence for PersonalOS. - [@lssm-tech/bundle.personal-os](https://lssm.co/docs/packages/bundle.personal-os/): Evidence-scored PersonalOS product composition and requirements coverage. - [@lssm-tech/module.gamification](https://lssm.co/docs/packages/module.gamification/): Reusable gamification projections and theme-aware React surfaces over the canonical gamification runtime. - [@lssm-tech/lib.gamification-runtime](https://lssm.co/docs/packages/lib.gamification-runtime/): Deterministic storage-neutral gamification evaluation and replay runtime. - [@lssm-tech/lib.gamification-spec](https://lssm.co/docs/packages/lib.gamification-spec/): Portable cross-vertical gamification campaign contracts and validation. - [@lssm-tech/module.learning-journey](https://lssm.co/docs/packages/module.learning-journey/): Comprehensive learning journey engine - onboarding, LMS, flashcards, gamification, and AI personalization - [@lssm-tech/module.personal-experience](https://lssm.co/docs/packages/module.personal-experience/): Authority-first RoleMorph and reversible Personalization composition for PersonalOS surfaces. - [@lssm-tech/module.personal-community](https://lssm.co/docs/packages/module.personal-community/): Subject-bound, consent-controlled HCircle community domain runtime. - [@lssm-tech/module.personal-founder-support](https://lssm.co/docs/packages/module.personal-founder-support/): Consent-bound founder-private cockpit and Pactena handoff runtime for PersonalOS. - [@lssm-tech/module.personal-goals](https://lssm.co/docs/packages/module.personal-goals/): Pure PersonalOS mission, goals, outcomes, and observed-metrics runtime. - [@lssm-tech/module.personal-household](https://lssm.co/docs/packages/module.personal-household/): Pure PersonalOS household membership, delegation, and revocation runtime. - [@lssm-tech/module.personal-learning](https://lssm.co/docs/packages/module.personal-learning/): Consent-bound PersonalOS learning adapter and reversible coaching runtime. - [@lssm-tech/module.personal-life-admin](https://lssm.co/docs/packages/module.personal-life-admin/): Subject-bound PersonalOS life administration and personal knowledge runtime. - [@lssm-tech/module.personal-operations](https://lssm.co/docs/packages/module.personal-operations/): Fail-closed PersonalOS performance, capacity, release, rollback, and support controls. - [@lssm-tech/module.personal-productivity](https://lssm.co/docs/packages/module.personal-productivity/): Pure PersonalOS Today planning, habits, recovery, review, and capacity runtime. - [@lssm-tech/lib.personal-os-runtime](https://lssm.co/docs/packages/lib.personal-os-runtime/): Pure fail-closed PersonalOS authority, replay, projection, and rights runtime. - [@lssm-tech/lib.personal-os-spec](https://lssm.co/docs/packages/lib.personal-os-spec/): Consent-aware personal mission, agency goal, and projection contracts for LSSM OS. - [@lssm-tech/module.personal-finance](https://lssm.co/docs/packages/module.personal-finance/): Subject-bound, non-advisory PersonalOS pocket family-office module. - [@lssm-tech/lib.personal-finance-runtime](https://lssm.co/docs/packages/lib.personal-finance-runtime/): Pure fail-closed PersonalOS finance runtime. - [@lssm-tech/lib.personal-finance-spec](https://lssm.co/docs/packages/lib.personal-finance-spec/): Subject-bound, provenance-first, non-advisory PersonalOS finance contracts. - [@lssm-tech/module.personal-health](https://lssm.co/docs/packages/module.personal-health/): Subject-bound non-clinical PersonalOS health ledger orchestration. - [@lssm-tech/lib.personal-health-runtime](https://lssm.co/docs/packages/lib.personal-health-runtime/): Pure PersonalOS health authorization, normalization, reconciliation, and sync runtime. - [@lssm-tech/lib.personal-health-spec](https://lssm.co/docs/packages/lib.personal-health-spec/): Consent, provenance, safety, sharing, and rights contracts for non-clinical PersonalOS health data. - [@lssm-tech/app.personalos-api](https://lssm.co/docs/packages/app.personalos-api/): Inspect the package guide, declared imports and source relationships. - [@lssm-tech/app.personalos-desktop](https://lssm.co/docs/packages/app.personalos-desktop/): Premium Tauri 2 desktop shell for PersonalOS. - [@lssm-tech/app.personalos-mobile](https://lssm.co/docs/packages/app.personalos-mobile/): Premium Expo Router iOS and Android shell for PersonalOS. - [@lssm-tech/app.personalos-web](https://lssm.co/docs/packages/app.personalos-web/): Private, accessible Next.js and PWA shell for PersonalOS. - [@lssm-tech/app.personalos-worker](https://lssm.co/docs/packages/app.personalos-worker/): Inspect the package guide, declared imports and source relationships.