bb-cc-lite 0.1.6 → 0.1.8

package/dist/historical-replay.d.ts

@@ -0,0 +1,21 @@
+import { type FailureRecoveryCategory } from "./recovery-stats.js";
+export interface HistoricalReplayOptions {
+    homeDir?: string;
+    claudeProjectsDir?: string;
+    maxFiles?: number;
+    maxBytesPerTranscript?: number;
+    holdoutRatio?: number;
+}
+export interface HistoricalReplayMetrics {
+    holdoutSessions: number;
+    evaluatedFailureEpisodes: number;
+    stopPrecisionOnUnrecoveredEpisodes: number | undefined;
+    falseStopCountOnRecoveredEpisodes: number;
+    missedUnrecoveredLoopCount: number;
+    blindRetryPrecision: number | undefined;
+    averageAttemptsBeforeWarning: number;
+    lowSampleSuppressions: number;
+    categoryCoverage: Partial<Record<FailureRecoveryCategory, number>>;
+}
+export declare function evaluateHistoricalReplay(options?: HistoricalReplayOptions): Promise<HistoricalReplayMetrics>;
+export declare function formatHistoricalReplayMetrics(metrics: HistoricalReplayMetrics): string;

package/dist/historical-replay.js

@@ -0,0 +1,263 @@
+import { readdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { extractFailureEpisodesFromTranscriptLines, extractSafeToolResultEventsFromTranscriptLines } from "./failure-episodes.js";
+import { addFailureEpisodeToRecoveryCounters, blindRetryAggregatesFromCounters, emptyRecoveryBuildCounters, FAILURE_RECOVERY_CATEGORIES, recoveryAggregatesFromCounters, recoveryInsight } from "./recovery-stats.js";
+import { readTranscriptTail } from "./transcript-reader.js";
+const DEFAULT_MAX_FILES = 1500;
+const DEFAULT_MAX_BYTES_PER_TRANSCRIPT = 1024 * 1024;
+const DEFAULT_HOLDOUT_RATIO = 0.2;
+export async function evaluateHistoricalReplay(options = {}) {
+    const homeDir = options.homeDir ?? homedir();
+    const claudeProjectsDir = options.claudeProjectsDir ?? join(homeDir, ".claude", "projects");
+    const maxFiles = options.maxFiles ?? DEFAULT_MAX_FILES;
+    const maxBytesPerTranscript = options.maxBytesPerTranscript ?? DEFAULT_MAX_BYTES_PER_TRANSCRIPT;
+    const files = await listTranscriptFiles(claudeProjectsDir, maxFiles);
+    const holdoutCount = holdoutSessionCount(files.length, options.holdoutRatio ?? DEFAULT_HOLDOUT_RATIO);
+    const holdoutFiles = files.slice(0, holdoutCount);
+    const trainingFiles = files.slice(holdoutCount);
+    const trainingEpisodes = await readEpisodes(trainingFiles, maxBytesPerTranscript);
+    const holdoutEventsBySession = await readEventsBySession(holdoutFiles, maxBytesPerTranscript);
+    const baseline = baselineFromEpisodes(trainingEpisodes);
+    return evaluateHoldout(holdoutEventsBySession, baseline);
+}
+export function formatHistoricalReplayMetrics(metrics) {
+    return [
+        `holdout sessions ${metrics.holdoutSessions}`,
+        `evaluated failure episodes ${metrics.evaluatedFailureEpisodes}`,
+        `Stop precision on unrecovered episodes ${formatMetricRate(metrics.stopPrecisionOnUnrecoveredEpisodes)}`,
+        `false Stop count on recovered episodes ${metrics.falseStopCountOnRecoveredEpisodes}`,
+        `missed unrecovered loop count ${metrics.missedUnrecoveredLoopCount}`,
+        `blind retry precision ${formatMetricRate(metrics.blindRetryPrecision)}`,
+        `average attempts before warning ${metrics.averageAttemptsBeforeWarning.toFixed(2)}`,
+        `low-sample suppressions ${metrics.lowSampleSuppressions}`,
+        `category coverage ${formatCategoryCoverage(metrics.categoryCoverage)}`
+    ].join("; ");
+}
+function evaluateHoldout(holdoutEventsBySession, baseline) {
+    let evaluatedFailureEpisodes = 0;
+    let stopTruePositive = 0;
+    let stopTotal = 0;
+    let falseStopCountOnRecoveredEpisodes = 0;
+    let missedUnrecoveredLoopCount = 0;
+    let blindRetryTruePositive = 0;
+    let blindRetryTotal = 0;
+    let lowSampleSuppressions = 0;
+    const attemptsBeforeWarning = [];
+    const categoryCoverage = {};
+    for (const events of holdoutEventsBySession) {
+        const replay = replaySession(events, baseline);
+        lowSampleSuppressions += replay.lowSampleSuppressions;
+        for (const outcome of replay.outcomes) {
+            evaluatedFailureEpisodes += 1;
+            categoryCoverage[outcome.category] = (categoryCoverage[outcome.category] || 0) + 1;
+            if (outcome.warningAttempt !== undefined) {
+                attemptsBeforeWarning.push(outcome.warningAttempt);
+            }
+            if (outcome.stopIssued) {
+                stopTotal += 1;
+                if (outcome.recovered) {
+                    falseStopCountOnRecoveredEpisodes += 1;
+                }
+                else {
+                    stopTruePositive += 1;
+                }
+            }
+            const unrecoveredLoop = !outcome.recovered && outcome.attemptCount >= 3;
+            if (unrecoveredLoop && !outcome.stopIssued) {
+                missedUnrecoveredLoopCount += 1;
+            }
+            if (outcome.blindRetryWarningIssued) {
+                blindRetryTotal += 1;
+                if (!outcome.recovered) {
+                    blindRetryTruePositive += 1;
+                }
+            }
+        }
+    }
+    return {
+        holdoutSessions: holdoutEventsBySession.length,
+        evaluatedFailureEpisodes,
+        stopPrecisionOnUnrecoveredEpisodes: stopTotal > 0 ? roundRate(stopTruePositive / stopTotal) : undefined,
+        falseStopCountOnRecoveredEpisodes,
+        missedUnrecoveredLoopCount,
+        blindRetryPrecision: blindRetryTotal > 0 ? roundRate(blindRetryTruePositive / blindRetryTotal) : undefined,
+        averageAttemptsBeforeWarning: attemptsBeforeWarning.length > 0
+            ? Number((attemptsBeforeWarning.reduce((total, value) => total + value, 0) / attemptsBeforeWarning.length).toFixed(2))
+            : 0,
+        lowSampleSuppressions,
+        categoryCoverage
+    };
+}
+function replaySession(events, baseline) {
+    const active = new Map();
+    const outcomes = [];
+    let lowSampleSuppressions = 0;
+    for (const event of events) {
+        if (event.outcome === "success") {
+            const sameIdentityEpisode = active.get(event.identity);
+            if (sameIdentityEpisode) {
+                outcomes.push(toReplayOutcome(sameIdentityEpisode, true));
+                active.delete(event.identity);
+            }
+            if (event.isEdit || event.isValidation) {
+                for (const episode of active.values()) {
+                    episode.meaningfulInterventionSinceFailure = true;
+                }
+            }
+            continue;
+        }
+        const episode = active.get(event.identity) || {
+            identity: event.identity,
+            category: event.category,
+            attemptCount: 0,
+            blindRunCount: 0,
+            maxBlindRunCount: 0,
+            meaningfulInterventionSinceFailure: false,
+            stopIssued: false,
+            blindRetryWarningIssued: false
+        };
+        if (episode.attemptCount === 0 || episode.meaningfulInterventionSinceFailure) {
+            episode.blindRunCount = 1;
+        }
+        else {
+            episode.blindRunCount += 1;
+        }
+        episode.attemptCount += 1;
+        episode.maxBlindRunCount = Math.max(episode.maxBlindRunCount, episode.blindRunCount);
+        episode.meaningfulInterventionSinceFailure = false;
+        const currentState = replayDecisionState(episode);
+        if (currentState !== "Healthy" && episode.warningAttempt === undefined) {
+            episode.warningAttempt = episode.attemptCount;
+        }
+        if (currentState !== "Healthy" && !recoveryInsight(baseline, episode.category, episode.attemptCount)) {
+            lowSampleSuppressions += 1;
+        }
+        if (episode.maxBlindRunCount >= 2) {
+            episode.blindRetryWarningIssued = true;
+        }
+        if (currentState === "Stop") {
+            episode.stopIssued = true;
+        }
+        active.set(event.identity, episode);
+    }
+    for (const episode of active.values()) {
+        outcomes.push(toReplayOutcome(episode, false));
+    }
+    return { outcomes, lowSampleSuppressions };
+}
+function replayDecisionState(episode) {
+    if (episode.maxBlindRunCount >= 3 || episode.attemptCount >= 3) {
+        return "Stop";
+    }
+    if (episode.maxBlindRunCount >= 2 || episode.attemptCount >= 2) {
+        return "Careful";
+    }
+    return "Healthy";
+}
+function toReplayOutcome(episode, recovered) {
+    return {
+        category: episode.category,
+        attemptCount: episode.attemptCount,
+        recovered,
+        warningAttempt: episode.warningAttempt,
+        stopIssued: episode.stopIssued,
+        blindRetryWarningIssued: episode.blindRetryWarningIssued
+    };
+}
+function baselineFromEpisodes(episodes) {
+    const counters = emptyRecoveryBuildCounters();
+    for (const episode of episodes) {
+        addFailureEpisodeToRecoveryCounters(counters, episode);
+    }
+    return {
+        failureRecovery: recoveryAggregatesFromCounters(counters),
+        blindRetry: blindRetryAggregatesFromCounters(counters)
+    };
+}
+async function readEpisodes(files, maxBytesPerTranscript) {
+    const sessions = await readEpisodesBySession(files, maxBytesPerTranscript);
+    return sessions.flat();
+}
+async function readEpisodesBySession(files, maxBytesPerTranscript) {
+    const sessions = [];
+    for (const file of files) {
+        const tail = await readTranscriptTail(file, { maxBytes: maxBytesPerTranscript });
+        if (tail.pathReadable) {
+            sessions.push(extractFailureEpisodesFromTranscriptLines(tail.lines));
+        }
+    }
+    return sessions;
+}
+async function readEventsBySession(files, maxBytesPerTranscript) {
+    const sessions = [];
+    for (const file of files) {
+        const tail = await readTranscriptTail(file, { maxBytes: maxBytesPerTranscript });
+        if (tail.pathReadable) {
+            sessions.push(extractSafeToolResultEventsFromTranscriptLines(tail.lines));
+        }
+    }
+    return sessions;
+}
+async function listTranscriptFiles(root, maxFiles) {
+    if (maxFiles <= 0) {
+        return [];
+    }
+    const candidates = [];
+    const pending = [root];
+    while (pending.length > 0) {
+        const current = pending.pop();
+        let entries;
+        try {
+            entries = await readdir(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const child = join(current, entry.name);
+            if (entry.isDirectory()) {
+                pending.push(child);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+                const mtimeMs = await readableFileMtimeMs(child);
+                if (mtimeMs !== undefined) {
+                    candidates.push({ path: child, mtimeMs });
+                }
+            }
+        }
+    }
+    return candidates
+        .sort((left, right) => right.mtimeMs - left.mtimeMs || left.path.localeCompare(right.path))
+        .slice(0, maxFiles)
+        .map((candidate) => candidate.path);
+}
+async function readableFileMtimeMs(path) {
+    try {
+        const fileStat = await stat(path);
+        return fileStat.isFile() ? fileStat.mtimeMs : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function holdoutSessionCount(total, ratio) {
+    if (total <= 1) {
+        return total;
+    }
+    return Math.max(1, Math.min(total - 1, Math.ceil(total * Math.max(0.05, Math.min(0.8, ratio)))));
+}
+function formatMetricRate(value) {
+    return value === undefined ? "n/a" : value.toFixed(2);
+}
+function formatCategoryCoverage(coverage) {
+    const parts = FAILURE_RECOVERY_CATEGORIES.flatMap((category) => {
+        const count = coverage[category] || 0;
+        return count > 0 ? [`${category}:${count}`] : [];
+    });
+    return parts.length > 0 ? parts.join(", ") : "none";
+}
+function roundRate(value) {
+    return Number(value.toFixed(4));
+}
+//# sourceMappingURL=historical-replay.js.map

package/dist/historical-replay.js.map

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

package/dist/hook-payload.js

@@ -1,6 +1,6 @@
 import { hashValue } from "./paths.js";
 import { asRecord, numberField, stringField } from "./status-input.js";
-import { classifyToolPurpose, safeToolName } from "./tool-metadata.js";
+import { classifyToolIdentity } from "./tool-metadata.js";
 export const SAFE_HOOK_EVENTS = [
     "PostToolUse",
     "PostToolUseFailure",
@@ -30,21 +30,25 @@ export function parseHookPayload(raw, fallbackEventName) {
         sessionKey: hashValue(sessionId)
     };
     if (hookEventName === "PostToolUseFailure") {
-        const toolName = safeToolName(stringField(root.tool_name) || stringField(root.toolName));
+        const identity = classifyToolIdentity(stringField(root.tool_name) || stringField(root.toolName), root.tool_input ?? root.toolInput);
         return {
             ...base,
             kind: "tool_failure",
-            toolName,
-            purpose: classifyToolPurpose(toolName, root.tool_input ?? root.toolInput)
+            toolName: identity.displayName,
+            purpose: identity.purpose,
+            category: identity.category,
+            identityHash: identity.identityHash
         };
     }
     if (hookEventName === "PostToolUse") {
-        const toolName = safeToolName(stringField(root.tool_name) || stringField(root.toolName));
+        const identity = classifyToolIdentity(stringField(root.tool_name) || stringField(root.toolName), root.tool_input ?? root.toolInput);
         return {
             ...base,
             kind: "tool_success",
-            toolName,
-            purpose: classifyToolPurpose(toolName, root.tool_input ?? root.toolInput)
+            toolName: identity.displayName,
+            purpose: identity.purpose,
+            category: identity.category,
+            identityHash: identity.identityHash
         };
     }
     if (hookEventName === "PostToolBatch") {

package/dist/hook-payload.js.map

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

package/dist/hook-summary.d.ts

@@ -3,10 +3,9 @@ export declare function mergeHookSummary(transcript: TranscriptSummary, hookData
     failedToolResults: number;
     toolCalls: number;
     compactionEvents: number;
-    repeatedFailures: Array<{
-        toolName: string;
-        count: number;
-        purpose?: string;
-    }>;
+    postCompactionActivity: number;
+    repeatedFailures: TranscriptSummary["repeatedFailures"];
+    blindRetry?: TranscriptSummary["blindRetry"];
     latestTimestamp?: string;
+    latestCompactionTimestamp?: string;
 }): TranscriptSummary;

package/dist/hook-summary.js

@@ -1,25 +1,51 @@
 export function mergeHookSummary(transcript, hookData) {
     const repeatedFailures = new Map();
     for (const failure of [...transcript.repeatedFailures, ...hookData.repeatedFailures]) {
-        const key = `${failure.toolName}:${failure.purpose || ""}`;
+        const key = failureKey(failure);
         const existing = repeatedFailures.get(key);
-        repeatedFailures.set(key, {
-            toolName: failure.toolName,
-            purpose: failure.purpose,
-            count: Math.max(existing?.count || 0, failure.count)
-        });
+        repeatedFailures.set(key, { ...failure, count: Math.max(existing?.count || 0, failure.count) });
     }
+    const latestTimestamp = latestIsoTimestamp(transcript.latestTimestamp, hookData.latestTimestamp);
+    const latestCompactionTimestamp = latestIsoTimestamp(transcript.latestCompactionTimestamp, hookData.latestCompactionTimestamp);
     return {
         ...transcript,
         toolCalls: Math.max(transcript.toolCalls, hookData.toolCalls),
         failedToolResults: Math.max(transcript.failedToolResults, hookData.failedToolResults),
         repeatedFailures: [...repeatedFailures.values()].filter((failure) => failure.count >= 2),
+        blindRetry: strongestBlindRetry(transcript.blindRetry, hookData.blindRetry),
         compactionEvents: Math.max(transcript.compactionEvents, hookData.compactionEvents),
-        latestTimestamp: transcript.latestTimestamp && hookData.latestTimestamp
-            ? transcript.latestTimestamp > hookData.latestTimestamp
-                ? transcript.latestTimestamp
-                : hookData.latestTimestamp
-            : transcript.latestTimestamp || hookData.latestTimestamp
+        postCompactionActivity: mergedPostCompactionActivity(transcript, hookData, latestTimestamp, latestCompactionTimestamp),
+        latestTimestamp,
+        latestCompactionTimestamp
     };
 }
+function strongestBlindRetry(first, second) {
+    if (!first) {
+        return second;
+    }
+    if (!second) {
+        return first;
+    }
+    return second.blindRetryFailureCount > first.blindRetryFailureCount ? second : first;
+}
+function failureKey(failure) {
+    return failure.category === "MCP" && failure.identityHash
+        ? `MCP:${failure.identityHash}`
+        : `${failure.toolName}:${failure.purpose || ""}`;
+}
+function latestIsoTimestamp(first, second) {
+    if (first && second) {
+        return first > second ? first : second;
+    }
+    return first || second;
+}
+function mergedPostCompactionActivity(transcript, hookData, latestTimestamp, latestCompactionTimestamp) {
+    if (!latestCompactionTimestamp) {
+        return Math.max(transcript.postCompactionActivity, hookData.postCompactionActivity);
+    }
+    const transcriptActivity = transcript.latestCompactionTimestamp === latestCompactionTimestamp ? transcript.postCompactionActivity : 0;
+    const hookActivity = hookData.latestCompactionTimestamp === latestCompactionTimestamp ? hookData.postCompactionActivity : 0;
+    const laterActivitySeen = latestTimestamp !== undefined && latestTimestamp > latestCompactionTimestamp;
+    return Math.max(transcriptActivity, hookActivity, laterActivitySeen ? 1 : 0);
+}
 //# sourceMappingURL=hook-summary.js.map

package/dist/hook-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook-summary.js","sourceRoot":"","sources":["../src/hook-summary.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,UAA6B,EAC7B,QAMC;IAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAiE,CAAC;IAClG,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,UAAU,CAAC,gBAAgB,EAAE,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrF,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC7D,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,CAAC;QACrF,gBAAgB,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACxF,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAAC;QAClF,eAAe,EACb,UAAU,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe;YACpD,CAAC,CAAC,UAAU,CAAC,eAAe,GAAG,QAAQ,CAAC,eAAe;gBACrD,CAAC,CAAC,UAAU,CAAC,eAAe;gBAC5B,CAAC,CAAC,QAAQ,CAAC,eAAe;YAC5B,CAAC,CAAC,UAAU,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe;KAC7D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"hook-summary.js","sourceRoot":"","sources":["../src/hook-summary.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,UAA6B,EAC7B,QASC;IAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAyD,CAAC;IAC1F,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,UAAU,CAAC,gBAAgB,EAAE,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrF,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,eAAe,GAAG,kBAAkB,CAAC,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjG,MAAM,yBAAyB,GAAG,kBAAkB,CAAC,UAAU,CAAC,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;IAE/H,OAAO;QACL,GAAG,UAAU;QACb,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC7D,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,CAAC;QACrF,gBAAgB,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACxF,UAAU,EAAE,mBAAmB,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;QAC3E,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAAC;QAClF,sBAAsB,EAAE,4BAA4B,CAAC,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,yBAAyB,CAAC;QACtH,eAAe;QACf,yBAAyB;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAsC,EACtC,MAAuC;IAEvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,sBAAsB,GAAG,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AACvF,CAAC;AAED,SAAS,UAAU,CAAC,OAAsD;IACxE,OAAO,OAAO,CAAC,QAAQ,KAAK,KAAK,IAAI,OAAO,CAAC,YAAY;QACvD,CAAC,CAAC,OAAO,OAAO,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB,EAAE,MAA0B;IAC/E,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,OAAO,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,IAAI,MAAM,CAAC;AACzB,CAAC;AAED,SAAS,4BAA4B,CACnC,UAA+G,EAC/G,QAIC,EACD,eAAmC,EACnC,yBAA6C;IAE7C,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,kBAAkB,GACtB,UAAU,CAAC,yBAAyB,KAAK,yBAAyB,CAAC,CAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,MAAM,YAAY,GAAG,QAAQ,CAAC,yBAAyB,KAAK,yBAAyB,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5H,MAAM,iBAAiB,GAAG,eAAe,KAAK,SAAS,IAAI,eAAe,GAAG,yBAAyB,CAAC;IACvG,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/recovery-stats.d.ts

@@ -0,0 +1,57 @@
+import type { DecisionConfidence, DecisionPersonalBaseline, FailureEpisodeSummary } from "./types.js";
+export type FailureRecoveryCategory = "tests" | "lint" | "typecheck" | "build" | "read" | "grep" | "glob" | "ls" | "edit" | "mcp" | "tool";
+export interface FailureRecoveryAggregate {
+    episodes: number;
+    recovered: number;
+    unrecovered: number;
+    activeEnded: number;
+    recoveryRate: number;
+    medianAttemptsBeforeRecovery: number;
+    p75AttemptsBeforeRecovery: number;
+    blindRetryEpisodes: number;
+    blindRetryRecovered: number;
+    blindRetryUnrecovered: number;
+    confidence: DecisionConfidence;
+}
+export interface BlindRetryAggregate {
+    episodes: number;
+    recovered: number;
+    unrecovered: number;
+    recoveryRate: number;
+    carefulLikeEpisodes: number;
+    stopLikeEpisodes: number;
+    confidence: DecisionConfidence;
+}
+export interface FailureRecoveryInsight {
+    kind: "usually_recovers" | "usually_unrecovered";
+    confidence: Exclude<DecisionConfidence, "low">;
+    category: FailureRecoveryCategory;
+    diagnosis: string;
+    baselineNote: string;
+}
+export interface RecoveryBuildCounters {
+    episodes: number;
+    recovered: number;
+    unrecovered: number;
+    activeEnded: number;
+    attemptsBeforeRecovery: number[];
+    blindRetryEpisodes: number;
+    blindRetryRecovered: number;
+    blindRetryUnrecovered: number;
+    blindRetryCarefulLikeEpisodes: number;
+    blindRetryStopLikeEpisodes: number;
+}
+export declare const FAILURE_RECOVERY_CATEGORIES: FailureRecoveryCategory[];
+export declare function emptyRecoveryBuildCounters(): Record<FailureRecoveryCategory, RecoveryBuildCounters>;
+export declare function mergeRecoveryBuildCounters(target: Record<FailureRecoveryCategory, RecoveryBuildCounters>, source: Record<FailureRecoveryCategory, RecoveryBuildCounters>): void;
+export declare function addFailureEpisodeToRecoveryCounters(target: Record<FailureRecoveryCategory, RecoveryBuildCounters>, episode: FailureEpisodeSummary): void;
+export declare function recoveryAggregatesFromCounters(counters: Record<FailureRecoveryCategory, RecoveryBuildCounters>): Partial<Record<FailureRecoveryCategory, FailureRecoveryAggregate>>;
+export declare function blindRetryAggregatesFromCounters(counters: Record<FailureRecoveryCategory, RecoveryBuildCounters>): Partial<Record<FailureRecoveryCategory, BlindRetryAggregate>>;
+export declare function recoveryInsight(baseline: DecisionPersonalBaseline | undefined, category: FailureRecoveryCategory, attempts: number): FailureRecoveryInsight | undefined;
+export declare function recoveryInsightFromAggregate(category: FailureRecoveryCategory, aggregate: FailureRecoveryAggregate, attempts: number): FailureRecoveryInsight | undefined;
+export declare function confidenceForSeen(seen: number): DecisionConfidence;
+export declare function categoryFailureSingular(category: FailureRecoveryCategory): string;
+export declare function categoryFailurePlural(category: FailureRecoveryCategory): string;
+export declare function rate(count: number, total: number): number;
+export declare function average(values: number[]): number;
+export declare function percentile(values: number[], percentileValue: number): number;