Release 107 feedback: mobile sync, previews, and Pro cleanup

.github/workflows/ci.yml

@@ -1,6 +1,7 @@
 name: CI
 
 on:
+  workflow_dispatch:
   push:
     branches:
       - main
@@ -130,14 +131,13 @@ jobs:
           # against dependencies nobody committed. The drift it papered over was real (five packages committed to
           # shared without regenerating its lock) and is fixed at the source; if it recurs, this should stop.
           npm --prefix ../shared ci
-          # Both packages this app consumes, because npm resolves each file: dep to its dist/ (jest
-          # reads src/, but tsc and metro read dist/). rag was never built at all before.
+          # Build every shared package this app consumes, because npm resolves each file: dependency
+          # to its dist/ (Jest reads src/, but TypeScript and Metro read dist/).
           npm --prefix ../shared/packages/sync run build
           npm --prefix ../shared/packages/rag run build
-          # speech too. It is a file: dep like the other two and six src files import it, but it was
-          # never built here - so every gate failed on "Cannot find module '@offgrid/speech'" (1966
-          # errors in one run) long before it reached anything real.
+          npm --prefix ../shared/packages/models run build
           npm --prefix ../shared/packages/speech run build
+          npm --prefix ../shared/packages/ui run build
 
       - name: Install dependencies
         id: install
@@ -183,6 +183,11 @@ jobs:
 
       - name: Run Jest tests
         if: ${{ !cancelled() && steps.install.outcome == 'success' }}
+        env:
+          # The serial RN + jsdom suite retains more than Node's default 2 GB heap before
+          # coverage is written. The macOS runner has 14 GB; keep enough headroom for native
+          # tooling while allowing the complete suite to finish without weakening the gate.
+          NODE_OPTIONS: --max-old-space-size=8192
         run: npx jest --coverage --forceExit --runInBand
 
       - name: Install Android NDK

.husky/pre-push

@@ -54,7 +54,13 @@ if [ -n "$PUSHED_JS" ]; then
   npx tsc --noEmit
 
   echo "▶ JS/TS tests (related to changed files)..."
-  echo "$PUSHED_JS" | tr '\n' '\0' | xargs -0 npx jest --findRelatedTests --passWithNoTests
+  # Rendered RN journeys share native-boundary state and are memory-heavy. Parallel workers
+  # starve one another and turn normal 10-second journeys into false multi-minute timeouts.
+  # CI runs this same graph serially; keep the local merge gate deterministic too.
+  # Some React Native boundary shims keep native-style handles alive after Jest has completed every
+  # assertion. The repository's full test command already force-closes those handles. Apply the same
+  # completion policy here so a fully passing related suite does not return a false non-zero status.
+  echo "$PUSHED_JS" | tr '\n' '\0' | xargs -0 npx jest --findRelatedTests --passWithNoTests --runInBand --forceExit
 
   echo "▶ Architecture gate (dependency-cruiser)..."
   npm run depcruise

App.tsx

@@ -4,25 +4,30 @@
  */
 
 import 'react-native-gesture-handler';
-import React, { useEffect, useState, useCallback } from 'react';
+import React, { useEffect, useState, useCallback, useRef } from 'react';
 import { ActivityIndicator, View, StyleSheet, LogBox } from 'react-native';
 import { SystemBars } from 'react-native-edge-to-edge';
 import { GestureHandlerRootView } from 'react-native-gesture-handler';
 import { SafeAreaProvider } from 'react-native-safe-area-context';
 import { NavigationContainer } from '@react-navigation/native';
 import { AppNavigator } from './src/navigation';
+import {
+  appNavigationRef,
+  useProExpiryRedirect,
+} from './src/navigation/useProExpiryRedirect';
 import { useTheme } from './src/theme';
 import { hardwareService, modelManager, authService, ragService, remoteServerManager } from './src/services';
 import logger from './src/utils/logger';
 import { useAppStore, useAuthStore, useRemoteServerStore, useWhisperStore } from './src/stores';
 import { useDebugLogsStore } from './src/stores/debugLogsStore';
-import { initDebugLogFile, appendDebugLine } from './src/utils/debugLogFile';
+import { initDebugLogFile, appendDebugLine, stopDebugLogFile } from './src/utils/debugLogFile';
 import { startStartupMemoryProbe } from './src/services/startupMemoryProbe';
 import { loadProFeatures } from './src/bootstrap/loadProFeatures';
 import { hydrateDownloadStore } from './src/services/downloadHydration';
 import { initActiveDownloadPersistence } from './src/services/activeDownloadPersistence';
 import { restoreQueuedDownloads } from './src/services/restoreQueuedDownloads';
 import { startLoadPolicySync } from './src/services/loadPolicySync';
+import { startNetworkReconnectWatcher, stopNetworkReconnectWatcher } from './src/services/networkReconnect';
 import { registerCoreDownloadProviders } from './src/services/modelDownloadService/registerProviders';
 import { useDownloadListeners } from './src/hooks/useDownloads';
 import { KeyboardProvider } from 'react-native-keyboard-controller';
@@ -34,6 +39,7 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 
 LogBox.ignoreAllLogs(); // Suppress all logs
 
+let stopStartupProbe: (() => void) | null = null;
 // Dev-only: mirror logger output into the in-app Debug Logs viewer. The whole block
 // is behind __DEV__, so release builds keep main's no-op logger (zero logging cost).
 if (__DEV__) {
@@ -60,7 +66,7 @@ if (__DEV__) {
   // Immediately after the sink exists, so the first sample lands before anything heavy runs. The app
   // was being killed by iOS at launch with the log going silent half a second in; this says where it
   // stops and what memory was doing when it did.
-  startStartupMemoryProbe();
+  stopStartupProbe = startStartupMemoryProbe();
 }
 
 const ensureRemoteServerStoreHydrated = async () => {
@@ -72,12 +78,20 @@ const ensureRemoteServerStoreHydrated = async () => {
 };
 
 function App() {
+  useEffect(() => () => {
+    stopStartupProbe?.();
+    stopStartupProbe = null;
+    stopDebugLogFile();
+  }, []);
+
   useDownloadListeners();
   // Reactive: when Pro is activated at runtime (license key → loadProFeatures),
   // the appRoot slot (TTS engine bridge) registers and this re-renders to mount
   // it live — no restart needed.
   const AppRoot = useSlot(SLOTS.appRoot);
+  const applyPendingProRedirect = useProExpiryRedirect();
   const [isInitializing, setIsInitializing] = useState(true);
+  const startupGeneration = useRef(0);
   const setDeviceInfo = useAppStore((s) => s.setDeviceInfo);
   const setModelRecommendation = useAppStore((s) => s.setModelRecommendation);
   const setDownloadedModels = useAppStore((s) => s.setDownloadedModels);
@@ -205,9 +219,13 @@ function App() {
     })().catch((error) => {
       logger.error('[App] Download-state recovery failed:', error);
     });
-  }, [setDownloadedModels, setDownloadedImageModels]);
+  }, [
+    reattachTextDownloadRecovery,
+    setDownloadedModels,
+    setDownloadedImageModels,
+  ]);
 
-  const initializeApp = useCallback(async () => {
+  const initializeApp = useCallback(async (generation: number) => {
     try {
       // Ensure persisted download metadata is loaded before restore logic reads it.
       logger.log('[BOOT] app store hydrate');
@@ -258,9 +276,18 @@ function App() {
 
       // Initialize remote server providers in the background — don't block
       // the home screen while fetching models from potentially unreachable servers.
-      remoteServerManager.initializeProviders().catch((err) => {
-        logger.error('[App] Failed to initialize remote server providers:', err);
-      });
+      remoteServerManager
+        .initializeProviders()
+        .catch((err) => {
+          logger.error('[App] Failed to initialize remote server providers:', err);
+        })
+        .finally(() => {
+          if (generation !== startupGeneration.current) return;
+          // Recovery and provider initialization both update the registry and remote-server store.
+          // Start recovery only after initialization releases those owners. A failed initialization
+          // must still start the watcher so a later network recovery can repair the connection.
+          startNetworkReconnectWatcher();
+        });
 
       // Check if passphrase is set and lock app if needed
       logger.log('[BOOT] auth passphrase check');
@@ -315,7 +342,12 @@ function App() {
   ]);
 
   useEffect(() => {
-    initializeApp();
+    const generation = ++startupGeneration.current;
+    initializeApp(generation);
+    return () => {
+      startupGeneration.current += 1;
+      stopNetworkReconnectWatcher();
+    };
   }, [initializeApp]);
 
   const handleUnlock = useCallback(() => {
@@ -353,6 +385,8 @@ function App() {
         <SystemBars style={isDark ? 'light' : 'dark'} />
         {AppRoot ? <AppRoot /> : null}
         <NavigationContainer
+          ref={appNavigationRef}
+          onReady={applyPendingProRedirect}
           theme={{
             dark: isDark,
             colors: {

README.md

@@ -50,7 +50,7 @@ Pro is an optional, additive tier. It gives the assistant a voice that talks bac
 - **Voice mode** - the free app transcribes your speech; Pro adds on-device Kokoro text-to-speech, so it talks back and you run the whole thing hands-free. The voice runs in your phone's RAM.
 - **Custom personas** - give each assistant its own system prompt, voice, and persistent memory, so it stays in character across conversations.
 - **Draft, then approve** - connect Calendar, email, and MCP servers like Linear, Notion, and GitHub. It drafts the reply or files the ticket and waits. Nothing sends without your tap.
-- **Sync, landing through July** - your phone and your Mac merge into one picture over your own network, never a relay. Your license includes it the day it ships.
+- **Personal Mesh sync** - your phone and your Mac share chats, files, and settings over your own network. There is no relay. See the [Personal Mesh guide](docs/PERSONAL_MESH.md).
 
 **[→ Get Pro access](https://offgridmobileai.co/pay/)** - $69 once and it is yours forever (the price climbs as more people join, never down), or $49/year.
 
@@ -95,7 +95,7 @@ Most "local LLM" apps give you a text chatbot and call it a day. Off Grid AI is
 
 **Vision AI** — Point your camera at anything and ask questions. SmolVLM, Qwen3-VL, Gemma 3n — analyze documents, describe scenes, read receipts. ~7s on flagship devices.
 
-**Voice Input** — On-device Whisper speech-to-text. Hold to record, auto-transcribe. No audio ever leaves your phone.
+**Voice Input** - On-device Whisper speech-to-text. Tap the microphone to start and stop, or use Auto and Hands-free modes. No audio ever leaves your phone.
 
 **Document Analysis** — Attach PDFs, code files, CSVs, and more to your conversations. Native PDF text extraction on both platforms.
 

__tests__/App.test.tsx

@@ -69,6 +69,8 @@ const mockModelManager = {
   refreshModelLists: jest.fn(() => Promise.resolve({ textModels: [], imageModels: [] })),
   watchDownload: jest.fn(),
 };
+const mockInitializeProviders = jest.fn(() => Promise.resolve());
+const mockStartNetworkReconnectWatcher = jest.fn();
 
 jest.mock('../src/navigation', () => ({
   AppNavigator: () => null,
@@ -135,9 +137,14 @@ jest.mock('../src/hooks/useDownloads', () => ({
 jest.mock('../src/services/loadPolicySync', () => ({
   startLoadPolicySync: jest.fn(() => jest.fn()),
 }));
+jest.mock('../src/services/networkReconnect', () => ({
+  startNetworkReconnectWatcher: mockStartNetworkReconnectWatcher,
+  stopNetworkReconnectWatcher: jest.fn(),
+}));
 jest.mock('../src/utils/debugLogFile', () => ({
   initDebugLogFile: jest.fn(),
   appendDebugLine: jest.fn(),
+  stopDebugLogFile: jest.fn(),
 }));
 
 jest.mock('../src/services', () => ({
@@ -153,7 +160,7 @@ jest.mock('../src/services', () => ({
     ensureReady: jest.fn(() => Promise.resolve()),
   },
   remoteServerManager: {
-    initializeProviders: jest.fn(() => Promise.resolve()),
+    initializeProviders: mockInitializeProviders,
   },
 }));
 
@@ -167,12 +174,14 @@ jest.mock('../src/services', () => ({
 describe('App', () => {
   beforeEach(() => {
     jest.clearAllMocks();
+    mockInitializeProviders.mockResolvedValue(undefined);
   });
 
   it('restores in-flight downloads at startup and watches each to completion', async () => {
     const App = require('../App').default;
+    let renderer: ReactTestRenderer.ReactTestRenderer;
     await ReactTestRenderer.act(async () => {
-      ReactTestRenderer.create(<App />);
+      renderer = ReactTestRenderer.create(<App />);
       // Flush the async startup chain (hydrate → reattach → restore → watch).
       for (let i = 0; i < 20; i++) await Promise.resolve();
     });
@@ -188,5 +197,59 @@ describe('App', () => {
       expect.any(Function),
       expect.any(Function),
     );
+    await ReactTestRenderer.act(async () => {
+      renderer!.unmount();
+    });
+  });
+
+  it('starts reconnect recovery only after remote provider initialization settles', async () => {
+    let finishInitialization: (() => void) | undefined;
+    mockInitializeProviders.mockImplementationOnce(() => new Promise<void>((resolve) => {
+      finishInitialization = resolve;
+    }));
+
+    const App = require('../App').default;
+    let renderer: ReactTestRenderer.ReactTestRenderer;
+    await ReactTestRenderer.act(async () => {
+      renderer = ReactTestRenderer.create(<App />);
+      for (let i = 0; i < 20; i++) await Promise.resolve();
+    });
+
+    expect(mockInitializeProviders).toHaveBeenCalledTimes(1);
+    expect(mockStartNetworkReconnectWatcher).not.toHaveBeenCalled();
+
+    await ReactTestRenderer.act(async () => {
+      finishInitialization?.();
+      await Promise.resolve();
+    });
+
+    expect(mockStartNetworkReconnectWatcher).toHaveBeenCalledTimes(1);
+    await ReactTestRenderer.act(async () => {
+      renderer!.unmount();
+    });
+  });
+
+  it('does not start reconnect recovery when provider initialization settles after unmount', async () => {
+    let finishInitialization: (() => void) | undefined;
+    mockInitializeProviders.mockImplementationOnce(() => new Promise<void>((resolve) => {
+      finishInitialization = resolve;
+    }));
+
+    const App = require('../App').default;
+    let renderer: ReactTestRenderer.ReactTestRenderer;
+    await ReactTestRenderer.act(async () => {
+      renderer = ReactTestRenderer.create(<App />);
+      for (let i = 0; i < 20; i++) await Promise.resolve();
+    });
+
+    await ReactTestRenderer.act(async () => {
+      renderer!.unmount();
+    });
+    await ReactTestRenderer.act(async () => {
+      finishInitialization?.();
+      await Promise.resolve();
+    });
+
+    expect(mockStartNetworkReconnectWatcher).not.toHaveBeenCalled();
   });
 });