memorydetective 1.8.1 → 1.10.0

package/dist/tools/analyzeAbandonedMemory.d.ts

@@ -0,0 +1,162 @@
+/**
+ * `analyzeAbandonedMemory(beforePath, afterPath)`
+ *
+ * Diff two `.memgraph` snapshots on the reference-tree class counts (not the
+ * cycle list) and classify the GROWTH shape per class. Surfaces the family
+ * of bugs that the standard `diffMemgraphs` (cycle-focused) misses:
+ * orphaned KVO observers, never-removed NotificationCenter handlers, caches
+ * that never evict, singletons that retain payloads, and the long tail of
+ * "unknown growth" that warrants further inspection.
+ *
+ * The tool is the natural pair for the v1.8 verify-fix loop: capture a
+ * `before.memgraph`, ship the fix, capture an `after.memgraph`, then run
+ * this to confirm the suspect class went from N to <= 1. Validated end
+ * to end on the notelet investigation 2026-05-12 where AVPlayerItem went
+ * 342 to 0 across a fix that was invisible in `leaks` output but obvious
+ * in the reference tree.
+ *
+ * The classifier is pattern-catalog driven, same shape as `classifyCycle`:
+ * each grown class is matched against a small set of heuristics and tagged
+ * with a stable `classification` id + confidence tier. The agent can chain
+ * the result into `swiftSearchPattern` with the class name to locate the
+ * source.
+ */
+import { z } from "zod";
+import { type ReferenceTreeEntry } from "../parsers/referenceTree.js";
+import type { NextCallSuggestion } from "../types.js";
+export declare const analyzeAbandonedMemoryShape: {
+    readonly beforePath: z.ZodString;
+    readonly afterPath: z.ZodString;
+    readonly topN: z.ZodDefault<z.ZodNumber>;
+    readonly classFilter: z.ZodOptional<z.ZodString>;
+    readonly outputFormat: z.ZodOptional<z.ZodEnum<["markdown", "json", "both", "verify-fix-table"]>>;
+};
+export declare const analyzeAbandonedMemorySchema: z.ZodObject<{
+    readonly beforePath: z.ZodString;
+    readonly afterPath: z.ZodString;
+    readonly topN: z.ZodDefault<z.ZodNumber>;
+    readonly classFilter: z.ZodOptional<z.ZodString>;
+    readonly outputFormat: z.ZodOptional<z.ZodEnum<["markdown", "json", "both", "verify-fix-table"]>>;
+}, "strip", z.ZodTypeAny, {
+    topN: number;
+    beforePath: string;
+    afterPath: string;
+    outputFormat?: "markdown" | "json" | "both" | "verify-fix-table" | undefined;
+    classFilter?: string | undefined;
+}, {
+    beforePath: string;
+    afterPath: string;
+    outputFormat?: "markdown" | "json" | "both" | "verify-fix-table" | undefined;
+    topN?: number | undefined;
+    classFilter?: string | undefined;
+}>;
+export type AnalyzeAbandonedMemoryInput = z.infer<typeof analyzeAbandonedMemorySchema>;
+export type AbandonedMemoryClassification = "kvo-observer-orphaned" | "notificationcenter-observer-leaked" | "cache-too-aggressive" | "singleton-retains-payload" | "unknown-growth";
+export interface AbandonedMemoryEntry {
+    className: string;
+    beforeCount: number;
+    afterCount: number;
+    delta: number;
+    beforeBytes: number;
+    afterBytes: number;
+    bytesDelta: number;
+    classification: AbandonedMemoryClassification;
+    confidence: "high" | "medium" | "low";
+    hint?: string;
+}
+export interface AnalyzeAbandonedMemoryResult {
+    ok: boolean;
+    beforePath: string;
+    afterPath: string;
+    totals: {
+        classesGrown: number;
+        classesShrunk: number;
+        classesUnchanged: number;
+        netInstancesDelta: number;
+        netBytesDelta: number;
+    };
+    /**
+     * Classes that grew between before and after, ranked by absolute delta
+     * descending. Each entry carries a `classification` from the catalog plus
+     * a `confidence` tier. The agent can branch on `classification` to choose
+     * the right `swiftSearchPattern` / fix template.
+     *
+     * **Raw view.** Includes framework noise (NSMutableDictionary, CFString,
+     * libMainThreadChecker bss, etc.). Useful for cache-bloat investigations.
+     */
+    growthByClass: AbandonedMemoryEntry[];
+    /**
+     * Classes that shrunk between before and after. Surfaced so the caller
+     * can confirm the fix freed the suspect class (e.g. AVPlayerItem in the
+     * notelet case went from 342 to 0). Sorted by absolute delta desc.
+     *
+     * **Raw view.** See `actionableShrinkage` for the filtered "what fix
+     * verifiably freed" view.
+     */
+    shrinkageByClass: AbandonedMemoryEntry[];
+    /**
+     * `growthByClass` with framework noise filtered out (Foundation collection
+     * types, ObjC metadata, __DATA sections, allocator stacks, etc.). The
+     * remaining entries are user-actionable classes. New in v1.10.
+     *
+     * Use this when answering "what new bug just appeared?". Use the raw
+     * `growthByClass` when answering "what does the heap look like now?".
+     */
+    actionableGrowth: AbandonedMemoryEntry[];
+    /**
+     * `shrinkageByClass` with framework noise filtered out. Use this in the
+     * verify-fix loop to confirm which app-level classes the fix actually
+     * freed. AVPlayerItem dropping from 342 to 0 shows up here at the top.
+     * New in v1.10.
+     */
+    actionableShrinkage: AbandonedMemoryEntry[];
+    /** Plain-English diagnosis tying the highest-confidence growth to a fix hint. */
+    diagnosis: string;
+    /** Pipeline hints: chain into `swiftSearchPattern` against the top growth class. */
+    suggestedNextCalls?: NextCallSuggestion[];
+}
+/**
+ * Pure: diff two reference-tree entry lists by class name, classify each
+ * class with a delta != 0, and return the structured result minus the
+ * filesystem header fields.
+ *
+ * Exposed so tests can drive it without subprocess spawning. The async
+ * wrapper around it handles the leaks invocations.
+ */
+export declare function buildAbandonedMemoryDiff(before: ReferenceTreeEntry[], after: ReferenceTreeEntry[], options: {
+    topN: number;
+    classFilter?: string;
+}): Omit<AnalyzeAbandonedMemoryResult, "ok" | "beforePath" | "afterPath">;
+/**
+ * Pure: classify a single class's growth shape based on its name + the
+ * presence of co-occurring NSKeyValueObservance growth.
+ *
+ * Heuristics (highest specificity first):
+ *
+ * - NSKeyValueObservance / NSKeyValueObservationInfo growth: high-confidence
+ *   `kvo-observer-orphaned`. The KVO subsystem only allocates these tokens
+ *   when `obj.observe(\.x) { ... }` is called; growth here means tokens
+ *   never invalidated.
+ *
+ * - When KVO observation infrastructure grew, escalate any other class
+ *   with delta >= 5 to `kvo-observer-orphaned` (medium confidence). These
+ *   are typically the observed types being retained by orphaned observers
+ *   (AVPlayerItem in the notelet case).
+ *
+ * - NSCache / NSCountedSet / NSMapTable / NSMutable{Array,Dictionary,Set}
+ *   growth: medium-confidence `cache-too-aggressive`. Collection classes
+ *   that grow across a workflow typically indicate missing eviction.
+ *
+ * - NotificationCenter observer block growth (NSConcreteNotification,
+ *   __NSObserver, and similar): medium-confidence
+ *   `notificationcenter-observer-leaked`.
+ *
+ * - Everything else: low-confidence `unknown-growth`. The agent should
+ *   chain into `swiftSearchPattern` with the class name to confirm.
+ */
+export declare function classifyGrowth(className: string, delta: number, hasKvoCoOccurrence: boolean, kvoObservanceDelta: number): {
+    classification: AbandonedMemoryClassification;
+    confidence: "high" | "medium" | "low";
+    hint?: string;
+};
+export declare function analyzeAbandonedMemory(input: AnalyzeAbandonedMemoryInput): Promise<AnalyzeAbandonedMemoryResult>;

package/dist/tools/analyzeAbandonedMemory.js

@@ -0,0 +1,325 @@
+/**
+ * `analyzeAbandonedMemory(beforePath, afterPath)`
+ *
+ * Diff two `.memgraph` snapshots on the reference-tree class counts (not the
+ * cycle list) and classify the GROWTH shape per class. Surfaces the family
+ * of bugs that the standard `diffMemgraphs` (cycle-focused) misses:
+ * orphaned KVO observers, never-removed NotificationCenter handlers, caches
+ * that never evict, singletons that retain payloads, and the long tail of
+ * "unknown growth" that warrants further inspection.
+ *
+ * The tool is the natural pair for the v1.8 verify-fix loop: capture a
+ * `before.memgraph`, ship the fix, capture an `after.memgraph`, then run
+ * this to confirm the suspect class went from N to <= 1. Validated end
+ * to end on the notelet investigation 2026-05-12 where AVPlayerItem went
+ * 342 to 0 across a fix that was invisible in `leaks` output but obvious
+ * in the reference tree.
+ *
+ * The classifier is pattern-catalog driven, same shape as `classifyCycle`:
+ * each grown class is matched against a small set of heuristics and tagged
+ * with a stable `classification` id + confidence tier. The agent can chain
+ * the result into `swiftSearchPattern` with the class name to locate the
+ * source.
+ */
+import { z } from "zod";
+import { existsSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { runCommand } from "../runtime/exec.js";
+import { parseReferenceTreeText, isFrameworkNoise, } from "../parsers/referenceTree.js";
+import { outputFormatField } from "../runtime/responseFormatter.js";
+export const analyzeAbandonedMemoryShape = {
+    beforePath: z
+        .string()
+        .min(1)
+        .describe("Absolute path to the baseline `.memgraph` (the BEFORE snapshot). Use `captureScenarioState({ label: 'before' })` to produce one in the standard verify-fix flow."),
+    afterPath: z
+        .string()
+        .min(1)
+        .describe("Absolute path to the post-fix `.memgraph` (the AFTER snapshot). Same workflow as `beforePath`, after applying the candidate fix."),
+    topN: z
+        .number()
+        .int()
+        .positive()
+        .max(200)
+        .default(25)
+        .describe("Cap on `growthByClass[]` length. Default 25, max 200. Classes are ranked by absolute instance-count delta descending."),
+    classFilter: z
+        .string()
+        .optional()
+        .describe("Optional substring filter. When set, only classes whose name contains this substring are included in the response. Useful for verifying a specific class went to baseline without seeing the surrounding noise."),
+    outputFormat: outputFormatField,
+};
+export const analyzeAbandonedMemorySchema = z.object(analyzeAbandonedMemoryShape);
+/**
+ * Pure: diff two reference-tree entry lists by class name, classify each
+ * class with a delta != 0, and return the structured result minus the
+ * filesystem header fields.
+ *
+ * Exposed so tests can drive it without subprocess spawning. The async
+ * wrapper around it handles the leaks invocations.
+ */
+export function buildAbandonedMemoryDiff(before, after, options) {
+    const beforeByName = new Map(before.map((e) => [e.className, e]));
+    const afterByName = new Map(after.map((e) => [e.className, e]));
+    const allNames = new Set([...beforeByName.keys(), ...afterByName.keys()]);
+    const raw = [];
+    for (const name of allNames) {
+        if (options.classFilter && !name.includes(options.classFilter))
+            continue;
+        const b = beforeByName.get(name);
+        const a = afterByName.get(name);
+        const beforeCount = b?.instanceCount ?? 0;
+        const afterCount = a?.instanceCount ?? 0;
+        const beforeBytes = b?.totalBytes ?? 0;
+        const afterBytes = a?.totalBytes ?? 0;
+        raw.push({
+            className: name,
+            beforeCount,
+            afterCount,
+            delta: afterCount - beforeCount,
+            beforeBytes,
+            afterBytes,
+            bytesDelta: afterBytes - beforeBytes,
+        });
+    }
+    // Co-occurrence signal: did the KVO observation infrastructure grow?
+    // If yes, the same-direction growth of other large classes is best
+    // explained as "those classes are the observed types being retained
+    // by orphaned observers", and the classifier should escalate them to
+    // `kvo-observer-orphaned` instead of leaving them as `unknown-growth`.
+    const kvoObservanceGrowth = raw.find((r) => r.className === "NSKeyValueObservance")?.delta ?? 0;
+    const kvoObservationInfoGrowth = raw.find((r) => r.className === "NSKeyValueObservationInfo")?.delta ?? 0;
+    const hasKvoCoOccurrence = kvoObservanceGrowth >= 3 || kvoObservationInfoGrowth >= 3;
+    const grown = raw.filter((r) => r.delta > 0);
+    const shrunk = raw.filter((r) => r.delta < 0);
+    const unchanged = raw.filter((r) => r.delta === 0).length;
+    const growthByClass = grown
+        .map((r) => {
+        const { classification, confidence, hint } = classifyGrowth(r.className, r.delta, hasKvoCoOccurrence, kvoObservanceGrowth);
+        return {
+            className: r.className,
+            beforeCount: r.beforeCount,
+            afterCount: r.afterCount,
+            delta: r.delta,
+            beforeBytes: r.beforeBytes,
+            afterBytes: r.afterBytes,
+            bytesDelta: r.bytesDelta,
+            classification,
+            confidence,
+            ...(hint ? { hint } : {}),
+        };
+    })
+        .sort((a, b) => b.delta - a.delta || b.bytesDelta - a.bytesDelta);
+    const shrinkageByClass = shrunk
+        .map((r) => ({
+        className: r.className,
+        beforeCount: r.beforeCount,
+        afterCount: r.afterCount,
+        delta: r.delta,
+        beforeBytes: r.beforeBytes,
+        afterBytes: r.afterBytes,
+        bytesDelta: r.bytesDelta,
+        // Shrinkage entries are still classified for symmetry, but the
+        // classification reflects what the suspect-shaped class WAS doing
+        // before; the fix freed it, which is what we want to confirm.
+        classification: classifyGrowth(r.className, Math.abs(r.delta), false, 0).classification,
+        confidence: "high",
+    }))
+        .sort((a, b) => a.delta - b.delta || a.bytesDelta - b.bytesDelta);
+    const netInstancesDelta = raw.reduce((acc, r) => acc + r.delta, 0);
+    const netBytesDelta = raw.reduce((acc, r) => acc + r.bytesDelta, 0);
+    const totals = {
+        classesGrown: grown.length,
+        classesShrunk: shrunk.length,
+        classesUnchanged: unchanged,
+        netInstancesDelta,
+        netBytesDelta,
+    };
+    const diagnosis = buildDiagnosis(growthByClass, shrinkageByClass);
+    const suggestedNextCalls = buildSuggestedNextCalls(growthByClass);
+    // Actionable views: drop framework noise so the caller's first-look list
+    // surfaces app-level + AV + KVO classes instead of NSMutableDictionary +
+    // CFString + ObjC runtime data. Same ranking, just filtered. Falls back
+    // to topN, so the actionable list can be SHORTER than the raw view when
+    // most of the top entries are noise.
+    const actionableGrowth = growthByClass
+        .filter((e) => !isFrameworkNoise(e.className))
+        .slice(0, options.topN);
+    const actionableShrinkage = shrinkageByClass
+        .filter((e) => !isFrameworkNoise(e.className))
+        .slice(0, options.topN);
+    return {
+        totals,
+        growthByClass: growthByClass.slice(0, options.topN),
+        shrinkageByClass: shrinkageByClass.slice(0, options.topN),
+        actionableGrowth,
+        actionableShrinkage,
+        diagnosis,
+        ...(suggestedNextCalls.length > 0 ? { suggestedNextCalls } : {}),
+    };
+}
+/**
+ * Pure: classify a single class's growth shape based on its name + the
+ * presence of co-occurring NSKeyValueObservance growth.
+ *
+ * Heuristics (highest specificity first):
+ *
+ * - NSKeyValueObservance / NSKeyValueObservationInfo growth: high-confidence
+ *   `kvo-observer-orphaned`. The KVO subsystem only allocates these tokens
+ *   when `obj.observe(\.x) { ... }` is called; growth here means tokens
+ *   never invalidated.
+ *
+ * - When KVO observation infrastructure grew, escalate any other class
+ *   with delta >= 5 to `kvo-observer-orphaned` (medium confidence). These
+ *   are typically the observed types being retained by orphaned observers
+ *   (AVPlayerItem in the notelet case).
+ *
+ * - NSCache / NSCountedSet / NSMapTable / NSMutable{Array,Dictionary,Set}
+ *   growth: medium-confidence `cache-too-aggressive`. Collection classes
+ *   that grow across a workflow typically indicate missing eviction.
+ *
+ * - NotificationCenter observer block growth (NSConcreteNotification,
+ *   __NSObserver, and similar): medium-confidence
+ *   `notificationcenter-observer-leaked`.
+ *
+ * - Everything else: low-confidence `unknown-growth`. The agent should
+ *   chain into `swiftSearchPattern` with the class name to confirm.
+ */
+export function classifyGrowth(className, delta, hasKvoCoOccurrence, kvoObservanceDelta) {
+    if (className.includes("NSKeyValueObservance") ||
+        className.includes("NSKeyValueObservationInfo")) {
+        return {
+            classification: "kvo-observer-orphaned",
+            confidence: "high",
+            hint: "NSKeyValueObservance growth indicates `observe(\\.x) { ... }` tokens that were never invalidated. The token strongly retains the change closure (which usually captures self), and the closure is anchored in the KVO global observer registry. Use `[weak self]` inside the observe closure and call `token?.invalidate()` in `deinit`, or invalidate-then-nil before reassigning the token. See `classifyCycle` pattern `kvo.observation-not-invalidated`.",
+        };
+    }
+    // KVO co-occurrence escalation. Tightened in v1.10 after the v1.9 retro
+    // showed the broad `delta >= 5` rule was painting 25 unrelated classes
+    // as `kvo-observer-orphaned high` whenever NSKeyValueObservance grew at
+    // all. Three guards now:
+    //   1. Skip classes that look like framework noise (allocator stacks,
+    //      memory zones, __DATA sections, summary rows, etc.)
+    //   2. Skip classes that are not "object-shaped" (anonymous bracket
+    //      forms `<... 0xADDR> [size]`, byte-offset prefixes, etc.). These
+    //      slip past Phase A's extractClassName when the leaks output uses
+    //      a non-canonical form for them.
+    //   3. Require the candidate's delta to be a meaningful FRACTION of
+    //      the KVO growth, not just any positive delta. A class with
+    //      delta=5 when NSKeyValueObservance grew by +200 is statistical
+    //      noise; the proportion thresholds below capture this.
+    if (hasKvoCoOccurrence && delta >= 5) {
+        const isObjectShaped = !isFrameworkNoise(className) &&
+            !/^<.*0x[0-9a-fA-F]+.*>/.test(className) &&
+            !/^\d+ bytes into\b/.test(className);
+        // Proportional thresholds. A class whose delta is below half of the
+        // NSKeyValueObservance delta is rejected as too small to be the
+        // observed type. Above 5x the KVO delta the confidence escalates
+        // to high (the class is the dominant observed type by a wide margin).
+        const mediumThreshold = Math.max(5, Math.floor(kvoObservanceDelta * 0.5));
+        const highThreshold = Math.max(50, Math.floor(kvoObservanceDelta * 5));
+        if (isObjectShaped && delta >= mediumThreshold) {
+            const confidence = delta >= highThreshold ? "high" : "medium";
+            return {
+                classification: "kvo-observer-orphaned",
+                confidence,
+                hint: `Co-occurring NSKeyValueObservance growth (+${kvoObservanceDelta}) suggests this type is the value being observed via \`observe(\\.x) { ... }\`. The orphaned observer holds the value alive. Fixing the observer (\`token.invalidate()\` on teardown) will free this class too. See \`classifyCycle\` pattern \`kvo.observation-not-invalidated\`.`,
+            };
+        }
+    }
+    if (/^NS(Cache|CountedSet|MapTable|MutableArray|MutableDictionary|MutableSet|HashTable)/.test(className)) {
+        return {
+            classification: "cache-too-aggressive",
+            confidence: "medium",
+            hint: "Bulk-storage class is growing across the workflow. Likely a cache or collection without eviction. For `NSCache`, set `countLimit` or `totalCostLimit`. For `NSMutable*`, audit the producer to confirm it is not appending without bounds. For domain caches, prefer `NSCache` over `NSMutableDictionary` when you want OS-driven eviction under memory pressure.",
+        };
+    }
+    if (/NotificationToken|NotificationObserver|__NSObserver|NSConcreteNotification|NSNotificationCenterObserver/.test(className)) {
+        return {
+            classification: "notificationcenter-observer-leaked",
+            confidence: "medium",
+            hint: "NotificationCenter observer block (added via `addObserver(forName:object:queue:using:)`) growth indicates the returned token was never passed to `removeObserver(_:)`. Store the token on `self` and remove it in `deinit`, or use the selector-based variant which auto-deregisters on dealloc.",
+        };
+    }
+    return {
+        classification: "unknown-growth",
+        confidence: "low",
+        hint: "Class grew between before and after but the catalog did not recognize a known abandoned-memory shape. Chain into `swiftSearchPattern` with this class name to locate the allocation sites, then inspect for missing teardown (observers, timers, dispatch sources, weak ownership invariants).",
+    };
+}
+function buildDiagnosis(grown, shrunk) {
+    if (grown.length === 0 && shrunk.length === 0) {
+        return "No class-count changes between before and after. Either the fix had no effect on the heap composition, or the workflow did not exercise the code path.";
+    }
+    if (grown.length === 0) {
+        const top = shrunk[0];
+        return `No growth detected. ${shrunk.length} class${shrunk.length === 1 ? "" : "es"} shrunk. Largest: ${top.className} (${top.beforeCount} to ${top.afterCount}, delta ${top.delta}). The fix appears to have closed an abandoned-memory chain.`;
+    }
+    const highConfidence = grown.filter((e) => e.confidence === "high");
+    const top = grown[0];
+    if (highConfidence.length > 0) {
+        const hc = highConfidence[0];
+        return `${grown.length} class${grown.length === 1 ? "" : "es"} grew. Top suspect: ${hc.className} (${hc.beforeCount} to ${hc.afterCount}, delta +${hc.delta}). Classification: ${hc.classification} (high confidence). ${hc.hint ?? ""}`;
+    }
+    return `${grown.length} class${grown.length === 1 ? "" : "es"} grew. Largest: ${top.className} (${top.beforeCount} to ${top.afterCount}, delta +${top.delta}). Classification: ${top.classification} (${top.confidence} confidence). Chain into swiftSearchPattern with the class name to locate the allocation site.`;
+}
+function buildSuggestedNextCalls(grown) {
+    if (grown.length === 0)
+        return [];
+    // Prefer the highest-confidence + largest-delta entry for the suggestion.
+    const ranked = [...grown].sort((a, b) => {
+        const confRank = (c) => c === "high" ? 2 : c === "medium" ? 1 : 0;
+        const diff = confRank(b.confidence) - confRank(a.confidence);
+        if (diff !== 0)
+            return diff;
+        return b.delta - a.delta;
+    });
+    const target = ranked[0];
+    return [
+        {
+            tool: "swiftSearchPattern",
+            args: {
+                pattern: target.className,
+                scope: "<your project root>",
+            },
+            why: `Locate the allocation site for ${target.className} (grew by +${target.delta} between snapshots; classified as ${target.classification}, ${target.confidence} confidence). The class name + a project-wide pattern search usually narrows to one or two files.`,
+        },
+    ];
+}
+/**
+ * Spawn `leaks --referenceTree --groupByType --noContent` against a .memgraph
+ * and return parsed entries. Wide topN here (1000) so the diff has the full
+ * picture; the user-facing `topN` only applies to the FINAL response slice.
+ */
+async function loadReferenceTree(path) {
+    const result = await runCommand("leaks", [path, "--referenceTree", "--groupByType", "--noContent"], { timeoutMs: 5 * 60_000 });
+    if (result.code !== 0 && result.code !== 1) {
+        throw new Error(`leaks --referenceTree failed (code ${result.code}) on ${path}: ${result.stderr || result.stdout}`);
+    }
+    return parseReferenceTreeText(result.stdout, 1000);
+}
+export async function analyzeAbandonedMemory(input) {
+    const beforePath = resolvePath(input.beforePath);
+    const afterPath = resolvePath(input.afterPath);
+    if (!existsSync(beforePath)) {
+        throw new Error(`Before memgraph not found: ${beforePath}`);
+    }
+    if (!existsSync(afterPath)) {
+        throw new Error(`After memgraph not found: ${afterPath}`);
+    }
+    const [before, after] = await Promise.all([
+        loadReferenceTree(beforePath),
+        loadReferenceTree(afterPath),
+    ]);
+    const diff = buildAbandonedMemoryDiff(before, after, {
+        topN: input.topN ?? 25,
+        ...(input.classFilter ? { classFilter: input.classFilter } : {}),
+    });
+    return {
+        ok: true,
+        beforePath,
+        afterPath,
+        ...diff,
+    };
+}
+//# sourceMappingURL=analyzeAbandonedMemory.js.map

package/dist/tools/analyzeAbandonedMemory.js.map

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

package/dist/tools/analyzeAllocations.d.ts

@@ -1,14 +1,18 @@
 import { z } from "zod";
+import type { DataStatus } from "../types.js";
 export declare const analyzeAllocationsSchema: z.ZodObject<{
     tracePath: z.ZodString;
     topN: z.ZodDefault<z.ZodNumber>;
     minBytes: z.ZodDefault<z.ZodNumber>;
+    outputFormat: z.ZodOptional<z.ZodEnum<["markdown", "json", "both", "verify-fix-table"]>>;
 }, "strip", z.ZodTypeAny, {
-    topN: number;
     tracePath: string;
+    topN: number;
     minBytes: number;
+    outputFormat?: "markdown" | "json" | "both" | "verify-fix-table" | undefined;
 }, {
     tracePath: string;
+    outputFormat?: "markdown" | "json" | "both" | "verify-fix-table" | undefined;
     topN?: number | undefined;
     minBytes?: number | undefined;
 }>;
@@ -38,9 +42,14 @@ export interface AnalyzeAllocationsResult {
     };
     /** Top categories by cumulative bytes. */
     topByBytes: AllocationEntry[];
-    /** Top categories by allocation count (different signal — small frequent allocations). */
+    /** Top categories by allocation count (different signal, small frequent allocations). */
     topByCount: AllocationEntry[];
     diagnosis: string;
+    /**
+     * Disambiguates empty arrays into "no data in the trace" vs "trace could
+     * not be exported" vs "data was exported partially". See {@link DataStatus}.
+     */
+    status: DataStatus;
 }
 /** Pure: turn parsed XML into the analyzed result. */
 export declare function analyzeAllocationsFromXml(xml: string, tracePath: string, topN?: number, minBytes?: number): AnalyzeAllocationsResult;

package/dist/tools/analyzeAllocations.js

@@ -3,6 +3,7 @@ import { existsSync } from "node:fs";
 import { resolve as resolvePath } from "node:path";
 import { runCommand } from "../runtime/exec.js";
 import { parseXctraceXml, asNumber, asFormatted, } from "../parsers/xctraceXml.js";
+import { outputFormatField } from "../runtime/responseFormatter.js";
 export const analyzeAllocationsSchema = z.object({
     tracePath: z
         .string()
@@ -19,6 +20,7 @@ export const analyzeAllocationsSchema = z.object({
         .nonnegative()
         .default(0)
         .describe("Filter out individual allocations smaller than this size in bytes (default 0). Use 1024 to focus on >1KB allocations."),
+    outputFormat: outputFormatField,
 });
 /** Pure: turn parsed XML into the analyzed result. */
 export function analyzeAllocationsFromXml(xml, tracePath, topN = 15, minBytes = 0) {
@@ -38,6 +40,7 @@ export function analyzeAllocationsFromXml(xml, tracePath, topN = 15, minBytes =
             topByBytes: [],
             topByCount: [],
             diagnosis: "No allocations table found in the trace.",
+            status: "not_present",
         };
     }
     // The xctrace `allocations` schema has columns roughly like:
@@ -126,6 +129,7 @@ export function analyzeAllocationsFromXml(xml, tracePath, topN = 15, minBytes =
         topByBytes,
         topByCount,
         diagnosis,
+        status: "available",
     };
 }
 function buildDiagnosis(rows, cumulativeBytes, topByBytes) {

package/dist/tools/analyzeAllocations.js.map

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

package/dist/tools/analyzeAnimationHitches.d.ts

@@ -1,16 +1,38 @@
 import { z } from "zod";
+import type { DataStatus } from "../types.js";
 export declare const analyzeAnimationHitchesSchema: z.ZodObject<{
     tracePath: z.ZodString;
     topN: z.ZodDefault<z.ZodNumber>;
     minDurationMs: z.ZodDefault<z.ZodNumber>;
+    timeRangeMs: z.ZodOptional<z.ZodObject<{
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startMs: number;
+        endMs: number;
+    }, {
+        startMs: number;
+        endMs: number;
+    }>>;
+    outputFormat: z.ZodOptional<z.ZodEnum<["markdown", "json", "both", "verify-fix-table"]>>;
 }, "strip", z.ZodTypeAny, {
-    topN: number;
     tracePath: string;
+    topN: number;
     minDurationMs: number;
+    outputFormat?: "markdown" | "json" | "both" | "verify-fix-table" | undefined;
+    timeRangeMs?: {
+        startMs: number;
+        endMs: number;
+    } | undefined;
 }, {
     tracePath: string;
+    outputFormat?: "markdown" | "json" | "both" | "verify-fix-table" | undefined;
     topN?: number | undefined;
     minDurationMs?: number | undefined;
+    timeRangeMs?: {
+        startMs: number;
+        endMs: number;
+    } | undefined;
 }>;
 export type AnalyzeAnimationHitchesInput = z.infer<typeof analyzeAnimationHitchesSchema>;
 export interface HitchEntry {
@@ -37,7 +59,15 @@ export interface AnalyzeAnimationHitchesResult {
     byType: Record<string, number>;
     top: HitchEntry[];
     diagnosis: string;
+    /**
+     * Disambiguates empty arrays into "no data in the trace" vs "trace could
+     * not be exported" vs "data was exported partially". See {@link DataStatus}.
+     */
+    status: DataStatus;
 }
 /** Pure: turn parsed XML into the analyzed result. */
-export declare function analyzeAnimationHitchesFromXml(xml: string, tracePath: string, topN?: number, minDurationMs?: number): AnalyzeAnimationHitchesResult;
+export declare function analyzeAnimationHitchesFromXml(xml: string, tracePath: string, topN?: number, minDurationMs?: number, timeRangeMs?: {
+    startMs: number;
+    endMs: number;
+}): AnalyzeAnimationHitchesResult;
 export declare function analyzeAnimationHitches(input: AnalyzeAnimationHitchesInput): Promise<AnalyzeAnimationHitchesResult>;