Phase 3: Native Desktop Features ✅

src-tauri/
├── src/
│   └── tray.rs              (170 lines) - System tray module
├── Cargo.toml               (Updated) - Added tray/notification features
└── icons/
    └── icon.png             - Tray icon

src/lib/
├── tauri/
│   └── notifications.ts     (380 lines) - Notification manager & tray control
└── hooks/
    ├── useNotifications.ts  (200 lines) - Notification React hooks
    └── useKeyboardShortcuts.ts (280 lines) - Keyboard shortcut system

src/
└── App.tsx                  (Updated) - Integrated notifications & shortcuts

┌─────────────────────────────────────────────────┐
│              Rust Backend (Tauri)                │
│                                                   │
│  ┌───────────────────────────────────────────┐  │
│  │  System Tray                               │  │
│  │  - Icon (platform-native)                  │  │
│  │  - Context Menu                            │  │
│  │  - Event Handler                           │  │
│  └───────────────────────────────────────────┘  │
│                       │                           │
│                       ▼                           │
│  ┌───────────────────────────────────────────┐  │
│  │  Tray Event Handler                        │  │
│  │  - Left Click → Show Window                │  │
│  │  - Right Click → Show Menu                 │  │
│  │  - Menu Items → Emit Events                │  │
│  └───────────────────────────────────────────┘  │
└───────────────────────┬───────────────────────────┘
                        │ (Tauri IPC)
                        ▼
┌─────────────────────────────────────────────────┐
│         TypeScript Frontend (React)              │
│                                                   │
│  ┌───────────────────────────────────────────┐  │
│  │  Notification Manager                      │  │
│  │  - Show Native Notifications               │  │
│  │  - Track Unread Count                      │  │
│  │  - Deduplicate by Tag                      │  │
│  └───────────────────────────────────────────┘  │
│                       │                           │
│                       ▼                           │
│  ┌───────────────────────────────────────────┐  │
│  │  React Hooks (useNotifications)            │  │
│  │  - Listen to WebSocket Events              │  │
│  │  - Show Notifications Automatically        │  │
│  │  - Update Tray Icon State                  │  │
│  └───────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘

pub fn create_system_tray() -> SystemTray {
    let show = CustomMenuItem::new("show".to_string(), "Show TrajectoryOS");
    let hide = CustomMenuItem::new("hide".to_string(), "Hide Window");

    // Quick Actions submenu
    let interview = CustomMenuItem::new("interview".to_string(), "Start Interview");
    let update_state = CustomMenuItem::new("update_state".to_string(), "Update State");
    let quick_actions = SystemTraySubmenu::new(
        "Quick Actions",
        SystemTrayMenu::new()
            .add_item(interview)
            .add_item(update_state),
    );

    let quit = CustomMenuItem::new("quit".to_string(), "Quit");

    SystemTrayMenu::new()
        .add_item(show)
        .add_item(hide)
        .add_submenu(quick_actions)
        .add_item(quit)
}

class NotificationManager {
  async show(options: NotificationOptions): Promise<void> {
    // Deduplicate by tag
    if (options.tag && this.notifications.has(options.tag)) {
      return;
    }

    // Send to Tauri backend (native notification)
    await invoke('show_notification', {
      title: options.title,
      body: options.body,
    });

    // Track notification
    if (options.tag) {
      this.notifications.set(options.tag, options);
    }
    this.unreadCount++;
  }

  // Specialized notification methods
  async notifyRegimeChange(oldRegime: string, newRegime: string) {
    await this.show({
      title: 'Regime Change!',
      body: `Transitioned from ${oldRegime} to ${newRegime}`,
      tag: 'regime-change',
      priority: 'high',
      requireInteraction: true,
    });
  }
}

export function useKeyboardShortcuts(options) {
  // Global shortcuts (work even when app not focused)
  useEffect(() => {
    if (config.toggleWindow && options.onToggleWindow) {
      shortcutManager.register(
        config.toggleWindow, // "CommandOrControl+Shift+T"
        options.onToggleWindow,
        { global: true }
      );
    }
  }, []);

  // In-app shortcuts (only when app focused)
  useEffect(() => {
    const handleKeyDown = (event: KeyboardEvent) => {
      const key = eventToKey(event);
      if (key === config.openSearch && options.onOpenSearch) {
        event.preventDefault();
        options.onOpenSearch();
      }
    };

    window.addEventListener('keydown', handleKeyDown);
    return () => window.removeEventListener('keydown', handleKeyDown);
  }, []);
}

class TrayManager {
  async updateState(state: Partial<TrayIconState>) {
    this.currentState = { ...this.currentState, ...state };

    // Determine icon state
    let iconState = 'default';
    if (!this.currentState.connected) {
      iconState = 'disconnected';
    } else if (this.currentState.hasUnreadNotifications) {
      iconState = 'notification';
    } else if (this.currentState.escapeIndexTrend === 'up') {
      iconState = 'trending-up';
    }

    await invoke('update_tray_icon', { iconState });
  }
}

┌─────────────────────────────────┐
│ ◉ Show TrajectoryOS             │
│   Hide Window                    │
├─────────────────────────────────┤
│ ▶ Quick Actions                  │
│   ├─ Start Interview             │
│   └─ Update State                │
├─────────────────────────────────┤
│   Quit                           │
└─────────────────────────────────┘

┌─────────────────────────────────┐
│ 🚀 Regime Change!                │
│                                  │
│ Transitioned from "trapped"      │
│ to "rising" regime               │
│                                  │
│ [Requires interaction]           │
└─────────────────────────────────┘

┌─────────────────────────────────┐
│ ✨ New Skill Added               │
│                                  │
│ TypeScript (92% confidence)      │
└─────────────────────────────────┘

┌─────────────────────────────────┐
│ ✅ Interview Complete            │
│                                  │
│ 12 skills extracted              │
└─────────────────────────────────┘

// In useNotifications hook
useStateUpdates((state: LifeState) => {
  // Detect regime change
  if (previousRegime && previousRegime !== state.regime) {
    notificationManager.notifyRegimeChange(previousRegime, state.regime);
  }

  // Update tray tooltip
  trayManager.updateTooltip(
    `TrajectoryOS - η: ${state.escapeIndex.toFixed(3)} (${state.regime})`
  );
});

// In tray.rs
"interview" => {
    if let Some(window) = app.get_window("main") {
        let _ = window.show();
        let _ = window.set_focus();
        // Emit event to frontend
        let _ = window.emit("start-interview", ());
    }
}

// In useNotifications hook
listen('start-interview', () => {
  window.dispatchEvent(new CustomEvent('tray:start-interview'));
});

// In App.tsx
window.addEventListener('tray:start-interview', () => {
  useInterviewStore.getState().startInterview();
});