Skip to main content

📕 Internal Product Bible

1. Vision & Philosophy​

Yuki is the AI Operating System for your life.

Unlike traditional productivity tools that act as "databases you have to manually fill," Yuki operates on a Zero-Input philosophy. The user lives their life; Yuki captures the metadata via background agents (SmartFeeder).

Core Tenets​

  • Passive > Active: If the user has to type it, we failed.
  • Privacy is Architecture: We don't just say "we respect privacy"; we build Kill Switches and Local-First sync engines to enforce it.
  • Probabilistic UI: AI hallucinations are inevitable. Our UI treats extracted data as "Drafts" or "Estimates" until verified, never absolute truth.

2. Architecture & Tech Stack​

High-Level Stack​

  • Mobile: React Native (Expo) + Tamagui UI.
  • State Management: TanStack Query (Local-first caching).
  • Backend: Supabase (PostgreSQL, Auth, Edge Functions).
  • AI Engine: OpenAI GPT-4o (Cloud) -> Moving to On-Device NPU (Roadmap).

The "SmartFeeder" Engine​

The heart of Yuki is utils/transportEngine.ts (The SmartFeeder).

  • Function: Runs in the background every 45-60 minutes.
  • Concurrency: Uses a custom Global Lock System (isSyncGlobalLock) in the database to prevent the background fetcher and foreground UI from corrupting data by writing simultaneously.
  • Ingestion: Connects to Gmail/Outlook via Restricted Scopes (gmail.readonly).

Privacy & Security​

  • Data Minimization: We ingest raw emails into memory, extract the JSON facts (Date, Amount, Merchant), and immediately discard the raw text.
  • The Kill Switch: We utilize a custom PostgreSQL RPC function delete_own_user. When a user deletes their account, this function executes at the database level to wipe all rows in trips, transactions, and users instantly.

3. Core Features (The "Now")​

🧠 Omni-Sync & Focus Inbox​

  • Problem: Users are drowning in newsletters and spam.
  • Solution: An LLM-based filter that scans unread emails. It categorizes them into "Noise" (hidden) vs. "Signal" (Actionable).
  • Output: A simplified "Focus Inbox" that summarizes only the emails requiring a reply (e.g., "Mom asking for dates").

💸 Autonomous Finance​

  • Logic: Detecting purchases from digital receipts (Uber, Amazon, Stripe).
  • Multi-Currency: Automatically normalizes foreign transactions (JPY, EUR, GBP) to the user's home currency using historical forex rates at the time of purchase.
  • Subscription Hunter: Heuristic analysis of recurring amounts and dates to flag "Zombie Subscriptions."

📅 The Day Organizer​

  • Unified Dashboard: Aggregates Calendar Events, Todoist/Apple Reminders, and "Focus" emails into a single timeline.
  • Quick Actions: One-tap buttons generated by AI (e.g., "Book Uber to Airport" appears 2 hours before a flight).

4. Roadmap (The "Next")​

HorizonFeatureDescription
Q3 (Short Term)Actionable Workflows"Text to Action". E.g., Detect grocery list in Notes -> Auto-create Instacart cart.
Q3 (Short Term)Unified BrainIntegrations for Slack (Work summary) and Notion (Project deadlines).
Q4 (Mid Term)Trip Suggestions"You booked a flight to NYC. Here are 3 hotels in SoHo available for your dates."
2027 (Long Term)Local-First AIMoving parsing logic from Cloud to On-Device (Apple Neural Engine) for 100% offline privacy.

5. Success Metrics​

  • Zero-Input Ratio: Percentage of transactions/trips captured automatically vs. manually added. Target: >90%.
  • Hallucination Rate: Frequency of user edits to AI-parsed fields. Target: <5%.
  • Sync Latency: Time from "Receipt Email Received" to "Push Notification". Target: <2 minutes.