@memlab/mcp-server 2.18.1 → 2.86.0

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;AAiMtE,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,CAsHjE;AAyED;;;;;;;;;;;;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;AAmED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgR5D"}