@perfonext/render-mcp 0.2.0 → 0.3.1

package/README.md

@@ -2,38 +2,100 @@
 
 [![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.
+`perfonext-render-mcp` is an MCP server for analyzing React render behavior in Next.js apps and applying fixes
+in the editor. It is the **agent companion** to React DevTools Profiler and `react-scan` — best at
+machine-readable summaries, exact rerender-cause attribution, source-aware follow-up, and diffing.
+
+The loop is **collect → analyze → fix**, all locally:
+
+- **collect** — choose live capture (react-scan/lite streams events in real time) or manual DevTools export
+- **analyze** — the MCP returns structured, machine-readable evidence: component costs, rerender causes, commit breakdowns, and regressions
+- **fix** — Copilot uses that evidence to propose and apply concrete code changes
+
+> **Note:** while a live capture session is active, React DevTools Timeline Profiler will not receive events
+> (react-scan/lite takes over the profiling channel). Calling `stop_render_capture` restores it.
 
 ## What It Does
 
-- loads exported React Profiler JSON files from Next.js apps
+- **live capture** — streams per-commit fiber events from a running React app directly into the MCP over a local HTTP endpoint; no manual export required
+- **manual export** — loads exported React DevTools Profiler JSON files as an alternative input path
 - summarizes commits, the most expensive components, and detected render issues in one call
 - 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
+- highlights components with repeated rerenders, reporting the **exact** changed props/state/hooks when live
+  capture provides `changeDescription` data, and falling back to deterministic heuristics otherwise
+- annotates ranked components with their source file and line when available
+- filters DOM host elements (`div`, `span`, …) and unnamed components out of ranked output so findings stay actionable
 - compares two render profiles to surface regressions and improvements
-- keeps the loaded profiles in memory so an MCP client can iterate without re-reading the file
+- keeps profiles in memory so Copilot can iterate without re-loading
 
 ## Tools
 
+### Entry point
+
+| Tool | Description |
+|------|-------------|
+| `begin_render_analysis` | Entry point. Accepts `approach: "live" \| "manual"`. For `live`: starts a capture session and returns the instrumentation snippet. For `manual`: returns React DevTools Profiler export steps. |
+
+### Live capture
+
+| Tool | Description |
+|------|-------------|
+| `run_render_capture` | Called after instrumentation is wired up. Accepts `method: "manual-interaction" \| "test-suite"`. Returns focused instructions for whichever method the user picks. Test suites must run **headed** (e.g. `playwright test --headed`) so React profiling hooks activate. |
+| `stop_render_capture` | Stop the session, finalize buffered events into a profile, and return a `profileId` plus `dataQuality` (`exact` \| `heuristic`) for analysis |
+| `get_captured_renders` | Optional diagnostic: peek at session progress without stopping (commit count, unknown events). Only call if something seems wrong. |
+
+### Analysis
+
 | Tool | Description |
 |------|-------------|
-| `load_render_profile` | Parse and load an exported React Profiler JSON file from disk |
-| `get_render_summary` | Summarize a loaded profile: top components by render cost, hottest commits, and detected render issues (rerender storms, commit spikes) |
+| `load_render_profile` | Parse and load an exported React DevTools Profiler JSON file from disk (manual path entry point) |
+| `get_render_summary` | Summarize a loaded profile: top components by render cost, hottest commits, and detected render issues |
 | `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` | Explain rerender causes with evidence, confidence, and a risk score. Reports exact changed props/state/hooks when `changeDescription` data is present (`dataQuality: "exact"`), heuristics otherwise |
 | `compare_renders` | Diff two loaded render profiles and rank regressions, improvements, additions, and removals |
 
-`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.
+## Quickstart
+
+Ask Copilot: *"Run a render analysis on my app."*
+
+Copilot calls `begin_render_analysis` and asks you to choose:
+
+**Option A — Live capture (recommended)**
+
+Copilot will:
+1. Start a capture session (ingest server on `127.0.0.1:7721`)
+2. Install `react-scan` as a devDependency if not present
+3. Write `instrumentation-client.js` at your project root with the session snippet
+4. Import it from your app's client-side entry point
+5. Ask whether you want to interact manually or run a test suite (`run_render_capture`)
+6. Stop the session and run analysis
+
+> Running a test suite? Launch it **headed** (e.g. `playwright test --headed`). A headless browser does not
+> expose the React DevTools profiling channel, so `changeDescription` data is unavailable and causes fall back
+> to heuristics (`dataQuality: "heuristic"`).
 
-`get_render_summary` includes an `issues` field with up to 5 detected render issues (commit spikes and rerender storms) so you get actionable findings in the same call as the summary.
+The ingest server runs on a **fixed port (7721)**. Only the `sessionId` line in `instrumentation-client.js` changes between sessions — the file does not need to be re-wired each time.
+
+**Option B — Manual DevTools export**
+
+1. Open React DevTools in the browser → Profiler tab → Record
+2. Interact with the app
+3. Export the JSON and share the file path
+4. Copilot calls `load_render_profile({ filePath: "..." })`
 
 ## Rerender Score Contract
 
-`get_rerender_causes` returns a `score`, `scoreBand`, `confidence`, and `evidence[]` for each component.
+`get_rerender_causes` returns a `dataQuality`, and per component a `score`, `scoreBand`, `confidence`,
+`evidence[]`, and (when known) a `source` file/line.
 
-- `score`: a `0-10` heuristic rerender-risk score
+- `dataQuality`:
+  - `exact`: at least one fiber carried real `changeDescription` data (live capture in a headed browser), so
+    causes name the specific props/state/hooks that changed
+  - `heuristic`: no diff data available (DevTools JSON export, or a headless run), so causes are inferred from
+    render patterns
+- `score`: a `0-10` rerender-risk score
 - `scoreBand`:
   - `low`: `0.0-2.9`
   - `medium`: `3.0-5.9`
@@ -42,19 +104,22 @@
   - `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
+- `evidence[]`: machine-readable signals such as exact change descriptions, repeated updates, nested-update
+  propagation, wide commit spread, or high actual-vs-self duration ratio
 
-Current score inputs are:
+The score ranks investigation order, not exact root cause.
 
-- repeated update-phase renders
-- nested update propagation
-- appearance across many commits
-- high actual-vs-self duration ratio
+## Example Copilot Prompts
 
-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.
+- "Run a render analysis on my app."
+- "Stop the capture and show me the slowest components."
+- "Which components are re-rendering the most and why?"
+- "Compare this run to the profile I captured before the refactor."
+- "I already have a React DevTools export — load it and tell me what's slow."
 
 ## Install
 
+
 Run directly with `npx`:
 
 ```bash
@@ -71,7 +136,7 @@ The executable command remains `perfonext-render-mcp` after installation.
 
 ## MCP Configuration
 
-Add this server to VS Code settings:
+Add to your VS Code `settings.json`:
 
 ```json
 {
@@ -86,15 +151,14 @@ Add this server to VS Code settings:
 }
 ```
 
-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."
-- "Compare `before.json` and `after.json` and tell me which components regressed."
-- "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."
+- "Run a render analysis on my app."
+- "Stop the capture and show me the slowest components."
+- "Which components are re-rendering the most and why?"
+- "Compare this run to the profile I captured before the refactor."
+- "I already have a React DevTools export — load it and tell me what's slow."
+- "Show me the hottest commits and which components dominated each spike."
 
 ## Development
 
@@ -104,7 +168,7 @@ npm run build
 npm test
 ```
 
-Sample fixtures for local validation live under `tests/fixtures/`.
+Sample fixtures live under `tests/fixtures/`.
 
 ## License
 

package/dist/index.js

@@ -7,9 +7,13 @@ 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';
+import { registerBeginRenderAnalysis } from './tools/begin-render-analysis.js';
+import { registerRunRenderCapture } from './tools/run-render-capture.js';
+import { registerStopRenderCapture } from './tools/stop-render-capture.js';
+import { registerGetCapturedRenders } from './tools/get-captured-renders.js';
 const server = new McpServer({
     name: 'perfonext-render-mcp',
-    version: '0.2.0',
+    version: '0.3.0',
 });
 registerLoadRenderProfile(server);
 registerCompareRenders(server);
@@ -17,6 +21,10 @@ registerGetRenderSummary(server);
 registerGetHotCommits(server);
 registerGetSlowComponents(server);
 registerGetRerenderCauses(server);
+registerBeginRenderAnalysis(server);
+registerRunRenderCapture(server);
+registerStopRenderCapture(server);
+registerGetCapturedRenders(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,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,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,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"}
+{"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,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,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;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAEnC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/ingest/server.d.ts

@@ -0,0 +1,54 @@
+export interface ReactScanChangeDescription {
+    props?: string[] | null;
+    state?: string[] | null;
+    context?: string[] | null;
+    hooks?: string[] | null;
+    parent?: boolean;
+    isFirstMount?: boolean;
+}
+export interface ReactScanSource {
+    fileName: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+export interface ReactScanFiberEvent {
+    fiberId: number;
+    name: string;
+    depth: number;
+    actualDuration: number;
+    selfDuration?: number;
+    changeDescription?: ReactScanChangeDescription | null;
+    source?: ReactScanSource | null;
+    parentId?: number | null;
+}
+export interface ReactScanCommitEvent {
+    type: 'commit';
+    sessionId: string;
+    commitIndex: number;
+    rootId: number;
+    duration: number;
+    timestamp: number;
+    priorityName?: string;
+    laneLabels?: string[];
+    updaterNames?: string[];
+    fibers: ReactScanFiberEvent[];
+}
+export interface CaptureSession {
+    sessionId: string;
+    endpoint: string;
+    status: 'active' | 'stopped';
+    commits: ReactScanCommitEvent[];
+    profilingAvailable: boolean | null;
+    startTime: number;
+    /** Count of POST bodies that had no recognizable react-scan/lite `message` field.
+     *  A non-zero value with zero commits usually means the instrumentation snippet
+     *  is not wired correctly (e.g. the import path is wrong or the file runs server-side). */
+    unknownEvents: number;
+}
+export declare function createCaptureSession(): Promise<CaptureSession>;
+export declare function getCaptureSession(sessionId: string): CaptureSession | undefined;
+export declare function stopCaptureSession(sessionId: string): CaptureSession | undefined;
+/** Remove a session from memory once its profile has been stored. */
+export declare function deleteCaptureSession(sessionId: string): void;
+export declare function getServerPort(): number | null;
+//# sourceMappingURL=server.d.ts.map

package/dist/ingest/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ingest/server.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACtD,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAqGD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB;;+FAE2F;IAC3F,aAAa,EAAE,MAAM,CAAC;CACvB;AAuID,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,CAoBpE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE/E;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAKhF;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C"}

package/dist/ingest/server.js

@@ -0,0 +1,212 @@
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+function normalizeFiber(raw) {
+    const cd = raw.changeDescription ?? null;
+    return {
+        fiberId: typeof raw.fiberId === 'number' ? raw.fiberId : 0,
+        name: (typeof raw.name === 'string' && raw.name.trim()) ? raw.name.trim() : '(anonymous)',
+        depth: typeof raw.depth === 'number' ? raw.depth : 0,
+        actualDuration: typeof raw.actualDuration === 'number' ? raw.actualDuration : 0,
+        selfDuration: typeof raw.selfBaseDuration === 'number' ? raw.selfBaseDuration : 0,
+        changeDescription: cd != null ? {
+            isFirstMount: cd.isFirstMount ?? false,
+            props: cd.props ?? null,
+            state: cd.state ? ['state'] : null,
+            context: cd.context ? ['context'] : null,
+            hooks: cd.hooks?.map((i) => `hook[${i}]`) ?? null,
+            parent: cd.parent ?? false,
+        } : null,
+        source: (raw.source && typeof raw.source === 'object') ? raw.source : null,
+        parentId: null,
+    };
+}
+function parseOneEvent(raw, commitIndex, urlSessionId) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const r = raw;
+    // ── Native react-scan/lite endpoint format ────────────────────────────────
+    // Body: { message: LiteEventKind, data: {...}, sessionId, timestamp }
+    if (typeof r.message === 'string') {
+        const data = (r.data && typeof r.data === 'object') ? r.data : {};
+        const ts = typeof r.timestamp === 'number' ? r.timestamp : Date.now();
+        if (r.message === 'commit') {
+            const tree = Array.isArray(data.tree) ? data.tree : [];
+            const fibers = tree.map(normalizeFiber);
+            // Use root-depth fiber's actualDuration as commit duration; fall back to sum.
+            const rootFiber = fibers.find(f => f.depth === 0);
+            const duration = rootFiber?.actualDuration ?? fibers.reduce((s, f) => s + f.actualDuration, 0);
+            return {
+                kind: 'commit',
+                event: {
+                    type: 'commit',
+                    sessionId: urlSessionId, // always use URL sessionId — never trust the body
+                    commitIndex,
+                    rootId: typeof data.rendererId === 'number' ? data.rendererId : 1,
+                    duration,
+                    timestamp: ts,
+                    priorityName: typeof data.priorityName === 'string' ? data.priorityName : undefined,
+                    laneLabels: Array.isArray(data.laneLabels) ? data.laneLabels : undefined,
+                    updaterNames: [],
+                    fibers,
+                },
+            };
+        }
+        if (r.message === 'profiling-hooks-status') {
+            return { kind: 'status', available: data.available === true };
+        }
+        return null; // other event kinds (render-start, post-commit, fiber-unmount, etc.) — expected noise
+    }
+    return null; // no `message` field — not a react-scan/lite payload
+}
+// ---------------------------------------------------------------------------
+// Singleton HTTP server state
+// ---------------------------------------------------------------------------
+const sessions = new Map();
+let httpServer = null;
+let serverPort = null;
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', reject);
+    });
+}
+function handleRequest(req, res) {
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+    if (req.method === 'OPTIONS') {
+        res.writeHead(204);
+        res.end();
+        return;
+    }
+    const url = req.url ?? '';
+    const match = url.match(/^\/ingest\/([^/]+)$/);
+    if (!match || req.method !== 'POST') {
+        res.writeHead(404);
+        res.end(JSON.stringify({ error: 'not found' }));
+        return;
+    }
+    const sessionId = decodeURIComponent(match[1]);
+    const session = sessions.get(sessionId);
+    if (!session) {
+        res.writeHead(404);
+        res.end(JSON.stringify({ error: 'session not found' }));
+        return;
+    }
+    if (session.status !== 'active') {
+        res.writeHead(410);
+        res.end(JSON.stringify({ error: 'session already stopped' }));
+        return;
+    }
+    readBody(req)
+        .then(body => {
+        let rawEvents;
+        try {
+            const parsed = JSON.parse(body);
+            rawEvents = Array.isArray(parsed) ? parsed : [parsed];
+        }
+        catch {
+            res.writeHead(400);
+            res.end(JSON.stringify({ error: 'invalid JSON' }));
+            return;
+        }
+        let received = 0;
+        for (const raw of rawEvents) {
+            const normalized = parseOneEvent(raw, session.commits.length, sessionId);
+            if (!normalized) {
+                if (raw && typeof raw === 'object' && !('message' in raw)) {
+                    session.unknownEvents++;
+                }
+                continue;
+            }
+            received++;
+            if (normalized.kind === 'commit') {
+                session.commits.push(normalized.event);
+            }
+            else if (normalized.kind === 'status') {
+                session.profilingAvailable = normalized.available;
+            }
+        }
+        res.writeHead(200);
+        res.end(JSON.stringify({ ok: true, received }));
+    })
+        .catch(() => {
+        res.writeHead(500);
+        res.end(JSON.stringify({ error: 'internal error' }));
+    });
+}
+// Default port 7721; override with PERFONEXT_INGEST_PORT.
+const _rawPort = parseInt(process.env.PERFONEXT_INGEST_PORT ?? '7721', 10);
+if (!Number.isFinite(_rawPort) || _rawPort < 1 || _rawPort > 65535) {
+    throw new Error(`PERFONEXT_INGEST_PORT must be a number between 1 and 65535 (got: "${process.env.PERFONEXT_INGEST_PORT}")`);
+}
+const INGEST_PORT = _rawPort;
+function startHttpServer() {
+    return new Promise((resolve, reject) => {
+        const server = createServer(handleRequest);
+        // Bind to loopback only — no external exposure.
+        server.listen(INGEST_PORT, '127.0.0.1', () => {
+            const addr = server.address();
+            if (!addr || typeof addr === 'string') {
+                reject(new Error('Unexpected server address'));
+                return;
+            }
+            httpServer = server;
+            serverPort = addr.port;
+            resolve(addr.port);
+        });
+        server.on('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                reject(new Error(`Ingest server port ${INGEST_PORT} is already in use. ` +
+                    'Free the port or set PERFONEXT_INGEST_PORT to a different value.'));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function createCaptureSession() {
+    if (!httpServer) {
+        await startHttpServer();
+    }
+    const sessionId = randomUUID();
+    const endpoint = `http://127.0.0.1:${serverPort}/ingest/${sessionId}`;
+    const session = {
+        sessionId,
+        endpoint,
+        status: 'active',
+        commits: [],
+        profilingAvailable: null,
+        startTime: Date.now(),
+        unknownEvents: 0,
+    };
+    sessions.set(sessionId, session);
+    return session;
+}
+export function getCaptureSession(sessionId) {
+    return sessions.get(sessionId);
+}
+export function stopCaptureSession(sessionId) {
+    const session = sessions.get(sessionId);
+    if (!session)
+        return undefined;
+    session.status = 'stopped';
+    return session;
+}
+/** Remove a session from memory once its profile has been stored. */
+export function deleteCaptureSession(sessionId) {
+    sessions.delete(sessionId);
+}
+export function getServerPort() {
+    return serverPort;
+}
+//# sourceMappingURL=server.js.map

package/dist/ingest/server.js.map

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

package/dist/parser/analysis.d.ts

@@ -1,4 +1,6 @@
 import type { CommitBreakdown, HotCommitSummary, ParsedRenderProfile, RenderComparison, RenderIssue, RenderPropagationPath, RenderSummaryEntry, RerenderCause } from './types.js';
+/** Returns true for named React components that appear in ranked analysis output. */
+export declare function isAnalyzableComponent(name: string): boolean;
 export declare function getHotCommits(profile: ParsedRenderProfile, limit?: number, componentLimit?: number, priorityLevel?: string): HotCommitSummary[];
 export declare function getRenderSummary(profile: ParsedRenderProfile, limit?: number): {
     profileId: string;
@@ -12,6 +14,8 @@ export declare function getRenderSummary(profile: ParsedRenderProfile, limit?: n
     topComponents: RenderSummaryEntry[];
     hotCommits: HotCommitSummary[];
     issues: RenderIssue[];
+    warnings: string[];
+    dataQuality: 'heuristic' | 'exact';
 };
 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[];

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

@@ -1 +1 @@
-{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/parser/analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAIf,gBAAgB,EAChB,mBAAmB,EAEnB,gBAAgB,EAEhB,WAAW,EAGX,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EAId,MAAM,YAAY,CAAC;AAwFpB,wBAAgB,aAAa,CAC3B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,SAAK,EACV,cAAc,SAAI,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,EAAE,CAsBpB;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;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAcA;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;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,EAAE,MAAM,EACnB,cAAc,SAAI,GACjB,eAAe,GAAG,IAAI,CA4ExB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,EAAE,MAAM,EACnB,KAAK,SAAK,GACT,qBAAqB,EAAE,CA0JzB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,SAAK,GAAG,WAAW,EAAE,CAyE1F;AA8CD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,mBAAmB,EAChC,cAAc,EAAE,mBAAmB,EACnC,KAAK,SAAK,EACV,QAAQ,SAAI,GACX,gBAAgB,CAyBlB"}
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/parser/analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAKf,gBAAgB,EAChB,mBAAmB,EAEnB,gBAAgB,EAEhB,WAAW,EAGX,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EAId,MAAM,YAAY,CAAC;AAyBpB,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AA6ED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,SAAK,EACV,cAAc,SAAI,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,EAAE,CAsBpB;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;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;CACpC,CA6BA;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,CA+BtB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,SAAK,EAAE,WAAW,SAAI,GAAG,aAAa,EAAE,CA+K5G;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,EAAE,MAAM,EACnB,cAAc,SAAI,GACjB,eAAe,GAAG,IAAI,CA4ExB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,EAAE,MAAM,EACnB,KAAK,SAAK,GACT,qBAAqB,EAAE,CA0JzB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,SAAK,GAAG,WAAW,EAAE,CAyE1F;AA8CD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,mBAAmB,EAChC,cAAc,EAAE,mBAAmB,EACnC,KAAK,SAAK,EACV,QAAQ,SAAI,GACX,gBAAgB,CAyBlB"}