agentimization 0.1.2 → 0.2.0

package/README.md

@@ -2,14 +2,12 @@
 
 [![npm version](https://img.shields.io/npm/v/agentimization?style=flat-square&color=blue)](https://www.npmjs.com/package/agentimization)
 
-```text
-╭───────────────────────────────────────────────╮
-│ ▓░▒▓░░▒░▓▒░▓▓░▒░▓░░▒▓▒░▓░░▓▒░▓░▒░▓░░▒▓░░      │
-│ ░▓▒░▓░░▒▓▒░▓░░▒▓▓░▒░▓▒░░▓▒░▓░▒░░▓▒░░▓░▒       │
-│ ▓░▒▓░░▒▓▒░░▓░▒▓▒░░▓░░▓▒░▓░▒░░▓▒░▓░░▒▓░        │
-│ ░▒▓░▒░▓▒░░▓░▒▓░░▒▓▒░░▓░▒▓░░▒▓░ agentimization │
-╰───────────────────────────────────────────────╯
-```
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/antlio/agentimization/main/assets/hero-loading-dark.svg">
+    <img src="https://raw.githubusercontent.com/antlio/agentimization/main/assets/hero-loading-light.svg" alt="agentimization" width="620">
+  </picture>
+</p>
 
 geo audit for agent-ready websites and projects.
 

package/dist/index.js

@@ -4105,6 +4105,140 @@ var DEFAULT_CONFIG = {
   onEvent: () => {
   }
 };
+var stripHtml = (html) => html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+var extractMarkdownLinks = (markdown) => {
+  const links = [];
+  const linkRegex = /\[.+?\]\(([^)]+)\)/g;
+  let match;
+  while ((match = linkRegex.exec(markdown)) !== null) {
+    links.push(match[1]);
+  }
+  return links;
+};
+var extractLinks = (html, baseUrl) => {
+  const links = [];
+  const linkRegex = /<a[^>]+href=["']([^"']+)["']/gi;
+  let match;
+  while ((match = linkRegex.exec(html)) !== null) {
+    try {
+      const resolved = new URL(match[1], baseUrl).href;
+      links.push(resolved);
+    } catch {
+    }
+  }
+  return links;
+};
+var extractMetaTags = (html) => {
+  const meta = {};
+  const metaRegex = /<meta[^>]+(?:name|property)=["']([^"']+)["'][^>]+content=["']([^"']+)["']/gi;
+  let match;
+  while ((match = metaRegex.exec(html)) !== null) {
+    meta[match[1].toLowerCase()] = match[2];
+  }
+  const metaRegex2 = /<meta[^>]+content=["']([^"']+)["'][^>]+(?:name|property)=["']([^"']+)["']/gi;
+  while ((match = metaRegex2.exec(html)) !== null) {
+    meta[match[2].toLowerCase()] = match[1];
+  }
+  return meta;
+};
+var extractJsonLd = (html) => {
+  const results = [];
+  const regex = /<script[^>]+type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi;
+  let match;
+  while ((match = regex.exec(html)) !== null) {
+    try {
+      results.push(JSON.parse(match[1]));
+    } catch {
+    }
+  }
+  return results;
+};
+var readAttr = (attrs, name) => {
+  const re = new RegExp(`\\b${name}=(?:"([^"]*)"|'([^']*)')`, "i");
+  const m = attrs.match(re);
+  if (!m) return void 0;
+  return m[1] ?? m[2];
+};
+var extractImages = (html) => {
+  const images = [];
+  const imgRegex = /<img\b([^>]*)>/gi;
+  let match;
+  while ((match = imgRegex.exec(html)) !== null) {
+    const attrs = match[1];
+    const src = readAttr(attrs, "src");
+    if (src === void 0) continue;
+    images.push({ src, alt: readAttr(attrs, "alt") });
+  }
+  return images;
+};
+var extractHeadings = (html) => {
+  const headings = [];
+  const regex = /<h([1-6])[^>]*>([\s\S]*?)<\/h\1>/gi;
+  let match;
+  while ((match = regex.exec(html)) !== null) {
+    headings.push({
+      level: parseInt(match[1], 10),
+      text: stripHtml(match[2]).trim()
+    });
+  }
+  return headings;
+};
+var hasServerRenderedContent = (html) => {
+  const withoutScripts = html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "");
+  const textContent = stripHtml(withoutScripts);
+  return textContent.length > 100;
+};
+var findContentStartPosition = (html) => {
+  const markers = [
+    /<main[\s>]/i,
+    /<article[\s>]/i,
+    /id=["']content["']/i,
+    /id=["']main["']/i,
+    /class=["'][^"']*content[^"']*["']/i,
+    /role=["']main["']/i
+  ];
+  for (const marker of markers) {
+    const match = html.search(marker);
+    if (match >= 0) {
+      return match / html.length;
+    }
+  }
+  const firstP = html.search(/<p[\s>]/i);
+  if (firstP >= 0) {
+    return firstP / html.length;
+  }
+  return 0.5;
+};
+var extractCodeFences = (markdown) => {
+  const fences = [];
+  const lines = markdown.split("\n");
+  let inFence = false;
+  let currentLang = "";
+  for (const line of lines) {
+    const openMatch = line.match(/^```(\w*)/);
+    if (openMatch && !inFence) {
+      inFence = true;
+      currentLang = openMatch[1] ?? "";
+    } else if (line.trim() === "```" && inFence) {
+      fences.push({ lang: currentLang, closed: true });
+      inFence = false;
+      currentLang = "";
+    }
+  }
+  if (inFence) {
+    fences.push({ lang: currentLang, closed: false });
+  }
+  return fences;
+};
+var parseSitemapUrls = (xml) => {
+  const urls = [];
+  const regex = /<loc>([^<]+)<\/loc>/gi;
+  let match;
+  while ((match = regex.exec(xml)) !== null) {
+    urls.push(match[1].trim());
+  }
+  return urls;
+};
 var llmsTxtExists = {
   id: "llms-txt-exists",
   name: "llms.txt Exists",
@@ -4144,7 +4278,7 @@ var llmsTxtValid = {
         name: "llms.txt Valid Structure",
         category: "content-discoverability",
         status: "skip",
-        message: "Skipped \u2014 no llms.txt found"
+        message: "Skipped: no llms.txt found"
       };
     }
     const issues = [];
@@ -4189,7 +4323,7 @@ var llmsTxtSize = {
         name: "llms.txt Size",
         category: "content-discoverability",
         status: "skip",
-        message: "Skipped \u2014 no llms.txt found"
+        message: "Skipped: no llms.txt found"
       };
     }
     const size = ctx.llmsTxt.length;
@@ -4227,7 +4361,7 @@ var llmsTxtFreshness = {
         name: "llms.txt Coverage",
         category: "content-discoverability",
         status: "skip",
-        message: "Skipped \u2014 no llms.txt found"
+        message: "Skipped: no llms.txt found"
       };
     }
     if (ctx.sitemapUrls.length === 0) {
@@ -4257,11 +4391,9 @@ var llmsTxtFreshness = {
         return null;
       }
     };
-    const linkRegex = /\[.+?\]\(([^)]+)\)/g;
     const llmsKeys = /* @__PURE__ */ new Set();
-    let match;
-    while ((match = linkRegex.exec(ctx.llmsTxt)) !== null) {
-      const k = keyFor(match[1]);
+    for (const link of extractMarkdownLinks(ctx.llmsTxt)) {
+      const k = keyFor(link);
       if (k) llmsKeys.add(k);
     }
     const sitemapKeys = /* @__PURE__ */ new Set();
@@ -4301,7 +4433,7 @@ var llmsTxtFreshness = {
       category: "content-discoverability",
       status: coveragePct >= 40 || freshnessPct >= 70 ? "warn" : "fail",
       message: `${message}${missingFromLlms > 0 ? ` \xB7 ${missingFromLlms} sitemap pages not in llms.txt` : ""}${staleInLlms > 0 ? ` \xB7 ${staleInLlms} llms.txt links not in sitemap` : ""}`,
-      suggestion: coveragePct < freshnessPct ? "Add missing sitemap pages to llms.txt to improve AI agent discoverability." : "Some llms.txt links aren't in the sitemap \u2014 they may be stale or your sitemap may be incomplete.",
+      suggestion: coveragePct < freshnessPct ? "Add missing sitemap pages to llms.txt to improve AI agent discoverability." : "Some llms.txt links aren't in the sitemap. They may be stale or your sitemap may be incomplete.",
       metadata: {
         coveragePct,
         freshnessPct,
@@ -4327,15 +4459,13 @@ var llmsTxtLinksResolve = {
         name: "llms.txt Links Resolve",
         category: "content-discoverability",
         status: "skip",
-        message: "Skipped \u2014 no llms.txt found"
+        message: "Skipped: no llms.txt found"
       };
     }
-    const linkRegex = /\[.+?\]\(([^)]+)\)/g;
     const urls = [];
-    let match;
-    while ((match = linkRegex.exec(ctx.llmsTxt)) !== null) {
+    for (const link of extractMarkdownLinks(ctx.llmsTxt)) {
       try {
-        const resolved2 = new URL(match[1], ctx.baseUrl.origin);
+        const resolved2 = new URL(link, ctx.baseUrl.origin);
         if (resolved2.origin === ctx.baseUrl.origin) {
           urls.push(resolved2.href);
         }
@@ -4376,7 +4506,7 @@ var llmsTxtLinksResolve = {
       name: "llms.txt Links Resolve",
       category: "content-discoverability",
       status: "fail",
-      message: `${resolved}/${sampled.length} sampled links resolve \u2014 ${sampled.length - resolved} broken`,
+      message: `${resolved}/${sampled.length} sampled links resolve, ${sampled.length - resolved} broken`,
       suggestion: "Fix broken links in llms.txt. AI agents will fail to fetch these pages.",
       metadata: { resolved, sampled: sampled.length, total: urls.length }
     };
@@ -4395,15 +4525,10 @@ var llmsTxtLinksMarkdown = {
         name: "llms.txt Links Markdown",
         category: "content-discoverability",
         status: "skip",
-        message: "Skipped \u2014 no llms.txt found"
+        message: "Skipped: no llms.txt found"
       };
     }
-    const linkRegex = /\[.+?\]\(([^)]+)\)/g;
-    const urls = [];
-    let m;
-    while ((m = linkRegex.exec(ctx.llmsTxt)) !== null) {
-      urls.push(m[1]);
-    }
+    const urls = extractMarkdownLinks(ctx.llmsTxt);
     if (urls.length === 0) {
       return {
         id: "llms-txt-links-markdown",
@@ -4451,7 +4576,7 @@ var llmsTxtLinksMarkdown = {
       category: "content-discoverability",
       status: "fail",
       message: `Only ${mdLinks}/${urls.length} llms.txt links point to .md URLs (${pct}%)`,
-      suggestion: "Most llms.txt links are HTML-only. Serve a markdown version at .md URLs and link to those \u2014 agents get cleaner content and fewer parse failures.",
+      suggestion: "Most llms.txt links are HTML-only. Serve a markdown version at .md URLs and link to those, so agents get cleaner content and fewer parse failures.",
       metadata: { mdLinks, total: urls.length, pct }
     };
   }
@@ -4553,6 +4678,176 @@ var robotsTxtAgentRules = {
     };
   }
 };
+var llmsFullExists = {
+  id: "llms-full-exists",
+  name: "llms-full.txt Exists",
+  category: "content-discoverability",
+  description: "Checks if llms-full.txt (the complete-content variant) is present at the site root",
+  weight: 0.4,
+  run: async (ctx) => {
+    if (ctx.llmsFullTxt) {
+      return {
+        id: "llms-full-exists",
+        name: "llms-full.txt Exists",
+        category: "content-discoverability",
+        status: "pass",
+        message: ctx.mode === "local" ? "llms-full.txt found in project root" : `llms-full.txt found at ${ctx.baseUrl.origin}/llms-full.txt`
+      };
+    }
+    return {
+      id: "llms-full-exists",
+      name: "llms-full.txt Exists",
+      category: "content-discoverability",
+      status: "info",
+      message: "No llms-full.txt found (optional)",
+      suggestion: "If your llms.txt is large or you want agents to get full content in one fetch, add a /llms-full.txt containing the concatenated markdown of your docs."
+    };
+  }
+};
+var llmsFullValid = {
+  id: "llms-full-valid",
+  name: "llms-full.txt Valid Structure",
+  category: "content-discoverability",
+  description: "Checks if llms-full.txt has recognizable markdown structure (headings, content)",
+  weight: 0.4,
+  run: async (ctx) => {
+    if (!ctx.llmsFullTxt) {
+      return {
+        id: "llms-full-valid",
+        name: "llms-full.txt Valid Structure",
+        category: "content-discoverability",
+        status: "skip",
+        message: "Skipped: no llms-full.txt found"
+      };
+    }
+    const hasHeadings = /^#{1,3}\s+/m.test(ctx.llmsFullTxt);
+    const hasProse = ctx.llmsFullTxt.length > 600;
+    if (hasHeadings && hasProse) {
+      return {
+        id: "llms-full-valid",
+        name: "llms-full.txt Valid Structure",
+        category: "content-discoverability",
+        status: "pass",
+        message: "llms-full.txt has recognizable markdown structure"
+      };
+    }
+    return {
+      id: "llms-full-valid",
+      name: "llms-full.txt Valid Structure",
+      category: "content-discoverability",
+      status: "warn",
+      message: `llms-full.txt found but ${!hasHeadings ? "has no markdown headings" : "has little content"}`,
+      suggestion: "llms-full.txt should contain the full markdown content of your docs, with headings, so agents can parse it."
+    };
+  }
+};
+var llmsFullSize = {
+  id: "llms-full-size",
+  name: "llms-full.txt Size",
+  category: "content-discoverability",
+  description: "Checks if llms-full.txt size is within the expected range (substantial but not excessive)",
+  weight: 0.3,
+  run: async (ctx) => {
+    if (!ctx.llmsFullTxt) {
+      return {
+        id: "llms-full-size",
+        name: "llms-full.txt Size",
+        category: "content-discoverability",
+        status: "skip",
+        message: "Skipped: no llms-full.txt found"
+      };
+    }
+    const size = ctx.llmsFullTxt.length;
+    const MIN = 1e4;
+    const MAX = 5e6;
+    if (size >= MIN && size <= MAX) {
+      return {
+        id: "llms-full-size",
+        name: "llms-full.txt Size",
+        category: "content-discoverability",
+        status: "pass",
+        message: `llms-full.txt is ${size.toLocaleString()} characters (within expected range)`,
+        metadata: { size }
+      };
+    }
+    return {
+      id: "llms-full-size",
+      name: "llms-full.txt Size",
+      category: "content-discoverability",
+      status: "warn",
+      message: size < MIN ? `llms-full.txt is only ${size.toLocaleString()} characters, smaller than expected for a full-content file` : `llms-full.txt is ${size.toLocaleString()} characters, large enough to overflow agent context windows`,
+      suggestion: size < MIN ? "llms-full.txt should contain your complete documentation. If it's this small, llms.txt alone may be enough." : "Consider trimming llms-full.txt or splitting content so agents can fetch what fits their context window.",
+      metadata: { size }
+    };
+  }
+};
+var llmsFullLinksResolve = {
+  id: "llms-full-links-resolve",
+  name: "llms-full.txt Links Resolve",
+  category: "content-discoverability",
+  description: "Checks if links in llms-full.txt return 200 OK",
+  weight: 0.4,
+  requiresNetwork: true,
+  run: async (ctx) => {
+    if (!ctx.llmsFullTxt) {
+      return {
+        id: "llms-full-links-resolve",
+        name: "llms-full.txt Links Resolve",
+        category: "content-discoverability",
+        status: "skip",
+        message: "Skipped: no llms-full.txt found"
+      };
+    }
+    const urls = [];
+    for (const link of extractMarkdownLinks(ctx.llmsFullTxt)) {
+      try {
+        const resolved2 = new URL(link, ctx.baseUrl.origin);
+        if (resolved2.origin === ctx.baseUrl.origin) {
+          urls.push(resolved2.href);
+        }
+      } catch {
+      }
+    }
+    if (urls.length === 0) {
+      return {
+        id: "llms-full-links-resolve",
+        name: "llms-full.txt Links Resolve",
+        category: "content-discoverability",
+        status: "info",
+        message: "No same-origin links found in llms-full.txt"
+      };
+    }
+    const sampled = urls.slice(0, 10);
+    const results = await Promise.allSettled(
+      sampled.map(async (url) => {
+        const resp = await fetch(url, { method: "HEAD", redirect: "follow" });
+        return { url, status: resp.status };
+      })
+    );
+    const resolved = results.filter(
+      (r) => r.status === "fulfilled" && r.value.status >= 200 && r.value.status < 400
+    ).length;
+    if (resolved === sampled.length) {
+      return {
+        id: "llms-full-links-resolve",
+        name: "llms-full.txt Links Resolve",
+        category: "content-discoverability",
+        status: "pass",
+        message: `All ${resolved} sampled same-origin links resolve (${urls.length} total links)`,
+        metadata: { resolved, sampled: sampled.length, total: urls.length }
+      };
+    }
+    return {
+      id: "llms-full-links-resolve",
+      name: "llms-full.txt Links Resolve",
+      category: "content-discoverability",
+      status: "fail",
+      message: `${resolved}/${sampled.length} sampled links resolve, ${sampled.length - resolved} broken`,
+      suggestion: "Fix broken links in llms-full.txt. AI agents will fail to fetch these pages.",
+      metadata: { resolved, sampled: sampled.length, total: urls.length }
+    };
+  }
+};
 var contentDiscoverabilityChecks = [
   llmsTxtExists,
   llmsTxtValid,
@@ -4560,21 +4855,29 @@ var contentDiscoverabilityChecks = [
   llmsTxtFreshness,
   llmsTxtLinksResolve,
   llmsTxtLinksMarkdown,
+  llmsFullExists,
+  llmsFullValid,
+  llmsFullSize,
+  llmsFullLinksResolve,
   sitemapExists,
   robotsTxtAgentRules
 ];
-var makeHeaders = (config) => ({
+var BROWSER_UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+var makeHeaders = (config, asBrowser = false) => asBrowser ? {
+  "User-Agent": BROWSER_UA,
+  Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+} : {
   "User-Agent": config.userAgent ?? DEFAULT_CONFIG.userAgent,
   Accept: "text/html,application/xhtml+xml,text/markdown,text/plain,*/*"
-});
-var fetchPage = async (url, config = {}) => {
+};
+var fetchPage = async (url, config = {}, asBrowser = false) => {
   const timeout = config.timeout ?? DEFAULT_CONFIG.timeout;
   const start = Date.now();
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeout);
   try {
     const response = await fetch(url, {
-      headers: makeHeaders(config),
+      headers: makeHeaders(config, asBrowser),
       signal: controller.signal,
       redirect: "follow"
     });
@@ -4627,13 +4930,13 @@ var fetchWithContentNegotiation = async (url, accept, config = {}) => {
     clearTimeout(timer);
   }
 };
-var fetchMany = async (urls, config = {}) => {
+var fetchMany = async (urls, config = {}, asBrowser = false) => {
   const concurrency = config.concurrency ?? DEFAULT_CONFIG.concurrency;
   const results = [];
   for (let i = 0; i < urls.length; i += concurrency) {
     const chunk = urls.slice(i, i + concurrency);
     const chunkResults = await Promise.allSettled(
-      chunk.map((url) => fetchPage(url, config))
+      chunk.map((url) => fetchPage(url, config, asBrowser))
     );
     for (const result of chunkResults) {
       if (result.status === "fulfilled") {
@@ -4796,131 +5099,6 @@ var markdownAvailabilityChecks = [
   contentNegotiation,
   markdownContentParity
 ];
-var stripHtml = (html) => html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
-var extractLinks = (html, baseUrl) => {
-  const links = [];
-  const linkRegex = /<a[^>]+href=["']([^"']+)["']/gi;
-  let match;
-  while ((match = linkRegex.exec(html)) !== null) {
-    try {
-      const resolved = new URL(match[1], baseUrl).href;
-      links.push(resolved);
-    } catch {
-    }
-  }
-  return links;
-};
-var extractMetaTags = (html) => {
-  const meta = {};
-  const metaRegex = /<meta[^>]+(?:name|property)=["']([^"']+)["'][^>]+content=["']([^"']+)["']/gi;
-  let match;
-  while ((match = metaRegex.exec(html)) !== null) {
-    meta[match[1].toLowerCase()] = match[2];
-  }
-  const metaRegex2 = /<meta[^>]+content=["']([^"']+)["'][^>]+(?:name|property)=["']([^"']+)["']/gi;
-  while ((match = metaRegex2.exec(html)) !== null) {
-    meta[match[2].toLowerCase()] = match[1];
-  }
-  return meta;
-};
-var extractJsonLd = (html) => {
-  const results = [];
-  const regex = /<script[^>]+type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi;
-  let match;
-  while ((match = regex.exec(html)) !== null) {
-    try {
-      results.push(JSON.parse(match[1]));
-    } catch {
-    }
-  }
-  return results;
-};
-var readAttr = (attrs, name) => {
-  const re = new RegExp(`\\b${name}=(?:"([^"]*)"|'([^']*)')`, "i");
-  const m = attrs.match(re);
-  if (!m) return void 0;
-  return m[1] ?? m[2];
-};
-var extractImages = (html) => {
-  const images = [];
-  const imgRegex = /<img\b([^>]*)>/gi;
-  let match;
-  while ((match = imgRegex.exec(html)) !== null) {
-    const attrs = match[1];
-    const src = readAttr(attrs, "src");
-    if (src === void 0) continue;
-    images.push({ src, alt: readAttr(attrs, "alt") });
-  }
-  return images;
-};
-var extractHeadings = (html) => {
-  const headings = [];
-  const regex = /<h([1-6])[^>]*>([\s\S]*?)<\/h\1>/gi;
-  let match;
-  while ((match = regex.exec(html)) !== null) {
-    headings.push({
-      level: parseInt(match[1], 10),
-      text: stripHtml(match[2]).trim()
-    });
-  }
-  return headings;
-};
-var hasServerRenderedContent = (html) => {
-  const withoutScripts = html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "");
-  const textContent = stripHtml(withoutScripts);
-  return textContent.length > 100;
-};
-var findContentStartPosition = (html) => {
-  const markers = [
-    /<main[\s>]/i,
-    /<article[\s>]/i,
-    /id=["']content["']/i,
-    /id=["']main["']/i,
-    /class=["'][^"']*content[^"']*["']/i,
-    /role=["']main["']/i
-  ];
-  for (const marker of markers) {
-    const match = html.search(marker);
-    if (match >= 0) {
-      return match / html.length;
-    }
-  }
-  const firstP = html.search(/<p[\s>]/i);
-  if (firstP >= 0) {
-    return firstP / html.length;
-  }
-  return 0.5;
-};
-var extractCodeFences = (markdown) => {
-  const fences = [];
-  const lines = markdown.split("\n");
-  let inFence = false;
-  let currentLang = "";
-  for (const line of lines) {
-    const openMatch = line.match(/^```(\w*)/);
-    if (openMatch && !inFence) {
-      inFence = true;
-      currentLang = openMatch[1] ?? "";
-    } else if (line.trim() === "```" && inFence) {
-      fences.push({ lang: currentLang, closed: true });
-      inFence = false;
-      currentLang = "";
-    }
-  }
-  if (inFence) {
-    fences.push({ lang: currentLang, closed: false });
-  }
-  return fences;
-};
-var parseSitemapUrls = (xml) => {
-  const urls = [];
-  const regex = /<loc>([^<]+)<\/loc>/gi;
-  let match;
-  while ((match = regex.exec(xml)) !== null) {
-    urls.push(match[1].trim());
-  }
-  return urls;
-};
 var MAX_HTML_CHARS = 5e4;
 var MAX_MD_CHARS = 5e4;
 var renderingStrategy = {
@@ -6239,6 +6417,56 @@ var mcpServerCard = {
     }
   }
 };
+var mcpToolCount = {
+  id: "mcp-tool-count",
+  name: "MCP Tool Count",
+  category: "agent-protocols",
+  description: "Checks that the MCP server card exposes at least one tool",
+  weight: 0.4,
+  run: async (ctx) => {
+    if (!ctx.mcpServerCard) {
+      return {
+        id: "mcp-tool-count",
+        name: "MCP Tool Count",
+        category: "agent-protocols",
+        status: "skip",
+        message: "Skipped: no MCP server card found"
+      };
+    }
+    let card;
+    try {
+      card = JSON.parse(ctx.mcpServerCard);
+    } catch {
+      return {
+        id: "mcp-tool-count",
+        name: "MCP Tool Count",
+        category: "agent-protocols",
+        status: "skip",
+        message: "Skipped: MCP server card is invalid JSON"
+      };
+    }
+    const toolCount = Array.isArray(card.tools) ? card.tools.length : Array.isArray(card.capabilities?.tools) ? card.capabilities.tools.length : 0;
+    if (toolCount > 0) {
+      return {
+        id: "mcp-tool-count",
+        name: "MCP Tool Count",
+        category: "agent-protocols",
+        status: "pass",
+        message: `MCP server exposes ${toolCount} tool${toolCount === 1 ? "" : "s"}`,
+        metadata: { toolCount }
+      };
+    }
+    return {
+      id: "mcp-tool-count",
+      name: "MCP Tool Count",
+      category: "agent-protocols",
+      status: "warn",
+      message: "MCP server card found but exposes no tools",
+      suggestion: "List your MCP server's tools in the server card so agents know what actions are available before connecting.",
+      metadata: { toolCount }
+    };
+  }
+};
 var apiCatalog = {
   id: "api-catalog",
   name: "API Catalog (RFC 9727)",
@@ -6312,7 +6540,7 @@ var contentSignals = {
         name: "Content Signals (AI Usage Declarations)",
         category: "agent-protocols",
         status: "info",
-        message: "No robots.txt found \u2014 cannot check for content signals",
+        message: "No robots.txt found, cannot check for content signals",
         suggestion: "Add a robots.txt with Content Signals directives to declare how AI agents may use your content (ai-train, ai-input, search)."
       };
     }
@@ -6497,7 +6725,7 @@ var agentsMd = {
         category: "agent-protocols",
         status: "fail",
         message: "No AGENTS.md or AGENT.md found",
-        suggestion: "Add an AGENTS.md at the project root. This is the universal agent configuration file \u2014 a README for AI coding agents. Include build/test commands, architecture overview, conventions, and any gotchas. Used by 60k+ open-source projects."
+        suggestion: "Add an AGENTS.md at the project root. This is the universal agent configuration file, a README for AI coding agents. Include build/test commands, architecture overview, conventions, and any gotchas. Used by 60k+ open-source projects."
       };
     }
     const content = ctx.agentsMd;
@@ -6549,6 +6777,7 @@ var agentsMd = {
 };
 var agentProtocolChecks = [
   mcpServerCard,
+  mcpToolCount,
   apiCatalog,
   contentSignals,
   linkHeaders,
@@ -6725,7 +6954,7 @@ var buildRemoteContext = async (targetUrl, config) => {
   const apiCatalog2 = apiCatalogResult.status === "fulfilled" && apiCatalogResult.value?.statusCode === 200 ? apiCatalogResult.value.text : void 0;
   const agentSkillsIndex2 = agentSkillsResult.status === "fulfilled" && agentSkillsResult.value?.statusCode === 200 ? agentSkillsResult.value.text : void 0;
   const agentsMd2 = void 0;
-  const sitemapUrls = sitemapXml ? parseSitemapUrls(sitemapXml) : [];
+  let sitemapUrls = sitemapXml ? parseSitemapUrls(sitemapXml) : [];
   if (!sitemapXml && robotsTxt) {
     const sitemapMatch = robotsTxt.match(/Sitemap:\s*(.+)/i);
     if (sitemapMatch) {
@@ -6735,10 +6964,28 @@ var buildRemoteContext = async (targetUrl, config) => {
       }
     }
   }
+  const isSitemapIndex = (sitemapXml ?? "").includes("<sitemapindex");
+  if (isSitemapIndex && sitemapUrls.length > 0) {
+    const nested = await Promise.allSettled(
+      sitemapUrls.slice(0, 20).map((u) => fetchText(u, config))
+    );
+    sitemapUrls = nested.flatMap(
+      (r) => r.status === "fulfilled" && r.value?.statusCode === 200 ? parseSitemapUrls(r.value.text) : []
+    );
+  }
   let pagesToSample = [];
   if (sitemapUrls.length > 0) {
-    const shuffled = [...sitemapUrls].sort(() => Math.random() - 0.5);
-    pagesToSample = shuffled.slice(0, config.sampleSize);
+    const pathPrefix = baseUrl.pathname.replace(/\/+$/, "");
+    const scoped = pathPrefix.length > 1 ? sitemapUrls.filter((u) => {
+      try {
+        return new URL(u).pathname.startsWith(pathPrefix);
+      } catch {
+        return false;
+      }
+    }) : sitemapUrls;
+    const pool = scoped.length > 0 ? scoped : sitemapUrls;
+    const step = Math.max(1, Math.floor(pool.length / config.sampleSize));
+    pagesToSample = pool.filter((_, i) => i % step === 0).slice(0, config.sampleSize);
   } else {
     const mainPage = await fetchPage(targetUrl, config);
     const linkRegex = /<a[^>]+href=["']([^"'#]+)["']/gi;
@@ -6758,14 +7005,16 @@ var buildRemoteContext = async (targetUrl, config) => {
   if (!pagesToSample.includes(targetUrl)) {
     pagesToSample.unshift(targetUrl);
   }
-  const sampledPages = await fetchMany(pagesToSample, config);
+  const sampledPages = await fetchMany(pagesToSample, config, true);
   emit({ type: "context-ready", pageCount: sampledPages.length });
-  for (const page of sampledPages) {
-    const mdResult = await fetchWithContentNegotiation(page.url, "text/markdown", config);
-    if (mdResult && mdResult.statusCode === 200 && (mdResult.contentType.includes("text/markdown") || mdResult.contentType.includes("text/plain"))) {
-      page.markdown = mdResult.text;
-    }
-  }
+  await Promise.allSettled(
+    sampledPages.map(async (page) => {
+      const mdResult = await fetchWithContentNegotiation(page.url, "text/markdown", config);
+      if (mdResult && mdResult.statusCode === 200 && (mdResult.contentType.includes("text/markdown") || mdResult.contentType.includes("text/plain"))) {
+        page.markdown = mdResult.text;
+      }
+    })
+  );
   return {
     mode: "remote",
     targetUrl,
@@ -6892,11 +7141,11 @@ var auditLocal = async (dirPath, config = {}) => {
 };
 
 // src/ui/app.tsx
-import { useState as useState4, useEffect as useEffect2 } from "react";
-import { Box as Box6, Text as Text6 } from "ink";
+import { useState as useState4 } from "react";
+import { Box as Box6, Text as Text6, Static, useStdout } from "ink";
 
 // src/ui/hero-card.tsx
-import { useEffect, useState } from "react";
+import { useState } from "react";
 import { Box, Text } from "ink";
 
 // src/ui/color.ts
@@ -6941,11 +7190,16 @@ var toInkColor = (input) => {
   return out;
 };
 
+// src/hooks/use-mount-effect.ts
+import { useEffect } from "react";
+var useMountEffect = (effect) => {
+  useEffect(effect, []);
+};
+
 // src/ui/hero-card.tsx
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-var CARD_WIDTH = 46;
+var DEFAULT_CARD_WIDTH = 46;
 var PATTERN_ROWS = 4;
-var PATTERN_COLS = CARD_WIDTH - 4;
 var PATTERN_GLYPHS = ["\u2591", "\u2592", "\u2593", "\u2588"];
 var ACCENT_BY_PHASE = {
   init: "oklch(0.787 0.119 304.8)",
@@ -7018,10 +7272,10 @@ var MiniLoader = ({
   intervalMs = 120
 }) => {
   const [frame, setFrame] = useState(0);
-  useEffect(() => {
+  useMountEffect(() => {
     const timer = setInterval(() => setFrame((f) => (f + 1) % 1e3), intervalMs);
     return () => clearInterval(timer);
-  }, [intervalMs]);
+  });
   const segments = [];
   let current = null;
   for (let c = 0; c < MINI_COLS; c++) {
@@ -7043,6 +7297,7 @@ var MiniLoader = ({
 var Pattern = ({
   accent,
   frame,
+  cols,
   overlay
 }) => {
   const overlayStart = overlay ? overlay.col : -1;
@@ -7051,7 +7306,7 @@ var Pattern = ({
     const segments = [];
     let current = null;
     const isOverlayRow = overlay && r === overlay.row;
-    for (let c = 0; c < PATTERN_COLS; c++) {
+    for (let c = 0; c < cols; c++) {
       let char;
       let color;
       if (isOverlayRow && c >= overlayStart && c < overlayEnd) {
@@ -7099,13 +7354,13 @@ var shimmerColor = (index, head, cycleLen, accent) => {
 };
 var Shimmer = ({ text, accent }) => {
   const [head, setHead] = useState(0);
-  useEffect(() => {
+  useMountEffect(() => {
     const cycleLen2 = text.length + SHIMMER_GAP;
     const timer = setInterval(() => {
       setHead((h) => (h + 1) % cycleLen2);
     }, SHIMMER_INTERVAL_MS);
     return () => clearInterval(timer);
-  }, [text.length]);
+  });
   const cycleLen = text.length + SHIMMER_GAP;
   const segments = [];
   let current = null;
@@ -7122,6 +7377,14 @@ var Shimmer = ({ text, accent }) => {
   if (current) segments.push(current);
   return /* @__PURE__ */ jsx(Text, { children: segments.map((s, i) => /* @__PURE__ */ jsx(Text, { color: toInkColor(s.color), children: s.text }, i)) });
 };
+var AnimatedPattern = ({ accent, cols, overlay }) => {
+  const [frame, setFrame] = useState(0);
+  useMountEffect(() => {
+    const timer = setInterval(() => setFrame((f) => (f + 1) % 1e3), 120);
+    return () => clearInterval(timer);
+  });
+  return /* @__PURE__ */ jsx(Pattern, { accent, frame, cols, overlay });
+};
 var HeroCard = ({
   target,
   isLocal,
@@ -7130,18 +7393,21 @@ var HeroCard = ({
   checksTotal,
   grade,
   score,
-  gradeColor
+  gradeColor,
+  width = DEFAULT_CARD_WIDTH
 }) => {
-  const [frame, setFrame] = useState(0);
-  useEffect(() => {
-    if (phase === "done" || phase === "error") return;
-    const timer = setInterval(() => setFrame((f) => (f + 1) % 1e3), 120);
-    return () => clearInterval(timer);
-  }, [phase]);
+  const cols = width - 4;
   const accent = phase === "done" && gradeColor ? gradeColor : ACCENT_BY_PHASE[phase];
   const status = STATUS_BY_PHASE(phase, isLocal, checksDone, checksTotal);
-  const targetLabel = truncate(target, PATTERN_COLS);
+  const targetLabel = truncate(target, cols);
   const showGrade = phase === "done" && grade !== void 0 && score !== void 0;
+  const isActive = phase !== "done" && phase !== "error";
+  const overlay = {
+    row: PATTERN_ROWS - 1,
+    col: cols - "agentimization".length - 1,
+    chars: Array.from(" agentimization"),
+    color: accent
+  };
   return /* @__PURE__ */ jsxs(
     Box,
     {
@@ -7149,21 +7415,9 @@ var HeroCard = ({
       borderStyle: "round",
       borderColor: dim(accent, FRAME_INNER_FACTOR),
       paddingX: 1,
-      width: CARD_WIDTH,
+      width,
       children: [
-        /* @__PURE__ */ jsx(
-          Pattern,
-          {
-            accent,
-            frame,
-            overlay: {
-              row: PATTERN_ROWS - 1,
-              col: PATTERN_COLS - "agentimization".length - 1,
-              chars: Array.from(" agentimization"),
-              color: accent
-            }
-          }
-        ),
+        isActive ? /* @__PURE__ */ jsx(AnimatedPattern, { accent, cols, overlay }) : /* @__PURE__ */ jsx(Pattern, { accent, frame: 0, cols, overlay }),
         /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { children: targetLabel }) }),
         /* @__PURE__ */ jsx(Box, { marginTop: 1, children: showGrade ? /* @__PURE__ */ jsxs(Fragment, { children: [
           /* @__PURE__ */ jsx(Text, { color: toInkColor(accent), children: grade }),
@@ -7176,7 +7430,7 @@ var HeroCard = ({
             "   ",
             status
           ] })
-        ] }) : /* @__PURE__ */ jsx(Shimmer, { text: status, accent }) })
+        ] }) : /* @__PURE__ */ jsx(Shimmer, { text: status, accent }, status) })
       ]
     }
   );
@@ -7222,7 +7476,7 @@ var ACCENT_BLUE = "oklch(0.766 0.111 259.9)";
 var TEXT_DIM = "oklch(0.550 0.034 277.1)";
 
 // src/ui/result-card.tsx
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 var SCORE_PAIRS = {
   pass: { bright: "oklch(0.858 0.109 142.7)", dim: "oklch(0.584 0.102 139.1)" },
   warn: { bright: "oklch(0.824 0.101 52.6)", dim: "oklch(0.572 0.072 53.0)" },
@@ -7230,8 +7484,7 @@ var SCORE_PAIRS = {
   empty: { bright: "oklch(0.404 0.032 280.2)", dim: "oklch(0.324 0.032 282.0)" }
 };
 var RESULT_CARD_WIDTH = 46;
-var RESULT_BAR_WIDTH = RESULT_CARD_WIDTH - 4;
-var SCORE_FIELD_ROWS = 2;
+var SCORE_FIELD_ROWS = 1;
 var SCORE_GLYPHS = ["\u2591", "\u2592", "\u2593", "\u2588"];
 var scoreCell = (row, col) => {
   const v = (row * 7 + col * 13) % 17;
@@ -7242,16 +7495,18 @@ var scoreCell = (row, col) => {
 var ScoreField = ({
   passWidth,
   warnWidth,
-  failWidth
+  failWidth,
+  barWidth
 }) => {
+  const emptyWidth = Math.max(0, barWidth - passWidth - warnWidth - failWidth);
   const colorAtCol = (col, bright) => {
-    const pair = col < passWidth ? SCORE_PAIRS.pass : col < passWidth + warnWidth ? SCORE_PAIRS.warn : col < passWidth + warnWidth + failWidth ? SCORE_PAIRS.fail : SCORE_PAIRS.empty;
+    const pair = col < emptyWidth ? SCORE_PAIRS.empty : col < emptyWidth + passWidth ? SCORE_PAIRS.pass : col < emptyWidth + passWidth + warnWidth ? SCORE_PAIRS.warn : SCORE_PAIRS.fail;
     return bright ? pair.bright : pair.dim;
   };
   return /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: Array.from({ length: SCORE_FIELD_ROWS }, (_, r) => {
     const segments = [];
     let current = null;
-    for (let c = 0; c < RESULT_BAR_WIDTH; c++) {
+    for (let c = 0; c < barWidth; c++) {
       const cell = scoreCell(r, c);
       const color = colorAtCol(c, cell.bright);
       if (current && current.color === color) {
@@ -7265,15 +7520,21 @@ var ScoreField = ({
     return /* @__PURE__ */ jsx2(Text2, { children: segments.map((s, i) => /* @__PURE__ */ jsx2(Text2, { color: toInkColor(s.color), children: s.text }, i)) }, r);
   }) });
 };
-var ResultCard = ({ result, target }) => {
+var ResultCard = ({
+  result,
+  target,
+  width = RESULT_CARD_WIDTH
+}) => {
   const { grade, overall_score, summary, latency_ms } = result;
   const gc = GRADE_COLORS[grade] ?? "red";
+  const barWidth = width - 4;
   const total = summary.total || 1;
-  const passWidth = Math.max(Math.round(summary.passed / total * RESULT_BAR_WIDTH), summary.passed > 0 ? 1 : 0);
-  const warnWidth = Math.max(Math.round(summary.warned / total * RESULT_BAR_WIDTH), summary.warned > 0 ? 1 : 0);
-  const failWidth = Math.max(Math.round(summary.failed / total * RESULT_BAR_WIDTH), summary.failed > 0 ? 1 : 0);
+  const passWidth = Math.max(Math.round(summary.passed / total * barWidth), summary.passed > 0 ? 1 : 0);
+  const warnWidth = Math.max(Math.round(summary.warned / total * barWidth), summary.warned > 0 ? 1 : 0);
+  const failWidth = Math.max(Math.round(summary.failed / total * barWidth), summary.failed > 0 ? 1 : 0);
   const seconds = (latency_ms / 1e3).toFixed(1);
-  const targetMax = RESULT_BAR_WIDTH;
+  const headerChrome = `${grade} ${overall_score}/100`.length + 3 + 3 + `${seconds}s`.length;
+  const targetMax = Math.max(8, barWidth - headerChrome);
   const targetLabel = target.length <= targetMax ? target : target.slice(0, targetMax - 1) + "\u2026";
   return /* @__PURE__ */ jsxs2(
     Box2,
@@ -7283,7 +7544,7 @@ var ResultCard = ({ result, target }) => {
       borderStyle: "round",
       borderColor: dim(gc, FRAME_INNER_FACTOR),
       paddingX: 1,
-      width: RESULT_CARD_WIDTH,
+      width,
       children: [
         /* @__PURE__ */ jsxs2(Box2, { children: [
           /* @__PURE__ */ jsx2(Text2, { color: toInkColor(gc), children: grade }),
@@ -7292,22 +7553,34 @@ var ResultCard = ({ result, target }) => {
             overall_score,
             "/100"
           ] }),
+          /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+            "   ",
+            targetLabel
+          ] }),
           /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
             "   ",
             seconds,
             "s"
           ] })
         ] }),
-        /* @__PURE__ */ jsx2(Text2, { children: targetLabel }),
         /* @__PURE__ */ jsx2(Box2, { marginTop: 1, children: /* @__PURE__ */ jsx2(
           ScoreField,
           {
             passWidth,
             warnWidth,
-            failWidth
+            failWidth,
+            barWidth
           }
         ) }),
         /* @__PURE__ */ jsxs2(Box2, { marginTop: 1, children: [
+          summary.skipped > 0 ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
+            /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+              STATUS_ICONS.skip,
+              " ",
+              summary.skipped
+            ] }),
+            /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "   " })
+          ] }) : null,
           /* @__PURE__ */ jsxs2(Text2, { color: toInkColor(SCORE_PAIRS.pass.bright), children: [
             STATUS_ICONS.pass,
             " ",
@@ -7324,12 +7597,6 @@ var ResultCard = ({ result, target }) => {
             STATUS_ICONS.fail,
             " ",
             summary.failed
-          ] }),
-          /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "   " }),
-          /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
-            STATUS_ICONS.skip,
-            " ",
-            summary.skipped
           ] })
         ] })
       ]
@@ -7363,14 +7630,13 @@ var CheckLine = ({ check, loaderColor }) => {
           r.id
         ] })
       ] }),
-      /* @__PURE__ */ jsxs3(Text3, { dimColor: true, children: [
-        "    ",
-        r.message
-      ] }),
-      showSuggestion ? /* @__PURE__ */ jsxs3(Text3, { color: toInkColor("oklch(0.858 0.109 142.7)"), children: [
-        "    \u2192 ",
-        r.suggestion
-      ] }) : null
+      /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", paddingLeft: 2, children: [
+        /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: r.message }),
+        showSuggestion ? /* @__PURE__ */ jsxs3(Text3, { color: toInkColor("oklch(0.858 0.109 142.7)"), children: [
+          "\u2192 ",
+          r.suggestion
+        ] }) : null
+      ] })
     ] });
   }
   return null;
@@ -7551,7 +7817,7 @@ var copyToClipboard = async (text) => {
 // src/ui/action-menu.tsx
 import { writeFileSync } from "fs";
 import { resolve } from "path";
-import { Fragment as Fragment2, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var FEEDBACK_OK = "oklch(0.858 0.109 142.7)";
 var FEEDBACK_ERR = "oklch(0.718 0.181 10.0)";
 var buildMenuOptions = (hasIssues) => [
@@ -7679,7 +7945,7 @@ var ActionMenu = ({
         ] }) : null
       ] }, opt.value);
     }) }),
-    feedback ? /* @__PURE__ */ jsxs4(Fragment2, { children: [
+    feedback ? /* @__PURE__ */ jsxs4(Fragment3, { children: [
       /* @__PURE__ */ jsx4(Box4, { marginTop: 1, paddingLeft: 2, children: /* @__PURE__ */ jsx4(Text4, { color: toInkColor(feedback.startsWith("\u2713") ? FEEDBACK_OK : FEEDBACK_ERR), children: feedback }) }),
       /* @__PURE__ */ jsx4(Box4, { height: 1, children: /* @__PURE__ */ jsx4(Text4, { children: " " }) })
     ] }) : null
@@ -7812,7 +8078,7 @@ var resolveTarget = (input) => {
 };
 
 // src/ui/app.tsx
-import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 var App = ({
   target: initialTarget,
   isLocal: initialIsLocal,
@@ -7822,22 +8088,95 @@ var App = ({
 }) => {
   const [target, setTarget] = useState4(initialTarget);
   const [isLocal, setIsLocal] = useState4(initialIsLocal);
+  const [retryError, setRetryError] = useState4(null);
+  const { stdout } = useStdout();
+  const [columns, setColumns] = useState4(stdout?.columns ?? 80);
+  useMountEffect(() => {
+    if (!stdout) return;
+    const onResize = () => setColumns(stdout.columns);
+    stdout.on("resize", onResize);
+    return () => {
+      stdout.off("resize", onResize);
+    };
+  });
+  const cardWidth = Math.max(40, Math.min(columns - 2, 72));
+  const handleRetry = (newInput) => {
+    const resolved = resolveTarget(newInput);
+    if ("error" in resolved) {
+      setRetryError(resolved.error);
+      return;
+    }
+    setRetryError(null);
+    setTarget(resolved.target);
+    setIsLocal(resolved.isLocal);
+  };
+  if (retryError) {
+    return /* @__PURE__ */ jsx6(ErrorCard, { message: retryError, target, cardWidth, onRetry: handleRetry });
+  }
+  return /* @__PURE__ */ jsx6(
+    AuditRunner,
+    {
+      target,
+      isLocal,
+      categories,
+      sampleSize,
+      autoDetectedFrom,
+      cardWidth,
+      onRetry: handleRetry
+    },
+    `${target}|${isLocal}`
+  );
+};
+var ErrorCard = ({
+  message,
+  target,
+  cardWidth,
+  onRetry
+}) => {
+  const errorColor = "oklch(0.718 0.181 10.0)";
+  const lines = message.split("\n");
+  return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", paddingLeft: 1, children: [
+    /* @__PURE__ */ jsxs6(
+      Box6,
+      {
+        flexDirection: "column",
+        marginTop: 1,
+        borderStyle: "round",
+        borderColor: dim(errorColor, FRAME_INNER_FACTOR),
+        paddingX: 1,
+        width: cardWidth,
+        children: [
+          /* @__PURE__ */ jsx6(Text6, { bold: true, color: toInkColor(errorColor), children: "Error" }),
+          /* @__PURE__ */ jsx6(Text6, { children: target }),
+          /* @__PURE__ */ jsx6(Box6, { marginTop: 1, flexDirection: "column", children: lines.map((line, i) => /* @__PURE__ */ jsx6(Text6, { dimColor: i > 0, children: line }, i)) })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx6(ErrorActions, { onRetry })
+  ] });
+};
+var AuditRunner = ({
+  target,
+  isLocal,
+  categories,
+  sampleSize,
+  autoDetectedFrom,
+  cardWidth,
+  onRetry
+}) => {
   const [phase, setPhase] = useState4("init");
   const [checks, setChecks] = useState4([]);
   const [result, setResult] = useState4(null);
   const [error, setError] = useState4(null);
   const [networkSkipped, setNetworkSkipped] = useState4(0);
-  useEffect2(() => {
+  useMountEffect(() => {
     const onEvent = (event) => {
       switch (event.type) {
         case "phase":
           setPhase(event.phase);
           break;
         case "check-start":
-          setChecks((prev) => [
-            ...prev,
-            { ...event.check, status: "running" }
-          ]);
+          setChecks((prev) => [...prev, { ...event.check, status: "running" }]);
           break;
         case "check-complete":
           setChecks(
@@ -7868,89 +8207,69 @@ var App = ({
       }
     };
     run();
-  }, [target, isLocal, categories, sampleSize]);
-  const handleRetry = (newInput) => {
-    const resolved = resolveTarget(newInput);
-    if ("error" in resolved) {
-      setError(resolved.error);
-      return;
-    }
-    setError(null);
-    setResult(null);
-    setChecks([]);
-    setNetworkSkipped(0);
-    setPhase("init");
-    setTarget(resolved.target);
-    setIsLocal(resolved.isLocal);
-  };
+  });
   const checksByCategory = /* @__PURE__ */ new Map();
   for (const check of checks) {
     const existing = checksByCategory.get(check.category) ?? [];
     existing.push(check);
     checksByCategory.set(check.category, existing);
   }
+  const categoryEntries = [...checksByCategory.entries()];
+  const committedCount = phase === "done" ? categoryEntries.length : Math.max(0, categoryEntries.length - 1);
+  const committedCategories = categoryEntries.slice(0, committedCount);
+  const liveCategory = categoryEntries[committedCount];
   if (phase === "error") {
-    const errorColor = "oklch(0.718 0.181 10.0)";
-    const lines = (error ?? "Unknown error").split("\n");
-    return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", paddingLeft: 1, children: [
-      /* @__PURE__ */ jsxs6(
-        Box6,
-        {
-          flexDirection: "column",
-          marginTop: 1,
-          borderStyle: "round",
-          borderColor: dim(errorColor, FRAME_INNER_FACTOR),
-          paddingX: 1,
-          width: RESULT_CARD_WIDTH,
-          children: [
-            /* @__PURE__ */ jsx6(Text6, { bold: true, color: toInkColor(errorColor), children: "Error" }),
-            /* @__PURE__ */ jsx6(Text6, { children: target }),
-            /* @__PURE__ */ jsx6(Box6, { marginTop: 1, flexDirection: "column", children: lines.map((line, i) => /* @__PURE__ */ jsx6(Text6, { dimColor: i > 0, children: line }, i)) })
-          ]
-        }
-      ),
-      /* @__PURE__ */ jsx6(ErrorActions, { onRetry: handleRetry })
-    ] });
-  }
-  const checksDone = checks.filter((c) => c.status === "done").length;
-  const accent = result ? GRADE_COLORS[result.grade] ?? ACCENT_BY_PHASE[phase] : ACCENT_BY_PHASE[phase];
-  return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", paddingLeft: 1, children: [
-    /* @__PURE__ */ jsx6(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx6(
-      HeroCard,
+    return /* @__PURE__ */ jsx6(
+      ErrorCard,
       {
+        message: error ?? "Unknown error",
         target,
-        isLocal,
-        phase,
-        checksDone,
-        checksTotal: checks.length,
-        grade: result?.grade,
-        score: result?.overall_score,
-        gradeColor: result ? GRADE_COLORS[result.grade] : void 0
+        cardWidth,
+        onRetry
       }
-    ) }),
-    autoDetectedFrom ? /* @__PURE__ */ jsxs6(Text6, { dimColor: true, children: [
-      "auto-detected build output (was ",
-      autoDetectedFrom,
-      ")"
-    ] }) : null,
-    isLocal && networkSkipped > 0 && phase === "done" ? /* @__PURE__ */ jsxs6(Text6, { dimColor: true, children: [
-      networkSkipped,
-      " network-only checks skipped"
-    ] }) : null,
-    checks.length > 0 ? /* @__PURE__ */ jsx6(Box6, { flexDirection: "column", children: [...checksByCategory.entries()].map(([cat, catChecks]) => /* @__PURE__ */ jsx6(
-      CategorySection,
-      {
-        category: cat,
-        checks: catChecks,
-        score: result?.categories[cat]?.score,
-        loaderColor: accent
-      },
-      cat
-    )) }) : null,
-    result ? /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", children: [
-      /* @__PURE__ */ jsx6(ResultCard, { result, target }),
-      /* @__PURE__ */ jsx6(ActionMenu, { result, target, isLocal, onRetry: handleRetry })
-    ] }) : null
+    );
+  }
+  const checksDone = checks.filter((c) => c.status === "done").length;
+  const accent = result ? GRADE_COLORS[result.grade] ?? ACCENT_BY_PHASE[phase] : ACCENT_BY_PHASE[phase];
+  return /* @__PURE__ */ jsxs6(Fragment4, { children: [
+    /* @__PURE__ */ jsx6(Static, { items: committedCategories, children: ([cat, catChecks]) => /* @__PURE__ */ jsx6(Box6, { paddingLeft: 1, children: /* @__PURE__ */ jsx6(CategorySection, { category: cat, checks: catChecks, loaderColor: accent }) }, cat) }),
+    /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", paddingLeft: 1, children: [
+      /* @__PURE__ */ jsx6(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx6(
+        HeroCard,
+        {
+          target,
+          isLocal,
+          phase,
+          checksDone,
+          checksTotal: checks.length,
+          grade: result?.grade,
+          score: result?.overall_score,
+          gradeColor: result ? GRADE_COLORS[result.grade] : void 0,
+          width: cardWidth
+        }
+      ) }),
+      autoDetectedFrom ? /* @__PURE__ */ jsxs6(Text6, { dimColor: true, children: [
+        "auto-detected build output (was ",
+        autoDetectedFrom,
+        ")"
+      ] }) : null,
+      isLocal && networkSkipped > 0 && phase === "done" ? /* @__PURE__ */ jsxs6(Text6, { dimColor: true, children: [
+        networkSkipped,
+        " network-only checks skipped"
+      ] }) : null,
+      liveCategory ? /* @__PURE__ */ jsx6(
+        CategorySection,
+        {
+          category: liveCategory[0],
+          checks: liveCategory[1],
+          loaderColor: accent
+        }
+      ) : null,
+      result ? /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsx6(ResultCard, { result, target, width: cardWidth }),
+        /* @__PURE__ */ jsx6(ActionMenu, { result, target, isLocal, onRetry })
+      ] }) : null
+    ] })
   ] });
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentimization",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "GEO audit CLI — check if your website is agent-ready",
   "license": "MIT",
   "author": "Anthony Lio <hello@antl.io>",