@munin-cli/core 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 semideus-dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/analyze/build.d.ts

@@ -0,0 +1,13 @@
+import type { PricedDataset, Window } from "../domain/analysis.js";
+import type { Dataset } from "../domain/source.js";
+import type { UsageEvent } from "../domain/usage.js";
+/** Stable source ordering shared by batch and ledger report builds. */
+export declare function sortUsageEvents(events: readonly UsageEvent[]): UsageEvent[];
+/** First event time to the last end (or start) time; never less than one day. */
+export declare function windowOf(events: UsageEvent[]): Window;
+/**
+ * Turn a dataset into priced events, every attempt, a window, and warnings.
+ * The input dataset is never mutated.
+ */
+export declare function buildEvents(dataset: Dataset): PricedDataset;
+//# sourceMappingURL=build.d.ts.map

package/dist/analyze/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/analyze/build.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EACV,OAAO,EAKR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAkIpE,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAE3E;AAQD,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAiCrD;AA2BD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAoC3D"}

package/dist/analyze/build.js

@@ -0,0 +1,223 @@
+/**
+ * Build priced events from a Phase 2 dataset.
+ *
+ * This is the seam between what the source recorded and what reports read. It
+ * is pure: no filesystem, network, or clock access. Every price is selected
+ * from the call's own timestamp.
+ */
+import { WARNING_CODES } from "../diagnostics.js";
+import { billableTokens, estimateCost } from "../pricing/cost.js";
+import { resolvePrice } from "../pricing/resolve.js";
+import { messageContexts } from "./turns.js";
+function isModelCall(message) {
+    return message.type === "assistant" || message.type === "compaction";
+}
+function schemaFor(dataset, session) {
+    if (session !== undefined)
+        return session.schema;
+    if (dataset.schema === "v1" || dataset.schema === "v2")
+        return dataset.schema;
+    // A message without its session should not happen. When it does, keep the
+    // event usable rather than throwing; the missing session is already visible
+    // in data health.
+    return "v2";
+}
+function latencyMs(start, end) {
+    if (end === undefined)
+        return undefined;
+    const startMs = Date.parse(start);
+    const endMs = Date.parse(end);
+    if (!Number.isFinite(startMs) || !Number.isFinite(endMs))
+        return undefined;
+    const delta = endMs - startMs;
+    return delta >= 0 ? delta : undefined;
+}
+function attemptFrom(message, session) {
+    const model = message.model ?? session?.model;
+    const agent = message.agent ?? session?.agent;
+    return {
+        id: message.id,
+        sessionId: message.sessionId,
+        ts: message.timeCreated,
+        type: message.type === "compaction" ? "compaction" : "assistant",
+        ...(model === undefined ? {} : { model: { ...model } }),
+        ...(agent === undefined ? {} : { agent }),
+        ...(message.usage === undefined
+            ? {}
+            : {
+                usage: {
+                    tokens: { ...message.usage.tokens },
+                    ...(message.usage.observedUsd === undefined
+                        ? {}
+                        : { observedUsd: message.usage.observedUsd }),
+                },
+            }),
+        ...(message.usage?.observedUsd === undefined ? {} : { observedUsd: message.usage.observedUsd }),
+        ...(message.stopReason === undefined ? {} : { stopReason: message.stopReason }),
+        ...(message.errorType === undefined ? {} : { errorType: message.errorType }),
+    };
+}
+function eventFrom(dataset, message, session, context) {
+    // The caller guarantees usage; the assertion keeps the map below total.
+    const usage = message.usage;
+    const billed = billableTokens(usage.tokens);
+    const model = message.model ?? session?.model;
+    const variant = message.model?.variant ?? session?.model?.variant;
+    const agent = message.agent ?? session?.agent;
+    const modelId = model?.model ?? "unknown";
+    const instructions = session?.instructions;
+    const endTs = message.completedAt;
+    const latency = latencyMs(message.timeCreated, endTs);
+    const turn = context ?? { contextEpoch: 0 };
+    return {
+        id: message.id,
+        source: "opencode",
+        schema: schemaFor(dataset, session),
+        provider: model?.provider ?? "unknown",
+        model: modelId,
+        ...(variant === undefined ? {} : { variant }),
+        ...(agent === undefined ? {} : { agent }),
+        ts: message.timeCreated,
+        sessionId: message.sessionId,
+        ...(session?.parentId === undefined ? {} : { parentSessionId: session.parentId }),
+        ...(session?.projectId === undefined ? {} : { projectId: session.projectId }),
+        project: session?.project ?? session?.projectId ?? "unknown",
+        ...(turn.turnId === undefined ? {} : { turnId: turn.turnId }),
+        ...(turn.turnStartedAt === undefined ? {} : { turnStartedAt: turn.turnStartedAt }),
+        ...(endTs === undefined ? {} : { endTs }),
+        contextEpoch: turn.contextEpoch,
+        inputTokens: billed.input,
+        // Priced output includes reasoning, which the provider bills as output.
+        outputTokens: billed.output,
+        thinkingTokens: billed.thinking,
+        cacheReadTokens: billed.cacheRead,
+        cacheWrite5mTokens: billed.cacheWrite,
+        cacheWrite1hTokens: 0,
+        ...(latency === undefined ? {} : { latencyMs: latency }),
+        ...(message.stopReason === undefined ? {} : { stopReason: message.stopReason }),
+        isSubagent: session?.parentId !== undefined,
+        tools: (message.toolCalls ?? []).map((tool) => ({ ...tool })),
+        ...(instructions === undefined
+            ? {}
+            : {
+                instructionKeys: [...instructions.keys],
+                instructionChars: instructions.chars,
+                prefixHash: instructions.prefixHash,
+            }),
+        cost: estimateCost({
+            tokens: billed,
+            model: modelId,
+            ...(usage.observedUsd === undefined ? {} : { observedUsd: usage.observedUsd }),
+            at: message.timeCreated,
+        }),
+    };
+}
+function compareEvents(a, b) {
+    if (a.ts !== b.ts)
+        return a.ts.localeCompare(b.ts);
+    if (a.sessionId !== b.sessionId)
+        return a.sessionId.localeCompare(b.sessionId);
+    return a.id.localeCompare(b.id);
+}
+/** Stable source ordering shared by batch and ledger report builds. */
+export function sortUsageEvents(events) {
+    return [...events].sort(compareEvents);
+}
+function compareAttempts(a, b) {
+    if (a.ts !== b.ts)
+        return a.ts.localeCompare(b.ts);
+    if (a.sessionId !== b.sessionId)
+        return a.sessionId.localeCompare(b.sessionId);
+    return a.id.localeCompare(b.id);
+}
+/** First event time to the last end (or start) time; never less than one day. */
+export function windowOf(events) {
+    const first = events[0];
+    if (first === undefined)
+        return { start: null, end: null, days: 0 };
+    let startMs = Date.parse(first.ts);
+    let start = first.ts;
+    let end = first.endTs ?? first.ts;
+    let endMs = Date.parse(end);
+    for (const event of events) {
+        const startCandidateMs = Date.parse(event.ts);
+        if (Number.isFinite(startCandidateMs) && startCandidateMs < startMs) {
+            // Same rule as sorted input: the earliest start wins. buildEvents() output
+            // is sorted, so this matches its window exactly and survives unsorted input.
+            startMs = startCandidateMs;
+            start = event.ts;
+        }
+        const candidate = event.endTs ?? event.ts;
+        const candidateMs = Date.parse(candidate);
+        if (Number.isFinite(candidateMs) && (!Number.isFinite(endMs) || candidateMs > endMs)) {
+            end = candidate;
+            endMs = candidateMs;
+        }
+    }
+    // startMs is always the earliest finite start: initialised from the first
+    // event and only ever lowered by a valid timestamp.
+    const days = Number.isFinite(startMs) && Number.isFinite(endMs) && endMs >= startMs
+        ? Math.max(1, (endMs - startMs) / 86_400_000)
+        : 1;
+    return { start, end, days };
+}
+/**
+ * One `price.unpriced-model` per model with no card, aggregated with its call
+ * count and observed spend. An observed charge does not make a model priced: it
+ * makes that call's headline observed, but the model still cannot be estimated.
+ */
+function addPricingWarnings(events, warnings) {
+    const unpriced = new Map();
+    for (const event of events) {
+        if (resolvePrice(event.model) !== null)
+            continue;
+        const row = unpriced.get(event.model) ?? { calls: 0, observedUsd: 0 };
+        row.calls += 1;
+        row.observedUsd += event.cost.observedUsd ?? 0;
+        unpriced.set(event.model, row);
+    }
+    for (const [model, row] of [...unpriced.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+        warnings.push({
+            code: WARNING_CODES.priceUnpricedModel,
+            message: `No price card for ${model}: ${row.calls} call(s), observed spend $${row.observedUsd}`,
+            count: row.calls,
+        });
+    }
+}
+/**
+ * Turn a dataset into priced events, every attempt, a window, and warnings.
+ * The input dataset is never mutated.
+ */
+export function buildEvents(dataset) {
+    const sessions = new Map(dataset.sessions.map((session) => [session.id, session]));
+    const contexts = messageContexts(dataset.messages);
+    const events = [];
+    const attempts = [];
+    for (const message of dataset.messages) {
+        if (!isModelCall(message))
+            continue;
+        const session = sessions.get(message.sessionId);
+        attempts.push(attemptFrom(message, session));
+        if (message.usage === undefined)
+            continue;
+        events.push(eventFrom(dataset, message, session, contexts.get(message.id)));
+    }
+    events.sort(compareEvents);
+    attempts.sort(compareAttempts);
+    const warnings = [...dataset.warnings];
+    addPricingWarnings(events, warnings);
+    if (events.length === 0) {
+        warnings.push({
+            code: WARNING_CODES.analysisNoEvents,
+            message: "No usage-bearing model calls were found",
+        });
+    }
+    return {
+        schema: dataset.schema,
+        events,
+        attempts,
+        window: windowOf(events),
+        warnings,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/analyze/build.js.map

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

package/dist/analyze/cache.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Cache read/write analysis.
+ *
+ * Descriptive only: numbers here describe what happened, and nothing claims a
+ * low hit rate is waste (that judgement is a detector in Phase 4). Cache costs
+ * are always the list-price estimate; the observed total is never rebuilt from
+ * cache categories.
+ */
+import type { CacheStats, CacheStatsOptions } from "../domain/analysis.js";
+import type { UsageEvent } from "../domain/usage.js";
+/**
+ * Cache read/write behaviour over priced events.
+ *
+ * Events are consumed in the order given; buildEvents() output is already in a
+ * stable order.
+ */
+export declare function cacheStats(events: UsageEvent[], options?: CacheStatsOptions): CacheStats;
+//# sourceMappingURL=cache.d.ts.map

package/dist/analyze/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/analyze/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAEV,UAAU,EACV,iBAAiB,EAIlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAqGrD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAqC5F"}

package/dist/analyze/cache.js

@@ -0,0 +1,198 @@
+import { dayKey } from "./day.js";
+/** Codepoint order, so results never depend on the runtime locale. */
+function asc(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function emptyAcc() {
+    return {
+        calls: 0,
+        inputTokens: 0,
+        readTokens: 0,
+        writeTokens: 0,
+        write5mTokens: 0,
+        write1hTokens: 0,
+        estimatedReadUsd: 0,
+        estimatedWriteUsd: 0,
+    };
+}
+function addEvent(acc, event) {
+    acc.calls += 1;
+    acc.inputTokens += event.inputTokens;
+    acc.readTokens += event.cacheReadTokens;
+    acc.write5mTokens += event.cacheWrite5mTokens;
+    acc.write1hTokens += event.cacheWrite1hTokens;
+    acc.writeTokens += event.cacheWrite5mTokens + event.cacheWrite1hTokens;
+    acc.estimatedReadUsd += event.cost.cacheRead;
+    acc.estimatedWriteUsd += event.cost.cacheWrite;
+}
+function hitRate(acc) {
+    const inputSide = acc.inputTokens + acc.readTokens + acc.writeTokens;
+    return inputSide === 0 ? null : acc.readTokens / inputSide;
+}
+function accumulate(events) {
+    const acc = emptyAcc();
+    for (const event of events)
+        addEvent(acc, event);
+    return acc;
+}
+function toBreakdown(key, events) {
+    const acc = accumulate(events);
+    // Change over the window: the later half of the calls against the earlier
+    // half, in event order. With an odd count the middle call is in neither.
+    const mid = Math.floor(events.length / 2);
+    let hitRateChange = null;
+    if (mid > 0) {
+        const earlier = accumulate(events.slice(0, mid));
+        const later = accumulate(events.slice(events.length - mid));
+        const earlierRate = hitRate(earlier);
+        const laterRate = hitRate(later);
+        if (earlierRate !== null && laterRate !== null)
+            hitRateChange = laterRate - earlierRate;
+    }
+    return {
+        key,
+        calls: acc.calls,
+        inputTokens: acc.inputTokens,
+        readTokens: acc.readTokens,
+        writeTokens: acc.writeTokens,
+        write5mTokens: acc.write5mTokens,
+        write1hTokens: acc.write1hTokens,
+        hitRate: hitRate(acc),
+        estimatedReadUsd: acc.estimatedReadUsd,
+        estimatedWriteUsd: acc.estimatedWriteUsd,
+        hitRateChange,
+    };
+}
+function byCacheSpendDescThenKey(a, b) {
+    const aCache = a.estimatedReadUsd + a.estimatedWriteUsd;
+    const bCache = b.estimatedReadUsd + b.estimatedWriteUsd;
+    if (aCache !== bCache)
+        return bCache - aCache;
+    return asc(a.key, b.key);
+}
+function breakdown(map) {
+    const rows = [];
+    for (const [key, events] of map)
+        rows.push(toBreakdown(key, events));
+    return rows.sort(byCacheSpendDescThenKey);
+}
+/**
+ * Cache read/write behaviour over priced events.
+ *
+ * Events are consumed in the order given; buildEvents() output is already in a
+ * stable order.
+ */
+export function cacheStats(events, options = {}) {
+    const zone = options.zone ?? "UTC";
+    const totals = emptyAcc();
+    const byModel = new Map();
+    const byProvider = new Map();
+    const bySession = new Map();
+    const byDay = new Map();
+    for (const event of events) {
+        addEvent(totals, event);
+        pushTo(byModel, `${event.provider}/${event.model}`, event);
+        pushTo(byProvider, event.provider, event);
+        pushTo(bySession, event.sessionId, event);
+        pushTo(byDay, dayKey(event.ts, zone), event);
+    }
+    const estimatedTotal = events.reduce((sum, event) => sum + (event.cost.estimatedUsd ?? 0), 0);
+    const cacheUsd = totals.estimatedReadUsd + totals.estimatedWriteUsd;
+    return {
+        inputTokens: totals.inputTokens,
+        readTokens: totals.readTokens,
+        writeTokens: totals.writeTokens,
+        write5mTokens: totals.write5mTokens,
+        write1hTokens: totals.write1hTokens,
+        hitRate: hitRate(totals),
+        estimatedReadUsd: totals.estimatedReadUsd,
+        estimatedWriteUsd: totals.estimatedWriteUsd,
+        shareOfEstimate: estimatedTotal === 0 ? 0 : cacheUsd / estimatedTotal,
+        writesRecorded: totals.writeTokens > 0,
+        byModel: breakdown(byModel),
+        byProvider: breakdown(byProvider),
+        bySession: breakdown(bySession),
+        byDay: breakdown(byDay),
+        instructionContext: instructionContextOf(events),
+    };
+}
+function pushTo(map, key, event) {
+    const list = map.get(key);
+    if (list === undefined)
+        map.set(key, [event]);
+    else
+        list.push(event);
+}
+/**
+ * Instruction context, grouped by the cache identity
+ * `prefixHash + agent + model + variant`, never the prefix hash alone: two
+ * agents on one model share nothing at request time.
+ */
+function instructionContextOf(events) {
+    const seenSessions = new Set();
+    const prefixHashes = new Set();
+    let totalChars = 0;
+    const groups = new Map();
+    for (const event of events) {
+        const hasInstructions = event.instructionChars !== undefined || event.prefixHash !== undefined;
+        if (hasInstructions && !seenSessions.has(event.sessionId)) {
+            // Instruction size and prefix are session properties; count them on the
+            // first observed event of the session, never per call.
+            seenSessions.add(event.sessionId);
+            if (event.instructionChars !== undefined)
+                totalChars += event.instructionChars;
+            if (event.prefixHash !== undefined)
+                prefixHashes.add(event.prefixHash);
+        }
+        if (event.prefixHash !== undefined) {
+            const agent = event.agent ?? "unknown";
+            const model = `${event.provider}/${event.model}`;
+            const variant = event.variant ?? undefined;
+            const key = `${event.prefixHash}\u0000${agent}\u0000${model}\u0000${variant ?? "-"}`;
+            const group = groups.get(key);
+            if (group === undefined) {
+                groups.set(key, {
+                    prefixHash: event.prefixHash,
+                    agent,
+                    model,
+                    variant,
+                    sessions: new Set([event.sessionId]),
+                    calls: 1,
+                    uncachedInputTokens: event.inputTokens,
+                });
+            }
+            else {
+                group.sessions.add(event.sessionId);
+                group.calls += 1;
+                group.uncachedInputTokens += event.inputTokens;
+            }
+        }
+    }
+    const sharedPrefixes = [];
+    for (const group of groups.values()) {
+        if (group.sessions.size < 2)
+            continue;
+        sharedPrefixes.push({
+            prefixHash: group.prefixHash,
+            agent: group.agent,
+            model: group.model,
+            ...(group.variant === undefined ? {} : { variant: group.variant }),
+            sessions: group.sessions.size,
+            calls: group.calls,
+            uncachedInputTokens: group.uncachedInputTokens,
+        });
+    }
+    sharedPrefixes.sort((a, b) => {
+        if (a.uncachedInputTokens !== b.uncachedInputTokens) {
+            return b.uncachedInputTokens - a.uncachedInputTokens;
+        }
+        return asc(a.prefixHash, b.prefixHash);
+    });
+    return {
+        sessions: seenSessions.size,
+        totalChars,
+        distinctPrefixHashes: prefixHashes.size,
+        sharedPrefixes,
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/analyze/cache.js.map

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

package/dist/analyze/day.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Day bucketing.
+ *
+ * UTC is the default. For non-UTC zones the local calendar day comes from
+ * `Intl.DateTimeFormat.formatToParts`, never from slicing the ISO string: a
+ * slice is only correct when the string is already in the bucketing zone.
+ */
+import type { DayZone } from "../domain/analysis.js";
+/** The calendar day one timestamp falls on in `zone`, as `YYYY-MM-DD`. */
+export declare function dayKey(iso: string, zone?: DayZone): string;
+//# sourceMappingURL=day.d.ts.map

package/dist/analyze/day.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"day.d.ts","sourceRoot":"","sources":["../../src/analyze/day.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAuBrD,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,OAAe,GAAG,MAAM,CAejE"}

package/dist/analyze/day.js

@@ -0,0 +1,33 @@
+const formatters = new Map();
+function pad(part) {
+    return part < 10 ? `0${part}` : String(part);
+}
+function formatterFor(zone) {
+    const cached = formatters.get(zone);
+    if (cached !== undefined)
+        return cached;
+    // en-CA renders year-month-day, so the parts are unambiguous.
+    const created = new Intl.DateTimeFormat("en-CA", {
+        timeZone: zone === "local" ? undefined : zone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    });
+    formatters.set(zone, created);
+    return created;
+}
+/** The calendar day one timestamp falls on in `zone`, as `YYYY-MM-DD`. */
+export function dayKey(iso, zone = "UTC") {
+    const ms = Date.parse(iso);
+    if (!Number.isFinite(ms))
+        return "unknown";
+    if (zone === "UTC") {
+        // The UTC day comes straight from the parsed instant.
+        const date = new Date(ms);
+        return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())}`;
+    }
+    const parts = formatterFor(zone).formatToParts(ms);
+    const read = (type) => parts.find((part) => part.type === type)?.value ?? "";
+    return `${read("year")}-${read("month")}-${read("day")}`;
+}
+//# sourceMappingURL=day.js.map

package/dist/analyze/day.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"day.js","sourceRoot":"","sources":["../../src/analyze/day.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAC;AAE1D,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,8DAA8D;IAC9D,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC/C,QAAQ,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;QAC7C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;KACf,CAAC,CAAC;IACH,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,OAAgB,KAAK;IACvD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,sDAAsD;QACtD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAC7F,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,CAAC,IAAkC,EAAU,EAAE,CAC1D,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IAExD,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3D,CAAC"}

package/dist/analyze/findings/index.d.ts

@@ -0,0 +1,3 @@
+export { detectRepeatToolCalls } from "./repeat-tool-calls.js";
+export { detectRepeatedContext, REPEATED_CONTEXT_THRESHOLDS } from "./repeated-context.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/analyze/findings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyze/findings/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/analyze/findings/index.js

@@ -0,0 +1,11 @@
+/**
+ * Finding detectors and thresholds shared by tests and the rule registry.
+ *
+ * The detector list itself now lives in `analyze/rules.ts` so rule metadata and
+ * detector wiring stay together.
+ */
+import { detectRepeatToolCalls } from "./repeat-tool-calls.js";
+import { detectRepeatedContext, REPEATED_CONTEXT_THRESHOLDS } from "./repeated-context.js";
+export { detectRepeatToolCalls } from "./repeat-tool-calls.js";
+export { detectRepeatedContext, REPEATED_CONTEXT_THRESHOLDS } from "./repeated-context.js";
+//# sourceMappingURL=index.js.map

package/dist/analyze/findings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyze/findings/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAE3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/analyze/findings/repeat-tool-calls.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The repeated-read detector: the same read-only tool call made again in one
+ * context, with nothing changed in between.
+ *
+ * A duplicate is not one extra read: it is written into the cacheable prefix
+ * and re-read by every later call in the context, so it compounds. An edit to
+ * the file, or any change at all for a search, makes the next read fresh. A
+ * subagent starts with an empty context, so its reads are not repeats of the
+ * parent; neither is a read after a compaction.
+ *
+ * Unknown tools count as mutating, so duplicates are under-counted, never
+ * over-counted (Phase 3 plan, Step 6).
+ */
+import type { DetectionContext, FindingDraft } from "../../domain/finding.js";
+export declare function detectRepeatToolCalls(context: DetectionContext): readonly FindingDraft[];
+//# sourceMappingURL=repeat-tool-calls.d.ts.map

package/dist/analyze/findings/repeat-tool-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeat-tool-calls.d.ts","sourceRoot":"","sources":["../../../src/analyze/findings/repeat-tool-calls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAqF9E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,YAAY,EAAE,CA+GxF"}