@memlab/mcp-server 2.1.0 → 2.3.0

package/dist/tools/auto-investigate.js

@@ -7,9 +7,11 @@
  * @format
  * @oncall memory_lab
  */
+import memlabCore from '@memlab/core';
+const { utils, NumericSet } = memlabCore;
 import { z } from 'zod';
 import { getSnapshot, getSnapshotMetadata } from '../heap-state.js';
-import { filterLargestObjects, isNodeWorthInspecting, formatBytes, formatNumber, truncateNodeName, errorResult, toolResult, } from '../utils.js';
+import { filterLargestObjects, isNodeWorthInspecting, formatBytes, formatNumber, truncateNodeName, instrumentationRetainerNote, errorResult, toolResult, suggestionsSuppressed, } from '../utils.js';
 function classifySeverity(retainedSize, totalSize) {
     if (totalSize === 0)
         return 'LOW';
@@ -244,6 +246,47 @@ function scanTopShapes(snapshot, limit) {
         .sort((a, b) => b.totalSelfSize - a.totalSelfSize)
         .slice(0, limit);
 }
+function scanDistributedAccumulation(snapshot, totalSize) {
+    const classMap = new Map();
+    snapshot.nodes.forEach(node => {
+        if (node.id <= 3)
+            return;
+        if (node.type === 'hidden' || node.type === 'array')
+            return;
+        const key = `${node.type}::${node.name}`;
+        const existing = classMap.get(key);
+        if (existing) {
+            existing.count++;
+            existing.totalSelfSize += node.self_size;
+        }
+        else {
+            classMap.set(key, {
+                className: node.name,
+                nodeType: node.type,
+                count: 1,
+                totalSelfSize: node.self_size,
+                exampleNodeId: node.id,
+            });
+        }
+    });
+    return [...classMap.values()]
+        .filter(c => {
+        if (c.count < 50_000)
+            return false;
+        const avgSize = c.totalSelfSize / c.count;
+        if (avgSize > 10_000)
+            return false;
+        if (totalSize > 0 && c.totalSelfSize < totalSize * 0.03)
+            return false;
+        return true;
+    })
+        .map(c => ({
+        ...c,
+        avgSize: c.totalSelfSize / c.count,
+    }))
+        .sort((a, b) => b.totalSelfSize - a.totalSelfSize)
+        .slice(0, 5);
+}
 const LISTENER_SHAPE_KEYWORDS = new Set([
     'callback',
     'handler',
@@ -264,7 +307,15 @@ const LISTENER_CONTEXT_KEYWORDS = new Set([
     'scope',
     'self',
 ]);
-function scanSubscriptionAccumulation(snapshot, threshold) {
+function scanSubscriptionAccumulation(snapshot, threshold, totalSize) {
+    const CALLBACK_PROPS = new Set(['callback', 'fn', 'handler', 'listener']);
+    const CONTEXT_PROPS_SET = new Set([
+        'context',
+        'ctx',
+        'this',
+        'target',
+        'scope',
+    ]);
     const shapeMap = new Map();
     snapshot.nodes.forEach(node => {
         if (node.type !== 'object' || node.id <= 3)
@@ -272,9 +323,20 @@ function scanSubscriptionAccumulation(snapshot, threshold) {
         if (node.name !== 'Object')
             return;
         const names = [];
+        let callbackId = 0;
+        let contextId = 0;
+        let contextName = '';
         for (const edge of node.references) {
             if (edge.type === 'property') {
-                names.push(String(edge.name_or_index));
+                const pName = String(edge.name_or_index);
+                names.push(pName);
+                if (CALLBACK_PROPS.has(pName)) {
+                    callbackId = edge.toNode.id;
+                }
+                if (CONTEXT_PROPS_SET.has(pName)) {
+                    contextId = edge.toNode.id;
+                    contextName = edge.toNode.name;
+                }
             }
         }
         if (names.length === 0 || names.length > 10)
@@ -285,10 +347,29 @@ function scanSubscriptionAccumulation(snapshot, threshold) {
         if (existing) {
             existing.count++;
             existing.totalSelfSize += node.self_size;
+            if (callbackId > 0)
+                existing.callbackIds.add(callbackId);
+            if (contextId > 0) {
+                existing.contextIds.add(contextId);
+                existing.contextShapeMap.set(contextName, (existing.contextShapeMap.get(contextName) ?? 0) + 1);
+                const ctxNode = snapshot.getNodeById(contextId);
+                if (ctxNode && ctxNode.numOfReferrers <= 2) {
+                    existing.orphanedContexts++;
+                }
+            }
         }
         else {
             const hasListener = names.some(n => LISTENER_SHAPE_KEYWORDS.has(n) || n.startsWith('on'));
             const hasContext = names.some(n => LISTENER_CONTEXT_KEYWORDS.has(n));
+            const contextShapeMap = new Map();
+            let orphanedContexts = 0;
+            if (contextId > 0) {
+                contextShapeMap.set(contextName, 1);
+                const ctxNode = snapshot.getNodeById(contextId);
+                if (ctxNode && ctxNode.numOfReferrers <= 2) {
+                    orphanedContexts = 1;
+                }
+            }
             shapeMap.set(key, {
                 properties: names,
                 count: 1,
@@ -296,12 +377,47 @@ function scanSubscriptionAccumulation(snapshot, threshold) {
                 exampleNodeId: node.id,
                 hasListenerProp: hasListener,
                 hasContextProp: hasContext,
+                callbackIds: new Set(callbackId > 0 ? [callbackId] : []),
+                contextIds: new Set(contextId > 0 ? [contextId] : []),
+                contextShapeMap,
+                orphanedContexts,
             });
         }
     });
-    return [...shapeMap.values()]
+    const results = [...shapeMap.values()]
         .filter(s => s.count >= threshold && s.hasListenerProp && s.hasContextProp)
         .sort((a, b) => b.totalSelfSize - a.totalSelfSize);
+    return results.map(s => {
+        const hasHighFanOut = s.callbackIds.size <= 5 && s.contextIds.size > 10;
+        const hasOrphanedContexts = s.orphanedContexts > s.contextIds.size * 0.5;
+        let fanOut;
+        if (hasHighFanOut || hasOrphanedContexts) {
+            let escalatedSeverity = classifySeverity(s.totalSelfSize, totalSize);
+            if (hasHighFanOut &&
+                hasOrphanedContexts &&
+                (escalatedSeverity === 'LOW' || escalatedSeverity === 'MEDIUM')) {
+                escalatedSeverity = s.orphanedContexts > 100 ? 'CRITICAL' : 'HIGH';
+            }
+            const contextShapes = [...s.contextShapeMap.entries()]
+                .map(([name, count]) => ({ name, count }))
+                .sort((a, b) => b.count - a.count)
+                .slice(0, 5);
+            fanOut = {
+                uniqueCallbacks: s.callbackIds.size,
+                uniqueContexts: s.contextIds.size,
+                orphanedContexts: s.orphanedContexts,
+                contextShapes,
+                escalatedSeverity,
+            };
+        }
+        return {
+            properties: s.properties,
+            count: s.count,
+            totalSelfSize: s.totalSelfSize,
+            exampleNodeId: s.exampleNodeId,
+            fanOut,
+        };
+    });
 }
 const ERROR_CLASS_NAMES = new Set([
     'Error',
@@ -354,9 +470,46 @@ function scanErrorAccumulation(snapshot, minCount) {
 function tracePrefix(trace) {
     return trace.map(s => `${s.name}(${s.type})`).join('->');
 }
+/**
+ * True if `ancestor` dominates `descendant` in the dominator tree (i.e. all
+ * paths from the GC root to `descendant` pass through `ancestor`, so
+ * `ancestor.retainedSize` already includes `descendant.retainedSize`). Walks
+ * the unique dominator chain upward, bounded to avoid pathological depth.
+ */
+function isDominatorAncestor(ancestor, descendant, maxWalk = 500) {
+    if (ancestor.id === descendant.id)
+        return false;
+    let cur = descendant.dominatorNode ?? null;
+    let steps = 0;
+    while (cur && steps < maxWalk) {
+        if (cur.id === ancestor.id)
+            return true;
+        if (cur.dominatorNode?.id === cur.id)
+            break; // reached root self-loop
+        cur = cur.dominatorNode ?? null;
+        steps++;
+    }
+    return false;
+}
+/**
+ * Correct combined retained size for a set of nodes that may overlap on the
+ * dominator tree. In a dominator tree two nodes' retained subtrees are either
+ * nested or disjoint, so only dominator-maximal members are counted (any node
+ * dominated by another member has its bytes already included). This never
+ * exceeds the heap total — fixing the ">100% of heap" accounting.
+ *
+ * Delegates to memlab's `aggregateDominatorMetrics`, which dedups by walking
+ * each node's dominator chain once against a set — O(N·D) (N = nodes, D =
+ * dominator depth), versus the previous O(N²·D) pairwise `isDominatorAncestor`
+ * scan.
+ */
+function combinedRetainedSize(nodes, snapshot) {
+    return utils.aggregateDominatorMetrics(new NumericSet(nodes.map(n => n.id)), snapshot, () => true, (node) => node.retainedSize);
+}
 function deduplicateFindings(findings) {
     if (findings.length <= 1)
         return findings;
+    // Phase 1: Collapse findings that share the same retainer trace prefix
     const prefixMap = new Map();
     for (const f of findings) {
         const collapsed = f.trace.filter(s => s.type !== 'hidden' &&
@@ -384,12 +537,54 @@ function deduplicateFindings(findings) {
             prefixMap.set(prefix, { representative: f, others: [] });
         }
     }
-    const result = [];
+    const prefixResult = [];
     for (const { representative, others } of prefixMap.values()) {
         representative.collapsed_siblings = others;
-        result.push(representative);
+        prefixResult.push(representative);
     }
-    return result;
+    // Phase 2: Merge findings that retain the *same dominated subtree* — whether
+    // because one node dominates the other in the dominator tree (so their
+    // retained sizes overlap) or because the same big subtree is reachable two
+    // ways and shows up under two different top retainers (Feedback §2a, §1a).
+    // The larger-retained node becomes the representative; the other is recorded
+    // as an alternate path so we report ONE finding instead of two ~equal ones.
+    if (prefixResult.length <= 1)
+        return prefixResult;
+    const traceNodeSets = prefixResult.map(f => {
+        const ids = new Set();
+        for (const step of f.trace) {
+            ids.add(step.nodeId);
+        }
+        return ids;
+    });
+    const absorbed = new Set();
+    for (let i = 0; i < prefixResult.length; i++) {
+        if (absorbed.has(i))
+            continue;
+        for (let j = i + 1; j < prefixResult.length; j++) {
+            if (absorbed.has(j))
+                continue;
+            const a = prefixResult[i].node;
+            const b = prefixResult[j].node;
+            const related = isDominatorAncestor(a, b) ||
+                isDominatorAncestor(b, a) ||
+                traceNodeSets[i].has(b.id) ||
+                traceNodeSets[j].has(a.id);
+            if (!related)
+                continue;
+            // Keep the larger-retained finding as representative.
+            const keepIdx = a.retainedSize >= b.retainedSize ? i : j;
+            const dropIdx = keepIdx === i ? j : i;
+            const siblings = prefixResult[keepIdx].collapsed_siblings ?? [];
+            siblings.push(prefixResult[dropIdx]);
+            siblings.push(...(prefixResult[dropIdx].collapsed_siblings ?? []));
+            prefixResult[keepIdx].collapsed_siblings = siblings;
+            absorbed.add(dropIdx);
+            if (dropIdx === i)
+                break; // i itself was absorbed; advance outer loop
+        }
+    }
+    return prefixResult.filter((_, idx) => !absorbed.has(idx));
 }
 function formatTrace(trace, maxSteps) {
     const collapsed = [];
@@ -420,6 +615,533 @@ function formatTrace(trace, maxSteps) {
     }
     return parts.join('\n  → ');
 }
+function computeTraceOverlap(a, b) {
+    let prefixLen = 0;
+    const minLen = Math.min(a.length, b.length);
+    for (let i = 0; i < minLen; i++) {
+        if (a[i].nodeId === b[i].nodeId) {
+            prefixLen++;
+        }
+        else {
+            break;
+        }
+    }
+    return { prefixLen, matchIndex: -1 };
+}
+function findBestTraceMatch(trace, previousTraces) {
+    let bestMatch = null;
+    for (let j = 0; j < previousTraces.length; j++) {
+        const { prefixLen } = computeTraceOverlap(trace, previousTraces[j]);
+        if (prefixLen > trace.length * 0.5) {
+            if (!bestMatch || prefixLen > bestMatch.prefixLen) {
+                bestMatch = { matchedIndex: j, prefixLen };
+            }
+        }
+    }
+    return bestMatch;
+}
+function detectAsyncContextLeaks(findings) {
+    const alerts = [];
+    const seen = new Set();
+    for (const f of findings) {
+        const traceNames = f.trace.map(s => s.name);
+        const traceEdges = f.trace.map(s => s.edgeName ?? '');
+        // Pattern 1: TCP/Socket → kResourceStore → afterContext (Next.js request context leak)
+        const hasTCP = traceNames.some(n => n === 'TCP' || n === 'Socket' || n.includes('TCP'));
+        const hasResourceStore = traceEdges.some(e => e === 'kResourceStore' || e === 'resource_symbol');
+        const hasAfterContext = traceEdges.some(e => e === 'afterContext');
+        const hasOnClose = traceEdges.some(e => e === 'onClose');
+        const hasContext = traceNames.some(n => n === 'system / Context' || n.startsWith('system /'));
+        if (hasTCP &&
+            hasResourceStore &&
+            (hasAfterContext || hasOnClose) &&
+            hasContext &&
+            !seen.has('tcp-als')) {
+            seen.add('tcp-als');
+            alerts.push(`🔴 **[CRITICAL] AsyncLocalStorage context retained by TCP connection**\n` +
+                `A TCP socket's async context chain retains ${formatBytes(f.node.retainedSize)} of request-scoped data. ` +
+                `The \`onClose\` closure captures the request's AsyncLocalStorage context, which chains to prior contexts via \`previous\` pointers.\n` +
+                `**Fix:** Ensure response bodies are fully consumed/canceled (check \`resp.body.cancel()\`), ` +
+                `or avoid capturing large data in request-scoped closures.`);
+        }
+        // Pattern 2: Generator.parameters_and_registers holding large arrays (Undici response body retention)
+        const hasGenerator = traceNames.some(n => n === 'Generator' || n.includes('Generator'));
+        const hasParamsAndRegisters = traceEdges.some(e => e === 'parameters_and_registers');
+        if (hasGenerator &&
+            hasParamsAndRegisters &&
+            f.node.retainedSize > 1024 * 1024 &&
+            !seen.has('generator-undici')) {
+            seen.add('generator-undici');
+            alerts.push(`🟠 **[HIGH] Generator retaining large data via \`parameters_and_registers\`**\n` +
+                `A Generator object holds ${formatBytes(f.node.retainedSize)} through its parameters/registers. ` +
+                `This is a common Undici pattern where an async generator (response body stream) retains the full response buffer.\n` +
+                `**Fix:** Ensure response bodies are fully read and the stream is closed/destroyed after use. ` +
+                `For fetch(), always call \`resp.text()\`, \`resp.json()\`, or \`resp.body.cancel()\`.`);
+        }
+        // Pattern 3: PromiseReaction chains with large retained sizes (unresolved/leaked promises)
+        const hasPromiseReaction = traceNames.some(n => n === 'PromiseReaction' || n === 'Promise');
+        const hasReactionEdge = traceEdges.some(e => e === 'reactions_or_result' ||
+            e === 'fulfill_handler' ||
+            e === 'reject_handler');
+        if (hasPromiseReaction &&
+            hasReactionEdge &&
+            f.node.retainedSize > 5 * 1024 * 1024 &&
+            !seen.has('promise-chain')) {
+            seen.add('promise-chain');
+            alerts.push(`🟠 **[HIGH] Unresolved Promise chain retaining ${formatBytes(f.node.retainedSize)}**\n` +
+                `A PromiseReaction chain is keeping large data alive. This often indicates a stuck async operation ` +
+                `(HTTP request, DB query, timer) whose promise was never resolved or rejected.\n` +
+                `**Fix:** Add timeouts to async operations. Check for \`await\` on promises that may never resolve. ` +
+                `Ensure \`.catch()\` handlers don't capture the entire response.`);
+        }
+        // Pattern 4: Undici Client/Pool response retention (Feedback #6)
+        const hasUndiciClient = traceNames.some(n => n === 'Client' || n === 'Pool' || n === 'Agent');
+        const hasRequestQueue = traceEdges.some(e => e === 'requests' || e === 'queue' || e === 'pending' || e === 'running');
+        if (hasUndiciClient &&
+            hasRequestQueue &&
+            f.node.retainedSize > 1024 * 1024 &&
+            !seen.has('undici-client')) {
+            seen.add('undici-client');
+            alerts.push(`🟠 **[HIGH] Undici HTTP Client/Pool retaining ${formatBytes(f.node.retainedSize)} via request queue**\n` +
+                `An Undici Client or Pool object is keeping response data alive through its request queue or closure chain. ` +
+                `This typically happens when HTTP response bodies are not fully consumed or canceled.\n` +
+                `**Fix:** Always consume or cancel response bodies: \`await resp.text()\`, \`resp.body.cancel()\`, ` +
+                `or \`resp.body.destroy()\`. For streaming responses, ensure the readable stream is fully drained.`);
+        }
+        // Pattern 5: mysql2 Connection retaining large data (Feedback #8)
+        const hasMysqlConn = traceNames.some(n => n === 'Connection' ||
+            n === 'PoolConnection' ||
+            n === 'PromiseConnection');
+        const hasMysqlEdge = traceEdges.some(e => e === '_protocol' || e === '_statements' || e === 'connectionConfig');
+        if (hasMysqlConn &&
+            hasMysqlEdge &&
+            f.node.retainedSize > 5 * 1024 * 1024 &&
+            !seen.has('mysql2-conn')) {
+            seen.add('mysql2-conn');
+            alerts.push(`🟠 **[HIGH] mysql2 Connection retaining ${formatBytes(f.node.retainedSize)}**\n` +
+                `A mysql2 Connection object is keeping query results or protocol buffers alive, often through ` +
+                `error event handler closure chains or unreleased prepared statements.\n` +
+                `**Fix:** Set pool \`idleTimeout\` (e.g., 60000ms) to free idle connections. ` +
+                `Ensure query result rows are not captured in long-lived closures. ` +
+                `Consider \`stream()\` instead of \`query()\` for large result sets.`);
+        }
+    }
+    return alerts;
+}
+// Framework class-name signatures. These are scanned heap-wide (not just along
+// the top retainer traces) because framework internals frequently accumulate
+// across many small objects that never surface as a single "top retained
+// object" — yet are high-signal root causes (Feedback §2b).
+const OTEL_METRIC_CLASSES = new Set([
+    'SyncMetricStorage',
+    'AsyncMetricStorage',
+    'TemporalMetricProcessor',
+    'DeltaMetricProcessor',
+    'AttributeHashMap',
+    'HashMap',
+    'MetricStorageRegistry',
+]);
+const RELAY_STORE_CLASSES = new Set([
+    'RelayModernStore',
+    'RelayRecordSource',
+    'RecordSource',
+    'RelayModernRecord',
+    'RelayReader',
+    'DataChecker',
+]);
+function mapEntryCount(node) {
+    for (const edge of node.references) {
+        const n = String(edge.name_or_index);
+        if ((n === 'table' || n === 'backing_store') &&
+            (edge.toNode.type === 'array' || edge.toNode.type === 'hidden')) {
+            return edge.toNode.edge_count;
+        }
+    }
+    return node.edge_count;
+}
+// In-process source-map caches (@jridgewell/trace-mapping). These decode huge
+// nested mapping arrays for stack-trace symbolication and are a recurring
+// top-retainer across the Nest SSR fleet (Feedback round 3 §2a).
+const SOURCEMAP_CLASSES = new Set(['TraceMap', 'AnyMap', 'SourceMapConsumer']);
+function detectFrameworkLeaks(snapshot, totalSize) {
+    const alerts = [];
+    const otel = new Map();
+    const relay = new Map();
+    const sourceMaps = {
+        count: 0,
+        totalRetained: 0,
+        decodedRetained: 0,
+        encodedRetained: 0,
+        sourcesContentRetained: 0,
+        exampleId: 0,
+        exampleRetained: 0,
+    };
+    let topGenerator = null;
+    let generatorCount = 0;
+    const accumulate = (map, node, entries) => {
+        const e = map.get(node.name);
+        if (e) {
+            e.count++;
+            e.totalRetained += node.retainedSize;
+            e.maxEntries = Math.max(e.maxEntries, entries);
+            if (node.retainedSize >
+                (snapshot.getNodeById(e.exampleId)?.retainedSize ?? 0)) {
+                e.exampleId = node.id;
+            }
+        }
+        else {
+            map.set(node.name, {
+                count: 1,
+                totalRetained: node.retainedSize,
+                exampleId: node.id,
+                maxEntries: entries,
+            });
+        }
+    };
+    snapshot.nodes.forEach(node => {
+        if (node.id <= 3)
+            return;
+        if (OTEL_METRIC_CLASSES.has(node.name) && node.type === 'object') {
+            // Find the largest child Map/HashMap (the attribute->aggregation table).
+            let entries = 0;
+            for (const edge of node.references) {
+                const t = edge.toNode;
+                if (t.name === 'Map' || t.name === 'HashMap' || t.name === 'Set') {
+                    entries = Math.max(entries, mapEntryCount(t));
+                }
+            }
+            accumulate(otel, node, entries);
+        }
+        if (RELAY_STORE_CLASSES.has(node.name) && node.type === 'object') {
+            accumulate(relay, node, mapEntryCount(node));
+        }
+        if (SOURCEMAP_CLASSES.has(node.name) && node.type === 'object') {
+            sourceMaps.count++;
+            sourceMaps.totalRetained += node.retainedSize;
+            if (node.retainedSize > sourceMaps.exampleRetained) {
+                sourceMaps.exampleRetained = node.retainedSize;
+                sourceMaps.exampleId = node.id;
+            }
+            for (const edge of node.references) {
+                if (edge.type !== 'property')
+                    continue;
+                const p = String(edge.name_or_index);
+                if (p === '_decoded') {
+                    sourceMaps.decodedRetained += edge.toNode.retainedSize;
+                }
+                else if (p === '_encoded') {
+                    sourceMaps.encodedRetained += edge.toNode.retainedSize;
+                }
+                else if (p === 'sourcesContent') {
+                    sourceMaps.sourcesContentRetained += edge.toNode.retainedSize;
+                }
+            }
+        }
+        if (node.name === 'Generator' &&
+            node.type === 'object' &&
+            node.retainedSize > 1024 * 1024) {
+            generatorCount++;
+            if (!topGenerator || node.retainedSize > topGenerator.retained) {
+                topGenerator = { id: node.id, retained: node.retainedSize };
+            }
+        }
+    });
+    // OpenTelemetry metric cardinality explosion.
+    const otelTotal = [...otel.values()].reduce((s, e) => s + e.totalRetained, 0);
+    const otelMaxEntries = Math.max(0, ...[...otel.values()].map(e => e.maxEntries));
+    if (otel.size > 0 &&
+        (otelTotal > 5 * 1024 * 1024 ||
+            (totalSize > 0 && otelTotal > totalSize * 0.03) ||
+            otelMaxEntries >= 1000)) {
+        const top = [...otel.entries()]
+            .sort((a, b) => b[1].totalRetained - a[1].totalRetained)
+            .slice(0, 3)
+            .map(([name, e]) => `${name} (${formatNumber(e.count)}×, ${formatBytes(e.totalRetained)}${e.maxEntries > 0 ? `, up to ${formatNumber(e.maxEntries)} attribute keys` : ''}, e.g. @${e.exampleId})`)
+            .join('; ');
+        alerts.push(`🔴 **[CRITICAL] OpenTelemetry metric cardinality explosion**\n` +
+            `OTel metric-storage internals retain ${formatBytes(otelTotal)} via per-attribute aggregation maps: ${top}.\n` +
+            `This is the classic Node OTel footgun: a high-cardinality attribute (request id, full URL with ids, user id) is used as a metric dimension, so each distinct value allocates a new aggregation in the \`AttributeHashMap\` / \`_valueMap\`.\n` +
+            `**Confirm:** \`memlab_property_distribution\` on the metric attribute shape, or \`memlab_search_strings\` for the serialized attribute keys (e.g. \`[["http.route","/x/<uuid>"]]\`).\n` +
+            `**Fix:** remove or bucket high-cardinality attributes (template the route: \`/artifact/:id\`), or add an allowed-attributes view so unbounded dimensions never enter the metric.`);
+    }
+    // Relay store growth.
+    const relayTotal = [...relay.values()].reduce((s, e) => s + e.totalRetained, 0);
+    if (relay.size > 0 &&
+        (relayTotal > 5 * 1024 * 1024 ||
+            (totalSize > 0 && relayTotal > totalSize * 0.05))) {
+        const top = [...relay.entries()]
+            .sort((a, b) => b[1].totalRetained - a[1].totalRetained)
+            .slice(0, 3)
+            .map(([name, e]) => `${name} (${formatNumber(e.count)}×, ${formatBytes(e.totalRetained)}, e.g. @${e.exampleId})`)
+            .join('; ');
+        alerts.push(`🟠 **[HIGH] Relay store retaining ${formatBytes(relayTotal)}**\n` +
+            `Relay record source/store internals are holding a large normalized cache: ${top}.\n` +
+            `**Fix:** ensure queries are disposed/GC'd (check \`retain()\` without matching \`dispose()\`), enable store garbage collection (\`gcReleaseBufferSize\`), or scope long-lived environments per request instead of a single global store.`);
+    }
+    // In-process source-map / symbolicator caches.
+    if (sourceMaps.count > 0 &&
+        (sourceMaps.totalRetained > 2 * 1024 * 1024 ||
+            (totalSize > 0 && sourceMaps.totalRetained > totalSize * 0.03))) {
+        const parts = [];
+        if (sourceMaps.decodedRetained > 0) {
+            parts.push(`_decoded ${formatBytes(sourceMaps.decodedRetained)}`);
+        }
+        if (sourceMaps.encodedRetained > 0) {
+            parts.push(`_encoded ${formatBytes(sourceMaps.encodedRetained)}`);
+        }
+        if (sourceMaps.sourcesContentRetained > 0) {
+            parts.push(`sourcesContent ${formatBytes(sourceMaps.sourcesContentRetained)}`);
+        }
+        const split = parts.length > 0 ? ` (${parts.join(', ')})` : '';
+        alerts.push(`🟠 **[HIGH] In-process source-map cache retaining ${formatBytes(sourceMaps.totalRetained)}**\n` +
+            `${formatNumber(sourceMaps.count)} \`TraceMap\`/source-map object(s) (\`@jridgewell/trace-mapping\`) are cached in-process for stack-trace symbolication${split}. Largest: @${sourceMaps.exampleId}. ` +
+            `The decoded mappings (\`_decoded\`) are huge nested arrays; on the Nest SSR fleet these are typically held by the OTel structured logger, the patched console, or a \`beforeExit\` closure.\n` +
+            `**Inspect:** \`memlab_dominator_subtree(${sourceMaps.exampleId})\` to see the decoded arrays; \`memlab_retainer_trace(${sourceMaps.exampleId})\` for who holds the cache.\n` +
+            `**Fix:** strip \`sourcesContent\` from the maps, cap/evict the symbolication cache, or move symbolication out-of-process. Every Nest server that symbolicates errors in-process hits this.`);
+    }
+    // Suspended async functions (generators) retaining large locals.
+    if (topGenerator) {
+        const g = topGenerator;
+        alerts.push(`🟠 **[HIGH] Suspended async function retaining ${formatBytes(g.retained)}**\n` +
+            `${formatNumber(generatorCount)} generator/async frame(s) >1 MB are parked mid-\`await\`, keeping their local variables (response buffers, accumulated rows) alive while the awaited resource never settles. Largest: @${g.id}.\n` +
+            `**Inspect:** \`memlab_closure_inspection(${g.id})\` resolves the frame's \`parameters_and_registers\` to source variable names.\n` +
+            `**Fix:** add timeouts/cancellation to the awaited operation; fully consume or cancel streamed response bodies (\`await resp.text()\` / \`resp.body.cancel()\`); avoid capturing whole datasets in the async frame.`);
+    }
+    return alerts;
+}
+/**
+ * Classify the long-lived GC root a closure hangs off of, by scanning its
+ * retainer path for the high-signal structures that pin request-scoped data for
+ * a connection/process lifetime (Feedback round 3 §2b/§2c).
+ */
+function classifyLongLivedHolder(trace) {
+    for (const s of trace) {
+        const n = s.name;
+        const e = s.edgeName ?? '';
+        if (n === 'Timeout' ||
+            n === 'TimersList' ||
+            e === '_onTimeout' ||
+            e === '_idleNext' ||
+            e === '_repeat') {
+            return 'setInterval/setTimeout timer';
+        }
+        if (e === 'onClose')
+            return 'onClose handler';
+        if (n === 'TCP' || n === 'Socket' || n === 'ReusedHandle') {
+            return 'keep-alive socket';
+        }
+        if (e === 'kResourceStore' ||
+            e === 'resource_symbol' ||
+            /AsyncLocalStorage/.test(n)) {
+            return 'AsyncLocalStorage store';
+        }
+        if (e === '_events' || /EventEmitter/.test(n))
+            return 'EventEmitter listener';
+        if (e === 'signal' || n === 'AbortSignal')
+            return 'AbortSignal listener';
+    }
+    return null;
+}
+/**
+ * Find the single largest variable a closure/context captures — the dominant
+ * captured scope member, which is usually what makes an oversized handler
+ * closure expensive.
+ */
+function dominantCapturedVar(closure) {
+    let ctx = null;
+    for (const edge of closure.references) {
+        if ((edge.type === 'internal' || edge.type === 'context') &&
+            String(edge.name_or_index) === 'context') {
+            ctx = edge.toNode;
+            break;
+        }
+    }
+    let best = null;
+    const consider = (node) => {
+        for (const edge of node.references) {
+            if (edge.type !== 'context' && edge.type !== 'property')
+                continue;
+            const name = String(edge.name_or_index);
+            if (name === 'previous' || name === 'native_context')
+                continue;
+            const t = edge.toNode;
+            if (t.id <= 3)
+                continue;
+            if (!best || t.retainedSize > best.retained) {
+                best = { name, retained: t.retainedSize, targetName: t.name };
+            }
+        }
+    };
+    consider(closure);
+    if (ctx)
+        consider(ctx);
+    return best;
+}
+/**
+ * Proactively surface the most common Node server leak shape this round: a
+ * long-lived closure (setInterval/onClose/listener) that captures a large
+ * variable it barely uses, pinning it for the connection/process lifetime.
+ * `closure_inspection` already computes the per-variable breakdown — this just
+ * flags the handler closures so the model doesn't have to suspect them first
+ * (Feedback round 3 §2b).
+ */
+function scanOversizedClosures(snapshot, totalSize) {
+    const closureMin = Math.max(1024 * 1024, totalSize > 0 ? totalSize * 0.02 : 0);
+    const candidates = [];
+    snapshot.nodes.forEach(node => {
+        if (node.type !== 'closure' || node.id <= 3)
+            return;
+        if (node.retainedSize < closureMin)
+            return;
+        candidates.push(node);
+    });
+    candidates.sort((a, b) => b.retainedSize - a.retainedSize);
+    const alerts = [];
+    const seen = new Set();
+    for (const closure of candidates.slice(0, 30)) {
+        const trace = getRetainerPath(closure);
+        const holder = classifyLongLivedHolder(trace);
+        if (!holder)
+            continue;
+        const dom = dominantCapturedVar(closure);
+        const key = `${holder}|${dom?.name ?? ''}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const domStr = dom
+            ? ` Its largest captured variable is \`${dom.name}\` → ${dom.targetName} (${formatBytes(dom.retained)})` +
+                (dom.retained > closure.retainedSize * 0.6
+                    ? ' — the bulk of the retention, and quite possibly captured but barely used.'
+                    : '.')
+            : '';
+        alerts.push(`🟠 **[HIGH] Oversized closure on a long-lived ${holder} retaining ${formatBytes(closure.retainedSize)}**\n` +
+            `Closure @${closure.id}${closure.name ? ` \`${truncateNodeName(closure.name, closure.type, closure.self_size, 40)}\`` : ''} is reachable from a ${holder} and keeps its captured scope alive for that root's lifetime.${domStr}\n` +
+            `**Inspect:** \`memlab_closure_inspection(${closure.id}, {min_retained_size: 102400})\` for the full per-variable capture breakdown.\n` +
+            `**Fix:** extract only the fields the callback needs before registering it (don't close over the whole request scope / serialized blob), or clear the timer / unregister the listener when the request or connection ends.`);
+        if (alerts.length >= 5)
+            break;
+    }
+    return alerts;
+}
+// Keys that mark a record as a log/conversation/message entry. An append-only
+// accumulation of these is a runaway-appender signature (Feedback round 3 §2d).
+const MESSAGE_RECORD_KEYS = new Set([
+    'role',
+    'content',
+    'message',
+    'msg',
+    'timestamp',
+    'ts',
+    'level',
+    'type',
+    'text',
+]);
+// Fields whose value usually discriminates the record kind, used to test
+// whether a few values repeat across most records.
+const DISCRIMINATOR_KEYS = ['role', 'level', 'type', 'message', 'msg'];
+/**
+ * A property whose value is expected to be unique per record. If such a field
+ * has far fewer distinct values than instances, the SAME records are retained
+ * multiple times (Feedback round 3 §1b).
+ */
+function looksUniqueKey(name) {
+    return (/^(id|_id|uuid|guid|key|hash|sku|pk|cursor|etag)$/i.test(name) ||
+        /(_id|Id|Key|Uuid|Guid|Hash)$/.test(name));
+}
+/**
+ * Detect append-only logs/conversations: a very high count of a uniform record
+ * shape dominated by a few repeated field values (e.g. 696K `{role, content,
+ * timestamp}` objects from a scheduler that re-appends the same system/error
+ * message forever). `growth_signals` misses these because they aren't keyed the
+ * way its heuristic expects (Feedback round 3 §2d).
+ */
+function scanAppendOnlyRecords(snapshot, totalSize) {
+    const shapeMap = new Map();
+    snapshot.nodes.forEach(node => {
+        if (node.type !== 'object' || node.id <= 3)
+            return;
+        if (node.name !== 'Object')
+            return;
+        const names = [];
+        for (const edge of node.references) {
+            if (edge.type === 'property')
+                names.push(String(edge.name_or_index));
+        }
+        if (names.length === 0 || names.length > 12)
+            return;
+        if (!names.some(n => MESSAGE_RECORD_KEYS.has(n.toLowerCase())))
+            return;
+        names.sort();
+        const key = names.join(',');
+        const ex = shapeMap.get(key);
+        if (ex) {
+            ex.count++;
+            ex.totalSelfSize += node.self_size;
+            if (ex.exampleIds.length < 100)
+                ex.exampleIds.push(node.id);
+        }
+        else {
+            shapeMap.set(key, {
+                properties: names,
+                count: 1,
+                totalSelfSize: node.self_size,
+                exampleNodeId: node.id,
+                exampleIds: [node.id],
+            });
+        }
+    });
+    const hits = [...shapeMap.values()]
+        .filter(s => s.count >= 50_000)
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 3);
+    const alerts = [];
+    for (const s of hits) {
+        // Test a discriminator field for value concentration over the sample.
+        const field = DISCRIMINATOR_KEYS.find(k => s.properties.includes(k)) ?? null;
+        let concentration = '';
+        if (field) {
+            const freq = new Map();
+            let sampled = 0;
+            for (const id of s.exampleIds) {
+                const node = snapshot.getNodeById(id);
+                if (!node)
+                    continue;
+                for (const edge of node.references) {
+                    if (edge.type === 'property' &&
+                        String(edge.name_or_index) === field) {
+                        let val = edge.toNode.name;
+                        if (edge.toNode.isString) {
+                            const sn = edge.toNode.toStringNode();
+                            if (sn)
+                                val = sn.stringValue;
+                        }
+                        freq.set(val, (freq.get(val) ?? 0) + 1);
+                        sampled++;
+                        break;
+                    }
+                }
+            }
+            if (sampled > 0) {
+                const top = [...freq.entries()].sort((a, b) => b[1] - a[1])[0];
+                if (top) {
+                    const pct = ((top[1] / sampled) * 100).toFixed(0);
+                    const valDisp = top[0].length > 40 ? top[0].slice(0, 40) + '…' : top[0];
+                    concentration = ` The \`${field}\` field is dominated by one value ("${valDisp}", ${pct}% of sampled records) — a strong append-only signature.`;
+                }
+            }
+        }
+        const pctHeap = totalSize > 0
+            ? ` (${((s.totalSelfSize / totalSize) * 100).toFixed(1)}% of heap self size)`
+            : '';
+        const propsDisplay = s.properties.length <= 6
+            ? `{${s.properties.join(', ')}}`
+            : `{${s.properties.slice(0, 5).join(', ')}, … +${s.properties.length - 5}}`;
+        alerts.push(`🟠 **[HIGH] Append-only record accumulation — ${formatNumber(s.count)}× ${propsDisplay}**\n` +
+            `${formatNumber(s.count)} uniform message/log records (${formatBytes(s.totalSelfSize)} self${pctHeap}, example @${s.exampleNodeId}).${concentration}\n` +
+            `**Fix:** bound the conversation/log history (ring buffer, max length, or periodic flush). Check for a scheduler/retry loop that re-appends the same system or error message without ever trimming.`);
+    }
+    return alerts;
+}
 export function registerAutoInvestigate(server) {
     server.tool('memlab_auto_investigate', 'One-shot deep analysis: finds the top retained objects, traces each retainer chain to the GC root, identifies pinch points (small objects retaining large subtrees), and detects unbounded caches. Returns a structured report with root causes and suggested fixes. Use this as the first tool after loading a snapshot to get immediate actionable findings.', {
         top_n: z
@@ -482,8 +1204,13 @@ export function registerAutoInvestigate(server) {
                     topPending: [],
                 };
             const shapes = focus === 'all' ? scanTopShapes(snapshot, 5) : [];
-            const subscriptions = focus === 'all' ? scanSubscriptionAccumulation(snapshot, 1000) : [];
+            const subscriptions = focus === 'all'
+                ? scanSubscriptionAccumulation(snapshot, 1000, totalSize)
+                : [];
             const errorAccum = focus === 'all' ? scanErrorAccumulation(snapshot, 10) : [];
+            const distributed = focus === 'all'
+                ? scanDistributedAccumulation(snapshot, totalSize)
+                : [];
             const lines = [`# Auto-Investigation Report`, ''];
             const focusLabel = focus === 'all' ? '' : ` (focus: ${focus})`;
             lines.push(`## Top ${findings.length} Retained Objects${focusLabel}`);
@@ -504,13 +1231,17 @@ export function registerAutoInvestigate(server) {
                     }
                 }
             }
+            const previousTraces = [];
             for (let i = 0; i < findings.length; i++) {
                 const f = findings[i];
                 const siblings = f.collapsed_siblings ?? [];
-                const totalRetained = f.node.retainedSize +
-                    siblings.reduce((s, sib) => s + sib.node.retainedSize, 0);
+                // Dominator-aware combined size: members on the same chain overlap,
+                // so we must not sum their retained sizes (that produced the old
+                // ">100% of heap" bug). combinedRetainedSize() keeps only
+                // dominator-maximal members.
+                const totalRetained = combinedRetainedSize([f.node, ...siblings.map(s => s.node)], snapshot);
                 const pct = totalSize > 0
-                    ? ` (${((totalRetained / totalSize) * 100).toFixed(1)}% of heap)`
+                    ? ` (${Math.min(100, (totalRetained / totalSize) * 100).toFixed(1)}% of heap)`
                     : '';
                 const name = truncateNodeName(f.node.name, f.node.type, f.node.self_size, 60);
                 const sevIcon = f.severity === 'CRITICAL'
@@ -520,21 +1251,48 @@ export function registerAutoInvestigate(server) {
                         : f.severity === 'MEDIUM'
                             ? '🟡'
                             : '🔵';
+                // Check if this finding's trace shares a common prefix with a previous one
+                const traceMatch = i > 0 ? findBestTraceMatch(f.trace, previousTraces) : null;
                 if (siblings.length > 0) {
-                    lines.push(`### ${i + 1}. ${sevIcon} [${f.severity}] \`${name}\` chain — ${formatBytes(totalRetained)} total across ${1 + siblings.length} nodes${pct}`);
+                    lines.push(`### ${i + 1}. ${sevIcon} [${f.severity}] \`${name}\` — ${formatBytes(totalRetained)} retained, same subtree reached via ${1 + siblings.length} retainer(s)${pct}`);
                     lines.push('');
-                    lines.push(`**Retainer chain:** ${formatTrace(f.trace, 8)}`);
+                    if (traceMatch) {
+                        const divergeStep = f.trace[traceMatch.prefixLen];
+                        const divergeEdge = divergeStep?.edgeName ?? '…';
+                        const divergeName = divergeStep
+                            ? truncateNodeName(divergeStep.name, divergeStep.type, divergeStep.selfSize, 40)
+                            : '…';
+                        lines.push(`**Retainer chain:** (same chain as #${traceMatch.matchedIndex + 1}) → [${divergeEdge}] ${divergeName} — ${formatBytes(f.node.retainedSize)}`);
+                    }
+                    else {
+                        lines.push(`**Retainer chain:** ${formatTrace(f.trace, 8)}`);
+                    }
                     lines.push('');
-                    lines.push(`**Same chain contains:** @${f.node.id} (${formatBytes(f.node.retainedSize)})` +
+                    lines.push(`**Alternate retainers of the same subtree** (retained sizes overlap — not additive): @${f.node.id} (${formatBytes(f.node.retainedSize)})` +
                         siblings
                             .map(sib => `, @${sib.node.id} ${truncateNodeName(sib.node.name, sib.node.type, sib.node.self_size, 30)} (${formatBytes(sib.node.retainedSize)})`)
                             .join(''));
                 }
+                else if (traceMatch) {
+                    const divergeStep = f.trace[traceMatch.prefixLen];
+                    const divergeEdge = divergeStep?.edgeName ?? '…';
+                    const divergeName = divergeStep
+                        ? truncateNodeName(divergeStep.name, divergeStep.type, divergeStep.selfSize, 40)
+                        : '…';
+                    lines.push(`### ${i + 1}. ${sevIcon} [${f.severity}] @${f.node.id} \`${name}\` (${f.node.type}) — ${formatBytes(f.node.retainedSize)}${pct}`);
+                    lines.push('');
+                    lines.push(`**Retainer chain:** (same chain as #${traceMatch.matchedIndex + 1}) → [${divergeEdge}] ${divergeName} — ${formatBytes(f.node.retainedSize)}`);
+                }
                 else {
                     lines.push(`### ${i + 1}. ${sevIcon} [${f.severity}] @${f.node.id} \`${name}\` (${f.node.type}) — ${formatBytes(f.node.retainedSize)}${pct}`);
                     lines.push('');
                     lines.push(`**Retainer chain:** ${formatTrace(f.trace, 8)}`);
                 }
+                previousTraces.push(f.trace);
+                const instrNote = instrumentationRetainerNote(f.trace);
+                if (instrNote) {
+                    lines.push(`> ⚠ ${instrNote}`);
+                }
                 lines.push('');
                 if (f.pinchPoint) {
                     const pp = f.pinchPoint;
@@ -558,8 +1316,20 @@ export function registerAutoInvestigate(server) {
                 lines.push('## Shared Pinch Points');
                 lines.push('');
                 for (const { pp, findingIndices } of sharedPinchPoints) {
+                    const ppNode = snapshot.getNodeById(pp.nodeId);
                     const ppName = truncateNodeName(pp.name, pp.type, pp.selfSize, 50);
                     lines.push(`- @${pp.nodeId} \`${ppName}\` — self: ${formatBytes(pp.selfSize)}, retains: ${formatBytes(pp.retainedSize)} (${formatNumber(Math.round(pp.ratio))}:1 ratio). Shared by findings ${findingIndices.map(j => `#${j + 1}`).join(', ')}. Freeing this single object would reclaim ${formatBytes(pp.retainedSize)}.`);
+                    if (ppNode) {
+                        const topProps = [];
+                        for (const edge of ppNode.references) {
+                            if (edge.type === 'property' && topProps.length < 5) {
+                                topProps.push(String(edge.name_or_index));
+                            }
+                        }
+                        if (topProps.length > 0) {
+                            lines.push(`  Properties: {${topProps.join(', ')}${ppNode.edge_count > 5 ? ', …' : ''}}`);
+                        }
+                    }
                 }
                 lines.push('');
             }
@@ -607,6 +1377,154 @@ export function registerAutoInvestigate(server) {
                 }
                 lines.push('', '_Use `memlab_shape_histogram` for full shape analysis with retained sizes._');
                 lines.push('');
+                // Feedback #4: Low-cardinality column detection
+                // Feedback #8: High-cost unique property detection
+                // Feedback round 3 §1b: same-object duplication detection
+                // For large shapes (>10K instances), sample property value cardinality
+                const columnAlerts = [];
+                const duplicationAlerts = [];
+                const dupShapesSeen = new Set();
+                // Pre-bucket: collect qualifying shape keys, then single-pass scan
+                const qualifyingShapes = shapes.filter(s => {
+                    if (s.count < 10_000)
+                        return false;
+                    return !!snapshot.getNodeById(s.exampleNodeId);
+                });
+                const shapeBuckets = new Map();
+                for (const s of qualifyingShapes) {
+                    shapeBuckets.set(s.properties.join(','), []);
+                }
+                if (shapeBuckets.size > 0) {
+                    const maxSamples = 200;
+                    snapshot.nodes.forEach(node => {
+                        if (node.type !== 'object' || node.id <= 3)
+                            return;
+                        if (node.name !== 'Object')
+                            return;
+                        const props = [];
+                        for (const edge of node.references) {
+                            if (edge.type === 'property') {
+                                props.push(String(edge.name_or_index));
+                            }
+                        }
+                        props.sort();
+                        const key = props.join(',');
+                        const bucket = shapeBuckets.get(key);
+                        if (bucket && bucket.length < maxSamples) {
+                            bucket.push(node);
+                        }
+                    });
+                }
+                for (const s of qualifyingShapes) {
+                    const sampleNodes = shapeBuckets.get(s.properties.join(',')) ?? [];
+                    if (sampleNodes.length < 50)
+                        continue;
+                    // Analyze each property's cardinality and value characteristics
+                    for (const propName of s.properties) {
+                        const values = new Set();
+                        let totalValueSize = 0;
+                        let stringValueCount = 0;
+                        let allUnique = true;
+                        for (const node of sampleNodes) {
+                            for (const edge of node.references) {
+                                if (edge.type === 'property' &&
+                                    String(edge.name_or_index) === propName) {
+                                    const target = edge.toNode;
+                                    let val = target.name;
+                                    if (target.isString) {
+                                        const strNode = target.toStringNode();
+                                        if (strNode)
+                                            val = strNode.stringValue;
+                                        stringValueCount++;
+                                        totalValueSize += target.self_size;
+                                    }
+                                    if (values.has(val))
+                                        allUnique = false;
+                                    values.add(val);
+                                    break;
+                                }
+                            }
+                        }
+                        const cardinality = values.size;
+                        const sampleCount = sampleNodes.length;
+                        const uniqueKey = looksUniqueKey(propName);
+                        const shapeKey = s.properties.join(',');
+                        // Same-object duplication vs genuine low cardinality (§1b): a field
+                        // that *should* be unique per record but has far fewer distinct
+                        // values than sampled instances means the SAME records are retained
+                        // N times — a retention/concurrency fix, not interning.
+                        if (uniqueKey &&
+                            sampleCount >= 100 &&
+                            cardinality >= 1 &&
+                            cardinality < sampleCount * 0.6 &&
+                            !dupShapesSeen.has(shapeKey)) {
+                            const dupFactor = Math.round(sampleCount / Math.max(1, cardinality));
+                            if (dupFactor >= 2) {
+                                dupShapesSeen.add(shapeKey);
+                                duplicationAlerts.push(`- \`${propName}\` (a unique-looking key) has only **${formatNumber(cardinality)} distinct value(s)** across ${formatNumber(sampleCount)} sampled of ${formatNumber(s.count)} total \`{${s.properties.slice(0, 4).join(', ')}${s.properties.length > 4 ? ', …' : ''}}\` instances — looks like **~${dupFactor} retained copies of the same records**, not a low-cardinality column. Investigate **retention/concurrency** (e.g. many concurrent requests each holding a full copy of this dataset), NOT string interning.`);
+                            }
+                        }
+                        else if (!uniqueKey &&
+                            cardinality <= 20 &&
+                            sampleCount >= 100) {
+                            // Genuine low-cardinality column.
+                            columnAlerts.push(`- Property \`${propName}\` has only **${cardinality} unique value(s)** across ${formatNumber(s.count)} instances — low-cardinality column suitable for pre-filtering at the data source or string interning`);
+                        }
+                        // High-cost unique: all values unique, string, large average size
+                        if (allUnique &&
+                            stringValueCount > sampleCount * 0.8 &&
+                            cardinality > sampleCount * 0.9) {
+                            const avgSize = totalValueSize / stringValueCount;
+                            if (avgSize > 50 && s.count > 10_000) {
+                                const estimatedWaste = avgSize * s.count;
+                                columnAlerts.push(`- Property \`${propName}\` has **all unique string values** (avg ${Math.round(avgSize)}B each × ${formatNumber(s.count)} instances = ~${formatBytes(estimatedWaste)}) — verify this field is needed by consumers`);
+                            }
+                        }
+                    }
+                }
+                if (duplicationAlerts.length > 0) {
+                    lines.push('## Same-Object Duplication');
+                    lines.push('');
+                    lines.push('Unique-looking keys with far fewer distinct values than instances — the same records appear to be retained multiple times:');
+                    lines.push('');
+                    lines.push(...duplicationAlerts.slice(0, 8));
+                    lines.push('', '_This is a retention/concurrency issue, **not** an interning opportunity: interning a per-record copy cannot reclaim duplicated whole records. Trace one example with `memlab_retainer_summary` / `memlab_trace_dominators` to find why N copies are kept alive (e.g. unbounded request concurrency, a cache keyed per-request, or fan-out without back-pressure)._');
+                    lines.push('');
+                }
+                if (columnAlerts.length > 0) {
+                    // Cap to the most relevant lines — on wide shapes this section
+                    // used to emit ~100 near-identical lines (Feedback §4).
+                    const COLUMN_ALERT_CAP = 12;
+                    lines.push('## Data Column Analysis');
+                    lines.push('');
+                    lines.push('Property value analysis across large object shapes:');
+                    lines.push('');
+                    lines.push(...columnAlerts.slice(0, COLUMN_ALERT_CAP));
+                    if (columnAlerts.length > COLUMN_ALERT_CAP) {
+                        lines.push(`- … and ${columnAlerts.length - COLUMN_ALERT_CAP} more column(s). Use \`memlab_property_distribution\` to drill into a specific property.`);
+                    }
+                    lines.push('', '_Low-cardinality columns can often be filtered at the data source (SQL WHERE clause). High-cost unique string properties should be verified as needed by consumers._');
+                    lines.push('');
+                }
+            }
+            if (distributed.length > 0) {
+                lines.push(`## Distributed Accumulation`);
+                lines.push('');
+                lines.push('Classes with many small instances that collectively consume significant memory. No single instance stands out, but the total is substantial:');
+                lines.push('');
+                for (const d of distributed) {
+                    const pct = totalSize > 0
+                        ? ` (${((d.totalSelfSize / totalSize) * 100).toFixed(1)}% of heap)`
+                        : '';
+                    const sevIcon = d.totalSelfSize >= totalSize * 0.1
+                        ? '🔴'
+                        : d.totalSelfSize >= totalSize * 0.05
+                            ? '🟠'
+                            : '🟡';
+                    lines.push(`- ${sevIcon} \`${d.className}\` (${d.nodeType}) — **${formatNumber(d.count)}** instances × ${Math.round(d.avgSize)}B avg = **${formatBytes(d.totalSelfSize)}**${pct} (example: @${d.exampleNodeId})`);
+                }
+                lines.push('', '_These won\'t appear in "top retained objects" because no single instance retains enough. Reduce instance count at the source (batch, deduplicate, or filter before storing)._');
+                lines.push('');
             }
             if (subscriptions.length > 0) {
                 lines.push(`## Subscription/Listener Accumulation`);
@@ -615,17 +1533,39 @@ export function registerAutoInvestigate(server) {
                 lines.push('');
                 for (const s of subscriptions.slice(0, 5)) {
                     const propsDisplay = `{${s.properties.join(', ')}}`;
-                    const subSev = classifySeverity(s.totalSelfSize, totalSize);
-                    const subSevIcon = subSev === 'CRITICAL'
+                    const baseSev = classifySeverity(s.totalSelfSize, totalSize);
+                    const effectiveSev = s.fanOut
+                        ? s.fanOut.escalatedSeverity
+                        : baseSev;
+                    const subSevIcon = effectiveSev === 'CRITICAL'
                         ? '🔴'
-                        : subSev === 'HIGH'
+                        : effectiveSev === 'HIGH'
                             ? '🟠'
-                            : subSev === 'MEDIUM'
+                            : effectiveSev === 'MEDIUM'
                                 ? '🟡'
                                 : '🔵';
-                    lines.push(`- ${subSevIcon} [${subSev}] ${propsDisplay} — **${formatNumber(s.count)}** instances, ${formatBytes(s.totalSelfSize)} self (example: @${s.exampleNodeId})`);
+                    lines.push(`- ${subSevIcon} [${effectiveSev}] ${propsDisplay} — **${formatNumber(s.count)}** instances, ${formatBytes(s.totalSelfSize)} self (example: @${s.exampleNodeId})`);
+                    if (s.fanOut) {
+                        const fo = s.fanOut;
+                        lines.push(`  - **Listener fan-out detected:** ${formatNumber(fo.uniqueCallbacks)} unique callback(s), ${formatNumber(fo.uniqueContexts)} unique context(s)`);
+                        if (fo.orphanedContexts > 0) {
+                            lines.push(`  - **${formatNumber(fo.orphanedContexts)} orphaned context(s)** — only retained by listener registrations`);
+                        }
+                        if (fo.contextShapes.length > 0) {
+                            const shapeStr = fo.contextShapes
+                                .map(cs => `${cs.count}× ${cs.name}`)
+                                .join(', ');
+                            lines.push(`  - Context shapes: ${shapeStr}`);
+                        }
+                        if (effectiveSev !== baseSev) {
+                            lines.push(`  - _Severity escalated from ${baseSev} → ${effectiveSev} due to listener fan-out pattern (few callbacks, many orphaned contexts)_`);
+                        }
+                    }
                 }
-                lines.push('', '_These may be event listeners, signal subscriptions, or observer registrations that are not being cleaned up. Use `memlab_retainer_summary` with node_ids from the examples to trace the retention pattern._');
+                lines.push('');
+                lines.push('_These may be event listeners, signal subscriptions, or observer registrations that are not being cleaned up. ' +
+                    'Use `memlab_event_listener_leaks` for detailed listener analysis or ' +
+                    '`memlab_retainer_summary` with node_ids from the examples to trace the retention pattern._');
                 lines.push('');
             }
             if (errorAccum.length > 0) {
@@ -642,6 +1582,26 @@ export function registerAutoInvestigate(server) {
                 lines.push('', '_Repeated identical errors are almost always a bug — a module failing to load, a misconfigured import, or a retry loop that never succeeds._');
                 lines.push('');
             }
+            const asyncAlerts = detectAsyncContextLeaks(findings);
+            const frameworkAlerts = focus === 'all' ? detectFrameworkLeaks(snapshot, totalSize) : [];
+            const closureAlerts = focus === 'all' || focus === 'closures'
+                ? scanOversizedClosures(snapshot, totalSize)
+                : [];
+            const appendOnlyAlerts = focus === 'all' ? scanAppendOnlyRecords(snapshot, totalSize) : [];
+            const allPatternAlerts = [
+                ...frameworkAlerts,
+                ...closureAlerts,
+                ...appendOnlyAlerts,
+                ...asyncAlerts,
+            ];
+            if (allPatternAlerts.length > 0) {
+                lines.push('## Known Leak Patterns');
+                lines.push('');
+                for (const alert of allPatternAlerts) {
+                    lines.push(alert);
+                    lines.push('');
+                }
+            }
             const sourceHints = extractSourceHints(findings.map(f => f.trace));
             if (sourceHints.length > 0) {
                 lines.push('## Source Hints');
@@ -655,23 +1615,25 @@ export function registerAutoInvestigate(server) {
                 }
                 lines.push('');
             }
-            lines.push('## Suggested Next Steps');
-            lines.push('');
-            let stepNum = 1;
-            if (findings[0]?.pinchPoint) {
-                const pp = findings[0].pinchPoint;
-                lines.push(`${stepNum++}. Inspect pinch point: \`memlab_get_node(${pp.nodeId})\` then \`memlab_dominator_subtree(${pp.nodeId})\``);
-            }
-            lines.push(`${stepNum++}. Trace top retainer: \`memlab_trace_dominators(${findings[0].node.id})\` for full dominator chain in one call`);
-            lines.push(`${stepNum++}. Check for patterns: \`memlab_retainer_summary\` with class name of top objects`);
-            if (promises.pendingCount > 0 && promises.topPending.length > 0) {
-                lines.push(`${stepNum++}. Investigate pending promises: \`memlab_trace_dominators(${promises.topPending[0].nodeId})\``);
-            }
-            if (caches.length > 0) {
-                lines.push(`${stepNum++}. Analyze caches: \`memlab_cache_analysis\` for detailed cache inspection`);
-            }
-            if (shapes.length > 0) {
-                lines.push(`${stepNum++}. Explore data shapes: \`memlab_shape_histogram\` for detailed shape clustering`);
+            if (!suggestionsSuppressed()) {
+                lines.push('## Suggested Next Steps');
+                lines.push('');
+                let stepNum = 1;
+                if (findings[0]?.pinchPoint) {
+                    const pp = findings[0].pinchPoint;
+                    lines.push(`${stepNum++}. Inspect pinch point: \`memlab_get_node(${pp.nodeId})\` then \`memlab_dominator_subtree(${pp.nodeId})\``);
+                }
+                lines.push(`${stepNum++}. Trace top retainer: \`memlab_trace_dominators(${findings[0].node.id})\` for full dominator chain in one call`);
+                lines.push(`${stepNum++}. Check for patterns: \`memlab_retainer_summary\` with class name of top objects`);
+                if (promises.pendingCount > 0 && promises.topPending.length > 0) {
+                    lines.push(`${stepNum++}. Investigate pending promises: \`memlab_trace_dominators(${promises.topPending[0].nodeId})\``);
+                }
+                if (caches.length > 0) {
+                    lines.push(`${stepNum++}. Analyze caches: \`memlab_cache_analysis\` for detailed cache inspection`);
+                }
+                if (shapes.length > 0) {
+                    lines.push(`${stepNum++}. Explore data shapes: \`memlab_shape_histogram\` for detailed shape clustering`);
+                }
             }
             return toolResult(lines.join('\n'));
         }