nfunc-mcp 0.3.0 → 0.4.0

package/dist/mappers/webVitalsMapper.js

@@ -0,0 +1,131 @@
+/**
+ * Core Web Vitals field data → priorities and defect prose.
+ *
+ * The lab side of a PSI response goes through the existing
+ * `formatLighthouseFinding` path unchanged. This module handles the CrUX half,
+ * where the inputs are 75th-percentile measurements from real users rather
+ * than audit scores, so neither the impact-weight mapping nor the WCAG
+ * technique table applies.
+ *
+ * Field findings are written to read differently from lab findings on purpose.
+ * A lab finding says the page did something under simulation; a field finding
+ * says a measurable share of real people already experienced it. That
+ * distinction is the whole reason to call PSI, and it should survive into the
+ * defect ticket.
+ */
+/** Google's official p75 boundaries. */
+const VITALS = {
+    lcp: { label: "Largest Contentful Paint", good: 2500, needsImprovement: 4000, isCoreVital: true },
+    inp: { label: "Interaction to Next Paint", good: 200, needsImprovement: 500, isCoreVital: true },
+    cls: { label: "Cumulative Layout Shift", good: 0.1, needsImprovement: 0.25, isCoreVital: true },
+    fcp: { label: "First Contentful Paint", good: 1800, needsImprovement: 3000, isCoreVital: false },
+    ttfb: { label: "Time to First Byte", good: 800, needsImprovement: 1800, isCoreVital: false },
+};
+export function vitalLabel(vital) {
+    return VITALS[vital].label;
+}
+/**
+ * LCP, INP and CLS gate a release and affect ranking; FCP and TTFB explain
+ * them. Exported because the priority cap has to hold everywhere a priority is
+ * decided, not just where one is first assigned.
+ */
+export function isCoreVital(vital) {
+    return VITALS[vital].isCoreVital;
+}
+/**
+ * Rate a p75 value against Google's thresholds.
+ *
+ * PSI also returns its own FAST/AVERAGE/SLOW `category` per metric, and the two
+ * agree in practice. We classify from the published thresholds anyway, so that
+ * the boundary a finding was raised at is a documented number in this file
+ * rather than a verdict from an opaque field — and so origin-level and
+ * URL-level metrics are graded identically.
+ */
+export function classifyVital(vital, p75) {
+    const spec = VITALS[vital];
+    if (p75 <= spec.good)
+        return "good";
+    if (p75 <= spec.needsImprovement)
+        return "needs-improvement";
+    return "poor";
+}
+/**
+ * Poor → P1, needs improvement → P2, good → no finding (never report a passing
+ * check). Non-core diagnostics cap at P2.
+ */
+export function fieldVitalToPriority(vital, p75) {
+    const rating = classifyVital(vital, p75);
+    if (rating === "good")
+        return null;
+    if (rating === "needs-improvement")
+        return "P2";
+    return VITALS[vital].isCoreVital ? "P1" : "P2";
+}
+/** Human-readable measurement. CLS is unitless; everything else is milliseconds. */
+export function formatVitalValue(vital, value) {
+    if (vital === "cls")
+        return value.toFixed(3).replace(/0+$/, "").replace(/\.$/, "");
+    return value >= 1000 ? `${(value / 1000).toFixed(1)} s` : `${Math.round(value)} ms`;
+}
+/** "7 in 10 users" reads more concretely in a ticket than "0.7019". */
+function shareOfUsers(proportion) {
+    const pct = Math.round(proportion * 100);
+    return `${pct}% of real users`;
+}
+/**
+ * Defect prose for each vital, in the register `defectFormatter.ts` established:
+ * what the user experiences, not what the metric is called.
+ *
+ * Every template states the share of real users in the poor bucket. A p75 alone
+ * invites the reply "that's just the tail" — naming the proportion answers it
+ * before it is asked, and the number is already in the response.
+ */
+const FIELD_DESCRIPTIONS = {
+    lcp: (_m, value, poor) => `Real users wait ${value} for the main page content to appear (75th percentile, trailing 28 days). ${poor} experience a load slow enough to be rated poor, well past the point where visitors begin abandoning the page.`,
+    inp: (_m, value, poor) => `The page takes ${value} to respond visibly after a real user taps or clicks (75th percentile, trailing 28 days). ${poor} experience responsiveness rated poor — taps appear to do nothing, so users tap again and trigger duplicate actions.`,
+    cls: (_m, value, poor) => `Real users see the layout shift by ${value} while the page loads (75th percentile, trailing 28 days). ${poor} experience shifting rated poor, which causes mis-taps on the wrong control and loss of reading position.`,
+    fcp: (_m, value, poor) => `Real users stare at a blank screen for ${value} before anything paints (75th percentile, trailing 28 days). ${poor} experience a first paint rated poor. This is a diagnostic for the slow Largest Contentful Paint rather than a defect to fix on its own.`,
+    ttfb: (_m, value, poor) => `The server takes ${value} to return the first byte for real users (75th percentile, trailing 28 days). ${poor} experience a response rated poor; every downstream resource waits on this, so it caps how fast the rest of the page can possibly be.`,
+};
+/**
+ * One field metric → a Finding, or null when real users are having a fine time.
+ *
+ * `source` reaches the evidence deliberately. An origin-level metric describes
+ * the whole site, not this page, and a reader deciding whether to act on the
+ * finding needs to know which they are looking at.
+ */
+export function formatFieldFinding(vital, metric) {
+    const priority = fieldVitalToPriority(vital, metric.p75);
+    if (!priority)
+        return null;
+    const value = formatVitalValue(vital, metric.p75);
+    const poor = shareOfUsers(metric.distribution.poor);
+    const spec = VITALS[vital];
+    const scope = metric.source === "origin" ? " (site-wide data)" : "";
+    return {
+        priority,
+        title: `${spec.label} is ${classifyVital(vital, metric.p75) === "poor" ? "poor" : "below target"} for real users${scope}`,
+        description: FIELD_DESCRIPTIONS[vital](metric, value, poor) +
+            (metric.source === "origin"
+                ? " This URL has too little traffic for its own field data, so these figures describe the whole origin and may not reflect this page."
+                : ""),
+        evidence: {
+            audit_id: `crux.${vital}`,
+            value,
+            threshold: formatVitalValue(vital, spec.good),
+            field_source: metric.source,
+            users_affected_pct: Math.round(metric.distribution.poor * 100),
+        },
+    };
+}
+/** Every failing field metric in a parsed CrUX block, unsorted. */
+export function formatFieldFindings(metrics) {
+    const findings = [];
+    for (const [vital, metric] of Object.entries(metrics)) {
+        const finding = formatFieldFinding(vital, metric);
+        if (finding)
+            findings.push(finding);
+    }
+    return findings;
+}
+//# sourceMappingURL=webVitalsMapper.js.map

package/dist/mappers/webVitalsMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webVitalsMapper.js","sourceRoot":"","sources":["../../src/mappers/webVitalsMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAqBH,wCAAwC;AACxC,MAAM,MAAM,GAAgC;IAC1C,GAAG,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;IACjG,GAAG,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;IAChG,GAAG,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;IAC/F,GAAG,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;IAChG,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;CAC7F,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAe,EAAE,GAAW;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,GAAG,IAAI,IAAI,CAAC,gBAAgB;QAAE,OAAO,mBAAmB,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAe,EACf,GAAW;IAEX,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,MAAM,KAAK,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,KAAe,EAAE,KAAa;IAC7D,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnF,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;AACtF,CAAC;AAED,uEAAuE;AACvE,SAAS,YAAY,CAAC,UAAkB;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;IACzC,OAAO,GAAG,GAAG,iBAAiB,CAAC;AACjC,CAAC;AAID;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAqC;IAC3D,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACvB,mBAAmB,KAAK,6EAA6E,IAAI,gHAAgH;IAC3N,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACvB,kBAAkB,KAAK,6FAA6F,IAAI,sHAAsH;IAChP,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACvB,sCAAsC,KAAK,8DAA8D,IAAI,2GAA2G;IAC1N,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACvB,0CAA0C,KAAK,gEAAgE,IAAI,0IAA0I;IAC/P,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACxB,oBAAoB,KAAK,iFAAiF,IAAI,uIAAuI;CACxP,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAe,EACf,MAAkB;IAElB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpE,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,OAAO,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,kBAAkB,KAAK,EAAE;QACzH,WAAW,EACT,kBAAkB,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC;YAC9C,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ;gBACzB,CAAC,CAAC,oIAAoI;gBACtI,CAAC,CAAC,EAAE,CAAC;QACT,QAAQ,EAAE;YACR,QAAQ,EAAE,QAAQ,KAAK,EAAE;YACzB,KAAK;YACL,SAAS,EAAE,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;YAC7C,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,GAAG,GAAG,CAAC;SAC/D;KACF,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,mBAAmB,CACjC,OAA8C;IAE9C,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAEnD,EAAE,CAAC;QACF,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/performanceAudit.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPerformanceAuditTool(server: McpServer): void;

package/dist/tools/performanceAudit.js

@@ -0,0 +1,446 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { z } from "zod";
+import { httpGetJson } from "../utils/httpClient.js";
+import { parsePsiResponse, PsiRuntimeError } from "../utils/psiParser.js";
+import { checkPublicReachability } from "../utils/publicUrl.js";
+import { resolveApiKey, keylessWarning, KEY_ENV_VAR, KEYLESS_RUN_CAP } from "../utils/psiAuth.js";
+import { formatLighthouseFinding } from "../mappers/defectFormatter.js";
+import { formatFieldFindings } from "../mappers/webVitalsMapper.js";
+import { sortFindingsByPriority } from "../mappers/priorityMapper.js";
+import { compareLabField, adjustmentFor, promote, demote, AUDIT_TO_VITAL, } from "../mappers/labFieldComparator.js";
+import { aggregate, collapseSystemicFindings, suppressComponentFindings, } from "../mappers/psiAggregator.js";
+/**
+ * Overridable so the tool can be exercised end to end against a captured
+ * response without spending quota, and so anyone behind an egress proxy can
+ * point at it. Defaults to the real API.
+ */
+const PSI_ENDPOINT = process.env.PAGESPEED_API_ENDPOINT ??
+    "https://www.googleapis.com/pagespeedonline/v5/runPagespeed";
+/**
+ * Per-attempt ceiling, set from measurement rather than from the documentation.
+ *
+ * Across every successful live run observed, latency fell between 10 s and
+ * 57 s. A longer timeout therefore buys no additional successes — it only makes
+ * a hang more expensive. 75 s covers the slowest observed success with margin
+ * and leaves room inside a 150 s chunk for a second attempt, which is worth
+ * more than waiting: in a 6-run sample the attempt immediately after a timeout
+ * succeeded in 10 s.
+ */
+const PSI_TIMEOUT_MS = 75_000;
+/** Typical successful run, measured against a live key. Used to reserve budget. */
+const TYPICAL_RUN_MS = 45_000;
+/** Spacing between calls. Sequencing beats fanning out — see the tool description. */
+const INTER_CALL_DELAY_MS = 1_500;
+const DEFAULT_OUTPUT_DIR = "./psi-reports";
+/**
+ * PSI calls take 10-30 s. Six is roughly 90 seconds of work, which fits inside
+ * a typical MCP client timeout with room to spare; the caller loops on the
+ * cursor until the batch is done.
+ */
+const DEFAULT_MAX_RUNS_PER_CALL = 2;
+/**
+ * Wall-clock ceiling for one call, the real protection against an MCP timeout.
+ *
+ * A run count alone cannot bound the time, because per-call latency varies far
+ * more than expected: fivebelow.com's homepage took 47 s per run while its
+ * beauty PLP returned HTTP 500 and burned the retry budget. Counting runs let
+ * a two-run chunk exceed five minutes. The loop now stops starting new work
+ * once the budget is spent and hands back a cursor, so a chunk returns on time
+ * whatever the API does.
+ */
+const DEFAULT_MAX_SECONDS_PER_CALL = 150;
+const pageShape = z.object({
+    template: z.string(),
+    label: z.string(),
+    url: z.string().url(),
+    slug: z.string().optional(),
+});
+const inputShape = {
+    pages: z.array(pageShape).min(1).describe("Approved pages from plan_performance_audit."),
+    strategy: z.enum(["mobile", "desktop", "both"]).optional(),
+    runs_per_url: z.number().int().min(1).max(5).optional(),
+    categories: z.array(z.string()).optional(),
+    output_dir: z.string().optional(),
+    origin_fallback: z.boolean().optional(),
+    api_key: z.string().optional(),
+    cursor: z.string().optional().describe("Resume token from a previous call. Omit on the first call."),
+    max_runs_per_call: z.number().int().min(1).max(20).optional(),
+    skip_completed: z
+        .boolean()
+        .optional()
+        .describe("Skip page/strategy pairs already present in the output index (default true). " +
+        "PSI fails intermittently, so re-running to fill gaps is normal — this makes " +
+        "that cheap instead of re-spending quota on pages that already succeeded. " +
+        "Set false to force a fresh measurement."),
+    max_seconds_per_call: z
+        .number()
+        .int()
+        .min(30)
+        .max(900)
+        .optional()
+        .describe(`Wall-clock ceiling for one call (default ${DEFAULT_MAX_SECONDS_PER_CALL}s). Must stay ` +
+        "below your MCP client's tool timeout; raise MCP_TOOL_TIMEOUT to use a bigger chunk."),
+};
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function slugFor(page) {
+    if (page.slug)
+        return page.slug;
+    try {
+        const url = new URL(page.url);
+        const path = url.pathname.replace(/^\/|\/$/g, "").replace(/\//g, "-");
+        const query = url.search ? `-${url.search.slice(1).replace(/[^a-z0-9]+/gi, "-")}` : "";
+        return (path || "homepage") + query;
+    }
+    catch {
+        return page.template;
+    }
+}
+function encodeCursor(index) {
+    return Buffer.from(JSON.stringify({ i: index })).toString("base64url");
+}
+function decodeCursor(cursor) {
+    if (!cursor)
+        return 0;
+    try {
+        const parsed = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+        return typeof parsed.i === "number" && parsed.i >= 0 ? parsed.i : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function buildRequestUrl(target, strategy, categories, key) {
+    const url = new URL(PSI_ENDPOINT);
+    url.searchParams.set("url", target);
+    url.searchParams.set("strategy", strategy);
+    if (key)
+        url.searchParams.set("key", key);
+    for (const category of categories)
+        url.searchParams.append("category", category);
+    return url;
+}
+/**
+ * Apply the lab-vs-field verdicts to the findings for one run.
+ *
+ * The lab finding is the one that moves. A confirmed failure is promoted
+ * because two independent measurements agree; a lab-only failure is demoted
+ * and tagged, because the simulation saw something real users do not. Field
+ * findings that the lab missed entirely are promoted and tagged `field_only` —
+ * those are the ones no local tool can produce.
+ */
+function applyComparisons(findings, comparisons) {
+    for (const comparison of comparisons) {
+        const { direction, tag } = adjustmentFor(comparison.verdict);
+        if (direction === "none")
+            continue;
+        const labAuditId = Object.entries(AUDIT_TO_VITAL).find(([, vital]) => vital === comparison.metric)?.[0];
+        const target = comparison.verdict === "worse_in_field"
+            ? findings.find((f) => f.evidence.audit_id === `crux.${comparison.metric}`)
+            : findings.find((f) => f.evidence.audit_id === labAuditId);
+        if (!target)
+            continue;
+        target.priority =
+            direction === "promote"
+                ? promote(target.priority, comparison.metric)
+                : demote(target.priority);
+        target.evidence = { ...target.evidence, lab_field_verdict: comparison.verdict, adjustment: tag };
+        target.description = `${target.description} ${comparison.note}`;
+    }
+    return findings;
+}
+/** Merge into the running index rather than overwriting, so batches accumulate. */
+async function mergeIndex(dir, results) {
+    const indexPath = join(dir, "_index.json");
+    let existing = [];
+    try {
+        existing = JSON.parse(await readFile(indexPath, "utf8"));
+    }
+    catch {
+        existing = [];
+    }
+    const byKey = new Map(existing.map((r) => [`${r.url}|${r.strategy}`, r]));
+    for (const result of results)
+        byKey.set(`${result.url}|${result.strategy}`, result);
+    await writeFile(indexPath, JSON.stringify([...byKey.values()], null, 2), "utf8");
+    return indexPath;
+}
+export function registerPerformanceAuditTool(server) {
+    server.registerTool("run_performance_audit", {
+        description: "Runs a PageSpeed Insights audit over an approved set of pages and " +
+            "returns lab scores, CrUX real-user field data, and the disagreements " +
+            "between them. " +
+            "\n\n" +
+            "**Call plan_performance_audit first** and get the user's approval on " +
+            "the page list — this tool spends real API quota and takes 10-30 " +
+            "seconds per page/device. " +
+            "\n\n" +
+            "Runs in chunks: each call performs at most `max_runs_per_call` PSI " +
+            "requests and returns a `cursor`. Keep calling with that cursor until " +
+            "`complete` is true. Full raw reports are written to `output_dir` " +
+            "(one JSON per page/device) and merged into a running `_index.json`, " +
+            "so a failure partway through never costs the completed runs. The " +
+            "final call also returns an `aggregate` block containing every " +
+            "cross-page number — quote those rather than recomputing them." +
+            "\n\n" +
+            "The unique value here is `lab_vs_field`: a metric that passes in the " +
+            "lab but fails for real users means the test environment is not " +
+            "reproducing production, which no local tool can detect.",
+        inputSchema: inputShape,
+    }, async ({ pages, strategy, runs_per_url, categories, output_dir, origin_fallback, api_key, cursor, max_runs_per_call, max_seconds_per_call, skip_completed, }) => {
+        const warnings = [];
+        const resolvedStrategy = strategy ?? "both";
+        const runsPerUrl = runs_per_url ?? 1;
+        const originFallback = origin_fallback ?? true;
+        const maxRuns = max_runs_per_call ?? DEFAULT_MAX_RUNS_PER_CALL;
+        const budgetMs = (max_seconds_per_call ?? DEFAULT_MAX_SECONDS_PER_CALL) * 1000;
+        const startedAt = Date.now();
+        const requestedCategories = categories ?? [
+            "performance", "accessibility", "best-practices", "seo",
+        ];
+        const dir = resolve(output_dir ?? DEFAULT_OUTPUT_DIR);
+        const { key, source } = resolveApiKey(api_key);
+        const strategies = resolvedStrategy === "both" ? ["mobile", "desktop"] : [resolvedStrategy];
+        const units = [];
+        for (const page of pages)
+            for (const s of strategies)
+                units.push({ page, strategy: s });
+        /**
+         * Drop work that already succeeded.
+         *
+         * PSI fails intermittently on real sites — roughly one run in three
+         * against fivebelow.com timed out or 500'd, and the same URL succeeded
+         * minutes later. Filling those gaps is the normal workflow, not an edge
+         * case, so a second pass must not re-measure and re-charge for the pages
+         * that worked. Ordering is preserved, so a cursor from a previous call
+         * would not line up; re-running to fill gaps means starting without one.
+         */
+        let skipped = 0;
+        if ((skip_completed ?? true) && !cursor) {
+            try {
+                const existing = JSON.parse(await readFile(join(dir, "_index.json"), "utf8"));
+                const done = new Set(existing.map((r) => `${r.url}|${r.strategy}`));
+                const before = units.length;
+                const remaining = units.filter((u) => !done.has(`${u.page.url}|${u.strategy}`));
+                skipped = before - remaining.length;
+                units.length = 0;
+                units.push(...remaining);
+            }
+            catch {
+                // No index yet — nothing to skip.
+            }
+        }
+        if (skipped > 0) {
+            warnings.push(`Skipped ${skipped} page/strategy pair(s) already in ${join(dir, "_index.json")}. ` +
+                "Pass skip_completed:false to re-measure them.");
+        }
+        if (units.length === 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            complete: true,
+                            progress: { done: 0, total: 0, failed: 0 },
+                            message: "Every requested page/strategy is already in the index. Nothing to run.",
+                            index_file: join(dir, "_index.json"),
+                            warnings,
+                        }, null, 2),
+                    }],
+            };
+        }
+        const totalRuns = units.length * runsPerUrl;
+        if (!key && totalRuns > KEYLESS_RUN_CAP) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "keyless_batch_too_large",
+                            message: keylessWarning(totalRuns),
+                            runs_requested: totalRuns,
+                            keyless_cap: KEYLESS_RUN_CAP,
+                            env_var: KEY_ENV_VAR,
+                        }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        const unreachable = pages
+            .map((p) => ({ url: p.url, check: checkPublicReachability(p.url) }))
+            .filter((p) => !p.check.auditable);
+        if (unreachable.length > 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "pages_not_auditable",
+                            pages: unreachable.map((p) => ({ url: p.url, reason: p.check.reason })),
+                        }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        await mkdir(dir, { recursive: true });
+        const start = decodeCursor(cursor);
+        const results = [];
+        const failures = [];
+        let index = start;
+        let callsUsed = 0;
+        let budgetExhausted = false;
+        while (index < units.length && callsUsed + runsPerUrl <= Math.max(maxRuns, runsPerUrl)) {
+            // Check before starting a unit, never mid-unit: abandoning a page
+            // half-way through its repeat runs would leave a median of one.
+            // Reserve room for the run about to start, rather than checking only
+            // whether the budget is already spent — otherwise a 40 s run at the
+            // 149 s mark starts a second and overshoots by a full run.
+            const reserve = TYPICAL_RUN_MS * runsPerUrl;
+            if (callsUsed > 0 && Date.now() - startedAt + reserve >= budgetMs) {
+                budgetExhausted = true;
+                break;
+            }
+            const unit = units[index];
+            // Raw bodies are kept alongside the parsed form: the parsed summary
+            // feeds the index, the raw response is what gets written to disk.
+            const attempts = [];
+            let lastError = "";
+            for (let run = 0; run < runsPerUrl; run++) {
+                if (callsUsed > 0)
+                    await sleep(INTER_CALL_DELAY_MS);
+                const requestUrl = buildRequestUrl(unit.page.url, unit.strategy, requestedCategories, key);
+                // Clamp this run's timeout to the budget it has left. Without it the
+                // budget is only advisory: a single hang costs the full PSI timeout
+                // on top of whatever was already spent, and a 150 s chunk ran 188 s.
+                // The reserve check above guarantees at least TYPICAL_RUN_MS remains,
+                // so this never squeezes a run into an unwinnable window.
+                // The whole call, retries included, is bounded by what is left of the
+                // chunk budget — so a retry can never push the chunk past its ceiling.
+                const remainingMs = budgetMs - (Date.now() - startedAt);
+                const response = await httpGetJson(requestUrl, {
+                    timeoutMs: PSI_TIMEOUT_MS,
+                    totalBudgetMs: Math.max(TYPICAL_RUN_MS, remainingMs),
+                    // One retry, and timeouts are included: measurement showed timeout
+                    // is the dominant failure mode here and that it usually recovers,
+                    // while 5xx is rare and cheap. Two attempts, not three.
+                    retries: 1,
+                    retryOnTimeout: true,
+                    retryDelayMs: 3_000,
+                    redact: key ? [key] : [],
+                });
+                callsUsed++;
+                if (!response.ok || !response.data) {
+                    lastError = response.error ?? `HTTP ${response.status}`;
+                    continue;
+                }
+                try {
+                    attempts.push({
+                        parsed: parsePsiResponse(response.body, {
+                            strategy: unit.strategy,
+                            originFallback,
+                        }),
+                        raw: response.body,
+                    });
+                }
+                catch (err) {
+                    // A 200 carrying a runtimeError is a failed run, not a zero score.
+                    lastError =
+                        err instanceof PsiRuntimeError
+                            ? `Lighthouse runtime error ${err.code}: ${err.message}`
+                            : err.message;
+                }
+            }
+            if (attempts.length === 0) {
+                failures.push({ url: unit.page.url, strategy: unit.strategy, error: lastError });
+                index++;
+                continue;
+            }
+            // Median run by performance score. Averaging the metrics of different
+            // runs would invent a page that was never measured; picking the median
+            // run keeps every number internally consistent with one real load.
+            const ordered = [...attempts].sort((a, b) => (a.parsed.scores.performance ?? 0) - (b.parsed.scores.performance ?? 0));
+            const median = ordered[Math.floor(ordered.length / 2)];
+            const parsed = median.parsed;
+            // Write the **raw** PSI response, not the parsed summary.
+            //
+            // This originally saved the parsed object, which holds only failing
+            // audits — 9 KB where the real response is closer to a megabyte. The
+            // report spec sends the agent to these files to fill in the diagnostic
+            // checklist (unused JS, third-party weight, image formats), and none of
+            // that detail survived parsing. The parsed summary lives in _index.json;
+            // disk holds the full record.
+            const fileName = `${slugFor(unit.page)}_${unit.strategy}.json`;
+            await writeFile(join(dir, fileName), median.raw, "utf8");
+            const labFindings = parsed.lighthouse.failedAudits
+                .map(formatLighthouseFinding)
+                .filter((f) => f !== null);
+            const fieldFindings = parsed.field ? formatFieldFindings(parsed.field.metrics) : [];
+            const comparisons = compareLabField(parsed.lab, parsed.field);
+            let findings = suppressComponentFindings([...fieldFindings, ...labFindings]);
+            findings = sortFindingsByPriority(applyComparisons(findings, comparisons));
+            results.push({
+                template: unit.page.template,
+                label: unit.page.label,
+                url: unit.page.url,
+                strategy: unit.strategy,
+                runs: attempts.length,
+                scores: parsed.scores,
+                lab: parsed.lab,
+                field: parsed.field,
+                comparisons,
+                findings,
+                report_file: fileName,
+            });
+            index++;
+        }
+        if (budgetExhausted) {
+            warnings.push(`Stopped after ${Math.round((Date.now() - startedAt) / 1000)}s to stay inside the ` +
+                "per-call time budget. Call again with the cursor to continue.");
+        }
+        const indexPath = await mergeIndex(dir, results);
+        const complete = index >= units.length;
+        if (failures.length > 0) {
+            warnings.push(`${failures.length} run(s) failed. PSI fails intermittently — the same URL often ` +
+                "succeeds on a later attempt. Call this tool again with the same pages and no " +
+                "cursor: completed runs are skipped automatically, so only the gaps are retried.");
+        }
+        let aggregateBlock;
+        if (complete) {
+            // Aggregate over everything on disk, not just this chunk — the whole
+            // point of the running index is that the final numbers cover the batch.
+            let allRuns = results;
+            try {
+                allRuns = JSON.parse(await readFile(indexPath, "utf8"));
+            }
+            catch {
+                warnings.push("Could not re-read the index; aggregate covers this call's runs only.");
+            }
+            const systemic = collapseSystemicFindings(allRuns);
+            aggregateBlock = {
+                ...aggregate(allRuns),
+                systemic_findings: systemic.findings,
+                collapsed_vitals: systemic.collapsedVitals,
+                ...(systemic.collapsedVitals.length > 0
+                    ? {
+                        collapse_note: `Per-page findings for ${systemic.collapsedVitals.join(", ")} are superseded by ` +
+                            "the systemic findings above; report them once, site-wide, not per page.",
+                    }
+                    : {}),
+            };
+        }
+        const payload = {
+            complete,
+            ...(complete ? {} : { cursor: encodeCursor(index) }),
+            progress: { done: index, total: units.length, failed: failures.length },
+            api_key: { present: Boolean(key), source },
+            output_dir: dir,
+            index_file: indexPath,
+            results,
+            ...(failures.length > 0 ? { failures } : {}),
+            ...(aggregateBlock ? { aggregate: aggregateBlock } : {}),
+            ...(complete
+                ? {}
+                : { next_step: "Call run_performance_audit again with this cursor and the same pages." }),
+            warnings,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
+    });
+}
+//# sourceMappingURL=performanceAudit.js.map

package/dist/tools/performanceAudit.js.map

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

package/dist/tools/performanceAuditPlan.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPerformanceAuditPlanTool(server: McpServer): void;