first color revision

.claude/CLAUDE.md

@@ -0,0 +1,110 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Development
+source ~/.nvm/nvm.sh && npm start          # Start Electron app with hot-reload
+
+# Build & Package
+source ~/.nvm/nvm.sh && npm run make       # Build distributable packages
+source ~/.nvm/nvm.sh && npm run package    # Package without making installers
+
+# Lint
+source ~/.nvm/nvm.sh && npm run lint       # ESLint over .ts/.tsx files
+
+# Database migrations (Drizzle)
+source ~/.nvm/nvm.sh && npx drizzle-kit generate   # Generate migration from schema changes
+source ~/.nvm/nvm.sh && npx drizzle-kit push        # Push schema directly (dev only)
+```
+
+There is no test suite currently.
+
+## Architecture Overview
+
+Adiuva is a local-first Electron desktop app. The three Electron processes communicate via a custom tRPC↔IPC bridge (the public `electron-trpc` package is incompatible with tRPC v11, so a custom implementation is used).
+
+### Process Boundaries
+
+```
+Renderer (React)  ──ipcLink──►  Preload (contextBridge)  ──IPC──►  Main (tRPC router + SQLite)
+```
+
+1. **Main process** (`src/main/`) — Node.js, owns the database and all business logic
+   - `index.ts` — Window creation, app lifecycle
+   - `ipc.ts` — Custom handler that bridges `ipcMain` to tRPC procedures
+   - `router/index.ts` — All tRPC routers (clients, projects, tasks, checkpoints, notes, settings, ai)
+   - `db/index.ts` — Drizzle + better-sqlite3, WAL mode, singleton `getDb()`
+   - `db/schema.ts` — All table definitions (clients, projects, tasks, checkpoints, notes)
+   - `store.ts` — electron-store for persistent UI settings (e.g., `sidebarCollapsed`)
+
+2. **Preload** (`src/preload/trpc.ts`) — Exposes `window.electronTRPC` with `sendMessage()` / `onMessage()`
+
+3. **Renderer** (`src/renderer/`) — React 19, never accesses Node APIs directly
+   - `lib/ipcLink.ts` — Custom TRPCLink that routes calls through `window.electronTRPC`
+   - `lib/trpc.ts` — `createTRPCReact<AppRouter>()` typed client
+   - `index.tsx` — QueryClient + tRPC + Router providers
+   - All data access is through `trpc.*.*useQuery()` / `trpc.*.*.useMutation()`
+
+### Routing
+
+File-based routing via TanStack Router. Add a file to `src/renderer/routes/` and the route tree (`src/renderer/routeTree.gen.ts`) is auto-regenerated by the Vite plugin on next `npm start`. Routes:
+- `__root.tsx` — Root layout wrapping everything in `AppShell`
+- `index.tsx`, `tasks.tsx`, `timeline.tsx`, `projects.tsx`
+
+### Database
+
+Schema lives in `src/main/db/schema.ts`. Migrations are in `src/main/db/migrations/`. The DB is created in Electron's `userData` directory as `adiuva.db`. On startup, `initDb()` runs non-destructive migrations (CREATE TABLE IF NOT EXISTS).
+
+To add a new table or column: edit `schema.ts`, run `drizzle-kit generate`, then `drizzle-kit push` (dev) or commit the migration file.
+
+### Adding a New Feature (end-to-end pattern)
+
+1. **Schema** — Add table/columns to `src/main/db/schema.ts`
+2. **Router** — Add a tRPC sub-router in `src/main/router/index.ts`, merge it into `appRouter`
+3. **Types** — `AppRouter` is exported from `src/main/router/index.ts` and imported in `src/renderer/lib/trpc.ts` — types flow automatically
+4. **UI** — Create components under `src/renderer/components/<feature>/`, use `trpc.*.*useQuery()` for data
+
+### AI Subsystem (`src/main/ai/`)
+
+LangGraph-based agentic system with pluggable LLM providers (OpenAI, Anthropic, GitHub Copilot).
+
+**Orchestrator** (`orchestrator.ts`): Classifies user intent → routes to one of three specialist agents:
+- **Project agent** — project-scoped Q&A with tools: `read_project_notes`, `add_task`, `get_summary`, `suggest_checkpoints`, `suggest_tasks`
+- **Knowledge agent** — cross-project semantic search via `vector_search_all`
+- **General agent** — workspace-wide `add_task`
+
+Tool-calling strategy differs by provider: OpenAI/Anthropic use LangChain `bindTools()` + ToolMessage loop (max 5 iterations); Copilot uses SDK-native tools (loop handled internally).
+
+**Streaming**: Orchestrator calls `sendStreamChunk(sender, token, done)` over IPC channel `'ai:stream'`. Renderer subscribes via `window.electronAI.onStreamChunk()` in `AIChatPanel.tsx`. `<tool_call>` blocks are filtered before sending to renderer.
+
+**Provider factory** (`llm.ts`): `gpt-4o-mini` (OpenAI), `claude-sonnet-4-20250514` (Anthropic), or ChatCopilot wrapper — all with `temperature: 0.3` and streaming enabled.
+
+**Token storage** (`token.ts`) — three-tier fallback:
+1. keytar (OS keychain) — preferred, encrypted per-user
+2. electron-store + `safeStorage` — encrypted at rest
+3. Plain electron-store — WSL fallback
+
+Keytar service name is `'adiuva'`. Once keytar fails, `keytarFailed` flag skips it for the session.
+
+**AI approval pattern**: Tasks and checkpoints have `isAiSuggested` (bool) and `isApproved` (bool) columns. AI-suggested items appear in the UI pending user approval before being treated as real records.
+
+### Vector Embeddings (`src/main/db/vectordb.ts`)
+
+LanceDB stored in `{userData}/vectors/`. Table schema: `{ id, projectId, content, vector }`. Vectors are 1536-dimensional (`text-embedding-3-small`). Embeddings use a priority chain: Copilot CLI token → OpenAI token.
+
+- Note create/update fires `upsertNoteEmbedding()` (fire-and-forget, errors swallowed)
+- `migrateNotesIfNeeded()` backfills existing notes on first startup
+- `searchNotes(query, limit=5)` is called by the Knowledge agent tool
+
+### Key Config Notes
+
+- Vite configs use `.mts` extension (not `.ts`) to avoid ESM/CJS conflicts with electron-forge's externalize-deps plugin
+- `@/*` path alias resolves to `src/renderer/*` (TypeScript + Vite + shadcn/ui all share this alias)
+- shadcn/ui style: **new-york**, base color: **neutral**
+- Icons: **lucide-react** throughout — do not introduce other icon libraries
+- Tailwind 4 (not 3) — use CSS variable theming via `globals.css`, not `tailwind.config.js`
+- Notes use Milkdown (`@milkdown/crepe`) as the markdown editor (`src/renderer/components/notes/MilkdownEditor.tsx`)
+- Routes: `index`, `tasks`, `timeline`, `projects`, `notes.$noteId` (note ID is a URL param)

.claude/settings.local.json

@@ -0,0 +1,6 @@
+{
+  "enabledMcpjsonServers": [
+    "shadcn"
+  ],
+  "enableAllProjectMcpServers": true
+}

.gitignore

@@ -92,5 +92,5 @@ typings/
 out/
 
 # local config files
-.vscode/
 .claude/
+.vscode/

.vscode/mcp.json

@@ -0,0 +1,11 @@
+{
+  "servers": {
+    "shadcn": {
+      "command": "npx",
+      "args": [
+        "shadcn@latest",
+        "mcp"
+      ]
+    }
+  }
+}

src/renderer/components/ai/AIChatPanel.tsx

@@ -1,15 +1,21 @@
-import { useState, useEffect, useRef, useCallback, useMemo } from 'react';
+import { useState, useEffect, useRef, useCallback } from 'react';
 import { Sparkles, KeyRound, ArrowUp, ListTodo, TrendingUp, AlertCircle, Lightbulb } from 'lucide-react';
 import ReactMarkdown from 'react-markdown';
 import remarkGfm from 'remark-gfm';
 import { trpc } from '@/lib/trpc';
-import { useAIChat, type ChatContext } from '@/hooks/useAIChat';
 import { Card, CardContent } from '@/components/ui/card';
 import { Button } from '@/components/ui/button';
 import { Badge } from '@/components/ui/badge';
 import { Skeleton } from '@/components/ui/skeleton';
 import { ScrollArea } from '@/components/ui/scroll-area';
 
+interface ChatMessage {
+  id: string;
+  role: 'user' | 'assistant';
+  content: string;
+  error?: boolean;
+}
+
 const SUGGESTION_CHIPS = [
   { icon: ListTodo, label: "What's on my plate today?" },
   { icon: TrendingUp, label: 'Summarize this week' },
@@ -40,21 +46,10 @@ export function AIChatPanel({
   const userNameQuery = trpc.settings.getUserName.useQuery(undefined, { enabled: !!isHomePage });
   const dueTodayQuery = trpc.tasks.dueToday.useQuery(undefined, { enabled: !!isHomePage });
 
-  const chatContext = useMemo<ChatContext>(
-    () => ({
-      type: contextType,
-      ...(contextType === 'project' && projectId ? { projectId } : {}),
-    }),
-    [contextType, projectId],
-  );
-  const {
-    messages,
-    input,
-    setInput,
-    isStreaming,
-    streamingContent,
-    handleSend: chatHandleSend,
-  } = useAIChat(chatContext);
+  const [messages, setMessages] = useState<ChatMessage[]>([]);
+  const [input, setInput] = useState('');
+  const [isStreaming, setIsStreaming] = useState(false);
+  const [streamingContent, setStreamingContent] = useState('');
 
   // Daily brief state (home page only)
   const [dailyBrief, setDailyBrief] = useState<string | null>(null);
@@ -64,6 +59,8 @@ export function AIChatPanel({
 
   const messagesContainerRef = useRef<HTMLDivElement | null>(null);
 
+  const streamingContentRef = useRef('');
+  const chatMutation = trpc.ai.chat.useMutation();
   const briefMutation = trpc.ai.dailyBrief.useMutation();
 
   const scrollToBottom = useCallback(() => {
@@ -119,9 +116,72 @@ export function AIChatPanel({
   }, [isHomePage, hasTokenQuery.data]); // briefMutation excluded — only fire once
 
   const handleSend = useCallback(() => {
-    if (briefLoading) return;
-    chatHandleSend();
-  }, [briefLoading, chatHandleSend]);
+    const trimmed = input.trim();
+    if (!trimmed || isStreaming || briefLoading) return;
+
+    const userMsg: ChatMessage = {
+      id: crypto.randomUUID(),
+      role: 'user',
+      content: trimmed,
+    };
+
+    setMessages((prev) => [...prev, userMsg]);
+    setInput('');
+    setIsStreaming(true);
+    setStreamingContent('');
+    streamingContentRef.current = '';
+
+    const unsubscribe = window.electronAI.onStreamChunk(({ token, done }) => {
+      if (done) {
+        const finalContent = streamingContentRef.current;
+        setMessages((prev) => [
+          ...prev,
+          { id: crypto.randomUUID(), role: 'assistant', content: finalContent },
+        ]);
+        setStreamingContent('');
+        streamingContentRef.current = '';
+        setIsStreaming(false);
+        unsubscribe();
+        return;
+      }
+      streamingContentRef.current += token;
+      setStreamingContent(streamingContentRef.current);
+    });
+
+    chatMutation.mutate(
+      {
+        message: trimmed,
+        context: {
+          type: contextType,
+          ...(contextType === 'project' && projectId ? { projectId } : {}),
+        },
+      },
+      {
+        onSuccess: (data) => {
+          if (data.error) {
+            unsubscribe();
+            setMessages((prev) => [
+              ...prev,
+              { id: crypto.randomUUID(), role: 'assistant', content: data.error!, error: true },
+            ]);
+            setStreamingContent('');
+            streamingContentRef.current = '';
+            setIsStreaming(false);
+          }
+        },
+        onError: (err) => {
+          unsubscribe();
+          setMessages((prev) => [
+            ...prev,
+            { id: crypto.randomUUID(), role: 'assistant', content: err.message || 'An unexpected error occurred.', error: true },
+          ]);
+          setStreamingContent('');
+          streamingContentRef.current = '';
+          setIsStreaming(false);
+        },
+      },
+    );
+  }, [input, isStreaming, briefLoading, contextType, projectId, chatMutation]);
 
   const handleKeyDown = (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
     if (e.key === 'Enter' && !e.shiftKey) {

src/renderer/globals.css

@@ -50,73 +50,113 @@
 
 :root {
   --radius: 0.625rem;
-  --background: oklch(1 0 0);
-  --foreground: oklch(0.141 0.005 285.823);
-  --card: oklch(1 0 0);
-  --card-foreground: oklch(0.141 0.005 285.823);
-  --popover: oklch(1 0 0);
-  --popover-foreground: oklch(0.141 0.005 285.823);
-  --primary: oklch(0.21 0.006 285.885);
-  --primary-foreground: oklch(0.985 0 0);
-  --secondary: oklch(0.967 0.001 286.375);
-  --secondary-foreground: oklch(0.21 0.006 285.885);
-  --muted: oklch(0.967 0.001 286.375);
-  --muted-foreground: oklch(0.552 0.016 285.938);
-  --accent: oklch(0.967 0.001 286.375);
-  --accent-foreground: oklch(0.21 0.006 285.885);
+  
+  /* #f4edf3 - Light Pinkish-White Canvas */
+  --background: oklch(0.945 0.012 328.5);
+  /* #040404 - Almost Black Text */
+  --foreground: oklch(0.145 0 0);
+  
+  --card: oklch(0.945 0.012 328.5);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(0.945 0.012 328.5);
+  --popover-foreground: oklch(0.145 0 0);
+  
+  /* #fbc881 - Golden Yellow Accent */
+  --primary: oklch(0.838 0.117 76.8);
+  --primary-foreground: oklch(0.145 0 0);
+  
+  /* #8a8ea9 - Slate Blue/Gray */
+  --secondary: oklch(0.627 0.041 274.5);
+  --secondary-foreground: oklch(0.945 0.012 328.5);
+  
+  /* #c8c3cd - Light Gray/Purple */
+  --muted: oklch(0.811 0.014 300.2);
+  --muted-foreground: oklch(0.627 0.041 274.5);
+  
+  --accent: oklch(0.811 0.014 300.2);
+  --accent-foreground: oklch(0.145 0 0);
+  
   --destructive: oklch(0.577 0.245 27.325);
   --destructive-foreground: oklch(0.985 0 0);
-  --border: oklch(0.92 0.004 286.32);
-  --input: oklch(0.92 0.004 286.32);
-  --ring: oklch(0.705 0.015 286.067);
+  
+  --border: oklch(0.811 0.014 300.2);
+  --input: oklch(0.811 0.014 300.2);
+  --ring: oklch(0.838 0.117 76.8);
+  
+  /* Kept your original chart colors */
   --chart-1: oklch(0.646 0.222 41.116);
   --chart-2: oklch(0.6 0.118 184.704);
   --chart-3: oklch(0.398 0.07 227.392);
   --chart-4: oklch(0.828 0.189 84.429);
   --chart-5: oklch(0.769 0.188 70.08);
-  --sidebar: oklch(0.985 0 0);
-  --sidebar-foreground: oklch(0.141 0.005 285.823);
-  --sidebar-primary: oklch(0.21 0.006 285.885);
-  --sidebar-primary-foreground: oklch(0.985 0 0);
-  --sidebar-accent: oklch(0.967 0.001 286.375);
-  --sidebar-accent-foreground: oklch(0.21 0.006 285.885);
-  --sidebar-border: oklch(0.92 0.004 286.32);
-  --sidebar-ring: oklch(0.705 0.015 286.067);
+  
+  /* Sidebar uses the custom palette */
+  --sidebar: oklch(0.945 0.012 328.5);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.838 0.117 76.8);
+  --sidebar-primary-foreground: oklch(0.145 0 0);
+  --sidebar-accent: oklch(0.811 0.014 300.2);
+  --sidebar-accent-foreground: oklch(0.145 0 0);
+  --sidebar-border: oklch(0.811 0.014 300.2);
+  --sidebar-ring: oklch(0.838 0.117 76.8);
 }
 
 .dark {
-  --background: oklch(0.141 0.005 285.823);
+  /* #0c0c0c - Deepest black for the main canvas */
+  --background: oklch(0.15 0 0);
+  /* #fbfbfb - Crisp white for primary text */
   --foreground: oklch(0.985 0 0);
-  --card: oklch(0.21 0.006 285.885);
+  
+  /* Cards use the main background but are defined by borders */
+  --card: oklch(0.15 0 0);
   --card-foreground: oklch(0.985 0 0);
-  --popover: oklch(0.21 0.006 285.885);
+  --popover: oklch(0.15 0 0);
   --popover-foreground: oklch(0.985 0 0);
-  --primary: oklch(0.92 0.004 286.32);
-  --primary-foreground: oklch(0.21 0.006 285.885);
-  --secondary: oklch(0.274 0.006 286.033);
+  
+  /* #fbfbfb - Primary actions (like the active white circle menu item) */
+  --primary: oklch(0.985 0 0);
+  /* #0c0c0c - Dark text/icons inside primary buttons */
+  --primary-foreground: oklch(0.15 0 0);
+  
+  /* #323232 - Dark gray for secondary surfaces and button backgrounds */
+  --secondary: oklch(0.335 0 0);
+  /* #fbfbfb - White text on secondary surfaces */
   --secondary-foreground: oklch(0.985 0 0);
-  --muted: oklch(0.274 0.006 286.033);
-  --muted-foreground: oklch(0.705 0.015 286.067);
-  --accent: oklch(0.274 0.006 286.033);
+  
+  /* #323232 - Dark gray for muted backgrounds */
+  --muted: oklch(0.335 0 0);
+  /* #77797b - Mid gray for muted/secondary text (like "ELEVATE YOUR...") */
+  --muted-foreground: oklch(0.555 0 0);
+  
+  /* #323232 - Hover states */
+  --accent: oklch(0.335 0 0);
   --accent-foreground: oklch(0.985 0 0);
-  --destructive: oklch(0.704 0.191 22.216);
+  
+  --destructive: oklch(0.704 0.191 22.216); /* Kept original dark red */
   --destructive-foreground: oklch(0.985 0 0);
-  --border: oklch(1 0 0 / 10%);
-  --input: oklch(1 0 0 / 15%);
-  --ring: oklch(0.552 0.016 285.938);
+  
+  /* #323232 - Distinct dark gray borders for the cards/panels */
+  --border: oklch(0.335 0 0);
+  --input: oklch(0.335 0 0);
+  /* #bab7ba - Lighter gray for focus rings to stand out against dark borders */
+  --ring: oklch(0.765 0 0);
+  
+  /* Kept your original chart colors */
   --chart-1: oklch(0.488 0.243 264.376);
   --chart-2: oklch(0.696 0.17 162.48);
   --chart-3: oklch(0.769 0.188 70.08);
   --chart-4: oklch(0.627 0.265 303.9);
   --chart-5: oklch(0.645 0.246 16.439);
-  --sidebar: oklch(0.21 0.006 285.885);
+  
+  /* Sidebar mapped to the new sleek dark palette */
+  --sidebar: oklch(0.15 0 0);
   --sidebar-foreground: oklch(0.985 0 0);
-  --sidebar-primary: oklch(0.488 0.243 264.376);
-  --sidebar-primary-foreground: oklch(0.985 0 0);
-  --sidebar-accent: oklch(0.274 0.006 286.033);
+  --sidebar-primary: oklch(0.985 0 0);
+  --sidebar-primary-foreground: oklch(0.15 0 0);
+  --sidebar-accent: oklch(0.335 0 0);
   --sidebar-accent-foreground: oklch(0.985 0 0);
-  --sidebar-border: oklch(1 0 0 / 10%);
-  --sidebar-ring: oklch(0.552 0.016 285.938);
+  --sidebar-border: oklch(0.335 0 0);
+  --sidebar-ring: oklch(0.765 0 0);
 }
 
 @layer base {

src/renderer/hooks/useAIChat.ts

@@ -1,130 +0,0 @@
-import { useState, useCallback, useRef } from 'react';
-import { trpc } from '@/lib/trpc';
-
-export interface ChatMessage {
-  id: string;
-  role: 'user' | 'assistant';
-  content: string;
-  error?: boolean;
-}
-
-export interface ChatContext {
-  type: 'global' | 'project';
-  projectId?: string;
-  uiContext?: string;
-}
-
-export interface UseAIChatReturn {
-  messages: ChatMessage[];
-  input: string;
-  setInput: (v: string) => void;
-  isStreaming: boolean;
-  streamingContent: string;
-  handleSend: (overrideMessage?: string, overrideContext?: ChatContext) => void;
-  clearMessages: () => void;
-}
-
-export function useAIChat(defaultContext: ChatContext): UseAIChatReturn {
-  const [messages, setMessages] = useState<ChatMessage[]>([]);
-  const [input, setInput] = useState('');
-  const [isStreaming, setIsStreaming] = useState(false);
-  const [streamingContent, setStreamingContent] = useState('');
-
-  const streamingContentRef = useRef('');
-  const chatMutation = trpc.ai.chat.useMutation();
-
-  const clearMessages = useCallback(() => {
-    setMessages([]);
-    setStreamingContent('');
-    streamingContentRef.current = '';
-  }, []);
-
-  const handleSend = useCallback(
-    (overrideMessage?: string, overrideContext?: ChatContext) => {
-      const trimmed = (overrideMessage ?? input).trim();
-      if (!trimmed || isStreaming) return;
-
-      const userMsg: ChatMessage = {
-        id: crypto.randomUUID(),
-        role: 'user',
-        content: trimmed,
-      };
-
-      setMessages((prev) => [...prev, userMsg]);
-      if (!overrideMessage) setInput('');
-      setIsStreaming(true);
-      setStreamingContent('');
-      streamingContentRef.current = '';
-
-      const unsubscribe = window.electronAI.onStreamChunk(({ token, done }) => {
-        if (done) {
-          const finalContent = streamingContentRef.current;
-          setMessages((prev) => [
-            ...prev,
-            { id: crypto.randomUUID(), role: 'assistant', content: finalContent },
-          ]);
-          setStreamingContent('');
-          streamingContentRef.current = '';
-          setIsStreaming(false);
-          unsubscribe();
-          return;
-        }
-        streamingContentRef.current += token;
-        setStreamingContent(streamingContentRef.current);
-      });
-
-      const ctx = overrideContext ?? defaultContext;
-
-      chatMutation.mutate(
-        {
-          message: trimmed,
-          context: {
-            type: ctx.type,
-            ...(ctx.type === 'project' && ctx.projectId ? { projectId: ctx.projectId } : {}),
-            ...(ctx.uiContext ? { uiContext: ctx.uiContext } : {}),
-          },
-        },
-        {
-          onSuccess: (data) => {
-            if (data.error) {
-              unsubscribe();
-              setMessages((prev) => [
-                ...prev,
-                { id: crypto.randomUUID(), role: 'assistant', content: data.error!, error: true },
-              ]);
-              setStreamingContent('');
-              streamingContentRef.current = '';
-              setIsStreaming(false);
-            }
-          },
-          onError: (err) => {
-            unsubscribe();
-            setMessages((prev) => [
-              ...prev,
-              {
-                id: crypto.randomUUID(),
-                role: 'assistant',
-                content: err.message || 'An unexpected error occurred.',
-                error: true,
-              },
-            ]);
-            setStreamingContent('');
-            streamingContentRef.current = '';
-            setIsStreaming(false);
-          },
-        },
-      );
-    },
-    [input, isStreaming, defaultContext, chatMutation],
-  );
-
-  return {
-    messages,
-    input,
-    setInput,
-    isStreaming,
-    streamingContent,
-    handleSend,
-    clearMessages,
-  };
-}