ai-wrapped 0.0.1

package/.0spec/config.toml

@@ -0,0 +1,50 @@
+# ai-stats — AI analytics dashboard desktop app (Electrobun)
+
+[settings]
+default_team = "global"
+default_model = "claude-opus-4-6"
+bypass_permissions = true
+fail_fast = true
+retries = 1
+
+[settings.doctor]
+enabled = true
+agent = "doctor"
+
+# ─── Teams ──────────────────────────────────────────────
+
+[teams.global]
+description = "Single agent — general tasks"
+agents = ["claude-agent"]
+
+[teams.research]
+description = "Research & analysis"
+agents = ["planner-claude"]
+rules = "Analyze documentation, produce structured reference material. No code changes."
+
+[teams.planners]
+description = "Architecture & planning"
+agents = ["planner-claude"]
+rules = "Design architecture, produce implementation specs. No implementation."
+
+[teams.implementors]
+description = "Implementation team"
+agents = ["coder-codex"]
+
+[teams.reviewers]
+description = "QA & review"
+agents = ["reviewer-codex"]
+rules = "Review code, run tests, verify builds. Output structured QA verdicts."
+
+# ─── Agents ─────────────────────────────────────────────
+
+[agents.claude-agent]
+engine = "claude"
+model = "claude-opus-4-6"
+timeout = 600
+
+[agents.doctor]
+engine = "claude"
+model = "haiku"
+timeout = 30
+max_turns = 3

package/.0spec/flows/ai-stats-build.toml

@@ -0,0 +1,291 @@
+[flow]
+name = "ai-stats-build"
+description = "Build ai-stats from existing architecture spec — scaffold through commit"
+
+# NOTE: ARCHITECTURE.md (1462 lines), SESSION_FORMATS.md, and AGENT_SESSIONS_REFERENCE.md
+# are pre-seeded in the project root from prior research/planning runs.
+# No consolidation stage needed — ARCHITECTURE.md is the authoritative spec.
+
+# ─── Phase 1: Scaffold ─────────────────────────────────
+
+[[stages]]
+id = "scaffold"
+name = "Project Scaffold"
+type = "seq"
+team = "implementors"
+prompt = """
+Read ARCHITECTURE.md in the project root — it is the authoritative spec.
+
+Create the project scaffold as specified in Section 1 (Project Structure) and Section 9 (Build & Dev Workflow).
+
+Constraints:
+- Use Electrobun react-tailwind-vite pattern (Vite builds to dist/, copy config maps to views/)
+- Remove "type": "module" and "module" from package.json if present
+- SQLite via bun:sqlite (built into Bun, no extra deps)
+- Tailwind v4 via @tailwindcss/vite plugin
+- Use concurrently for dev:hmr script
+
+Only skeleton — stub files with empty exports/components. No business logic.
+
+Verify:
+- `bun install` succeeds
+- Vite build compiles without errors
+- Main process file parses without errors
+"""
+output = { format = "markdown", name = "scaffold.md" }
+
+[[stages]]
+id = "qa-scaffold"
+name = "QA Scaffold"
+type = "seq"
+team = "reviewers"
+depends_on = ["scaffold"]
+input_from = ["scaffold"]
+prompt = """
+Read ARCHITECTURE.md for the expected project structure.
+
+Verify the scaffold:
+1. `bun install` succeeds
+2. Vite build compiles without errors
+3. All files from Section 1 of ARCHITECTURE.md exist (check file tree)
+4. package.json has correct scripts (dev, dev:hmr, build)
+5. electrobun.config.ts is valid
+6. No "type": "module" in package.json
+
+Output JSON: { "verdict": "pass" or "fail", "issues": [...] }
+"""
+output = { format = "json", name = "qa-scaffold.json" }
+
+[[stages]]
+id = "fix-scaffold"
+name = "Fix Scaffold Issues"
+type = "loop"
+team = "implementors"
+depends_on = ["qa-scaffold"]
+input_from = ["qa-scaffold"]
+prompt = "Fix all issues from QA report."
+max_loops = 2
+loop_to = "qa-scaffold"
+condition = "qa-scaffold.verdict != 'pass'"
+output = { format = "diff", name = "scaffold-fixes.diff" }
+
+# ─── Phase 2: Parsers & Data Layer ─────────────────────
+
+[[stages]]
+id = "data-layer"
+name = "Session Parsers + SQLite + RPC"
+type = "seq"
+team = "implementors"
+depends_on = ["fix-scaffold"]
+prompt = """
+Read ARCHITECTURE.md (Sections 2-6) and SESSION_FORMATS.md in the project root. Implement:
+
+1. Session discovery (src/bun/discovery/):
+   - Discover Claude Code sessions: ~/.claude/projects/*/*.jsonl
+   - Discover Codex CLI sessions: ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
+   - Discover other agents if present (Gemini, Copilot, OpenCode)
+   - Return file paths with agent source type
+
+2. JSONL parsers (src/bun/parsers/):
+   - Claude Code parser — handle nested message.content, uuid/parentUuid threading
+   - Codex CLI parser — handle top-level content, delta streaming chunks
+   - Generic parser fallback
+   - All parsers produce normalized SessionEvent[]
+
+3. Normalizer (src/bun/normalizer.ts):
+   - Map raw event types to SessionEventKind (user, assistant, tool_call, tool_result, error, meta)
+   - Extract text from various content formats
+   - Handle timestamp format variations (ISO 8601, epoch seconds/ms)
+
+4. SQLite database (src/bun/db.ts):
+   - Tables as specified in Section 3 of ARCHITECTURE.md
+   - Migration/init, upsert parsed sessions, query functions
+
+5. RPC types (src/shared/types.ts) + wiring (src/bun/index.ts):
+   - As specified in Section 6 of ARCHITECTURE.md
+
+Verify:
+- TypeScript compiles without errors
+- DB initializes and creates tables
+- At least one real session file parses successfully
+"""
+output = { format = "markdown", name = "data-layer.md" }
+
+[[stages]]
+id = "qa-data"
+name = "QA Data Layer"
+type = "seq"
+team = "reviewers"
+depends_on = ["data-layer"]
+input_from = ["data-layer"]
+prompt = """
+Read ARCHITECTURE.md for the expected schema and RPC surface.
+
+Verify the data layer:
+1. SQLite schema matches Section 3 of ARCHITECTURE.md
+2. Session discovery finds real session files on this machine
+3. At least one Claude Code and one Codex session parses without errors
+4. Normalized events have correct kind, text, timestamps
+5. RPC types are complete and type-safe
+6. TypeScript compiles
+
+Output JSON: { "verdict": "pass" or "fail", "issues": [...] }
+"""
+output = { format = "json", name = "qa-data.json" }
+
+[[stages]]
+id = "fix-data"
+name = "Fix Data Layer Issues"
+type = "loop"
+team = "implementors"
+depends_on = ["qa-data"]
+input_from = ["qa-data"]
+prompt = "Fix all issues from QA report."
+max_loops = 2
+loop_to = "qa-data"
+condition = "qa-data.verdict != 'pass'"
+output = { format = "diff", name = "data-fixes.diff" }
+
+# ─── Phase 3: Dashboard UI ─────────────────────────────
+
+[[stages]]
+id = "dashboard-ui"
+name = "Dashboard UI Components"
+type = "seq"
+team = "implementors"
+depends_on = ["fix-data"]
+prompt = """
+Read ARCHITECTURE.md Section 7 (Component Tree). Implement the React dashboard UI:
+
+1. App shell (App.tsx) — sidebar nav + main content area
+2. Dashboard page — summary cards (total sessions, total events, tool calls today) + charts
+3. Charts — session count over time (line), events by agent (bar), tool call frequency (bar), model usage (pie)
+4. Session browser page — filterable list of all sessions, search by repo/agent/date
+5. Session detail page — event timeline with kind icons, expandable tool call details
+6. Settings page — configure watched directories, rescan interval
+7. useRPC hook — typed wrapper around Electroview RPC calls
+
+Use Tailwind v4 for all styling. Dark theme by default.
+Use Recharts for charts.
+
+Verify:
+- Vite build compiles without errors
+- All components render (no runtime crashes on import)
+"""
+output = { format = "markdown", name = "dashboard-ui.md" }
+
+[[stages]]
+id = "qa-ui"
+name = "QA Dashboard UI"
+type = "seq"
+team = "reviewers"
+depends_on = ["dashboard-ui"]
+input_from = ["dashboard-ui"]
+prompt = """
+Read ARCHITECTURE.md Section 7 for expected components.
+
+Verify the dashboard UI:
+1. Vite build compiles without errors
+2. All pages/components exist per spec
+3. RPC hooks are properly typed
+4. Tailwind classes are valid
+5. Dark theme is consistent
+6. No hardcoded data — all data comes through RPC
+
+Output JSON: { "verdict": "pass" or "fail", "issues": [...] }
+"""
+output = { format = "json", name = "qa-ui.json" }
+
+[[stages]]
+id = "fix-ui"
+name = "Fix UI Issues"
+type = "loop"
+team = "implementors"
+depends_on = ["qa-ui"]
+input_from = ["qa-ui"]
+prompt = "Fix all issues from QA report."
+max_loops = 2
+loop_to = "qa-ui"
+condition = "qa-ui.verdict != 'pass'"
+output = { format = "diff", name = "ui-fixes.diff" }
+
+# ─── Phase 4: Native Integration ───────────────────────
+
+[[stages]]
+id = "native"
+name = "Tray, Menu & Window Polish"
+type = "seq"
+team = "implementors"
+depends_on = ["fix-ui"]
+prompt = """
+Read ARCHITECTURE.md Section 11 (Main Process Behavior). Implement native desktop integration:
+
+1. System tray:
+   - Show app icon in tray
+   - Tray menu: quick stats (today's sessions/events), "Show Dashboard", "Rescan Sessions", "Quit"
+   - Clicking tray icon shows/hides main window
+
+2. Application menu:
+   - Standard Edit menu (undo, redo, cut, copy, paste, selectAll)
+   - File menu: "Rescan Sessions" action, "Quit"
+   - View menu: "Toggle Dark Mode"
+
+3. Window behavior:
+   - Close button minimizes to tray (on macOS)
+   - Proper quit via menu or tray
+
+Verify:
+- Main process starts without errors
+- Tray icon appears
+- Menu items are functional
+"""
+output = { format = "markdown", name = "native.md" }
+
+[[stages]]
+id = "qa-native"
+name = "QA Native Integration"
+type = "seq"
+team = "reviewers"
+depends_on = ["native"]
+input_from = ["native"]
+prompt = """
+Verify native integration:
+1. Tray icon creates without errors
+2. Application menu has all required items
+3. Menu actions are wired to handlers
+4. Window close behavior is correct
+5. Main process starts and creates window + tray
+
+Output JSON: { "verdict": "pass" or "fail", "issues": [...] }
+"""
+output = { format = "json", name = "qa-native.json" }
+
+[[stages]]
+id = "fix-native"
+name = "Fix Native Issues"
+type = "loop"
+team = "implementors"
+depends_on = ["qa-native"]
+input_from = ["qa-native"]
+prompt = "Fix all issues from QA report."
+max_loops = 2
+loop_to = "qa-native"
+condition = "qa-native.verdict != 'pass'"
+output = { format = "diff", name = "native-fixes.diff" }
+
+# ─── Phase 5: Final ────────────────────────────────────
+
+[[stages]]
+id = "commit"
+name = "Final Commit"
+type = "seq"
+team = "global"
+depends_on = ["fix-native"]
+prompt = """
+Review git diff. Stage all new/modified files. Commit with descriptive message:
+"feat: ai-stats — Electrobun desktop dashboard for AI agent session analytics"
+
+Do NOT push.
+"""
+tools = ["Read", "Glob", "Grep", "Bash"]
+output = { format = "markdown", name = "commit.md" }

package/.0spec/flows/ai-stats-fix.toml

@@ -0,0 +1,285 @@
+[flow]
+name = "ai-stats-fix"
+description = "Fix ai-stats: remove SQLite, simplify to JSON store, Spotify Wrapped-style dashboard"
+
+# ─── Phase 1: Rip out SQLite, replace with JSON file store ─────
+
+[[stages]]
+id = "json-store"
+name = "Replace SQLite with JSON File Store"
+type = "seq"
+team = "implementors"
+prompt = """
+The app currently uses SQLite (bun:sqlite) for all data storage. This causes crashes
+(UNIQUE constraint errors on events.id) and is overkill. Replace it entirely.
+
+**What to do:**
+
+1. Delete `src/bun/db.ts` entirely.
+
+2. Create `src/bun/store.ts` — a simple JSON file store:
+   - Data dir: `~/.ai-stats/` (create with mkdirSync recursive)
+   - Files:
+     - `~/.ai-stats/scan-state.json` — record of parsed files: `Record<filePath, { source, fileSize, mtimeMs, parsedAt }>`
+     - `~/.ai-stats/daily.json` — daily aggregates: `Record<date, { bySource: Record<source, DayStats>, byModel: Record<model, DayStats>, totals: DayStats }>`
+       where DayStats = `{ sessions, messages, toolCalls, inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens, reasoningTokens, costUsd, durationMs }`
+     - `~/.ai-stats/settings.json` — app settings
+   - Read/write with Bun.file() / Bun.write() + JSON.parse/stringify
+   - No locking needed — single process app
+   - Load lazily on first access, cache in memory, flush on write
+
+3. Update `src/bun/scan.ts`:
+   - Remove all DB imports
+   - Use the new store for scan state checks (skip already-parsed files by path+mtime+size)
+   - After parsing sessions, aggregate into daily.json instead of SQLite
+   - Do NOT store individual sessions or events — only aggregate stats per day
+   - Each scan: discover files → parse → compute daily aggregates → merge into daily.json
+
+4. Update `src/bun/aggregator.ts`:
+   - Implement actual aggregation: take parsed sessions, group by date, accumulate stats
+   - Merge into existing daily.json (additive for new dates, replace for re-scanned dates)
+
+5. Update `src/bun/index.ts` (main process):
+   - Remove `import { openDatabase } from "./db"` and all `db.` calls
+   - Import from `./store` instead
+   - Update RPC handlers to read from JSON store
+
+6. Update `src/shared/types.ts` — simplify RPC:
+   - REMOVE these RPCs: getSessions, getSession, getSessionEvents, getDistinctModels, getDistinctRepos, getDbStats, vacuumDatabase
+   - KEEP these RPCs: getDashboardSummary, getDailyTimeline, triggerScan, getScanStatus, getTrayStats, getSettings, updateSettings
+   - getDashboardSummary reads from daily.json and computes totals
+   - getDailyTimeline reads date range from daily.json
+
+7. Update `src/shared/schema.ts`:
+   - Remove `Session`, `SessionEvent`, `SessionFilters`, `ScanState` interfaces (no longer exposed to frontend)
+   - Keep `TokenUsage`, `DashboardSummary`, `DailyAggregate`, `TrayStats`, `SessionSource`
+
+8. Remove `bun:sqlite` from any imports. Remove sqlite-related deps from package.json if any.
+
+**Verify:**
+- `bun install` succeeds
+- Vite build compiles without errors
+- No references to bun:sqlite remain
+- No references to db.ts remain
+"""
+output = { format = "markdown", name = "json-store.md" }
+
+[[stages]]
+id = "qa-store"
+name = "QA JSON Store"
+type = "seq"
+team = "reviewers"
+depends_on = ["json-store"]
+input_from = ["json-store"]
+prompt = """
+Verify the SQLite removal and JSON store replacement:
+
+1. `bun:sqlite` is not imported anywhere: `grep -r "bun:sqlite" src/`
+2. `db.ts` does not exist
+3. `src/bun/store.ts` exists and implements read/write for scan-state.json, daily.json, settings.json
+4. `src/bun/scan.ts` uses store, not db
+5. `src/bun/index.ts` uses store, not db
+6. RPC types in shared/types.ts have no session/event RPCs
+7. schema.ts has no Session/SessionEvent/SessionFilters interfaces
+8. Vite build compiles without errors
+9. TypeScript has no type errors (check with `bunx tsc --noEmit` or esbuild)
+
+Output JSON: { "verdict": "pass" or "fail", "issues": [...] }
+"""
+output = { format = "json", name = "qa-store.json" }
+
+[[stages]]
+id = "fix-store"
+name = "Fix Store Issues"
+type = "loop"
+team = "implementors"
+depends_on = ["qa-store"]
+input_from = ["qa-store"]
+prompt = "Fix all issues from QA report."
+max_loops = 2
+loop_to = "qa-store"
+condition = "qa-store.verdict != 'pass'"
+output = { format = "diff", name = "store-fixes.diff" }
+
+# ─── Phase 2: Spotify Wrapped-style UI ─────────────────────
+
+[[stages]]
+id = "wrapped-ui"
+name = "Spotify Wrapped Dashboard"
+type = "seq"
+team = "implementors"
+depends_on = ["fix-store"]
+prompt = """
+Transform the dashboard into a Spotify Wrapped-style visual experience. This should feel like
+an annual review / "Your Year in Code" summary — bold typography, gradient backgrounds,
+animated stat reveals, and visual flair.
+
+**Delete these files** (session detail features removed):
+- src/mainview/components/SessionDetail.tsx
+- src/mainview/components/SessionList.tsx
+- src/mainview/components/SessionListItem.tsx
+- src/mainview/components/EventTimeline.tsx
+- src/mainview/components/EventItem.tsx
+- src/mainview/components/FilterBar.tsx
+- src/mainview/components/SearchInput.tsx
+- src/mainview/hooks/useSessionDetail.ts
+- src/mainview/hooks/useSessions.ts
+- src/mainview/lib/filters.ts
+- All *.test.tsx files
+
+**Redesign App.tsx:**
+- Remove sidebar navigation — single-page "Wrapped" scroll experience
+- Remove "sessions" and "session-detail" views entirely
+- Keep a small gear icon for settings (modal overlay, not separate page)
+- Full-screen scrollable cards
+
+**Create new Wrapped-style Dashboard (replace existing Dashboard.tsx, DashboardCharts.tsx, StatsCards.tsx):**
+
+The dashboard is a vertical scroll of full-width "cards" — each card fills most of the viewport
+and showcases one stat category with bold visuals:
+
+Card 1: "Your AI Coding Year" hero
+  - Big animated counter: total sessions, total cost, total tokens
+  - Gradient background (dark purple → blue → teal)
+  - Date range shown subtly
+
+Card 2: "Time Spent Coding with AI"
+  - Total hours/days spent
+  - Average session duration
+  - Longest session highlight
+  - Animated circular progress ring
+
+Card 3: "Your Top Models"
+  - Ranked list of models by usage (tokens or cost)
+  - Horizontal bar chart with model colors
+  - Percentage breakdown
+
+Card 4: "Your Agents"
+  - Agent breakdown (Claude, Codex, Gemini, etc.)
+  - Each agent gets an icon/emoji and stats
+  - Donut chart showing distribution
+
+Card 5: "Daily Activity"
+  - Heatmap-style grid (like GitHub contribution graph) or area chart
+  - Shows daily token usage or session count over time
+
+Card 6: "Cost Breakdown"
+  - Total spend with big number
+  - Daily average
+  - Most expensive day
+  - Trend line
+
+Card 7: "Your Top Repos"
+  - List of repos by session count and cost
+  - Bar chart
+
+**Visual style:**
+- Dark theme default — deep navy/charcoal backgrounds
+- Each card has a subtle gradient or accent color
+- Use CSS animations for number counters (count up on scroll into view)
+- Large typography (3xl-6xl for hero numbers)
+- Rounded cards with glassmorphism borders (subtle white/10 border, backdrop-blur)
+- Recharts for data visualization where needed
+- Smooth scroll-snap between cards
+- Responsive — works on smaller windows too
+
+**Data source:**
+- All data comes from RPC `getDashboardSummary` and `getDailyTimeline`
+- No session-level data needed
+
+**Hooks:**
+- Keep `useDashboardData.ts` but simplify to only fetch summary + timeline
+- Remove session-related hooks
+- Update `useRPC.ts` to remove session RPCs
+
+**Update Sidebar.tsx:**
+- Remove it entirely or replace with a minimal floating nav
+- Just a small settings gear + app title
+
+**Verify:**
+- Vite build compiles
+- No imports of deleted files remain
+- No TypeScript errors
+"""
+output = { format = "markdown", name = "wrapped-ui.md" }
+
+[[stages]]
+id = "qa-wrapped"
+name = "QA Wrapped UI"
+type = "seq"
+team = "reviewers"
+depends_on = ["wrapped-ui"]
+input_from = ["wrapped-ui"]
+prompt = """
+Verify the Wrapped UI transformation:
+
+1. Deleted files are gone (SessionDetail, SessionList, EventTimeline, etc.)
+2. No imports of deleted files remain anywhere
+3. Sidebar is removed or minimal
+4. App.tsx has no "sessions" or "session-detail" views
+5. Dashboard renders a scroll of visual cards (check component structure)
+6. RPC calls are only getDashboardSummary and getDailyTimeline
+7. Vite build compiles
+8. TypeScript has no errors
+9. All Recharts imports are valid
+10. CSS uses dark theme with gradients
+
+Output JSON: { "verdict": "pass" or "fail", "issues": [...] }
+"""
+output = { format = "json", name = "qa-wrapped.json" }
+
+[[stages]]
+id = "fix-wrapped"
+name = "Fix Wrapped UI Issues"
+type = "loop"
+team = "implementors"
+depends_on = ["qa-wrapped"]
+input_from = ["qa-wrapped"]
+prompt = "Fix all issues from QA report."
+max_loops = 2
+loop_to = "qa-wrapped"
+condition = "qa-wrapped.verdict != 'pass'"
+output = { format = "diff", name = "wrapped-fixes.diff" }
+
+# ─── Phase 3: Integration test + commit ─────────────────────
+
+[[stages]]
+id = "integration"
+name = "Integration Smoke Test"
+type = "seq"
+team = "implementors"
+depends_on = ["fix-wrapped"]
+prompt = """
+Final integration check:
+
+1. Run `bun install` — must succeed
+2. Run Vite build — must succeed with no errors
+3. Run `bunx tsc --noEmit` or esbuild check — no type errors
+4. Verify no references to:
+   - bun:sqlite
+   - db.ts
+   - SessionDetail, SessionList, EventTimeline, EventItem
+   - querySessions, getSessionEvents, getSession
+5. Verify ~/.ai-stats/ directory structure works:
+   - The store module can create the directory
+   - Can write and read JSON files
+6. Fix any remaining issues.
+
+Report what you found and fixed.
+"""
+output = { format = "markdown", name = "integration.md" }
+
+[[stages]]
+id = "commit"
+name = "Final Commit"
+type = "seq"
+team = "global"
+depends_on = ["integration"]
+prompt = """
+Review git diff. Stage all new/modified files and deleted files. Commit with message:
+"refactor: remove SQLite, add JSON store, Spotify Wrapped-style dashboard"
+
+Do NOT push.
+"""
+tools = ["Read", "Glob", "Grep", "Bash"]
+output = { format = "markdown", name = "commit.md" }