🔧 Fix GitHub Actions docs workflow

- Update mkdocs dependencies to latest versions
- Add permissions for GitHub Pages deployment
- Add workflow_dispatch for manual trigger
- Fix build command with fallback

site/foundation/helpers/onboarding-flow-diagram.mermaid

@@ -0,0 +1,18 @@
+```mermaid
+flowchart TD
+  A[User visits DAARION.city] --> B{Login method}
+  B -->|Email OTP| C[Create/Activate DAIS Identity]
+  B -->|Magic Link| C
+  B -->|Web3 Wallet (SIWE)| C
+  C --> D[Create Agent (home_microdao = DAARION)]
+  D --> E[Agent Console]
+  E --> F{Become Orchestrator?}
+  F -->|Yes| G[Check Access Conditions (wallet, tokens)]
+  G -->|Pass| H[agent.promoted_to_orchestrator]
+  H --> I[MicroDAO Creation Wizard]
+  I --> J[microdao.created]
+  J --> K[NODE REGISTRATION]
+  K --> L[node.registered]
+  L --> M[MicroDAO Operational]
+```
+