Insight Engine v3, timezone registration, Reanimated easing fix

- Add dynamic metric discovery, intraday analyzers (excursion clustering,
  stability trends, temporal distribution, sequential change detection)
- Add metric type catalog and auto-blacklisting for low-quality patterns
- Update pattern spotter and ranker for v3 pipeline
- Fix Reanimated v4 easing error in BioPortrait (bezier returns worklet object)
- Add timezone registration and tests
- Add admin insights route and blacklist migration
- Add glucose trend analysis scripts

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

Author: schwaaamp

docs/README.md

@@ -39,6 +39,8 @@ Active feature planning and architectural strategy documents.
 | [Integration Test Plan](./planning/INTEGRATION_TEST_PLAN.md) | Mobile integration test strategy (Phases 1-4) | 🔄 Phase 4 In Progress |
 | [Phase 4 E2E Test Spec](./planning/PHASE_4_E2E_TEST_SPEC.md) | E2E test implementation details | 🔄 In Progress (3/13 passing) |
 | [Unit Test Coverage Plan](./planning/UNIT_TEST_COVERAGE_PLAN.md) | Comprehensive unit test coverage roadmap | ✅ Active |
+| [Insight Engine v3](./planning/insight-engine-v3.md) | Dynamic metric discovery, auto-blacklisting, intraday analyzers | 📋 Planning |
+| [Timezone Strategy](./planning/timezone-strategy.md) | Cross-system timezone normalization for all data sources | 📋 Planning (prerequisite for Insight v3) |
 
 ---
 

docs/planning/insight-engine-v3.md

@@ -42,8 +42,8 @@ export default function BioPortrait({ activationLevel, size = 200 }: BioPortrait
   const breathScale = useSharedValue(1.0);
 
   useEffect(() => {
-    const easing = Easing.bezier(0.25, 0.1, 0.25, 1) as unknown as Parameters<typeof Easing.inOut>[0];
-    const timing = { duration: 600, easing: Easing.inOut(easing) };
+    const easing = Easing.bezier(0.25, 0.1, 0.25, 1);
+    const timing = { duration: 600, easing };
 
     if (activationLevel >= 1) {
       // Core activates with soft pulsing breath

mobile/src/components/BioPortrait.tsx

@@ -2,14 +2,14 @@
  * Tests for timezoneRegistration.ts
  *
  * Covers:
- * - Successful timezone registration (upserts IANA timezone to user_profiles)
+ * - Successful timezone registration (updates user_profiles)
+ * - Returns null and logs warning when profile row doesn't exist (count=0)
  * - Deduplication of concurrent calls
  * - Re-registration after previous call completes
- * - Graceful handling of missing Intl.DateTimeFormat timezone
  * - Graceful handling of Supabase update errors
  */
 
-const mockEq = jest.fn().mockResolvedValue({ error: null });
+const mockEq = jest.fn().mockResolvedValue({ error: null, count: 1 });
 const mockUpdate = jest.fn().mockReturnValue({ eq: mockEq });
 
 jest.mock('@/utils/supabaseClient', () => ({
@@ -28,39 +28,46 @@ import { registerTimezone, getDeviceTimezone } from '../timezoneRegistration';
 describe('timezoneRegistration', () => {
   beforeEach(() => {
     jest.clearAllMocks();
+    mockEq.mockResolvedValue({ error: null, count: 1 });
   });
 
   describe('getDeviceTimezone', () => {
     it('returns the IANA timezone from Intl.DateTimeFormat', () => {
       const tz = getDeviceTimezone();
-      // Jest runs in Node which has Intl support — should return a valid IANA string
       expect(typeof tz).toBe('string');
       expect(tz!.length).toBeGreaterThan(0);
-      // IANA timezones contain a slash (e.g., "America/New_York", "UTC" is the exception)
       expect(tz === 'UTC' || tz!.includes('/')).toBe(true);
     });
   });
 
   describe('registerTimezone', () => {
-    it('upserts timezone to user_profiles', async () => {
+    it('updates timezone on user_profiles with count option', async () => {
       await registerTimezone('user-123');
 
       expect(mockUpdate).toHaveBeenCalledWith(
         expect.objectContaining({
           timezone: expect.any(String),
           tz_source: 'device',
           tz_updated_at: expect.any(String),
-        })
+        }),
+        { count: 'exact' },
       );
       expect(mockEq).toHaveBeenCalledWith('user_id', 'user-123');
     });
 
-    it('returns the detected timezone string', async () => {
+    it('returns the detected timezone string on success', async () => {
       const tz = await registerTimezone('user-123');
       expect(typeof tz).toBe('string');
       expect(tz!.length).toBeGreaterThan(0);
     });
 
+    it('returns null when no profile row exists (count=0)', async () => {
+      mockEq.mockResolvedValueOnce({ error: null, count: 0 });
+
+      const tz = await registerTimezone('user-123');
+      expect(tz).toBeNull();
+    });
+
     it('deduplicates concurrent calls', async () => {
       const [r1, r2, r3] = await Promise.all([
         registerTimezone('user-123'),
@@ -84,7 +91,7 @@ describe('timezoneRegistration', () => {
     });
 
     it('returns null on Supabase update error', async () => {
-      mockEq.mockResolvedValueOnce({ error: { message: 'DB error' } });
+      mockEq.mockResolvedValueOnce({ error: { message: 'DB error' }, count: null });
 
       const tz = await registerTimezone('user-123');
       expect(tz).toBeNull();

mobile/src/utils/__tests__/timezoneRegistration.test.ts

@@ -22,6 +22,19 @@ import { registerTimezone } from '@/utils/timezoneRegistration';
 
 let sessionInitPromise: Promise<SupabaseSession | null> | null = null;
 
+/** Extract user ID (sub claim) from a JWT without a library. */
+function extractUserIdFromJwt(token: string | undefined | null): string | null {
+  if (!token) return null;
+  try {
+    const payload = token.split('.')[1];
+    if (!payload) return null;
+    const decoded = JSON.parse(atob(payload));
+    return decoded.sub ?? null;
+  } catch {
+    return null;
+  }
+}
+
 /**
  * Runs the one-time session restore: SecureStore read, Supabase setSession,
  * Zustand sync, and push token registration. Concurrent callers share the
@@ -51,9 +64,14 @@ function initSession(): Promise<SupabaseSession | null> {
     }
 
     // Fire-and-forget registrations (non-blocking, deduplicated)
-    if (currentSession?.user?.id) {
-      registerPushToken(currentSession.user.id).catch(() => {});
-      registerTimezone(currentSession.user.id).catch(() => {});
+    // The session may not include .user (Google OAuth implicit flow returns
+    // tokens only). Extract user ID from the JWT sub claim as fallback.
+    const userId = currentSession?.user?.id ?? extractUserIdFromJwt(currentSession?.access_token);
+    if (userId) {
+      registerPushToken(userId).catch(() => {});
+      registerTimezone(userId).catch(() => {});
+    } else if (currentSession) {
+      console.warn('[Auth] Could not extract user ID from session — timezone and push token registration skipped');
     }
 
     return currentSession;

mobile/src/utils/auth/useAuth.ts

@@ -52,20 +52,25 @@ async function doRegisterTimezone(userId: string): Promise<string | null> {
       return null;
     }
 
-    const { error } = await supabase
+    const { error, count } = await supabase
       .from('user_profiles')
       .update({
         timezone,
         tz_source: 'device',
         tz_updated_at: new Date().toISOString(),
-      })
+      }, { count: 'exact' })
       .eq('user_id', userId);
 
     if (error) {
       console.error('[Timezone] Failed to update timezone:', error);
       return null;
     }
 
+    if (count === 0) {
+      console.warn('[Timezone] No profile row found for user — timezone not saved. Will retry on next app launch.');
+      return null;
+    }
+
     console.log('[Timezone] Registered:', timezone);
     return timezone;
   } catch (error) {