@forkpoint/agent-lighthouse-core 0.3.0 → 1.0.0

package/dist/index.js

@@ -40,12 +40,15 @@ __export(index_exports, {
   CheckResultSchema: () => CheckResultSchema,
   CheckStatusSchema: () => CheckStatusSchema,
   DEFAULT_SCAN_LIMIT: () => DEFAULT_SCAN_LIMIT,
+  DeprecationNoticeSchema: () => DeprecationNoticeSchema,
   FixEffortSchema: () => FixEffortSchema,
   MAX_CONCURRENT_REQUESTS: () => MAX_CONCURRENT_REQUESTS,
   MAX_PAGES_PER_SCAN: () => MAX_PAGES_PER_SCAN,
   MAX_RESPONSE_BODY_BYTES: () => MAX_RESPONSE_BODY_BYTES,
   PAGE_TYPE_LABELS: () => PAGE_TYPE_LABELS,
+  PHASE_WEIGHTS: () => PHASE_WEIGHTS,
   PRESETS: () => PRESETS,
+  ProgressTracker: () => ProgressTracker,
   READINESS_WEIGHTS: () => READINESS_WEIGHTS,
   REQUEST_TIMEOUT_MS: () => REQUEST_TIMEOUT_MS,
   SCANNER_USER_AGENT: () => SCANNER_USER_AGENT,
@@ -82,6 +85,7 @@ __export(index_exports, {
   getTierColor: () => getTierColor,
   getTierLabel: () => getTierLabel,
   getWordCount: () => getWordCount,
+  isInformative: () => isInformative,
   isPrivateIp: () => isPrivateIp,
   isSafeUrl: () => isSafeUrl,
   joinUrl: () => joinUrl,
@@ -89,6 +93,7 @@ __export(index_exports, {
   logger: () => logger,
   normalizeUrl: () => normalizeUrl,
   parseHtml: () => parseHtml,
+  planAudits: () => planAudits,
   runAudits: () => runAudits,
   runScan: () => runScan
 });
@@ -798,6 +803,10 @@ var AuditGuidanceSchema = import_zod.z.object({
   tags: import_zod.z.array(import_zod.z.string().max(50)).max(20).optional()
 });
 var ScoreDisplayModeSchema = import_zod.z.enum(["binary", "ternary", "informative"]);
+var DeprecationNoticeSchema = import_zod.z.object({
+  notice: import_zod.z.string().min(1).max(500),
+  link: import_zod.z.string().url()
+});
 var AuditMetaSchema = import_zod.z.object({
   id: import_zod.z.string(),
   category: import_zod.z.string(),
@@ -805,10 +814,12 @@ var AuditMetaSchema = import_zod.z.object({
   failureTitle: import_zod.z.string(),
   description: import_zod.z.string(),
   scoreDisplayMode: ScoreDisplayModeSchema,
-  weight: import_zod.z.number().positive(),
+  // Deprecated audits carry weight 0 (excluded from scoring).
+  weight: import_zod.z.number().nonnegative(),
   applicablePageTypes: import_zod.z.array(import_zod.z.string()).optional(),
   defaultPriority: CheckPrioritySchema,
-  guidance: AuditGuidanceSchema.optional()
+  guidance: AuditGuidanceSchema.optional(),
+  deprecated: DeprecationNoticeSchema.optional()
 });
 var CheckResultSchema = import_zod.z.object({
   id: import_zod.z.string().max(20),
@@ -830,7 +841,8 @@ var CheckResultSchema = import_zod.z.object({
     code: import_zod.z.string().max(1e4).optional(),
     docsUrl: import_zod.z.string().max(2048).url().optional().or(import_zod.z.string().length(0))
   }).optional(),
-  tags: import_zod.z.array(import_zod.z.string().max(50)).max(20).optional()
+  tags: import_zod.z.array(import_zod.z.string().max(50)).max(20).optional(),
+  deprecated: DeprecationNoticeSchema.optional()
 });
 
 // src/audit.ts
@@ -923,7 +935,8 @@ var Audit = class _Audit {
         docsUrl: meta.guidance?.docsUrl,
         effort: meta.guidance?.effort
       },
-      tags: meta.guidance?.tags
+      tags: meta.guidance?.tags,
+      deprecated: meta.deprecated
     };
   }
 };
@@ -2626,90 +2639,16 @@ var NoBrokenLinksAudit = class _NoBrokenLinksAudit extends Audit {
   }
 };
 
-// src/audits/content-discoverability/navigation-json.ts
-function isOk14(result) {
-  return result.status === 200;
-}
-var NavigationJsonAudit = class extends Audit {
-  static meta = {
-    id: "1.21",
-    category: "content-discoverability",
-    title: "navigation.json present",
-    failureTitle: "navigation.json present",
-    description: "A navigation.json file gives AI agents a machine-readable map of your site hierarchy, helping them navigate your site like a human would.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "Without a machine-readable navigation structure, AI agents must infer your site hierarchy from HTML parsing, which is error-prone and incomplete. A navigation.json gives agents a clear map of your site, enabling accurate multi-step browsing.",
-      fix: "Create a /navigation.json file at your site root with a JSON structure representing your site menu hierarchy. Include labels, URLs, and nested children for submenus.",
-      code: '{\n  "name": "Your Site",\n  "items": [\n    { "label": "Home", "url": "/" },\n    { "label": "Products", "url": "/products", "children": [\n      { "label": "Product A", "url": "/products/a" },\n      { "label": "Product B", "url": "/products/b" }\n    ]},\n    { "label": "About", "url": "/about" }\n  ]\n}',
-      effort: "easy",
-      tags: ["navigation", "structured-data", "discoverability"]
-    }
-  };
-  audit(ctx) {
-    const result = ctx.rootFiles["/navigation.json"];
-    if (!result || !isOk14(result)) {
-      return this.fail(
-        "No navigation.json found at the site root.",
-        "GET /navigation.json returns 200 with valid JSON",
-        result ? `HTTP ${result.status}` : "No response",
-        {
-          priority: "medium",
-          description: "A navigation.json file gives AI agents a machine-readable map of your site hierarchy. This helps agents navigate your site like a human would, following logical paths through menus and sections.",
-          code: `{
-  "name": "Your Site",
-  "items": [
-    { "label": "Home", "url": "/" },
-    { "label": "Products", "url": "/products", "children": [
-      { "label": "Product A", "url": "/products/a" },
-      { "label": "Product B", "url": "/products/b" }
-    ]},
-    { "label": "About", "url": "/about" }
-  ]
-}`
-        }
-      );
-    }
-    try {
-      JSON.parse(result.body);
-    } catch {
-      return this.fail(
-        "navigation.json exists but contains invalid JSON.",
-        "Valid JSON content",
-        "Invalid JSON",
-        {
-          priority: "medium",
-          description: "Your navigation.json has invalid JSON syntax, so AI agents cannot parse it. Validate the JSON and fix any syntax errors (missing commas, unquoted keys, etc.).",
-          code: `{
-  "name": "Your Site",
-  "items": [
-    { "label": "Home", "url": "/" },
-    { "label": "About", "url": "/about" }
-  ]
-}`
-        }
-      );
-    }
-    return this.pass(
-      "navigation.json exists with valid JSON.",
-      "HTTP 200 with valid JSON",
-      "Valid JSON"
-    );
-  }
-};
-
 // src/audits/content-discoverability/no-orphan-pages.ts
 var cheerio7 = __toESM(require("cheerio"));
-function isOk15(result) {
+function isOk14(result) {
   return result.status === 200;
 }
 function getSitemapResult5(ctx) {
   const sitemap = ctx.rootFiles["/sitemap.xml"];
-  if (sitemap && isOk15(sitemap)) return sitemap;
+  if (sitemap && isOk14(sitemap)) return sitemap;
   const index = ctx.rootFiles["/sitemap-index.xml"];
-  if (index && isOk15(index)) return index;
+  if (index && isOk14(index)) return index;
   return null;
 }
 var NoOrphanPagesAudit = class extends Audit {
@@ -2751,7 +2690,7 @@ var NoOrphanPagesAudit = class extends Audit {
     }
     const llmsUrls = /* @__PURE__ */ new Set();
     const llmsResult = ctx.rootFiles["/llms.txt"];
-    if (llmsResult && isOk15(llmsResult)) {
+    if (llmsResult && isOk14(llmsResult)) {
       const links = extractMarkdownLinks(llmsResult.body);
       for (const link of links) {
         try {
@@ -5062,82 +5001,6 @@ var SpeakableSchemaAudit = class extends Audit {
   }
 };
 
-// src/audits/structured-data/potential-action.ts
-function matchesAnyType3(schema, types) {
-  return types.some((t) => {
-    const st = schema["@type"];
-    if (typeof st === "string") return st === t;
-    if (Array.isArray(st)) return st.includes(t);
-    return false;
-  });
-}
-function allSchemas5(ctx) {
-  return ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
-}
-var PotentialActionAudit = class extends Audit {
-  static meta = {
-    id: "3.10",
-    category: "structured-data",
-    title: "potentialAction on service pages",
-    failureTitle: "potentialAction on service pages",
-    description: "AI agents use potentialAction to understand what actions users can take on your site (order, book, contact). This enables agentic workflows where ChatGPT or Claude can guide users directly to the right action URL instead of just describing your service.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    applicablePageTypes: ["homepage", "product"],
-    defaultPriority: "medium",
-    guidance: {
-      impact: "Without potentialAction schema, AI agents cannot determine what actions users can take on your site (order, book, contact). This prevents agentic workflows where ChatGPT or Claude could guide users directly to the right action URL, reducing conversion from AI-driven traffic.",
-      fix: "Add a potentialAction property to your Organization or Service schema with a ContactAction, OrderAction, or BookAction type and a target URL.",
-      code: `{
-  "@context": "https://schema.org",
-  "@type": "Organization",
-  "name": "Your Company",
-  "potentialAction": {
-    "@type": "OrderAction",
-    "target": "https://yoursite.com/order"
-  }
-}`,
-      effort: "easy",
-      docsUrl: "https://schema.org/potentialAction",
-      tags: ["json-ld", "schema", "actions", "agentic-commerce"]
-    }
-  };
-  audit(ctx) {
-    const actionTypes = ["ContactAction", "OrderAction", "BookAction"];
-    const schemas = allSchemas5(ctx);
-    const withAction = schemas.filter((s) => {
-      const obj = s;
-      const action = obj["potentialAction"];
-      if (!action) return false;
-      const actions = Array.isArray(action) ? action : [action];
-      return actions.some(
-        (a) => a && typeof a === "object" && matchesAnyType3(a, actionTypes)
-      );
-    });
-    const found = withAction.length > 0;
-    if (found) {
-      return this.pass(
-        `potentialAction (ContactAction/OrderAction/BookAction) found on ${withAction.length} schema(s).`,
-        "At least one page with potentialAction (ContactAction, OrderAction, or BookAction).",
-        `${withAction.length} schema(s) with qualifying potentialAction`
-      );
-    }
-    return this.fail(
-      "No potentialAction with ContactAction, OrderAction, or BookAction found.",
-      "At least one page with potentialAction (ContactAction, OrderAction, or BookAction).",
-      "None",
-      {
-        priority: "medium",
-        description: "AI agents use potentialAction to understand what actions users can take on your site (order, book, contact). This enables agentic workflows where ChatGPT or Claude can guide users directly to the right action URL instead of just describing your service.",
-        code: `"potentialAction": {
-  "@type": "OrderAction",
-  "target": "https://yoursite.com/order"
-}`
-      }
-    );
-  }
-};
-
 // src/audits/structured-data/howto-schema.ts
 function matchesType4(schema, type) {
   const t = schema["@type"];
@@ -5274,7 +5137,7 @@ var HowToSchemaAudit = class extends Audit {
 };
 
 // src/audits/structured-data/local-business-schema.ts
-function matchesAnyType4(schema, types) {
+function matchesAnyType3(schema, types) {
   return types.some((t) => {
     const st = schema["@type"];
     if (typeof st === "string") return st === t;
@@ -5282,12 +5145,12 @@ function matchesAnyType4(schema, types) {
     return false;
   });
 }
-function allSchemas6(ctx) {
+function allSchemas5(ctx) {
   return ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
 }
 function hasPostalAddressBlock(page) {
   const schemas = flattenJsonLd(page.structuredData ?? page.jsonLd);
-  if (schemas.some((s) => matchesAnyType4(s, ["PostalAddress"]))) {
+  if (schemas.some((s) => matchesAnyType3(s, ["PostalAddress"]))) {
     return true;
   }
   return page.$('[itemtype*="PostalAddress"]').length > 0;
@@ -5353,9 +5216,9 @@ var LocalBusinessSchemaAudit = class extends Audit {
         "No physical location indicators found."
       );
     }
-    const schemas = allSchemas6(ctx);
+    const schemas = allSchemas5(ctx);
     const localSchemas = schemas.filter(
-      (s) => matchesAnyType4(s, ["LocalBusiness", "ProfessionalService"])
+      (s) => matchesAnyType3(s, ["LocalBusiness", "ProfessionalService"])
     );
     const found = localSchemas.length > 0;
     if (found) {
@@ -5385,7 +5248,7 @@ var LocalBusinessSchemaAudit = class extends Audit {
 };
 
 // src/audits/structured-data/review-schema.ts
-function matchesAnyType5(schema, types) {
+function matchesAnyType4(schema, types) {
   return types.some((t) => {
     const st = schema["@type"];
     if (typeof st === "string") return st === t;
@@ -5393,7 +5256,7 @@ function matchesAnyType5(schema, types) {
     return false;
   });
 }
-function allSchemas7(ctx) {
+function allSchemas6(ctx) {
   return ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
 }
 function hasTestimonialContent(page) {
@@ -5462,9 +5325,9 @@ var ReviewSchemaAudit = class extends Audit {
         }
       );
     }
-    const schemas = allSchemas7(ctx);
+    const schemas = allSchemas6(ctx);
     const reviewSchemas = schemas.filter(
-      (s) => matchesAnyType5(s, ["Review", "AggregateRating"])
+      (s) => matchesAnyType4(s, ["Review", "AggregateRating"])
     );
     const schemasWithReviewProp = schemas.filter((s) => {
       const obj = s;
@@ -5496,7 +5359,7 @@ var ReviewSchemaAudit = class extends Audit {
 };
 
 // src/audits/structured-data/offer-schema.ts
-function matchesAnyType6(schema, types) {
+function matchesAnyType5(schema, types) {
   return types.some((t) => {
     const st = schema["@type"];
     if (typeof st === "string") return st === t;
@@ -5544,7 +5407,7 @@ var OfferSchemaAudit = class extends Audit {
     const pagesWithOffer = productPages.filter((p) => {
       const schemas = flattenJsonLd(p.structuredData ?? p.jsonLd);
       const hasOfferSchema = schemas.some(
-        (s) => matchesAnyType6(s, ["Offer", "AggregateOffer"])
+        (s) => matchesAnyType5(s, ["Offer", "AggregateOffer"])
       );
       const hasOfferProp = schemas.some((s) => {
         const obj = s;
@@ -5558,7 +5421,7 @@ var OfferSchemaAudit = class extends Audit {
       });
       if (hasOfferSchema) {
         const first2 = schemas.find(
-          (s) => matchesAnyType6(s, ["Offer", "AggregateOffer"])
+          (s) => matchesAnyType5(s, ["Offer", "AggregateOffer"])
         );
         return first2 && first2["price"] !== void 0 && !!first2["priceCurrency"];
       }
@@ -5617,10 +5480,10 @@ function matchesType5(schema, type) {
   if (Array.isArray(t)) return t.includes(type);
   return false;
 }
-function matchesAnyType7(schema, types) {
+function matchesAnyType6(schema, types) {
   return types.some((t) => matchesType5(schema, t));
 }
-function allSchemas8(ctx) {
+function allSchemas7(ctx) {
   return ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
 }
 function hasProps3(obj, keys) {
@@ -5660,13 +5523,13 @@ var AuthorSchemaAudit = class extends Audit {
     }
   };
   audit(ctx) {
-    const schemas = allSchemas8(ctx);
+    const schemas = allSchemas7(ctx);
     const personSchemas = schemas.filter(
       (s) => matchesType5(s, "Person")
     );
     const authorFromArticles = [];
     for (const s of schemas) {
-      if (matchesAnyType7(s, ["Article", "NewsArticle", "BlogPosting"])) {
+      if (matchesAnyType6(s, ["Article", "NewsArticle", "BlogPosting"])) {
         const author = s["author"];
         if (Array.isArray(author)) {
           for (const a of author) {
@@ -5736,120 +5599,8 @@ var AuthorSchemaAudit = class extends Audit {
   }
 };
 
-// src/audits/structured-data/action-schema.ts
-function matchesAnyType8(schema, types) {
-  return types.some((t) => {
-    const st = schema["@type"];
-    if (typeof st === "string") return st === t;
-    if (Array.isArray(st)) return st.includes(t);
-    return false;
-  });
-}
-function isConfirmationUrl(url) {
-  return /\/(thank-?you|confirmation|success|order-complete)\b/i.test(url);
-}
-var ActionSchemaAudit = class extends Audit {
-  static meta = {
-    id: "3.16",
-    category: "structured-data",
-    title: "ConfirmAction/ReserveAction schema",
-    failureTitle: "ConfirmAction/ReserveAction schema",
-    description: "AI agents use ConfirmAction/ReserveAction schema to complete transactions on behalf of users in agentic workflows. Without this schema on your confirmation pages, agents cannot programmatically verify that a booking or purchase was successful.",
-    scoreDisplayMode: "ternary",
-    weight: 1,
-    defaultPriority: "low",
-    guidance: {
-      impact: "Without ConfirmAction or ReserveAction schema on confirmation pages, AI agents cannot programmatically verify that a booking or purchase completed successfully. This breaks end-to-end agentic commerce workflows, forcing users back into manual checkout confirmation.",
-      fix: "Add a ConfirmAction or ReserveAction as a potentialAction on your thank-you/confirmation page JSON-LD. Include the target URL pointing to the confirmation endpoint.",
-      code: `{
-  "@context": "https://schema.org",
-  "@type": "WebPage",
-  "potentialAction": {
-    "@type": "ConfirmAction",
-    "target": "https://yoursite.com/confirm"
-  }
-}`,
-      effort: "moderate",
-      docsUrl: "https://schema.org/ConfirmAction",
-      tags: ["json-ld", "schema", "agentic-commerce", "actions"]
-    }
-  };
-  audit(ctx) {
-    const confirmationPages = ctx.pages.filter((p) => isConfirmationUrl(p.url));
-    if (confirmationPages.length === 0) {
-      return this.warn(
-        "No thank-you or confirmation pages detected to evaluate.",
-        "ConfirmAction or ReserveAction schema on thank-you/confirmation pages.",
-        "No confirmation pages detected (URLs containing /thank-you/, /confirmation/, /success/).",
-        {
-          priority: "low",
-          description: "If your site has booking or purchase flows, AI agents use ConfirmAction/ReserveAction schema to complete transactions on behalf of users. This enables end-to-end agentic workflows where the agent can confirm a booking without the user manually navigating forms.",
-          code: `"potentialAction": {
-  "@type": "ConfirmAction",
-  "target": "https://yoursite.com/confirm"
-}`
-        }
-      );
-    }
-    const actionTypes = ["ConfirmAction", "ReserveAction"];
-    const pagesWithAction = confirmationPages.filter((p) => {
-      const schemas = flattenJsonLd(p.structuredData ?? p.jsonLd);
-      const hasActionSchema = schemas.some(
-        (s) => matchesAnyType8(s, actionTypes)
-      );
-      const hasActionProp = schemas.some((s) => {
-        const obj = s;
-        const action = obj["potentialAction"];
-        if (!action) return false;
-        const actions = Array.isArray(action) ? action : [action];
-        return actions.some(
-          (a) => a && typeof a === "object" && matchesAnyType8(a, actionTypes)
-        );
-      });
-      return hasActionSchema || hasActionProp;
-    });
-    const allHave = pagesWithAction.length === confirmationPages.length;
-    const someHave = pagesWithAction.length > 0;
-    if (allHave) {
-      return this.pass(
-        `ConfirmAction/ReserveAction found on all ${confirmationPages.length} confirmation page(s).`,
-        "ConfirmAction or ReserveAction schema on thank-you/confirmation pages.",
-        `${pagesWithAction.length}/${confirmationPages.length} confirmation pages with action schema`
-      );
-    }
-    if (someHave) {
-      return this.warn(
-        `ConfirmAction/ReserveAction found on ${pagesWithAction.length} of ${confirmationPages.length} confirmation page(s).`,
-        "ConfirmAction or ReserveAction schema on thank-you/confirmation pages.",
-        `${pagesWithAction.length}/${confirmationPages.length} confirmation pages with action schema`,
-        {
-          priority: "low",
-          description: "AI agents use ConfirmAction/ReserveAction schema to complete transactions on behalf of users in agentic workflows. Without this schema on your confirmation pages, agents cannot programmatically verify that a booking or purchase was successful.",
-          code: `"potentialAction": {
-  "@type": "ConfirmAction",
-  "target": "https://yoursite.com/confirm"
-}`
-        }
-      );
-    }
-    return this.fail(
-      `No ConfirmAction/ReserveAction found on ${confirmationPages.length} confirmation page(s).`,
-      "ConfirmAction or ReserveAction schema on thank-you/confirmation pages.",
-      `${pagesWithAction.length}/${confirmationPages.length} confirmation pages with action schema`,
-      {
-        priority: "low",
-        description: "AI agents use ConfirmAction/ReserveAction schema to complete transactions on behalf of users in agentic workflows. Without this schema on your confirmation pages, agents cannot programmatically verify that a booking or purchase was successful.",
-        code: `"potentialAction": {
-  "@type": "ConfirmAction",
-  "target": "https://yoursite.com/confirm"
-}`
-      }
-    );
-  }
-};
-
 // src/audits/structured-data/product-identifiers.ts
-function matchesAnyType9(schema, types) {
+function matchesAnyType7(schema, types) {
   return types.some((t) => {
     const st = schema["@type"];
     if (typeof st === "string") return st === t;
@@ -5887,7 +5638,7 @@ var ProductIdentifiersAudit = class extends Audit {
   audit(ctx) {
     const schemas = ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
     const products = schemas.filter(
-      (s) => matchesAnyType9(s, [
+      (s) => matchesAnyType7(s, [
         "Product",
         "IndividualProduct",
         "ProductModel"
@@ -5952,7 +5703,7 @@ var ProductIdentifiersAudit = class extends Audit {
 };
 
 // src/audits/structured-data/product-details.ts
-function matchesAnyType10(schema, types) {
+function matchesAnyType8(schema, types) {
   return types.some((t) => {
     const st = schema["@type"];
     if (typeof st === "string") return st === t;
@@ -5996,7 +5747,7 @@ var ProductDetailsAudit = class extends Audit {
   audit(ctx) {
     const schemas = ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
     const products = schemas.filter(
-      (s) => matchesAnyType10(s, [
+      (s) => matchesAnyType8(s, [
         "Product",
         "IndividualProduct",
         "ProductModel"
@@ -6115,7 +5866,7 @@ var ProductReviewsAudit = class extends Audit {
 };
 
 // src/audits/structured-data/product-transaction-certainty.ts
-function matchesAnyType11(schema, types) {
+function matchesAnyType9(schema, types) {
   return types.some((t) => {
     const st = schema["@type"];
     if (typeof st === "string") return st === t;
@@ -6174,7 +5925,7 @@ var ProductTransactionCertaintyAudit = class extends Audit {
   audit(ctx) {
     const schemas = ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
     const products = schemas.filter(
-      (s) => matchesAnyType11(s, [
+      (s) => matchesAnyType9(s, [
         "Product",
         "IndividualProduct",
         "ProductModel"
@@ -6879,53 +6630,6 @@ var LlmsTxtLinkAudit = class extends Audit {
   }
 };
 
-// src/audits/meta-tags/llms-full-txt-link.ts
-var LlmsFullTxtLinkAudit = class extends Audit {
-  static meta = {
-    id: "4.12",
-    category: "meta-tags",
-    title: "llms-full.txt link in head",
-    failureTitle: "llms-full.txt link in head",
-    description: "The llms-full.txt file provides AI agents with a comprehensive, unabridged version of your content optimized for ingestion into context windows. Adding this link in <head> lets agents choose between the summary (llms.txt) and full content versions based on their context budget.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "The llms-full.txt file provides AI agents with a comprehensive, unabridged version of your content optimized for large context windows. Without it, agents are limited to the summary version, potentially missing important details about your offerings.",
-      fix: 'Create a llms-full.txt file with comprehensive content and add a <link rel="alternate"> tag in <head> pointing to it.',
-      code: '<link rel="alternate" type="text/plain" href="/llms-full.txt" title="LLMs-full.txt">',
-      effort: "moderate",
-      docsUrl: "https://llmstxt.org/",
-      tags: ["meta-tags", "llms-txt", "ai-discovery"]
-    }
-  };
-  audit(ctx) {
-    const page = ctx.pages[0];
-    const link = page?.headLinks?.find(
-      (l) => l.rel === "alternate" && l.type === "text/plain" && (l.title ?? "").toLowerCase().includes("llms-full")
-    );
-    if (link) {
-      return this.pass(
-        `llms-full.txt link found: "${link.href}".`,
-        '<link rel="alternate" type="text/plain" title="...LLMs-full...">',
-        `href="${link.href}" title="${link.title}"`,
-        page.url
-      );
-    }
-    return this.fail(
-      "No llms-full.txt link found in <head>.",
-      '<link rel="alternate" type="text/plain" title="...LLMs-full...">',
-      "Not found",
-      {
-        priority: "medium",
-        description: "The llms-full.txt file provides AI agents with a comprehensive, unabridged version of your content optimized for ingestion into context windows. Adding this link in <head> lets agents choose between the summary (llms.txt) and full content versions based on their context budget.",
-        code: '<link rel="alternate" type="text/plain" href="/llms-full.txt" title="LLMs-full.txt">'
-      },
-      page?.url
-    );
-  }
-};
-
 // src/audits/meta-tags/ai-content-declaration.ts
 var AiContentDeclarationAudit = class extends Audit {
   static meta = {
@@ -6983,50 +6687,6 @@ var AiContentDeclarationAudit = class extends Audit {
   }
 };
 
-// src/audits/meta-tags/ai-instructions.ts
-var AiInstructionsAudit = class extends Audit {
-  static meta = {
-    id: "4.14",
-    category: "meta-tags",
-    title: "ai-instructions meta",
-    failureTitle: "ai-instructions meta",
-    description: "The ai-instructions meta tag gives AI agents a plain-English brief on how to interact with your site and represent your content. It acts like a system prompt for any AI agent visiting your page, telling it your preferred summarization style, content focus, and usage guidelines.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "Without ai-instructions, AI agents have no guidance on how to interact with your site or represent your content. They may summarize your pages inaccurately, speculate about features, or miss your preferred content focus.",
-      fix: 'Add a <meta name="ai-instructions"> tag with plain-English instructions telling AI agents how to summarize and represent your content.',
-      code: '<meta name="ai-instructions" content="Summarise this page as a product overview. Focus on features and pricing. Do not speculate about unreleased features.">',
-      effort: "trivial",
-      tags: ["meta-tags", "ai-policy", "ai-discovery"]
-    }
-  };
-  audit(ctx) {
-    const page = ctx.pages[0];
-    const value = (page?.meta?.["ai-instructions"] ?? "").trim();
-    if (value) {
-      return this.pass(
-        `ai-instructions meta tag is present.`,
-        "meta[ai-instructions] with non-empty content",
-        value.length > 80 ? value.slice(0, 80) + "..." : value,
-        page.url
-      );
-    }
-    return this.fail(
-      "No ai-instructions meta tag found.",
-      "meta[ai-instructions] with non-empty content",
-      "Not found",
-      {
-        priority: "medium",
-        description: "The ai-instructions meta tag gives AI agents a plain-English brief on how to interact with your site and represent your content. It acts like a system prompt for any AI agent visiting your page, telling it your preferred summarization style, content focus, and usage guidelines.",
-        code: '<meta name="ai-instructions" content="Summarise this page as a product overview. Focus on features and pricing. Do not speculate about unreleased features.">'
-      },
-      page?.url
-    );
-  }
-};
-
 // src/audits/meta-tags/markdown-alternate.ts
 var MarkdownAlternateAudit = class extends Audit {
   static meta = {
@@ -7117,94 +6777,47 @@ var RssFeedLinkAudit = class extends Audit {
   }
 };
 
-// src/audits/meta-tags/mcp-discovery-link.ts
-var McpDiscoveryLinkAudit = class extends Audit {
+// src/audits/meta-tags/openapi-link.ts
+var OpenApiLinkAudit = class extends Audit {
   static meta = {
-    id: "4.17",
+    id: "4.18",
     category: "meta-tags",
-    title: "MCP discovery link in head",
-    failureTitle: "MCP discovery link in head",
-    description: "The MCP (Model Context Protocol) discovery link in <head> enables AI agents like Claude and ChatGPT to find and connect to your site's tool endpoints. This is how agents discover that your site offers programmatic actions (search, booking, data queries) beyond static content. Without it, agents cannot discover your MCP server.",
+    title: "OpenAPI spec link in head",
+    failureTitle: "OpenAPI spec link in head",
+    description: "AI agents use OpenAPI specifications to understand your API endpoints, parameters, and response formats. An OpenAPI link in <head> enables agents to programmatically interact with your API without manual documentation parsing, powering agentic workflows that call your services.",
     scoreDisplayMode: "binary",
     weight: 1,
     defaultPriority: "low",
     guidance: {
-      impact: "Without an MCP discovery link, AI agents like Claude and ChatGPT cannot find your site's tool endpoints. This means agents cannot discover that your site offers programmatic actions (search, booking, data queries) beyond static content.",
-      fix: 'If your site offers API endpoints or tools, create an MCP server configuration and add a <link rel="alternate"> tag in <head> pointing to it.',
-      code: '<link rel="alternate" type="application/json" href="/mcp.json" title="MCP Server">',
+      impact: "Without an OpenAPI spec link, AI agents cannot programmatically understand your API endpoints, parameters, and response formats. This blocks agentic workflows that could call your API services on behalf of users.",
+      fix: 'If your site has an API, create an OpenAPI specification and add a <link rel="alternate"> tag in <head> pointing to it.',
+      code: '<link rel="alternate" type="application/json" href="/openapi.json" title="OpenAPI Spec">',
       effort: "complex",
-      docsUrl: "https://modelcontextprotocol.io/",
-      tags: ["meta-tags", "mcp", "agentic-commerce", "ai-discovery"]
+      docsUrl: "https://swagger.io/specification/",
+      tags: ["meta-tags", "openapi", "api", "ai-discovery"]
     }
   };
   audit(ctx) {
     const page = ctx.pages[0];
     const link = page?.headLinks?.find(
-      (l) => l.rel === "alternate" && l.type === "application/json" && (l.title ?? "").toLowerCase().includes("mcp") || l.rel === "mcp-discovery" || l.rel === "alternate" && (l.href ?? "").toLowerCase().includes("mcp.json")
+      (l) => l.rel === "alternate" && l.type === "application/json" && (l.title ?? "").toLowerCase().includes("openapi")
     );
     if (link) {
       return this.pass(
-        `MCP discovery link found: "${link.href}".`,
-        '<link rel="alternate" type="application/json" title="...MCP...">',
+        `OpenAPI spec link found: "${link.href}".`,
+        '<link rel="alternate" type="application/json" title="...OpenAPI...">',
         `href="${link.href}" title="${link.title}"`,
         page.url
       );
     }
     return this.fail(
-      "No MCP discovery link found in <head>.",
-      '<link rel="alternate" type="application/json" title="...MCP...">',
+      "No OpenAPI spec link found in <head>.",
+      '<link rel="alternate" type="application/json" title="...OpenAPI...">',
       "Not found",
       {
         priority: "low",
-        description: "The MCP (Model Context Protocol) discovery link in <head> enables AI agents like Claude and ChatGPT to find and connect to your site's tool endpoints. This is how agents discover that your site offers programmatic actions (search, booking, data queries) beyond static content. Without it, agents cannot discover your MCP server.",
-        code: '<link rel="alternate" type="application/json" href="/mcp.json" title="MCP Server">'
-      },
-      page?.url
-    );
-  }
-};
-
-// src/audits/meta-tags/openapi-link.ts
-var OpenApiLinkAudit = class extends Audit {
-  static meta = {
-    id: "4.18",
-    category: "meta-tags",
-    title: "OpenAPI spec link in head",
-    failureTitle: "OpenAPI spec link in head",
-    description: "AI agents use OpenAPI specifications to understand your API endpoints, parameters, and response formats. An OpenAPI link in <head> enables agents to programmatically interact with your API without manual documentation parsing, powering agentic workflows that call your services.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "low",
-    guidance: {
-      impact: "Without an OpenAPI spec link, AI agents cannot programmatically understand your API endpoints, parameters, and response formats. This blocks agentic workflows that could call your API services on behalf of users.",
-      fix: 'If your site has an API, create an OpenAPI specification and add a <link rel="alternate"> tag in <head> pointing to it.',
-      code: '<link rel="alternate" type="application/json" href="/openapi.json" title="OpenAPI Spec">',
-      effort: "complex",
-      docsUrl: "https://swagger.io/specification/",
-      tags: ["meta-tags", "openapi", "api", "ai-discovery"]
-    }
-  };
-  audit(ctx) {
-    const page = ctx.pages[0];
-    const link = page?.headLinks?.find(
-      (l) => l.rel === "alternate" && l.type === "application/json" && (l.title ?? "").toLowerCase().includes("openapi")
-    );
-    if (link) {
-      return this.pass(
-        `OpenAPI spec link found: "${link.href}".`,
-        '<link rel="alternate" type="application/json" title="...OpenAPI...">',
-        `href="${link.href}" title="${link.title}"`,
-        page.url
-      );
-    }
-    return this.fail(
-      "No OpenAPI spec link found in <head>.",
-      '<link rel="alternate" type="application/json" title="...OpenAPI...">',
-      "Not found",
-      {
-        priority: "low",
-        description: "AI agents use OpenAPI specifications to understand your API endpoints, parameters, and response formats. An OpenAPI link in <head> enables agents to programmatically interact with your API without manual documentation parsing, powering agentic workflows that call your services.",
-        code: '<link rel="alternate" type="application/json" href="/openapi.json" title="OpenAPI Spec">'
+        description: "AI agents use OpenAPI specifications to understand your API endpoints, parameters, and response formats. An OpenAPI link in <head> enables agents to programmatically interact with your API without manual documentation parsing, powering agentic workflows that call your services.",
+        code: '<link rel="alternate" type="application/json" href="/openapi.json" title="OpenAPI Spec">'
       },
       page?.url
     );
@@ -7729,7 +7342,7 @@ var OpenApiOperationIdsAudit = class _OpenApiOperationIdsAudit extends Audit {
   }
 };
 
-// src/audits/agent-tools/openapi-ai-instructions.ts
+// src/audits/agent-tools/openapi-servers.ts
 function tryParseJson4(body) {
   try {
     return JSON.parse(body);
@@ -7748,90 +7361,6 @@ function getOpenApiSpec3(ctx) {
   }
   return void 0;
 }
-var OpenApiAiInstructionsAudit = class _OpenApiAiInstructionsAudit extends Audit {
-  static meta = {
-    id: "5.4",
-    category: "agent-tools",
-    title: "x-ai-instructions in OpenAPI",
-    failureTitle: "x-ai-instructions in OpenAPI",
-    description: "The x-ai-instructions field lets you give natural-language guidance to AI agents about how to use your API. This is your chance to explain business logic, rate limits, authentication flow, and common use cases in plain English.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "Without x-ai-instructions, AI agents must infer your API's business logic, usage patterns, and constraints from endpoint names alone. This leads to incorrect API usage, violated rate limits, and poor user experiences.",
-      fix: "Add an x-ai-instructions string to the info object of your OpenAPI spec. Describe common workflows, rate limits, authentication requirements, and any sequencing constraints in plain English.",
-      code: `"info": {
-  "title": "Your Site API",
-  "version": "1.0.0",
-  "x-ai-instructions": "This API lets you search content, submit contact forms, and retrieve product details. Always call searchContent before submitContact. Rate limit: 10 requests/minute. No authentication required for read endpoints."
-}`,
-      effort: "trivial",
-      tags: ["openapi", "ai-instructions", "api"]
-    }
-  };
-  audit(ctx) {
-    const spec = getOpenApiSpec3(ctx);
-    if (!spec) {
-      return this.fail(
-        "No parseable OpenAPI JSON spec found.",
-        "info object has x-ai-instructions field",
-        "No spec",
-        {
-          priority: "medium",
-          description: _OpenApiAiInstructionsAudit.meta.description,
-          code: `"info": {
-  "title": "Your Site API",
-  "version": "1.0.0",
-  "x-ai-instructions": "This API lets you search content, submit contact forms, and retrieve product details. Always call searchContent before submitContact. Rate limit: 10 requests/minute. No authentication required for read endpoints."
-}`
-        }
-      );
-    }
-    const info = spec["info"];
-    if (isObject4(info) && typeof info["x-ai-instructions"] === "string" && info["x-ai-instructions"]) {
-      return this.pass(
-        "OpenAPI info object contains x-ai-instructions.",
-        "info object has x-ai-instructions field",
-        "x-ai-instructions present"
-      );
-    }
-    return this.fail(
-      "OpenAPI info object does not contain x-ai-instructions.",
-      "info object has x-ai-instructions field",
-      "x-ai-instructions missing",
-      {
-        priority: "medium",
-        description: _OpenApiAiInstructionsAudit.meta.description,
-        code: `"info": {
-  "title": "Your Site API",
-  "version": "1.0.0",
-  "x-ai-instructions": "This API lets you search content, submit contact forms, and retrieve product details. Always call searchContent before submitContact. Rate limit: 10 requests/minute. No authentication required for read endpoints."
-}`
-      }
-    );
-  }
-};
-
-// src/audits/agent-tools/openapi-servers.ts
-function tryParseJson5(body) {
-  try {
-    return JSON.parse(body);
-  } catch {
-    return void 0;
-  }
-}
-function isObject5(val) {
-  return typeof val === "object" && val !== null && !Array.isArray(val);
-}
-function getOpenApiSpec4(ctx) {
-  const jsonResult = ctx.rootFiles["/openapi.json"];
-  if (jsonResult && jsonResult.status === 200 && jsonResult.body) {
-    const parsed = tryParseJson5(jsonResult.body);
-    if (isObject5(parsed)) return parsed;
-  }
-  return void 0;
-}
 var OpenApiServersAudit = class _OpenApiServersAudit extends Audit {
   static meta = {
     id: "5.5",
@@ -7857,7 +7386,7 @@ var OpenApiServersAudit = class _OpenApiServersAudit extends Audit {
     }
   };
   async audit(ctx) {
-    const spec = getOpenApiSpec4(ctx);
+    const spec = getOpenApiSpec3(ctx);
     if (!spec) {
       return this.fail(
         "No parseable OpenAPI JSON spec found.",
@@ -7894,7 +7423,7 @@ var OpenApiServersAudit = class _OpenApiServersAudit extends Audit {
       );
     }
     const firstWithUrl = servers.find(
-      (s) => isObject5(s) && typeof s["url"] === "string" && s["url"]
+      (s) => isObject4(s) && typeof s["url"] === "string" && s["url"]
     );
     if (!firstWithUrl) {
       return this.fail(
@@ -7959,34 +7488,34 @@ var OpenApiServersAudit = class _OpenApiServersAudit extends Audit {
 };
 
 // src/audits/agent-tools/openapi-schemas.ts
-function tryParseJson6(body) {
+function tryParseJson5(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject6(val) {
+function isObject5(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var HTTP_METHODS3 = ["get", "post", "put", "patch", "delete", "options", "head", "trace"];
-function getOpenApiSpec5(ctx) {
+function getOpenApiSpec4(ctx) {
   const jsonResult = ctx.rootFiles["/openapi.json"];
   if (jsonResult && jsonResult.status === 200 && jsonResult.body) {
-    const parsed = tryParseJson6(jsonResult.body);
-    if (isObject6(parsed)) return parsed;
+    const parsed = tryParseJson5(jsonResult.body);
+    if (isObject5(parsed)) return parsed;
   }
   return void 0;
 }
 function getOperations3(spec) {
   const paths = spec["paths"];
-  if (!isObject6(paths)) return [];
+  if (!isObject5(paths)) return [];
   const ops = [];
   for (const [path, pathItem] of Object.entries(paths)) {
-    if (!isObject6(pathItem)) continue;
+    if (!isObject5(pathItem)) continue;
     for (const method of HTTP_METHODS3) {
       const op = pathItem[method];
-      if (isObject6(op)) {
+      if (isObject5(op)) {
         ops.push({ path, method, op });
       }
     }
@@ -8047,7 +7576,7 @@ var OpenApiSchemasAudit = class _OpenApiSchemasAudit extends Audit {
     }
   };
   audit(ctx) {
-    const spec = getOpenApiSpec5(ctx);
+    const spec = getOpenApiSpec4(ctx);
     if (!spec) {
       return this.fail(
         "No parseable OpenAPI JSON spec found.",
@@ -8148,11 +7677,11 @@ var OpenApiSchemasAudit = class _OpenApiSchemasAudit extends Audit {
       if (["post", "put", "patch"].includes(method)) {
         writeMethods++;
         const rb = op["requestBody"];
-        if (isObject6(rb)) {
+        if (isObject5(rb)) {
           const content = rb["content"];
-          if (isObject6(content)) {
+          if (isObject5(content)) {
             for (const mediaType of Object.values(content)) {
-              if (isObject6(mediaType) && mediaType["schema"]) {
+              if (isObject5(mediaType) && mediaType["schema"]) {
                 withRequestSchema++;
                 break;
               }
@@ -8161,13 +7690,13 @@ var OpenApiSchemasAudit = class _OpenApiSchemasAudit extends Audit {
         }
       }
       const responses = op["responses"];
-      if (isObject6(responses)) {
+      if (isObject5(responses)) {
         for (const resp of Object.values(responses)) {
-          if (isObject6(resp)) {
+          if (isObject5(resp)) {
             const content = resp["content"];
-            if (isObject6(content)) {
+            if (isObject5(content)) {
               for (const mediaType of Object.values(content)) {
-                if (isObject6(mediaType) && mediaType["schema"]) {
+                if (isObject5(mediaType) && mediaType["schema"]) {
                   withResponseSchema++;
                   break;
                 }
@@ -8244,14 +7773,14 @@ var OpenApiSchemasAudit = class _OpenApiSchemasAudit extends Audit {
 };
 
 // src/audits/agent-tools/ai-catalog-exists.ts
-function tryParseJson7(body) {
+function tryParseJson6(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject7(val) {
+function isObject6(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var AiCatalogExistsAudit = class _AiCatalogExistsAudit extends Audit {
@@ -8323,8 +7852,8 @@ var AiCatalogExistsAudit = class _AiCatalogExistsAudit extends Audit {
         }
       );
     }
-    const parsed = tryParseJson7(result.body);
-    if (!isObject7(parsed)) {
+    const parsed = tryParseJson6(result.body);
+    if (!isObject6(parsed)) {
       return this.fail(
         "ai-catalog.json is not valid JSON.",
         "/.well-known/ai-catalog.json returns 200 with valid JSON containing services array",
@@ -8403,14 +7932,14 @@ var AiCatalogExistsAudit = class _AiCatalogExistsAudit extends Audit {
 };
 
 // src/audits/agent-tools/ai-catalog-metadata.ts
-function tryParseJson8(body) {
+function tryParseJson7(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject8(val) {
+function isObject7(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var AiCatalogMetadataAudit = class _AiCatalogMetadataAudit extends Audit {
@@ -8463,8 +7992,8 @@ var AiCatalogMetadataAudit = class _AiCatalogMetadataAudit extends Audit {
         }
       );
     }
-    const parsed = tryParseJson8(result.body);
-    if (!isObject8(parsed)) {
+    const parsed = tryParseJson7(result.body);
+    if (!isObject7(parsed)) {
       return this.fail(
         "ai-catalog.json is not valid JSON.",
         "Has version, name, description, capabilities, owner, contact, lastUpdated",
@@ -8537,14 +8066,14 @@ var AiCatalogMetadataAudit = class _AiCatalogMetadataAudit extends Audit {
 };
 
 // src/audits/agent-tools/ai-catalog-urls.ts
-function tryParseJson9(body) {
+function tryParseJson8(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject9(val) {
+function isObject8(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var AiCatalogUrlsAudit = class _AiCatalogUrlsAudit extends Audit {
@@ -8593,8 +8122,8 @@ var AiCatalogUrlsAudit = class _AiCatalogUrlsAudit extends Audit {
         }
       );
     }
-    const parsed = tryParseJson9(result.body);
-    if (!isObject9(parsed) || !Array.isArray(parsed["services"])) {
+    const parsed = tryParseJson8(result.body);
+    if (!isObject8(parsed) || !Array.isArray(parsed["services"])) {
       return this.fail(
         "ai-catalog.json has no services array.",
         "Each service URL returns HTTP 200",
@@ -8616,7 +8145,7 @@ var AiCatalogUrlsAudit = class _AiCatalogUrlsAudit extends Audit {
     const services = parsed["services"];
     const urls = [];
     for (const svc of services) {
-      if (isObject9(svc) && typeof svc["url"] === "string" && svc["url"]) {
+      if (isObject8(svc) && typeof svc["url"] === "string" && svc["url"]) {
         urls.push(svc["url"]);
       }
     }
@@ -8688,14 +8217,14 @@ var AiCatalogUrlsAudit = class _AiCatalogUrlsAudit extends Audit {
 };
 
 // src/audits/agent-tools/agents-json.ts
-function tryParseJson10(body) {
+function tryParseJson9(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject10(val) {
+function isObject9(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var AgentsJsonAudit = class _AgentsJsonAudit extends Audit {
@@ -8763,8 +8292,8 @@ var AgentsJsonAudit = class _AgentsJsonAudit extends Audit {
         }
       );
     }
-    const parsed = tryParseJson10(result.body);
-    if (!isObject10(parsed) && !Array.isArray(parsed)) {
+    const parsed = tryParseJson9(result.body);
+    if (!isObject9(parsed) && !Array.isArray(parsed)) {
       return this.fail(
         "agents.json is not valid JSON.",
         "/.well-known/agents.json returns 200 with valid JSON",
@@ -8802,160 +8331,15 @@ var AgentsJsonAudit = class _AgentsJsonAudit extends Audit {
   }
 };
 
-// src/audits/agent-tools/ai-plugin-json.ts
-function tryParseJson11(body) {
-  try {
-    return JSON.parse(body);
-  } catch {
-    return void 0;
-  }
-}
-function isObject11(val) {
-  return typeof val === "object" && val !== null && !Array.isArray(val);
-}
-var AiPluginJsonAudit = class _AiPluginJsonAudit extends Audit {
-  static meta = {
-    id: "5.11",
-    category: "agent-tools",
-    title: "ai-plugin.json exists",
-    failureTitle: "ai-plugin.json exists",
-    description: "ai-plugin.json is the ChatGPT plugin manifest format. Even if you do not build a ChatGPT plugin, having this file helps AI agents understand your site as a tool with human-readable and model-readable names, logos, and API references.",
-    scoreDisplayMode: "ternary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "ai-plugin.json is the standard manifest used by ChatGPT and other AI platforms to register your site as a tool. Without it, your site cannot be installed as a plugin, and agents lose the human-readable and model-readable names needed for reliable interactions.",
-      fix: "Create a /.well-known/ai-plugin.json with at minimum schema_version, name_for_human, name_for_model, description_for_human, description_for_model, auth, and an api reference pointing to your OpenAPI spec.",
-      code: `// /.well-known/ai-plugin.json
-{
-  "schema_version": "v1",
-  "name_for_human": "Your Site Name",
-  "name_for_model": "your_site",
-  "description_for_human": "What your site does for users.",
-  "description_for_model": "Use this plugin to search content and submit inquiries.",
-  "auth": { "type": "none" },
-  "api": {
-    "type": "openapi",
-    "url": "https://yoursite.com/openapi.json"
-  },
-  "logo_url": "https://yoursite.com/logo.png",
-  "contact_email": "hello@yoursite.com"
-}`,
-      effort: "easy",
-      docsUrl: "https://platform.openai.com/docs/plugins/getting-started/plugin-manifest",
-      tags: ["ai-plugin", "chatgpt", "discovery", "agent-protocol"]
-    }
-  };
-  audit(ctx) {
-    const result = ctx.rootFiles["/.well-known/ai-plugin.json"];
-    if (!result || result.status !== 200 || !result.body) {
-      return this.fail(
-        "/.well-known/ai-plugin.json not found or not accessible.",
-        "/.well-known/ai-plugin.json returns 200 with valid JSON containing schema_version, name_for_human, name_for_model",
-        result ? `HTTP ${result.status}` : "Not fetched",
-        {
-          priority: "medium",
-          description: _AiPluginJsonAudit.meta.description,
-          code: `// /.well-known/ai-plugin.json
-{
-  "schema_version": "v1",
-  "name_for_human": "Your Site Name",
-  "name_for_model": "your_site",
-  "description_for_human": "What your site does for users.",
-  "description_for_model": "Use this plugin to search content, submit inquiries, and get product details from Your Site.",
-  "auth": { "type": "none" },
-  "api": {
-    "type": "openapi",
-    "url": "https://yoursite.com/openapi.json"
-  },
-  "logo_url": "https://yoursite.com/logo.png",
-  "contact_email": "hello@yoursite.com"
-}`
-        }
-      );
-    }
-    const parsed = tryParseJson11(result.body);
-    if (!isObject11(parsed)) {
-      return this.fail(
-        "ai-plugin.json is not valid JSON.",
-        "/.well-known/ai-plugin.json returns 200 with valid JSON containing schema_version, name_for_human, name_for_model",
-        "Invalid JSON",
-        {
-          priority: "medium",
-          description: _AiPluginJsonAudit.meta.description,
-          code: `// /.well-known/ai-plugin.json
-{
-  "schema_version": "v1",
-  "name_for_human": "Your Site Name",
-  "name_for_model": "your_site",
-  "description_for_human": "What your site does for users.",
-  "description_for_model": "Use this plugin to search content, submit inquiries, and get product details from Your Site.",
-  "auth": { "type": "none" },
-  "api": {
-    "type": "openapi",
-    "url": "https://yoursite.com/openapi.json"
-  },
-  "logo_url": "https://yoursite.com/logo.png",
-  "contact_email": "hello@yoursite.com"
-}`
-        }
-      );
-    }
-    const requiredFields = ["schema_version", "name_for_human", "name_for_model"];
-    const missing = requiredFields.filter((f) => typeof parsed[f] !== "string" || !parsed[f]);
-    if (missing.length === 0) {
-      return this.pass(
-        "ai-plugin.json found with all required fields.",
-        "/.well-known/ai-plugin.json returns 200 with valid JSON containing schema_version, name_for_human, name_for_model",
-        // requiredFields guarantees these three are non-empty strings here.
-        `schema_version=${parsed["schema_version"]}, name_for_human=${parsed["name_for_human"]}, name_for_model=${parsed["name_for_model"]}`
-      );
-    }
-    const recommendation = {
-      priority: "medium",
-      description: _AiPluginJsonAudit.meta.description,
-      code: `// /.well-known/ai-plugin.json
-{
-  "schema_version": "v1",
-  "name_for_human": "Your Site Name",
-  "name_for_model": "your_site",
-  "description_for_human": "What your site does for users.",
-  "description_for_model": "Use this plugin to search content, submit inquiries, and get product details from Your Site.",
-  "auth": { "type": "none" },
-  "api": {
-    "type": "openapi",
-    "url": "https://yoursite.com/openapi.json"
-  },
-  "logo_url": "https://yoursite.com/logo.png",
-  "contact_email": "hello@yoursite.com"
-}`
-    };
-    if (missing.length < requiredFields.length) {
-      return this.warn(
-        `ai-plugin.json is missing fields: ${missing.join(", ")}.`,
-        "/.well-known/ai-plugin.json returns 200 with valid JSON containing schema_version, name_for_human, name_for_model",
-        `Missing: ${missing.join(", ")}`,
-        recommendation
-      );
-    }
-    return this.fail(
-      `ai-plugin.json is missing all required fields: ${missing.join(", ")}.`,
-      "/.well-known/ai-plugin.json returns 200 with valid JSON containing schema_version, name_for_human, name_for_model",
-      `Missing: ${missing.join(", ")}`,
-      recommendation
-    );
-  }
-};
-
 // src/audits/agent-tools/mcp-discovery.ts
-function tryParseJson12(body) {
+function tryParseJson10(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject12(val) {
+function isObject10(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var McpDiscoveryAudit = class _McpDiscoveryAudit extends Audit {
@@ -8994,8 +8378,8 @@ var McpDiscoveryAudit = class _McpDiscoveryAudit extends Audit {
   audit(ctx) {
     const result = ctx.rootFiles["/.well-known/mcp/servers.json"];
     if (result && result.status === 200 && result.body) {
-      const parsed = tryParseJson12(result.body);
-      if (!isObject12(parsed)) {
+      const parsed = tryParseJson10(result.body);
+      if (!isObject10(parsed)) {
         return this.fail(
           "mcp/servers.json is not valid JSON.",
           "/.well-known/mcp/servers.json returns 200 with valid JSON containing servers array",
@@ -9028,8 +8412,8 @@ var McpDiscoveryAudit = class _McpDiscoveryAudit extends Audit {
     }
     const ucpResult = ctx.rootFiles["/.well-known/ucp"];
     if (ucpResult && ucpResult.status === 200 && ucpResult.body) {
-      const ucpParsed = tryParseJson12(ucpResult.body);
-      if (isObject12(ucpParsed)) {
+      const ucpParsed = tryParseJson10(ucpResult.body);
+      if (isObject10(ucpParsed)) {
         const ucpObj = ucpParsed["ucp"] ?? ucpParsed;
         const services = ucpParsed["services"] || ucpObj["services"];
         const capabilities = ucpParsed["capabilities"] || ucpObj["capabilities"];
@@ -9056,14 +8440,14 @@ var McpDiscoveryAudit = class _McpDiscoveryAudit extends Audit {
 };
 
 // src/audits/agent-tools/mcp-endpoint.ts
-function tryParseJson13(body) {
+function tryParseJson11(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject13(val) {
+function isObject11(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var McpEndpointAudit = class _McpEndpointAudit extends Audit {
@@ -9113,8 +8497,8 @@ Content-Type: application/json
     let targetEndpointUrl;
     const result = ctx.rootFiles["/.well-known/mcp/servers.json"];
     if (result && result.status === 200 && result.body) {
-      const parsed = tryParseJson13(result.body);
-      if (!isObject13(parsed) || !Array.isArray(parsed["servers"])) {
+      const parsed = tryParseJson11(result.body);
+      if (!isObject11(parsed) || !Array.isArray(parsed["servers"])) {
         return this.fail(
           "servers.json has no servers array.",
           "MCP server URL responds to JSON-RPC initialize request",
@@ -9127,8 +8511,8 @@ Content-Type: application/json
         );
       }
       const servers = parsed["servers"];
-      const serverUrl = servers.find((s) => isObject13(s) && typeof s["url"] === "string" && s["url"]);
-      if (!serverUrl || !isObject13(serverUrl)) {
+      const serverUrl = servers.find((s) => isObject11(s) && typeof s["url"] === "string" && s["url"]);
+      if (!serverUrl || !isObject11(serverUrl)) {
         return this.fail(
           "No server URL found in servers.json.",
           "MCP server URL responds to JSON-RPC initialize request",
@@ -9145,8 +8529,8 @@ Content-Type: application/json
     if (!targetEndpointUrl) {
       const ucpResult = ctx.rootFiles["/.well-known/ucp"];
       if (ucpResult && ucpResult.status === 200 && ucpResult.body) {
-        const ucpParsed = tryParseJson13(ucpResult.body);
-        if (isObject13(ucpParsed)) {
+        const ucpParsed = tryParseJson11(ucpResult.body);
+        if (isObject11(ucpParsed)) {
           const ucpObj = ucpParsed["ucp"] ?? ucpParsed;
           const services = ucpParsed["services"] || ucpObj["services"];
           if (services) {
@@ -9154,7 +8538,7 @@ Content-Type: application/json
               const svcList = services[key];
               if (Array.isArray(svcList)) {
                 for (const svc of svcList) {
-                  if (isObject13(svc) && svc["transport"] === "mcp" && typeof svc["endpoint"] === "string") {
+                  if (isObject11(svc) && svc["transport"] === "mcp" && typeof svc["endpoint"] === "string") {
                     targetEndpointUrl = svc["endpoint"];
                     break;
                   }
@@ -9197,8 +8581,8 @@ Content-Type: application/json
         contentType: "application/json"
       });
       if (response.status === 200) {
-        const respBody = tryParseJson13(response.body);
-        if (isObject13(respBody) && respBody["jsonrpc"] === "2.0" && !("error" in respBody) && isObject13(respBody["result"]) && typeof respBody["result"]["protocolVersion"] === "string") {
+        const respBody = tryParseJson11(response.body);
+        if (isObject11(respBody) && respBody["jsonrpc"] === "2.0" && !("error" in respBody) && isObject11(respBody["result"]) && typeof respBody["result"]["protocolVersion"] === "string") {
           return this.pass(
             `MCP endpoint at ${url} responded with valid JSON-RPC initialize result.`,
             "MCP server URL responds to JSON-RPC initialize request",
@@ -9314,14 +8698,14 @@ Content-Type: application/json
 };
 
 // src/audits/agent-tools/mcp-capabilities.ts
-function tryParseJson14(body) {
+function tryParseJson12(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject14(val) {
+function isObject12(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var McpCapabilitiesAudit = class _McpCapabilitiesAudit extends Audit {
@@ -9359,8 +8743,8 @@ var McpCapabilitiesAudit = class _McpCapabilitiesAudit extends Audit {
     const result = ctx.rootFiles["/.well-known/mcp/servers.json"];
     const ucpResult = ctx.rootFiles["/.well-known/ucp"];
     if (result && result.status === 200 && result.body) {
-      const parsed = tryParseJson14(result.body);
-      if (!isObject14(parsed) || !Array.isArray(parsed["servers"])) {
+      const parsed = tryParseJson12(result.body);
+      if (!isObject12(parsed) || !Array.isArray(parsed["servers"])) {
         return this.fail(
           "servers.json has no servers array.",
           "servers.json or MCP response declares tools, resources, or prompts",
@@ -9376,14 +8760,14 @@ var McpCapabilitiesAudit = class _McpCapabilitiesAudit extends Audit {
       const capabilityKeys = ["tools", "resources", "prompts"];
       const foundCapabilities = [];
       for (const server of servers) {
-        if (!isObject14(server)) continue;
+        if (!isObject12(server)) continue;
         for (const key of capabilityKeys) {
           if (server[key] !== void 0 && server[key] !== false) {
             foundCapabilities.push(key);
           }
         }
         const caps = server["capabilities"];
-        if (isObject14(caps)) {
+        if (isObject12(caps)) {
           for (const key of capabilityKeys) {
             if (caps[key] !== void 0 && caps[key] !== false && !foundCapabilities.includes(key)) {
               foundCapabilities.push(key);
@@ -9411,11 +8795,11 @@ var McpCapabilitiesAudit = class _McpCapabilitiesAudit extends Audit {
       );
     }
     if (ucpResult && ucpResult.status === 200 && ucpResult.body) {
-      const ucpParsed = tryParseJson14(ucpResult.body);
-      if (isObject14(ucpParsed)) {
+      const ucpParsed = tryParseJson12(ucpResult.body);
+      if (isObject12(ucpParsed)) {
         const ucpObj = ucpParsed["ucp"] ?? ucpParsed;
         const capabilities = ucpParsed["capabilities"] || ucpObj["capabilities"];
-        if (capabilities && isObject14(capabilities)) {
+        if (capabilities && isObject12(capabilities)) {
           const capNames = Object.keys(capabilities).map((cap) => cap.split(".").pop() || cap);
           if (capNames.length > 0) {
             const unique = [...new Set(capNames)];
@@ -9442,34 +8826,34 @@ var McpCapabilitiesAudit = class _McpCapabilitiesAudit extends Audit {
 };
 
 // src/audits/agent-tools/contact-form.ts
-function tryParseJson15(body) {
+function tryParseJson13(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject15(val) {
+function isObject13(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var HTTP_METHODS4 = ["get", "post", "put", "patch", "delete", "options", "head", "trace"];
-function getOpenApiSpec6(ctx) {
+function getOpenApiSpec5(ctx) {
   const jsonResult = ctx.rootFiles["/openapi.json"];
   if (jsonResult && jsonResult.status === 200 && jsonResult.body) {
-    const parsed = tryParseJson15(jsonResult.body);
-    if (isObject15(parsed)) return parsed;
+    const parsed = tryParseJson13(jsonResult.body);
+    if (isObject13(parsed)) return parsed;
   }
   return void 0;
 }
 function getOperations4(spec) {
   const paths = spec["paths"];
-  if (!isObject15(paths)) return [];
+  if (!isObject13(paths)) return [];
   const ops = [];
   for (const [path, pathItem] of Object.entries(paths)) {
-    if (!isObject15(pathItem)) continue;
+    if (!isObject13(pathItem)) continue;
     for (const method of HTTP_METHODS4) {
       const op = pathItem[method];
-      if (isObject15(op)) {
+      if (isObject13(op)) {
         ops.push({ path, method, op });
       }
     }
@@ -9538,7 +8922,7 @@ var ContactFormAudit = class _ContactFormAudit extends Audit {
         }
       }
     }
-    const spec = getOpenApiSpec6(ctx);
+    const spec = getOpenApiSpec5(ctx);
     if (spec) {
       const ops = getOperations4(spec);
       for (const { path, method } of ops) {
@@ -9585,34 +8969,34 @@ var ContactFormAudit = class _ContactFormAudit extends Audit {
 };
 
 // src/audits/agent-tools/search-endpoint.ts
-function tryParseJson16(body) {
+function tryParseJson14(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject16(val) {
+function isObject14(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var HTTP_METHODS5 = ["get", "post", "put", "patch", "delete", "options", "head", "trace"];
-function getOpenApiSpec7(ctx) {
+function getOpenApiSpec6(ctx) {
   const jsonResult = ctx.rootFiles["/openapi.json"];
   if (jsonResult && jsonResult.status === 200 && jsonResult.body) {
-    const parsed = tryParseJson16(jsonResult.body);
-    if (isObject16(parsed)) return parsed;
+    const parsed = tryParseJson14(jsonResult.body);
+    if (isObject14(parsed)) return parsed;
   }
   return void 0;
 }
 function getOperations5(spec) {
   const paths = spec["paths"];
-  if (!isObject16(paths)) return [];
+  if (!isObject14(paths)) return [];
   const ops = [];
   for (const [path, pathItem] of Object.entries(paths)) {
-    if (!isObject16(pathItem)) continue;
+    if (!isObject14(pathItem)) continue;
     for (const method of HTTP_METHODS5) {
       const op = pathItem[method];
-      if (isObject16(op)) {
+      if (isObject14(op)) {
         ops.push({ path, method, op });
       }
     }
@@ -9620,10 +9004,10 @@ function getOperations5(spec) {
   return ops;
 }
 function findSearchActionUrl(obj) {
-  if (!isObject16(obj)) return void 0;
-  if ((obj["@type"] === "SearchAction" || obj["@type"] === "WebSite") && isObject16(obj["potentialAction"])) {
+  if (!isObject14(obj)) return void 0;
+  if ((obj["@type"] === "SearchAction" || obj["@type"] === "WebSite") && isObject14(obj["potentialAction"])) {
     const action = obj["potentialAction"];
-    if (action["@type"] === "SearchAction" && isObject16(action["target"])) {
+    if (action["@type"] === "SearchAction" && isObject14(action["target"])) {
       const target = action["target"];
       if (typeof target["urlTemplate"] === "string") return target["urlTemplate"];
     }
@@ -9632,7 +9016,7 @@ function findSearchActionUrl(obj) {
     }
   }
   if (obj["@type"] === "SearchAction") {
-    if (isObject16(obj["target"])) {
+    if (isObject14(obj["target"])) {
       const target = obj["target"];
       if (typeof target["urlTemplate"] === "string") return target["urlTemplate"];
     }
@@ -9753,7 +9137,7 @@ var SearchEndpointAudit = class _SearchEndpointAudit extends Audit {
         }
       }
     }
-    const spec = getOpenApiSpec7(ctx);
+    const spec = getOpenApiSpec6(ctx);
     if (spec) {
       const ops = getOperations5(spec);
       for (const { path, method } of ops) {
@@ -9794,96 +9178,6 @@ var SearchEndpointAudit = class _SearchEndpointAudit extends Audit {
   }
 };
 
-// src/audits/agent-tools/data-action-ctas.ts
-var DataActionCtasAudit = class _DataActionCtasAudit extends Audit {
-  static meta = {
-    id: "5.17",
-    category: "agent-tools",
-    title: "data-action attributes on CTAs",
-    failureTitle: "data-action attributes on CTAs",
-    description: "data-action attributes help AI browser agents (like ChatGPT Browse and Google Mariner) identify clickable CTAs and understand what each button does. Without these hints, agents must guess which elements are interactive based on text alone.",
-    scoreDisplayMode: "ternary",
-    weight: 1,
-    defaultPriority: "low",
-    guidance: {
-      impact: 'Without data-action attributes, AI browser agents like ChatGPT Browse and Google Mariner must guess which elements are clickable and what they do. This leads to missed conversions when agents cannot reliably identify your "Book a Demo" or "Add to Cart" buttons.',
-      fix: 'Add data-action, data-action-type, and data-action-label attributes to your key CTA buttons and links. Use descriptive action names and categorize them (e.g., "conversion", "navigation").',
-      code: `<button data-action="book-demo" data-action-type="conversion"
-  data-action-label="Book a Demo">
-  Book a Demo
-</button>
-
-<a href="/pricing" data-action="view-pricing" data-action-type="navigation"
-  data-action-label="See Pricing">
-  See Pricing
-</a>`,
-      effort: "easy",
-      tags: ["html", "cta", "browser-agent", "accessibility"]
-    }
-  };
-  audit(ctx) {
-    let totalDataAction = 0;
-    let totalDataActionType = 0;
-    let foundPage = "";
-    for (const page of ctx.pages) {
-      const withDataAction = page.$("[data-action]");
-      const withDataActionType = page.$("[data-action-type]");
-      if (withDataAction.length > 0 || withDataActionType.length > 0) {
-        totalDataAction += withDataAction.length;
-        totalDataActionType += withDataActionType.length;
-        if (!foundPage) foundPage = page.url;
-      }
-    }
-    if (totalDataAction > 0 && totalDataActionType > 0) {
-      return this.pass(
-        `Found ${totalDataAction} element(s) with data-action and ${totalDataActionType} with data-action-type.`,
-        "Elements with data-action and data-action-type attributes",
-        `${totalDataAction} data-action, ${totalDataActionType} data-action-type`,
-        foundPage
-      );
-    }
-    if (totalDataAction > 0 || totalDataActionType > 0) {
-      return this.warn(
-        `Partial data-action markup: ${totalDataAction} data-action, ${totalDataActionType} data-action-type.`,
-        "Elements with data-action and data-action-type attributes",
-        `${totalDataAction} data-action, ${totalDataActionType} data-action-type`,
-        {
-          priority: "low",
-          description: _DataActionCtasAudit.meta.description,
-          code: `<button data-action="book-demo" data-action-type="conversion"
-  data-action-label="Book a Demo">
-  Book a Demo
-</button>
-
-<a href="/pricing" data-action="view-pricing" data-action-type="navigation"
-  data-action-label="See Pricing">
-  See Pricing
-</a>`
-        },
-        foundPage
-      );
-    }
-    return this.fail(
-      "No elements with data-action or data-action-type attributes found.",
-      "Elements with data-action and data-action-type attributes",
-      "None",
-      {
-        priority: "low",
-        description: _DataActionCtasAudit.meta.description,
-        code: `<button data-action="book-demo" data-action-type="conversion"
-  data-action-label="Book a Demo">
-  Book a Demo
-</button>
-
-<a href="/pricing" data-action="view-pricing" data-action-type="navigation"
-  data-action-label="See Pricing">
-  See Pricing
-</a>`
-      }
-    );
-  }
-};
-
 // src/audits/agent-tools/no-blocking-captcha.ts
 var CAPTCHA_PATTERNS = [
   "recaptcha",
@@ -10054,14 +9348,14 @@ var FormsNoJsAudit = class _FormsNoJsAudit extends Audit {
 };
 
 // src/audits/agent-tools/webmcp-manifest.ts
-function tryParseJson17(body) {
+function tryParseJson15(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject17(val) {
+function isObject15(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var WebmcpManifestAudit = class extends Audit {
@@ -10111,8 +9405,8 @@ var WebmcpManifestAudit = class extends Audit {
         "high"
       );
     }
-    const parsed = tryParseJson17(result.body);
-    if (!isObject17(parsed)) {
+    const parsed = tryParseJson15(result.body);
+    if (!isObject15(parsed)) {
       return this.fail(
         "/.well-known/webmcp is not valid JSON.",
         "Valid JSON object with tools array",
@@ -10130,7 +9424,7 @@ var WebmcpManifestAudit = class extends Audit {
     }
     const rawTools = parsed["tools"];
     const tools = rawTools.filter(
-      (t) => isObject17(t) && typeof t["name"] === "string"
+      (t) => isObject15(t) && typeof t["name"] === "string"
     );
     if (tools.length === 0) {
       return this.fail(
@@ -10347,13 +9641,13 @@ var WebmcpInputQualityAudit = class extends Audit {
 };
 
 // src/audits/agent-tools/webmcp-tool-naming.ts
-function isObject18(val) {
+function isObject16(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 function asString(val) {
   return typeof val === "string" ? val : "";
 }
-function tryParseJson18(body) {
+function tryParseJson16(body) {
   try {
     return JSON.parse(body);
   } catch {
@@ -10396,10 +9690,10 @@ var WebmcpToolNamingAudit = class extends Audit {
     const tools = [];
     const manifestResult = ctx.rootFiles["/.well-known/webmcp"];
     if (manifestResult?.status === 200 && manifestResult.body) {
-      const parsed = tryParseJson18(manifestResult.body);
-      if (isObject18(parsed) && Array.isArray(parsed["tools"])) {
+      const parsed = tryParseJson16(manifestResult.body);
+      if (isObject16(parsed) && Array.isArray(parsed["tools"])) {
         for (const tool of parsed["tools"]) {
-          if (isObject18(tool)) {
+          if (isObject16(tool)) {
             const name = asString(tool["name"]);
             tools.push({
               name,
@@ -10476,14 +9770,14 @@ var WebmcpToolNamingAudit = class extends Audit {
 };
 
 // src/audits/agent-tools/webmcp-tool-annotations.ts
-function tryParseJson19(body) {
+function tryParseJson17(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject19(val) {
+function isObject17(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 function asString2(val) {
@@ -10546,15 +9840,15 @@ var WebmcpToolAnnotationsAudit = class extends Audit {
     const seen = /* @__PURE__ */ new Set();
     const manifestResult = ctx.rootFiles["/.well-known/webmcp"];
     if (manifestResult?.status === 200 && manifestResult.body) {
-      const parsed = tryParseJson19(manifestResult.body);
-      if (isObject19(parsed) && Array.isArray(parsed["tools"])) {
+      const parsed = tryParseJson17(manifestResult.body);
+      if (isObject17(parsed) && Array.isArray(parsed["tools"])) {
         for (const tool of parsed["tools"]) {
-          if (!isObject19(tool)) continue;
+          if (!isObject17(tool)) continue;
           const name = asString2(tool["name"]);
           totalTools++;
           if (name) seen.add(name);
           const annotations = tool["annotations"];
-          if (isObject19(annotations)) {
+          if (isObject17(annotations)) {
             const found = SAFETY_ANNOTATIONS.filter((a) => a in annotations);
             if (found.length > 0) {
               toolsWithAnnotations++;
@@ -10616,203 +9910,24 @@ var WebmcpToolAnnotationsAudit = class extends Audit {
   }
 };
 
-// src/audits/agent-tools/webmcp-action-coverage.ts
-function tryParseJson20(body) {
-  try {
-    return JSON.parse(body);
-  } catch {
-    return void 0;
-  }
-}
-function isObject20(val) {
-  return typeof val === "object" && val !== null && !Array.isArray(val);
-}
-function asString3(val) {
-  return typeof val === "string" ? val : "";
-}
-var COMMERCE_ACTIONS = [
-  {
-    label: "Product Search",
-    keywords: ["search", "find", "query", "browse", "filter", "lookup", "catalog"]
-  },
-  {
-    label: "Product Detail",
-    keywords: ["product", "detail", "productdetail", "getproduct", "viewproduct", "viewitem"]
-  },
-  { label: "Add to Cart", keywords: ["cart", "addtocart", "basket", "additem"] },
-  {
-    label: "Checkout",
-    keywords: ["checkout", "purchase", "placeorder", "completepurchase", "buyproduct"]
-  },
-  {
-    label: "Account/Auth",
-    keywords: ["login", "register", "signup", "signin", "authenticate", "createaccount"]
-  },
-  {
-    label: "Contact/Support",
-    keywords: ["contact", "support", "inquiry", "submitinquiry", "sendmessage", "helpdesk"]
-  }
-];
-var MIN_COVERAGE = 2;
-var WebmcpActionCoverageAudit = class extends Audit {
-  static meta = {
-    id: "5.25",
-    category: "agent-tools",
-    title: "WebMCP commerce action coverage",
-    failureTitle: "WebMCP commerce action coverage",
-    description: "For e-commerce sites, WebMCP tools should cover key commerce actions: product search, product detail, add to cart, checkout, and contact/support. Broader action coverage means AI agents can complete more user tasks without falling back to manual browsing.",
-    scoreDisplayMode: "ternary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "AI shopping agents need to complete full purchase journeys \u2014 search, view, add to cart, checkout. If your WebMCP tools only cover search but not checkout, agents abandon the flow and users turn to competitors with full coverage.",
-      fix: "Expose WebMCP tools for the key commerce actions: product search, product detail/view, add to cart, checkout/purchase, and contact/support.",
-      code: `// /.well-known/webmcp \u2014 full commerce coverage
-{
-  "tools": [
-    {
-      "name": "searchProducts",
-      "description": "Search the product catalog by keyword, category, or filters",
-      "annotations": { "readOnlyHint": true },
-      "inputSchema": {
-        "type": "object",
-        "properties": {
-          "query": { "type": "string" },
-          "category": { "type": "string" },
-          "maxPrice": { "type": "number" }
-        },
-        "required": ["query"]
-      }
-    },
-    {
-      "name": "getProductDetails",
-      "description": "Get full details for a specific product by ID or URL",
-      "annotations": { "readOnlyHint": true },
-      "inputSchema": {
-        "type": "object",
-        "properties": { "productId": { "type": "string" } },
-        "required": ["productId"]
-      }
-    },
-    {
-      "name": "addToCart",
-      "description": "Add a product to the shopping cart with quantity",
-      "annotations": { "readOnlyHint": false, "idempotentHint": false },
-      "inputSchema": {
-        "type": "object",
-        "properties": {
-          "productId": { "type": "string" },
-          "quantity": { "type": "integer", "minimum": 1 }
-        },
-        "required": ["productId"]
-      }
-    },
-    {
-      "name": "checkout",
-      "description": "Initiate checkout for the current cart",
-      "annotations": { "readOnlyHint": false, "confirmationRequired": true },
-      "inputSchema": {
-        "type": "object",
-        "properties": { "shippingMethod": { "type": "string" } }
-      }
-    }
-  ]
-}`,
-      effort: "moderate",
-      docsUrl: "https://webmcp.link/",
-      tags: ["webmcp", "commerce", "coverage", "chrome-146"]
-    }
-  };
-  audit(ctx) {
-    const toolSignatures = [];
-    const seen = /* @__PURE__ */ new Set();
-    const manifestResult = ctx.rootFiles["/.well-known/webmcp"];
-    if (manifestResult?.status === 200 && manifestResult.body) {
-      const parsed = tryParseJson20(manifestResult.body);
-      if (isObject20(parsed) && Array.isArray(parsed["tools"])) {
-        for (const tool of parsed["tools"]) {
-          if (isObject20(tool)) {
-            const name = asString3(tool["name"]);
-            const sig = `${name} ${asString3(tool["description"])}`.toLowerCase();
-            toolSignatures.push(sig);
-            if (name) seen.add(name);
-          }
-        }
-      }
-    }
-    for (const page of ctx.pages) {
-      page.$("form[toolname]").each((_, el) => {
-        const name = page.$(el).attr("toolname") || "";
-        if (name && seen.has(name)) return;
-        const desc = page.$(el).attr("tooldescription") || "";
-        const action = page.$(el).attr("action") || "";
-        toolSignatures.push(`${name} ${desc} ${action}`.toLowerCase());
-        if (name) seen.add(name);
-      });
-    }
-    if (toolSignatures.length === 0) {
-      return this.notApplicable(
-        "No WebMCP tools found \u2014 commerce action coverage cannot be assessed.",
-        `At least ${MIN_COVERAGE} commerce actions covered (search, product, cart, checkout, contact)`,
-        "No WebMCP tools"
-      );
-    }
-    const coveredActions = [];
-    const missingActions = [];
-    for (const action of COMMERCE_ACTIONS) {
-      const matched = toolSignatures.some(
-        (sig) => action.keywords.some((kw) => new RegExp(`\\b${kw}\\b`).test(sig))
-      );
-      if (matched) {
-        coveredActions.push(action.label);
-      } else {
-        missingActions.push(action.label);
-      }
-    }
-    const coverage = coveredActions.length;
-    const total = COMMERCE_ACTIONS.length;
-    if (coverage >= 4) {
-      return this.pass(
-        `${coverage}/${total} commerce actions covered: ${coveredActions.join(", ")}.`,
-        `At least ${MIN_COVERAGE} commerce actions covered`,
-        `${coverage}/${total} covered`
-      );
-    }
-    if (coverage >= MIN_COVERAGE) {
-      return this.warn(
-        `${coverage}/${total} commerce actions covered: ${coveredActions.join(", ")}. Missing: ${missingActions.join(", ")}.`,
-        `At least 4 commerce actions covered for strong agent support`,
-        `${coverage}/${total} covered`,
-        "medium"
-      );
-    }
-    return this.fail(
-      `Only ${coverage}/${total} commerce actions covered: ${coveredActions.length > 0 ? coveredActions.join(", ") : "none"}. Missing: ${missingActions.join(", ")}.`,
-      `At least ${MIN_COVERAGE} commerce actions covered`,
-      `${coverage}/${total} covered`,
-      "medium"
-    );
-  }
-};
-
 // src/audits/agent-tools/openapi-description-quality.ts
-function tryParseJson21(body) {
+function tryParseJson18(body) {
   try {
     return JSON.parse(body);
   } catch {
     return void 0;
   }
 }
-function isObject21(val) {
+function isObject18(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
 var HTTP_METHODS6 = ["get", "post", "put", "patch", "delete", "options", "head", "trace"];
 var MIN_DESCRIPTION_LENGTH2 = 15;
-function getOpenApiSpec8(ctx) {
+function getOpenApiSpec7(ctx) {
   const jsonResult = ctx.rootFiles["/openapi.json"];
   if (jsonResult && jsonResult.status === 200 && jsonResult.body) {
-    const parsed = tryParseJson21(jsonResult.body);
-    if (isObject21(parsed)) return parsed;
+    const parsed = tryParseJson18(jsonResult.body);
+    if (isObject18(parsed)) return parsed;
   }
   return void 0;
 }
@@ -10821,13 +9936,13 @@ function hasGoodDescription(val) {
 }
 function getCheckableItems(spec) {
   const paths = spec["paths"];
-  if (!isObject21(paths)) return [];
+  if (!isObject18(paths)) return [];
   const items = [];
   for (const [path, pathItem] of Object.entries(paths)) {
-    if (!isObject21(pathItem)) continue;
+    if (!isObject18(pathItem)) continue;
     for (const method of HTTP_METHODS6) {
       const op = pathItem[method];
-      if (!isObject21(op)) continue;
+      if (!isObject18(op)) continue;
       const operation = op;
       const opLabel = `${method.toUpperCase()} ${path}`;
       items.push({
@@ -10837,7 +9952,7 @@ function getCheckableItems(spec) {
       const parameters = operation["parameters"];
       if (Array.isArray(parameters)) {
         for (const param of parameters) {
-          if (!isObject21(param)) continue;
+          if (!isObject18(param)) continue;
           const name = typeof param["name"] === "string" ? param["name"] : "(unnamed)";
           items.push({
             label: `${opLabel} param '${name}'`,
@@ -10881,7 +9996,7 @@ var OpenApiDescriptionQualityAudit = class _OpenApiDescriptionQualityAudit exten
     }
   };
   audit(ctx) {
-    const spec = getOpenApiSpec8(ctx);
+    const spec = getOpenApiSpec7(ctx);
     if (!spec) {
       return this.notApplicable(
         "No parseable OpenAPI JSON spec found at /openapi.json.",
@@ -11858,53 +10973,6 @@ var TimeElementAudit = class extends Audit {
   }
 };
 
-// src/audits/semantic-html/address-element.ts
-var AddressElementAudit = class extends Audit {
-  static meta = {
-    id: "6.12",
-    category: "semantic-html",
-    title: "<address> for contact info",
-    failureTitle: "<address> for contact info",
-    description: 'AI agents use <address> elements to extract contact information (email, phone, physical address) for structured answers to "how to contact" queries. Without semantic <address> markup, agents must guess which text on your page is contact info.',
-    scoreDisplayMode: "binary",
-    weight: 1,
-    applicablePageTypes: ["homepage"],
-    defaultPriority: "low",
-    guidance: {
-      impact: 'AI agents cannot reliably extract contact information (email, phone, physical address) when it is not wrapped in an <address> element. This means your business contact details may be omitted from AI-generated answers to "how do I contact" queries.',
-      fix: "Wrap all contact information blocks (email addresses, phone numbers, physical addresses) in an <address> element. Place it in the <footer> or near the relevant content section.",
-      code: '<address>\n  <a href="mailto:info@yoursite.com">info@yoursite.com</a><br>\n  <a href="tel:+1234567890">+1 (234) 567-890</a><br>\n  123 Main St, City, ST 12345\n</address>',
-      effort: "trivial",
-      docsUrl: "https://developer.mozilla.org/en-US/docs/Web/HTML/Element/address",
-      tags: ["contact", "semantic", "html"]
-    }
-  };
-  audit(ctx) {
-    let pagesWithAddress = 0;
-    for (const page of ctx.pages) {
-      if (page.$("address").length > 0) pagesWithAddress++;
-    }
-    const hasAddress = pagesWithAddress > 0;
-    if (hasAddress) {
-      return this.pass(
-        `${pagesWithAddress}/${ctx.pages.length} page(s) use <address> for contact information.`,
-        "<address> element used for contact information",
-        `${pagesWithAddress} page(s) with <address>`
-      );
-    }
-    return this.warn(
-      "No <address> elements found. If contact information exists, consider using <address>.",
-      "<address> element used for contact information",
-      "No <address> elements found",
-      {
-        priority: "low",
-        description: 'AI agents use <address> elements to extract contact information (email, phone, physical address) for structured answers to "how to contact" queries. Without semantic <address> markup, agents must guess which text on your page is contact info.',
-        code: '<address>\n  <a href="mailto:info@yoursite.com">info@yoursite.com</a><br>\n  123 Main St, City, ST 12345\n</address>'
-      }
-    );
-  }
-};
-
 // src/audits/semantic-html/definition-elements.ts
 var DefinitionElementsAudit = class extends Audit {
   static meta = {
@@ -12095,81 +11163,6 @@ var ImageAltTextAudit = class extends Audit {
   }
 };
 
-// src/audits/semantic-html/decorative-images.ts
-var DecorativeImagesAudit = class extends Audit {
-  static meta = {
-    id: "6.16",
-    category: "semantic-html",
-    title: "Decorative images marked correctly",
-    failureTitle: "Decorative images marked correctly",
-    description: 'AI agents processing the accessibility tree treat images with empty alt but no role="presentation" as potentially missing alt text rather than intentionally decorative. Adding role="presentation" explicitly tells agents to skip these images, preventing them from flagging false content gaps.',
-    scoreDisplayMode: "ternary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: 'AI agents processing the accessibility tree treat images with empty alt but no role="presentation" as potentially missing alt text rather than intentionally decorative. This creates false-positive content gaps and wastes agent processing on irrelevant images.',
-      fix: 'Add role="presentation" (or role="none") to all decorative images that already have an empty alt attribute. This explicitly tells AI agents and assistive technologies to skip these images entirely.',
-      code: '<img src="decorative-border.png" alt="" role="presentation">',
-      effort: "trivial",
-      docsUrl: "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/presentation_role",
-      tags: ["images", "decorative", "accessibility", "semantic"]
-    }
-  };
-  audit(ctx) {
-    let decorativeCount = 0;
-    let correctlyMarked = 0;
-    for (const page of ctx.pages) {
-      const images = extractImages(page.$);
-      for (const img of images) {
-        if (img.alt === "") {
-          decorativeCount++;
-          if (img.role === "presentation" || img.role === "none" || img.ariaHidden === "true") {
-            correctlyMarked++;
-          }
-        }
-      }
-    }
-    if (decorativeCount === 0) {
-      return this.pass(
-        "No decorative images (empty alt) found \u2014 check not applicable.",
-        'Images with empty alt have role="presentation"',
-        "No images with empty alt"
-      );
-    }
-    const allCorrect = correctlyMarked === decorativeCount;
-    const majorityCorrect = correctlyMarked > decorativeCount / 2;
-    if (allCorrect) {
-      return this.pass(
-        `All ${decorativeCount} decorative image(s) have role="presentation".`,
-        'Images with empty alt have role="presentation"',
-        `${correctlyMarked}/${decorativeCount} correctly marked`
-      );
-    }
-    if (majorityCorrect) {
-      return this.warn(
-        `${correctlyMarked}/${decorativeCount} decorative image(s) have role="presentation".`,
-        'Images with empty alt have role="presentation"',
-        `${correctlyMarked}/${decorativeCount} correctly marked`,
-        {
-          priority: "medium",
-          description: 'AI agents processing the accessibility tree treat images with empty alt but no role="presentation" as potentially missing alt text rather than intentionally decorative. Adding role="presentation" explicitly tells agents to skip these images, preventing them from flagging false content gaps.',
-          code: '<img src="decorative-bg.png" alt="" role="presentation">'
-        }
-      );
-    }
-    return this.fail(
-      `${correctlyMarked}/${decorativeCount} decorative image(s) have role="presentation".`,
-      'Images with empty alt have role="presentation"',
-      `${correctlyMarked}/${decorativeCount} correctly marked`,
-      {
-        priority: "medium",
-        description: 'AI agents processing the accessibility tree treat images with empty alt but no role="presentation" as potentially missing alt text rather than intentionally decorative. Adding role="presentation" explicitly tells agents to skip these images, preventing them from flagging false content gaps.',
-        code: '<img src="decorative-bg.png" alt="" role="presentation">'
-      }
-    );
-  }
-};
-
 // src/audits/semantic-html/figure-figcaption.ts
 var FigureFigcaptionAudit = class extends Audit {
   static meta = {
@@ -12524,85 +11517,24 @@ var FakeHeadingsAudit = class extends Audit {
         "No styled <div>/<span>/<p>/<b> elements impersonating headings"
       );
     }
-    const recommendation = {
-      priority: "medium",
-      description: "AI agents chunk and outline page content by reading real <h1>\u2013<h6> tags. Elements styled to look like headings are invisible to that outline, so sections cannot be navigated, summarized, or cited correctly. Replace styled generic elements with the appropriate heading level.",
-      code: '<!-- Before -->\n<div class="text-2xl font-bold">Pricing Plans</div>\n\n<!-- After -->\n<h2 class="text-2xl font-bold">Pricing Plans</h2>'
-    };
-    if (found.length >= 5) {
-      return this.fail(
-        `Found ${found.length} fake heading(s) \u2014 generic elements styled to look like headings instead of <h1>-<h6> tags.`,
-        expected,
-        foundSummary,
-        recommendation
-      );
-    }
-    return this.warn(
-      `Found ${found.length} fake heading(s) \u2014 generic elements styled to look like headings instead of <h1>-<h6> tags.`,
-      expected,
-      foundSummary,
-      recommendation
-    );
-  }
-};
-
-// src/audits/accessibility/skip-nav.ts
-var SkipNavAudit = class extends Audit {
-  static meta = {
-    id: "7.1",
-    category: "accessibility",
-    title: "Skip navigation link",
-    failureTitle: "Skip navigation link",
-    description: "Headless browser agents (Claude computer use, GPTBot with browser) parse the accessibility tree to navigate pages efficiently. A skip navigation link lets these agents jump directly to primary content without processing every nav element, reducing latency and improving content extraction accuracy.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "Headless browser agents (Claude computer use, GPTBot) parse the accessibility tree to navigate pages. A skip navigation link lets agents jump directly to primary content without processing every nav element, reducing latency and improving content extraction accuracy.",
-      fix: 'Add a "Skip to main content" link as the first focusable element in <body>, pointing to an anchor on your <main> element.',
-      code: '<a href="#main-content" class="skip-link">Skip to main content</a>\n<!-- ... navigation ... -->\n<main id="main-content">...</main>',
-      effort: "trivial",
-      docsUrl: "https://www.w3.org/WAI/WCAG21/Techniques/general/G1",
-      tags: ["a11y", "navigation", "accessibility"]
-    }
-  };
-  audit(ctx) {
-    if (!ctx.pages || ctx.pages.length === 0) {
-      return this.warn(
-        "No pages scanned to check for skip navigation link.",
-        "A skip-to-content link among the first links in <body>",
-        "No pages scanned"
-      );
-    }
-    for (const page of ctx.pages) {
-      const $ = page.$;
-      const bodyLinks = $("body a").slice(0, 5);
-      let found = false;
-      bodyLinks.each((_, el) => {
-        const text = $(el).text().toLowerCase().trim();
-        const href = ($(el).attr("href") ?? "").toLowerCase();
-        if ((text.includes("skip") || text.includes("jump to") || text.includes("go to main")) && (href.includes("#main") || href.includes("#content") || href.includes("#skip"))) {
-          found = true;
-        }
-      });
-      if (found) {
-        return this.pass(
-          "Skip navigation link found among the first links in <body>.",
-          "A skip-to-content link among the first links in <body>",
-          "Skip navigation link detected",
-          page.url
-        );
-      }
+    const recommendation = {
+      priority: "medium",
+      description: "AI agents chunk and outline page content by reading real <h1>\u2013<h6> tags. Elements styled to look like headings are invisible to that outline, so sections cannot be navigated, summarized, or cited correctly. Replace styled generic elements with the appropriate heading level.",
+      code: '<!-- Before -->\n<div class="text-2xl font-bold">Pricing Plans</div>\n\n<!-- After -->\n<h2 class="text-2xl font-bold">Pricing Plans</h2>'
+    };
+    if (found.length >= 5) {
+      return this.fail(
+        `Found ${found.length} fake heading(s) \u2014 generic elements styled to look like headings instead of <h1>-<h6> tags.`,
+        expected,
+        foundSummary,
+        recommendation
+      );
     }
-    return this.fail(
-      "No skip navigation link found. Screen reader and keyboard users rely on skip links to bypass repeated navigation.",
-      "A skip-to-content link among the first links in <body>",
-      "No skip navigation link detected in the first few <body> links",
-      {
-        priority: "medium",
-        description: "Headless browser agents (Claude computer use, GPTBot with browser) parse the accessibility tree to navigate pages efficiently. A skip navigation link lets these agents jump directly to primary content without processing every nav element, reducing latency and improving content extraction accuracy.",
-        code: '<a href="#main-content" class="skip-link">Skip to main content</a>\n<!-- Then on your main content: -->\n<main id="main-content">...</main>'
-      }
+    return this.warn(
+      `Found ${found.length} fake heading(s) \u2014 generic elements styled to look like headings instead of <h1>-<h6> tags.`,
+      expected,
+      foundSummary,
+      recommendation
     );
   }
 };
@@ -13473,98 +12405,6 @@ var ContentTypeOptionsAudit = class extends Audit {
   }
 };
 
-// src/audits/technical-readiness/referrer-policy.ts
-var ReferrerPolicyAudit = class extends Audit {
-  static meta = {
-    id: "8.5",
-    category: "technical-readiness",
-    title: "Referrer-Policy header",
-    failureTitle: "Referrer-Policy header",
-    description: "AI trust-scoring systems check for Referrer-Policy as a privacy maturity signal. Without it, your site leaks full URL paths in referrer headers to third parties, which AI security audits flag as a privacy concern that can reduce trust scores.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "Without a Referrer-Policy header, your site leaks full URL paths (including query parameters) in HTTP Referer headers when users navigate to external links. AI security audits flag this as a privacy vulnerability, and trust-scoring systems lower your site's rating. Sensitive URL parameters like session tokens or search queries may be exposed to third parties.",
-      fix: 'Add a Referrer-Policy header to your server responses. The recommended value is "strict-origin-when-cross-origin", which sends the full URL for same-origin requests but only the origin for cross-origin requests.',
-      code: "Referrer-Policy: strict-origin-when-cross-origin",
-      effort: "trivial",
-      docsUrl: "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy",
-      tags: ["security", "headers", "privacy"]
-    }
-  };
-  audit(ctx) {
-    const page = ctx.pages?.[0];
-    const headers = page?.fetchResult.headers ?? {};
-    const value = headers["referrer-policy"];
-    if (value) {
-      return this.pass(
-        `Referrer-Policy header is present: ${value}`,
-        "Referrer-Policy header present on homepage response",
-        `referrer-policy: ${value}`,
-        page?.url
-      );
-    }
-    return this.fail(
-      "Referrer-Policy header is missing from the homepage response.",
-      "Referrer-Policy header present on homepage response",
-      "Header not found",
-      {
-        priority: "medium",
-        description: "AI trust-scoring systems check for Referrer-Policy as a privacy maturity signal. Without it, your site leaks full URL paths in referrer headers to third parties, which AI security audits flag as a privacy concern that can reduce trust scores.",
-        code: "Referrer-Policy: strict-origin-when-cross-origin"
-      },
-      page?.url
-    );
-  }
-};
-
-// src/audits/technical-readiness/permissions-policy.ts
-var PermissionsPolicyAudit = class extends Audit {
-  static meta = {
-    id: "8.6",
-    category: "technical-readiness",
-    title: "Permissions-Policy header",
-    failureTitle: "Permissions-Policy header",
-    description: "AI browser agents that visit your site may trigger permission prompts for camera, microphone, or geolocation if Permissions-Policy is not set. These prompts block agent workflows and are flagged as security concerns by AI trust-scoring systems.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "medium",
-    guidance: {
-      impact: "Without a Permissions-Policy header, AI browser agents visiting your site may trigger unexpected permission prompts for camera, microphone, or geolocation. These prompts block automated agent workflows entirely and are flagged by AI trust-scoring systems as a security concern, reducing your site's trust score.",
-      fix: "Add a Permissions-Policy header that disables sensitive browser features your site does not use. Deny camera, microphone, and geolocation unless your site explicitly requires them.",
-      code: "Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=()",
-      effort: "trivial",
-      docsUrl: "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Permissions-Policy",
-      tags: ["security", "headers", "privacy"]
-    }
-  };
-  audit(ctx) {
-    const page = ctx.pages?.[0];
-    const headers = page?.fetchResult.headers ?? {};
-    const value = headers["permissions-policy"];
-    if (value) {
-      return this.pass(
-        `Permissions-Policy header is present: ${value.length > 120 ? value.slice(0, 120) + "..." : value}`,
-        "Permissions-Policy header present on homepage response",
-        `permissions-policy: ${value.length > 120 ? value.slice(0, 120) + "..." : value}`,
-        page?.url
-      );
-    }
-    return this.fail(
-      "Permissions-Policy header is missing from the homepage response.",
-      "Permissions-Policy header present on homepage response",
-      "Header not found",
-      {
-        priority: "medium",
-        description: "AI browser agents that visit your site may trigger permission prompts for camera, microphone, or geolocation if Permissions-Policy is not set. These prompts block agent workflows and are flagged as security concerns by AI trust-scoring systems.",
-        code: "Permissions-Policy: camera=(), microphone=(), geolocation=()"
-      },
-      page?.url
-    );
-  }
-};
-
 // src/audits/technical-readiness/security-txt.ts
 var SecurityTxtAudit = class extends Audit {
   static meta = {
@@ -14304,66 +13144,6 @@ var LcpNotLazyAudit = class extends Audit {
   }
 };
 
-// src/audits/technical-readiness/preconnect-hints.ts
-var PreconnectHintsAudit = class extends Audit {
-  static meta = {
-    id: "8.17",
-    category: "technical-readiness",
-    title: "Preconnect hints",
-    failureTitle: "Preconnect hints",
-    description: "Preconnect hints reduce the time AI crawlers spend establishing connections to third-party resources. Faster page loads mean AI agents can crawl more of your pages within their time budget, improving overall content coverage in AI knowledge bases.",
-    scoreDisplayMode: "binary",
-    weight: 1,
-    defaultPriority: "low",
-    guidance: {
-      impact: "Without preconnect hints, each third-party resource requires a full DNS lookup, TCP handshake, and TLS negotiation before loading can begin. This adds hundreds of milliseconds per origin, slowing overall page load and reducing the number of pages AI crawlers can process within their time budget.",
-      fix: 'Add <link rel="preconnect"> tags in <head> for your most critical third-party origins (CDNs, font providers, analytics). Limit to 2-4 origins to avoid diminishing returns.',
-      code: '<link rel="preconnect" href="https://fonts.googleapis.com">\n<link rel="preconnect" href="https://cdn.yoursite.com" crossorigin>',
-      effort: "trivial",
-      docsUrl: "https://web.dev/articles/uses-rel-preconnect",
-      tags: ["performance", "speed", "resource-hints"]
-    }
-  };
-  audit(ctx) {
-    const page = ctx.pages?.[0];
-    if (!page) {
-      return this.warn(
-        "No homepage data available to check preconnect hints.",
-        'At least one <link rel="preconnect"> tag present',
-        "No homepage fetched",
-        void 0,
-        void 0
-      );
-    }
-    const $ = page.$;
-    const preconnects = $('link[rel="preconnect"]');
-    if (preconnects.length > 0) {
-      const hrefs = [];
-      preconnects.each((_, el) => {
-        const href = $(el).attr("href");
-        if (href) hrefs.push(href);
-      });
-      return this.pass(
-        `Found ${preconnects.length} preconnect hint(s): ${hrefs.slice(0, 5).join(", ")}`,
-        'At least one <link rel="preconnect"> tag present',
-        `${preconnects.length} preconnect hint(s)`,
-        page.url
-      );
-    }
-    return this.fail(
-      'No <link rel="preconnect"> hints found. Preconnect hints speed up connections to critical third-party origins.',
-      'At least one <link rel="preconnect"> tag present',
-      "No preconnect hints found",
-      {
-        priority: "low",
-        description: "Preconnect hints reduce the time AI crawlers spend establishing connections to third-party resources. Faster page loads mean AI agents can crawl more of your pages within their time budget, improving overall content coverage in AI knowledge bases.",
-        code: '<link rel="preconnect" href="https://fonts.googleapis.com">\n<link rel="preconnect" href="https://cdn.yoursite.com">'
-      },
-      page.url
-    );
-  }
-};
-
 // src/audits/technical-readiness/no-broken-ai-endpoints.ts
 var NoBrokenAiEndpointsAudit = class extends Audit {
   static meta = {
@@ -14677,71 +13457,6 @@ var TermsOfServiceAudit = class extends Audit {
   }
 };
 
-// src/audits/technical-readiness/framework-detection.ts
-var FrameworkDetectionAudit = class extends Audit {
-  static meta = {
-    id: "8.21",
-    category: "technical-readiness",
-    title: "Frontend framework detection",
-    failureTitle: "Frontend framework detection",
-    description: "AI agents can optimize their interaction strategy if they know the underlying technology stack (e.g., React, Next.js, Vue). This also helps identify potential client-side rendering issues.",
-    scoreDisplayMode: "informative",
-    weight: 1,
-    defaultPriority: "low",
-    guidance: {
-      impact: "This is an informational audit. Knowing your frontend framework helps identify potential rendering issues \u2014 for example, pure client-side React apps are invisible to AI crawlers that do not execute JavaScript. Framework detection also helps prioritize other audit recommendations.",
-      fix: "No action required. This audit detects your framework automatically. If your framework relies on client-side rendering (e.g., Create React App, Vue SPA), consider switching to a server-rendering mode (Next.js, Nuxt, or SvelteKit) so AI crawlers can read your content.",
-      effort: "trivial",
-      tags: ["informational", "framework"]
-    }
-  };
-  audit(ctx) {
-    const page = ctx.pages[0];
-    if (!page) {
-      return this.fail("No pages available for analysis.", "", "None");
-    }
-    const { meta, $ } = page;
-    const frameworks = [];
-    if (meta["generator"]) {
-      frameworks.push(`Generator: ${meta["generator"]}`);
-    }
-    if (meta["next-head-count"] || $('script[id="__NEXT_DATA__"]').length > 0) {
-      frameworks.push("Next.js");
-    }
-    if ($('script[src*="nuxt"]').length > 0 || globalThis.window?.__NUXT__) {
-      frameworks.push("Nuxt.js");
-    }
-    if ($("[data-reactroot], [data-reactid]").length > 0 || $('script[src*="react"]').length > 0) {
-      frameworks.push("React");
-    }
-    if ($("[data-v-field], [data-v-]").length > 0 || $('script[src*="vue"]').length > 0) {
-      frameworks.push("Vue.js");
-    }
-    if ($("app-root, [ng-version]").length > 0) {
-      frameworks.push("Angular");
-    }
-    if ($('script[src*="astro"]').length > 0 || $("style[data-astro-cid]").length > 0) {
-      frameworks.push("Astro");
-    }
-    if ($('script[src*="svelte"]').length > 0) {
-      frameworks.push("Svelte");
-    }
-    if (frameworks.length > 0) {
-      const unique = Array.from(new Set(frameworks));
-      return this.pass(
-        `Detected frameworks: ${unique.join(", ")}.`,
-        "Identify the frontend framework used by the site.",
-        unique.join(", ")
-      );
-    }
-    return this.pass(
-      "No specific frontend framework clearly detected.",
-      "Identify the frontend framework used by the site.",
-      "Generic/Unknown"
-    );
-  }
-};
-
 // src/audits/answer-engine/faq-sections.ts
 var FAQ_TEXT = /frequently\s+asked\s+questions|\bFAQ['']?s?\b|common\s+questions|questions?\s*(?:&|and)\s*answers|\bQ\s*&\s*A\b/i;
 function hasFaqJsonLd(p) {
@@ -15706,7 +14421,7 @@ var MetaDescriptionAeoAudit = class _MetaDescriptionAeoAudit extends Audit {
 };
 
 // src/audits/generative-engine/named-author.ts
-function asString4(val) {
+function asString3(val) {
   return typeof val === "string" ? val : "";
 }
 function findJsonLdByType(jsonLd, types) {
@@ -15793,7 +14508,7 @@ var NamedAuthorAudit = class extends Audit {
         if (!author) continue;
         const authors = Array.isArray(author) ? author : [author];
         for (const a of authors) {
-          const name = typeof a === "string" ? a : typeof a === "object" && a !== null ? asString4(a["name"]) : "";
+          const name = typeof a === "string" ? a : typeof a === "object" && a !== null ? asString3(a["name"]) : "";
           const lower = name.trim().toLowerCase();
           if (lower && !GENERIC_AUTHOR_NAMES.has(lower)) {
             return this.pass(
@@ -16732,7 +15447,7 @@ var PublicationDateAudit = class extends Audit {
 };
 
 // src/audits/generative-engine/last-modified-schema.ts
-function asString5(val) {
+function asString4(val) {
   return typeof val === "string" ? val : "";
 }
 function findJsonLdByType5(jsonLd, types) {
@@ -16818,7 +15533,7 @@ var LastModifiedSchemaAudit = class extends Audit {
           return this.warn(
             datePublished ? `dateModified equals datePublished ("${dateModified}"). Update dateModified when content changes.` : `dateModified is set ("${dateModified}") but no datePublished for comparison.`,
             "JSON-LD dateModified present and different from datePublished",
-            `dateModified: ${dateModified}${datePublished ? `, datePublished: ${asString5(datePublished)}` : ""}`,
+            `dateModified: ${dateModified}${datePublished ? `, datePublished: ${asString4(datePublished)}` : ""}`,
             {
               priority: "low",
               description: "AI engines compare dateModified to datePublished to detect actively maintained content. When they match, agents treat the content as never-updated since publication. Update dateModified each time you revise content to signal freshness."
@@ -16928,69 +15643,6 @@ var InternalCrossLinkingAudit = class extends Audit {
   }
 };
 
-// src/audits/generative-engine/pagination-links.ts
-var PaginationLinksAudit = class extends Audit {
-  static meta = {
-    id: "10.12",
-    category: "generative-engine",
-    title: "Pagination links",
-    failureTitle: "Pagination links",
-    description: 'AI crawlers use rel="prev" and rel="next" to navigate paginated content series without missing pages.',
-    scoreDisplayMode: "ternary",
-    weight: 1,
-    applicablePageTypes: ["category"],
-    defaultPriority: "low",
-    guidance: {
-      impact: 'AI crawlers use rel="prev" and rel="next" to navigate paginated content series sequentially. Without these links, agents may miss pages in a series or index paginated listings out of order, leading to incomplete content coverage in AI knowledge bases.',
-      fix: 'Add <link rel="prev"> and <link rel="next"> tags in the <head> of paginated pages pointing to the previous and next pages in the series.',
-      code: '<link rel="prev" href="/blog/page/1">\n<link rel="next" href="/blog/page/3">',
-      effort: "easy",
-      tags: ["pagination", "html", "generative-engine"]
-    }
-  };
-  audit(ctx) {
-    const page = ctx.pages[0];
-    if (!page) {
-      return this.fail(
-        "No pages scanned.",
-        '<link rel="prev"> and <link rel="next"> in head',
-        "No pages scanned",
-        {
-          priority: "low",
-          description: 'AI crawlers use rel="prev" and rel="next" to navigate paginated content series without missing pages.',
-          code: '<link rel="prev" href="/blog/page/1">\n<link rel="next" href="/blog/page/3">'
-        }
-      );
-    }
-    for (const p of ctx.pages) {
-      const hasPrev = p.headLinks.some((l) => l.rel === "prev");
-      const hasNext = p.headLinks.some((l) => l.rel === "next");
-      if (hasPrev || hasNext) {
-        const found = [];
-        if (hasPrev) found.push('rel="prev"');
-        if (hasNext) found.push('rel="next"');
-        return this.pass(
-          `Pagination links found: ${found.join(" and ")}.`,
-          '<link rel="prev"> and <link rel="next"> in head',
-          found.join(", "),
-          p.url
-        );
-      }
-    }
-    return this.warn(
-      'No <link rel="prev"> or <link rel="next"> found on any page.',
-      '<link rel="prev"> and <link rel="next"> in head',
-      "Not found",
-      {
-        priority: "low",
-        description: 'AI crawlers use rel="prev" and rel="next" to navigate paginated content series sequentially. Without these links, agents may miss pages in a series or index paginated listings out of order, leading to incomplete content coverage in AI knowledge bases.',
-        code: '<link rel="prev" href="/blog/page/1">\n<link rel="next" href="/blog/page/3">'
-      },
-      page.url
-    );
-  }
-};
-
 // src/audits/generative-engine/unique-data.ts
 var STAT_PATTERN = /\d+(?:\.\d+)?%|\$[\d,]+(?:\.\d{2})?|\b\d{1,3}(?:,\d{3})+\b|\b\d+(?:\.\d+)?x\b/;
 var UniqueDataAudit = class extends Audit {
@@ -17266,7 +15918,6 @@ var defaultConfig = {
       reg(MobileFriendlyAudit),
       reg(FastPageLoadAudit),
       reg(NoBrokenLinksAudit),
-      reg(NavigationJsonAudit),
       reg(NoOrphanPagesAudit),
       reg(CommerceLinksAudit)
     ],
@@ -17310,13 +15961,11 @@ var defaultConfig = {
       reg(FaqPageSchemaAudit),
       reg(ServiceProductSchemaAudit),
       reg(SpeakableSchemaAudit),
-      reg(PotentialActionAudit),
       reg(HowToSchemaAudit),
       reg(LocalBusinessSchemaAudit),
       reg(ReviewSchemaAudit),
       reg(OfferSchemaAudit),
       reg(AuthorSchemaAudit),
-      reg(ActionSchemaAudit),
       reg(ProductIdentifiersAudit),
       reg(ProductDetailsAudit),
       reg(ProductReviewsAudit),
@@ -17334,12 +15983,9 @@ var defaultConfig = {
       reg(OgImageAltAudit),
       reg(TwitterCardAudit),
       reg(LlmsTxtLinkAudit),
-      reg(LlmsFullTxtLinkAudit),
       reg(AiContentDeclarationAudit),
-      reg(AiInstructionsAudit),
       reg(MarkdownAlternateAudit),
       reg(RssFeedLinkAudit),
-      reg(McpDiscoveryLinkAudit),
       reg(OpenApiLinkAudit),
       reg(AiCatalogLinkAudit),
       reg(MetaRobotsAudit)
@@ -17348,20 +15994,17 @@ var defaultConfig = {
       reg(OpenApiExistsAudit),
       reg(OpenApiEndpointsAudit),
       reg(OpenApiOperationIdsAudit),
-      reg(OpenApiAiInstructionsAudit),
       reg(OpenApiServersAudit),
       reg(OpenApiSchemasAudit),
       reg(AiCatalogExistsAudit),
       reg(AiCatalogMetadataAudit),
       reg(AiCatalogUrlsAudit),
       reg(AgentsJsonAudit),
-      reg(AiPluginJsonAudit),
       reg(McpDiscoveryAudit),
       reg(McpEndpointAudit),
       reg(McpCapabilitiesAudit),
       reg(ContactFormAudit),
       reg(SearchEndpointAudit),
-      reg(DataActionCtasAudit),
       reg(NoBlockingCaptchaAudit),
       reg(FormsNoJsAudit),
       reg(WebmcpManifestAudit),
@@ -17369,7 +16012,6 @@ var defaultConfig = {
       reg(WebmcpInputQualityAudit),
       reg(WebmcpToolNamingAudit),
       reg(WebmcpToolAnnotationsAudit),
-      reg(WebmcpActionCoverageAudit),
       reg(OpenApiDescriptionQualityAudit),
       reg(FormActionabilityAudit)
     ],
@@ -17385,18 +16027,15 @@ var defaultConfig = {
       reg(DataTablesAudit),
       reg(CodeLanguageAudit),
       reg(TimeElementAudit),
-      reg(AddressElementAudit),
       reg(DefinitionElementsAudit),
       reg(ContentDepthAudit),
       reg(ImageAltTextAudit),
-      reg(DecorativeImagesAudit),
       reg(FigureFigcaptionAudit),
       reg(SvgBloatAudit),
       reg(TokenRatioAudit),
       reg(FakeHeadingsAudit)
     ],
     accessibility: [
-      reg(SkipNavAudit),
       reg(AriaLandmarksAudit),
       reg(NavAriaLabelAudit),
       reg(FormErrorMessagesAudit),
@@ -17424,8 +16063,6 @@ var defaultConfig = {
       reg(HstsHeaderAudit),
       reg(CspHeaderAudit),
       reg(ContentTypeOptionsAudit),
-      reg(ReferrerPolicyAudit),
-      reg(PermissionsPolicyAudit),
       reg(SecurityTxtAudit),
       reg(CorsAiFilesAudit),
       reg(CorsApiRoutesAudit),
@@ -17436,11 +16073,9 @@ var defaultConfig = {
       reg(NoRenderBlockingAudit),
       reg(ImageDimensionsAudit),
       reg(LcpNotLazyAudit),
-      reg(PreconnectHintsAudit),
       reg(NoBrokenAiEndpointsAudit),
       reg(PrivacyPolicyAudit),
-      reg(TermsOfServiceAudit),
-      reg(FrameworkDetectionAudit)
+      reg(TermsOfServiceAudit)
     ],
     "answer-engine": [
       reg(FaqSectionsAudit),
@@ -17467,7 +16102,6 @@ var defaultConfig = {
       reg(PublicationDateAudit),
       reg(LastModifiedSchemaAudit),
       reg(InternalCrossLinkingAudit),
-      reg(PaginationLinksAudit),
       reg(UniqueDataAudit),
       reg(BlockquoteUsageAudit),
       reg(DescriptiveUrlsAudit)
@@ -17489,20 +16123,21 @@ function stubCheck(meta, tag, explanation) {
     priority: meta.defaultPriority,
     impact: meta.guidance?.impact ?? "",
     fix: meta.guidance?.fix ?? "",
-    tags: [tag]
+    tags: [tag],
+    deprecated: meta.deprecated
   };
 }
-async function runAudits(ctx, config, onProgress) {
+function planAudits(ctx, config) {
   const scannedPageTypes = new Set(ctx.pages.map((p) => p.pageType));
-  const all = [];
-  const allChecks = [];
+  const runnable = [];
+  const skipped = [];
   for (const cat of config.categories) {
     const regs = config.audits[cat.id] ?? [];
     for (const reg2 of regs) {
       const applicable = reg2.meta.applicablePageTypes;
       if (applicable && applicable.length > 0) {
         if (!applicable.some((pt) => scannedPageTypes.has(pt))) {
-          allChecks.push(
+          skipped.push(
             stubCheck(
               reg2.meta,
               TAG_SKIPPED_PAGE_TYPE,
@@ -17512,30 +16147,35 @@ async function runAudits(ctx, config, onProgress) {
           continue;
         }
       }
-      all.push({ reg: reg2, categoryId: cat.id });
+      runnable.push({ reg: reg2, categoryId: cat.id });
     }
   }
-  const totalAudits = all.length;
-  let completed = 0;
+  return { runnable, skipped };
+}
+async function runAudits(ctx, config, onEvent, plan) {
+  const { runnable, skipped } = plan ?? planAudits(ctx, config);
+  const allChecks = [...skipped];
   const batchSize = 20;
-  for (let i = 0; i < totalAudits; i += batchSize) {
-    const batch = all.slice(i, i + batchSize);
+  for (let i = 0; i < runnable.length; i += batchSize) {
+    const batch = runnable.slice(i, i + batchSize);
     const batchResults = await Promise.all(
       batch.map(async ({ reg: reg2 }) => {
+        const label2 = `${reg2.meta.id} ${reg2.meta.title}`;
         try {
           const instance = reg2.create();
           const result = await instance.audit(ctx);
-          return instance.toCheckResult(result);
+          const check = instance.toCheckResult(result);
+          onEvent?.({ type: "unit:done", label: label2 });
+          return check;
         } catch (err) {
           logger.error({ err, auditId: reg2.meta.id }, "[scanner] Audit error");
           const message = err instanceof Error ? err.message : String(err);
+          onEvent?.({ type: "unit:fail", label: label2, error: message });
           return stubCheck(reg2.meta, TAG_SCAN_ERROR, `Audit failed to run: ${message}`);
         }
       })
     );
     allChecks.push(...batchResults);
-    completed += batchResults.length;
-    onProgress?.(completed, totalAudits);
   }
   const categories = config.categories.map((cat) => {
     const catChecks = allChecks.filter((c) => c.category === cat.id);
@@ -17583,6 +16223,110 @@ function buildWeightedCategoryResult(cat, checks2, registrations) {
   };
 }
 
+// src/progress.ts
+var PHASE_WEIGHTS = {
+  "fetch-root": 0.35,
+  "fetch-pages": 0.2,
+  analyze: 0.1,
+  audits: 0.3,
+  report: 0.05
+};
+var ProgressTracker = class {
+  onEvent;
+  startMs;
+  doneWeight = 0;
+  phase = null;
+  phaseStartMs = 0;
+  totalUnits = 0;
+  completedUnits = 0;
+  lastFraction = 0;
+  constructor(onEvent) {
+    this.onEvent = onEvent;
+    this.startMs = performance.now();
+  }
+  /** Fraction of the whole scan that is complete, in [0, 1]. Never decreases. */
+  get fraction() {
+    let f = this.doneWeight;
+    if (this.phase !== null) {
+      const ratio = this.totalUnits > 0 ? Math.min(1, this.completedUnits / this.totalUnits) : 0;
+      f += PHASE_WEIGHTS[this.phase] * ratio;
+    }
+    return Math.min(1, Math.max(f, this.lastFraction));
+  }
+  /** Stamp an event with the current fraction/elapsed and advance the floor. */
+  stamp() {
+    const fraction = this.fraction;
+    this.lastFraction = Math.max(this.lastFraction, fraction);
+    return { fraction, elapsedMs: this.elapsedMs() };
+  }
+  elapsedMs() {
+    return Math.max(0, Math.round(performance.now() - this.startMs));
+  }
+  scanStart(url) {
+    this.onEvent({ type: "scan:start", url, ...this.stamp() });
+  }
+  phaseStart(phase, totalUnits) {
+    this.phase = phase;
+    this.phaseStartMs = performance.now();
+    this.totalUnits = Math.max(0, totalUnits);
+    this.completedUnits = 0;
+    this.onEvent({
+      type: "phase:start",
+      phase,
+      totalUnits: this.totalUnits,
+      ...this.stamp()
+    });
+  }
+  /** Correct the current phase's unit total (e.g. discovery finds pages mid-phase). */
+  setPhaseTotal(totalUnits) {
+    this.totalUnits = Math.max(this.completedUnits, totalUnits);
+  }
+  unitDone(label2) {
+    const phase = this.phase;
+    if (phase === null) return;
+    this.completedUnits += 1;
+    this.onEvent({
+      type: "unit:done",
+      phase,
+      completed: this.completedUnits,
+      total: this.totalUnits,
+      label: label2,
+      ...this.stamp()
+    });
+  }
+  /** A failed unit still counts as settled work so the phase can complete. */
+  unitFail(label2, error) {
+    const phase = this.phase;
+    if (phase === null) return;
+    this.completedUnits += 1;
+    this.onEvent({
+      type: "unit:fail",
+      phase,
+      label: label2,
+      error,
+      ...this.stamp()
+    });
+  }
+  phaseDone() {
+    const phase = this.phase;
+    if (phase === null) return;
+    this.phase = null;
+    this.doneWeight += PHASE_WEIGHTS[phase];
+    const durationMs = Math.max(0, Math.round(performance.now() - this.phaseStartMs));
+    this.totalUnits = 0;
+    this.completedUnits = 0;
+    this.onEvent({
+      type: "phase:done",
+      phase,
+      durationMs,
+      ...this.stamp()
+    });
+  }
+  scanDone(score) {
+    this.onEvent({ type: "scan:done", durationMs: this.elapsedMs(), score, ...this.stamp() });
+  }
+};
+
 // src/audits/accessibility/runner.ts
 var import_jsdom = require("jsdom");
 
@@ -22902,6 +21646,34 @@ function generateScanSummary(report) {
   return summary;
 }
 
+// src/scorer.ts
+function isInformative(check) {
+  return check.scoreDisplayMode === "informative";
+}
+function calculateCategoryScore(checks2) {
+  const scored = checks2.filter((c) => c.status !== "na" && !isInformative(c));
+  if (scored.length === 0) return 0;
+  const total = scored.reduce((sum, c) => sum + c.score, 0);
+  return Math.round(total / scored.length * 100);
+}
+function buildCategoryResult(id, checks2) {
+  return {
+    id,
+    name: CATEGORY_NAMES[id] ?? id,
+    weight: CATEGORY_WEIGHTS[id] ?? 0,
+    score: calculateCategoryScore(checks2),
+    checks: checks2,
+    passCount: checks2.filter((c) => c.status === "pass").length,
+    warnCount: checks2.filter((c) => c.status === "warn").length,
+    failCount: checks2.filter((c) => c.status === "fail").length
+  };
+}
+function calculateOverallScore(categories) {
+  return Math.round(
+    categories.reduce((sum, cat) => sum + cat.score * cat.weight, 0)
+  );
+}
+
 // src/waf-detector.ts
 function detectWafProtection(targetUrl, homepageResult, rootFiles, scannedPagesCount) {
   const allResults = [];
@@ -23094,9 +21866,11 @@ function discoverPages(homepageUrl, domain, rootFiles, homepage$, exclude, maxAd
   }
   return selected;
 }
-async function runScan(url, onProgress, pageOverrides, signal) {
-  const progress = onProgress ?? (() => {
-  });
+async function runScan(url, options) {
+  const onEvent = options?.onEvent;
+  const pageOverrides = options?.pages;
+  const signal = options?.signal;
+  const tracker = new ProgressTracker((event) => onEvent?.(event));
   const start = performance.now();
   const fetcher = createFetcher();
   const baseUrl = new URL(url).origin;
@@ -23119,7 +21893,7 @@ async function runScan(url, onProgress, pageOverrides, signal) {
   }
   logger.debug({ url, domain }, "[orchestrator] Starting runScan");
   signal?.throwIfAborted();
-  await progress(5, "Fetching root files");
+  tracker.scanStart(displayUrl);
   const rootFilePaths = [
     "/robots.txt",
     "/llms.txt",
@@ -23157,19 +21931,26 @@ async function runScan(url, onProgress, pageOverrides, signal) {
     "/our-story"
   ];
   logger.debug({ count: rootFilePaths.length }, "[orchestrator] Phase 1: Fetching root files");
+  tracker.phaseStart("fetch-root", rootFilePaths.length);
   const rootResults = await Promise.all(
-    rootFilePaths.map((path) => fetcher.fetch({ url: `${baseUrl}${path}`, signal }))
+    rootFilePaths.map(
+      (path) => fetcher.fetch({ url: `${baseUrl}${path}`, signal }).then((result) => {
+        tracker.unitDone(path);
+        return result;
+      })
+    )
   );
   const rootFiles = {};
   rootFilePaths.forEach((path, i) => {
     rootFiles[path] = rootResults[i];
   });
-  await progress(25, "Root files fetched");
+  tracker.phaseDone();
   logger.debug("[orchestrator] Phase 1 complete: Root files fetched");
   signal?.throwIfAborted();
-  await progress(30, "Fetching pages");
   logger.debug("[orchestrator] Phase 2: Fetching pages");
+  tracker.phaseStart("fetch-pages", 1);
   const homepageResult = await fetcher.fetch({ url, signal });
+  tracker.unitDone(displayUrl);
   const homepage$ = homepageResult.status === 200 && homepageResult.body ? parseHtml(homepageResult.body) : null;
   const discoverLimit = Math.max(0, MAX_PAGES_PER_SCAN - 1 - overrideUrls.length);
   const discoveredUrls = homepage$ ? discoverPages(url, domain, rootFiles, homepage$, new Set(overrideTypeByKey.keys()), discoverLimit) : [];
@@ -23178,12 +21959,22 @@ async function runScan(url, onProgress, pageOverrides, signal) {
     "[orchestrator] Page set: overrides + discovered URLs"
   );
   const extraUrls = [...overrideUrls, ...discoveredUrls];
-  await progress(40, `Analyzing ${1 + extraUrls.length} pages`);
+  tracker.setPhaseTotal(1 + extraUrls.length);
   const extraResults = await Promise.all(
-    extraUrls.map((pageUrl) => fetcher.fetch({ url: pageUrl, signal }))
+    extraUrls.map(
+      (pageUrl) => fetcher.fetch({ url: pageUrl, signal }).then((result) => {
+        tracker.unitDone(pageUrl);
+        return result;
+      })
+    )
   );
+  tracker.phaseDone();
   const allPageResults = [homepageResult, ...extraResults];
   const allPageUrls = [displayUrl, ...extraUrls];
+  tracker.phaseStart(
+    "analyze",
+    allPageResults.filter((r) => r.status === 200 && r.body).length
+  );
   const pages = allPageResults.map((r, i) => ({ result: r, url: allPageUrls[i], index: i })).filter((p) => p.result.status === 200 && p.result.body).map((p) => {
     const $ = parseHtml(p.result.body);
     const jsonLd = extractJsonLd($);
@@ -23191,6 +21982,7 @@ async function runScan(url, onProgress, pageOverrides, signal) {
     const meta = extractMetaTags($);
     const isFirstPage = p.index === 0;
     const forcedType = overrideTypeByKey.get(p.url.replace(/\/$/, ""));
+    tracker.unitDone(p.url);
     return {
       url: p.url,
       pageType: forcedType ?? detectPageType(p.url, $, structuredData, meta, isFirstPage),
@@ -23208,13 +22000,12 @@ async function runScan(url, onProgress, pageOverrides, signal) {
       p.a11yResults = await runA11yForHtml(p.fetchResult.body, p.url, A11Y_RULES);
     })
   );
-  await progress(55, "Page analysis complete");
+  tracker.phaseDone();
   logger.debug(
     { pagesAnalyzed: pages.length },
     "[orchestrator] Phase 2 complete: Page analysis complete"
   );
   signal?.throwIfAborted();
-  await progress(60, "Running audits");
   logger.debug("[orchestrator] Phase 3: Running audits");
   const wafProtection = detectWafProtection(url, homepageResult, rootFiles, pages.length);
   const ctx = {
@@ -23222,22 +22013,30 @@ async function runScan(url, onProgress, pageOverrides, signal) {
     pages,
     domain,
     baseUrl,
-    fetch: (options) => fetcher.fetch({ ...options, signal }),
+    fetch: (options2) => fetcher.fetch({ ...options2, signal }),
     wafProtection: wafProtection ?? void 0
   };
+  const auditPlan = planAudits(ctx, defaultConfig);
+  tracker.phaseStart("audits", auditPlan.runnable.length);
   const {
     checks: allChecks,
     categories,
     overallScore
-  } = await runAudits(ctx, defaultConfig, (completed, total) => {
-    const checkProgress = 60 + Math.round(completed / total * 30);
-    void progress(checkProgress, `Running audits (${completed}/${total})`);
-  });
+  } = await runAudits(
+    ctx,
+    defaultConfig,
+    (event) => {
+      if (event.type === "unit:done") tracker.unitDone(event.label);
+      else tracker.unitFail(event.label, event.error);
+    },
+    auditPlan
+  );
+  tracker.phaseDone();
   logger.debug("[orchestrator] Phase 3 complete: Audits finished");
-  await progress(97, "Building report");
+  tracker.phaseStart("report", 1);
   logger.debug("[orchestrator] Phase 4: Building final report");
   const durationMs = Math.round(performance.now() - start);
-  const recommendations = allChecks.filter((c) => c.status !== "pass").slice().sort((a, b) => {
+  const recommendations = allChecks.filter((c) => c.status !== "pass" && !isInformative(c)).slice().sort((a, b) => {
     const order = { critical: 0, high: 1, medium: 2, low: 3 };
     return (order[a.priority] ?? 3) - (order[b.priority] ?? 3);
   });
@@ -23248,11 +22047,12 @@ async function runScan(url, onProgress, pageOverrides, signal) {
       weightMap.set(reg2.meta.id, reg2.meta.weight);
     }
   }
-  const topPasses = allChecks.filter((c) => c.status === "pass").slice().sort(
+  const topPasses = allChecks.filter((c) => c.status === "pass" && !isInformative(c)).slice().sort(
     (a, b) => (weightMap.get(b.id) ?? 1) - (weightMap.get(a.id) ?? 1)
   ).slice(0, 10);
-  await progress(100, "Complete");
-  const readinessVitals = calculateReadinessVitals(allChecks);
+  const readinessVitals = calculateReadinessVitals(
+    allChecks.filter((c) => !isInformative(c))
+  );
   const readinessScore = Math.round(
     readinessVitals.commerce * READINESS_WEIGHTS.commerce + readinessVitals.content * READINESS_WEIGHTS.content + readinessVitals.botAccessibility * READINESS_WEIGHTS.botAccessibility + readinessVitals.technical * READINESS_WEIGHTS.technical
   );
@@ -23281,6 +22081,9 @@ async function runScan(url, onProgress, pageOverrides, signal) {
     productFields: [...overrideTypeByKey.values()].includes("product") ? extractProductFieldVerification(pages) : void 0
   };
   report.summary = generateScanSummary(report);
+  tracker.unitDone();
+  tracker.phaseDone();
+  tracker.scanDone(overallScore);
   logger.debug({ durationMs, score: overallScore }, "[orchestrator] runScan complete");
   return report;
 }
@@ -23329,31 +22132,6 @@ function calculateReadinessVitals(checks2) {
   };
 }
 
-// src/scorer.ts
-function calculateCategoryScore(checks2) {
-  const scored = checks2.filter((c) => c.status !== "na");
-  if (scored.length === 0) return 0;
-  const total = scored.reduce((sum, c) => sum + c.score, 0);
-  return Math.round(total / scored.length * 100);
-}
-function buildCategoryResult(id, checks2) {
-  return {
-    id,
-    name: CATEGORY_NAMES[id] ?? id,
-    weight: CATEGORY_WEIGHTS[id] ?? 0,
-    score: calculateCategoryScore(checks2),
-    checks: checks2,
-    passCount: checks2.filter((c) => c.status === "pass").length,
-    warnCount: checks2.filter((c) => c.status === "warn").length,
-    failCount: checks2.filter((c) => c.status === "fail").length
-  };
-}
-function calculateOverallScore(categories) {
-  return Math.round(
-    categories.reduce((sum, cat) => sum + cat.score * cat.weight, 0)
-  );
-}
-
 // src/types.ts
 var PAGE_TYPE_LABELS = {
   homepage: "Homepage",
@@ -23461,12 +22239,15 @@ function loadConfigFile(customPath) {
   CheckResultSchema,
   CheckStatusSchema,
   DEFAULT_SCAN_LIMIT,
+  DeprecationNoticeSchema,
   FixEffortSchema,
   MAX_CONCURRENT_REQUESTS,
   MAX_PAGES_PER_SCAN,
   MAX_RESPONSE_BODY_BYTES,
   PAGE_TYPE_LABELS,
+  PHASE_WEIGHTS,
   PRESETS,
+  ProgressTracker,
   READINESS_WEIGHTS,
   REQUEST_TIMEOUT_MS,
   SCANNER_USER_AGENT,
@@ -23503,6 +22284,7 @@ function loadConfigFile(customPath) {
   getTierColor,
   getTierLabel,
   getWordCount,
+  isInformative,
   isPrivateIp,
   isSafeUrl,
   joinUrl,
@@ -23510,6 +22292,7 @@ function loadConfigFile(customPath) {
   logger,
   normalizeUrl,
   parseHtml,
+  planAudits,
   runAudits,
   runScan
 });