feat(desktop): persist onboarding state with --force-onboarding flag

Use Zustand persist middleware with localStorage to remember onboarding
completion across app restarts. Only the completed flag is persisted;
transient UI state resets each launch. Add --force-onboarding CLI flag
to re-show onboarding even when already completed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

apps/desktop/src/renderer/src/App.tsx

@@ -1,3 +1,4 @@
+import { useEffect } from 'react'
 import { createHashRouter, Navigate, RouterProvider } from 'react-router-dom'
 import Layout from './pages/layout'
 import HomePage from './pages/home'
@@ -15,7 +16,8 @@ import { useOnboardingStore } from './stores/onboarding'
 
 function OnboardingGuard({ children }: { children: React.ReactNode }) {
   const completed = useOnboardingStore((s) => s.completed)
-  if (!completed) return <Navigate to="/onboarding" replace />
+  const forceOnboarding = useOnboardingStore((s) => s.forceOnboarding)
+  if (!completed || forceOnboarding) return <Navigate to="/onboarding" replace />
   return <>{children}</>
 }
 
@@ -52,5 +54,9 @@ const router = createHashRouter([
 ])
 
 export default function App() {
+  useEffect(() => {
+    useOnboardingStore.getState().initForceFlag()
+  }, [])
+
   return <RouterProvider router={router} />
 }

apps/desktop/src/renderer/src/stores/onboarding.ts

@@ -1,4 +1,5 @@
 import { create } from "zustand"
+import { persist } from "zustand/middleware"
 
 interface AcknowledgementsState {
   fileSystem: boolean
@@ -9,6 +10,7 @@ interface AcknowledgementsState {
 
 interface OnboardingStore {
   completed: boolean
+  forceOnboarding: boolean
   acknowledgements: AcknowledgementsState
   allAcknowledged: boolean
   providerConfigured: boolean
@@ -17,30 +19,47 @@ interface OnboardingStore {
   setProviderConfigured: (configured: boolean) => void
   setClientConnected: (connected: boolean) => void
   completeOnboarding: () => void
+  initForceFlag: () => Promise<void>
 }
 
-export const useOnboardingStore = create<OnboardingStore>((set, get) => ({
-  completed: false,
+export const useOnboardingStore = create<OnboardingStore>()(
+  persist(
+    (set, get) => ({
+      completed: false,
+      forceOnboarding: false,
 
-  acknowledgements: {
-    fileSystem: false,
-    shellExecution: false,
-    llmRequests: false,
-    localStorage: false,
-  },
-  allAcknowledged: false,
-  providerConfigured: false,
-  clientConnected: false,
+      acknowledgements: {
+        fileSystem: false,
+        shellExecution: false,
+        llmRequests: false,
+        localStorage: false,
+      },
+      allAcknowledged: false,
+      providerConfigured: false,
+      clientConnected: false,
 
-  setAcknowledgement: (key, value) => {
-    const acknowledgements = { ...get().acknowledgements, [key]: value }
-    const allAcknowledged = Object.values(acknowledgements).every(Boolean)
-    set({ acknowledgements, allAcknowledged })
-  },
+      setAcknowledgement: (key, value) => {
+        const acknowledgements = { ...get().acknowledgements, [key]: value }
+        const allAcknowledged = Object.values(acknowledgements).every(Boolean)
+        set({ acknowledgements, allAcknowledged })
+      },
 
-  setProviderConfigured: (configured) => set({ providerConfigured: configured }),
+      setProviderConfigured: (configured) => set({ providerConfigured: configured }),
 
-  setClientConnected: (connected) => set({ clientConnected: connected }),
+      setClientConnected: (connected) => set({ clientConnected: connected }),
 
-  completeOnboarding: () => set({ completed: true }),
-}))
+      completeOnboarding: () => set({ completed: true }),
+
+      initForceFlag: async () => {
+        const flags = await window.electronAPI.app.getFlags()
+        if (flags.forceOnboarding) {
+          set({ forceOnboarding: true })
+        }
+      },
+    }),
+    {
+      name: 'multica-onboarding',
+      partialize: (state) => ({ completed: state.completed }),
+    }
+  )
+)