feat: add Atlas native app UX overhaul

Docs/Sequence/execute-flow.md

@@ -0,0 +1,21 @@
+# Execute Flow
+
+## Actors
+
+- User
+- AtlasApp
+- AtlasWorkerClient
+- AtlasWorkerXPC
+- AtlasPrivilegedHelper
+- AtlasStore
+
+## Sequence
+
+1. User previews a plan and confirms execution.
+2. App sends `task.execute`.
+3. Worker splits actions into privileged and non-privileged work.
+4. Worker performs non-privileged actions directly.
+5. Worker submits allowlisted privileged actions to helper when needed.
+6. Worker streams progress, warnings, and per-item results.
+7. Worker persists task result and recoverable items.
+8. App renders a result page with success, warnings, and recovery actions.

Docs/Sequence/restore-flow.md

@@ -0,0 +1,19 @@
+# Restore Flow
+
+## Actors
+
+- User
+- AtlasApp
+- AtlasWorkerClient
+- AtlasWorkerXPC
+- AtlasPrivilegedHelper
+- AtlasStore
+
+## Sequence
+
+1. User selects one or more recovery items.
+2. App sends `recovery.restore`.
+3. Worker validates recovery windows and target conflicts.
+4. Worker restores items directly or via helper when required.
+5. Worker persists restore result and updates recovery status.
+6. App renders restored, failed, or expired outcomes.

Docs/Sequence/scan-flow.md

@@ -0,0 +1,21 @@
+# Scan Flow
+
+## Actors
+
+- User
+- AtlasApp
+- AtlasWorkerClient
+- AtlasWorkerXPC
+- AtlasCoreAdapters
+- AtlasStore
+
+## Sequence
+
+1. User starts a scan.
+2. App sends `scan.start`.
+3. Worker validates scope and permissions.
+4. Worker invokes one or more adapters.
+5. Worker streams progress events.
+6. Worker aggregates findings and summary.
+7. Worker persists scan summary.
+8. App renders grouped findings or a limited-results banner.