feat(recorder): on-device recorder host + whisper transcription + chat/RAG

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "pro"]
 	path = pro
-	url = https://github.com/wednesday-solutions/offgrid-pro.git
+	url = https://github.com/off-grid-ai/mobile-pro.git

__tests__/rntl/navigation/AppNavigator.test.tsx

@@ -186,7 +186,7 @@ describe('AppNavigator', () => {
       expect(getAllByText('Chats').length).toBeGreaterThanOrEqual(1);
       expect(getAllByText('Projects').length).toBeGreaterThanOrEqual(1);
       expect(getAllByText('Models').length).toBeGreaterThanOrEqual(1);
-      expect(getAllByText('Settings').length).toBeGreaterThanOrEqual(1);
+      expect(getAllByText('Recorder').length).toBeGreaterThanOrEqual(1);
     });
 
     it('renders all tab buttons with testIDs', () => {
@@ -196,7 +196,7 @@ describe('AppNavigator', () => {
       expect(getByTestId('chats-tab')).toBeTruthy();
       expect(getByTestId('projects-tab')).toBeTruthy();
       expect(getByTestId('models-tab')).toBeTruthy();
-      expect(getByTestId('settings-tab')).toBeTruthy();
+      expect(getByTestId('recorder-tab')).toBeTruthy();
     });
   });
 
@@ -279,14 +279,14 @@ describe('AppNavigator', () => {
       expect(getAllByText('Chats').length).toBeGreaterThanOrEqual(1);
       expect(getAllByText('Projects').length).toBeGreaterThanOrEqual(1);
       expect(getAllByText('Models').length).toBeGreaterThanOrEqual(1);
-      expect(getAllByText('Settings').length).toBeGreaterThanOrEqual(1);
+      expect(getAllByText('Recorder').length).toBeGreaterThanOrEqual(1);
 
       // All tab buttons should be pressable
       expect(getByTestId('home-tab')).toBeTruthy();
       expect(getByTestId('chats-tab')).toBeTruthy();
       expect(getByTestId('projects-tab')).toBeTruthy();
       expect(getByTestId('models-tab')).toBeTruthy();
-      expect(getByTestId('settings-tab')).toBeTruthy();
+      expect(getByTestId('recorder-tab')).toBeTruthy();
     });
   });
 });

__tests__/rntl/onboarding/HomeScreenSpotlight.test.tsx

@@ -299,15 +299,15 @@ describe('HomeScreen Spotlight Integration', () => {
   // Flow 5: Explore Settings
   // ========================================================================
   describe('Flow 5: exploredSettings', () => {
-    it('queues pending spotlight 6, navigates to SettingsTab, fires goTo(5)', () => {
+    it('queues pending spotlight 6, navigates to Settings, fires goTo(5)', () => {
       const { getByTestId } = renderHomeScreen();
 
       act(() => {
         fireEvent.press(getByTestId('step-exploredSettings'));
       });
 
       expect(peekPendingSpotlight()).toBe(6);
-      expect(mockNavigate).toHaveBeenCalledWith('SettingsTab');
+      expect(mockNavigate).toHaveBeenCalledWith('Settings');
 
       act(() => { jest.advanceTimersByTime(800); });
       expect(mockGoTo).toHaveBeenCalledWith(5);

__tests__/unit/onboarding/handleStepPress.test.ts

@@ -307,9 +307,9 @@ describe('handleStepPress', () => {
       expect(peekPendingSpotlight()).toBe(6);
     });
 
-    it('navigates to SettingsTab', () => {
+    it('navigates to Settings', () => {
       simulateHandleStepPress('exploredSettings', callbacks());
-      expect(navigate).toHaveBeenCalledWith('SettingsTab');
+      expect(navigate).toHaveBeenCalledWith('Settings');
     });
 
     it('fires goTo(5) after delay', () => {

__tests__/unit/onboarding/onboardingFlows.test.ts

@@ -80,7 +80,7 @@ describe('Onboarding Flows', () => {
         downloadedModel: 'ModelsTab',
         loadedModel: 'HomeTab',
         sentMessage: 'ChatsTab',
-        exploredSettings: 'SettingsTab',
+        exploredSettings: 'Settings',
         createdProject: 'ProjectsTab',
         triedImageGen: 'ModelsTab',
       });

__tests__/unit/services/generationToolLoop.branches.test.ts

@@ -354,21 +354,31 @@ describe('runToolLoop — LiteRT loop branches', () => {
 describe('runToolLoop — precise date/time context for calendar tools', () => {
   beforeEach(resetMocks);
 
-  it('augments the system prompt with a precise timestamp when a calendar tool is enabled', async () => {
+  it('appends a precise time-of-day note to the latest user message when a calendar tool is enabled', async () => {
     mockedGenerateResponseWithTools.mockResolvedValue({ fullResponse: 'ok', toolCalls: [] });
 
     const ctx = createContext({
       enabledToolIds: ['create_calendar_event'],
-      messages: [makeMessage({ role: 'system', content: 'You are helpful.' })],
+      messages: [
+        makeMessage({ role: 'system', content: 'You are helpful.' }),
+        makeMessage({ role: 'user', content: 'Schedule a sync' }),
+      ],
     });
     await runToolLoop(ctx);
 
     const sentMessages = mockedGenerateResponseWithTools.mock.calls[0][0];
+    // The STABLE date stays in the system prefix so the system+tools prefix
+    // remains cacheable turn-to-turn.
     const sysContent = sentMessages.find((m: Message) => m.role === 'system')!.content as string;
-    // precise=true produces the YYYY-MM-DDTHH:MM:SS phrasing (not the date-only variant)
-    expect(sysContent).toContain('current date and time is');
-    expect(sysContent).toMatch(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/);
-    expect(sysContent).toContain('in half an hour');
+    expect(sysContent).toContain('The current date is');
+    // The EXACT time-of-day (needed to resolve "in half an hour") is appended to
+    // the latest user message instead, keeping the big prefix cacheable.
+    const userContent = [...sentMessages]
+      .reverse()
+      .find((m: Message) => m.role === 'user')!.content as string;
+    expect(userContent).toContain('Current local date and time');
+    expect(userContent).toMatch(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/);
+    expect(userContent).toContain('in half an hour');
   });
 
   it('uses the date-only context when no time-sensitive tool is enabled', async () => {

__tests__/unit/services/rag/database.test.ts

@@ -42,11 +42,13 @@ describe('RagDatabase', () => {
     it('opens the database and creates tables', async () => {
       await ragDatabase.ensureReady();
       expect(open).toHaveBeenCalledWith({ name: 'rag.db' });
-      // rag_documents, rag_chunks, rag_embeddings = 3 tables
-      expect(mockExecuteSync).toHaveBeenCalledTimes(3);
+      // rag_documents, rag_chunks, ALTER rag_chunks (metadata migration), rag_embeddings
+      expect(mockExecuteSync).toHaveBeenCalledTimes(4);
       expect(mockExecuteSync.mock.calls[0][0]).toContain('rag_documents');
       expect(mockExecuteSync.mock.calls[1][0]).toContain('rag_chunks');
-      expect(mockExecuteSync.mock.calls[2][0]).toContain('rag_embeddings');
+      expect(mockExecuteSync.mock.calls[2][0]).toContain('ALTER TABLE rag_chunks');
+      expect(mockExecuteSync.mock.calls[2][0]).toContain('metadata');
+      expect(mockExecuteSync.mock.calls[3][0]).toContain('rag_embeddings');
     });
 
     it('does not re-initialize on second call', async () => {
@@ -86,8 +88,22 @@ describe('RagDatabase', () => {
         (c: any[]) => typeof c[0] === 'string' && c[0].includes('INSERT INTO rag_chunks')
       );
       expect(chunkInserts).toHaveLength(2);
-      expect(chunkInserts[0][1]).toEqual(['chunk one', 42, 0]);
-      expect(chunkInserts[1][1]).toEqual(['chunk two', 42, 1]);
+      // 4th bind is metadata (null when the chunk carries none).
+      expect(chunkInserts[0][1]).toEqual(['chunk one', 42, 0, null]);
+      expect(chunkInserts[1][1]).toEqual(['chunk two', 42, 1, null]);
+    });
+
+    it('serializes chunk metadata to a JSON string on the way into the DB', async () => {
+      await ragDatabase.ensureReady();
+      mockExecuteSync.mockReturnValue({ insertId: 7, rowsAffected: 1, rows: [] });
+
+      const metadata = { recordingId: 'rec-1', startMs: 100, eventTitle: 'Standup' };
+      ragDatabase.insertChunks(42, [{ content: 'has meta', position: 0, metadata } as any]);
+
+      const chunkInsert = mockExecuteSync.mock.calls.find(
+        (c: any[]) => typeof c[0] === 'string' && c[0].includes('INSERT INTO rag_chunks'),
+      );
+      expect(chunkInsert![1]).toEqual(['has meta', 42, 0, JSON.stringify(metadata)]);
     });
   });
 

__tests__/unit/services/whisperService.branches.test.ts

@@ -44,6 +44,11 @@ describe('WhisperService — branch coverage', () => {
   beforeEach(() => {
     jest.restoreAllMocks();
     jest.clearAllMocks();
+    // clearAllMocks() clears call history but NOT the mockResolvedValueOnce
+    // queue, so an unconsumed once from a prior test would shift these
+    // ordered exists()/stat() chains. Reset them for true per-test isolation.
+    mockedRNFS.exists.mockReset();
+    mockedRNFS.stat.mockReset();
     resetService();
     mockedBDS.isAvailable.mockReturnValue(true);
     mockedBDS.cancelDownload.mockResolvedValue(undefined as any);

__tests__/unit/services/whisperService.test.ts

@@ -297,11 +297,47 @@ describe('WhisperService', () => {
 
       await whisperService.loadModel('/path/to/model.bin');
 
-      expect(initWhisper).toHaveBeenCalledWith({ filePath: '/path/to/model.bin' });
+      expect(initWhisper).toHaveBeenCalledWith({
+        filePath: '/path/to/model.bin',
+        useGpu: false,
+        useFlashAttn: false,
+        useCoreMLIos: false,
+      });
       expect(whisperService.isModelLoaded()).toBe(true);
       expect(whisperService.getLoadedModelPath()).toBe('/path/to/model.bin');
     });
 
+    it('falls back to CPU when CoreML requested but the encoder asset is missing', async () => {
+      // Valid model file, but the ggml-<model>-encoder.mlmodelc bundle is absent.
+      // Enabling CoreML without it makes whisper.rn crash at 0% on some iOS devices,
+      // so the guard must silently downgrade to CPU (useCoreMLIos: false).
+      mockedRNFS.stat.mockResolvedValue({ size: 75 * 1024 * 1024, isFile: () => true } as any);
+      mockedRNFS.exists.mockImplementation(async (p: string) =>
+        !p.endsWith('-encoder.mlmodelc'),
+      );
+      const mockContext = { id: 'ctx', release: jest.fn(), transcribeRealtime: jest.fn(), transcribe: jest.fn() };
+      mockedInitWhisper.mockResolvedValue(mockContext as any);
+
+      await whisperService.loadModel('/path/to/model.bin', { useCoreML: true });
+
+      expect(initWhisper).toHaveBeenCalledWith(
+        expect.objectContaining({ filePath: '/path/to/model.bin', useCoreMLIos: false }),
+      );
+    });
+
+    it('enables CoreML when the encoder asset is present', async () => {
+      mockedRNFS.stat.mockResolvedValue({ size: 75 * 1024 * 1024, isFile: () => true } as any);
+      mockedRNFS.exists.mockResolvedValue(true); // both the .bin and the .mlmodelc exist
+      const mockContext = { id: 'ctx', release: jest.fn(), transcribeRealtime: jest.fn(), transcribe: jest.fn() };
+      mockedInitWhisper.mockResolvedValue(mockContext as any);
+
+      await whisperService.loadModel('/path/to/model.bin', { useCoreML: true, useGpu: true, useFlashAttn: true });
+
+      expect(initWhisper).toHaveBeenCalledWith(
+        expect.objectContaining({ useCoreMLIos: true, useGpu: true, useFlashAttn: true }),
+      );
+    });
+
     it('unloads different model before loading new one', async () => {
       mockValidModelFile();
       const mockContext1 = {
@@ -761,7 +797,8 @@ describe('WhisperService', () => {
         })),
       };
       mockedInitWhisper.mockResolvedValueOnce(mockContext as any);
-      await whisperService.loadModel('/path/model.bin');
+      // English-only model (.en.bin) so transcribeFile forces language 'en'.
+      await whisperService.loadModel('/path/model.en.bin');
 
       const result = await whisperService.transcribeFile('/audio.wav');
 

__tests__/unit/stores/whisperStore.test.ts

@@ -164,6 +164,7 @@ describe('whisperStore', () => {
       expect(mockWhisperService.getModelPath).toHaveBeenCalledWith('ggml-tiny');
       expect(mockWhisperService.loadModel).toHaveBeenCalledWith(
         '/models/ggml-tiny',
+        undefined,
       );
       expect(getState().isModelLoaded).toBe(true);
     });
@@ -252,6 +253,7 @@ describe('whisperStore', () => {
       expect(mockWhisperService.getModelPath).toHaveBeenCalledWith('ggml-tiny');
       expect(mockWhisperService.loadModel).toHaveBeenCalledWith(
         '/models/ggml-tiny',
+        undefined,
       );
       expect(getState().isModelLoaded).toBe(true);
       expect(getState().isModelLoading).toBe(false);

__tests__/unit/utils/memorySnapshot.test.ts

@@ -0,0 +1,68 @@
+/**
+ * memorySnapshot unit tests
+ *
+ * logMemory() is a diagnostics probe used around whisper model load and each
+ * transcribe chunk to capture the app's footprint. On iOS it surfaces whether
+ * an apparent transcription "crash" was actually a jetsam low-memory kill.
+ *
+ * Guarantees under test:
+ * - formats used/total in MB and a percentage
+ * - never throws (a failing probe must not break the path it observes)
+ * - no divide-by-zero when total memory is reported as 0
+ */
+
+import DeviceInfo from 'react-native-device-info';
+import logger from '../../../src/utils/logger';
+import { logMemory } from '../../../src/utils/memorySnapshot';
+
+const mockedDeviceInfo = DeviceInfo as jest.Mocked<typeof DeviceInfo>;
+
+describe('logMemory', () => {
+  let logSpy: jest.SpyInstance;
+  let warnSpy: jest.SpyInstance;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    logSpy = jest.spyOn(logger, 'log').mockImplementation(() => {});
+    warnSpy = jest.spyOn(logger, 'warn').mockImplementation(() => {});
+  });
+
+  afterEach(() => {
+    logSpy.mockRestore();
+    warnSpy.mockRestore();
+  });
+
+  it('logs used/total in MB with a percentage, tagged with the call site', async () => {
+    mockedDeviceInfo.getUsedMemory.mockResolvedValue(1.4 * 1024 * 1024 * 1024);
+    mockedDeviceInfo.getTotalMemory.mockResolvedValue(4 * 1024 * 1024 * 1024);
+
+    await logMemory('whisper:beforeLoad');
+
+    expect(logSpy).toHaveBeenCalledTimes(1);
+    const msg = logSpy.mock.calls[0][0] as string;
+    expect(msg).toContain('[mem] whisper:beforeLoad');
+    expect(msg).toContain('used=1434MB');
+    expect(msg).toContain('total=4096MB');
+    expect(msg).toContain('(35%)');
+  });
+
+  it('never throws and warns when the probe fails', async () => {
+    mockedDeviceInfo.getUsedMemory.mockRejectedValue(new Error('boom'));
+    mockedDeviceInfo.getTotalMemory.mockResolvedValue(4 * 1024 * 1024 * 1024);
+
+    await expect(logMemory('transcribe:chunk@0s')).resolves.toBeUndefined();
+    expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('snapshot failed'));
+    expect(logSpy).not.toHaveBeenCalled();
+  });
+
+  it('does not divide by zero when total memory is unavailable', async () => {
+    mockedDeviceInfo.getUsedMemory.mockResolvedValue(100 * 1024 * 1024);
+    mockedDeviceInfo.getTotalMemory.mockResolvedValue(0);
+
+    await logMemory('zero');
+
+    const msg = logSpy.mock.calls[0][0] as string;
+    expect(msg).toContain('total=0MB');
+    expect(msg).toContain('(0%)');
+  });
+});

ios/OffgridMobile/Info.plist

@@ -18,6 +18,10 @@
 	<string>$(PRODUCT_NAME)</string>
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>$(MARKETING_VERSION)</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
 	<key>CFBundleURLTypes</key>
 	<array>
 		<dict>
@@ -29,19 +33,15 @@
 			</array>
 		</dict>
 	</array>
-	<key>CFBundleShortVersionString</key>
-	<string>$(MARKETING_VERSION)</string>
-	<key>CFBundleSignature</key>
-	<string>????</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
-	<key>LSRequiresIPhoneOS</key>
-	<true/>
 	<key>LSApplicationQueriesSchemes</key>
 	<array>
 		<string>twitter</string>
 		<string>x</string>
 	</array>
+	<key>LSRequiresIPhoneOS</key>
+	<true/>
 	<key>NSAppTransportSecurity</key>
 	<dict>
 		<key>NSAllowsLocalNetworking</key>
@@ -53,6 +53,10 @@
 		<string>_ollama._tcp</string>
 		<string>_lmstudio._tcp</string>
 	</array>
+	<key>NSCalendarsFullAccessUsageDescription</key>
+	<string>Used to read and create calendar events on your request.</string>
+	<key>NSCalendarsUsageDescription</key>
+	<string>Used to read and create calendar events on your request.</string>
 	<key>NSCameraUsageDescription</key>
 	<string>This app needs access to your camera to take photos and attach them to conversations.</string>
 	<key>NSFaceIDUsageDescription</key>
@@ -65,10 +69,6 @@
 	<string>This app needs permission to save generated images to your photo library.</string>
 	<key>NSPhotoLibraryUsageDescription</key>
 	<string>This app needs access to your photo library to attach images to conversations.</string>
-	<key>NSCalendarsUsageDescription</key>
-	<string>Used to read and create calendar events on your request.</string>
-	<key>NSCalendarsFullAccessUsageDescription</key>
-	<string>Used to read and create calendar events on your request.</string>
 	<key>NSSpeechRecognitionUsageDescription</key>
 	<string>This app uses on-device speech recognition to transcribe voice input.</string>
 	<key>RCTNewArchEnabled</key>
@@ -95,6 +95,10 @@
 		<string>SimpleLineIcons.ttf</string>
 		<string>FontAwesome6_Brands.ttf</string>
 	</array>
+	<key>UIBackgroundModes</key>
+	<array>
+		<string>audio</string>
+	</array>
 	<key>UILaunchStoryboardName</key>
 	<string>LaunchScreen</string>
 	<key>UIRequiredDeviceCapabilities</key>