memorydetective 1.11.0 → 1.12.0

package/CHANGELOG.md

@@ -6,6 +6,25 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [1.12.0] - 2026-05-14
+
+Four-phase patch completing the v1.10 retro §7.2 propagation (`countAlive`, `findRetainers`, `verifyFix` reference-tree integrations) and internalizing the v1.9 cross-schema correlation (`analyzeHangs` auto-classification). The agent chain `analyzeAbandonedMemory` → `findRetainers` → `countAlive` → `verifyFix` no longer falls off a cliff after the first call.
+
+### Added
+
+- **`countAlive` reference-tree integration.** New `includeReferenceTree: boolean` input flag (default false preserves v1.11 behavior). When true, spawns `leaks --referenceTree --groupByType --noContent` in parallel with the existing cycle pass, merges counts by class name, and surfaces a new `actionableCounts[]` field filtered via `isFrameworkNoise`. For `countAlive({ className: "AVPlayerItem", includeReferenceTree: true })` on the notelet pre-fix memgraph, returns `instanceCount: 685` (substring match captures both AVPlayerItem 342 + AVPlayerItemInternal 343); for the topN path, surfaces AVCMNotificationDispatcher / __NSObserver / AVPlayerItem instead of NSMutableDictionary / CFString noise. New per-class `byCycle` + `byReferenceTree` breakdown fields when the flag is on. 3 new schema validation tests.
+
+- **`verifyFix` abandoned-memory verdict fallback.** v1.11 returned `overallVerdict: "PASS"` with empty `patternResolution[]` on the notelet pair (both `leakCount: 0`); v1.12 chains internally into `analyzeAbandonedMemory` when no cycle patterns fire on either side. New `verdictSource: "cycle-pattern" | "abandoned-memory"`, `freedClasses[]`, `regressionClasses[]` fields. Magnitude-dominance heuristic resolves verdict to PASS / PARTIAL / FAIL by comparing the sum of `|freed delta|` to `|growth delta|` at a 2x ratio. Notelet pair now returns `verdict: PASS` with diagnosis "Fix verified via abandoned-memory shrinkage: 10,386 instances freed dominates the residual 4,531-instance growth (typically Swift runtime / font cache / ObjC class table)." `isFrameworkNoise` extended to flag `N bytes into <X 0xADDR> [size]` heap-offset entries so the magnitude check doesn't get fooled by partial-allocation noise. 1 new reference-tree filter test.
+
+- **`findRetainers` reference-tree chains.** New `includeReferenceTree: boolean` input flag (default false). When true, spawns `leaks --debug=stacks --debug='<className>$'` and parses the per-instance allocation stack output via a new `src/parsers/leaksDebugStacks.ts` parser. Instances sharing the same call-stack fingerprint aggregate into one chain with `instanceCount`. Each chain exposes `callStack[]` (ordered frames from dyld root to allocation site), `retainers[]` (unique retainer classes with aggregate counts), `exampleAddress` (one representative instance), and `userFrame` (the deepest non-system frame, surfacing the actual line a developer would inspect). New 11-test parser file. leaks's `--debug=` predicate restriction documented in the schema description: `^` is rejected by leaks, only trailing `$` works. MallocStackLogging caveat documented: Xcode-exported memgraphs may surface fewer chains than the total instance count because `leaks --debug=stacks` only emits blocks for instances whose allocation stack was recorded.
+
+- **`analyzeHangs` cross-schema correlation.** v1.9 added `mainThreadViolations[]` enrichment via the caller-supplied `topFramesByHangStartNs` map; v1.12 internalizes it. New `includeStackClassification: boolean` input flag (default false preserves v1.9 behavior). When true, exports the `time-profile` schema in parallel with `potential-hangs`, correlates samples to hang windows by timestamp (sample in `[hang.startNs, hang.startNs + hang.durationNs]`), picks the dominant top frame per hang by aggregate weight, and runs `classifyHangFrame()` on it. New pure `correlateTimeProfileToHangs()` helper. Caller-supplied maps still take precedence over the auto-correlation. 8 new pure correlation tests covering empty inputs both sides, in/out-of-window, weight tiebreaker, backtrace fallback, multi-hang independence, default-weight handling.
+
+### Changed
+
+- `package.json` + `server.json`: 1.11.0 → 1.12.0.
+- `compareTracesByPattern` call sites of `analyzeHangs` now pass `includeStackClassification: false` explicitly to satisfy the inferred `analyzeHangs` input type (cosmetic; no behavioral change).
+
 ## [1.11.0] - 2026-05-14
 
 Three-fix patch driven by the v1.10 validation pass on the global npm binary. The v1.10 retro §7 surfaced gaps that v1.11 closes: CLI human-output ignored the new abandoned-memory data, `diffMemgraphs` had the same reference-tree blind spot v1.10 fixed only in `analyzeMemgraph` + `analyzeAbandonedMemory`, and there was no orientation tool for `.trace` bundles.
@@ -429,7 +448,8 @@ When called with no arguments it starts the MCP server over stdio.
 - **`captureMemgraph`** does not work on physical iOS devices — `leaks(1)` only attaches to processes on the local Mac (which includes iOS simulators). Memory Graph capture from a physical device still requires Xcode.
 - **`detectLeaksInXCUITest`** is flagged experimental: orchestration logic is implemented but not yet validated against a wide set of production XCUITest runs.
 
-[Unreleased]: https://github.com/carloshpdoc/memorydetective/compare/v1.11.0...HEAD
+[Unreleased]: https://github.com/carloshpdoc/memorydetective/compare/v1.12.0...HEAD
+[1.12.0]: https://github.com/carloshpdoc/memorydetective/compare/v1.11.0...v1.12.0
 [1.11.0]: https://github.com/carloshpdoc/memorydetective/compare/v1.10.0...v1.11.0
 [1.10.0]: https://github.com/carloshpdoc/memorydetective/compare/v1.9.0...v1.10.0
 [1.9.0]: https://github.com/carloshpdoc/memorydetective/compare/v1.8.1...v1.9.0

package/README.md

@@ -17,9 +17,9 @@
 - **MCP-native.** Plugs into Claude Code, Claude Desktop, Cursor, Cline, and any other MCP client. The agent drives the full investigate → classify → suggest-fix loop without you opening Instruments.
 - **Honest about its limits.** No mocked outputs, no over-promises. Hangs analysis works clean from `xctrace`; sample-level Time Profile is parsed when `xctrace` symbolicates the trace and returns a structured workaround notice when it can't (the underlying `xctrace` SIGSEGV on heavy unsymbolicated traces is an Apple-side limitation we surface explicitly). Memory Graph capture works on Mac apps and iOS simulator; physical iOS devices still need Xcode.
 
-> **What's new in v1.11** (2026-05-14): three-fix patch driven by the v1.10 validation pass. (1) New `inspectTrace` MCP tool: single-call orientation for `.trace` bundles that returns schemas + row counts + device + template + `suggestedNextCalls[]` mapping each populated known schema to its analyzer. Closes the discovery gap vs alternative trace MCPs. (2) `diffMemgraphs` now reads the reference tree alongside the cycle output: new `actionableReferenceTreeChanges[]` field surfaces the AVPlayerItem 342 to 0 delta that v1.10 left invisible to this tool. (3) CLI human-output `analyze` now renders a top-5 abandoned-memory suspects mini-table by default, plus `classify` adds a tip pointing at `analyze` when no cycles fire. Terminal users no longer walk away from real bugs. 487 → 500 tests, 34 → 35 MCP tools.
+> **What's new in v1.12** (2026-05-14): four-phase patch completing the v1.10 retro propagation across the remaining tools that had the reference-tree blind spot. (1) `countAlive({ includeReferenceTree: true })` now surfaces heap-wide instance counts (AVPlayerItem 685 = AVPlayerItem + AVPlayerItemInternal, via the substring match semantic) plus a noise-filtered `actionableCounts[]` view. (2) `verifyFix` chains internally into `analyzeAbandonedMemory` when no cycle patterns fire on either side; the notelet pair now returns `verdict: PASS` with `verdictSource: "abandoned-memory"` and a structured `freedClasses[]` list, instead of `verdict: undefined`. (3) `findRetainers({ includeReferenceTree: true })` parses `leaks --debug=stacks` and returns per-call-stack-fingerprint aggregated chains: the notelet AVPlayerItem case surfaces `MediaNoteItemVideoView.prepareVideo` as the allocation site + `_CFXNotificationRegistrarAddObject` (KVO global registry) as the retainer. (4) `analyzeHangs({ includeStackClassification: true })` now internally exports the time-profile schema alongside potential-hangs and auto-populates `mainThreadViolations[]` without the caller building a `topFramesByHangStartNs` map. 500 → 523 tests.
 >
-> **Also recent**: v1.10 (same day) closed the notelet retro feedback loop with the abandoned-memory parser fixes + classifier guards + `verify-fix-table` output. v1.9 shipped `analyzeAbandonedMemory` + `detectLeaksInXCTest` + `cleanupTraces` + `mainThreadViolations` + security env flags. v1.8 (2026-05-06) shipped the macOS 26.x `task_for_pid` workaround chain + verify-fix loop. Full notes in [CHANGELOG](./CHANGELOG.md).
+> **Also recent**: v1.11 added `inspectTrace`, `diffMemgraphs` reference-tree, and CLI abandoned-memory mini-table. v1.10 closed the notelet retro feedback loop with parser fixes + classifier guards + `verify-fix-table` output. v1.9 shipped `analyzeAbandonedMemory` + `detectLeaksInXCTest` + `cleanupTraces` + `mainThreadViolations` + security env flags. Full notes in [CHANGELOG](./CHANGELOG.md).
 
 > **Heads up for macOS 26.x users:** Apple shipped a `task_for_pid` kernel regression on macOS 26.x that blocks `leaks --outputGraph`, `heap`, AND `xctrace --template Allocations` against iOS simulator processes regardless of `MallocStackLogging`. Even Xcode's "View Memory Graph Hierarchy" hits it unless `Malloc Stack Logging` is enabled in the scheme's Diagnostics tab. memorydetective surfaces this as a proactive `platformAdvisory` on the first capture-class tool call, plus a `workaroundNotice` with `issue: "macos-26-task-for-pid-broken"` if `leaks` is invoked. **The most reliable workaround today is to target an iOS 18 simulator runtime** (install via Xcode > Settings > Platforms > +iOS 18.x). Empirically validated in the [notelet investigation](https://github.com/carloshpdoc/memorydetective/blob/main/CHANGELOG.md#unreleased) 2026-05-12 where three independent CLI memory-introspection paths all failed before iOS 18 was identified as the working escape hatch. Set `MEMORYDETECTIVE_SUPPRESS_PLATFORM_ADVISORY=1` to silence the notice once you have settled on a workaround.
 
@@ -490,7 +490,7 @@ The `tool` subcommand dispatches to any registered MCP tool by name, reading inp
 git clone https://github.com/carloshpdoc/memorydetective
 cd memorydetective
 npm install
-npm test                  # 500 unit tests
+npm test                  # 523 unit tests
 npm run build             # build → dist/
 npm run dev               # tsx, stdio mode (dev mode)
 ./scripts/demo.sh         # full demo against a real .memgraph (set MEMGRAPH=path)
@@ -501,7 +501,7 @@ npm run dev               # tsx, stdio mode (dev mode)
 Contributions are welcome. Bug reports, feature requests, new cycle patterns, all of it.
 
 - **Bugs / feature requests**: [open an issue](https://github.com/carloshpdoc/memorydetective/issues).
-- **PRs**: fork → branch → `npm install` → make changes → `npm test` (500 tests must stay green) → open a PR with a concise description of what changed and why.
+- **PRs**: fork → branch → `npm install` → make changes → `npm test` (523 tests must stay green) → open a PR with a concise description of what changed and why.
 
 ### Adding a cycle pattern to `classifyCycle`
 

package/dist/parsers/leaksDebugStacks.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Parser for `leaks --debug=stacks --debug='<ClassName>$'` output.
+ *
+ * This is the canonical way to get the allocation stack + retainer list for
+ * a specific class without it being part of a strict cycle. The notelet
+ * investigation's `342 to 0 AVPlayerItem` count came from running this
+ * command directly + grepping `_objc_rootAllocWithZone | wc -l`. v1.12
+ * automates the parse + aggregates by call-stack fingerprint so the
+ * response is a small structured list instead of 342 verbose blocks.
+ *
+ * Output shape (per SCANNING block):
+ *
+ * ```text
+ * SCANNING <AVPlayerItem 0xADDR> [size]
+ *     Call stack: 0xADDR (dyld) start | 0xADDR (...) ??? | ...
+ * REFERENCES TO THIS: N   STRONG: X  CONSERVATIVE: Y  WEAK UU etc: Z
+ *    <retainer-class 0xADDR> [size]   +offset: edge-name 0xADDR
+ *    ...
+ * CONTENTS:
+ *    +offset: field-name      0xADDR --> <target-class 0xADDR> [size]
+ *    ...
+ * ```
+ *
+ * Multiple SCANNING blocks (one per instance) are aggregated by
+ * call-stack fingerprint. Identical stacks count as one chain with
+ * `instanceCount: N` instead of N duplicates.
+ */
+export interface AllocationFrame {
+    /** Hex address of the frame, e.g. "0x100e97da4". */
+    address: string;
+    /** Image/binary name in parentheses, e.g. "(dyld)" or "(NoteletDemo.debug.dylib)". */
+    image: string;
+    /** Symbol name when symbolicated, e.g. "_objc_rootAllocWithZone" or "MediaNoteItemVideoView.prepareVideo". `???` when stripped. */
+    symbol: string;
+}
+export interface ReferenceTreeChain {
+    /** How many instances share this exact call-stack fingerprint. */
+    instanceCount: number;
+    /**
+     * Call-stack frames from outer (root, dyld start) to inner (allocation site).
+     * The leaks output emits them in dyld-first order; we preserve that.
+     */
+    callStack: AllocationFrame[];
+    /** A representative instance address for the user to chain into via `leaks <addr>`. */
+    exampleAddress: string;
+    /** Unique retainer classes referenced from THIS instance with how often each appeared across the aggregation group. */
+    retainers: Array<{
+        className: string;
+        count: number;
+    }>;
+    /** The "user-actionable" frame: the deepest frame whose image isn't system (dyld, libobjc, libsystem, libdispatch, SwiftUI core runtime). Surfaces the line a developer would inspect. */
+    userFrame?: AllocationFrame;
+}
+/**
+ * Pure: parse a single `Call stack: ...` line into an ordered list of frames.
+ * Frames are pipe-separated; each frame is `<hex-addr> (<image>) <symbol>`.
+ */
+export declare function parseCallStackLine(line: string): AllocationFrame[];
+/**
+ * Heuristic: pick the user-actionable frame from a call stack. The deepest
+ * (closest to allocation) frame whose image is NOT a system runtime. For
+ * notelet, this resolves to `MediaNoteItemVideoView.prepareVideo` -- the
+ * line in the library that called `AVPlayerItem.init`.
+ */
+export declare function pickUserFrame(frames: AllocationFrame[]): AllocationFrame | undefined;
+/** Pure: parse the full `leaks --debug=stacks` output for a class. */
+export declare function parseLeaksDebugStacks(output: string): ReferenceTreeChain[];

package/dist/parsers/leaksDebugStacks.js

@@ -0,0 +1,187 @@
+/**
+ * Parser for `leaks --debug=stacks --debug='<ClassName>$'` output.
+ *
+ * This is the canonical way to get the allocation stack + retainer list for
+ * a specific class without it being part of a strict cycle. The notelet
+ * investigation's `342 to 0 AVPlayerItem` count came from running this
+ * command directly + grepping `_objc_rootAllocWithZone | wc -l`. v1.12
+ * automates the parse + aggregates by call-stack fingerprint so the
+ * response is a small structured list instead of 342 verbose blocks.
+ *
+ * Output shape (per SCANNING block):
+ *
+ * ```text
+ * SCANNING <AVPlayerItem 0xADDR> [size]
+ *     Call stack: 0xADDR (dyld) start | 0xADDR (...) ??? | ...
+ * REFERENCES TO THIS: N   STRONG: X  CONSERVATIVE: Y  WEAK UU etc: Z
+ *    <retainer-class 0xADDR> [size]   +offset: edge-name 0xADDR
+ *    ...
+ * CONTENTS:
+ *    +offset: field-name      0xADDR --> <target-class 0xADDR> [size]
+ *    ...
+ * ```
+ *
+ * Multiple SCANNING blocks (one per instance) are aggregated by
+ * call-stack fingerprint. Identical stacks count as one chain with
+ * `instanceCount: N` instead of N duplicates.
+ */
+/** Image names we treat as "system runtime" when scanning for the user-actionable frame. */
+const SYSTEM_IMAGES = new Set([
+    "dyld",
+    "dyld_sim",
+    "libobjc.A.dylib",
+    "libsystem_malloc.dylib",
+    "libsystem_pthread.dylib",
+    "libsystem_c.dylib",
+    "libdispatch.dylib",
+    "libswift_Concurrency.dylib",
+    "libswiftCore.dylib",
+    "libswiftFoundation.dylib",
+    "com.apple.Foundation",
+    "com.apple.CoreFoundation",
+    "com.apple.SwiftUI",
+    "com.apple.UIKitCore",
+    "com.apple.GraphicsServices",
+]);
+/**
+ * Pure: parse a single `Call stack: ...` line into an ordered list of frames.
+ * Frames are pipe-separated; each frame is `<hex-addr> (<image>) <symbol>`.
+ */
+export function parseCallStackLine(line) {
+    // Strip the leading "Call stack:" prefix and split by " | " separator.
+    const m = /Call stack:\s*(.*)$/.exec(line.trim());
+    if (!m)
+        return [];
+    const raw = m[1];
+    const frames = [];
+    for (const part of raw.split("|").map((s) => s.trim())) {
+        if (!part)
+            continue;
+        // `0xADDR (image) symbol`
+        const fm = /^(0x[0-9a-fA-F]+)\s*\(([^)]+)\)\s*(.*)$/.exec(part);
+        if (!fm)
+            continue;
+        frames.push({
+            address: fm[1],
+            image: fm[2],
+            symbol: fm[3].trim() || "???",
+        });
+    }
+    return frames;
+}
+/**
+ * Heuristic: pick the user-actionable frame from a call stack. The deepest
+ * (closest to allocation) frame whose image is NOT a system runtime. For
+ * notelet, this resolves to `MediaNoteItemVideoView.prepareVideo` -- the
+ * line in the library that called `AVPlayerItem.init`.
+ */
+export function pickUserFrame(frames) {
+    // Walk from innermost (end of array) to outermost (start) looking for
+    // the first non-system image. Skip frames whose symbol is `???`.
+    for (let i = frames.length - 1; i >= 0; i--) {
+        const f = frames[i];
+        if (SYSTEM_IMAGES.has(f.image))
+            continue;
+        if (f.symbol === "???")
+            continue;
+        return f;
+    }
+    return undefined;
+}
+/**
+ * Fingerprint a call stack for aggregation. Strips addresses (which differ
+ * per instance even when the call site is the same), keeps image + symbol.
+ */
+function fingerprintCallStack(frames) {
+    return frames.map((f) => `${f.image}::${f.symbol}`).join("|");
+}
+/** Pure: parse the full `leaks --debug=stacks` output for a class. */
+export function parseLeaksDebugStacks(output) {
+    const blocks = output.split(/^SCANNING\s+/m).slice(1);
+    const buckets = new Map();
+    for (const block of blocks) {
+        // Block header: `<ClassName 0xADDR> [size]\n` followed by indented lines.
+        const headerMatch = /^<[^>]+\s+(0x[0-9a-fA-F]+)>\s*\[\d+\]/.exec(block);
+        if (!headerMatch)
+            continue;
+        const exampleAddress = headerMatch[1];
+        const lines = block.split(/\r?\n/);
+        let callStack = [];
+        const retainers = new Set();
+        let inRetainerSection = false;
+        let inContentsSection = false;
+        for (const line of lines) {
+            if (line.includes("Call stack:")) {
+                callStack = parseCallStackLine(line);
+                continue;
+            }
+            if (/^REFERENCES TO THIS:/.test(line.trim())) {
+                inRetainerSection = true;
+                inContentsSection = false;
+                continue;
+            }
+            if (/^CONTENTS:/.test(line.trim())) {
+                inRetainerSection = false;
+                inContentsSection = true;
+                continue;
+            }
+            if (inRetainerSection) {
+                // Lines look like:
+                //   `   <retainer-class 0xADDR> [size]   +N: edge 0xADDR`
+                //   `   <NSMutableSet (Storage) 0xADDR> [size]    +N: __strong 0xADDR`
+                // The class name can contain spaces and parens (Foundation storage
+                // variants); capture everything between the leading `<` and the
+                // ` 0xADDR>` suffix. Greedy until the last space-then-hex pattern.
+                const rm = /<\s*(.+?)\s+0x[0-9a-fA-F]+\s*>/.exec(line);
+                if (rm) {
+                    const name = rm[1].trim();
+                    if (name.length > 0)
+                        retainers.add(name);
+                }
+            }
+            // We don't currently capture CONTENTS (outgoing edges). Could be
+            // surfaced later as a separate field if useful.
+            void inContentsSection;
+        }
+        if (callStack.length === 0)
+            continue;
+        const fp = fingerprintCallStack(callStack);
+        const existing = buckets.get(fp);
+        if (existing) {
+            existing.instanceCount += 1;
+            for (const r of retainers) {
+                existing.retainerCounts.set(r, (existing.retainerCounts.get(r) ?? 0) + 1);
+            }
+        }
+        else {
+            const retainerCounts = new Map();
+            for (const r of retainers)
+                retainerCounts.set(r, 1);
+            buckets.set(fp, {
+                instanceCount: 1,
+                callStack,
+                exampleAddress,
+                retainerCounts,
+            });
+        }
+    }
+    const chains = [];
+    for (const b of buckets.values()) {
+        const retainers = Array.from(b.retainerCounts.entries())
+            .map(([className, count]) => ({ className, count }))
+            .sort((x, y) => y.count - x.count);
+        const chain = {
+            instanceCount: b.instanceCount,
+            callStack: b.callStack,
+            exampleAddress: b.exampleAddress,
+            retainers,
+        };
+        const uf = pickUserFrame(b.callStack);
+        if (uf)
+            chain.userFrame = uf;
+        chains.push(chain);
+    }
+    chains.sort((a, b) => b.instanceCount - a.instanceCount);
+    return chains;
+}
+//# sourceMappingURL=leaksDebugStacks.js.map

package/dist/parsers/leaksDebugStacks.js.map

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

package/dist/parsers/referenceTree.js

@@ -267,6 +267,11 @@ export function isFrameworkNoise(className) {
     // missed them, e.g. closures with no class name).
     if (/^<[^>]*0x[0-9a-fA-F]+>/.test(className))
         return true;
+    // "N bytes into <SomeClass 0xADDR> [size]" form. These are heap offsets,
+    // not class instances; they represent partial allocations and scale with
+    // app activity (Swift runtime growing, ObjC class table loading, etc.).
+    if (/^\d+ bytes into\b/.test(className))
+        return true;
     // Foundation observer registry internals (these grow with KVO activity but
     // are not the actionable site; the user's class is what to fix).
     if (className === "CFXNotificationRegistrar")

package/dist/parsers/referenceTree.js.map

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

package/dist/tools/analyzeHangs.d.ts

@@ -15,11 +15,13 @@ export declare const analyzeHangsSchema: z.ZodObject<{
         endMs: number;
     }>>;
     topFramesByHangStartNs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    includeStackClassification: z.ZodDefault<z.ZodBoolean>;
     outputFormat: z.ZodOptional<z.ZodEnum<["markdown", "json", "both", "verify-fix-table"]>>;
 }, "strip", z.ZodTypeAny, {
     tracePath: string;
     topN: number;
     minDurationMs: number;
+    includeStackClassification: boolean;
     outputFormat?: "markdown" | "json" | "both" | "verify-fix-table" | undefined;
     timeRangeMs?: {
         startMs: number;
@@ -36,6 +38,7 @@ export declare const analyzeHangsSchema: z.ZodObject<{
         endMs: number;
     } | undefined;
     topFramesByHangStartNs?: Record<string, string> | undefined;
+    includeStackClassification?: boolean | undefined;
 }>;
 export type AnalyzeHangsInput = z.infer<typeof analyzeHangsSchema>;
 /**
@@ -114,4 +117,29 @@ export declare function analyzeHangsFromXml(xml: string, tracePath: string, topN
     startMs: number;
     endMs: number;
 }, topFramesByHangStartNs?: Readonly<Record<string, string>>): AnalyzeHangsResult;
+/**
+ * Pure: walk parsed time-profile rows + hang entries, correlate samples
+ * to hang windows by timestamp, return a `startNs -> topFrame` map.
+ *
+ * Algorithm: for each hang H with [startNs, startNs+durationNs], find all
+ * samples whose `weight` timestamp falls in that window. Per hang, pick
+ * the top frame by aggregate sample weight (or by sample count if weight
+ * is absent). The result map keys are stringified `startNs` values to
+ * match the existing `topFramesByHangStartNs` shape that v1.9 exposed.
+ *
+ * Returns an empty map when the time-profile rows are absent or none
+ * correlate. Failure modes degrade silently so the cycle-side path
+ * still completes.
+ *
+ * Exposed for testing.
+ */
+export declare function correlateTimeProfileToHangs(hangs: Array<{
+    startNs: number;
+    durationNs: number;
+}>, timeProfileRows: Array<{
+    startNs: number;
+    weight?: number;
+    backtrace?: string;
+    topFrame?: string;
+}>): Record<string, string>;
 export declare function analyzeHangs(input: AnalyzeHangsInput): Promise<AnalyzeHangsResult>;

package/dist/tools/analyzeHangs.js

@@ -30,7 +30,11 @@ export const analyzeHangsSchema = z.object({
     topFramesByHangStartNs: z
         .record(z.string(), z.string())
         .optional()
-        .describe("Optional supplemental map from a hang's `startNs` (as a string) to the top frame seen during that hang. When provided, each matching hang in `top[]` is enriched with `mainThreadViolations[]` that catalog the kind of work happening on the main thread (sync-io, db-lock, network, lock-contention). Typical pipeline: call `analyzeTimeProfile` separately on the same `.trace`, correlate samples to hang windows by timestamp, then re-call `analyzeHangs` with the resulting map. Omit to skip the enrichment."),
+        .describe("Optional supplemental map from a hang's `startNs` (as a string) to the top frame seen during that hang. When provided, each matching hang in `top[]` is enriched with `mainThreadViolations[]` that catalog the kind of work happening on the main thread (sync-io, db-lock, network, lock-contention). Typical pipeline: call `analyzeTimeProfile` separately on the same `.trace`, correlate samples to hang windows by timestamp, then re-call `analyzeHangs` with the resulting map. Omit to skip the enrichment. SUPERSEDED in v1.12 by `includeStackClassification: true`, which builds this map internally."),
+    includeStackClassification: z
+        .boolean()
+        .default(false)
+        .describe("v1.12+. When true, analyzeHangs internally exports the `time-profile` schema in parallel with `potential-hangs`, correlates samples to hang windows by timestamp, picks the dominant top frame per hang, and runs `classifyHangFrame` on it. The `mainThreadViolations[]` field on each top hang is populated automatically. Replaces the v1.9 caller-built `topFramesByHangStartNs` map: most callers should set this flag instead of building the map manually. Adds a second xctrace export call, run in parallel with the hangs export so wall-clock is unchanged when the trace export succeeds. Falls back gracefully (empty violations, no error) when the time-profile schema is absent or xctrace SIGSEGVs on it."),
     outputFormat: outputFormatField,
 });
 const MAIN_THREAD_VIOLATION_SIGNATURES = [
@@ -206,22 +210,145 @@ function buildHangDiagnosis(rows, hangs, microhangs, longestMs, averageMs) {
     }
     return parts.join(" ");
 }
-export async function analyzeHangs(input) {
-    const tracePath = resolvePath(input.tracePath);
-    if (!existsSync(tracePath)) {
-        throw new Error(`Trace bundle not found: ${tracePath}`);
+/**
+ * Pure: walk parsed time-profile rows + hang entries, correlate samples
+ * to hang windows by timestamp, return a `startNs -> topFrame` map.
+ *
+ * Algorithm: for each hang H with [startNs, startNs+durationNs], find all
+ * samples whose `weight` timestamp falls in that window. Per hang, pick
+ * the top frame by aggregate sample weight (or by sample count if weight
+ * is absent). The result map keys are stringified `startNs` values to
+ * match the existing `topFramesByHangStartNs` shape that v1.9 exposed.
+ *
+ * Returns an empty map when the time-profile rows are absent or none
+ * correlate. Failure modes degrade silently so the cycle-side path
+ * still completes.
+ *
+ * Exposed for testing.
+ */
+export function correlateTimeProfileToHangs(hangs, timeProfileRows) {
+    const result = {};
+    if (hangs.length === 0 || timeProfileRows.length === 0)
+        return result;
+    for (const hang of hangs) {
+        const windowEnd = hang.startNs + hang.durationNs;
+        // Per-frame aggregate score within this hang's window.
+        const scores = new Map();
+        for (const sample of timeProfileRows) {
+            if (sample.startNs < hang.startNs || sample.startNs > windowEnd)
+                continue;
+            const frame = sample.topFrame ??
+                // First non-empty line of backtrace, when topFrame isn't pre-parsed.
+                sample.backtrace?.split(/\r?\n/).find((l) => l.trim().length > 0) ??
+                "";
+            if (!frame)
+                continue;
+            const weight = sample.weight ?? 1;
+            scores.set(frame, (scores.get(frame) ?? 0) + weight);
+        }
+        if (scores.size === 0)
+            continue;
+        // Pick the frame with the highest aggregate score.
+        let topFrame = "";
+        let topScore = -Infinity;
+        for (const [frame, score] of scores) {
+            if (score > topScore) {
+                topScore = score;
+                topFrame = frame;
+            }
+        }
+        if (topFrame)
+            result[hangFrameMapKey(hang.startNs)] = topFrame;
     }
+    return result;
+}
+/**
+ * Spawn `xctrace export` for the `time-profile` schema. Non-fatal on
+ * failure: returns an empty array so the caller can degrade gracefully.
+ * Returns parsed rows with at minimum `startNs` + a `topFrame` string.
+ */
+async function captureTimeProfileRows(tracePath) {
     const result = await runCommand("xcrun", [
         "xctrace",
         "export",
         "--input",
         tracePath,
         "--xpath",
-        '/trace-toc/run/data/table[@schema="potential-hangs"]',
+        '/trace-toc/run/data/table[@schema="time-profile"]',
     ], { timeoutMs: 5 * 60_000 });
-    if (result.code !== 0) {
-        throw new Error(`xctrace export failed (code ${result.code}): ${result.stderr || result.stdout}`);
+    if (result.code !== 0)
+        return [];
+    try {
+        const tables = parseXctraceXml(result.stdout);
+        const tp = tables.find((t) => t.schema === "time-profile");
+        if (!tp)
+            return [];
+        const rows = [];
+        for (const row of tp.rows) {
+            const startNs = asNumber(row.start);
+            if (startNs == null)
+                continue;
+            const weight = asNumber(row.weight) ?? undefined;
+            // The "top frame" field name varies (`backtrace`, `top-frame`, etc.).
+            // Pick the first non-empty stringified candidate.
+            const candidates = [
+                asFormatted(row["top-frame"]),
+                asFormatted(row.backtrace),
+                asFormatted(row.symbol),
+                asFormatted(row["leaf-symbol"]),
+            ];
+            const topFrame = candidates.find((v) => typeof v === "string" && v.length > 0);
+            rows.push({ startNs, weight, topFrame });
+        }
+        return rows;
+    }
+    catch {
+        return [];
+    }
+}
+export async function analyzeHangs(input) {
+    const tracePath = resolvePath(input.tracePath);
+    if (!existsSync(tracePath)) {
+        throw new Error(`Trace bundle not found: ${tracePath}`);
+    }
+    const wantStackClassification = input.includeStackClassification ?? false;
+    const [hangsResult, timeProfileRows] = await Promise.all([
+        runCommand("xcrun", [
+            "xctrace",
+            "export",
+            "--input",
+            tracePath,
+            "--xpath",
+            '/trace-toc/run/data/table[@schema="potential-hangs"]',
+        ], { timeoutMs: 5 * 60_000 }),
+        wantStackClassification
+            ? captureTimeProfileRows(tracePath)
+            : Promise.resolve([]),
+    ]);
+    if (hangsResult.code !== 0) {
+        throw new Error(`xctrace export failed (code ${hangsResult.code}): ${hangsResult.stderr || hangsResult.stdout}`);
+    }
+    // Build the supplemental top-frames map. Caller-supplied map takes
+    // precedence over the v1.12 auto-correlation so users who pre-built a
+    // map can override the heuristic. The auto path runs only when the
+    // user didn't supply a map AND opted into stack classification.
+    let topFramesMap = input.topFramesByHangStartNs;
+    if (!topFramesMap && wantStackClassification && timeProfileRows.length > 0) {
+        // Parse the hangs table once to drive correlation; analyzeHangsFromXml
+        // re-parses internally so we get a clean separation between the
+        // correlation step and the final render.
+        const tables = parseXctraceXml(hangsResult.stdout);
+        const hangsTable = tables.find((t) => t.schema === "potential-hangs");
+        if (hangsTable) {
+            const hangsForCorrelation = [];
+            for (const row of hangsTable.rows) {
+                const startNs = asNumber(row.start) ?? 0;
+                const durationNs = asNumber(row.duration) ?? 0;
+                hangsForCorrelation.push({ startNs, durationNs });
+            }
+            topFramesMap = correlateTimeProfileToHangs(hangsForCorrelation, timeProfileRows);
+        }
     }
-    return analyzeHangsFromXml(result.stdout, tracePath, input.topN ?? 10, input.minDurationMs ?? 0, input.timeRangeMs, input.topFramesByHangStartNs);
+    return analyzeHangsFromXml(hangsResult.stdout, tracePath, input.topN ?? 10, input.minDurationMs ?? 0, input.timeRangeMs, topFramesMap);
 }
 //# sourceMappingURL=analyzeHangs.js.map