memorydetective 1.10.0 → 1.12.0

package/dist/tools/diffMemgraphs.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { type ReferenceTreeEntry } from "../parsers/referenceTree.js";
 import type { LeaksReport } from "../types.js";
 export declare const diffMemgraphsSchema: z.ZodObject<{
     before: z.ZodString;
@@ -26,6 +27,15 @@ export interface CycleDiffEntry {
     afterCount: number;
     delta: number;
 }
+export interface ReferenceTreeDiffEntry {
+    className: string;
+    before: number;
+    after: number;
+    delta: number;
+    beforeBytes: number;
+    afterBytes: number;
+    bytesDelta: number;
+}
 export interface DiffMemgraphsResult {
     ok: boolean;
     before: {
@@ -39,16 +49,24 @@ export interface DiffMemgraphsResult {
     totals: {
         leakCountDelta: number;
         bytesLeakedDelta: number;
+        /**
+         * Net instance-count delta from the reference-tree (heap-wide) view.
+         * Sum of all `referenceTreeChanges` deltas. Useful for "did the heap
+         * shrink overall?" without scrolling per-class. New in v1.11.
+         */
+        referenceTreeInstanceDelta?: number;
+        /** Net bytes delta from the reference-tree view. New in v1.11. */
+        referenceTreeBytesDelta?: number;
     };
     classCounts: {
-        /** Classes whose count went up (potential new leaks). */
+        /** Classes whose count went up (potential new leaks). Cycle-based view. */
         increased: Array<{
             className: string;
             before: number;
             after: number;
             delta: number;
         }>;
-        /** Classes whose count went down (fixed leaks or just gone). */
+        /** Classes whose count went down (fixed leaks or just gone). Cycle-based view. */
         decreased: Array<{
             className: string;
             before: number;
@@ -56,15 +74,50 @@ export interface DiffMemgraphsResult {
             delta: number;
         }>;
     };
+    /**
+     * Heap-wide class-count changes from the reference-tree pass. Populated
+     * even when `leakCount` is 0 in both snapshots (which is exactly when
+     * cycle-only `classCounts` returns empty and the user wants this view).
+     * Includes framework noise (NSMutableDictionary, CFString, etc.); see
+     * `actionableReferenceTreeChanges` for the filtered view. New in v1.11.
+     */
+    referenceTreeChanges?: {
+        increased: ReferenceTreeDiffEntry[];
+        decreased: ReferenceTreeDiffEntry[];
+    };
+    /**
+     * `referenceTreeChanges` with framework noise filtered out via
+     * `isFrameworkNoise`. Surfaces AV / KVO / app-level classes for the
+     * verify-fix loop without scrolling past Foundation collection growth.
+     * New in v1.11.
+     */
+    actionableReferenceTreeChanges?: {
+        increased: ReferenceTreeDiffEntry[];
+        decreased: ReferenceTreeDiffEntry[];
+    };
     cycles: {
         /** ROOT CYCLE signatures present only in `after`. */
         newInAfter: CycleDiffEntry[];
         /** Signatures present only in `before` (cycle disappeared). */
         goneFromBefore: CycleDiffEntry[];
-        /** Signatures present in both — count change is what matters. */
+        /** Signatures present in both; count change is what matters. */
         persisted: CycleDiffEntry[];
     };
 }
 /** Pure: compare two parsed reports and return a structured diff. */
 export declare function diffReports(before: LeaksReport, after: LeaksReport, beforePath: string, afterPath: string): DiffMemgraphsResult;
+/**
+ * Pure: diff two reference-tree entry lists by class name and return
+ * increased / decreased buckets. Each entry carries before/after counts,
+ * bytes, and delta values. Sorted: increased by delta desc, decreased by
+ * delta asc (most-negative first).
+ *
+ * Returns null when both inputs are empty. The async wrapper uses this
+ * absence to suppress the `referenceTreeChanges` field on the result so
+ * cycle-only callers see no change vs v1.10. New in v1.11.
+ */
+export declare function diffReferenceTrees(before: ReferenceTreeEntry[], after: ReferenceTreeEntry[]): {
+    increased: ReferenceTreeDiffEntry[];
+    decreased: ReferenceTreeDiffEntry[];
+} | null;
 export declare function diffMemgraphs(input: DiffMemgraphsInput): Promise<DiffMemgraphsResult>;

package/dist/tools/diffMemgraphs.js

@@ -1,6 +1,8 @@
 import { z } from "zod";
+import { runCommand } from "../runtime/exec.js";
 import { runLeaksAndParse } from "../runtime/leaks.js";
 import { rootCyclesOnly } from "../parsers/leaksOutput.js";
+import { parseReferenceTreeText, isFrameworkNoise, } from "../parsers/referenceTree.js";
 import { countByClass } from "./countAlive.js";
 import { outputFormatField } from "../runtime/responseFormatter.js";
 export const diffMemgraphsSchema = z.object({
@@ -104,11 +106,106 @@ export function diffReports(before, after, beforePath, afterPath) {
         cycles: { newInAfter, goneFromBefore, persisted },
     };
 }
+/**
+ * Pure: diff two reference-tree entry lists by class name and return
+ * increased / decreased buckets. Each entry carries before/after counts,
+ * bytes, and delta values. Sorted: increased by delta desc, decreased by
+ * delta asc (most-negative first).
+ *
+ * Returns null when both inputs are empty. The async wrapper uses this
+ * absence to suppress the `referenceTreeChanges` field on the result so
+ * cycle-only callers see no change vs v1.10. New in v1.11.
+ */
+export function diffReferenceTrees(before, after) {
+    if (before.length === 0 && after.length === 0)
+        return null;
+    const beforeByClass = new Map(before.map((e) => [e.className, e]));
+    const afterByClass = new Map(after.map((e) => [e.className, e]));
+    const allClasses = new Set([
+        ...beforeByClass.keys(),
+        ...afterByClass.keys(),
+    ]);
+    const increased = [];
+    const decreased = [];
+    for (const cls of allClasses) {
+        const b = beforeByClass.get(cls);
+        const a = afterByClass.get(cls);
+        const beforeCount = b?.instanceCount ?? 0;
+        const afterCount = a?.instanceCount ?? 0;
+        const delta = afterCount - beforeCount;
+        if (delta === 0)
+            continue;
+        const beforeBytes = b?.totalBytes ?? 0;
+        const afterBytes = a?.totalBytes ?? 0;
+        const entry = {
+            className: cls,
+            before: beforeCount,
+            after: afterCount,
+            delta,
+            beforeBytes,
+            afterBytes,
+            bytesDelta: afterBytes - beforeBytes,
+        };
+        if (delta > 0)
+            increased.push(entry);
+        else
+            decreased.push(entry);
+    }
+    increased.sort((x, y) => y.delta - x.delta || y.bytesDelta - x.bytesDelta);
+    decreased.sort((x, y) => x.delta - y.delta || x.bytesDelta - y.bytesDelta);
+    return { increased, decreased };
+}
+/**
+ * Wide capture pool for the reference-tree pass. Mirrors analyzeMemgraph's
+ * 10x heuristic from v1.10: the actionable view filters out framework
+ * noise (NSMutableDictionary, CFString, libMainThreadChecker bss, etc.)
+ * so we need enough headroom for app-level classes ranked below the
+ * noise leaders to survive into the post-filter top.
+ */
+const REFERENCE_TREE_DIFF_TOPN = 1000;
+/** Spawn `leaks --referenceTree --groupByType --noContent` against a
+ *  `.memgraph` and return parsed entries. Failure is non-fatal: returns
+ *  an empty array so the cycle-side diff still completes. */
+async function captureReferenceTree(path) {
+    const result = await runCommand("leaks", ["--referenceTree", "--groupByType", "--noContent", path], { timeoutMs: 5 * 60_000 });
+    if (result.code !== 0 && result.code !== 1) {
+        return [];
+    }
+    return parseReferenceTreeText(result.stdout, REFERENCE_TREE_DIFF_TOPN);
+}
 export async function diffMemgraphs(input) {
-    const [{ report: before, resolvedPath: bp }, { report: after, resolvedPath: ap }] = await Promise.all([
+    const [{ report: before, resolvedPath: bp }, { report: after, resolvedPath: ap }, beforeRefTree, afterRefTree,] = await Promise.all([
         runLeaksAndParse(input.before),
         runLeaksAndParse(input.after),
+        captureReferenceTree(input.before),
+        captureReferenceTree(input.after),
     ]);
-    return diffReports(before, after, bp, ap);
+    const result = diffReports(before, after, bp, ap);
+    const referenceTreeChanges = diffReferenceTrees(beforeRefTree, afterRefTree);
+    if (referenceTreeChanges) {
+        result.referenceTreeChanges = referenceTreeChanges;
+        // Actionable view: same diff with framework noise filtered out. Same
+        // ordering preserved (no re-rank). Provides the verify-fix view for
+        // the notelet-shape case where AVPlayerItem 342 to 0 needs to surface
+        // above NSMutableDictionary 12k to 11k noise.
+        result.actionableReferenceTreeChanges = {
+            increased: referenceTreeChanges.increased.filter((e) => !isFrameworkNoise(e.className)),
+            decreased: referenceTreeChanges.decreased.filter((e) => !isFrameworkNoise(e.className)),
+        };
+        // Heap-wide totals so callers can branch on a single number.
+        let instanceDelta = 0;
+        let bytesDelta = 0;
+        for (const e of referenceTreeChanges.increased) {
+            instanceDelta += e.delta;
+            bytesDelta += e.bytesDelta;
+        }
+        for (const e of referenceTreeChanges.decreased) {
+            instanceDelta += e.delta;
+            bytesDelta += e.bytesDelta;
+        }
+        result.totals.referenceTreeInstanceDelta = instanceDelta;
+        result.totals.referenceTreeBytesDelta = bytesDelta;
+    }
+    return result;
 }
 //# sourceMappingURL=diffMemgraphs.js.map

package/dist/tools/diffMemgraphs.js.map

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

package/dist/tools/findRetainers.d.ts

@@ -1,17 +1,21 @@
 import { z } from "zod";
+import { type ReferenceTreeChain } from "../parsers/leaksDebugStacks.js";
 import type { LeaksReport, NextCallSuggestion } from "../types.js";
 export declare const findRetainersSchema: z.ZodObject<{
     path: z.ZodString;
     className: z.ZodString;
     maxResults: z.ZodDefault<z.ZodNumber>;
+    includeReferenceTree: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     className: string;
     path: string;
     maxResults: number;
+    includeReferenceTree: boolean;
 }, {
     className: string;
     path: string;
     maxResults?: number | undefined;
+    includeReferenceTree?: boolean | undefined;
 }>;
 export type FindRetainersInput = z.infer<typeof findRetainersSchema>;
 export interface RetainerChainEntry {
@@ -33,7 +37,17 @@ export interface FindRetainersResult {
     className: string;
     totalMatches: number;
     retainers: RetainerChain[];
-    /** Pipeline hint — once you know who retains the class, locate it in source. */
+    /**
+     * v1.12+. Populated when `includeReferenceTree: true` and `leaks
+     * --debug=stacks` returned data. Each chain aggregates instances that
+     * share the same allocation call stack (the 342 notelet AVPlayerItem
+     * instances collapse to 1 chain with `instanceCount: 342`). The
+     * `userFrame` field surfaces the deepest non-system frame, which is
+     * the line a developer would inspect (e.g. `MediaNoteItemVideoView.prepareVideo`
+     * for the notelet case).
+     */
+    referenceTreeChains?: ReferenceTreeChain[];
+    /** Pipeline hint: once you know who retains the class, locate it in source. */
     suggestedNextCalls?: NextCallSuggestion[];
 }
 /**

package/dist/tools/findRetainers.js

@@ -1,5 +1,7 @@
 import { z } from "zod";
+import { runCommand } from "../runtime/exec.js";
 import { runLeaksAndParse } from "../runtime/leaks.js";
+import { parseLeaksDebugStacks, } from "../parsers/leaksDebugStacks.js";
 import { suggestionGetDefinition } from "../runtime/suggestions.js";
 export const findRetainersSchema = z.object({
     path: z.string().min(1).describe("Absolute path to a `.memgraph` file."),
@@ -13,6 +15,10 @@ export const findRetainersSchema = z.object({
         .positive()
         .default(10)
         .describe("Cap on how many retain chains to return (default 10)."),
+    includeReferenceTree: z
+        .boolean()
+        .default(false)
+        .describe("v1.12+. When true, also run `leaks --debug=stacks --debug='<className>$'` to surface per-instance allocation stacks aggregated by call-stack fingerprint. Required on memgraphs where `leakCount: 0` and the class is reachable from KVO/NotificationCenter/caches (abandoned-memory shape). Each chain returns the allocation call stack + the unique retainer classes + a representative instance address. **Note:** `leaks --debug=stacks` only emits blocks for instances whose allocation stack was recorded, which requires the target was launched with `MallocStackLogging=1`. Xcode's Memory Graph Debugger export does NOT enable MSL by default, so memgraphs captured that way may surface fewer chains than the total instance count from `analyzeMemgraph.abandonedMemorySuspects[]`. Default false preserves v1.11 behavior."),
 });
 /**
  * Walk the cycle forest and collect every parent-path that ends in a node whose
@@ -46,19 +52,59 @@ export function findRetainersIn(report, needle, maxResults = 10) {
         visit(root, []);
     return { totalMatches: total, retainers: matches };
 }
+/**
+ * Spawn `leaks --debug=stacks --debug='<ClassName>$'` and parse the stdout
+ * into per-stack-fingerprint aggregated chains. Failure is non-fatal:
+ * returns an empty array so the cycle-side path still completes.
+ *
+ * leaks(1) `--debug=` predicate rejects `^` (`cannot match the start of
+ * a class name`); only the `$` trailing anchor is supported. The
+ * resulting semantic is "ends with X", which matches AVPlayerItem
+ * exactly but also things like MyAVPlayerItem (rare; intentionally
+ * permissive over over-restrictive). Class-name regex metacharacters
+ * are escaped so substrings like "Player.Item" stay literal.
+ */
+async function captureReferenceTreeChains(path, className, maxResults) {
+    // Escape regex metacharacters in the user-supplied class name so a
+    // substring like "AVPlayerItem" stays literal under leaks's regex
+    // predicate. `^` and `$` aren't escaped (leaks treats them specially).
+    const escaped = className.replace(/[.*+?{}()|[\]\\]/g, "\\$&");
+    const predicate = `${escaped}$`;
+    const result = await runCommand("leaks", ["--debug=stacks", `--debug=${predicate}`, path], { timeoutMs: 5 * 60_000 });
+    if (result.code !== 0 && result.code !== 1)
+        return [];
+    const all = parseLeaksDebugStacks(result.stdout);
+    return all.slice(0, maxResults);
+}
 export async function findRetainers(input) {
-    const { report, resolvedPath } = await runLeaksAndParse(input.path);
-    const { totalMatches, retainers } = findRetainersIn(report, input.className, input.maxResults ?? 10);
-    const suggestedNextCalls = totalMatches > 0
+    const wantReferenceTree = input.includeReferenceTree ?? false;
+    const maxResults = input.maxResults ?? 10;
+    const [{ report, resolvedPath }, referenceTreeChains,] = await Promise.all([
+        runLeaksAndParse(input.path),
+        wantReferenceTree
+            ? captureReferenceTreeChains(input.path, input.className, maxResults)
+            : Promise.resolve([]),
+    ]);
+    const { totalMatches, retainers } = findRetainersIn(report, input.className, maxResults);
+    // Update totalMatches to include reference-tree side if it found instances
+    // the cycle path missed. Instance counts aggregate across the per-stack
+    // chains; cycle matches count each path separately, so we don't double-add.
+    const referenceTreeInstanceTotal = referenceTreeChains.reduce((s, c) => s + c.instanceCount, 0);
+    const effectiveTotal = totalMatches > 0 ? totalMatches : referenceTreeInstanceTotal;
+    const suggestedNextCalls = effectiveTotal > 0
         ? [suggestionGetDefinition({ symbolName: input.className })]
         : [];
-    return {
+    const result = {
         ok: true,
         path: resolvedPath,
         className: input.className,
-        totalMatches,
+        totalMatches: effectiveTotal,
         retainers,
         ...(suggestedNextCalls.length > 0 ? { suggestedNextCalls } : {}),
     };
+    if (referenceTreeChains.length > 0) {
+        result.referenceTreeChains = referenceTreeChains;
+    }
+    return result;
 }
 //# sourceMappingURL=findRetainers.js.map

package/dist/tools/findRetainers.js.map

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

package/dist/tools/inspectTrace.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `inspectTrace`: orientation tool for `.trace` bundles. Lists which
+ * schemas are present, how many rows each carries, the time range, the
+ * device model, the template name, and a pre-baked `suggestedNextCalls`
+ * pointing at the matching analyzer for each populated schema.
+ *
+ * The use case is "I have a .trace, what's worth looking at?". Without
+ * this tool the caller has to either pick an `analyze*` blindly or
+ * read the full xctrace export which is wasteful. The MCP-native
+ * agent loop benefits the most: discovery costs 1 call instead of 5.
+ *
+ * Implementation notes:
+ *
+ * - Single `xctrace export --xpath '/trace-toc/run'` invocation. Returns
+ *   the run metadata + all table schemas in one shot. We parse just enough
+ *   to enumerate schemas + count rows; we deliberately do NOT parse row
+ *   contents (the downstream `analyze*` tools do that).
+ *
+ * - Time range: derived from the schema-level `start-time` / `end-time`
+ *   attributes when present; falls back to the run's `<recorded-when>`
+ *   timestamp string when not parseable.
+ *
+ * - The 5 known schemas (potential-hangs, animation-hitches, time-profile,
+ *   allocations, app-launch) map 1:1 to the existing analyzers. Any
+ *   schema NOT in that map is still surfaced in the `schemas[]` list (so
+ *   the user sees it) but does not contribute a `suggestedNextCalls`
+ *   entry — there's no analyzer to chain into.
+ */
+import { z } from "zod";
+import type { NextCallSuggestion } from "../types.js";
+export declare const inspectTraceSchema: z.ZodObject<{
+    tracePath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    tracePath: string;
+}, {
+    tracePath: string;
+}>;
+export type InspectTraceInput = z.infer<typeof inspectTraceSchema>;
+export interface TraceSchemaSummary {
+    /** Schema name (e.g. "potential-hangs", "time-profile"). */
+    name: string;
+    /** Number of rows in this schema's table. 0 means the schema is present in the trace but carries no data. */
+    rowCount: number;
+    /** Engineering description when the schema declares one; absent otherwise. */
+    description?: string;
+}
+export interface InspectTraceResult {
+    ok: boolean;
+    tracePath: string;
+    /** All schemas present in the trace TOC, ranked by rowCount desc. */
+    schemas: TraceSchemaSummary[];
+    /** Convenience: schemaName -> rowCount, same data as `schemas[]` in object form. */
+    rowCounts: Record<string, number>;
+    /** Trace file size in bytes (the .trace bundle is a directory; reports the directory entry size, not recursive). */
+    fileSize?: number;
+    /** Device model name when the trace's run metadata exposes one. */
+    deviceModel?: string;
+    /** OS version when present. */
+    osVersion?: string;
+    /** Template name (e.g. "Time Profiler", "Allocations"). */
+    templateName?: string;
+    /** Recording timestamp string (raw, unparsed). */
+    recordedWhen?: string;
+    /** Plain-English orientation diagnosis. */
+    diagnosis: string;
+    /** Pipeline hints based on which analyzers have data to chain into. */
+    suggestedNextCalls: NextCallSuggestion[];
+}
+/** Pure: parse the trace-toc XML payload into an inspection result. */
+export declare function parseTraceToc(xml: string, tracePath: string): Omit<InspectTraceResult, "ok" | "fileSize">;
+export declare function inspectTrace(input: InspectTraceInput): Promise<InspectTraceResult>;
+export declare function _basenameForTests(p: string): string;

package/dist/tools/inspectTrace.js

@@ -0,0 +1,181 @@
+/**
+ * `inspectTrace`: orientation tool for `.trace` bundles. Lists which
+ * schemas are present, how many rows each carries, the time range, the
+ * device model, the template name, and a pre-baked `suggestedNextCalls`
+ * pointing at the matching analyzer for each populated schema.
+ *
+ * The use case is "I have a .trace, what's worth looking at?". Without
+ * this tool the caller has to either pick an `analyze*` blindly or
+ * read the full xctrace export which is wasteful. The MCP-native
+ * agent loop benefits the most: discovery costs 1 call instead of 5.
+ *
+ * Implementation notes:
+ *
+ * - Single `xctrace export --xpath '/trace-toc/run'` invocation. Returns
+ *   the run metadata + all table schemas in one shot. We parse just enough
+ *   to enumerate schemas + count rows; we deliberately do NOT parse row
+ *   contents (the downstream `analyze*` tools do that).
+ *
+ * - Time range: derived from the schema-level `start-time` / `end-time`
+ *   attributes when present; falls back to the run's `<recorded-when>`
+ *   timestamp string when not parseable.
+ *
+ * - The 5 known schemas (potential-hangs, animation-hitches, time-profile,
+ *   allocations, app-launch) map 1:1 to the existing analyzers. Any
+ *   schema NOT in that map is still surfaced in the `schemas[]` list (so
+ *   the user sees it) but does not contribute a `suggestedNextCalls`
+ *   entry — there's no analyzer to chain into.
+ */
+import { z } from "zod";
+import { existsSync } from "node:fs";
+import { resolve as resolvePath, basename } from "node:path";
+import { statSync } from "node:fs";
+import { runCommand } from "../runtime/exec.js";
+export const inspectTraceSchema = z.object({
+    tracePath: z
+        .string()
+        .min(1)
+        .describe("Absolute path to a `.trace` bundle (output of `xcrun xctrace record` or Instruments)."),
+});
+/**
+ * Map from xctrace schema name to the analyzer that consumes it. Drives
+ * `suggestedNextCalls[]` so the agent doesn't have to know the mapping.
+ */
+const SCHEMA_TO_ANALYZER = {
+    "potential-hangs": {
+        tool: "analyzeHangs",
+        description: "Parses the hangs table and returns Hang vs Microhang counts plus the longest events. Pair with `topFramesByHangStartNs` to classify main-thread violations.",
+    },
+    "animation-hitches": {
+        tool: "analyzeAnimationHitches",
+        description: "Parses the hitches table and reports by-type counts plus the count of user-perceptible (>100ms) hitches.",
+    },
+    "time-profile": {
+        tool: "analyzeTimeProfile",
+        description: "Returns top symbols by sample count. Reports a structured workaroundNotice when xctrace SIGSEGVs on heavy unsymbolicated traces.",
+    },
+    allocations: {
+        tool: "analyzeAllocations",
+        description: "Returns per-category aggregates (cumulative bytes, allocation count, transient/persistent/mixed lifecycle classification) plus top allocators.",
+    },
+    "app-launch": {
+        tool: "analyzeAppLaunch",
+        description: "Returns cold/warm launch type plus per-phase breakdown (process-creation, dyld-init, ObjC-init, AppDelegate, first-frame).",
+    },
+};
+/** Pure: parse the trace-toc XML payload into an inspection result. */
+export function parseTraceToc(xml, tracePath) {
+    const schemas = [];
+    // We use lightweight regex parsing here instead of fast-xml-parser
+    // because the TOC XML is simple, well-defined, and the existing
+    // parseXctraceXml is row-content focused (parses through schemas).
+    // Surfacing only schema metadata + row counts is faster and avoids
+    // pulling row payloads into memory for traces that have hundreds of
+    // thousands of rows.
+    // Match each <table schema="X"> block.
+    const tableRegex = /<table\b[^>]*\bschema="([^"]+)"[^>]*>([\s\S]*?)<\/table>/g;
+    let match;
+    while ((match = tableRegex.exec(xml)) !== null) {
+        const name = match[1];
+        const body = match[2];
+        // Row count = number of <row> tags inside this table.
+        const rowMatches = body.match(/<row\b/g);
+        const rowCount = rowMatches ? rowMatches.length : 0;
+        // Description: schema may carry an `engineering-type` description.
+        const descMatch = /<engineering-description>([^<]+)<\/engineering-description>/.exec(body);
+        const description = descMatch?.[1]?.trim();
+        schemas.push({
+            name,
+            rowCount,
+            ...(description ? { description } : {}),
+        });
+    }
+    schemas.sort((a, b) => b.rowCount - a.rowCount);
+    const rowCounts = {};
+    for (const s of schemas)
+        rowCounts[s.name] = s.rowCount;
+    // Run-level metadata extracted from the TOC's <run> attributes / children.
+    const deviceMatch = /<device-model>([^<]+)<\/device-model>/.exec(xml);
+    const osMatch = /<os-version>([^<]+)<\/os-version>/.exec(xml);
+    const templateMatch = /<template-name>([^<]+)<\/template-name>/.exec(xml);
+    const recordedMatch = /<recorded-when>([^<]+)<\/recorded-when>/.exec(xml);
+    const suggestedNextCalls = [];
+    for (const s of schemas) {
+        if (s.rowCount === 0)
+            continue;
+        const mapping = SCHEMA_TO_ANALYZER[s.name];
+        if (!mapping)
+            continue;
+        suggestedNextCalls.push({
+            tool: mapping.tool,
+            args: { tracePath },
+            why: `${s.rowCount.toLocaleString()} rows in the ${s.name} schema. ${mapping.description}`,
+        });
+    }
+    return {
+        tracePath,
+        schemas,
+        rowCounts,
+        ...(deviceMatch ? { deviceModel: deviceMatch[1].trim() } : {}),
+        ...(osMatch ? { osVersion: osMatch[1].trim() } : {}),
+        ...(templateMatch ? { templateName: templateMatch[1].trim() } : {}),
+        ...(recordedMatch ? { recordedWhen: recordedMatch[1].trim() } : {}),
+        diagnosis: buildDiagnosis(schemas, templateMatch?.[1]?.trim()),
+        suggestedNextCalls,
+    };
+}
+function buildDiagnosis(schemas, templateName) {
+    if (schemas.length === 0) {
+        return "Trace TOC reports no schemas. The trace may be malformed, empty, or recorded with a custom template the parser does not recognize. Inspect via Instruments.app to confirm.";
+    }
+    const populated = schemas.filter((s) => s.rowCount > 0);
+    const topSchema = populated[0];
+    const parts = [];
+    if (templateName)
+        parts.push(`Template: \`${templateName}\`.`);
+    parts.push(`${schemas.length} schema${schemas.length === 1 ? "" : "s"} in the TOC, ${populated.length} with data.`);
+    if (topSchema) {
+        parts.push(`Heaviest: \`${topSchema.name}\` with ${topSchema.rowCount.toLocaleString()} rows.`);
+    }
+    if (populated.length === 0) {
+        parts.push("All tables are empty. Trace likely recorded zero events; double-check the recording duration and active template.");
+    }
+    return parts.join(" ");
+}
+export async function inspectTrace(input) {
+    const tracePath = resolvePath(input.tracePath);
+    if (!existsSync(tracePath)) {
+        throw new Error(`Trace bundle not found: ${tracePath}`);
+    }
+    let fileSize;
+    try {
+        fileSize = statSync(tracePath).size;
+    }
+    catch {
+        // The bundle is a directory on macOS; stat reports the directory inode
+        // size, which is fine for orientation. Failures are non-fatal.
+    }
+    const result = await runCommand("xcrun", ["xctrace", "export", "--input", tracePath, "--xpath", "/trace-toc/run"], { timeoutMs: 60_000 });
+    if (result.code !== 0) {
+        // Fallback: when the targeted xpath fails (older xctrace versions, or
+        // a trace with no /run node), try the broader /trace-toc xpath and
+        // parse whatever schemas surface.
+        const fallback = await runCommand("xcrun", ["xctrace", "export", "--input", tracePath, "--xpath", "/trace-toc"], { timeoutMs: 60_000 });
+        if (fallback.code !== 0) {
+            throw new Error(`xctrace export TOC failed (code ${result.code}): ${result.stderr || result.stdout || "<no output>"}`);
+        }
+        const parsed = parseTraceToc(fallback.stdout, tracePath);
+        return { ok: true, ...parsed, ...(fileSize != null ? { fileSize } : {}) };
+    }
+    const parsed = parseTraceToc(result.stdout, tracePath);
+    return {
+        ok: true,
+        ...parsed,
+        ...(fileSize != null ? { fileSize } : {}),
+    };
+}
+// Used by tests to verify the bundle name surfaces correctly.
+export function _basenameForTests(p) {
+    return basename(p);
+}
+//# sourceMappingURL=inspectTrace.js.map

package/dist/tools/inspectTrace.js.map

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