feat: implement onboarding journeys

workplans/USER-WP-0013-onboarding-journeys-and-welcome-protocols.md

@@ -4,7 +4,7 @@ type: workplan
 title: "Onboarding Journeys And Welcome Protocols"
 domain: netkingdom
 repo: user-engine
-status: proposed
+status: finished
 owner: codex
 topic_slug: netkingdom
 planning_priority: medium
@@ -42,7 +42,7 @@ channels, and external task systems remain adapters or downstream systems.
 
 ```task
 id: USER-WP-0013-T1
-status: todo
+status: done
 priority: high
 state_hub_task_id: "30ef8507-eebc-4b96-8aa6-c530bef05739"
 ```
@@ -52,7 +52,7 @@ handoff models.
 
 ```task
 id: USER-WP-0013-T2
-status: todo
+status: done
 priority: high
 state_hub_task_id: "7c6e53d4-ff96-4036-a413-f04b4b73d266"
 ```
@@ -62,7 +62,7 @@ tenant, realm, service, application, role, hat, and factor requirements.
 
 ```task
 id: USER-WP-0013-T3
-status: todo
+status: done
 priority: high
 state_hub_task_id: "d9c2983a-45d1-4b1b-a416-63e180ca74b3"
 ```
@@ -72,7 +72,7 @@ with authorization, audit, and outbox behavior.
 
 ```task
 id: USER-WP-0013-T4
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "7155c2eb-4e32-46f0-ad33-961784cb9a03"
 ```
@@ -82,7 +82,7 @@ welcome callbacks, and lifecycle task linking.
 
 ```task
 id: USER-WP-0013-T5
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "c5e42dd6-207a-4b1e-a0d8-35701e9f71bc"
 ```
@@ -105,3 +105,41 @@ contracts.
 - Welcome protocol service facade.
 - Adapter ports for notifications and subsystem handoff.
 - Scenario tests for successful, blocked, and resumed onboarding.
+
+## Implementation Notes
+
+Implemented on 2026-06-15:
+
+- Added `OnboardingTriggerType`, `OnboardingJourneyStatus`,
+  `OnboardingStepStatus`, `WelcomeProtocol`, `WelcomeProtocolStep`,
+  `OnboardingJourney`, `OnboardingStep`, `OnboardingTask`, and
+  `SubsystemHandoff` domain models.
+- Added welcome-protocol and onboarding-journey persistence to
+  `UserEngineStore` and `InMemoryUserEngineStore`, including transaction
+  snapshots and record counts.
+- Added adapter ports for onboarding notifications, task links, support
+  content, subsystem welcome callbacks, and lifecycle task linking.
+- Added `UserEngineService` onboarding facade methods:
+  `register_welcome_protocol`, `list_welcome_protocols`,
+  `start_onboarding_journey`, `start_onboarding_for_registration`,
+  `start_onboarding_for_prepared_account`, `progress_onboarding_step`,
+  `complete_onboarding_step`, `skip_onboarding_step`,
+  `fail_onboarding_step`, `resume_onboarding_journey`, and
+  `onboarding_diagnostics`.
+- Added auto-start hooks for matching registration-completion protocols and
+  prepared-account claim protocols.
+- Extended `identity_context` with onboarding journeys for the resolved
+  user/tenant.
+- Added lifecycle-gap handling for missing subsystem callbacks and resumable
+  blocked/failed journey state.
+- Added `docs/onboarding-journeys-and-welcome-protocols.md`, public contract
+  updates, and tests for registration-triggered, prepared-claim-triggered,
+  blocked, resumed, progressed, skipped, and failed onboarding.
+
+Verification:
+
+```text
+make test
+Ran 66 tests in 0.620s
+OK
+```