@qualitykit/engine 0.0.0-stage → 0.3.0

package/dist/fetch-html.js

@@ -0,0 +1,134 @@
+const DEFAULT_TIMEOUT = 8_000;
+const DEFAULT_MAX_BYTES = 1_000_000;
+export function parseHtmlSignals(html) {
+    const title = matchContent(html, /<title[^>]*>([\s\S]*?)<\/title>/i);
+    const description = matchAttr(html, /<meta[^>]+name=["']description["'][^>]+content=["']([^"']*)["'][^>]*>/i) ??
+        matchAttr(html, /<meta[^>]+content=["']([^"']*)["'][^>]+name=["']description["'][^>]*>/i);
+    const canonical = matchAttr(html, /<link[^>]+rel=["']canonical["'][^>]+href=["']([^"']+)["'][^>]*>/i) ??
+        matchAttr(html, /<link[^>]+href=["']([^"']+)["'][^>]+rel=["']canonical["'][^>]*>/i);
+    const ogTitle = matchAttr(html, /<meta[^>]+property=["']og:title["'][^>]+content=["']([^"']*)["']/i) ??
+        matchAttr(html, /<meta[^>]+content=["']([^"']*)["'][^>]+property=["']og:title["']/i);
+    const ogDescription = matchAttr(html, /<meta[^>]+property=["']og:description["'][^>]+content=["']([^"']*)["']/i) ??
+        matchAttr(html, /<meta[^>]+content=["']([^"']*)["'][^>]+property=["']og:description["']/i);
+    const robotsMeta = matchAttr(html, /<meta[^>]+name=["']robots["'][^>]+content=["']([^"']*)["']/i) ??
+        matchAttr(html, /<meta[^>]+content=["']([^"']*)["'][^>]+name=["']robots["']/i);
+    const h1 = [];
+    const headings = [];
+    const h1Re = /<h1\b[^>]*>([\s\S]*?)<\/h1>/gi;
+    let m;
+    while ((m = h1Re.exec(html))) {
+        const text = stripTags(m[1]).trim();
+        if (text)
+            h1.push(text);
+    }
+    const hRe = /<h([1-3])\b[^>]*>([\s\S]*?)<\/h\1>/gi;
+    while ((m = hRe.exec(html))) {
+        const text = stripTags(m[2]).trim();
+        if (text)
+            headings.push(text);
+    }
+    const jsonLd = [];
+    const ldRe = /<script[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi;
+    while ((m = ldRe.exec(html))) {
+        try {
+            jsonLd.push(JSON.parse(m[1]));
+        }
+        catch {
+            // ignore invalid blocks
+        }
+    }
+    return {
+        title: title ? stripTags(title).trim() : undefined,
+        description: description || undefined,
+        canonical: canonical || undefined,
+        ogTitle: ogTitle || undefined,
+        ogDescription: ogDescription || undefined,
+        robotsMeta: robotsMeta || undefined,
+        headings,
+        h1,
+        jsonLd,
+    };
+}
+function matchContent(html, re) {
+    const m = html.match(re);
+    return m?.[1];
+}
+function matchAttr(html, re) {
+    const m = html.match(re);
+    return m?.[1];
+}
+function stripTags(s) {
+    return s.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ");
+}
+export async function fetchRenderedPages(siteUrl, options = {}) {
+    const base = siteUrl.replace(/\/$/, "");
+    const paths = options.paths?.length ? options.paths : ["/"];
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT;
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const results = [];
+    for (const path of paths) {
+        const url = path.startsWith("http") ? path : `${base}${path === "/" ? "" : path}`;
+        const pathName = path.startsWith("http")
+            ? safePath(path)
+            : path.startsWith("/")
+                ? path
+                : `/${path}`;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            const res = await fetchImpl(url, {
+                signal: controller.signal,
+                redirect: "follow",
+                headers: { "User-Agent": "QualityKitAudit/0.1 (+local-mcp; read-only)" },
+            });
+            clearTimeout(timer);
+            const buf = new Uint8Array(await res.arrayBuffer());
+            if (buf.byteLength > maxBytes) {
+                results.push({
+                    url,
+                    path: pathName,
+                    ok: false,
+                    status: res.status,
+                    error: `Response exceeded ${maxBytes} bytes`,
+                    headings: [],
+                    h1: [],
+                    jsonLd: [],
+                });
+                continue;
+            }
+            const html = new TextDecoder("utf-8", { fatal: false }).decode(buf);
+            const signals = parseHtmlSignals(html);
+            results.push({
+                url,
+                path: pathName,
+                ok: res.ok,
+                status: res.status,
+                error: res.ok ? undefined : `HTTP ${res.status}`,
+                html,
+                ...signals,
+            });
+        }
+        catch (error) {
+            results.push({
+                url,
+                path: pathName,
+                ok: false,
+                error: error instanceof Error ? error.message : "Fetch failed",
+                headings: [],
+                h1: [],
+                jsonLd: [],
+            });
+        }
+    }
+    return results;
+}
+function safePath(url) {
+    try {
+        return new URL(url).pathname || "/";
+    }
+    catch {
+        return "/";
+    }
+}
+//# sourceMappingURL=fetch-html.js.map

package/dist/fetch-html.js.map

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

package/dist/finding.d.ts

@@ -0,0 +1,47 @@
+import type { Severity } from "./site.js";
+export type FindingKind = "defect" | "opportunity";
+export type FixSafety = "auto" | "approval" | "manual";
+export type Confidence = "high" | "medium" | "low";
+export type Impact = "high" | "medium" | "low";
+export type Effort = "low" | "medium" | "high";
+export type FindingCategory = "technical-seo" | "metadata" | "content" | "ai" | "schema" | "links" | "performance" | "conversion";
+export interface Finding {
+    id: string;
+    kind: FindingKind;
+    category: FindingCategory;
+    severity: Severity;
+    title: string;
+    whyItMatters: string;
+    evidence: string[];
+    suggestedFix: string;
+    expectedImpact: Impact;
+    confidence: Confidence;
+    effort: Effort;
+    fixSafety: FixSafety;
+    verification: string;
+    relatedIds?: string[];
+    rootCauseId?: string;
+}
+export interface RouteInventoryItem {
+    path: string;
+    file: string;
+    kind: "page" | "layout" | "route" | "other";
+    pattern: "static" | "dynamic" | "handler" | "layout";
+}
+export interface AuditSummary {
+    defects: number;
+    opportunities: number;
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+    info: number;
+}
+export declare function sortFindings(findings: Finding[]): Finding[];
+export declare function summarizeFindings(findings: Finding[]): AuditSummary;
+export declare function buildRouteInventory(routes: {
+    path: string;
+    file: string;
+    kind: "page" | "layout" | "route" | "other";
+}[]): RouteInventoryItem[];
+//# sourceMappingURL=finding.d.ts.map

package/dist/finding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.d.ts","sourceRoot":"","sources":["../src/finding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEvD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnD,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/C,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,UAAU,GACV,SAAS,GACT,IAAI,GACJ,QAAQ,GACR,OAAO,GACP,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IAC5C,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAgC3D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,CAUnE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;CAC7C,EAAE,GACF,kBAAkB,EAAE,CAatB"}

package/dist/finding.js

@@ -0,0 +1,62 @@
+export function sortFindings(findings) {
+    const severityRank = {
+        critical: 0,
+        high: 1,
+        medium: 2,
+        low: 3,
+        info: 4,
+    };
+    const impactRank = { high: 0, medium: 1, low: 2 };
+    const confidenceRank = {
+        high: 0,
+        medium: 1,
+        low: 2,
+    };
+    const effortRank = { low: 0, medium: 1, high: 2 };
+    return [...findings].sort((a, b) => {
+        if (a.kind !== b.kind)
+            return a.kind === "defect" ? -1 : 1;
+        if (severityRank[a.severity] !== severityRank[b.severity]) {
+            return severityRank[a.severity] - severityRank[b.severity];
+        }
+        if (impactRank[a.expectedImpact] !== impactRank[b.expectedImpact]) {
+            return impactRank[a.expectedImpact] - impactRank[b.expectedImpact];
+        }
+        if (confidenceRank[a.confidence] !== confidenceRank[b.confidence]) {
+            return confidenceRank[a.confidence] - confidenceRank[b.confidence];
+        }
+        if (effortRank[a.effort] !== effortRank[b.effort]) {
+            return effortRank[a.effort] - effortRank[b.effort];
+        }
+        return a.id.localeCompare(b.id);
+    });
+}
+export function summarizeFindings(findings) {
+    return {
+        defects: findings.filter((f) => f.kind === "defect").length,
+        opportunities: findings.filter((f) => f.kind === "opportunity").length,
+        critical: findings.filter((f) => f.severity === "critical").length,
+        high: findings.filter((f) => f.severity === "high").length,
+        medium: findings.filter((f) => f.severity === "medium").length,
+        low: findings.filter((f) => f.severity === "low").length,
+        info: findings.filter((f) => f.severity === "info").length,
+    };
+}
+export function buildRouteInventory(routes) {
+    return routes.map((r) => {
+        let pattern = "static";
+        if (r.kind === "layout")
+            pattern = "layout";
+        else if (r.kind === "route")
+            pattern = "handler";
+        else if (r.path.includes(":"))
+            pattern = "dynamic";
+        return {
+            path: r.path,
+            file: r.file,
+            kind: r.kind,
+            pattern,
+        };
+    });
+}
+//# sourceMappingURL=finding.js.map

package/dist/finding.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./finding.js";
+export * from "./site.js";
+export * from "./fetch-html.js";
+export * from "./robots.js";
+export * from "./audit-engine.js";
+export * from "./live-audit.js";
+export * from "./report.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./finding.js";
+export * from "./site.js";
+export * from "./fetch-html.js";
+export * from "./robots.js";
+export * from "./audit-engine.js";
+export * from "./live-audit.js";
+export * from "./report.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/live-audit.d.ts

@@ -0,0 +1,21 @@
+import { type EngineAuditResult } from "./audit-engine.js";
+import { type FetchHtmlOptions, type RenderedPage } from "./fetch-html.js";
+import type { ReportEnvelope } from "./report.js";
+export interface LiveAuditOptions extends FetchHtmlOptions {
+    projectName?: string;
+    maxSitemapUrls?: number;
+    maxExtraPaths?: number;
+}
+export interface LiveAuditResult {
+    envelope: ReportEnvelope;
+    audit: EngineAuditResult;
+    pages: RenderedPage[];
+    robotsText?: string;
+    sitemapPaths: string[];
+}
+export declare function runLiveAudit(siteUrl: string, options?: LiveAuditOptions): Promise<LiveAuditResult>;
+export declare function diffRegressions(previousFindingIds: string[], current: EngineAuditResult): {
+    newDefects: string[];
+    stillOpen: string[];
+};
+//# sourceMappingURL=live-audit.d.ts.map

package/dist/live-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-audit.d.ts","sourceRoot":"","sources":["../src/live-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,aAAa,CAAC;AAM/D,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA0D1B;AAuJD,wBAAgB,eAAe,CAC7B,kBAAkB,EAAE,MAAM,EAAE,EAC5B,OAAO,EAAE,iBAAiB,GACzB;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAS/C"}

package/dist/live-audit.js

@@ -0,0 +1,209 @@
+import { runAuditEngine } from "./audit-engine.js";
+import { fetchRenderedPages, } from "./fetch-html.js";
+import { analyzeRobotsContent, AI_CRAWLERS } from "./robots.js";
+import { wrapReport } from "./report.js";
+const SITEMAP_CAP = 50;
+const EXTRA_PATH_CAP = 8;
+export async function runLiveAudit(siteUrl, options = {}) {
+    const base = siteUrl.replace(/\/$/, "");
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const maxSitemap = options.maxSitemapUrls ?? SITEMAP_CAP;
+    const maxExtra = options.maxExtraPaths ?? EXTRA_PATH_CAP;
+    const robotsText = await fetchText(`${base}/robots.txt`, fetchImpl);
+    const sitemapXml = await fetchText(`${base}/sitemap.xml`, fetchImpl);
+    const sitemapPaths = sitemapXml
+        ? parseSitemapPaths(sitemapXml, maxSitemap)
+        : [];
+    const paths = [
+        "/",
+        ...sitemapPaths.filter((p) => p !== "/").slice(0, maxExtra),
+    ];
+    const pages = await fetchRenderedPages(base, {
+        ...options,
+        paths,
+        fetchImpl,
+    });
+    const site = buildLiveSiteModel(base, robotsText, sitemapPaths, pages);
+    const audit = runAuditEngine(site, pages);
+    const coverage = {
+        source: "not_run",
+        rendered: pages.some((p) => p.ok) ? "completed" : "not_run",
+        live: pages.some((p) => p.ok) ? "completed" : "fail",
+        searchData: "not_connected",
+    };
+    const envelope = wrapReport({
+        project: options.projectName ?? new URL(base).hostname,
+        mode: "live",
+        coverage,
+        findings: audit.findings.map((f) => ({
+            ruleId: f.id,
+            severity: f.severity === "critical" || f.severity === "high" ? "P1" : f.severity === "medium" ? "P2" : "P3",
+            status: f.kind === "defect" ? "confirmed" : "needs_verification",
+            confidence: f.confidence,
+            affectedUrls: extractUrls(f.evidence, base),
+            evidence: f.evidence,
+            fixable: f.fixSafety === "auto" || f.fixSafety === "approval",
+            requiresApproval: f.fixSafety !== "auto",
+            title: f.title,
+            kind: f.kind,
+        })),
+        summary: audit.summary,
+    });
+    return {
+        envelope,
+        audit,
+        pages,
+        robotsText: robotsText ?? undefined,
+        sitemapPaths,
+    };
+}
+function buildLiveSiteModel(siteUrl, robotsText, sitemapPaths, pages) {
+    const home = pages.find((p) => p.path === "/" && p.ok);
+    const robots = robotsText
+        ? analyzeRobotsContent(robotsText)
+        : {
+            blocksAll: false,
+            aiCrawlers: AI_CRAWLERS.map((name) => ({
+                name,
+                status: "unknown",
+                evidence: "robots.txt not fetched",
+            })),
+        };
+    const routes = pages
+        .filter((p) => p.ok)
+        .map((p) => ({
+        path: p.path,
+        file: `live:${p.path}`,
+        kind: "page",
+        title: p.title,
+        description: p.description,
+        hasMetadata: Boolean(p.title || p.description),
+        hasCanonical: Boolean(p.canonical),
+        headings: p.headings,
+        h1Count: p.h1.length,
+        imagesMissingAlt: 0,
+        internalLinks: extractInternalHrefs(p.html ?? ""),
+    }));
+    const jsonTypes = new Set();
+    for (const page of pages) {
+        for (const block of page.jsonLd) {
+            const t = block["@type"];
+            if (typeof t === "string")
+                jsonTypes.add(t);
+            const graph = block["@graph"];
+            if (Array.isArray(graph)) {
+                for (const node of graph) {
+                    if (typeof node["@type"] === "string")
+                        jsonTypes.add(node["@type"]);
+                }
+            }
+        }
+    }
+    return {
+        projectRoot: siteUrl,
+        framework: "generic",
+        frameworkConfidence: 0.4,
+        router: "unknown",
+        siteUrl,
+        routes,
+        metadata: {
+            hasMetadataBase: true,
+            hasTitleTemplate: false,
+            hasRootTitle: Boolean(home?.title),
+            hasRootDescription: Boolean(home?.description),
+            rootTitle: home?.title,
+            rootDescription: home?.description,
+            metadataBaseValue: siteUrl,
+        },
+        robots: {
+            present: Boolean(robotsText),
+            content: robotsText ?? undefined,
+            blocksAll: robots.blocksAll,
+            aiCrawlers: robots.aiCrawlers,
+            source: robotsText ? "public/robots.txt" : undefined,
+            file: robotsText ? "robots.txt" : undefined,
+        },
+        sitemap: {
+            present: sitemapPaths.length > 0,
+            routesHint: sitemapPaths,
+            source: sitemapPaths.length ? "public/sitemap.xml" : undefined,
+            file: sitemapPaths.length ? "sitemap.xml" : undefined,
+        },
+        redirects: { present: false, count: 0, snippets: [] },
+        structuredData: {
+            files: pages.filter((p) => p.jsonLd.length).map((p) => `live:${p.path}`),
+            types: [...jsonTypes],
+        },
+        blog: {
+            present: sitemapPaths.some((p) => p.startsWith("/blog")),
+            routes: sitemapPaths.filter((p) => p.startsWith("/blog")),
+            postCount: sitemapPaths.filter((p) => /^\/blog\/.+/.test(p)).length,
+        },
+        business: {
+            name: home?.title,
+            description: home?.description,
+            audienceHints: [],
+            topics: [],
+            confidence: home?.title ? 0.6 : 0.3,
+        },
+        files: [],
+    };
+}
+async function fetchText(url, fetchImpl) {
+    try {
+        const res = await fetchImpl(url, {
+            redirect: "follow",
+            headers: { "User-Agent": "QualityKitBot/0.3 (+https://qualitykit.dev)" },
+        });
+        if (!res.ok)
+            return null;
+        return await res.text();
+    }
+    catch {
+        return null;
+    }
+}
+function parseSitemapPaths(xml, cap) {
+    const paths = [];
+    const re = /<loc>([^<]+)<\/loc>/gi;
+    let m;
+    while ((m = re.exec(xml)) && paths.length < cap) {
+        try {
+            const u = new URL(m[1].trim());
+            paths.push(u.pathname || "/");
+        }
+        catch {
+            // skip
+        }
+    }
+    return [...new Set(paths)];
+}
+function extractInternalHrefs(html) {
+    const links = new Set();
+    const re = /href=["'](\/[^"'#?]*)/g;
+    let m;
+    while ((m = re.exec(html)))
+        links.add(m[1]);
+    return [...links];
+}
+function extractUrls(evidence, base) {
+    const urls = [];
+    for (const e of evidence) {
+        if (e.startsWith("http"))
+            urls.push(e);
+        else if (e.startsWith("/"))
+            urls.push(`${base.replace(/\/$/, "")}${e}`);
+    }
+    return urls.length ? urls : ["/"];
+}
+export function diffRegressions(previousFindingIds, current) {
+    const prev = new Set(previousFindingIds);
+    const currentDefects = current.findings
+        .filter((f) => f.kind === "defect")
+        .map((f) => f.id);
+    return {
+        newDefects: currentDefects.filter((id) => !prev.has(id)),
+        stillOpen: currentDefects.filter((id) => prev.has(id)),
+    };
+}
+//# sourceMappingURL=live-audit.js.map

package/dist/live-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-audit.js","sourceRoot":"","sources":["../src/live-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,kBAAkB,GAGnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,cAAc,GAAG,CAAC,CAAC;AAgBzB,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,UAA4B,EAAE;IAE9B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,IAAI,WAAW,CAAC;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,IAAI,cAAc,CAAC;IAEzD,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,GAAG,IAAI,aAAa,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,GAAG,IAAI,cAAc,EAAE,SAAS,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,UAAU;QAC7B,CAAC,CAAC,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC;QAC3C,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,KAAK,GAAG;QACZ,GAAG;QACH,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;KAC5D,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE;QAC3C,GAAG,OAAO;QACV,KAAK;QACL,SAAS;KACV,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAE1C,MAAM,QAAQ,GAAgB;QAC5B,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QAC3D,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;QACpD,UAAU,EAAE,eAAe;KAC5B,CAAC;IAEF,MAAM,QAAQ,GAAG,UAAU,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ;QACtD,IAAI,EAAE,MAAM;QACZ,QAAQ;QACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,EAAE,CAAC,CAAC,EAAE;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YAC3G,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,oBAAoB;YAChE,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC;YAC3C,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,SAAS,KAAK,MAAM,IAAI,CAAC,CAAC,SAAS,KAAK,UAAU;YAC7D,gBAAgB,EAAE,CAAC,CAAC,SAAS,KAAK,MAAM;YACxC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ;QACR,KAAK;QACL,KAAK;QACL,UAAU,EAAE,UAAU,IAAI,SAAS;QACnC,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAe,EACf,UAAyB,EACzB,YAAsB,EACtB,KAAqB;IAErB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,UAAU;QACvB,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC;QAClC,CAAC,CAAC;YACE,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACrC,IAAI;gBACJ,MAAM,EAAE,SAAkB;gBAC1B,QAAQ,EAAE,wBAAwB;aACnC,CAAC,CAAC;SACJ,CAAC;IAEN,MAAM,MAAM,GAAG,KAAK;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,MAAe;QACrB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,CAAC;QAC9C,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM;QACpB,gBAAgB,EAAE,CAAC;QACnB,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;KAClD,CAAC,CAAC,CAAC;IAEN,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,CAAC,GAAI,KAA8B,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAI,KAAoD,CACjE,QAAQ,CACT,CAAC;YACF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;wBAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE,SAAS;QACpB,mBAAmB,EAAE,GAAG;QACxB,MAAM,EAAE,SAAS;QACjB,OAAO;QACP,MAAM;QACN,QAAQ,EAAE;YACR,eAAe,EAAE,IAAI;YACrB,gBAAgB,EAAE,KAAK;YACvB,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;YAClC,kBAAkB,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC;YAC9C,SAAS,EAAE,IAAI,EAAE,KAAK;YACtB,eAAe,EAAE,IAAI,EAAE,WAAW;YAClC,iBAAiB,EAAE,OAAO;SAC3B;QACD,MAAM,EAAE;YACN,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;YAC5B,OAAO,EAAE,UAAU,IAAI,SAAS;YAChC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS;YACpD,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;SAC5C;QACD,OAAO,EAAE;YACP,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC;YAChC,UAAU,EAAE,YAAY;YACxB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,SAAS;YAC9D,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;SACtD;QACD,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrD,cAAc,EAAE;YACd,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACxE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;SACtB;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACxD,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACzD,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM;SACpE;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,EAAE,KAAK;YACjB,WAAW,EAAE,IAAI,EAAE,WAAW;YAC9B,aAAa,EAAE,EAAE;YACjB,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;SACpC;QACD,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,GAAW,EACX,SAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YAC/B,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,EAAE,YAAY,EAAE,6CAA6C,EAAE;SACzE,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW,EAAE,GAAW;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,uBAAuB,CAAC;IACnC,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,EAAE,GAAG,wBAAwB,CAAC;IACpC,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,QAAkB,EAAE,IAAY;IACnD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aAClC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,kBAA4B,EAC5B,OAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpB,OAAO;QACL,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxD,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,35 @@
+export type CoverageStatus = "completed" | "not_run" | "fail" | "not_connected" | "not_applicable";
+export interface CoverageMap {
+    source: CoverageStatus;
+    rendered: CoverageStatus;
+    live: CoverageStatus;
+    searchData: CoverageStatus;
+}
+export interface ReportFinding {
+    ruleId: string;
+    severity: "P1" | "P2" | "P3";
+    status: "pass" | "fail" | "confirmed" | "needs_verification" | "not_applicable" | "not_run";
+    confidence: "high" | "medium" | "low";
+    affectedUrls: string[];
+    evidence: string[];
+    fixable: boolean;
+    requiresApproval: boolean;
+    title?: string;
+    kind?: "defect" | "opportunity";
+}
+export interface ReportEnvelope {
+    schemaVersion: "1.0";
+    project: string;
+    mode: "full" | "live" | "self_hosted";
+    coverage: CoverageMap;
+    findings: ReportFinding[];
+    summary?: unknown;
+}
+export declare function wrapReport(input: {
+    project: string;
+    mode: ReportEnvelope["mode"];
+    coverage: CoverageMap;
+    findings: ReportFinding[];
+    summary?: unknown;
+}): ReportEnvelope;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,SAAS,GACT,MAAM,GACN,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,MAAM,EACF,MAAM,GACN,MAAM,GACN,WAAW,GACX,oBAAoB,GACpB,gBAAgB,GAChB,SAAS,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,KAAK,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACtC,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,cAAc,CASjB"}

package/dist/report.js

@@ -0,0 +1,11 @@
+export function wrapReport(input) {
+    return {
+        schemaVersion: "1.0",
+        project: input.project,
+        mode: input.mode,
+        coverage: input.coverage,
+        findings: input.findings,
+        summary: input.summary,
+    };
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AA0CA,MAAM,UAAU,UAAU,CAAC,KAM1B;IACC,OAAO;QACL,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC"}

package/dist/robots.d.ts

@@ -0,0 +1,10 @@
+export declare const AI_CRAWLERS: readonly ["GPTBot", "Google-Extended", "PerplexityBot", "ClaudeBot", "anthropic-ai", "Bingbot", "Applebot-Extended", "Bytespider"];
+export declare function analyzeRobotsContent(content: string): {
+    blocksAll: boolean;
+    aiCrawlers: {
+        name: string;
+        status: "allowed" | "disallowed" | "unknown";
+        evidence?: string;
+    }[];
+};
+//# sourceMappingURL=robots.d.ts.map

package/dist/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,oIASd,CAAC;AAEX,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;QAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;CACL,CAsEA"}