@perfonext/build-mcp 0.1.0 → 0.3.0

package/dist/parser/webpack-stats.js

@@ -0,0 +1,195 @@
+import { readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+const NODE_MODULES_MARKER = 'node_modules/';
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+function toFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+function toStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((item) => typeof item === 'string');
+}
+/**
+ * Resolve the npm package an emitted module belongs to. Uses the LAST `node_modules/` segment so
+ * nested installs (`a/node_modules/b`) attribute to the inner package, and preserves scoped names
+ * (`@org/pkg`). Returns null for first-party application code.
+ */
+export function extractPackageName(moduleName) {
+    // Webpack `name` uses POSIX separators, but the `identifier` fallback can carry
+    // Windows backslashes — normalize so attribution works on every platform.
+    const normalized = moduleName.replace(/\\/g, '/');
+    const markerIndex = normalized.lastIndexOf(NODE_MODULES_MARKER);
+    if (markerIndex === -1) {
+        return null;
+    }
+    const rest = normalized.slice(markerIndex + NODE_MODULES_MARKER.length);
+    const parts = rest.split('/').filter(Boolean);
+    if (parts.length === 0) {
+        return null;
+    }
+    if (parts[0].startsWith('@') && parts.length >= 2) {
+        return `${parts[0]}/${parts[1]}`;
+    }
+    return parts[0];
+}
+function normalizeReason(raw) {
+    if (!isRecord(raw)) {
+        return null;
+    }
+    const moduleName = typeof raw.moduleName === 'string' ? raw.moduleName : null;
+    const userRequest = typeof raw.userRequest === 'string' ? raw.userRequest : null;
+    if (moduleName === null && userRequest === null) {
+        return null;
+    }
+    return { moduleName, userRequest };
+}
+function normalizeModule(raw) {
+    const name = typeof raw.name === 'string'
+        ? raw.name
+        : typeof raw.identifier === 'string'
+            ? raw.identifier
+            : null;
+    if (!name) {
+        return null;
+    }
+    const chunkIds = Array.isArray(raw.chunks)
+        ? raw.chunks.filter((id) => typeof id === 'string' || typeof id === 'number')
+        : [];
+    const reasons = Array.isArray(raw.reasons)
+        ? raw.reasons
+            .map(normalizeReason)
+            .filter((reason) => reason !== null)
+        : [];
+    return {
+        name,
+        packageName: extractPackageName(name),
+        sizeBytes: toFiniteNumber(raw.size),
+        chunkIds,
+        reasons,
+    };
+}
+function normalizeChunk(raw) {
+    if (raw.id === undefined || (typeof raw.id !== 'string' && typeof raw.id !== 'number')) {
+        return null;
+    }
+    return {
+        id: raw.id,
+        names: toStringArray(raw.names),
+        files: toStringArray(raw.files),
+        sizeBytes: toFiniteNumber(raw.size),
+    };
+}
+/**
+ * Parse a webpack module-stats JSON (`.next/stats.json`) into a compact, analysis-ready shape.
+ * Only the fields the attribution tools need are retained — raw source, asset maps, and other
+ * webpack noise are dropped so a multi-MB stats file stays small in memory.
+ */
+export async function parseWebpackStats(buildDirPath, buildId) {
+    const buildDir = resolve(buildDirPath);
+    const statsPath = join(buildDir, 'stats.json');
+    let content;
+    try {
+        content = await readFile(statsPath, 'utf-8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+    let raw;
+    try {
+        raw = JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse webpack stats JSON at ${statsPath} (build "${buildId}"): ${error.message}`);
+    }
+    const rawModules = Array.isArray(raw.modules) ? raw.modules : [];
+    const rawChunks = Array.isArray(raw.chunks) ? raw.chunks : [];
+    const modules = rawModules
+        .map(module => normalizeModule(module))
+        .filter((module) => module !== null);
+    const chunks = rawChunks
+        .map(chunk => normalizeChunk(chunk))
+        .filter((chunk) => chunk !== null);
+    return {
+        buildId,
+        statsPath,
+        modules,
+        chunks,
+        moduleCount: rawModules.length,
+        parsedModuleCount: modules.length,
+    };
+}
+function buildModuleIndex(stats) {
+    const index = new Map();
+    for (const module of stats.modules) {
+        index.set(module.name, module);
+    }
+    return index;
+}
+function chunkFilesForModule(module, chunkById) {
+    const files = new Set();
+    for (const chunkId of module.chunkIds) {
+        const chunk = chunkById.get(chunkId);
+        for (const file of chunk?.files ?? []) {
+            files.add(file);
+        }
+    }
+    return Array.from(files).sort();
+}
+/**
+ * Walk a module's `reasons` upward to the nearest entry to explain why it is bundled. Picks the
+ * first resolvable parent at each step, guards against cycles, and caps depth so a pathological
+ * graph cannot loop. Returns the chain ordered from entry → target.
+ */
+function buildImportChain(target, moduleIndex) {
+    const chain = [
+        { moduleName: target.name, packageName: target.packageName },
+    ];
+    const visited = new Set([target.name]);
+    let current = target;
+    const maxDepth = 25;
+    for (let depth = 0; depth < maxDepth; depth += 1) {
+        const parentReason = current.reasons.find(reason => reason.moduleName !== null && !visited.has(reason.moduleName));
+        if (!parentReason || parentReason.moduleName === null) {
+            break;
+        }
+        const parent = moduleIndex.get(parentReason.moduleName);
+        visited.add(parentReason.moduleName);
+        chain.push({
+            moduleName: parentReason.moduleName,
+            packageName: parent?.packageName ?? extractPackageName(parentReason.moduleName),
+        });
+        if (!parent || parent.reasons.length === 0) {
+            break;
+        }
+        current = parent;
+    }
+    return chain.reverse();
+}
+export function traceImport(stats, moduleName, limit = 10) {
+    const query = moduleName.toLowerCase();
+    const moduleIndex = buildModuleIndex(stats);
+    const chunkById = new Map(stats.chunks.map(chunk => [chunk.id, chunk]));
+    const matches = stats.modules
+        .filter(module => module.name.toLowerCase().includes(query))
+        .sort((left, right) => right.sizeBytes - left.sizeBytes);
+    const traces = matches.slice(0, limit).map(module => ({
+        moduleName: module.name,
+        packageName: module.packageName,
+        sizeBytes: module.sizeBytes,
+        chunkFiles: chunkFilesForModule(module, chunkById),
+        importChain: buildImportChain(module, moduleIndex),
+    }));
+    return {
+        query: moduleName,
+        matchCount: matches.length,
+        traces,
+    };
+}
+//# sourceMappingURL=webpack-stats.js.map

package/dist/parser/webpack-stats.js.map

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

package/dist/store.d.ts

@@ -1,6 +1,8 @@
-import type { ParsedBuildStats } from './parser/types.js';
+import type { ParsedBuildStats, ParsedWebpackStats } from './parser/types.js';
 export declare function storeBuildStats(build: ParsedBuildStats): void;
 export declare function getBuildStats(id: string): ParsedBuildStats | undefined;
+export declare function storeWebpackStats(stats: ParsedWebpackStats): void;
+export declare function getWebpackStats(buildId: string): ParsedWebpackStats | undefined;
 export declare function listBuildStats(): Array<{
     id: string;
     buildDir: string;

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEtE;AAED,wBAAgB,cAAc,IAAI,KAAK,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC,CASD"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAK9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAEjE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE/E;AAED,wBAAgB,cAAc,IAAI,KAAK,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC,CASD"}

package/dist/store.js

@@ -1,10 +1,17 @@
 const builds = new Map();
+const webpackStats = new Map();
 export function storeBuildStats(build) {
     builds.set(build.id, build);
 }
 export function getBuildStats(id) {
     return builds.get(id);
 }
+export function storeWebpackStats(stats) {
+    webpackStats.set(stats.buildId, stats);
+}
+export function getWebpackStats(buildId) {
+    return webpackStats.get(buildId);
+}
 export function listBuildStats() {
     return Array.from(builds.values()).map(build => ({
         id: build.id,

package/dist/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEnD,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,cAAc;IAQ5B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/C,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC/B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC/B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;AACnD,MAAM,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAC;AAE3D,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc;IAQ5B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/C,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC/B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC/B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/tools/explain-growth.d.ts

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

package/dist/tools/explain-growth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-growth.d.ts","sourceRoot":"","sources":["../../src/tools/explain-growth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+F7D"}

package/dist/tools/explain-growth.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { formatBytes, formatPct } from '../format.js';
+import { explainGrowth as explainBuildGrowth } from '../parser/analysis.js';
+import { getBuildStats, listBuildStats } from '../store.js';
+function formatNullableRatio(value) {
+    return value === null ? null : formatPct(value);
+}
+export function registerExplainGrowth(server) {
+    server.registerTool('explain_growth', {
+        title: 'Explain Growth',
+        description: 'Identify which routes and chunks are responsible for bundle size growth between two loaded builds. ' +
+            'Returns severity-ranked route findings, the top growing chunks, and an overall regression summary.',
+        inputSchema: {
+            baselineBuildId: z
+                .string()
+                .optional()
+                .describe('Baseline build ID from load_build_stats. Omit to list loaded builds.'),
+            currentBuildId: z
+                .string()
+                .optional()
+                .describe('Current build ID from load_build_stats. Omit to list loaded builds.'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(25)
+                .optional()
+                .describe('Max route findings and top growing chunks to return. Defaults to 10.'),
+        },
+    }, async ({ baselineBuildId, currentBuildId, limit }) => {
+        if (!baselineBuildId || !currentBuildId) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            builds: listBuildStats().map(build => ({
+                                id: build.id,
+                                buildDir: build.buildDir,
+                                routeCount: build.routeCount,
+                                totalChunkBytes: build.totalChunkBytes,
+                                totalChunkBytesText: formatBytes(build.totalChunkBytes),
+                            })),
+                        }, null, 2),
+                    }],
+            };
+        }
+        const baseline = getBuildStats(baselineBuildId);
+        if (!baseline) {
+            throw new Error(`Build "${baselineBuildId}" not found. Call explain_growth without IDs to list loaded builds.`);
+        }
+        const current = getBuildStats(currentBuildId);
+        if (!current) {
+            throw new Error(`Build "${currentBuildId}" not found. Call explain_growth without IDs to list loaded builds.`);
+        }
+        const explanation = explainBuildGrowth(baseline, current, limit ?? 10);
+        const hasGrowth = explanation.routeFindings.length > 0 || explanation.topGrowingChunks.length > 0;
+        const nextStep = hasGrowth
+            ? `Inspect the largest contributors with get_shared_chunks and get_largest_routes on build '${current.id}', then apply the recommended actions.`
+            : `No bundle growth detected between '${baseline.id}' and '${current.id}'.`;
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        ...explanation,
+                        overall: {
+                            ...explanation.overall,
+                            totalDeltaBytesText: formatBytes(Math.abs(explanation.overall.totalDeltaBytes)),
+                            totalDeltaDirection: explanation.overall.totalDeltaBytes >= 0 ? 'growth' : 'shrink',
+                            totalDeltaRatioText: formatNullableRatio(explanation.overall.totalDeltaRatio),
+                        },
+                        routeFindings: explanation.routeFindings.map(finding => ({
+                            ...finding,
+                            deltaBytesText: formatBytes(finding.deltaBytes),
+                            deltaRatioText: formatNullableRatio(finding.deltaRatio),
+                            topContributingChunks: finding.topContributingChunks.map(chunk => ({
+                                ...chunk,
+                                deltaBytesText: formatBytes(chunk.deltaBytes),
+                                deltaRatioText: formatNullableRatio(chunk.deltaRatio),
+                            })),
+                        })),
+                        topGrowingChunks: explanation.topGrowingChunks.map(chunk => ({
+                            ...chunk,
+                            deltaBytesText: formatBytes(chunk.deltaBytes),
+                            deltaRatioText: formatNullableRatio(chunk.deltaRatio),
+                        })),
+                        suggestions: explanation.suggestions.map(suggestion => ({
+                            ...suggestion,
+                            deltaBytesText: formatBytes(suggestion.deltaBytes),
+                            deltaRatioText: formatNullableRatio(suggestion.deltaRatio),
+                        })),
+                        nextStep,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=explain-growth.js.map

package/dist/tools/explain-growth.js.map

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

package/dist/tools/how-to-collect-stats.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerHowToCollectStats(server: McpServer): void;
+//# sourceMappingURL=how-to-collect-stats.d.ts.map

package/dist/tools/how-to-collect-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"how-to-collect-stats.d.ts","sourceRoot":"","sources":["../../src/tools/how-to-collect-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4HpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8BjE"}

package/dist/tools/how-to-collect-stats.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+const NEXT_CONFIG_WEBPACK_SNIPPET = `// next.config.ts — write .next/stats.json only when ANALYZE=true
+import type { NextConfig } from "next";
+import { StatsWriterPlugin } from "webpack-stats-plugin";
+
+const nextConfig: NextConfig = {
+  webpack(config) {
+    if (process.env.ANALYZE === "true") {
+      config.plugins.push(
+        new StatsWriterPlugin({
+          filename: "stats.json", // -> .next/stats.json
+          // ids + large modulesSpace are required: without them webpack drops
+          // chunk ids and collapses the module list, yielding empty attribution.
+          stats: {
+            all: false,
+            modules: true,
+            chunks: true,
+            chunkModules: true,
+            reasons: true,
+            ids: true,
+            nestedModules: true,
+            modulesSpace: Infinity,
+            chunkModulesSpace: Infinity,
+          },
+        }),
+      );
+    }
+    return config;
+  },
+};
+
+export default nextConfig;`;
+function buildManualResponse(scenario) {
+    if (scenario === 'turbopack') {
+        return turbopackResponse();
+    }
+    return {
+        method: 'manual',
+        steps: [
+            {
+                step: 1,
+                title: 'Add the dev dependency',
+                command: 'npm install --save-dev webpack-stats-plugin',
+            },
+            {
+                step: 2,
+                title: 'Emit stats behind an ANALYZE flag in next.config',
+                snippet: NEXT_CONFIG_WEBPACK_SNIPPET,
+            },
+            {
+                step: 3,
+                title: 'Build with the flag set',
+                command: 'ANALYZE=true next build',
+            },
+        ],
+        producesFile: '.next/stats.json',
+        nextStep: 'Once .next/stats.json exists, call load_webpack_stats with the same buildDir and the buildId from load_build_stats.',
+    };
+}
+function buildAutomaticResponse(scenario) {
+    if (scenario === 'turbopack') {
+        return turbopackResponse();
+    }
+    return {
+        method: 'automatic',
+        actions: [
+            {
+                action: 'add-dev-dependency',
+                run: 'npm install --save-dev webpack-stats-plugin',
+            },
+            {
+                action: 'edit-next-config',
+                description: 'Add a webpack hook gated behind ANALYZE=true that writes .next/stats.json.',
+                snippet: NEXT_CONFIG_WEBPACK_SNIPPET,
+            },
+            {
+                action: 'add-package-script',
+                script: { analyze: 'ANALYZE=true next build' },
+            },
+            {
+                action: 'run-build',
+                run: 'npm run analyze',
+            },
+            {
+                action: 'verify-output',
+                description: 'Confirm .next/stats.json exists before loading it.',
+            },
+        ],
+        producesFile: '.next/stats.json',
+        nextStep: 'After .next/stats.json exists, call load_webpack_stats with the same buildDir and the buildId from load_build_stats.',
+    };
+}
+function turbopackResponse() {
+    return {
+        method: 'unavailable',
+        scenario: 'turbopack',
+        summary: 'Turbopack has no webpack module graph, so .next/stats.json cannot be produced and trace_import cannot run.',
+        guidance: 'Run a one-off webpack build (omit --turbopack) with the stats hook to use trace_import, or stay on the manifest-only tools.',
+        manifestOnlyTools: [
+            'load_build_stats',
+            'get_largest_routes',
+            'get_shared_chunks',
+            'compare_builds',
+            'explain_growth',
+        ],
+        nextStep: 'Rebuild with webpack to produce .next/stats.json, or continue with get_largest_routes / get_shared_chunks on the build you already loaded.',
+    };
+}
+export function registerHowToCollectStats(server) {
+    server.registerTool('how_to_collect_stats', {
+        title: 'How To Collect Webpack Stats',
+        description: 'Explain how to generate the webpack stats file (.next/stats.json) required by the bundle attribution ' +
+            'tools. Choose manual (a recipe you apply yourself) or automatic (an action plan Copilot executes).',
+        inputSchema: {
+            method: z
+                .enum(['manual', 'automatic'])
+                .describe('manual: return a recipe to apply yourself. automatic: return an action plan for Copilot to execute.'),
+            scenario: z
+                .enum(['webpack', 'turbopack'])
+                .optional()
+                .describe('Collection context. Defaults to webpack. Use turbopack if the app builds with --turbopack.'),
+        },
+    }, async ({ method, scenario }) => {
+        const resolvedScenario = scenario ?? 'webpack';
+        const resolvedMethod = method;
+        const payload = resolvedMethod === 'manual'
+            ? buildManualResponse(resolvedScenario)
+            : buildAutomaticResponse(resolvedScenario);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(payload, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=how-to-collect-stats.js.map

package/dist/tools/how-to-collect-stats.js.map

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

package/dist/tools/load-webpack-stats.d.ts

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

package/dist/tools/load-webpack-stats.d.ts.map

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

package/dist/tools/load-webpack-stats.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { parseWebpackStats } from '../parser/webpack-stats.js';
+import { getBuildStats, storeWebpackStats } from '../store.js';
+import { statsTextResult } from './webpack-shared.js';
+export function registerLoadWebpackStats(server) {
+    server.registerTool('load_webpack_stats', {
+        title: 'Load Webpack Stats',
+        description: 'Parse the webpack module stats file (.next/stats.json) and link it to a build loaded with ' +
+            'load_build_stats. Required before trace_import.',
+        inputSchema: {
+            buildId: z.string().describe('Build ID returned by load_build_stats; the stats.json is read from that build directory'),
+        },
+    }, async ({ buildId }) => {
+        const build = getBuildStats(buildId);
+        if (!build) {
+            throw new Error(`Build "${buildId}" not found. Call load_build_stats first and pass the buildId it returns.`);
+        }
+        const stats = await parseWebpackStats(build.buildDir, buildId);
+        if (!stats) {
+            return statsTextResult({
+                buildId,
+                webpackStatsLoaded: false,
+                message: `No stats.json found in ${build.buildDir}. A stock next build does not emit one.`,
+                nextStep: 'Call how_to_collect_stats to generate .next/stats.json, then load_webpack_stats again.',
+            });
+        }
+        storeWebpackStats(stats);
+        const looksCollapsed = stats.parsedModuleCount === 0 || stats.chunks.length === 0;
+        return statsTextResult({
+            buildId,
+            webpackStatsLoaded: true,
+            statsPath: stats.statsPath,
+            moduleCount: stats.moduleCount,
+            parsedModuleCount: stats.parsedModuleCount,
+            chunkCount: stats.chunks.length,
+            ...(looksCollapsed
+                ? {
+                    warning: 'The stats file parsed but contains no usable modules/chunks. This usually means the stats ' +
+                        'config collapsed the module graph (webpack groups modules once `modulesSpace` is exceeded and ' +
+                        'omits chunk ids unless `ids: true`). Re-run how_to_collect_stats for the corrected config and rebuild.',
+                }
+                : {}),
+            nextStep: looksCollapsed
+                ? 'Call how_to_collect_stats again, apply the corrected stats config, rebuild, then load_webpack_stats.'
+                : 'Now call trace_import with a module or package name (e.g. a heavy dependency) to see why it is bundled.',
+        });
+    });
+}
+//# sourceMappingURL=load-webpack-stats.js.map

package/dist/tools/load-webpack-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-webpack-stats.js","sourceRoot":"","sources":["../../src/tools/load-webpack-stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE;QACxC,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,4FAA4F;YAC5F,iDAAiD;QACnD,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yFAAyF,CAAC;SACxH;KACF,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,2EAA2E,CAAC,CAAC;QAChH,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,eAAe,CAAC;gBACrB,OAAO;gBACP,kBAAkB,EAAE,KAAK;gBACzB,OAAO,EAAE,0BAA0B,KAAK,CAAC,QAAQ,yCAAyC;gBAC1F,QAAQ,EAAE,wFAAwF;aACnG,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QAClF,OAAO,eAAe,CAAC;YACrB,OAAO;YACP,kBAAkB,EAAE,IAAI;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;YAC1C,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC/B,GAAG,CAAC,cAAc;gBAChB,CAAC,CAAC;oBACE,OAAO,EACL,4FAA4F;wBAC5F,gGAAgG;wBAChG,wGAAwG;iBAC3G;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,QAAQ,EAAE,cAAc;gBACtB,CAAC,CAAC,sGAAsG;gBACxG,CAAC,CAAC,yGAAyG;SAC9G,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/trace-import.d.ts

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

package/dist/tools/trace-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-import.d.ts","sourceRoot":"","sources":["../../src/tools/trace-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqC3D"}

package/dist/tools/trace-import.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { formatBytes } from '../format.js';
+import { traceImport } from '../parser/webpack-stats.js';
+import { getBuildStats } from '../store.js';
+import { resolveWebpackStats, statsTextResult } from './webpack-shared.js';
+export function registerTraceImport(server) {
+    server.registerTool('trace_import', {
+        title: 'Trace Import',
+        description: 'Explain why a module is bundled by tracing its import chain from an entry point to the module. ' +
+            'Requires load_webpack_stats first.',
+        inputSchema: {
+            buildId: z.string().describe('Build ID returned by load_build_stats'),
+            moduleName: z.string().describe('Module or package name to search for (case-insensitive substring), e.g. "lodash"'),
+            limit: z.number().int().positive().max(25).optional().describe('Maximum matching modules to trace. Defaults to 10.'),
+        },
+    }, async ({ buildId, moduleName, limit }) => {
+        const build = getBuildStats(buildId);
+        if (!build) {
+            throw new Error(`Build "${buildId}" not found. Call load_build_stats first.`);
+        }
+        const resolved = resolveWebpackStats(buildId);
+        if ('breadcrumb' in resolved) {
+            return statsTextResult(resolved.breadcrumb);
+        }
+        const result = traceImport(resolved.stats, moduleName, limit ?? 10);
+        return statsTextResult({
+            buildId,
+            query: result.query,
+            matchCount: result.matchCount,
+            traces: result.traces.map(trace => ({
+                moduleName: trace.moduleName,
+                packageName: trace.packageName,
+                sizeBytes: trace.sizeBytes,
+                sizeBytesText: formatBytes(trace.sizeBytes),
+                chunkFiles: trace.chunkFiles,
+                importChain: trace.importChain,
+            })),
+        });
+    });
+}
+//# sourceMappingURL=trace-import.js.map

package/dist/tools/trace-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-import.js","sourceRoot":"","sources":["../../src/tools/trace-import.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3E,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE;QAClC,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,iGAAiG;YACjG,oCAAoC;QACtC,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACrE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kFAAkF,CAAC;YACnH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;SACrH;KACF,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,2CAA2C,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACpE,OAAO,eAAe,CAAC;YACrB,OAAO;YACP,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAClC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC;gBAC3C,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}