@planckspace/cli 0.1.1 → 0.2.0

package/dist/detectors/context-bloat.js

@@ -0,0 +1,68 @@
+import { estimateFileTokens } from "./fileTokens.js";
+const DAYS_30_MS = 30 * 24 * 60 * 60 * 1000;
+const CACHE_READ_RATE_PER_M = 0.30; // Sonnet 4 rate, $/M tokens
+const MIN_SESSIONS = 3;
+const REREAD_THRESHOLD = 5; // > 5 sessions
+const TOKEN_THRESHOLD = 5_000;
+function isClaudeMd(filePath) {
+    const normalized = filePath.replace(/\\/g, "/").toLowerCase();
+    return normalized === "claude.md" || normalized.endsWith("/claude.md");
+}
+export const contextBloatDetector = {
+    id: "context-bloat",
+    description: "CLAUDE.md re-read in many sessions — splitting it reduces per-session cache costs",
+    minSessionsRequired: MIN_SESSIONS,
+    detect(sessions) {
+        if (sessions.length < MIN_SESSIONS)
+            return [];
+        const since = new Date(Date.now() - DAYS_30_MS).toISOString();
+        const recent = sessions.filter((s) => s.startedAt >= since);
+        const fileIndex = new Map();
+        for (const session of recent) {
+            for (const turn of session.turns) {
+                for (const file of turn.filesTouched) {
+                    if (!isClaudeMd(file))
+                        continue;
+                    if (!fileIndex.has(file)) {
+                        fileIndex.set(file, { sessions: new Set(), repoName: session.repoName });
+                    }
+                    fileIndex.get(file).sessions.add(session.id);
+                }
+            }
+        }
+        const insights = [];
+        for (const [filePath, { sessions: sessionIds, repoName }] of fileIndex) {
+            if (sessionIds.size <= REREAD_THRESHOLD)
+                continue;
+            const tokenCount = estimateFileTokens(filePath);
+            if (tokenCount <= TOKEN_THRESHOLD)
+                continue;
+            const reReadCount = sessionIds.size;
+            const monthlySavingsUsd = (reReadCount * tokenCount * CACHE_READ_RATE_PER_M) / 1_000_000;
+            insights.push({
+                detectorId: "context-bloat",
+                repoName,
+                workspaceScope: "repo",
+                titleShort: `CLAUDE.md re-read in ${reReadCount} sessions (last 30 days)`,
+                estimatedMonthlySavingsUsd: monthlySavingsUsd,
+                confidence: "high",
+                evidence: {
+                    sessionIds: [...sessionIds],
+                    metrics: {
+                        reReadCount,
+                        estimatedTokenCount: tokenCount,
+                        cacheReadRatePerM: CACHE_READ_RATE_PER_M,
+                    },
+                },
+                manualFix: `Split \`CLAUDE.md\` (~${tokenCount.toLocaleString()} tokens) into a root index under` +
+                    ` 50 lines that uses \`@import\` directives to load scoped sub-files. This lets Claude` +
+                    ` load only the sections relevant to each task, cutting the per-session re-read from` +
+                    ` ~${tokenCount.toLocaleString()} tokens to a few hundred.\n\n` +
+                    `See the [Claude Code memory docs](https://docs.anthropic.com/en/docs/claude-code/memory)` +
+                    ` for the import syntax.`,
+            });
+        }
+        return insights;
+    },
+};
+//# sourceMappingURL=context-bloat.js.map

package/dist/detectors/context-bloat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-bloat.js","sourceRoot":"","sources":["../../src/detectors/context-bloat.ts"],"names":[],"mappings":"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"}

package/dist/detectors/fileTokens.d.ts

@@ -0,0 +1,3 @@
+/** Estimate token count by reading file bytes and dividing by 4 (chars/token heuristic). Returns 0 if unreadable. */
+export declare function estimateFileTokens(filePath: string): number;
+//# sourceMappingURL=fileTokens.d.ts.map

package/dist/detectors/fileTokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTokens.d.ts","sourceRoot":"","sources":["../../src/detectors/fileTokens.ts"],"names":[],"mappings":"AAEA,qHAAqH;AACrH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO3D"}

package/dist/detectors/fileTokens.js

@@ -0,0 +1,12 @@
+import fs from "fs";
+/** Estimate token count by reading file bytes and dividing by 4 (chars/token heuristic). Returns 0 if unreadable. */
+export function estimateFileTokens(filePath) {
+    try {
+        const buf = fs.readFileSync(filePath);
+        return Math.ceil(buf.length / 4);
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=fileTokens.js.map

package/dist/detectors/fileTokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTokens.js","sourceRoot":"","sources":["../../src/detectors/fileTokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,qHAAqH;AACrH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/detectors/index.d.ts

@@ -0,0 +1,20 @@
+import type { Detector, Insight, Session } from "./types.js";
+import type { SubscriptionContext } from "../config.js";
+import type { SessionRow } from "../db/store.js";
+export type { Session, Insight, Detector };
+/** Parse a DB row's turnsJson into a Session the detectors can consume. */
+export declare function parseSession(row: SessionRow): Session;
+export declare function getDetectors(subscriptions: SubscriptionContext[]): Detector[];
+export type RunResult = {
+    insights: Insight[];
+    skipped: {
+        detectorId: string;
+        reason: string;
+    }[];
+};
+/**
+ * Run all detectors. Detectors whose minSessionsRequired threshold is not met are
+ * skipped and recorded in `skipped` so the caller can surface honest empty states.
+ */
+export declare function runDetectors(sessions: Session[], subscriptions: SubscriptionContext[]): RunResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/detectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/detectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQjD,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAE3C,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAIrD;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,mBAAmB,EAAE,GAAG,QAAQ,EAAE,CAQ7E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,mBAAmB,EAAE,GACnC,SAAS,CAiBX"}

package/dist/detectors/index.js

@@ -0,0 +1,41 @@
+import { contextBloatDetector } from "./context-bloat.js";
+import { repeatReadDetector } from "./repeat-read.js";
+import { modelRoutingDetector } from "./model-routing.js";
+import { cacheGapDetector } from "./cache-gap.js";
+import { createSeatEfficiencyDetector } from "./seat-efficiency.js";
+/** Parse a DB row's turnsJson into a Session the detectors can consume. */
+export function parseSession(row) {
+    const turns = JSON.parse(row.turnsJson);
+    const { turnsJson: _omit, ...rest } = row;
+    return { ...rest, turns };
+}
+export function getDetectors(subscriptions) {
+    return [
+        contextBloatDetector,
+        repeatReadDetector,
+        modelRoutingDetector,
+        cacheGapDetector,
+        createSeatEfficiencyDetector(subscriptions),
+    ];
+}
+/**
+ * Run all detectors. Detectors whose minSessionsRequired threshold is not met are
+ * skipped and recorded in `skipped` so the caller can surface honest empty states.
+ */
+export function runDetectors(sessions, subscriptions) {
+    const detectors = getDetectors(subscriptions);
+    const insights = [];
+    const skipped = [];
+    for (const detector of detectors) {
+        if (sessions.length < detector.minSessionsRequired) {
+            skipped.push({
+                detectorId: detector.id,
+                reason: `need ≥${detector.minSessionsRequired} sessions, have ${sessions.length}`,
+            });
+            continue;
+        }
+        insights.push(...detector.detect(sessions));
+    }
+    return { insights, skipped };
+}
+//# sourceMappingURL=index.js.map

package/dist/detectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/detectors/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAIpE,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,GAAe;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAW,CAAC;IAClD,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;IAC1C,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,aAAoC;IAC/D,OAAO;QACL,oBAAoB;QACpB,kBAAkB;QAClB,oBAAoB;QACpB,gBAAgB;QAChB,4BAA4B,CAAC,aAAa,CAAC;KAC5C,CAAC;AACJ,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAmB,EACnB,aAAoC;IAEpC,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,OAAO,GAA6C,EAAE,CAAC;IAE7D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,mBAAmB,EAAE,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC;gBACX,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,MAAM,EAAE,SAAS,QAAQ,CAAC,mBAAmB,mBAAmB,QAAQ,CAAC,MAAM,EAAE;aAClF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/detectors/model-routing.d.ts

@@ -0,0 +1,3 @@
+import type { Detector } from "./types.js";
+export declare const modelRoutingDetector: Detector;
+//# sourceMappingURL=model-routing.d.ts.map

package/dist/detectors/model-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-routing.d.ts","sourceRoot":"","sources":["../../src/detectors/model-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAqB7D,eAAO,MAAM,oBAAoB,EAAE,QA2DlC,CAAC"}

package/dist/detectors/model-routing.js

@@ -0,0 +1,71 @@
+const DAYS_30_MS = 30 * 24 * 60 * 60 * 1000;
+const OPUS_OUTPUT_RATE_PER_M = 25.00; // $/M output tokens
+const HAIKU_OUTPUT_RATE_PER_M = 5.00; // $/M output tokens
+const RATE_DIFF_PER_M = OPUS_OUTPUT_RATE_PER_M - HAIKU_OUTPUT_RATE_PER_M; // 20.00
+const P50_OUTPUT_THRESHOLD = 800;
+const MIN_SESSIONS = 5;
+function isOpus(modelId) {
+    // Matches claude-opus-4-* but not the deprecated claude-opus-4-1 tier
+    return modelId.startsWith("claude-opus-4") && !modelId.startsWith("claude-opus-4-1");
+}
+function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 !== 0 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
+}
+export const modelRoutingDetector = {
+    id: "model-routing",
+    description: "Opus used for low-output tasks — Haiku handles the same work at 5× lower cost",
+    minSessionsRequired: MIN_SESSIONS,
+    detect(sessions) {
+        if (sessions.length < MIN_SESSIONS)
+            return [];
+        const since = new Date(Date.now() - DAYS_30_MS).toISOString();
+        const recent = sessions.filter((s) => s.startedAt >= since);
+        const opusSessions = recent.filter((s) => isOpus(s.model));
+        if (opusSessions.length === 0)
+            return [];
+        const qualifying = [];
+        for (const session of opusSessions) {
+            if (session.turns.length === 0)
+                continue;
+            const p50 = median(session.turns.map((t) => t.outputTokens));
+            if (p50 < P50_OUTPUT_THRESHOLD)
+                qualifying.push(session);
+        }
+        if (qualifying.length === 0)
+            return [];
+        const totalOutputTokens = qualifying.reduce((sum, s) => sum + s.turns.reduce((ts, t) => ts + t.outputTokens, 0), 0);
+        const totalTurns = qualifying.reduce((sum, s) => sum + s.turns.length, 0);
+        const monthlySavingsUsd = (totalOutputTokens * RATE_DIFF_PER_M) / 1_000_000;
+        const avgTurnOutput = totalTurns > 0 ? Math.round(totalOutputTokens / totalTurns) : 0;
+        return [{
+                detectorId: "model-routing",
+                repoName: null,
+                workspaceScope: "workspace",
+                titleShort: `${qualifying.length} Opus session(s) with p50 output <${P50_OUTPUT_THRESHOLD} tokens — likely cheap-class work`,
+                estimatedMonthlySavingsUsd: monthlySavingsUsd,
+                confidence: "low",
+                evidence: {
+                    sessionIds: qualifying.map((s) => s.id),
+                    metrics: {
+                        opusSessionCount: qualifying.length,
+                        totalTurns,
+                        avgTurnOutputTokens: avgTurnOutput,
+                        rateDiffPerM: RATE_DIFF_PER_M,
+                    },
+                },
+                manualFix: `**Confidence is low — output token count is a weak proxy for task complexity.**\n\n` +
+                    `These Opus sessions had a median turn output below ${P50_OUTPUT_THRESHOLD} tokens,` +
+                    ` which often indicates quick file edits, short Q&A, or simple completions that` +
+                    ` Haiku 4.5 handles equally well at 5× lower output cost.\n\n` +
+                    `Review a sample of these sessions before acting. If the tasks genuinely only need` +
+                    ` short responses, configure Claude Code to default to a smaller model for that project.` +
+                    ` Keep Opus for complex multi-step reasoning, long-context synthesis, and agentic tasks` +
+                    ` with many tool calls.`,
+            }];
+    },
+};
+//# sourceMappingURL=model-routing.js.map

package/dist/detectors/model-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-routing.js","sourceRoot":"","sources":["../../src/detectors/model-routing.ts"],"names":[],"mappings":"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"}

package/dist/detectors/repeat-read.d.ts

@@ -0,0 +1,3 @@
+import type { Detector } from "./types.js";
+export declare const repeatReadDetector: Detector;
+//# sourceMappingURL=repeat-read.d.ts.map

package/dist/detectors/repeat-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeat-read.d.ts","sourceRoot":"","sources":["../../src/detectors/repeat-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAW7D,eAAO,MAAM,kBAAkB,EAAE,QAqEhC,CAAC"}

package/dist/detectors/repeat-read.js

@@ -0,0 +1,69 @@
+import { estimateFileTokens } from "./fileTokens.js";
+const DAYS_7_MS = 7 * 24 * 60 * 60 * 1000;
+const CACHE_READ_RATE_PER_M = 0.30; // Sonnet 4 rate, $/M tokens
+const MONTHLY_PROJECTION = 30 / 7; // scale 7-day window to 30 days
+const MIN_SESSIONS = 3;
+const READ_COUNT_THRESHOLD = 10; // > 10 total reads
+const SESSION_COUNT_THRESHOLD = 3; // > 3 distinct sessions
+const TOKEN_THRESHOLD = 2_000;
+export const repeatReadDetector = {
+    id: "repeat-read",
+    description: "Same file read >10× across >3 sessions in 7 days — a prompt caching opportunity",
+    minSessionsRequired: MIN_SESSIONS,
+    detect(sessions) {
+        if (sessions.length < MIN_SESSIONS)
+            return [];
+        const since = new Date(Date.now() - DAYS_7_MS).toISOString();
+        const recent = sessions.filter((s) => s.startedAt >= since);
+        const fileIndex = new Map();
+        for (const session of recent) {
+            for (const turn of session.turns) {
+                for (const file of turn.filesTouched) {
+                    if (!fileIndex.has(file)) {
+                        fileIndex.set(file, { totalReads: 0, sessions: new Set(), repoName: session.repoName });
+                    }
+                    const entry = fileIndex.get(file);
+                    entry.totalReads++;
+                    entry.sessions.add(session.id);
+                }
+            }
+        }
+        const insights = [];
+        for (const [filePath, { totalReads, sessions: sessionIds, repoName }] of fileIndex) {
+            if (totalReads <= READ_COUNT_THRESHOLD)
+                continue;
+            if (sessionIds.size <= SESSION_COUNT_THRESHOLD)
+                continue;
+            const tokenCount = estimateFileTokens(filePath);
+            if (tokenCount <= TOKEN_THRESHOLD)
+                continue;
+            // Savings = (reads - 1) × tokens × rate, projected to 30 days
+            const monthlySavingsUsd = ((totalReads - 1) * tokenCount * CACHE_READ_RATE_PER_M * MONTHLY_PROJECTION) / 1_000_000;
+            const fileName = filePath.replace(/\\/g, "/").split("/").pop() ?? filePath;
+            insights.push({
+                detectorId: "repeat-read",
+                repoName,
+                workspaceScope: "repo",
+                titleShort: `${fileName} read ${totalReads}× across ${sessionIds.size} sessions (last 7 days)`,
+                estimatedMonthlySavingsUsd: monthlySavingsUsd,
+                confidence: "medium",
+                evidence: {
+                    sessionIds: [...sessionIds],
+                    metrics: {
+                        totalReads,
+                        distinctSessions: sessionIds.size,
+                        estimatedTokenCount: tokenCount,
+                    },
+                },
+                manualFix: `\`${fileName}\` (${tokenCount.toLocaleString()} tokens) is loaded repeatedly without prompt` +
+                    ` caching. Add a \`cache_control: ephemeral\` block to the system prompt section that` +
+                    ` includes this file, or restructure prompts so the file content sits in a stable prefix` +
+                    ` covered by Claude Code's 5-minute cache TTL.\n\n` +
+                    `If the file changes frequently, split it: keep the stable reference sections in a` +
+                    ` separate file that changes less often, and only load the volatile parts dynamically.`,
+            });
+        }
+        return insights;
+    },
+};
+//# sourceMappingURL=repeat-read.js.map

package/dist/detectors/repeat-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeat-read.js","sourceRoot":"","sources":["../../src/detectors/repeat-read.ts"],"names":[],"mappings":"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"}

package/dist/detectors/seat-efficiency.d.ts

@@ -0,0 +1,4 @@
+import type { Detector } from "./types.js";
+import type { SubscriptionContext } from "../config.js";
+export declare function createSeatEfficiencyDetector(subscriptions: SubscriptionContext[]): Detector;
+//# sourceMappingURL=seat-efficiency.d.ts.map

package/dist/detectors/seat-efficiency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-efficiency.d.ts","sourceRoot":"","sources":["../../src/detectors/seat-efficiency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAOxD,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,mBAAmB,EAAE,GAAG,QAAQ,CAqG3F"}

package/dist/detectors/seat-efficiency.js

@@ -0,0 +1,86 @@
+const DAYS_30_MS = 30 * 24 * 60 * 60 * 1000;
+const DORMANT_THRESHOLD = 0.10; // < 10% of seat cost → dormant
+const OVERLOADED_THRESHOLD = 4.0; // > 4× seat cost → under-priced
+const MIN_SESSIONS = 5;
+export function createSeatEfficiencyDetector(subscriptions) {
+    return {
+        id: "seat-efficiency",
+        description: "Dormant or over-capacity seats relative to declared subscription cost",
+        minSessionsRequired: MIN_SESSIONS,
+        detect(sessions) {
+            if (sessions.length < MIN_SESSIONS)
+                return [];
+            if (subscriptions.length === 0)
+                return [];
+            const since = new Date(Date.now() - DAYS_30_MS).toISOString();
+            const recent = sessions.filter((s) => s.startedAt >= since);
+            const insights = [];
+            for (const sub of subscriptions) {
+                const toolSessions = recent.filter((s) => s.tool === sub.tool);
+                const seatCost = sub.seatCostUsdMonthly;
+                const perSeat = new Map();
+                for (const session of toolSessions) {
+                    const key = session.gitAuthorEmail ?? "(unattributed)";
+                    if (!perSeat.has(key))
+                        perSeat.set(key, { consumption: 0, sessionIds: [] });
+                    const entry = perSeat.get(key);
+                    entry.consumption += session.costUsd;
+                    entry.sessionIds.push(session.id);
+                }
+                const dormant = [...perSeat.entries()].filter(([, e]) => e.consumption < seatCost * DORMANT_THRESHOLD);
+                const overCapacity = [...perSeat.entries()].filter(([, e]) => e.consumption > seatCost * OVERLOADED_THRESHOLD);
+                if (dormant.length > 0) {
+                    const monthlySavingsUsd = dormant.length * seatCost;
+                    const avgConsumption = dormant.reduce((s, [, e]) => s + e.consumption, 0) / dormant.length;
+                    const dormantEmails = dormant.map(([email]) => email).join(", ");
+                    insights.push({
+                        detectorId: "seat-efficiency",
+                        repoName: null,
+                        workspaceScope: "workspace",
+                        titleShort: `${dormant.length} dormant ${sub.tool} ${sub.plan} seat(s) — <10% of seat cost consumed`,
+                        estimatedMonthlySavingsUsd: monthlySavingsUsd,
+                        confidence: "high",
+                        evidence: {
+                            sessionIds: dormant.flatMap(([, e]) => e.sessionIds),
+                            metrics: {
+                                dormantSeatCount: dormant.length,
+                                seatCostUsdMonthly: seatCost,
+                                avgConsumptionUsd: parseFloat(avgConsumption.toFixed(4)),
+                            },
+                        },
+                        manualFix: `${dormant.length} seat(s) on the ${sub.tool} ${sub.plan} plan` +
+                            ` ($${seatCost}/seat/mo) consumed less than 10% of their seat cost over the last` +
+                            ` 30 days. Consider removing or reassigning them to save ~$${monthlySavingsUsd.toFixed(2)}/mo.\n\n` +
+                            `Dormant users: ${dormantEmails}`,
+                    });
+                }
+                if (overCapacity.length > 0) {
+                    const avgConsumption = overCapacity.reduce((s, [, e]) => s + e.consumption, 0) / overCapacity.length;
+                    const highValueEmails = overCapacity.map(([email]) => email).join(", ");
+                    insights.push({
+                        detectorId: "seat-efficiency",
+                        repoName: null,
+                        workspaceScope: "workspace",
+                        titleShort: `${overCapacity.length} over-capacity ${sub.tool} ${sub.plan} seat(s) — >4× seat cost consumed`,
+                        estimatedMonthlySavingsUsd: 0, // contract defend, not a cost saving
+                        confidence: "high",
+                        evidence: {
+                            sessionIds: overCapacity.flatMap(([, e]) => e.sessionIds),
+                            metrics: {
+                                overCapacitySeatCount: overCapacity.length,
+                                seatCostUsdMonthly: seatCost,
+                                avgConsumptionUsd: parseFloat(avgConsumption.toFixed(4)),
+                            },
+                        },
+                        manualFix: `${overCapacity.length} seat(s) consumed more than 4× their seat cost` +
+                            ` ($${seatCost}/seat/mo) in the last 30 days. These users deliver strong ROI —` +
+                            ` use this data to defend or expand the contract at renewal.\n\n` +
+                            `High-value users: ${highValueEmails}`,
+                    });
+                }
+            }
+            return insights;
+        },
+    };
+}
+//# sourceMappingURL=seat-efficiency.js.map

package/dist/detectors/seat-efficiency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-efficiency.js","sourceRoot":"","sources":["../../src/detectors/seat-efficiency.ts"],"names":[],"mappings":"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"}

package/dist/detectors/types.d.ts

@@ -0,0 +1,46 @@
+import type { Turn } from "../scrapers/types.js";
+/** SessionRow with turnsJson pre-parsed. Avoids importing SessionRow to break circular deps. */
+export type Session = {
+    id: string;
+    tool: string;
+    model: string;
+    startedAt: string;
+    endedAt: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    costUsd: number;
+    costType: string;
+    subscriptionPlan: string | null;
+    unmatchedTurns: number;
+    repoName: string | null;
+    gitBranch: string | null;
+    gitAuthorEmail: string | null;
+    workingDir: string;
+    turnCount: number;
+    filesTouchedCount: number;
+    outcome: string;
+    scrapedAt: string;
+    turns: Turn[];
+};
+export type Insight = {
+    detectorId: string;
+    repoName: string | null;
+    workspaceScope: "workspace" | "repo" | "developer";
+    titleShort: string;
+    estimatedMonthlySavingsUsd: number;
+    confidence: "high" | "medium" | "low";
+    evidence: {
+        sessionIds: string[];
+        metrics: Record<string, number>;
+    };
+    manualFix: string;
+};
+export type Detector = {
+    id: string;
+    description: string;
+    minSessionsRequired: number;
+    detect(sessions: Session[]): Insight[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/detectors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/detectors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,gGAAgG;AAChG,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B,EAAE,MAAM,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACxC,CAAC"}

package/dist/detectors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/detectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/detectors/types.ts"],"names":[],"mappings":""}

package/dist/health.d.ts

@@ -0,0 +1,59 @@
+export type HealthOk = {
+    ok: true;
+    workspaceId: string;
+    workspaceName: string;
+    dbInstanceId: string;
+};
+export type HealthFailure = {
+    ok: false;
+    reason: "no-token";
+} | {
+    ok: false;
+    reason: "invalid-token";
+} | {
+    ok: false;
+    reason: "network";
+} | {
+    ok: false;
+    reason: "workspace-changed";
+    previous: string;
+    current: string;
+    /** New workspace name (for display). */
+    workspaceName: string;
+    /** DB instance ID at the new workspace (unchanged from our perspective). */
+    dbInstanceId: string;
+} | {
+    ok: false;
+    reason: "db-reset";
+    previous: string;
+    current: string;
+    /** Workspace ID (unchanged). */
+    workspaceId: string;
+    workspaceName: string;
+};
+export type HealthResult = HealthOk | HealthFailure;
+/**
+ * Check /api/me/health and detect three classes of drift:
+ *   - workspace-changed  (token now bound to a different workspace)
+ *   - db-reset           (backend DB was wiped/restored since last check)
+ *
+ * On success, updates last_backend_db_instance_id / last_workspace_id /
+ * last_health_check_at in connection_state.
+ *
+ * On drift, returns the failure type with `current` values but does NOT
+ * update stored state — callers must call commitHealthState() after resolving.
+ */
+export declare function preflightHealth(): Promise<HealthResult>;
+/** Persist health state; call after a successful preflight or after reconcile resolves drift. */
+export declare function commitHealthState(dbInstanceId: string, workspaceId: string): void;
+/**
+ * Fetch the backend session manifest and reset sync state for any local
+ * sessions that are marked synced but absent from the backend.
+ *
+ * Returns the count of sessions whose sync state was reset (they will be
+ * re-sent on the next `planck sync`).
+ */
+export declare function reconcileWithManifest(): Promise<{
+    reset: number;
+}>;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,IAAI,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;AAUpD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAoD7D;AAID,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAIjF;AAID;;;;;;GAMG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCxE"}