@memlab/mcp-server 2.3.0 → 2.52.0

package/dist/tools/detached-dom.js

@@ -9,8 +9,10 @@
  */
 import { z } from 'zod';
 import { getSnapshot, getSnapshotEnv } from '../heap-state.js';
-import { queryNodes, formatQueryNodesResult, formatBytes, formatNumber, markdownTable, errorResult, toolResult, } from '../utils.js';
-import { collectDevRoots, classifyDevOnly } from './dev-artifacts.js';
+import { queryNodes, formatQueryNodesResult, formatBytes, formatNumber, isNodeWorthInspecting, markdownTable, truncateNodeName, errorResult, toolResult, boundedDominatorRetainedSize, } from '../utils.js';
+import memlabCore from '@memlab/core';
+const { NumericSet } = memlabCore;
+import { collectDevRoots, classifyDevOnly, computeReachableWithoutDevRoots, summarizeDevRoots, } from './dev-artifacts.js';
 function isDetachedDOMNode(node) {
     if (node.id <= 3)
         return false;
@@ -18,6 +20,40 @@ function isDetachedDOMNode(node) {
         return true;
     return node.name.startsWith('Detached ');
 }
+// A detached node is only an actual leak if it is still reachable from a GC
+// root — i.e. it has a shortest-path retainer edge. Detached nodes with NO
+// retainer path found are typically GC-eligible (about to be collected) or
+// retained only through weak references, and should not be counted toward a
+// leak total. This distinguishes the "which half is real" problem where a
+// snapshot's detached-node list mixes genuinely-pinned nodes with transient
+// ones. `hasPathEdge` is the same reachability signal used to walk retainers.
+function isPinned(node) {
+    return Boolean(node.hasPathEdge);
+}
+function emptySplit() {
+    return {
+        pinnedCount: 0,
+        pinnedRetained: 0,
+        noPathCount: 0,
+        noPathRetained: 0,
+        pinnedIds: [],
+    };
+}
+/**
+ * Two different numbers, and quoting the wrong one has produced published
+ * errors: on one round the plain sum read 9.7 MB where the amount actually
+ * reclaimable was 308 KB. Lead with the dominator-deduped figure and keep the
+ * sum visible but explicitly labelled.
+ */
+function formatReachabilitySplit(split, snapshot) {
+    const deduped = boundedDominatorRetainedSize(new NumericSet(split.pinnedIds), snapshot);
+    const bound = deduped.exact ? '' : ' (upper bound; deep dominator chain)';
+    return [
+        `- Pinned (retainer path to a GC root — actionable leak): ${formatNumber(split.pinnedCount)} nodes, **${formatBytes(deduped.retained)} reclaimable**${bound} (dominator-deduped)`,
+        `  - sum over nodes: ${formatBytes(split.pinnedRetained)} — double-counts nested detached subtrees; do NOT quote this as the size of the leak`,
+        `- No retainer path found (likely GC-eligible / weak-only — exclude from leak totals): ${formatNumber(split.noPathCount)} nodes, ${formatBytes(split.noPathRetained)}`,
+    ];
+}
 function extractElementTag(name) {
     // V8 names detached DOM as "Detached <div>" or "Detached <div class="...">"
     const match = name.match(/^(?:Detached\s+)?<(\w+)/);
@@ -30,7 +66,7 @@ function extractTestId(node) {
         return testIdMatch[1];
     return '(no testid)';
 }
-function getFirstNonFrameworkRetainer(node) {
+export function getFirstNonFrameworkRetainer(node) {
     const frameworkNames = new Set([
         'system / Context',
         '(GC roots)',
@@ -55,14 +91,94 @@ function getFirstNonFrameworkRetainer(node) {
             from.type !== 'synthetic' &&
             from.type !== 'native') {
             const edgeName = String(edge.name_or_index);
-            return `${from.name} (${from.type}) .${edgeName}`;
+            // V8 leaves anonymous functions/objects unnamed; printing the empty
+            // string renders as a leading blank that reads like a formatting bug.
+            const fromName = from.name.length > 0 ? from.name : '(anonymous)';
+            return `${fromName} (${from.type}) .${edgeName}`;
         }
         cur = from;
     }
     return '(unknown)';
 }
+// Climbing more than this many dominator hops means the detached subtree is
+// pathologically deep; give up rather than pay for it on every node.
+const MAX_DOMINATOR_HOPS = 64;
+// Distinct owners tracked per group before the count is reported as "N+".
+// Bounds memory when a group spans one owner per node (100k+ detached nodes).
+const MAX_TRACKED_OWNERS = 1000;
+/**
+ * Resolve the node that is ACCOUNTABLE for a detached node: the nearest
+ * dominator above it that is not itself detached DOM and is worth naming.
+ *
+ * Why this is not the same as `getFirstNonFrameworkRetainer`: that walks the
+ * shortest RETAINER path, which is only one of possibly many references and need
+ * not dominate the node at all. Grouping by it and then saying "fixing this
+ * frees X" is wrong whenever the group's nodes are also held elsewhere — the
+ * whole point of the dominator tree is that freeing a dominator DOES free
+ * everything below it.
+ *
+ * Returns a resolver closure rather than a bare function so the walk can be
+ * memoized: sibling detached nodes share ancestors, and every chain member's
+ * answer is the same node. Cached entries are per-load only (the closure lives
+ * for one tool call).
+ */
+function makeDominatorResolver() {
+    const cache = new Map();
+    return function resolve(node) {
+        const chain = [];
+        const seen = new Set([node.id]);
+        let cur = node.dominatorNode ?? null;
+        let owner = null;
+        let hops = 0;
+        // Whether the walk ended for a reason intrinsic to the graph (found an
+        // owner, or ran out of dominators) rather than because THIS walk ran out of
+        // budget. Only an intrinsic result may be memoized — see below.
+        let conclusive = false;
+        while (cur && hops < MAX_DOMINATOR_HOPS) {
+            const cached = cache.get(cur.id);
+            if (cached !== undefined) {
+                owner = cached;
+                conclusive = true;
+                break;
+            }
+            if (seen.has(cur.id))
+                break;
+            seen.add(cur.id);
+            chain.push(cur.id);
+            if (!isDetachedDOMNode(cur) &&
+                cur.name !== '(GC roots)' &&
+                isNodeWorthInspecting(cur)) {
+                owner = cur;
+                conclusive = true;
+                break;
+            }
+            const next = cur.dominatorNode ?? null;
+            if (!next || next.id === cur.id) {
+                // The chain genuinely ends here: there is no owner above, and that is a
+                // property of the graph, not of this walk.
+                conclusive = true;
+                break;
+            }
+            cur = next;
+            hops++;
+        }
+        // Memoize ONLY a conclusive result. Caching a hop-cap or cycle-break exit
+        // would store "no owner" — a fact about this walk's 64-hop budget — as if it
+        // were a fact about the node. A later, deeper node whose own budget WOULD
+        // have reached a real owner then short-circuits on the poisoned entry and is
+        // reported as "no single owner", which is precisely the unsound ownership
+        // claim this grouping exists to eliminate.
+        if (conclusive) {
+            for (const id of chain)
+                cache.set(id, owner);
+        }
+        return owner;
+    };
+}
 export function registerDetachedDom(server) {
-    server.tool('memlab_detached_dom', 'Find detached DOM elements still retained in memory. These are common sources of memory leaks — DOM nodes removed from the document but kept alive by JavaScript references. Supports count-only and ids-only modes for large result sets. Use group_by to aggregate by element tag, retainer pattern, or data-testid. ' +
+    server.tool('memlab_detached_dom', 'Find detached DOM elements still retained in memory. These are common sources of memory leaks — DOM nodes removed from the document but kept alive by JavaScript references. Supports count-only and ids-only modes for large result sets. Use group_by to aggregate by dominator (accountable owner), element tag, retainer pattern, or data-testid. ' +
+        'Prefer group_by: "dominator" when you intend to act on the result: it groups by the nearest non-detached DOMINATOR, so releasing that one object provably frees the whole group. The other groupings key on a shortest retainer path, which need not dominate the nodes — they report an "Owners" column (distinct accountable dominators) so a group split across many owners is not mistaken for a single fix. ' +
+        'Reports a pinned-vs-GC-eligible split: detached nodes with a retainer path to a GC root are actual leaks, while nodes with no retainer path found are typically GC-eligible (transient / weak-only) and should be excluded from leak totals — set only_with_retainer_path to list/aggregate just the pinned ones. ' +
         '⚠ Full-heap scan — slow on very large heaps (millions of nodes); use count-only / ids-only modes and group_by to bound output.', {
         output_mode: z
             .enum(['full', 'count', 'ids'])
@@ -70,9 +186,9 @@ export function registerDetachedDom(server) {
             .default('full')
             .describe('Output verbosity: "full" returns node summaries (default), "count" returns only the total count, "ids" returns only node IDs'),
         group_by: z
-            .enum(['element', 'retainer', 'testid'])
+            .enum(['element', 'retainer', 'testid', 'dominator'])
             .optional()
-            .describe('Group detached DOM nodes instead of listing individually. "element" groups by HTML tag (div, span, button), "retainer" groups by first non-framework retainer (the component/module holding them), "testid" groups by data-testid attribute.'),
+            .describe('Group detached DOM nodes instead of listing individually. "dominator" groups by the nearest non-detached dominator — the object that provably frees the whole group when released (use this to decide what to fix); "element" groups by HTML tag (div, span, button); "retainer" groups by first non-framework retainer on the shortest path (which need not dominate the nodes); "testid" groups by data-testid attribute.'),
         offset: z
             .number()
             .optional()
@@ -87,8 +203,13 @@ export function registerDetachedDom(server) {
             .boolean()
             .optional()
             .default(true)
-            .describe("Report how much detached DOM is retained ONLY via dev/extension globals (__REACT_DEVTOOLS_GLOBAL_HOOK__, window.Debug, …) and would be GC'd in production (default true). Use memlab_dev_artifacts for the full breakdown."),
-    }, async ({ output_mode, group_by, offset, limit, classify_dev_only }) => {
+            .describe('Report how much detached DOM is retained ONLY via dev/automation artifacts — dev/extension globals (__REACT_DEVTOOLS_GLOBAL_HOOK__, window.Debug, …) or the Blink a11y/CDP cache (AXObjectCacheImpl, which co-retains detached DOM under automation) — and so should be excluded from production leak totals (default true). Use memlab_dev_artifacts for the full breakdown.'),
+        only_with_retainer_path: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Only include detached nodes that have a retainer path to a GC root (i.e. actually pinned / leaked). When false (default) all detached nodes are included, but the summary always reports the pinned-vs-GC-eligible split so transient / weak-only detached DOM is not mistaken for a leak.'),
+    }, async ({ output_mode, group_by, offset, limit, classify_dev_only, only_with_retainer_path, }) => {
         try {
             const env = getSnapshotEnv();
             if (env === 'node') {
@@ -101,19 +222,47 @@ export function registerDetachedDom(server) {
             }
             const snapshot = getSnapshot();
             const devRoots = classify_dev_only ? collectDevRoots(snapshot) : null;
+            // Reachability pass (dev roots as sinks) so co-retention via multiple
+            // dev roots — e.g. detached DOM held by BOTH the DevTools console and
+            // the a11y cache — is correctly counted as a dev/automation artifact.
+            const reached = devRoots && devRoots.byId.size > 0
+                ? computeReachableWithoutDevRoots(snapshot, devRoots)
+                : undefined;
             if (group_by) {
                 const groups = new Map();
+                const resolveOwner = makeDominatorResolver();
                 let totalDetached = 0;
                 let totalRetainedAll = 0;
                 let devOnlyRetained = 0;
+                const split = emptySplit();
                 snapshot.nodes.forEach(node => {
                     if (!isDetachedDOMNode(node))
                         return;
                     totalDetached++;
                     totalRetainedAll += node.retainedSize;
-                    if (devRoots && classifyDevOnly(node, devRoots).devOnly) {
+                    const pinned = isPinned(node);
+                    if (pinned) {
+                        split.pinnedCount++;
+                        split.pinnedRetained += node.retainedSize;
+                        split.pinnedIds.push(node.id);
+                    }
+                    else {
+                        split.noPathCount++;
+                        split.noPathRetained += node.retainedSize;
+                    }
+                    const nodeIsDevOnly = devRoots
+                        ? classifyDevOnly(node, devRoots, reached).devOnly
+                        : false;
+                    if (nodeIsDevOnly) {
                         devOnlyRetained += node.retainedSize;
                     }
+                    // With only_with_retainer_path, exclude GC-eligible (no-path) nodes
+                    // from the group aggregation — they are still counted in the split.
+                    if (only_with_retainer_path && !pinned)
+                        return;
+                    // Resolved for every grouping, not just 'dominator': the other keys
+                    // need it to report how many distinct owners they span.
+                    const owner = resolveOwner(node);
                     let key;
                     switch (group_by) {
                         case 'element':
@@ -125,11 +274,33 @@ export function registerDetachedDom(server) {
                         case 'testid':
                             key = extractTestId(node);
                             break;
+                        case 'dominator':
+                            // No owner = the dominator is the GC root itself, i.e. the node
+                            // is reachable through two or more independent paths. Naming
+                            // that outcome matters more than the others: it is precisely the
+                            // case where "fix this retainer and X is freed" is false.
+                            key = owner
+                                ? `@${owner.id} ${truncateNodeName(owner.name, owner.type, owner.self_size, 60)}`
+                                : '(no single owner — dominated by the GC root, i.e. reachable via ≥2 independent paths)';
+                            break;
                     }
                     const existing = groups.get(key);
                     if (existing) {
                         existing.count++;
                         existing.totalRetained += node.retainedSize;
+                        if (nodeIsDevOnly)
+                            existing.devOnlyCount++;
+                        if (owner) {
+                            if (existing.ownerIds.size < MAX_TRACKED_OWNERS) {
+                                existing.ownerIds.add(owner.id);
+                            }
+                            else if (!existing.ownerIds.has(owner.id)) {
+                                existing.ownersTruncated = true;
+                            }
+                        }
+                        else {
+                            existing.ownerlessCount++;
+                        }
                         if (node.retainedSize > existing.maxRetainedSize) {
                             existing.exampleId = node.id;
                             existing.maxRetainedSize = node.retainedSize;
@@ -141,10 +312,26 @@ export function registerDetachedDom(server) {
                             totalRetained: node.retainedSize,
                             exampleId: node.id,
                             maxRetainedSize: node.retainedSize,
+                            devOnlyCount: nodeIsDevOnly ? 1 : 0,
+                            ownerIds: new Set(owner ? [owner.id] : []),
+                            ownersTruncated: false,
+                            ownerlessCount: owner ? 0 : 1,
+                            // The owner's own retained size, not the sum of the group's
+                            // detached nodes: releasing it frees everything it dominates.
+                            ownerRetained: owner ? owner.retainedSize : 0,
                         });
                     }
                 });
                 if (groups.size === 0) {
+                    if (totalDetached > 0) {
+                        return toolResult([
+                            `Detached DOM grouped by ${group_by}: ${formatNumber(totalDetached)} total nodes, ${formatBytes(totalRetainedAll)} total retained`,
+                            ...formatReachabilitySplit(split, snapshot),
+                            only_with_retainer_path
+                                ? '_No pinned (retainer-path) detached nodes — all detached DOM is GC-eligible / weak-only, not a leak._'
+                                : '',
+                        ].join('\n'));
+                    }
                     return toolResult('No detached DOM nodes found.');
                 }
                 const sorted = [...groups.entries()]
@@ -154,15 +341,36 @@ export function registerDetachedDom(server) {
                     ? 'Element'
                     : group_by === 'retainer'
                         ? 'Retainer'
-                        : 'data-testid';
+                        : group_by === 'dominator'
+                            ? 'Dominator (accountable owner)'
+                            : 'data-testid';
+                // Per-group dev-only share. Without this the caller has to run
+                // dev_artifacts separately and mentally join the two outputs, which is
+                // exactly the step that gets skipped before a group is reported as a
+                // production leak.
+                const showDevOnly = devRoots != null &&
+                    sorted.some(([, stats]) => stats.devOnlyCount > 0);
+                // In dominator mode the owner count is 1 by construction, so the
+                // interesting column is what that owner frees; for every other
+                // grouping it is how many owners the group is split across.
+                const isDominatorMode = group_by === 'dominator';
+                const ownerCountLabel = (stats) => {
+                    const n = stats.ownerIds.size;
+                    const shown = stats.ownersTruncated ? `${n}+` : String(n);
+                    if (n === 0)
+                        return stats.ownerlessCount > 0 ? 'none' : '-';
+                    return stats.ownerlessCount > 0 ? `${shown} (+unowned)` : shown;
+                };
                 const headers = [
                     groupLabel,
                     'Count',
+                    ...(showDevOnly ? ['Dev-only'] : []),
                     'Total Retained',
                     '% of Detached',
+                    ...(isDominatorMode ? ['Owner Frees'] : ['Owners']),
                     'Example ID',
                 ];
-                const rightCols = new Set([1, 2, 3]);
+                const rightCols = new Set(showDevOnly ? [1, 2, 3, 4, 5] : [1, 2, 3, 4]);
                 const rows = sorted.map(([key, stats]) => {
                     const pct = totalRetainedAll > 0
                         ? ((stats.totalRetained / totalRetainedAll) * 100).toFixed(1) +
@@ -171,44 +379,107 @@ export function registerDetachedDom(server) {
                     return [
                         key.length > 60 ? key.slice(0, 57) + '...' : key,
                         formatNumber(stats.count),
+                        ...(showDevOnly
+                            ? [
+                                stats.devOnlyCount === 0
+                                    ? '—'
+                                    : stats.devOnlyCount === stats.count
+                                        ? 'ALL'
+                                        : `${formatNumber(stats.devOnlyCount)}/${formatNumber(stats.count)}`,
+                            ]
+                            : []),
                         formatBytes(stats.totalRetained),
                         pct,
+                        isDominatorMode
+                            ? stats.ownerRetained > 0
+                                ? formatBytes(stats.ownerRetained)
+                                : '-'
+                            : ownerCountLabel(stats),
                         `@${stats.exampleId}`,
                     ];
                 });
                 const lines = [
                     `Detached DOM grouped by ${group_by}: ${formatNumber(totalDetached)} total nodes, ${formatBytes(totalRetainedAll)} total retained`,
-                    '',
-                    markdownTable(headers, rows, rightCols),
+                    ...formatReachabilitySplit(split, snapshot),
                 ];
+                if (only_with_retainer_path) {
+                    lines.push('_(groups below show pinned nodes only)_');
+                }
+                lines.push('', markdownTable(headers, rows, rightCols));
+                if (isDominatorMode) {
+                    const ownerless = sorted.find(([, s]) => s.ownerIds.size === 0 && s.ownerlessCount > 0);
+                    lines.push('', "_Grouped by the nearest non-detached **dominator**: releasing that object frees every detached node in its row. **Owner Frees** is the owner's own retained size — the true, non-overlapping figure, and the amount actually reclaimed (it also covers whatever else the owner holds). Total Retained is a plain sum over the group, so it double-counts nested detached subtrees and can exceed Owner Frees._");
+                    if (ownerless) {
+                        lines.push(`_⚠ ${formatNumber(ownerless[1].count)} node(s) (${formatBytes(ownerless[1].totalRetained)}) have **no single owner** — their dominator is the GC root, so they are reachable through two or more independent paths and no one object frees them. Use \`memlab_retainer_summary\` / \`memlab_get_referrers\` to enumerate every path; all of them must be cut._`);
+                    }
+                }
+                else {
+                    const notSingleOwner = sorted.filter(([, s]) => s.ownerIds.size === 0 ||
+                        s.ownerIds.size + (s.ownerlessCount > 0 ? 1 : 0) > 1).length;
+                    lines.push('', `_**Owners** = distinct accountable dominators the group spans (\`none\` = dominated by the GC root, i.e. reachable via ≥2 independent paths). This grouping keys on ${group_by === 'retainer' ? 'the first non-framework retainer along the SHORTEST retainer path, which need not dominate the nodes' : `the node's ${group_by}`}, so only a group with **Owners = 1** is freed by fixing one object.${notSingleOwner > 0 ? ` ${formatNumber(notSingleOwner)} of the ${formatNumber(sorted.length)} groups below are not single-owner — for those, "fixing this frees X" is wrong; re-run with \`group_by: "dominator"\` to see what actually frees them.` : ''}_`);
+                }
                 if (devRoots && devRoots.byId.size > 0 && devOnlyRetained > 0) {
                     const pct = totalRetainedAll > 0
                         ? ((devOnlyRetained / totalRetainedAll) * 100).toFixed(0)
                         : '0';
-                    lines.push('', `⚠ **${formatBytes(devOnlyRetained)} (${pct}%) of this detached DOM is retained ONLY via dev/extension globals** (${[...new Set(devRoots.byId.values())].join(', ')}) — it would be garbage-collected in production. Exclude it from leak totals; run \`memlab_dev_artifacts\` for the breakdown.`);
+                    lines.push('', `⚠ **${formatBytes(devOnlyRetained)} (${pct}%) of this detached DOM is retained ONLY via dev/automation artifacts** (${summarizeDevRoots(devRoots)}) — dev-global retention would be GC'd in production, and a11y/CDP-cache retention is automation-inflated (not present at that scale in a normal session). Exclude it from leak totals; run \`memlab_dev_artifacts\` for the breakdown.`);
                 }
                 if (sorted.length > 0) {
-                    lines.push('', `**Suggested action:** Use \`memlab_retainer_summary\` with node_ids from the top group's example to trace the common retention pattern.`);
+                    // In dominator mode point at the largest row that HAS an owner —
+                    // the ownerless bucket can top the table, and "run dominator_chain
+                    // on it" is meaningless there (it is already at the root).
+                    const topOwned = isDominatorMode
+                        ? sorted.find(([, s]) => s.ownerIds.size > 0)
+                        : undefined;
+                    lines.push('', isDominatorMode
+                        ? topOwned
+                            ? `**Suggested action:** Run \`memlab_dominator_chain\` on the largest owned group's owner to find the accountable application object, then \`memlab_retainer_summary\` on its example (\`@${topOwned[1].exampleId}\`) for the reference that holds it.`
+                            : '**Suggested action:** No group has a single owner — every detached node here is reachable via multiple independent paths. Use `memlab_retainer_summary` on an example to enumerate the paths; each one must be cut.'
+                        : `**Suggested action:** Use \`memlab_retainer_summary\` with node_ids from the top group's example to trace the common retention pattern. Before acting on a group, confirm its **Owners** is 1 — or re-run with \`group_by: "dominator"\`, which groups by what a fix actually frees.`);
                 }
                 return toolResult(lines.join('\n'));
             }
+            const split = emptySplit();
+            snapshot.nodes.forEach(node => {
+                if (!isDetachedDOMNode(node))
+                    return;
+                if (isPinned(node)) {
+                    split.pinnedCount++;
+                    split.pinnedRetained += node.retainedSize;
+                    split.pinnedIds.push(node.id);
+                }
+                else {
+                    split.noPathCount++;
+                    split.noPathRetained += node.retainedSize;
+                }
+            });
+            const predicate = only_with_retainer_path
+                ? (n) => isDetachedDOMNode(n) && isPinned(n)
+                : isDetachedDOMNode;
             const effectiveLimit = output_mode === 'ids' ? Math.min(limit, 10000) : Math.min(limit, 500);
-            const result = queryNodes(snapshot, isDetachedDOMNode, {
+            const result = queryNodes(snapshot, predicate, {
                 limit: effectiveLimit,
                 offset,
                 outputMode: output_mode,
             });
-            const output = formatQueryNodesResult(result, offset);
+            const splitBlock = output_mode === 'ids'
+                ? ''
+                : formatReachabilitySplit(split, snapshot).join('\n') + '\n\n';
+            const output = splitBlock + formatQueryNodesResult(result, offset);
             if (result.total_count > 0 && output_mode === 'full') {
                 const devNote = devRoots && devRoots.byId.size > 0
-                    ? ` Dev/extension globals (${[...new Set(devRoots.byId.values())].join(', ')}) are present — run \`memlab_dev_artifacts\` to exclude DevTools-only retention from leak totals.`
+                    ? ` Dev/extension globals (${summarizeDevRoots(devRoots)}) are present — run \`memlab_dev_artifacts\` to exclude DevTools-only retention from leak totals.`
+                    : '';
+                const pinnedNote = split.noPathCount > 0
+                    ? ` ${formatNumber(split.noPathCount)} detached node(s) have no retainer path (likely GC-eligible / weak-only) — pass only_with_retainer_path to focus on the ${formatNumber(split.pinnedCount)} pinned one(s).`
                     : '';
                 return toolResult(output +
                     '\n\n---\n\n' +
                     '**Suggested action:** Check for missing `removeEventListener` calls, ' +
                     'React component cleanup in `useEffect` return, or refs not cleared on unmount. ' +
                     'Use `memlab_retainer_trace` on top entries to find the retention path. ' +
-                    'Use `group_by: "retainer"` to see which components are retaining the most detached DOM.' +
+                    'Use `group_by: "dominator"` to see which objects are accountable for the most detached DOM (releasing one frees its whole group), or `group_by: "retainer"` for the shortest-path view.' +
+                    pinnedNote +
                     devNote);
             }
             return toolResult(output);

package/dist/tools/detached-dom.js.map

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

package/dist/tools/dev-artifacts.d.ts

@@ -11,7 +11,22 @@ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { IHeapNode, IHeapSnapshot } from '@memlab/core';
 export interface DevRoots {
     byId: Map<number, string>;
+    categoryById: Map<number, DevRootCategory>;
 }
+export type DevRootCategory = 'console' | 'a11y' | 'devGlobal' | 'reactDebugStack' | 'reactFastRefresh' | 'harness';
+/**
+ * One-line summary of the dev/automation roots present, as counts per family.
+ *
+ * The full list was printed on every call and is unbounded: each Blink a11y
+ * object and each bridge export is its own root, so a measured WhatsApp Web run
+ * spent ~1,500 tokens per call on a single comma-separated line of names, and an
+ * Ads Manager run repeated an entire multi-sentence React warning inside it.
+ * Nothing downstream keyed on the individual names — the reader needs to know
+ * WHICH FAMILIES are present, which is what the categories already encode.
+ * `show_roots: true` restores the full list for the rare case of chasing one
+ * specific root.
+ */
+export declare function summarizeDevRoots(devRoots: DevRoots, showAll?: boolean): string;
 /**
  * Find the dev/extension "root" objects: the targets of dev-global edges on
  * the Window/global object, plus any node whose own name marks it as a
@@ -19,13 +34,54 @@ export interface DevRoots {
  */
 export declare function collectDevRoots(snapshot: IHeapSnapshot): DevRoots;
 /**
- * Classify whether a node is retained ONLY via a dev/extension global. We walk
- * the dominator chain upward: if a dev root *dominates* the node, then every
- * path from a GC root to the node passes through that dev object, so it would
- * be collected in production. Using the dominator (not the shortest retainer)
- * makes the "only via" claim rigorous.
+ * Reachability from GC roots with every dev/automation root treated as a sink
+ * (its outgoing edges are not followed). Returns a bitmap indexed by
+ * `node.nodeIndex`: 1 = still reachable from a real GC root without passing
+ * through a dev root (production-reachable), 0 = reachable ONLY through one or
+ * more dev roots (a dev/automation-only artifact).
+ *
+ * This is stricter and more complete than a dominator walk: when an object is
+ * co-retained by SEVERAL different dev roots (e.g. the DevTools console AND the
+ * a11y cache both point at the same detached-DOM subtree), no single dev root
+ * dominates it, so a dominator walk misses it — but it is still dev-only because
+ * every path to it passes through some dev root. This pass catches that case.
+ */
+export declare function computeReachableWithoutDevRoots(snapshot: IHeapSnapshot, devRoots: DevRoots): Uint8Array;
+export interface DevOnlyTotals {
+    nodes: number;
+    retained: number;
+    byCategory: Map<DevRootCategory, {
+        nodes: number;
+        selfBytes: number;
+    }>;
+}
+/**
+ * Whole-heap total of everything retained ONLY via dev/automation roots, plus a
+ * per-source breakdown.
+ *
+ * This is deliberately independent of any display threshold. The previous
+ * implementation accumulated the total inside the same loop that filtered
+ * candidates by `min_retained_size`, so the headline number only counted
+ * objects above the cutoff. With the 512 KB default that made a heap holding
+ * thousands of small console-retained objects report **0 B dev-only** — read by
+ * a caller as "this is production-real". Whole classes of artifact (per-event
+ * log strings, one logged object per interaction) are individually tiny and
+ * collectively large, which is exactly the case that matters.
+ *
+ * Attribution is a single BFS over the dev-only subgraph, seeded from each dev
+ * root's dev-only successors and OR-ing a category bit as it goes, so a subtree
+ * co-retained by several artifact families is counted under each.
+ */
+export declare function summarizeDevOnly(snapshot: IHeapSnapshot, devRoots: DevRoots, reached: Uint8Array): DevOnlyTotals;
+/**
+ * Classify whether a node is retained ONLY via dev/automation roots. Prefer the
+ * reachability bitmap from `computeReachableWithoutDevRoots` (rigorous and
+ * complete, including multi-dev-root co-retention). Without a bitmap, fall back
+ * to a dominator walk: if a dev root *dominates* the node, every path to it
+ * passes through that dev object — conservative, catches only single-dev-root
+ * retention.
  */
-export declare function classifyDevOnly(node: IHeapNode, devRoots: DevRoots, maxWalk?: number): {
+export declare function classifyDevOnly(node: IHeapNode, devRoots: DevRoots, reached?: Uint8Array, maxWalk?: number): {
     devOnly: boolean;
     via: string | null;
 };

package/dist/tools/dev-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-artifacts.d.ts","sourceRoot":"","sources":["../../src/tools/dev-artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAC,SAAS,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AA4B3D,MAAM,WAAW,QAAQ;IAEvB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,QAAQ,CAqBjE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,SAAO,GACb;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAC,CAYxC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwG5D"}
+{"version":3,"file":"dev-artifacts.d.ts","sourceRoot":"","sources":["../../src/tools/dev-artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAY,SAAS,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAwJtE,MAAM,WAAW,QAAQ;IAEvB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAG1B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,MAAM,GACN,WAAW,GACX,iBAAiB,GACjB,kBAAkB,GAClB,SAAS,CAAC;AAWd;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,UAAQ,GAAG,MAAM,CAoB7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,QAAQ,CAoGjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,QAAQ,GACjB,UAAU,CA0BZ;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC,eAAe,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CACtE;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,UAAU,GAClB,aAAa,CAgEf;AAyBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,UAAU,EACpB,OAAO,SAAO,GACb;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAC,CAmBxC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkN5D"}