nfunc-mcp 0.3.0 → 0.5.0

package/dist/tools/performanceAuditPlan.js

@@ -0,0 +1,438 @@
+import { z } from "zod";
+import { httpGet } from "../utils/httpClient.js";
+import { readSitemap } from "../utils/sitemapReader.js";
+import { readUrlsFromCsv } from "../utils/csvReader.js";
+import { classifyUrls } from "../utils/urlClassifier.js";
+import { checkPublicReachability } from "../utils/publicUrl.js";
+import { resolveApiKey, keylessWarning, KEY_ENV_VAR, KEYLESS_RUN_CAP, } from "../utils/psiAuth.js";
+/**
+ * Wall-clock budget per PSI call.
+ *
+ * Measured, not guessed: fivebelow.com's homepage took 39-47 s per run against
+ * a live key, roughly three times the 10-30 s the documentation implies. An
+ * estimate exists to let someone decide whether to approve a batch, so it
+ * should err high — a 20-minute job quoted as 7 gets approved and then
+ * abandoned.
+ */
+const SECONDS_PER_RUN = 45;
+const DAILY_QUOTA_WITH_KEY = 25_000;
+/**
+ * How many templates get sampled by default.
+ *
+ * Classification is deliberately granular — merging "/en/blog/release/*" into
+ * "/en/*" would hide real differences — but granularity compounds: nodejs.org
+ * resolves to 100 templates, and sampling all of them is 364 PSI calls of
+ * mostly redundant blog posts. Templates are ranked by how much of the site
+ * they represent and the top slice is sampled; the rest are still reported, so
+ * the user can pull any of them in by name.
+ */
+const DEFAULT_MAX_TEMPLATES = 12;
+const inputShape = {
+    origin: z
+        .string()
+        .url()
+        .describe("Site to plan an audit for, e.g. https://www.example.com"),
+    discovery: z
+        .enum(["sitemap", "list", "csv", "crawl"])
+        .optional()
+        .describe("How to find URLs. 'sitemap' (default) reads robots.txt and " +
+        "/sitemap.xml — fastest and authoritative. 'list' uses the urls " +
+        "input. 'csv' reads csv_path. 'crawl' is not implemented yet."),
+    urls: z.array(z.string().url()).optional(),
+    csv_path: z.string().optional(),
+    strategy: z.enum(["mobile", "desktop", "both"]).optional(),
+    runs_per_url: z.number().int().min(1).max(5).optional(),
+    max_templates: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe(`How many templates to sample, largest first (default ${DEFAULT_MAX_TEMPLATES}). ` +
+        "Smaller templates are still listed so they can be requested by name."),
+    api_key: z
+        .string()
+        .optional()
+        .describe(`Optional PSI key. Prefer setting ${KEY_ENV_VAR} in the MCP client ` +
+        "config — a key passed here is stored in the conversation transcript."),
+};
+/** Same-host filter. A sitemap may list other properties; auditing them silently would be wrong. */
+function sameOrigin(url, originHost) {
+    try {
+        return new URL(url).hostname.toLowerCase() === originHost;
+    }
+    catch {
+        return false;
+    }
+}
+/** A leading /en/ or /en-us/ is a locale, not a section of the site. */
+const LOCALE_SEGMENT = /^[a-z]{2}(-[a-z]{2})?$/i;
+/**
+ * Which part of the site a template belongs to.
+ *
+ * The first path segment, except when that segment is a locale code — on
+ * nodejs.org every page lives under /en/, so keying on segment one put blog,
+ * docs and downloads in a single bucket and defeated the round-robin
+ * entirely. Locale-prefixed URLs are common enough (and this check narrow
+ * enough) to be worth special-casing.
+ */
+function sectionOf(pattern) {
+    const segments = pattern.replace(/^\//, "").split("?")[0].split("/").filter(Boolean);
+    if (segments.length > 1 && LOCALE_SEGMENT.test(segments[0]))
+        segments.shift();
+    return segments[0] ?? "/";
+}
+/**
+ * Choose which templates to sample.
+ *
+ * Ranking purely by URL count fills the budget with whatever section is
+ * biggest: on nodejs.org that is eleven flavours of blog and nothing else,
+ * while a human would have picked a blog post, the docs, the download page and
+ * the homepage. Volume is a poor proxy for what a performance audit needs,
+ * because templates within one section usually share a codepath and therefore
+ * share their defects — the second blog variant tells you far less than the
+ * first download page.
+ *
+ * So selection round-robins across top-level sections, taking each section's
+ * largest remaining template in turn. Within a section, and between sections
+ * of equal standing, URL count still decides. The entry page — whatever URL was
+ * actually requested — is seeded first regardless: it is a single URL, so volume
+ * ranking always sorts it last, and it is the page the user named.
+ */
+function selectBudget(eligible, budget, entryPattern = "/") {
+    // The entry page is one URL, so volume ranking always sorts it last.
+    const homepage = eligible.find((t) => t.pattern === entryPattern);
+    const picked = homepage ? [homepage] : [];
+    const bySection = new Map();
+    for (const t of eligible) {
+        if (t === homepage)
+            continue;
+        const key = sectionOf(t.pattern);
+        const bucket = bySection.get(key);
+        if (bucket)
+            bucket.push(t);
+        else
+            bySection.set(key, [t]);
+    }
+    // Sections ordered by their largest template, so the dominant part of the
+    // site is still sampled first — just not exclusively.
+    const queues = [...bySection.values()]
+        .map((list) => [...list].sort((a, b) => b.urlCount - a.urlCount))
+        .sort((a, b) => b[0].urlCount - a[0].urlCount);
+    let progressed = true;
+    while (picked.length < budget && progressed) {
+        progressed = false;
+        for (const queue of queues) {
+            if (picked.length >= budget)
+                break;
+            const next = queue.shift();
+            if (!next)
+                continue;
+            picked.push(next);
+            progressed = true;
+        }
+    }
+    return picked;
+}
+function buildQuestions(templates, gated, deferred, runs, runsPerUrl, hasKey, truncated) {
+    const questions = [];
+    questions.push(`Sample sizes: the plan audits ${templates.reduce((n, t) => n + t.suggestedSample, 0)} ` +
+        `URLs across ${templates.length} templates. Accept these, or set your own per template?`);
+    if (runsPerUrl === 1) {
+        const extra = Math.round((runs * 2 * SECONDS_PER_RUN) / 60);
+        questions.push(`runs_per_url is 1, so a single slow run becomes an unchallenged data ` +
+            `point. Raising it to 3 takes the median and removes that risk, at ` +
+            `roughly ${extra} extra minutes. Raise it?`);
+    }
+    if (deferred.length > 0) {
+        questions.push(`${deferred.length} smaller template(s) are listed but not sampled, to keep the run ` +
+            `affordable. Pull any of them in by pattern, or raise max_templates?`);
+    }
+    if (gated.length > 0) {
+        questions.push(`${gated.map((t) => t.label).join(", ")} cannot be audited by PSI — it ` +
+            `fetches anonymously, so it would measure an empty cart or a login ` +
+            `redirect. Run these through run_lighthouse separately?`);
+    }
+    if (!hasKey) {
+        questions.push(`No ${KEY_ENV_VAR} is set. Provide a key, or cut the run to ` +
+            `${KEYLESS_RUN_CAP} runs or fewer?`);
+    }
+    if (truncated) {
+        questions.push("Sitemap discovery hit its cap, so the template breakdown covers a " +
+            "subset of the site. Proceed with that, or narrow the audit to " +
+            "specific sections?");
+    }
+    return questions;
+}
+export function registerPerformanceAuditPlanTool(server) {
+    server.registerTool("plan_performance_audit", {
+        description: "Plans a PageSpeed Insights audit without spending any PSI quota. " +
+            "Discovers a site's URLs (sitemap, an explicit list, or a CSV), " +
+            "clusters them into page templates, flags the ones PSI physically " +
+            "cannot audit, and returns a costed run plan plus the questions that " +
+            "need answering before it runs. " +
+            "\n\n" +
+            "**Always call this before run_performance_audit.** Present the " +
+            "returned templates and `questions` to the user, get their answers, " +
+            "then pass the confirmed page list to run_performance_audit. Nothing " +
+            "is audited until they approve — a misclassified template should " +
+            "cost a conversation turn, not 40 API calls." +
+            "\n\n" +
+            "PSI is for publicly hosted sites. Localhost and private hosts are " +
+            "rejected here; use run_lighthouse for those.",
+        inputSchema: inputShape,
+    }, async ({ origin, discovery, urls, csv_path, strategy, runs_per_url, max_templates, api_key }) => {
+        const warnings = [];
+        const mode = discovery ?? "sitemap";
+        const resolvedStrategy = strategy ?? "both";
+        const runsPerUrl = runs_per_url ?? 1;
+        const maxTemplates = max_templates ?? DEFAULT_MAX_TEMPLATES;
+        const strategyCount = resolvedStrategy === "both" ? 2 : 1;
+        // --- Preflight ------------------------------------------------------
+        const reach = checkPublicReachability(origin);
+        if (!reach.auditable) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "origin_not_auditable", origin, reason: reach.reason }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (mode === "crawl") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "crawl_not_implemented",
+                            message: "Crawling is not built yet. Use discovery:'sitemap' " +
+                                "(default), or supply URLs with discovery:'list' or " +
+                                "discovery:'csv'.",
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const originHost = new URL(origin).hostname.toLowerCase();
+        const liveCheck = await httpGet(origin, { timeoutMs: 15_000, retries: 1 });
+        if (!liveCheck.ok) {
+            // A bot wall blocking *us* says nothing about PSI, which fetches from
+            // Google's own address space and is widely allowlisted — fivebelow.com
+            // returns a Cloudflare challenge here while having served PSI fine.
+            // Reporting that as "PSI will likely fail" would be a false alarm.
+            const botWalled = liveCheck.status === 403 || liveCheck.status === 503;
+            warnings.push(botWalled
+                ? `${origin} returned HTTP ${liveCheck.status} to this preflight, which usually means ` +
+                    "a bot-protection challenge rather than a broken site. PSI fetches from Google's " +
+                    "infrastructure and is often allowlisted where we are not, so this is not a reason " +
+                    "to stop — but if the audit comes back empty, that challenge page is the first suspect."
+                : `${origin} did not respond successfully (${liveCheck.error ?? `HTTP ${liveCheck.status}`}). ` +
+                    "PSI will likely fail the same way; confirm the URL before running.");
+        }
+        // --- Discovery ------------------------------------------------------
+        let discovered = [];
+        let sitemapUrl = null;
+        let truncated = false;
+        if (mode === "list") {
+            if (!urls || urls.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: "missing_urls", message: "discovery:'list' requires a non-empty urls array." }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            discovered = urls;
+        }
+        else if (mode === "csv") {
+            if (!csv_path) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: "missing_csv_path", message: "discovery:'csv' requires csv_path." }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            try {
+                const csv = readUrlsFromCsv(csv_path);
+                discovered = csv.urls;
+                warnings.push(...csv.warnings);
+                warnings.push(`Read ${csv.urls.length} URLs from column "${csv.column}" of ${csv_path}.`);
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: "csv_unreadable", message: err.message }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        else {
+            const sitemap = await readSitemap(origin);
+            discovered = sitemap.urls;
+            sitemapUrl = sitemap.sitemapsRead[0] ?? null;
+            truncated = sitemap.truncated;
+            warnings.push(...sitemap.warnings);
+        }
+        // Seed the URL the user actually gave.
+        //
+        // Sitemaps frequently omit their entry page — nodejs.org lists /en/... and
+        // never "/" — so a plan built purely from discovery can skip the very page
+        // that was asked about. This originally seeded `new URL("/", origin)`,
+        // which silently retargeted the audit whenever the input carried a path:
+        // a request for /ecommerce/ was planned as the site's domain homepage, a
+        // completely different page.
+        const entry = new URL(origin);
+        const entryUrl = entry.toString();
+        const entryPath = entry.pathname.replace(/\/$/, "") || "/";
+        const sameUrl = (a, b) => a.replace(/\/$/, "") === b.replace(/\/$/, "");
+        if (!discovered.some((u) => sameUrl(u, entryUrl))) {
+            discovered = [entryUrl, ...discovered];
+            warnings.push(`Added ${entryUrl} — it was not listed by ${mode} discovery.`);
+        }
+        let onOrigin = discovered.filter((u) => sameOrigin(u, originHost));
+        // A path in the input scopes the audit to that subtree. Someone auditing
+        // /ecommerce/ is asking about the shop, not the blog that shares the host.
+        if (entryPath !== "/") {
+            const before = onOrigin.length;
+            onOrigin = onOrigin.filter((u) => {
+                try {
+                    const path = new URL(u).pathname.replace(/\/$/, "") || "/";
+                    return path === entryPath || path.startsWith(`${entryPath}/`);
+                }
+                catch {
+                    return false;
+                }
+            });
+            if (before > onOrigin.length) {
+                warnings.push(`Scoped to ${entryPath}/ — dropped ${before - onOrigin.length} URL(s) outside that ` +
+                    `path. Pass the bare origin instead to audit the whole site.`);
+            }
+        }
+        if (onOrigin.length < discovered.length) {
+            warnings.push(`Dropped ${discovered.length - onOrigin.length} URL(s) pointing at a different host than ${originHost}.`);
+        }
+        if (onOrigin.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "no_urls_found",
+                            origin,
+                            discovery: mode,
+                            warnings,
+                            message: "No auditable URLs were discovered. Supply them directly " +
+                                "with discovery:'list', or point at a CSV export.",
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // --- Classify -------------------------------------------------------
+        const { templates, skipped } = classifyUrls(onOrigin);
+        if (skipped > 0)
+            warnings.push(`Skipped ${skipped} unparseable URL(s).`);
+        // classifyUrls returns largest-first, so the head of the list is the
+        // slice of the site worth spending calls on — with one correction. The
+        // homepage is a single URL and therefore ranks last by volume, which on
+        // nodejs.org pushed it out of the sample entirely in favour of an
+        // eleventh blog variant. It is the most-visited page on essentially
+        // every site, so it is seeded into the budget before ranking applies.
+        const eligible = templates.filter((t) => !t.anySessionGated);
+        const inBudget = new Set(selectBudget(eligible, maxTemplates, entryPath).map((t) => t.id));
+        const planned = templates.map((t) => {
+            if (!inBudget.has(t.id) && !t.anySessionGated) {
+                return {
+                    ...t,
+                    suggestedSample: 0,
+                    reason: "below_sampling_budget",
+                    recommendation: `Not sampled by default — it is outside the top ${maxTemplates} templates by ` +
+                        "URL count. Ask for it by pattern to include it.",
+                };
+            }
+            if (t.anySessionGated) {
+                return {
+                    ...t,
+                    auditable: false,
+                    suggestedSample: 0,
+                    reason: "session_gated",
+                    recommendation: "PSI fetches anonymously and would measure a logged-out or " +
+                        "empty version of this page. Audit it with run_lighthouse, " +
+                        "which runs Chrome locally and can carry session cookies.",
+                };
+            }
+            return { ...t, sampled_urls: t.candidates.slice(0, t.suggestedSample) };
+        });
+        const sampled = planned.filter((t) => t.auditable && t.suggestedSample > 0);
+        const gated = planned.filter((t) => !t.auditable);
+        const deferred = planned.filter((t) => t.auditable && t.suggestedSample === 0);
+        // --- Cost -----------------------------------------------------------
+        const sampledUrls = sampled.reduce((n, t) => n + t.suggestedSample, 0);
+        const urlsCovered = sampled.reduce((n, t) => n + t.urlCount, 0);
+        const runs = sampledUrls * strategyCount * runsPerUrl;
+        const { key, source } = resolveApiKey(api_key);
+        if (!key && runs > KEYLESS_RUN_CAP)
+            warnings.push(keylessWarning(runs));
+        const payload = {
+            origin,
+            discovery: {
+                source: mode,
+                urls_found: onOrigin.length,
+                sitemap_url: sitemapUrl,
+                truncated,
+            },
+            api_key: { present: Boolean(key), source },
+            strategy: resolvedStrategy,
+            runs_per_url: runsPerUrl,
+            templates: planned.map((t) => ({
+                id: t.id,
+                label: t.label,
+                pattern: t.pattern,
+                url_count: t.urlCount,
+                suggested_sample: t.suggestedSample,
+                candidates: t.candidates,
+                ...(t.sampled_urls ? { sampled_urls: t.sampled_urls } : {}),
+                auditable: t.auditable,
+                ...(t.reason ? { reason: t.reason } : {}),
+                ...(t.recommendation ? { recommendation: t.recommendation } : {}),
+            })),
+            coverage: {
+                templates_total: planned.length,
+                templates_sampled: sampled.length,
+                templates_deferred: deferred.length,
+                urls_represented: urlsCovered,
+                urls_total: onOrigin.length,
+                represented_pct: Math.round((urlsCovered / onOrigin.length) * 100),
+            },
+            estimate: {
+                urls_sampled: sampledUrls,
+                runs,
+                wall_clock_minutes: Math.max(1, Math.round((runs * SECONDS_PER_RUN) / 60)),
+                quota_used: runs,
+                quota_limit: key ? DAILY_QUOTA_WITH_KEY : KEYLESS_RUN_CAP,
+            },
+            questions: buildQuestions(sampled, gated, deferred, runs, runsPerUrl, Boolean(key), truncated),
+            next_step: "Show the templates and questions to the user. Once they confirm " +
+                "the sample, call run_performance_audit with the approved pages.",
+            warnings,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
+    });
+}
+//# sourceMappingURL=performanceAuditPlan.js.map

package/dist/tools/performanceAuditPlan.js.map

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

package/dist/utils/batchState.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Shared machinery for tools that process a list of URLs across several calls.
+ *
+ * Extracted from the PSI runner, where every piece of it was earned the hard
+ * way: an MCP client backgrounds a tool call at 120 seconds, local Lighthouse
+ * takes 20-40 seconds per URL per form factor, and both PSI and pa11y fail
+ * intermittently on real sites. A batch therefore cannot be one long call, and
+ * a failure partway through must not cost the runs that already succeeded.
+ *
+ * The contract is: bound each call by a clock, write results to disk as they
+ * land, merge rather than overwrite an index, and hand back a cursor.
+ */
+/** Default per-call ceiling. Below the 120s at which Claude Code backgrounds a call. */
+export declare const DEFAULT_MAX_SECONDS_PER_CALL = 100;
+export interface BatchUnit {
+    url: string;
+    /** Device profile, engine, or whatever second dimension the tool runs over. */
+    variant: string;
+}
+/** Anything the index can hold. Tools define their own richer result types. */
+export interface BatchRecord {
+    url: string;
+    variant: string;
+    [key: string]: unknown;
+}
+export declare function encodeCursor(index: number): string;
+export declare function decodeCursor(cursor: string | undefined): number;
+/** Cross-product of URLs and variants, in URL-major order so a partial run covers whole pages. */
+export declare function buildUnits(urls: string[], variants: string[]): BatchUnit[];
+/**
+ * A filesystem-safe stem for a URL.
+ *
+ * Derived from the path rather than hashed so the files are browsable: someone
+ * opening `output_dir` should be able to tell which page each report is for.
+ */
+export declare function slugForUrl(url: string): string;
+export interface IndexMergeResult {
+    indexPath: string;
+    total: number;
+}
+/**
+ * Merge records into the running index, keyed on URL + variant.
+ *
+ * Merging rather than overwriting is what lets a second pass fill gaps without
+ * discarding the first pass, and what lets the final aggregate cover the whole
+ * batch instead of only the last chunk.
+ */
+export declare function mergeIndex<T extends BatchRecord>(dir: string, records: T[], fileName?: string): Promise<IndexMergeResult>;
+export declare function readIndex<T extends BatchRecord>(dir: string, fileName?: string): Promise<T[]>;
+/**
+ * Drop work already recorded in the index.
+ *
+ * Re-running to fill gaps is the normal workflow, not an edge case, because
+ * these tools fail intermittently on real sites. Without this, the advice
+ * "just run it again" silently re-does — and on metered APIs re-charges for —
+ * everything that already worked.
+ *
+ * Only applies when no cursor is in play: a cursor indexes into the unfiltered
+ * list, so filtering would misalign it.
+ */
+export declare function filterCompleted(dir: string, units: BatchUnit[], skipCompleted: boolean, cursor: string | undefined): Promise<{
+    units: BatchUnit[];
+    skipped: number;
+}>;
+/**
+ * Whether there is room to start another unit.
+ *
+ * Checked before a unit begins, never mid-unit, and it reserves the expected
+ * cost of the work about to start rather than only asking whether the budget is
+ * already spent — otherwise a 40-second run beginning at the 99-second mark
+ * overshoots by a full unit. The PSI runner overran a 150s budget by 38s
+ * before this reserve existed.
+ */
+export declare function hasBudget(startedAt: number, budgetMs: number, reserveMs: number, unitsDone: number): boolean;
+export declare function elapsedSeconds(startedAt: number): number;

package/dist/utils/batchState.js

@@ -0,0 +1,128 @@
+/**
+ * Shared machinery for tools that process a list of URLs across several calls.
+ *
+ * Extracted from the PSI runner, where every piece of it was earned the hard
+ * way: an MCP client backgrounds a tool call at 120 seconds, local Lighthouse
+ * takes 20-40 seconds per URL per form factor, and both PSI and pa11y fail
+ * intermittently on real sites. A batch therefore cannot be one long call, and
+ * a failure partway through must not cost the runs that already succeeded.
+ *
+ * The contract is: bound each call by a clock, write results to disk as they
+ * land, merge rather than overwrite an index, and hand back a cursor.
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+/** Default per-call ceiling. Below the 120s at which Claude Code backgrounds a call. */
+export const DEFAULT_MAX_SECONDS_PER_CALL = 100;
+export function encodeCursor(index) {
+    return Buffer.from(JSON.stringify({ i: index })).toString("base64url");
+}
+export 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;
+    }
+}
+/** Cross-product of URLs and variants, in URL-major order so a partial run covers whole pages. */
+export function buildUnits(urls, variants) {
+    const units = [];
+    for (const url of urls)
+        for (const variant of variants)
+            units.push({ url, variant });
+    return units;
+}
+/**
+ * A filesystem-safe stem for a URL.
+ *
+ * Derived from the path rather than hashed so the files are browsable: someone
+ * opening `output_dir` should be able to tell which page each report is for.
+ */
+export function slugForUrl(url) {
+    try {
+        const parsed = new URL(url);
+        const path = parsed.pathname.replace(/^\/|\/$/g, "").replace(/\//g, "-");
+        const query = parsed.search ? `-${parsed.search.slice(1).replace(/[^a-z0-9]+/gi, "-")}` : "";
+        const stem = `${path || "homepage"}${query}`.replace(/-+/g, "-").replace(/^-|-$/g, "");
+        // Long paths make unreadable filenames; the tail is the distinguishing part.
+        return stem.length > 80 ? stem.slice(-80).replace(/^-/, "") : stem;
+    }
+    catch {
+        return "url";
+    }
+}
+/**
+ * Merge records into the running index, keyed on URL + variant.
+ *
+ * Merging rather than overwriting is what lets a second pass fill gaps without
+ * discarding the first pass, and what lets the final aggregate cover the whole
+ * batch instead of only the last chunk.
+ */
+export async function mergeIndex(dir, records, fileName = "_index.json") {
+    await mkdir(dir, { recursive: true });
+    const indexPath = join(dir, fileName);
+    let existing = [];
+    try {
+        existing = JSON.parse(await readFile(indexPath, "utf8"));
+    }
+    catch {
+        existing = [];
+    }
+    const byKey = new Map(existing.map((r) => [`${r.url}|${r.variant}`, r]));
+    for (const record of records)
+        byKey.set(`${record.url}|${record.variant}`, record);
+    const merged = [...byKey.values()];
+    await writeFile(indexPath, JSON.stringify(merged, null, 2), "utf8");
+    return { indexPath, total: merged.length };
+}
+export async function readIndex(dir, fileName = "_index.json") {
+    try {
+        return JSON.parse(await readFile(join(dir, fileName), "utf8"));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Drop work already recorded in the index.
+ *
+ * Re-running to fill gaps is the normal workflow, not an edge case, because
+ * these tools fail intermittently on real sites. Without this, the advice
+ * "just run it again" silently re-does — and on metered APIs re-charges for —
+ * everything that already worked.
+ *
+ * Only applies when no cursor is in play: a cursor indexes into the unfiltered
+ * list, so filtering would misalign it.
+ */
+export async function filterCompleted(dir, units, skipCompleted, cursor) {
+    if (!skipCompleted || cursor)
+        return { units, skipped: 0 };
+    const existing = await readIndex(dir);
+    if (existing.length === 0)
+        return { units, skipped: 0 };
+    const done = new Set(existing.map((r) => `${r.url}|${r.variant}`));
+    const remaining = units.filter((u) => !done.has(`${u.url}|${u.variant}`));
+    return { units: remaining, skipped: units.length - remaining.length };
+}
+/**
+ * Whether there is room to start another unit.
+ *
+ * Checked before a unit begins, never mid-unit, and it reserves the expected
+ * cost of the work about to start rather than only asking whether the budget is
+ * already spent — otherwise a 40-second run beginning at the 99-second mark
+ * overshoots by a full unit. The PSI runner overran a 150s budget by 38s
+ * before this reserve existed.
+ */
+export function hasBudget(startedAt, budgetMs, reserveMs, unitsDone) {
+    if (unitsDone === 0)
+        return true; // always attempt at least one
+    return Date.now() - startedAt + reserveMs < budgetMs;
+}
+export function elapsedSeconds(startedAt) {
+    return Math.round((Date.now() - startedAt) / 1000);
+}
+//# sourceMappingURL=batchState.js.map