@pi-archimedes/footer 2.10.3 → 2.11.0

package/src/utils/vcs-change-events.ts

@@ -0,0 +1,38 @@
+/**
+ * A tiny change bus for the VCS facts the footer displays (git status counts,
+ * linked-worktree answer, jj bookmark and changed-file count).
+ *
+ * Those facts are refreshed in the background (`execFile`) so a render never
+ * blocks, but a background reply has no way to say "the value you painted is
+ * now wrong": pi draws a frame only when the host requests one, so the footer
+ * would keep showing the stale number until unrelated activity repaints it.
+ * The utils that own a cache publish here when a refresh actually changed the
+ * visible value, and the footer subscribes and requests a render.
+ *
+ * Listeners are notified only on a *change* — a refresh that returns the same
+ * value stays silent, otherwise the 2s cache TTL would drive a render every
+ * two seconds forever.
+ */
+
+export type VcsChangeListener = () => void;
+
+const listeners = new Set<VcsChangeListener>();
+
+/** Subscribe to visible VCS changes. Returns an unsubscribe function. */
+export function onVcsChange(listener: VcsChangeListener): () => void {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+/** Tell subscribers the displayed VCS facts changed. Never throws. */
+export function notifyVcsChange(): void {
+  for (const listener of [...listeners]) {
+    try {
+      listener();
+    } catch {
+      /* a listener must not break the refresh callback that published */
+    }
+  }
+}

package/src/cost-accumulator.test.ts

@@ -1,85 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { CostAccumulator } from "./cost-accumulator.js";
-import { getBus, Events } from "@pi-archimedes/core/bus";
-
-// ── globalThis cleanup ──────────────────────────────────────────────────────
-
-const BUS_KEY = Symbol.for("archimedes:bus");
-const QUEUE_KEY = Symbol.for("archimedes:busQueue");
-
-afterEach(() => {
-  delete (globalThis as Record<symbol, unknown>)[BUS_KEY];
-  delete (globalThis as Record<symbol, unknown>)[QUEUE_KEY];
-});
-
-// ── CostAccumulator ─────────────────────────────────────────────────────────
-
-describe("CostAccumulator", () => {
-  let accumulator: CostAccumulator;
-
-  beforeEach(() => {
-    accumulator = new CostAccumulator();
-    accumulator.subscribe();
-  });
-
-  it("accumulates input tokens from cost events", () => {
-    getBus().emit(Events.COST_UPDATE, { inputTokens: 100, outputTokens: 50 });
-    expect(accumulator.inputTokens).toBe(100);
-    expect(accumulator.outputTokens).toBe(50);
-  });
-
-  it("accumulates cache read/write tokens", () => {
-    getBus().emit(Events.COST_UPDATE, {
-      cacheReadTokens: 200,
-      cacheWriteTokens: 100,
-    });
-    expect(accumulator.cacheReadTokens).toBe(200);
-    expect(accumulator.cacheWriteTokens).toBe(100);
-  });
-
-  it("accumulates cost", () => {
-    getBus().emit(Events.COST_UPDATE, { cost: 0.015 });
-    expect(accumulator.cost).toBe(0.015);
-  });
-
-  it("multiple cost updates accumulate correctly", () => {
-    getBus().emit(Events.COST_UPDATE, { inputTokens: 100, cost: 0.01 });
-    getBus().emit(Events.COST_UPDATE, { inputTokens: 200, cost: 0.02 });
-    getBus().emit(Events.COST_UPDATE, { inputTokens: 300, cost: 0.03 });
-    expect(accumulator.inputTokens).toBe(600);
-    expect(accumulator.cost).toBe(0.06);
-  });
-
-  it("missing fields in payload default to 0", () => {
-    getBus().emit(Events.COST_UPDATE, {});
-    expect(accumulator.inputTokens).toBe(0);
-    expect(accumulator.outputTokens).toBe(0);
-    expect(accumulator.cacheReadTokens).toBe(0);
-    expect(accumulator.cacheWriteTokens).toBe(0);
-    expect(accumulator.cost).toBe(0);
-  });
-
-  it("reset zeroes all counters", () => {
-    getBus().emit(Events.COST_UPDATE, { inputTokens: 100, cost: 0.01 });
-    accumulator.reset();
-    expect(accumulator.inputTokens).toBe(0);
-    expect(accumulator.outputTokens).toBe(0);
-    expect(accumulator.cacheReadTokens).toBe(0);
-    expect(accumulator.cacheWriteTokens).toBe(0);
-    expect(accumulator.cost).toBe(0);
-  });
-
-  it("dispose unsubscribes — subsequent events not accumulated", () => {
-    getBus().emit(Events.COST_UPDATE, { inputTokens: 100 });
-    accumulator.dispose();
-    getBus().emit(Events.COST_UPDATE, { inputTokens: 500 });
-    expect(accumulator.inputTokens).toBe(100);
-  });
-
-  it("subsequent events not accumulated after dispose", () => {
-    getBus().emit(Events.COST_UPDATE, { cost: 0.01 });
-    accumulator.dispose();
-    getBus().emit(Events.COST_UPDATE, { cost: 0.05 });
-    expect(accumulator.cost).toBe(0.01);
-  });
-});

package/src/cost-accumulator.ts

@@ -1,35 +0,0 @@
-import { getBus, Events, type CostUpdatePayload } from "@pi-archimedes/core/bus";
-
-export class CostAccumulator {
-  inputTokens = 0;
-  outputTokens = 0;
-  cacheReadTokens = 0;
-  cacheWriteTokens = 0;
-  cost = 0;
-  private unsubscribes: Array<() => void> = [];
-
-  subscribe(): void {
-    const unsub = getBus().on(Events.COST_UPDATE, (payload: unknown) => {
-      const data = payload as CostUpdatePayload;
-      this.inputTokens += data.inputTokens ?? 0;
-      this.outputTokens += data.outputTokens ?? 0;
-      this.cacheReadTokens += data.cacheReadTokens ?? 0;
-      this.cacheWriteTokens += data.cacheWriteTokens ?? 0;
-      this.cost += data.cost ?? 0;
-    });
-    this.unsubscribes.push(unsub);
-  }
-
-  reset(): void {
-    this.inputTokens = 0;
-    this.outputTokens = 0;
-    this.cacheReadTokens = 0;
-    this.cacheWriteTokens = 0;
-    this.cost = 0;
-  }
-
-  dispose(): void {
-    this.unsubscribes.forEach(unsub => unsub());
-    this.unsubscribes = [];
-  }
-}