@mohndoe/pi-atlas 0.1.1

package/src/components/__tests__/Dashboard.test.ts

@@ -0,0 +1,452 @@
+import { describe, expect, it } from "bun:test";
+import { makeMockTUI, makeRangeSelector, makeTheme } from "../../__tests__/components.fixtures";
+import { makeSummary } from "../../__tests__/compute.fixtures";
+import type { StatsSummary, TimeRange } from "../../types";
+import { Dashboard } from "../Dashboard";
+
+const mockTui = makeMockTUI();
+export const allRanges: TimeRange[] = ["1d", "7d", "30d", "All"];
+
+export function mapAllSummaries(ranges: TimeRange[], summary: ReturnType<typeof makeSummary>) {
+  return new Map(ranges.map((r) => [r, { ...summary }]));
+}
+
+export const ALL_SUMMARIES = mapAllSummaries(allRanges, makeSummary());
+
+describe("Dashboard", () => {
+  it("renders all sections", () => {
+    const summaries = ALL_SUMMARIES;
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+    expect(text).toContain("Overview");
+    expect(text).toContain("All time");
+    expect(text).toContain("Total");
+    expect(text).toContain("Esc/q close");
+    expect(text).toContain("█");
+  });
+
+  it("shows 'No sessions found' when no session data exists", () => {
+    const zeroSummary = {
+      ...makeSummary(),
+      totalCost: 0,
+      sessionCount: 0,
+      totalMessages: 0,
+      totalTokens: 0,
+      dailySpend: [],
+    };
+    const summaries = mapAllSummaries(allRanges, zeroSummary);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+    expect(text).toContain("No sessions found");
+  });
+
+  it("shows 'No data for this time range' when current range is empty", () => {
+    const dataSummary = { ...makeSummary(), totalCost: 5.0, sessionCount: 3 };
+    const zeroSummary = {
+      ...makeSummary(),
+      totalCost: 0,
+      sessionCount: 0,
+      totalMessages: 0,
+      totalTokens: 0,
+      dailySpend: [],
+    };
+    // 1d range empty, others have data
+    const summaries: Map<TimeRange, StatsSummary> = new Map([
+      ["1d", zeroSummary],
+      ["7d", dataSummary],
+      ["30d", dataSummary],
+      ["All", dataSummary],
+    ]);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+    // Default range is All. r key cycles: All→1d
+    dash.handleInput("r");
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+    expect(text).toContain("No data for this time range");
+  });
+
+  it("handles escape to close", () => {
+    const summaries = ALL_SUMMARIES;
+    let closed = false;
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+      () => {
+        closed = true;
+      },
+    );
+    dash.handleInput("\x1b");
+    expect(closed).toBe(true);
+  });
+
+  it("handles q to close", () => {
+    const summaries = ALL_SUMMARIES;
+    let closed = false;
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+      () => {
+        closed = true;
+      },
+    );
+    dash.handleInput("q");
+    expect(closed).toBe(true);
+  });
+
+  it("renders Languages tab when active", () => {
+    const summary = {
+      ...makeSummary(),
+      languages: [
+        { language: "TypeScript", lines: 1500, edits: 45 },
+        { language: "Python", lines: 800, edits: 20 },
+        { language: "JSON", lines: 300, edits: 5 },
+      ],
+    };
+    const summaries = mapAllSummaries(allRanges, summary);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    // Switch to Languages tab (index 1)
+    dash.handleInput("\x1b[C"); // right arrow
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+
+    expect(text).toContain("Languages");
+    expect(text).toContain("TypeScript");
+    expect(text).toContain("Python");
+    expect(text).toContain("JSON");
+    expect(text).toContain("1.5k");
+    expect(text).toContain("800");
+  });
+
+  it("Languages tab updates when time range changes", () => {
+    const summary1d = {
+      ...makeSummary(),
+      languages: [{ language: "TypeScript", lines: 100, edits: 3 }],
+    };
+    const summary7d = {
+      ...makeSummary(),
+      languages: [
+        { language: "TypeScript", lines: 1500, edits: 45 },
+        { language: "Go", lines: 200, edits: 8 },
+      ],
+    };
+    const summaries: Map<TimeRange, StatsSummary> = new Map([
+      ["1d", summary1d],
+      ["7d", summary7d],
+      ["30d", summary7d],
+      ["All", summary7d],
+    ]);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    // Default range is All (= summary7d). r key cycles: All→1d
+    dash.handleInput("r"); // All → 1d
+    // Switch to Languages tab
+    dash.handleInput("\x1b[C"); // right to Languages
+    let lines = dash.render(80);
+    let text = lines.join("\n");
+    // Range 1d, only 1 language
+    expect(text).toContain("TypeScript");
+    expect(text).not.toContain("Go");
+
+    // Switch back to Overview, r to 7d, then back to Languages
+    dash.handleInput("\x1b[D"); // left to Overview
+    dash.handleInput("r"); // 1d → 7d
+    dash.handleInput("\x1b[C"); // right to Languages
+    lines = dash.render(80);
+    text = lines.join("\n");
+    expect(text).toContain("Go");
+  });
+
+  it("Languages tab shows empty state when no language data", () => {
+    const summary = { ...makeSummary(), languages: [] };
+    const summaries = mapAllSummaries(allRanges, summary);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    dash.handleInput("\x1b[C"); // right to Languages
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+    expect(text).toContain("No language data");
+  });
+
+  // ---- Models tab ----
+
+  it("renders Models tab", () => {
+    const summary = {
+      ...makeSummary(),
+      models: [
+        { model: "claude-sonnet-4-20250514", cost: 12.34, calls: 150 },
+        { model: "deepseek-v4-pro", cost: 5.67, calls: 80 },
+        { model: "gemini-2.0-flash", cost: 1.23, calls: 40 },
+      ],
+    };
+    const summaries = mapAllSummaries(allRanges, summary);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    // Switch to Models tab (index 2)
+    dash.handleInput("\x1b[C"); // right to Languages
+    dash.handleInput("\x1b[C"); // right to Models
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+
+    expect(text).toContain("Model");
+    expect(text).toContain("Provider");
+  });
+
+  it("formats model names in Models tab", () => {
+    const summary = {
+      ...makeSummary(),
+      models: [{ model: "claude-sonnet-4-20250514", cost: 1.0, calls: 10 }],
+    };
+    const summaries = mapAllSummaries(allRanges, summary);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    // Navigate to Models tab
+    dash.handleInput("\x1b[C"); // → Languages
+    dash.handleInput("\x1b[C"); // → Models
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+
+    expect(text).toContain("Claude");
+    expect(text).not.toContain("claude-sonnet-4-20250514");
+  });
+
+  it("Models tab shows empty state when no model data", () => {
+    const summary = { ...makeSummary(), models: [] };
+    const summaries = mapAllSummaries(allRanges, summary);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    dash.handleInput("\x1b[C"); // → Languages
+    dash.handleInput("\x1b[C"); // → Models
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+    expect(text).toContain("No model data");
+  });
+
+  it("Models tab updates when time range changes", () => {
+    const summary1d = {
+      ...makeSummary(),
+      models: [{ model: "claude-sonnet-4-20250514", cost: 1.0, calls: 5 }],
+    };
+    const summary7d = {
+      ...makeSummary(),
+      models: [
+        { model: "claude-sonnet-4-20250514", cost: 12.0, calls: 150 },
+        { model: "deepseek-v4-pro", cost: 5.0, calls: 80 },
+      ],
+    };
+    const summaries: Map<TimeRange, StatsSummary> = new Map([
+      ["1d", summary1d],
+      ["7d", summary7d],
+      ["30d", summary7d],
+      ["All", summary7d],
+    ]);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    // Default range is All (= summary7d). r key cycles: All→1d
+    dash.handleInput("r"); // All → 1d
+    dash.handleInput("\x1b[C"); // → Languages
+    dash.handleInput("\x1b[C"); // → Models
+    let lines = dash.render(80);
+    let text = lines.join("\n");
+    // Range 1d, only 1 model
+    expect(text).toContain("Claude");
+    // deepseek-v4-pro → "Deeps…" visible truncated name in 7d range
+    expect(text).not.toContain("Deeps");
+
+    // Switch back to Overview, r to 7d, then back to Models
+    dash.handleInput("\x1b[D"); // left to Languages
+    dash.handleInput("\x1b[D"); // left to Overview
+    dash.handleInput("r"); // 1d → 7d
+    dash.handleInput("\x1b[C"); // → Languages
+    dash.handleInput("\x1b[C"); // → Models
+    lines = dash.render(80);
+    text = lines.join("\n");
+    expect(text).toContain("Deeps");
+  });
+
+  it("switches tabs with left/right arrows", () => {
+    const summaries = ALL_SUMMARIES;
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+    dash.handleInput("\x1b[C"); // right
+    const lines = dash.render(80);
+    expect(lines.join("\n")).toContain("Languages");
+  });
+
+  // ---- Projects tab ----
+
+  it("renders Project tab", () => {
+    const summary = {
+      ...makeSummary(),
+      projects: [
+        { project: "pi-atlas", cost: 15.5, sessions: 42 },
+        { project: "dotfiles", cost: 8.2, sessions: 20 },
+      ],
+      tools: [
+        { name: "bash", count: 150 },
+        { name: "read", count: 120 },
+      ],
+    };
+    const summaries = mapAllSummaries(allRanges, summary);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    // Navigate to Projects+Tools tab (index 3)
+    dash.handleInput("\x1b[C"); // → Languages
+    dash.handleInput("\x1b[C"); // → Models
+    dash.handleInput("\x1b[C"); // → Projects + Tools
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+
+    expect(text).toContain("Projects");
+  });
+
+  it("Projects tab shows empty states when no data", () => {
+    const summary = { ...makeSummary(), projects: [], tools: [] };
+    const summaries = mapAllSummaries(allRanges, summary);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    dash.handleInput("\x1b[C"); // → Languages
+    dash.handleInput("\x1b[C"); // → Models
+    dash.handleInput("\x1b[C"); // → Projects + Tools
+    const lines = dash.render(80);
+    const text = lines.join("\n");
+
+    expect(text).toContain("No projects data");
+  });
+
+  it("Projects tab updates when time range changes", () => {
+    const summary1d = {
+      ...makeSummary(),
+      projects: [{ project: "pi-atlas", cost: 1.0, sessions: 5 }],
+    };
+    const summary7d = {
+      ...makeSummary(),
+      projects: [
+        { project: "pi-atlas", cost: 15.5, sessions: 42 },
+        { project: "dotfiles", cost: 8.2, sessions: 20 },
+      ],
+    };
+    const summaries: Map<TimeRange, StatsSummary> = new Map([
+      ["1d", summary1d],
+      ["7d", summary7d],
+      ["30d", summary7d],
+      ["All", summary7d],
+    ]);
+    const dash = new Dashboard(
+      summaries,
+      makeTheme(),
+      mockTui,
+      null,
+      makeRangeSelector(makeTheme()),
+    );
+
+    // Default range is All (= summary7d). r key cycles: All→1d
+    dash.handleInput("r"); // All → 1d
+    dash.handleInput("\x1b[C"); // → Languages
+    dash.handleInput("\x1b[C"); // → Models
+    dash.handleInput("\x1b[C"); // → Projects
+    let lines = dash.render(80);
+    let text = lines.join("\n");
+    // 1d range: only pi-atlas
+    expect(text).toContain("pi-atlas");
+    expect(text).not.toContain("dotfiles");
+
+    // Switch back to Overview, r to 7d, then back to Projects+Tools
+    dash.handleInput("\x1b[D"); // ← Models
+    dash.handleInput("\x1b[D"); // ← Languages
+    dash.handleInput("\x1b[D"); // ← Overview
+    dash.handleInput("r"); // 1d → 7d
+    dash.handleInput("\x1b[C"); // → Languages
+    dash.handleInput("\x1b[C"); // → Models
+    dash.handleInput("\x1b[C"); // → Projects + Tools
+    lines = dash.render(80);
+    text = lines.join("\n");
+    expect(text).toContain("dotfiles");
+    expect(text).toContain("pi-atlas");
+  });
+});

package/src/components/__tests__/KpiCards.test.ts

@@ -0,0 +1,83 @@
+import { describe, expect, it } from "bun:test";
+import { makeTheme } from "../../__tests__/components.fixtures";
+import { KpiCards } from "../KpiCards";
+
+describe("KpiCards", () => {
+  const kpis = {
+    totalCost: 12.34,
+    sessionCount: 42,
+    totalMessages: 1500,
+    totalTokens: 250000,
+    daysActive: 7,
+    avgCostPerDay: 1.76,
+  };
+
+  it("renders 6 KPIs in a grid", () => {
+    const cards = new KpiCards(kpis, makeTheme());
+    const lines = cards.render(80);
+    // Should have multiple lines (2 rows of 3 cards each)
+    expect(lines.length).toBeGreaterThanOrEqual(2);
+    // Should mention key metrics
+    const text = lines.join("\n");
+    expect(text).toContain("12.34");
+    expect(text).toContain("42");
+    expect(text).toContain("1.5k");
+    expect(text).toContain("250.0k");
+    expect(text).toContain("7");
+    expect(text).toContain("1.76");
+  });
+
+  it("renders label for each card", () => {
+    const cards = new KpiCards(kpis, makeTheme());
+    const lines = cards.render(80);
+    const text = lines.join("\n");
+    expect(text).toContain("Total");
+    expect(text).toContain("Sessions");
+    expect(text).toContain("Messages");
+    expect(text).toContain("Tokens");
+    expect(text).toContain("Active");
+    expect(text).toContain("Avg/Day");
+  });
+
+  it("renders within width", () => {
+    const cards = new KpiCards(kpis, makeTheme());
+    const lines = cards.render(50);
+    for (const line of lines) {
+      expect(line.length).toBeLessThanOrEqual(50);
+    }
+  });
+
+  it("formats large token numbers", () => {
+    const cards = new KpiCards({ ...kpis, totalTokens: 1500000 }, makeTheme());
+    const lines = cards.render(80);
+    expect(lines.join("\n")).toContain("1.50M");
+  });
+
+  it("formats large costs with compact notation", () => {
+    const cards = new KpiCards({ ...kpis, totalCost: 5432.1 }, makeTheme());
+    const lines = cards.render(80);
+    expect(lines.join("\n")).toContain("$5.4k");
+  });
+
+  it("formats very large costs with M notation", () => {
+    const cards = new KpiCards({ ...kpis, totalCost: 2_500_000 }, makeTheme());
+    const lines = cards.render(80);
+    expect(lines.join("\n")).toContain("$2.5M");
+  });
+
+  it("keeps exact notation for small costs", () => {
+    const cards = new KpiCards(kpis, makeTheme());
+    const lines = cards.render(80);
+    expect(lines.join("\n")).toContain("$12.34");
+  });
+
+  it("invalidates cache", () => {
+    const cards = new KpiCards(kpis, makeTheme());
+    cards.render(80);
+    cards.invalidate();
+    const lines = cards.render(60);
+    for (const line of lines) {
+      expect(line.length).toBeLessThanOrEqual(60);
+    }
+  });
+});

package/src/components/__tests__/LoadingView.test.ts

@@ -0,0 +1,26 @@
+import { describe, expect, it } from "bun:test";
+import { LoadingView } from "../LoadingView";
+
+describe("LoadingView", () => {
+  it("renders with 0% progress", () => {
+    const lv = new LoadingView();
+    const lines = lv.render(80);
+    expect(lines.join("\n")).toContain("Parsing session logs...");
+    expect(lines.join("\n")).toContain("0%");
+  });
+
+  it("updates progress", () => {
+    const lv = new LoadingView();
+    lv.setProgress(50);
+    const lines = lv.render(80);
+    expect(lines.join("\n")).toContain("50%");
+  });
+
+  it("renders progress bar with block chars", () => {
+    const lv = new LoadingView();
+    lv.setProgress(75);
+    const lines = lv.render(80);
+    expect(lines.join("\n")).toContain("█");
+    expect(lines.join("\n")).toContain("75%");
+  });
+});

package/src/components/__tests__/MarqueeText.test.ts

@@ -0,0 +1,75 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "bun:test";
+import { makeMockTUI } from "../../__tests__/components.fixtures";
+import { MarqueeText } from "../MarqueeText";
+
+describe("MarqueeText", () => {
+  let tui: ReturnType<typeof makeMockTUI>;
+
+  beforeEach(() => {
+    vi.useFakeTimers();
+    tui = makeMockTUI();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it("renders full text when it fits within width", () => {
+    const mt = new MarqueeText("Hello", tui);
+    const lines = mt.render(10);
+    expect(lines).toEqual(["Hello"]);
+  });
+
+  it("renders truncated window when text overflows", () => {
+    const mt = new MarqueeText("Hello World!", tui);
+    // tick=0, offset=0 → first 5 chars
+    const lines = mt.render(5);
+    expect(lines[0]).toBe("Hello");
+  });
+
+  it("advances tick via timer and shows next window", () => {
+    const mt = new MarqueeText("Hello World!", tui);
+    mt.render(5); // timer starts
+
+    // tick=0 → "Hello"
+    expect(mt.render(5)[0]).toBe("Hello");
+
+    // Advance 50ms = timer hasn't fired yet → still offset=0
+    vi.advanceTimersByTime(50);
+    expect(mt.render(5)[0]).toBe("Hello");
+
+    // Advance 100ms more = 1 timer tick at 150ms → offset=1 → "ello "
+    vi.advanceTimersByTime(100);
+    expect(mt.render(5)[0]).toBe("ello ");
+  });
+
+  it("wraps around when reaching end of content", () => {
+    const mt = new MarqueeText("ABCDEF", tui);
+    mt.render(3);
+
+    // Advance 600ms = 4 timer ticks → offset=4%11=4 → "EF "
+    // (5-space gap after text shows first gap space at position 6)
+    vi.advanceTimersByTime(600);
+    expect(mt.render(3)[0]).toBe("EF ");
+  });
+
+  it("resets marquee to start", () => {
+    const mt = new MarqueeText("Hello World!", tui);
+    mt.render(5);
+    vi.advanceTimersByTime(150); // 1 tick, offset=1
+    expect(mt.render(5)[0]).toBe("ello ");
+
+    mt.reset();
+    expect(mt.render(5)[0]).toBe("Hello");
+  });
+
+  it("handles empty string", () => {
+    const mt = new MarqueeText("", tui);
+    expect(mt.render(5)).toEqual([""]);
+  });
+
+  it("handles exact fit (text.length === width)", () => {
+    const mt = new MarqueeText("Hello", tui);
+    expect(mt.render(5)).toEqual(["Hello"]);
+  });
+});

package/src/components/__tests__/RangeSelector.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it } from "bun:test";
+import { makeTheme } from "../../__tests__/components.fixtures";
+import { type RangeOption, RangeSelector } from "../RangeSelector";
+
+describe("RangeSelector", () => {
+  const ranges: RangeOption[] = [
+    { label: "Today", value: "1d" },
+    { label: "Last 7 days", value: "7d" },
+    { label: "Last 30 days", value: "30d" },
+    { label: "All time", value: "All" },
+  ];
+
+  it("renders selected range label", () => {
+    for (const [index, { label }] of ranges.entries()) {
+      const rs = new RangeSelector(makeTheme(), ranges, index);
+      const lines = rs.render(80);
+      expect(lines).toHaveLength(1);
+      expect(lines[0]).toContain(label);
+    }
+  });
+
+  it("returns selectedValue from getter", () => {
+    for (const [index, { value }] of ranges.entries()) {
+      const rs = new RangeSelector(makeTheme(), ranges, index);
+      expect(rs.selectedValue).toBe(value);
+    }
+  });
+
+  it("renders within width", () => {
+    const rs = new RangeSelector(makeTheme(), ranges, 0);
+    const lines = rs.render(40);
+    expect(lines[0]!.length).toBeLessThanOrEqual(40);
+  });
+});