agentfit 0.1.0 → 0.1.2

package/CONTRIBUTING.md

@@ -1,209 +0,0 @@
-# Contributing a Community Plugin
-
-AgentFit has a plugin system that lets anyone contribute new analysis views. Your plugin appears in the **Community** sidebar section and receives the same usage data as built-in pages.
-
-## Quick Start
-
-```bash
-# 1. Fork & clone
-git clone https://github.com/<you>/agentfit && cd agentfit
-npm install
-
-# 2. Scaffold your plugin
-mkdir -p plugins/my-analysis
-
-# 3. Create the two required files (see below)
-# 4. Register it in plugins/index.ts
-# 5. Run dev server & tests
-npm run dev
-npm test
-```
-
-## Plugin Structure
-
-Every plugin lives in its own folder under `plugins/` and has exactly **two files** plus a test:
-
-```
-plugins/
-  my-analysis/
-    manifest.ts          # metadata (name, slug, icon, etc.)
-    component.tsx        # React component that renders the analysis
-    component.test.tsx   # tests (required for PR acceptance)
-```
-
-### manifest.ts
-
-```ts
-import type { PluginManifest } from '@/lib/plugins'
-
-const manifest: PluginManifest = {
-  slug: 'my-analysis',          // URL-safe, lowercase, hyphens only
-  name: 'My Analysis',          // shown in sidebar
-  description: 'One-line summary of what this shows',
-  author: 'your-github-handle',
-  icon: 'ChartArea',            // any lucide-react icon name
-  version: '1.0.0',
-  tags: ['cost', 'productivity'],  // optional, for discoverability
-}
-
-export default manifest
-```
-
-**Slug rules:** lowercase letters, numbers, hyphens only (e.g. `my-analysis`). Must be unique across all plugins.
-
-### component.tsx
-
-```tsx
-'use client'
-
-import { useMemo } from 'react'
-import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
-import type { PluginProps } from '@/lib/plugins'
-
-export default function MyAnalysis({ data }: PluginProps) {
-  const stats = useMemo(() => {
-    // Compute your analysis from data.sessions, data.daily, etc.
-    return { total: data.sessions.length }
-  }, [data])
-
-  return (
-    <Card>
-      <CardHeader>
-        <CardTitle>My Analysis</CardTitle>
-      </CardHeader>
-      <CardContent>
-        <p>Found {stats.total} sessions</p>
-      </CardContent>
-    </Card>
-  )
-}
-```
-
-### Registration
-
-Open `plugins/index.ts` and add your import + registration call:
-
-```ts
-// ─── Community plugins ──────────────────────────────────────────────
-import myAnalysisManifest from './my-analysis/manifest'
-import MyAnalysis from './my-analysis/component'
-registerPlugin(myAnalysisManifest, MyAnalysis)
-```
-
-That's it. Your plugin now appears in the sidebar at `/community/my-analysis`.
-
-## Data Available to Plugins
-
-Your component receives `PluginProps`:
-
-```ts
-interface PluginProps {
-  data: UsageData
-}
-```
-
-`UsageData` contains:
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `overview` | `OverviewStats` | Aggregated metrics (totals for sessions, tokens, cost, etc.) |
-| `sessions` | `SessionSummary[]` | Every session with tokens, cost, duration, tool calls |
-| `projects` | `ProjectSummary[]` | Per-project aggregations |
-| `daily` | `DailyUsage[]` | Per-day aggregations |
-| `toolUsage` | `Record<string, number>` | Tool invocation counts |
-
-All data is already filtered by the user's selected time range and agent type. You don't need to filter again.
-
-See `lib/parse-logs.ts` for the full type definitions.
-
-## UI Guidelines
-
-- Use **shadcn UI** components from `components/ui/` (Card, Badge, Table, etc.)
-- Use **Recharts** (already installed) for charts, wrapped in `ChartContainer`
-- Use `lib/format.ts` helpers: `formatCost()`, `formatTokens()`, `formatDuration()`
-- Use the existing CSS chart color variables: `--chart-1` through `--chart-10`
-- Mark your component as `'use client'` at the top
-- Wrap computed values in `useMemo` for performance
-
-## Writing Tests
-
-Every plugin must include tests. Use the provided test helpers:
-
-```tsx
-// plugins/my-analysis/component.test.tsx
-import { describe, it, expect } from 'vitest'
-import { screen } from '@testing-library/react'
-import { renderPlugin } from '@/tests/plugin-helpers'
-import { validateManifest } from '@/lib/plugins'
-import MyAnalysis from './component'
-import manifest from './manifest'
-
-describe('my-analysis plugin', () => {
-  it('manifest passes validation', () => {
-    expect(validateManifest(manifest)).toEqual([])
-  })
-
-  it('renders without crashing', () => {
-    const { container } = renderPlugin(MyAnalysis)
-    expect(container).toBeTruthy()
-  })
-
-  it('shows expected content', () => {
-    renderPlugin(MyAnalysis)
-    expect(screen.getByText('My Analysis')).toBeInTheDocument()
-  })
-
-  it('handles empty data', () => {
-    renderPlugin(MyAnalysis, { sessions: [], daily: [], projects: [] })
-    // Should not crash — show an empty state instead
-  })
-})
-```
-
-### Test utilities
-
-| Helper | Import | Description |
-|--------|--------|-------------|
-| `renderPlugin(Component, dataOverrides?)` | `@/tests/plugin-helpers` | Renders your plugin with mock `UsageData` |
-| `createMockData(overrides?)` | `@/tests/fixtures` | Creates a realistic `UsageData` object |
-| `createMockSession(overrides?)` | `@/tests/fixtures` | Creates a single `SessionSummary` |
-| `createMockDaily(overrides?)` | `@/tests/fixtures` | Creates a single `DailyUsage` |
-| `validateManifest(manifest)` | `@/lib/plugins` | Returns array of validation errors (empty = valid) |
-
-### Running tests
-
-```bash
-npm test                 # run all tests once
-npm run test:watch       # watch mode during development
-```
-
-## PR Checklist
-
-Before submitting your pull request:
-
-- [ ] Plugin folder is in `plugins/<your-slug>/`
-- [ ] `manifest.ts` passes `validateManifest()` with zero errors
-- [ ] `component.tsx` exports a default React component accepting `PluginProps`
-- [ ] Plugin is registered in `plugins/index.ts`
-- [ ] Tests exist in `component.test.tsx` and all pass (`npm test`)
-- [ ] Component handles empty data gracefully (no crashes)
-- [ ] No new dependencies added (use existing recharts, shadcn, lucide-react)
-- [ ] `npm run typecheck` passes
-- [ ] `npm run lint` passes
-
-## Advanced: Custom Data Sources
-
-If your plugin fetches its own data (e.g., from a custom API route), set `customDataSource: true` in your manifest. This hides the time-range filter when your plugin is active.
-
-```ts
-const manifest: PluginManifest = {
-  // ...
-  customDataSource: true,
-}
-```
-
-You can still use the `data` prop as a fallback, but you're free to `fetch()` additional data in a `useEffect`.
-
-## Example Plugin
-
-See `plugins/cost-heatmap/` for a complete working example with manifest, component, and tests.

package/prisma/migrations/20260328152517_init/migration.sql

@@ -1,41 +0,0 @@
--- CreateTable
-CREATE TABLE "Session" (
-    "id" TEXT NOT NULL PRIMARY KEY,
-    "sessionId" TEXT NOT NULL,
-    "project" TEXT NOT NULL,
-    "projectPath" TEXT NOT NULL,
-    "startTime" DATETIME NOT NULL,
-    "endTime" DATETIME NOT NULL,
-    "durationMinutes" REAL NOT NULL,
-    "userMessages" INTEGER NOT NULL,
-    "assistantMessages" INTEGER NOT NULL,
-    "totalMessages" INTEGER NOT NULL,
-    "inputTokens" INTEGER NOT NULL,
-    "outputTokens" INTEGER NOT NULL,
-    "cacheCreationTokens" INTEGER NOT NULL,
-    "cacheReadTokens" INTEGER NOT NULL,
-    "totalTokens" INTEGER NOT NULL,
-    "costUSD" REAL NOT NULL,
-    "model" TEXT NOT NULL,
-    "toolCallsTotal" INTEGER NOT NULL,
-    "toolCallsJson" TEXT NOT NULL,
-    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
-);
-
--- CreateTable
-CREATE TABLE "SyncLog" (
-    "id" TEXT NOT NULL PRIMARY KEY,
-    "syncedAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    "filesProcessed" INTEGER NOT NULL,
-    "sessionsAdded" INTEGER NOT NULL,
-    "sessionsSkipped" INTEGER NOT NULL
-);
-
--- CreateIndex
-CREATE UNIQUE INDEX "Session_sessionId_key" ON "Session"("sessionId");
-
--- CreateIndex
-CREATE INDEX "Session_project_idx" ON "Session"("project");
-
--- CreateIndex
-CREATE INDEX "Session_startTime_idx" ON "Session"("startTime");

package/prisma/migrations/20260328153801_add_image_model/migration.sql

@@ -1,18 +0,0 @@
--- CreateTable
-CREATE TABLE "Image" (
-    "id" TEXT NOT NULL PRIMARY KEY,
-    "sessionId" TEXT NOT NULL,
-    "messageId" TEXT NOT NULL,
-    "filename" TEXT NOT NULL,
-    "mediaType" TEXT NOT NULL,
-    "sizeBytes" INTEGER NOT NULL,
-    "timestamp" DATETIME NOT NULL,
-    "role" TEXT NOT NULL,
-    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
-);
-
--- CreateIndex
-CREATE INDEX "Image_sessionId_idx" ON "Image"("sessionId");
-
--- CreateIndex
-CREATE UNIQUE INDEX "Image_sessionId_messageId_filename_key" ON "Image"("sessionId", "messageId", "filename");

package/prisma.config.ts

@@ -1,14 +0,0 @@
-// This file was generated by Prisma, and assumes you have installed the following:
-// npm install --save-dev prisma dotenv
-import "dotenv/config";
-import { defineConfig } from "prisma/config";
-
-export default defineConfig({
-  schema: "prisma/schema.prisma",
-  migrations: {
-    path: "prisma/migrations",
-  },
-  datasource: {
-    url: process.env["DATABASE_URL"],
-  },
-});

package/setup.sh

@@ -1,73 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# ─── AgentFit Installer ─────────────────────────────────────────────
-# Usage:
-#   curl -fsSL https://raw.githubusercontent.com/harrywang/agentfit/main/setup.sh | bash
-#
-# Or clone manually:
-#   git clone https://github.com/harrywang/agentfit.git && cd agentfit && ./setup.sh
-# ─────────────────────────────────────────────────────────────────────
-
-REPO="https://github.com/harrywang/agentfit.git"
-DIR="agentfit"
-PORT="${AGENTFIT_PORT:-3000}"
-
-info()  { printf "\033[1;34m==>\033[0m %s\n" "$1"; }
-ok()    { printf "\033[1;32m==>\033[0m %s\n" "$1"; }
-error() { printf "\033[1;31m==>\033[0m %s\n" "$1" >&2; }
-
-# ─── Prerequisites ───────────────────────────────────────────────────
-
-command -v node >/dev/null 2>&1 || { error "Node.js is required. Install it from https://nodejs.org"; exit 1; }
-command -v npm  >/dev/null 2>&1 || { error "npm is required. It ships with Node.js."; exit 1; }
-
-NODE_MAJOR=$(node -e "process.stdout.write(String(process.versions.node.split('.')[0]))")
-if [ "$NODE_MAJOR" -lt 20 ]; then
-  error "Node.js 20+ is required (found v$(node -v)). Please upgrade."
-  exit 1
-fi
-
-# ─── Clone (skip if already inside the repo) ────────────────────────
-
-if [ ! -f "package.json" ] || ! grep -q '"agentfit"' package.json 2>/dev/null; then
-  if [ -d "$DIR" ]; then
-    info "Directory '$DIR' already exists — pulling latest..."
-    cd "$DIR"
-    git pull --ff-only
-  else
-    info "Cloning AgentFit..."
-    git clone "$REPO" "$DIR"
-    cd "$DIR"
-  fi
-fi
-
-# ─── Install ─────────────────────────────────────────────────────────
-
-info "Installing dependencies..."
-npm install
-
-# ─── Database ────────────────────────────────────────────────────────
-
-info "Setting up database..."
-echo 'DATABASE_URL="file:./dev.db"' > .env
-npx prisma generate
-npx prisma migrate deploy
-
-# ─── Build ───────────────────────────────────────────────────────────
-
-info "Building production bundle..."
-npm run build
-
-# ─── Done ────────────────────────────────────────────────────────────
-
-ok "AgentFit is ready!"
-echo ""
-echo "  Start the dashboard:"
-echo "    cd ${DIR} && npm start"
-echo ""
-echo "  Or run in dev mode:"
-echo "    cd ${DIR} && npm run dev"
-echo ""
-echo "  Then open http://localhost:${PORT}"
-echo ""