memorydetective 1.13.0 → 1.15.0

package/dist/tools/analyzeNetworkActivity.js

@@ -0,0 +1,312 @@
+/**
+ * `analyzeNetworkActivity`: parses xctrace's network-connections schema
+ * from a `.trace` recorded with the Network Profile template. v1.14 item A.
+ *
+ * "The network is slow" / "my SDK is chatty" / "slow launch because of
+ * one API call" are top-3 iOS perf complaints. Pre-v1.14 we had zero
+ * coverage of the network family. XcodeTraceMCP's regex map listed it
+ * as one of their five instrument families. This analyzer closes the
+ * gap with the same shape as analyzeHangs / analyzeAnimationHitches:
+ *
+ * - Bytes-in/out, duration, status-code, and URL/host extracted per
+ *   connection.
+ * - Aggregates: total bytes, slowest response, average response, count
+ *   per HTTP status bucket.
+ * - Top-N by duration (the "which calls blocked the user?" view) and
+ *   top-N by bytes (the "which calls are bloating my budget?" view).
+ * - Per-host aggregates surfacing chatty SDKs without manually grouping.
+ *
+ * Resilient to column-name drift across xctrace versions: each field
+ * is looked up under multiple plausible mnemonics, falling back to the
+ * one that yields data.
+ */
+import { z } from "zod";
+import { existsSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { runCommand } from "../runtime/exec.js";
+import { fetchDiscoveredSchemas } from "../parsers/schemaDiscovery.js";
+import { parseXctraceXml, asNumber, asFormatted, } from "../parsers/xctraceXml.js";
+import { outputFormatField } from "../runtime/responseFormatter.js";
+export const analyzeNetworkActivitySchema = z.object({
+    tracePath: z
+        .string()
+        .min(1)
+        .describe("Absolute path to a `.trace` bundle recorded with a Network template (`xcrun xctrace record --template 'Network Profile' --attach <app|pid>`)."),
+    topN: z
+        .number()
+        .int()
+        .positive()
+        .default(10)
+        .describe("Return the top N rows for each ranking dimension (by-duration + by-bytes). Default 10."),
+    minBytes: z
+        .number()
+        .nonnegative()
+        .default(0)
+        .describe("Filter out connections that transferred fewer than this many bytes (in + out combined). Useful for cutting tiny pings out of the by-bytes view."),
+    outputFormat: outputFormatField,
+});
+/**
+ * Helper: pull a string field from a row trying multiple plausible
+ * column names. xctrace varies network column mnemonics across iOS
+ * versions and templates; we try them all rather than failing on a
+ * single canonical name.
+ */
+function pickString(row, keys) {
+    for (const k of keys) {
+        const v = asFormatted(row[k]);
+        if (v && v.trim().length > 0)
+            return v.trim();
+    }
+    return undefined;
+}
+/** Same idea as pickString but for numeric fields. */
+function pickNumber(row, keys) {
+    for (const k of keys) {
+        const v = asNumber(row[k]);
+        if (typeof v === "number" && Number.isFinite(v))
+            return v;
+    }
+    return undefined;
+}
+/** Extract a host string from a URL-or-host value. Falls back to the
+ *  raw input when it does not look like a URL (already a host). */
+export function extractHost(urlOrHost) {
+    if (!urlOrHost)
+        return undefined;
+    // Strip scheme + path. Accepts http://host:port/path, host:port/path, bare host.
+    const stripped = urlOrHost
+        .replace(/^https?:\/\//i, "")
+        .replace(/^.*?:\/\//, "");
+    const slash = stripped.indexOf("/");
+    const hostPort = slash >= 0 ? stripped.slice(0, slash) : stripped;
+    // Drop the trailing :port for cleaner aggregation.
+    const colon = hostPort.indexOf(":");
+    return colon >= 0 ? hostPort.slice(0, colon) : hostPort;
+}
+function statusBucket(code) {
+    if (code == null)
+        return "n/a";
+    if (code >= 200 && code < 300)
+        return "2xx";
+    if (code >= 300 && code < 400)
+        return "3xx";
+    if (code >= 400 && code < 500)
+        return "4xx";
+    if (code >= 500 && code < 600)
+        return "5xx";
+    return "other";
+}
+/** Pure: turn the network-connections XML into the analyzed result. */
+export function analyzeNetworkActivityFromXml(xml, tracePath, topN = 10, minBytes = 0) {
+    const tables = parseXctraceXml(xml);
+    // The Network template historically uses "network-connections"; some
+    // older builds use plain "network". Both are covered by SCHEMA_FAMILIES
+    // network -> the discovered schema name was passed by the caller, but
+    // the table here may carry either canonical name when synthetic
+    // fixtures are in play. Accept whichever matches.
+    const table = tables.find((t) => /network/i.test(t.schema) || /connection/i.test(t.schema) || /^http/i.test(t.schema));
+    if (!table) {
+        return {
+            ok: true,
+            tracePath,
+            totals: {
+                rows: 0,
+                totalBytesIn: 0,
+                totalBytesOut: 0,
+                longestMs: 0,
+                averageMs: 0,
+                statusBuckets: {},
+            },
+            topByDuration: [],
+            topByBytes: [],
+            byHost: [],
+            diagnosis: "No network-connections table found in the trace.",
+            status: "not_present",
+            supportStatus: [
+                {
+                    kind: "network-connections",
+                    status: "not_present",
+                    reason: "Schema absent from the trace TOC.",
+                },
+            ],
+        };
+    }
+    const entries = [];
+    for (const row of table.rows) {
+        const startNs = pickNumber(row, ["start", "time", "connect-time", "event-time"]) ?? 0;
+        const durationNs = pickNumber(row, [
+            "duration",
+            "response-time",
+            "transaction-duration",
+            "elapsed",
+        ]);
+        const url = pickString(row, ["url", "host", "endpoint", "connect-event-host", "request-url"]);
+        const method = pickString(row, ["method", "http-method", "request-method"]);
+        const statusCode = pickNumber(row, [
+            "status-code",
+            "http-status",
+            "response-code",
+            "status",
+        ]);
+        const bytesIn = pickNumber(row, [
+            "bytes-in",
+            "response-bytes",
+            "received-bytes",
+            "bytes-received",
+            "rx-bytes",
+        ]);
+        const bytesOut = pickNumber(row, [
+            "bytes-out",
+            "request-bytes",
+            "sent-bytes",
+            "bytes-sent",
+            "tx-bytes",
+        ]);
+        const totalBytes = (bytesIn ?? 0) + (bytesOut ?? 0);
+        if (totalBytes < minBytes)
+            continue;
+        entries.push({
+            startNs,
+            ...(asFormatted(row.start) ? { startFmt: asFormatted(row.start) } : {}),
+            ...(durationNs != null ? { durationNs, durationMs: durationNs / 1_000_000 } : {}),
+            ...(asFormatted(row.duration) ? { durationFmt: asFormatted(row.duration) } : {}),
+            ...(url ? { url, host: extractHost(url) } : {}),
+            ...(method ? { method } : {}),
+            ...(statusCode != null ? { statusCode } : {}),
+            ...(bytesIn != null ? { bytesIn } : {}),
+            ...(bytesOut != null ? { bytesOut } : {}),
+        });
+    }
+    const totalBytesIn = entries.reduce((s, e) => s + (e.bytesIn ?? 0), 0);
+    const totalBytesOut = entries.reduce((s, e) => s + (e.bytesOut ?? 0), 0);
+    const durations = entries
+        .map((e) => e.durationMs ?? 0)
+        .filter((d) => d > 0);
+    const longestMs = durations.length > 0 ? Math.max(...durations) : 0;
+    const averageMs = durations.length > 0
+        ? durations.reduce((a, b) => a + b, 0) / durations.length
+        : 0;
+    const statusBuckets = {};
+    for (const e of entries) {
+        const bucket = statusBucket(e.statusCode);
+        statusBuckets[bucket] = (statusBuckets[bucket] ?? 0) + 1;
+    }
+    const topByDuration = [...entries]
+        .sort((a, b) => (b.durationMs ?? 0) - (a.durationMs ?? 0))
+        .slice(0, topN);
+    const topByBytes = [...entries]
+        .sort((a, b) => (b.bytesIn ?? 0) + (b.bytesOut ?? 0) - ((a.bytesIn ?? 0) + (a.bytesOut ?? 0)))
+        .slice(0, topN);
+    const hostMap = new Map();
+    for (const e of entries) {
+        if (!e.host)
+            continue;
+        const cur = hostMap.get(e.host) ?? {
+            host: e.host,
+            count: 0,
+            bytesIn: 0,
+            bytesOut: 0,
+            longestMs: 0,
+        };
+        cur.count += 1;
+        cur.bytesIn += e.bytesIn ?? 0;
+        cur.bytesOut += e.bytesOut ?? 0;
+        if (e.durationMs != null && e.durationMs > cur.longestMs) {
+            cur.longestMs = e.durationMs;
+        }
+        hostMap.set(e.host, cur);
+    }
+    const byHost = Array.from(hostMap.values()).sort((a, b) => b.count - a.count);
+    return {
+        ok: true,
+        tracePath,
+        totals: {
+            rows: entries.length,
+            totalBytesIn,
+            totalBytesOut,
+            longestMs,
+            averageMs,
+            statusBuckets,
+        },
+        topByDuration,
+        topByBytes,
+        byHost,
+        diagnosis: buildDiagnosis(entries.length, longestMs, totalBytesIn, totalBytesOut, byHost),
+        status: "available",
+        supportStatus: [
+            {
+                kind: "network-connections",
+                status: "available",
+                sourceSchemas: ["network-connections"],
+            },
+        ],
+    };
+}
+function buildDiagnosis(rows, longestMs, totalBytesIn, totalBytesOut, byHost) {
+    if (rows === 0) {
+        return "No network activity in the recording window (or all rows were filtered out by minBytes).";
+    }
+    const parts = [];
+    parts.push(`${rows} network requests captured.`);
+    const totalKB = (totalBytesIn + totalBytesOut) / 1024;
+    if (totalKB >= 1) {
+        parts.push(`${totalKB.toFixed(1)} KB total (${(totalBytesIn / 1024).toFixed(1)} KB in, ${(totalBytesOut / 1024).toFixed(1)} KB out).`);
+    }
+    if (longestMs > 0) {
+        parts.push(`Slowest: ${longestMs.toFixed(0)}ms.`);
+    }
+    if (byHost.length > 0) {
+        const top = byHost[0];
+        parts.push(`Chattiest host: \`${top.host}\` (${top.count} requests).`);
+    }
+    if (longestMs > 3000) {
+        parts.push("At least one request over 3s. Likely the user-visible perf gap.");
+    }
+    return parts.join(" ");
+}
+export async function analyzeNetworkActivity(input) {
+    const tracePath = resolvePath(input.tracePath);
+    if (!existsSync(tracePath)) {
+        throw new Error(`Trace bundle not found: ${tracePath}`);
+    }
+    const { network: schemaName } = await fetchDiscoveredSchemas(runCommand, tracePath, ["network"]);
+    const result = await runCommand("xcrun", [
+        "xctrace",
+        "export",
+        "--input",
+        tracePath,
+        "--xpath",
+        `/trace-toc/run/data/table[@schema="${schemaName}"]`,
+    ], { timeoutMs: 5 * 60_000 });
+    if (result.code !== 0) {
+        // Schema may simply not be present in this trace (e.g. Time Profiler
+        // template without Network instrument). Surface as "not_present"
+        // rather than throwing so summarizeTrace can branch on status.
+        return {
+            ok: true,
+            tracePath,
+            totals: {
+                rows: 0,
+                totalBytesIn: 0,
+                totalBytesOut: 0,
+                longestMs: 0,
+                averageMs: 0,
+                statusBuckets: {},
+            },
+            topByDuration: [],
+            topByBytes: [],
+            byHost: [],
+            diagnosis: "Network schema not exportable from this trace (likely recorded with a non-Network template).",
+            status: "not_present",
+            supportStatus: [
+                {
+                    kind: "network-connections",
+                    status: "not_exportable",
+                    reason: "xctrace export failed; likely recorded with a non-Network template.",
+                },
+            ],
+        };
+    }
+    return analyzeNetworkActivityFromXml(result.stdout, tracePath, input.topN ?? 10, input.minBytes ?? 0);
+}
+//# sourceMappingURL=analyzeNetworkActivity.js.map

package/dist/tools/analyzeNetworkActivity.js.map

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

package/dist/tools/analyzeTimeProfile.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { DataStatus } from "../types.js";
+import type { DataStatus, SupportStatus } from "../types.js";
 export declare const analyzeTimeProfileSchema: z.ZodObject<{
     tracePath: z.ZodString;
     topN: z.ZodDefault<z.ZodNumber>;
@@ -19,6 +19,8 @@ export interface SampleEntry {
     weightFmt?: string;
     threadName?: string;
     symbol?: string;
+    /** Binary name for the leaf frame (e.g. "CoreFoundation", "libsystem_kernel.dylib"). Useful when the symbol is an unsymbolicated hex address. */
+    binary?: string;
 }
 export interface AnalyzeTimeProfileResult {
     ok: boolean;
@@ -34,6 +36,9 @@ export interface AnalyzeTimeProfileResult {
     /**
      * Optional notice explaining a known limitation
      * (e.g. xctrace crashed exporting the time-profile schema).
+     *
+     * @deprecated v1.14 item I. The same information now flows through
+     * `supportStatus[0].reason`. Kept for backwards compat.
      */
     notice?: string;
     diagnosis: string;
@@ -41,8 +46,12 @@ export interface AnalyzeTimeProfileResult {
      * Disambiguates empty arrays into "no data in the trace" vs "trace
      * could not be exported" vs "data was exported partially". Agents
      * should branch on this rather than `totalSamples === 0`.
+     *
+     * @deprecated v1.14 item I. Use `supportStatus[]` instead.
      */
     status: DataStatus;
+    /** v1.14+. Unified per-area status. See {@link SupportStatus}. */
+    supportStatus: SupportStatus[];
 }
 /**
  * Pure analysis from a chunk of xctrace XML. Aggregates sample counts per

package/dist/tools/analyzeTimeProfile.js

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { existsSync } from "node:fs";
 import { resolve as resolvePath } from "node:path";
 import { runCommand } from "../runtime/exec.js";
+import { fetchDiscoveredSchemas } from "../parsers/schemaDiscovery.js";
 import { parseXctraceXml, asNumber, asFormatted, } from "../parsers/xctraceXml.js";
 import { outputFormatField } from "../runtime/responseFormatter.js";
 export const analyzeTimeProfileSchema = z.object({
@@ -33,6 +34,13 @@ export function analyzeTimeProfileFromXml(xml, tracePath, topN = 20) {
             topRows: [],
             diagnosis: "No time-profile table found in the export.",
             status: "not_present",
+            supportStatus: [
+                {
+                    kind: "time-profile",
+                    status: "not_present",
+                    reason: "Schema absent from the trace TOC.",
+                },
+            ],
         };
     }
     const rows = [];
@@ -40,14 +48,33 @@ export function analyzeTimeProfileFromXml(xml, tracePath, topN = 20) {
     for (const row of tp.rows) {
         const weight = asNumber(row.weight);
         const weightFmt = asFormatted(row.weight);
-        // Symbol may live under 'backtrace' or 'symbol' or as a nested cell.
-        const symbol = asFormatted(row.symbol) ??
-            asFormatted(row["weight"]) ??
-            row.backtrace?.fmt ??
-            row.backtrace?.raw ??
-            undefined;
+        // xctrace's time-profile schema names the backtrace column `stack`
+        // (mnemonic), with the underlying engineering-type `backtrace`. The
+        // parser keys cells by mnemonic, so the cell is at `row.stack`.
+        //
+        // The leaf frame's @_name attribute is the symbol when it could be
+        // resolved (e.g. `_CFRunLoopRunSpecificWithOptions`) or a raw hex
+        // address when unsymbolicated. In the unsymbolicated case we keep
+        // the binary name (e.g. `libsystem_kernel.dylib`) so aggregations
+        // still cluster by library instead of every sample being a unique
+        // address. Pre-2026-05-15 the parser only read `@_fmt` so this whole
+        // metadata was invisible and `topSymbols` was just the weight column
+        // text repeating "1.00 ms" for every sample.
+        const leafFrame = row.stack?.nested?.frame;
+        const binary = leafFrame?.nested?.binary?.name;
+        const frameName = leafFrame?.name;
+        // Real Apple traces expose the symbol on the leaf frame's @_name; some
+        // synthetic test fixtures use a dedicated <symbol> column instead. Try
+        // the stack first, fall back to the dedicated column.
+        const symbol = pickSymbol(frameName, binary) ?? asFormatted(row.symbol) ?? undefined;
         const threadName = row.thread?.fmt ?? undefined;
-        rows.push({ weight, weightFmt, symbol, threadName });
+        rows.push({
+            weight,
+            weightFmt,
+            ...(symbol ? { symbol } : {}),
+            ...(binary ? { binary } : {}),
+            ...(threadName ? { threadName } : {}),
+        });
         if (symbol) {
             symbolCounts.set(symbol, (symbolCounts.get(symbol) ?? 0) + 1);
         }
@@ -69,8 +96,27 @@ export function analyzeTimeProfileFromXml(xml, tracePath, topN = 20) {
             ? "No samples found in the time-profile table."
             : `${rows.length} samples; top symbol: ${topSymbols[0]?.symbol ?? "unknown"} (${topSymbols[0]?.samples ?? 0} samples).`,
         status: "available",
+        supportStatus: [
+            {
+                kind: "time-profile",
+                status: "available",
+                sourceSchemas: ["time-profile"],
+            },
+        ],
     };
 }
+/**
+ * Pick the most useful identifier for a sample given the leaf frame name +
+ * binary. Resolved symbol wins; otherwise we cluster by binary so the
+ * aggregation is still meaningful for unsymbolicated traces.
+ */
+function pickSymbol(frameName, binary) {
+    if (frameName && !/^0x[0-9a-f]+$/i.test(frameName))
+        return frameName;
+    if (binary)
+        return frameName ? `${binary} (${frameName})` : binary;
+    return frameName;
+}
 const SIGSEGV_NOTICE = `xctrace crashed exporting the time-profile schema (SIGSEGV). This is a known issue with heavy time-profile data and unsymbolicated traces.
 
 Workarounds:
@@ -82,13 +128,14 @@ export async function analyzeTimeProfile(input) {
     if (!existsSync(tracePath)) {
         throw new Error(`Trace bundle not found: ${tracePath}`);
     }
+    const { "time-profile": schemaName } = await fetchDiscoveredSchemas(runCommand, tracePath, ["time-profile"]);
     const result = await runCommand("xcrun", [
         "xctrace",
         "export",
         "--input",
         tracePath,
         "--xpath",
-        '/trace-toc/run/data/table[@schema="time-profile"]',
+        `/trace-toc/run/data/table[@schema="${schemaName}"]`,
     ], { timeoutMs: 5 * 60_000 });
     if (result.code !== 0) {
         // SIGSEGV typically reports as 139 (128 + 11). Surface a useful message.
@@ -102,6 +149,14 @@ export async function analyzeTimeProfile(input) {
                 notice: SIGSEGV_NOTICE,
                 diagnosis: "Could not export time-profile schema (xctrace crashed). See `notice` for workarounds.",
                 status: "not_exportable",
+                supportStatus: [
+                    {
+                        kind: "time-profile",
+                        status: "not_exportable",
+                        reason: SIGSEGV_NOTICE,
+                        sourceSchemas: ["time-profile"],
+                    },
+                ],
             };
         }
         throw new Error(`xctrace export failed (code ${result.code}): ${result.stderr || result.stdout}`);

package/dist/tools/analyzeTimeProfile.js.map

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

package/dist/tools/countAlive.d.ts

@@ -5,16 +5,19 @@ export declare const countAliveSchema: z.ZodObject<{
     className: z.ZodOptional<z.ZodString>;
     topN: z.ZodDefault<z.ZodNumber>;
     includeReferenceTree: z.ZodDefault<z.ZodBoolean>;
+    sortBy: z.ZodDefault<z.ZodEnum<["count", "totalBytes"]>>;
 }, "strip", z.ZodTypeAny, {
     path: string;
     topN: number;
     includeReferenceTree: boolean;
+    sortBy: "count" | "totalBytes";
     className?: string | undefined;
 }, {
     path: string;
     className?: string | undefined;
     topN?: number | undefined;
     includeReferenceTree?: boolean | undefined;
+    sortBy?: "count" | "totalBytes" | undefined;
 }>;
 export type CountAliveInput = z.infer<typeof countAliveSchema>;
 export interface CountAliveEntry {
@@ -24,6 +27,22 @@ export interface CountAliveEntry {
     byCycle?: number;
     /** When `includeReferenceTree: true`, the reference-tree contribution. Often the only non-zero side on `leakCount: 0` memgraphs. */
     byReferenceTree?: number;
+    /**
+     * v1.14+. Per-instance size in bytes derived from the memgraph. For
+     * fixed-size ObjC classes every instance has the same size; for
+     * variable-size classes (NSData with payload, etc.) this is an average
+     * (totalBytes / instanceCount, rounded). Absent when neither the
+     * cycle-side `[N]` annotation nor the reference-tree parens-size
+     * carried a number (rare).
+     */
+    instanceSizeBytes?: number;
+    /**
+     * v1.14+. Total bytes attributed to this class: sum of per-instance
+     * sizes from the cycle forest plus the reference-tree totals. FLEX
+     * surfaces this as the "Size" sort column in its Live Objects view.
+     * Useful for "where is my memory going?" investigations.
+     */
+    totalBytes?: number;
 }
 export interface CountAliveResult {
     ok: boolean;
@@ -41,6 +60,21 @@ export interface CountAliveResult {
      */
     actionableCounts?: CountAliveEntry[];
 }
-/** Pure: count node occurrences by exact className across the cycle forest. */
+/** Pure: count node occurrences by exact className across the cycle forest.
+ *  Backwards-compatible API; for v1.14 byte aggregation use
+ *  {@link countByClassWithBytes}. */
 export declare function countByClass(report: LeaksReport): Map<string, number>;
+/**
+ * Pure: aggregate occurrences AND bytes by exact className across the
+ * cycle forest. Each node's `instanceSize` is summed into `totalBytes`;
+ * the first non-zero `instanceSize` seen is recorded as the canonical
+ * `instanceSizeBytes` (ObjC classes are typically fixed-size, so the
+ * first value is representative). Nodes without a size annotation
+ * contribute to count but not bytes. v1.14.
+ */
+export declare function countByClassWithBytes(report: LeaksReport): Map<string, {
+    count: number;
+    totalBytes: number;
+    instanceSizeBytes?: number;
+}>;
 export declare function countAlive(input: CountAliveInput): Promise<CountAliveResult>;