@perfonext/render-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Perfonext
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# perfonext-render-mcp
+
+[![npm](https://img.shields.io/npm/v/@perfonext/render-mcp)](https://www.npmjs.com/package/@perfonext/render-mcp)
+
+`perfonext-render-mcp` is an MCP server for loading and analyzing React DevTools Profiler exports captured from Next.js apps. It gives GitHub Copilot and other MCP clients structured render data they can reason over instead of forcing the model to inspect raw profiler JSON.
+
+## What It Does
+
+- loads exported React Profiler JSON files from Next.js apps
+- summarizes commits and the most expensive components
+- ranks the hottest commits and shows the top components inside each spike
+- identifies the slowest components by total render cost
+- highlights components with repeated rerenders using deterministic heuristics, evidence signals, and confidence levels
+- keeps the loaded profiles in memory so an MCP client can iterate without re-reading the file
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `load_render_profile` | Parse and load an exported React Profiler JSON file from disk |
+| `get_render_summary` | Summarize a loaded profile, including top components by render cost and the hottest commits |
+| `get_hot_commits` | Rank the most expensive commits and show the top components inside each spike |
+| `get_slow_components` | Rank the slowest components by total actual render time |
+| `get_rerender_causes` | Explain likely rerender causes using profile-derived heuristics, evidence, confidence, and a documented score |
+
+`get_rerender_causes` is heuristic by design. It works from structural signals in the profiler export — update frequency, nested update propagation, commit spread, and self-intensive renders. When you record with **"Record why each component rendered"** enabled in React DevTools Profiler settings, the export includes richer `changeDescriptions` data; future versions of this tool will parse that field to surface exact prop/state/context diffs natively.
+
+## Rerender Score Contract
+
+`get_rerender_causes` returns a `score`, `scoreBand`, `confidence`, and `evidence[]` for each component.
+
+- `score`: a `0-10` heuristic rerender-risk score
+- `scoreBand`:
+  - `low`: `0.0-2.9`
+  - `medium`: `3.0-5.9`
+  - `high`: `6.0-10.0`
+- `confidence`: how many independent evidence signals supported the finding
+  - `low`: one weak signal or only fallback export evidence
+  - `medium`: two independent signals
+  - `high`: three or more independent signals
+- `evidence[]`: machine-readable signals such as repeated updates, nested-update propagation, wide commit spread, or high actual-vs-self duration ratio
+
+Current score inputs are:
+
+- repeated update-phase renders
+- nested update propagation
+- appearance across many commits
+- high actual-vs-self duration ratio
+
+The score is meant to help rank investigation order, not to claim exact root cause. Enable **"Record why each component rendered"** in React DevTools Profiler settings before recording to capture richer change metadata in the export.
+
+## Install
+
+Run directly with `npx`:
+
+```bash
+npx -y @perfonext/render-mcp
+```
+
+Or install globally:
+
+```bash
+npm install -g @perfonext/render-mcp
+```
+
+The executable command remains `perfonext-render-mcp` after installation.
+
+## MCP Configuration
+
+Add this server to VS Code settings:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "perfonext-render": {
+        "command": "npx",
+        "args": ["-y", "@perfonext/render-mcp"]
+      }
+    }
+  }
+}
+```
+
+Local workspace MCP config is also included in `.vscode/mcp.json` for development.
+
+## Example Copilot Prompts
+
+- "Load the React Profiler export at `./profile.json` and summarize the hottest components."
+- "Show me the hottest commits in `./profile.json` and which components dominated each spike."
+- "Which components are consuming the most render time in this Next.js profile?"
+- "Show me the likely rerender causes for the slowest components, including evidence and confidence."
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+Sample fixtures for local validation live under `tests/fixtures/`.
+
+## License
+
+MIT

package/dist/format.d.ts

@@ -0,0 +1,3 @@
+export declare function formatMs(value: number): string;
+export declare function formatPct(value: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/format.js

@@ -0,0 +1,7 @@
+export function formatMs(value) {
+    return `${value.toFixed(2)}ms`;
+}
+export function formatPct(value) {
+    return `${(value * 100).toFixed(1)}%`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerLoadRenderProfile } from './tools/load-render-profile.js';
+import { registerGetRenderSummary } from './tools/get-render-summary.js';
+import { registerGetHotCommits } from './tools/get-hot-commits.js';
+import { registerGetSlowComponents } from './tools/get-slow-components.js';
+import { registerGetRerenderCauses } from './tools/get-rerender-causes.js';
+const server = new McpServer({
+    name: 'perfonext-render-mcp',
+    version: '0.1.0',
+});
+registerLoadRenderProfile(server);
+registerGetRenderSummary(server);
+registerGetHotCommits(server);
+registerGetSlowComponents(server);
+registerGetRerenderCauses(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAElC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/parser/analysis.d.ts

@@ -0,0 +1,17 @@
+import type { HotCommitSummary, ParsedRenderProfile, RenderSummaryEntry, RerenderCause } from './types.js';
+export declare function getHotCommits(profile: ParsedRenderProfile, limit?: number, componentLimit?: number): HotCommitSummary[];
+export declare function getRenderSummary(profile: ParsedRenderProfile, limit?: number): {
+    profileId: string;
+    filename: string;
+    version: string;
+    rendererId: number | null;
+    commitCount: number;
+    componentCount: number;
+    totalCommitDuration: number;
+    totalRenderDuration: number;
+    topComponents: RenderSummaryEntry[];
+    hotCommits: HotCommitSummary[];
+};
+export declare function getSlowComponents(profile: ParsedRenderProfile, limit?: number, sortBy?: 'total' | 'average' | 'max', minDuration?: number): RenderSummaryEntry[];
+export declare function getRerenderCauses(profile: ParsedRenderProfile, limit?: number, minDuration?: number): RerenderCause[];
+//# sourceMappingURL=analysis.d.ts.map

package/dist/parser/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/parser/analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,mBAAmB,EAEnB,kBAAkB,EAClB,aAAa,EAId,MAAM,YAAY,CAAC;AA2DpB,wBAAgB,aAAa,CAC3B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,SAAK,EACV,cAAc,SAAI,GACjB,gBAAgB,EAAE,CAuBpB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,SAAK,GAAG;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC,CAaA;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,SAAK,EACV,MAAM,GAAE,OAAO,GAAG,SAAS,GAAG,KAAe,EAC7C,WAAW,SAAI,GACd,kBAAkB,EAAE,CA0BtB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,SAAK,EAAE,WAAW,SAAI,GAAG,aAAa,EAAE,CA6I5G"}

package/dist/parser/analysis.js

@@ -0,0 +1,226 @@
+function getScoreBand(score) {
+    if (score >= 6) {
+        return 'high';
+    }
+    if (score >= 3) {
+        return 'medium';
+    }
+    return 'low';
+}
+function getConfidence(evidenceCount) {
+    if (evidenceCount >= 3) {
+        return 'high';
+    }
+    if (evidenceCount >= 2) {
+        return 'medium';
+    }
+    return 'low';
+}
+function getCommitTopComponents(commit, limit) {
+    const components = new Map();
+    const totalActualDuration = commit.measurements.reduce((sum, measurement) => sum + measurement.actualDuration, 0);
+    for (const measurement of commit.measurements) {
+        const existing = components.get(measurement.componentName) ?? {
+            componentName: measurement.componentName,
+            actualDuration: 0,
+            selfDuration: 0,
+            renderCount: 0,
+            shareOfCommitWork: 0,
+        };
+        existing.actualDuration += measurement.actualDuration;
+        existing.selfDuration += measurement.selfDuration;
+        existing.renderCount += measurement.renderCount;
+        components.set(measurement.componentName, existing);
+    }
+    return Array.from(components.values())
+        .sort((left, right) => right.actualDuration - left.actualDuration)
+        .slice(0, limit)
+        .map(component => ({
+        ...component,
+        shareOfCommitWork: totalActualDuration > 0
+            ? component.actualDuration / totalActualDuration
+            : 0,
+    }));
+}
+export function getHotCommits(profile, limit = 10, componentLimit = 3) {
+    return profile.commits
+        .map(commit => ({
+        commitIndex: commit.index,
+        duration: commit.duration,
+        totalActualDuration: commit.measurements.reduce((sum, measurement) => sum + measurement.actualDuration, 0),
+        timestamp: commit.timestamp,
+        priorityLevel: commit.priorityLevel,
+        measurementCount: commit.measurements.length,
+        topComponents: getCommitTopComponents(commit, componentLimit),
+        updaterComponentNames: commit.updaterComponentNames,
+    }))
+        .sort((left, right) => {
+        if (right.duration !== left.duration) {
+            return right.duration - left.duration;
+        }
+        return right.totalActualDuration - left.totalActualDuration;
+    })
+        .slice(0, limit);
+}
+export function getRenderSummary(profile, limit = 10) {
+    return {
+        profileId: profile.id,
+        filename: profile.filename,
+        version: profile.version,
+        rendererId: profile.rendererId,
+        commitCount: profile.commits.length,
+        componentCount: profile.components.length,
+        totalCommitDuration: profile.totalCommitDuration,
+        totalRenderDuration: profile.totalRenderDuration,
+        hotCommits: getHotCommits(profile, Math.min(3, profile.commits.length), 3),
+        topComponents: getSlowComponents(profile, limit),
+    };
+}
+export function getSlowComponents(profile, limit = 10, sortBy = 'total', minDuration = 0) {
+    const entries = profile.components
+        .filter(component => component.totalActualDuration >= minDuration)
+        .map(component => ({
+        componentName: component.componentName,
+        renderCount: component.renderCount,
+        mountCount: component.mountCount,
+        updateCount: component.updateCount,
+        nestedUpdateCount: component.nestedUpdateCount,
+        totalActualDuration: component.totalActualDuration,
+        averageActualDuration: component.renderCount > 0
+            ? component.totalActualDuration / component.renderCount
+            : 0,
+        maxActualDuration: component.maxActualDuration,
+        commitCount: component.commitIndices.length,
+    }));
+    if (sortBy === 'average') {
+        entries.sort((a, b) => b.averageActualDuration - a.averageActualDuration);
+    }
+    else if (sortBy === 'max') {
+        entries.sort((a, b) => b.maxActualDuration - a.maxActualDuration);
+    }
+    else {
+        entries.sort((a, b) => b.totalActualDuration - a.totalActualDuration);
+    }
+    return entries.slice(0, limit);
+}
+export function getRerenderCauses(profile, limit = 10, minDuration = 0) {
+    const causes = profile.components
+        .filter(component => (component.updateCount > 0 || component.nestedUpdateCount > 0) &&
+        component.totalActualDuration >= minDuration)
+        .map(component => {
+        const likelyCauses = [];
+        const evidence = [];
+        const selfToActualRatio = component.totalActualDuration > 0
+            ? component.totalSelfDuration / component.totalActualDuration
+            : 0;
+        if (component.updateCount >= 2) {
+            const updatePct = component.renderCount > 0
+                ? Math.round((component.updateCount / component.renderCount) * 100)
+                : 0;
+            const mountPct = 100 - updatePct;
+            let causeText;
+            if (updatePct >= 80) {
+                causeText =
+                    `${component.componentName} rendered in update phase ${component.updateCount} of ${component.renderCount} times (${updatePct}% updates, ${mountPct}% mounts). ` +
+                        `It almost never remounts fresh, which means it is staying alive and re-rendering in place repeatedly. ` +
+                        `The likely driver is a parent passing new object/array/function references on every render, or the component's own state being set more often than intended. ` +
+                        `Check for inline object props, unstable callback references, or a context value that changes on every parent render.`;
+            }
+            else if (updatePct >= 40) {
+                causeText =
+                    `${component.componentName} has a mixed mount/update pattern: ${updatePct}% updates, ${mountPct}% mounts across ${component.renderCount} renders. ` +
+                        `The component is sometimes remounting fresh and sometimes updating in place, which can mean it is conditionally included in the tree, ` +
+                        `or its React key changes on some renders (causing a full unmount+mount). ` +
+                        `Investigate whether key changes are intentional and whether conditional rendering could be replaced with CSS visibility to avoid remount cost.`;
+            }
+            else {
+                causeText =
+                    `${component.componentName} is mostly mounting rather than updating: ${mountPct}% mounts vs ${updatePct}% updates across ${component.renderCount} renders. ` +
+                        `This level of remounting usually points to unstable list keys, a parent that conditionally unmounts and recreates the component, ` +
+                        `or a component defined inside a render function (which creates a new type on every render and forces React to unmount instead of update). ` +
+                        `Ensure keys are stable identifiers and that the component is not defined inline.`;
+            }
+            likelyCauses.push(causeText);
+            evidence.push({
+                signal: 'repeated-update-phases',
+                observed: component.updateCount,
+                threshold: 2,
+                detail: `${component.componentName} entered the update phase ${component.updateCount} times (${updatePct}%) across ${component.commitIndices.length} commit${component.commitIndices.length === 1 ? '' : 's'}. Mount/update ratio: ${mountPct}% mounts, ${updatePct}% updates.`,
+            });
+        }
+        if (component.nestedUpdateCount > 0) {
+            likelyCauses.push(`${component.nestedUpdateCount} of ${component.componentName}'s renders were triggered as nested updates ` +
+                `(the component itself was listed as an updater for its own commit). ` +
+                `This is a strong indicator of a render-then-setState loop, an effect with missing or incorrect dependencies, ` +
+                `or a context provider that updates its value during render.`);
+            evidence.push({
+                signal: 'nested-update-propagation',
+                observed: component.nestedUpdateCount,
+                threshold: 1,
+                detail: `${component.componentName} appeared as an updater in ${component.nestedUpdateCount} of its own commits, which is a strong hint that rerender work is self-propagating inside this subtree.`,
+            });
+        }
+        if (selfToActualRatio >= 0.9) {
+            const selfPct = Math.round(selfToActualRatio * 100);
+            likelyCauses.push(`${selfPct}% of ${component.componentName}'s render cost is self-contained (not delegated to children). ` +
+                `The component body itself is doing the heavy lifting — likely expensive JSX construction, inline computations, or heavy formatting on each render. ` +
+                `Wrapping with React.memo will prevent unnecessary calls, and moving expensive calculations into useMemo will avoid recomputing them when unrelated state changes.`);
+            evidence.push({
+                signal: 'self-intensive-render',
+                observed: Number(selfToActualRatio.toFixed(2)),
+                threshold: 0.9,
+                detail: `Self duration is ${selfPct}% of actual duration for ${component.componentName}, indicating this component does most render work in its own body rather than delegating to children. Direct memoization of this component is the correct fix.`,
+            });
+        }
+        if (component.commitIndices.length >= 3) {
+            const commitList = component.commitIndices.slice(0, 5).join(', ') +
+                (component.commitIndices.length > 5 ? ` … (+${component.commitIndices.length - 5} more)` : '');
+            likelyCauses.push(`${component.componentName} appeared in ${component.commitIndices.length} separate commits (commits ${commitList}), ` +
+                `which means rerender pressure on this component is sustained across the session rather than a one-off spike. ` +
+                `Likely causes are an unstable context value, a subscription or timer that triggers frequent state updates, ` +
+                `or a prop that carries a new reference on every parent render.`);
+            evidence.push({
+                signal: 'wide-commit-spread',
+                observed: component.commitIndices.length,
+                threshold: 3,
+                detail: `${component.componentName} shows up across ${component.commitIndices.length} commits, which usually means rerender pressure is sustained rather than a one-off spike.`,
+            });
+        }
+        if (likelyCauses.length === 0) {
+            likelyCauses.push(`${component.componentName} rendered ${component.updateCount} time${component.updateCount === 1 ? '' : 's'} in update phase, ` +
+                `but the signals are below the thresholds for specific heuristics. ` +
+                `React Profiler exports do not include prop/state diffs, so the exact trigger cannot be determined from this data alone. ` +
+                `Use why-did-you-render or React DevTools to capture the specific prop or state change.`);
+            evidence.push({
+                signal: 'limited-export-evidence',
+                observed: component.commitIndices.length,
+                threshold: 'n/a',
+                detail: `React Profiler exports do not include exact prop/state diffs, so only weak rerender signals were available for ${component.componentName}.`,
+            });
+        }
+        const score = Math.min(10, Number((Math.min(3, component.updateCount)
+            + Math.min(3, component.nestedUpdateCount * 1.5)
+            + (component.commitIndices.length >= 3 ? 2 : component.commitIndices.length >= 2 ? 1 : 0)
+            + (selfToActualRatio >= 0.9 ? 2 : selfToActualRatio >= 0.75 ? 1 : 0)).toFixed(1)));
+        return {
+            componentName: component.componentName,
+            renderCount: component.renderCount,
+            updateCount: component.updateCount,
+            nestedUpdateCount: component.nestedUpdateCount,
+            totalActualDuration: component.totalActualDuration,
+            score,
+            scoreBand: getScoreBand(score),
+            confidence: getConfidence(evidence.filter(item => item.signal !== 'limited-export-evidence').length),
+            evidence,
+            likelyCauses,
+        };
+    })
+        .sort((left, right) => {
+        if (right.score !== left.score) {
+            return right.score - left.score;
+        }
+        return right.totalActualDuration - left.totalActualDuration;
+    });
+    return causes.slice(0, limit);
+}
+//# sourceMappingURL=analysis.js.map

package/dist/parser/analysis.js.map

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

package/dist/parser/react-profile.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedRenderProfile } from './types.js';
+export declare function parseRenderProfile(content: string, filename: string): ParsedRenderProfile;
+//# sourceMappingURL=react-profile.d.ts.map

package/dist/parser/react-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-profile.d.ts","sourceRoot":"","sources":["../../src/parser/react-profile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,YAAY,CAAC;AAuOpB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAmEzF"}

package/dist/parser/react-profile.js

@@ -0,0 +1,212 @@
+import { randomUUID } from 'node:crypto';
+import { basename } from 'node:path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function asNumber(value, fallback = 0) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+/**
+ * Build a fiberID -> displayName map from the snapshots array.
+ * snapshots is serialised as Array<[fiberID, SnapshotNode]> in the export.
+ */
+function buildSnapshotMap(snapshots) {
+    const map = new Map();
+    if (!Array.isArray(snapshots))
+        return map;
+    for (const entry of snapshots) {
+        if (!Array.isArray(entry) || entry.length < 2)
+            continue;
+        const [fiberID, node] = entry;
+        if (typeof fiberID !== 'number')
+            continue;
+        const raw = node;
+        const name = typeof raw?.displayName === 'string' && raw.displayName.trim().length > 0
+            ? raw.displayName
+            : `(fiber:${fiberID})`;
+        map.set(fiberID, name);
+    }
+    return map;
+}
+/**
+ * Build a Set of fiberIDs that existed before profiling started.
+ * initialTreeBaseDurations is serialised as Array<[fiberID, duration]>.
+ */
+function buildInitialFiberIDSet(initialTreeBaseDurations) {
+    const set = new Set();
+    if (!Array.isArray(initialTreeBaseDurations))
+        return set;
+    for (const entry of initialTreeBaseDurations) {
+        if (Array.isArray(entry) && typeof entry[0] === 'number') {
+            set.add(entry[0]);
+        }
+    }
+    return set;
+}
+/**
+ * Parse a single commit from the React DevTools v5 export.
+ * fiberActualDurations and fiberSelfDurations are Array<[fiberID, duration]> tuples.
+ */
+function parseCommit(raw, index, snapshotMap, initialFiberIDs, seenFiberIDs) {
+    const fiberActualDurations = Array.isArray(raw.fiberActualDurations)
+        ? raw.fiberActualDurations
+        : [];
+    // Build a quick self-duration lookup for this commit
+    const selfDurationMap = new Map();
+    if (Array.isArray(raw.fiberSelfDurations)) {
+        for (const entry of raw.fiberSelfDurations) {
+            if (Array.isArray(entry) &&
+                typeof entry[0] === 'number' &&
+                typeof entry[1] === 'number') {
+                selfDurationMap.set(entry[0], entry[1]);
+            }
+        }
+    }
+    // Build the set of fiber IDs that triggered this commit (React DevTools "updaters" field).
+    // updaters are the components that called setState / dispatched / caused this commit.
+    const updaterFiberIDs = new Set();
+    if (Array.isArray(raw.updaters)) {
+        for (const updater of raw.updaters) {
+            if (updater !== null && typeof updater === 'object') {
+                const u = updater;
+                if (typeof u['id'] === 'number') {
+                    updaterFiberIDs.add(u['id']);
+                }
+            }
+        }
+    }
+    const seenUpdaterNames = new Set();
+    const updaterComponentNames = [];
+    for (const fiberID of updaterFiberIDs) {
+        const name = snapshotMap.get(fiberID) ?? `(fiber:${fiberID})`;
+        if (!seenUpdaterNames.has(name)) {
+            seenUpdaterNames.add(name);
+            updaterComponentNames.push(name);
+        }
+    }
+    const measurements = [];
+    for (const entry of fiberActualDurations) {
+        if (!Array.isArray(entry) || entry.length < 2)
+            continue;
+        const [fiberID, actualDuration] = entry;
+        if (typeof fiberID !== 'number' || typeof actualDuration !== 'number')
+            continue;
+        const componentName = snapshotMap.get(fiberID) ?? `(fiber:${fiberID})`;
+        const selfDuration = selfDurationMap.get(fiberID) ?? actualDuration;
+        // A fiber is mounting if it was not present when profiling started AND
+        // this is the first commit we have seen it in.
+        const isMount = !initialFiberIDs.has(fiberID) && !seenFiberIDs.has(fiberID);
+        seenFiberIDs.add(fiberID);
+        measurements.push({
+            componentName,
+            phase: isMount ? 'mount' : 'update',
+            actualDuration,
+            selfDuration,
+            startTime: asNumber(raw.timestamp),
+            commitTime: asNumber(raw.timestamp),
+            renderCount: 1,
+            commitIndex: index,
+            isNestedUpdate: !isMount && updaterFiberIDs.has(fiberID),
+        });
+    }
+    return {
+        index,
+        duration: asNumber(raw.duration),
+        timestamp: asNumber(raw.timestamp),
+        priorityLevel: typeof raw.priorityLevel === 'string' ? raw.priorityLevel : null,
+        measurements,
+        updaterComponentNames,
+    };
+}
+function buildComponentStats(commits) {
+    const stats = new Map();
+    const commitIndexSets = new Map();
+    for (const commit of commits) {
+        for (const measurement of commit.measurements) {
+            const name = measurement.componentName;
+            if (!stats.has(name)) {
+                stats.set(name, {
+                    componentName: name,
+                    renderCount: 0,
+                    mountCount: 0,
+                    updateCount: 0,
+                    nestedUpdateCount: 0,
+                    totalActualDuration: 0,
+                    totalSelfDuration: 0,
+                    maxActualDuration: 0,
+                    commitIndices: [],
+                });
+                commitIndexSets.set(name, new Set());
+            }
+            const existing = stats.get(name);
+            existing.renderCount += 1;
+            existing.totalActualDuration += measurement.actualDuration;
+            existing.totalSelfDuration += measurement.selfDuration;
+            existing.maxActualDuration = Math.max(existing.maxActualDuration, measurement.actualDuration);
+            commitIndexSets.get(name).add(commit.index);
+            if (measurement.phase === 'mount') {
+                existing.mountCount += 1;
+            }
+            else {
+                existing.updateCount += 1;
+                if (measurement.isNestedUpdate) {
+                    existing.nestedUpdateCount += 1;
+                }
+            }
+        }
+    }
+    for (const [name, indexSet] of commitIndexSets) {
+        stats.get(name).commitIndices = Array.from(indexSet).sort((a, b) => a - b);
+    }
+    return Array.from(stats.values()).sort((a, b) => b.totalActualDuration - a.totalActualDuration);
+}
+export function parseRenderProfile(content, filename) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        throw new Error('Invalid render profile JSON');
+    }
+    // React DevTools has exported version 5 since early 2020 (PROFILER_EXPORT_VERSION = 5).
+    if (parsed.version !== 5) {
+        throw new Error(`Invalid render profile format: unsupported version "${String(parsed.version)}". ` +
+            'Expected a React DevTools Profiler export (version 5). ' +
+            'Open React DevTools -> Profiler tab -> record -> click the save icon.');
+    }
+    if (!Array.isArray(parsed.dataForRoots) || parsed.dataForRoots.length === 0) {
+        throw new Error('Invalid render profile format: no root data found. ' +
+            'Ensure you exported from the React DevTools Profiler tab, not the browser Performance tab.');
+    }
+    const allCommits = [];
+    for (const rawRoot of parsed.dataForRoots) {
+        const root = rawRoot;
+        // fiberID -> displayName, built from the serialised snapshots map
+        const snapshotMap = buildSnapshotMap(root.snapshots);
+        // Fibers present before profiling started (used for mount vs update detection)
+        const initialFiberIDs = buildInitialFiberIDSet(root.initialTreeBaseDurations);
+        const seenFiberIDs = new Set();
+        const commitDataArray = Array.isArray(root.commitData)
+            ? root.commitData
+            : [];
+        const startIndex = allCommits.length;
+        for (let i = 0; i < commitDataArray.length; i++) {
+            allCommits.push(parseCommit(commitDataArray[i], startIndex + i, snapshotMap, initialFiberIDs, seenFiberIDs));
+        }
+    }
+    if (allCommits.length === 0) {
+        throw new Error('No profiling commits found. The profiler may have been started but no renders occurred.');
+    }
+    const components = buildComponentStats(allCommits);
+    return {
+        id: randomUUID(),
+        filename: basename(filename),
+        version: '5',
+        rendererId: null,
+        commits: allCommits,
+        components,
+        totalCommitDuration: allCommits.reduce((sum, c) => sum + c.duration, 0),
+        totalRenderDuration: components.reduce((sum, c) => sum + c.totalActualDuration, 0),
+    };
+}
+//# sourceMappingURL=react-profile.js.map

package/dist/parser/react-profile.js.map

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

package/dist/parser/types.d.ts

@@ -0,0 +1,89 @@
+export interface RenderMeasurement {
+    componentName: string;
+    phase: string;
+    actualDuration: number;
+    selfDuration: number;
+    startTime: number;
+    commitTime: number;
+    renderCount: number;
+    commitIndex: number;
+    isNestedUpdate: boolean;
+}
+export interface RenderCommit {
+    index: number;
+    duration: number;
+    timestamp: number;
+    priorityLevel: string | null;
+    measurements: RenderMeasurement[];
+    updaterComponentNames: string[];
+}
+export interface ComponentStats {
+    componentName: string;
+    renderCount: number;
+    mountCount: number;
+    updateCount: number;
+    nestedUpdateCount: number;
+    totalActualDuration: number;
+    totalSelfDuration: number;
+    maxActualDuration: number;
+    commitIndices: number[];
+}
+export interface ParsedRenderProfile {
+    id: string;
+    filename: string;
+    version: string;
+    rendererId: number | null;
+    commits: RenderCommit[];
+    components: ComponentStats[];
+    totalCommitDuration: number;
+    totalRenderDuration: number;
+}
+export interface RenderSummaryEntry {
+    componentName: string;
+    renderCount: number;
+    mountCount: number;
+    updateCount: number;
+    nestedUpdateCount: number;
+    totalActualDuration: number;
+    averageActualDuration: number;
+    maxActualDuration: number;
+    commitCount: number;
+}
+export interface HotCommitComponentSummary {
+    componentName: string;
+    actualDuration: number;
+    selfDuration: number;
+    renderCount: number;
+    shareOfCommitWork: number;
+}
+export interface HotCommitSummary {
+    commitIndex: number;
+    duration: number;
+    totalActualDuration: number;
+    timestamp: number;
+    priorityLevel: string | null;
+    measurementCount: number;
+    topComponents: HotCommitComponentSummary[];
+    updaterComponentNames: string[];
+}
+export interface RerenderEvidence {
+    signal: string;
+    observed: number | string;
+    threshold: number | string;
+    detail: string;
+}
+export type RerenderConfidence = 'low' | 'medium' | 'high';
+export type RerenderScoreBand = 'low' | 'medium' | 'high';
+export interface RerenderCause {
+    componentName: string;
+    renderCount: number;
+    updateCount: number;
+    nestedUpdateCount: number;
+    totalActualDuration: number;
+    score: number;
+    scoreBand: RerenderScoreBand;
+    confidence: RerenderConfidence;
+    evidence: RerenderEvidence[];
+    likelyCauses: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/parser/types.d.ts.map

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

package/dist/parser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/parser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":""}

package/dist/store.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedRenderProfile } from './parser/types.js';
+export declare function storeRenderProfile(profile: ParsedRenderProfile): void;
+export declare function getRenderProfile(id: string): ParsedRenderProfile | undefined;
+export declare function listRenderProfiles(): Array<{
+    id: string;
+    filename: string;
+    commitCount: number;
+    componentCount: number;
+    totalCommitDuration: number;
+}>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI7D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAErE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE5E;AAED,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC,CAQD"}

package/dist/store.js

@@ -0,0 +1,17 @@
+const profiles = new Map();
+export function storeRenderProfile(profile) {
+    profiles.set(profile.id, profile);
+}
+export function getRenderProfile(id) {
+    return profiles.get(id);
+}
+export function listRenderProfiles() {
+    return Array.from(profiles.values()).map(profile => ({
+        id: profile.id,
+        filename: profile.filename,
+        commitCount: profile.commits.length,
+        componentCount: profile.components.length,
+        totalCommitDuration: profile.totalCommitDuration,
+    }));
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;AAExD,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAOhC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnD,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;QACnC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;QACzC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;KACjD,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/tools/get-hot-commits.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetHotCommits(server: McpServer): void;
+//# sourceMappingURL=get-hot-commits.d.ts.map

package/dist/tools/get-hot-commits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-hot-commits.d.ts","sourceRoot":"","sources":["../../src/tools/get-hot-commits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsC7D"}

package/dist/tools/get-hot-commits.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { formatMs, formatPct } from '../format.js';
+import { getHotCommits } from '../parser/analysis.js';
+import { getRenderProfile } from '../store.js';
+export function registerGetHotCommits(server) {
+    server.registerTool('get_hot_commits', {
+        title: 'Get Hot Commits',
+        description: 'Rank the most expensive commits in a loaded render profile and show the top components inside each spike.',
+        inputSchema: {
+            profileId: z.string().describe('Profile ID from load_render_profile'),
+            limit: z.number().int().positive().max(25).optional().describe('How many commits to include. Defaults to 10.'),
+            componentLimit: z.number().int().positive().max(10).optional().describe('How many top components to include per commit. Defaults to 3.'),
+        },
+    }, async ({ profileId, limit, componentLimit }) => {
+        const profile = getRenderProfile(profileId);
+        if (!profile) {
+            throw new Error(`Profile "${profileId}" not found. Call get_render_summary without a profileId to list all loaded profiles.`);
+        }
+        const hotCommits = getHotCommits(profile, limit ?? 10, componentLimit ?? 3).map(commit => ({
+            ...commit,
+            duration: formatMs(commit.duration),
+            totalActualDuration: formatMs(commit.totalActualDuration),
+            topComponents: commit.topComponents.map(component => ({
+                ...component,
+                actualDuration: formatMs(component.actualDuration),
+                selfDuration: formatMs(component.selfDuration),
+                shareOfCommitWork: formatPct(component.shareOfCommitWork),
+            })),
+        }));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        profileId,
+                        timestampNote: 'timestamp values are milliseconds since the profiling session started, not Unix epoch',
+                        hotCommits,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=get-hot-commits.js.map

package/dist/tools/get-hot-commits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-hot-commits.js","sourceRoot":"","sources":["../../src/tools/get-hot-commits.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE;QACrC,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,2GAA2G;QACxH,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YAC9G,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;SACzI;KACF,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE;QAChD,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,uFAAuF,CAAC,CAAC;QAChI,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzF,GAAG,MAAM;YACT,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;YACnC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC;YACzD,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACpD,GAAG,SAAS;gBACZ,cAAc,EAAE,QAAQ,CAAC,SAAS,CAAC,cAAc,CAAC;gBAClD,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC;gBAC9C,iBAAiB,EAAE,SAAS,CAAC,SAAS,CAAC,iBAAiB,CAAC;aAC1D,CAAC,CAAC;SACJ,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,SAAS;wBACT,aAAa,EAAE,uFAAuF;wBACtG,UAAU;qBACX,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/get-render-summary.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetRenderSummary(server: McpServer): void;
+//# sourceMappingURL=get-render-summary.d.ts.map

package/dist/tools/get-render-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-render-summary.d.ts","sourceRoot":"","sources":["../../src/tools/get-render-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0DhE"}

package/dist/tools/get-render-summary.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { formatMs, formatPct } from '../format.js';
+import { getRenderSummary as summarizeRenderProfile } from '../parser/analysis.js';
+import { getRenderProfile, listRenderProfiles } from '../store.js';
+export function registerGetRenderSummary(server) {
+    server.registerTool('get_render_summary', {
+        title: 'Get Render Summary',
+        description: 'Summarize the loaded Next.js render profile, including top components by render cost.',
+        inputSchema: {
+            profileId: z.string().optional().describe('Profile ID from load_render_profile. Omit to list loaded profiles.'),
+            limit: z.number().int().positive().max(25).optional().describe('How many top components to include. Defaults to 10.'),
+        },
+    }, async ({ profileId, limit }) => {
+        if (!profileId) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            profiles: listRenderProfiles().map(profile => ({
+                                ...profile,
+                                totalCommitDuration: `${profile.totalCommitDuration.toFixed(2)}ms`,
+                            })),
+                        }, null, 2),
+                    }],
+            };
+        }
+        const profile = getRenderProfile(profileId);
+        if (!profile) {
+            throw new Error(`Profile "${profileId}" not found. Call get_render_summary without a profileId to list all loaded profiles.`);
+        }
+        const summary = summarizeRenderProfile(profile, limit ?? 10);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        ...summary,
+                        totalCommitDuration: formatMs(summary.totalCommitDuration),
+                        totalRenderDuration: formatMs(summary.totalRenderDuration),
+                        topComponents: summary.topComponents.map(component => ({
+                            ...component,
+                            totalActualDuration: formatMs(component.totalActualDuration),
+                            averageActualDuration: formatMs(component.averageActualDuration),
+                            maxActualDuration: formatMs(component.maxActualDuration),
+                        })),
+                        hotCommits: summary.hotCommits.map(commit => ({
+                            ...commit,
+                            duration: formatMs(commit.duration),
+                            totalActualDuration: formatMs(commit.totalActualDuration),
+                            topComponents: commit.topComponents.map(component => ({
+                                ...component,
+                                actualDuration: formatMs(component.actualDuration),
+                                selfDuration: formatMs(component.selfDuration),
+                                shareOfCommitWork: formatPct(component.shareOfCommitWork),
+                            })),
+                        })),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=get-render-summary.js.map

package/dist/tools/get-render-summary.js.map

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

package/dist/tools/get-rerender-causes.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetRerenderCauses(server: McpServer): void;
+//# sourceMappingURL=get-rerender-causes.d.ts.map

package/dist/tools/get-rerender-causes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-rerender-causes.d.ts","sourceRoot":"","sources":["../../src/tools/get-rerender-causes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8CjE"}

package/dist/tools/get-rerender-causes.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { formatMs } from '../format.js';
+import { getRerenderCauses } from '../parser/analysis.js';
+import { getRenderProfile } from '../store.js';
+export function registerGetRerenderCauses(server) {
+    server.registerTool('get_rerender_causes', {
+        title: 'Get Rerender Causes',
+        description: 'Highlight components with repeated rerenders and explain likely causes using heuristics derived from the exported profile.',
+        inputSchema: {
+            profileId: z.string().describe('Profile ID from load_render_profile'),
+            limit: z.number().int().positive().max(25).optional().describe('How many components to include. Defaults to 10.'),
+            minDuration: z.number().nonnegative().optional().describe('Minimum total actual duration in ms for a component to appear. Filters sub-millisecond noise. Defaults to 0.'),
+        },
+    }, async ({ profileId, limit, minDuration }) => {
+        const profile = getRenderProfile(profileId);
+        if (!profile) {
+            throw new Error(`Profile "${profileId}" not found. Call get_render_summary without a profileId to list all loaded profiles.`);
+        }
+        const causes = getRerenderCauses(profile, limit ?? 10, minDuration ?? 0).map(cause => ({
+            ...cause,
+            score: Number(cause.score.toFixed(1)),
+            totalActualDuration: formatMs(cause.totalActualDuration),
+        }));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        profileId,
+                        note: 'Rerender causes are heuristic because exported React Profiler JSON does not include direct prop/state diff metadata.',
+                        scoreDocumentation: {
+                            meaning: '0-10 heuristic rerender risk score. Higher means stronger evidence that repeated rerenders are worth investigating.',
+                            thresholds: {
+                                low: '0.0-2.9',
+                                medium: '3.0-5.9',
+                                high: '6.0-10.0',
+                            },
+                            factors: [
+                                'Repeated update-phase renders',
+                                'Nested update propagation (component listed as updater for its own commit)',
+                                'Presence across many commits',
+                                'Self-intensive render (high self-to-actual ratio, low child delegation)',
+                            ],
+                        },
+                        causes,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=get-rerender-causes.js.map

package/dist/tools/get-rerender-causes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-rerender-causes.js","sourceRoot":"","sources":["../../src/tools/get-rerender-causes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CAAC,qBAAqB,EAAE;QACzC,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,4HAA4H;QACzI,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;YACjH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8GAA8G,CAAC;SAC1K;KACF,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;QAC7C,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,uFAAuF,CAAC,CAAC;QAChI,CAAC;QAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,WAAW,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrF,GAAG,KAAK;YACR,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACrC,mBAAmB,EAAE,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC;SACzD,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,SAAS;wBACT,IAAI,EAAE,sHAAsH;wBAC5H,kBAAkB,EAAE;4BAClB,OAAO,EAAE,qHAAqH;4BAC9H,UAAU,EAAE;gCACV,GAAG,EAAE,SAAS;gCACd,MAAM,EAAE,SAAS;gCACjB,IAAI,EAAE,UAAU;6BACjB;4BACD,OAAO,EAAE;gCACP,+BAA+B;gCAC/B,4EAA4E;gCAC5E,8BAA8B;gCAC9B,yEAAyE;6BAC1E;yBACF;wBACD,MAAM;qBACP,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/get-slow-components.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetSlowComponents(server: McpServer): void;
+//# sourceMappingURL=get-slow-components.d.ts.map

package/dist/tools/get-slow-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-slow-components.d.ts","sourceRoot":"","sources":["../../src/tools/get-slow-components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+BjE"}

package/dist/tools/get-slow-components.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { formatMs } from '../format.js';
+import { getSlowComponents } from '../parser/analysis.js';
+import { getRenderProfile } from '../store.js';
+export function registerGetSlowComponents(server) {
+    server.registerTool('get_slow_components', {
+        title: 'Get Slow Components',
+        description: 'Return the slowest components in a loaded Next.js render profile, ranked by total actual render time.',
+        inputSchema: {
+            profileId: z.string().describe('Profile ID from load_render_profile'),
+            limit: z.number().int().positive().max(25).optional().describe('How many components to return. Defaults to 10.'),
+            sortBy: z.enum(['total', 'average', 'max']).optional().describe('Sort metric: "total" = total render time (default), "average" = average per render, "max" = peak single render time.'),
+            minDuration: z.number().nonnegative().optional().describe('Minimum total actual duration in ms to include. Filters sub-millisecond noise. Defaults to 0.'),
+        },
+    }, async ({ profileId, limit, sortBy, minDuration }) => {
+        const profile = getRenderProfile(profileId);
+        if (!profile) {
+            throw new Error(`Profile "${profileId}" not found. Call get_render_summary without a profileId to list all loaded profiles.`);
+        }
+        const slowComponents = getSlowComponents(profile, limit ?? 10, sortBy ?? 'total', minDuration ?? 0).map((component, index) => ({
+            rank: index + 1,
+            ...component,
+            totalActualDuration: formatMs(component.totalActualDuration),
+            averageActualDuration: formatMs(component.averageActualDuration),
+            maxActualDuration: formatMs(component.maxActualDuration),
+        }));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ profileId, slowComponents }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=get-slow-components.js.map

package/dist/tools/get-slow-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-slow-components.js","sourceRoot":"","sources":["../../src/tools/get-slow-components.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CAAC,qBAAqB,EAAE;QACzC,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,uGAAuG;QACpH,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAChH,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sHAAsH,CAAC;YACvL,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+FAA+F,CAAC;SAC3J;KACF,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;QACrD,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,uFAAuF,CAAC,CAAC;QAChI,CAAC;QAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,MAAM,IAAI,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7H,IAAI,EAAE,KAAK,GAAG,CAAC;YACf,GAAG,SAAS;YACZ,mBAAmB,EAAE,QAAQ,CAAC,SAAS,CAAC,mBAAmB,CAAC;YAC5D,qBAAqB,EAAE,QAAQ,CAAC,SAAS,CAAC,qBAAqB,CAAC;YAChE,iBAAiB,EAAE,QAAQ,CAAC,SAAS,CAAC,iBAAiB,CAAC;SACzD,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC7D,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/load-render-profile.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerLoadRenderProfile(server: McpServer): void;
+//# sourceMappingURL=load-render-profile.d.ts.map

package/dist/tools/load-render-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-render-profile.d.ts","sourceRoot":"","sources":["../../src/tools/load-render-profile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2BjE"}

package/dist/tools/load-render-profile.js

@@ -0,0 +1,34 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+import { formatMs } from '../format.js';
+import { parseRenderProfile } from '../parser/react-profile.js';
+import { storeRenderProfile } from '../store.js';
+export function registerLoadRenderProfile(server) {
+    server.registerTool('load_render_profile', {
+        title: 'Load Render Profile',
+        description: 'Parse and load a React DevTools profiler export captured from a Next.js app. Returns a profile ID for use with the other render analysis tools.',
+        inputSchema: {
+            filePath: z.string().describe('Absolute or relative path to the exported React Profiler JSON file'),
+        },
+    }, async ({ filePath }) => {
+        const absPath = resolve(filePath);
+        const content = await readFile(absPath, 'utf-8');
+        const profile = parseRenderProfile(content, absPath);
+        storeRenderProfile(profile);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        profileId: profile.id,
+                        filename: profile.filename,
+                        version: profile.version,
+                        commitCount: profile.commits.length,
+                        componentCount: profile.components.length,
+                        totalCommitDuration: formatMs(profile.totalCommitDuration),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=load-render-profile.js.map

package/dist/tools/load-render-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-render-profile.js","sourceRoot":"","sources":["../../src/tools/load-render-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CAAC,qBAAqB,EAAE;QACzC,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,iJAAiJ;QAC9J,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;SACpG;KACF,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrD,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAE5B,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,SAAS,EAAE,OAAO,CAAC,EAAE;wBACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;wBACnC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;wBACzC,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC;qBAC3D,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@perfonext/render-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for analyzing Next.js React Profiler exports and render performance",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "perfonext-render-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "inspector": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "github-copilot",
+    "nextjs",
+    "react-profiler",
+    "render",
+    "rerender",
+    "hydration",
+    "performance"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/souvikxcoder/perfonext-render-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/souvikxcoder/perfonext-render-mcp/issues"
+  },
+  "homepage": "https://github.com/souvikxcoder/perfonext-render-mcp#readme",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3",
+    "vitest": "^3.2.4"
+  }
+}