agentimization 0.1.0 → 0.1.2

package/dist/index.js

@@ -9,7 +9,6 @@ var __export = (target, all) => {
 import { Command } from "commander";
 import { render } from "ink";
 import React2 from "react";
-import { resolve as resolve3 } from "path";
 
 // ../../node_modules/zod/v3/external.js
 var external_exports = {};
@@ -4052,7 +4051,9 @@ var coerce = {
 };
 var NEVER = INVALID;
 
-// node_modules/@agentimization/core/node_modules/@agentimization/shared/dist/types.js
+// node_modules/@agentimization/core/dist/index.js
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { dirname, join, relative, extname } from "path";
 var CHECK_STATUSES = ["pass", "warn", "fail", "skip", "info"];
 var CHECK_CATEGORIES = [
   "content-discoverability",
@@ -4104,8 +4105,6 @@ var DEFAULT_CONFIG = {
   onEvent: () => {
   }
 };
-
-// node_modules/@agentimization/core/dist/checks/content-discoverability.js
 var llmsTxtExists = {
   id: "llms-txt-exists",
   name: "llms.txt Exists",
@@ -4151,17 +4150,13 @@ var llmsTxtValid = {
     const issues = [];
     const lines = ctx.llmsTxt.split("\n");
     const hasH1 = lines.some((l) => /^#\s+/.test(l));
-    if (!hasH1)
-      issues.push("Missing H1 title");
+    if (!hasH1) issues.push("Missing H1 title");
     const hasBlockquote = lines.some((l) => /^>\s+/.test(l));
-    if (!hasBlockquote)
-      issues.push("Missing blockquote description");
+    if (!hasBlockquote) issues.push("Missing blockquote description");
     const hasHeadingSections = lines.some((l) => /^##\s+/.test(l));
-    if (!hasHeadingSections)
-      issues.push("Missing ## section headings");
+    if (!hasHeadingSections) issues.push("Missing ## section headings");
     const hasLinks = /\[.+\]\(.+\)/.test(ctx.llmsTxt);
-    if (!hasLinks)
-      issues.push("No markdown links found");
+    if (!hasLinks) issues.push("No markdown links found");
     if (issues.length === 0) {
       return {
         id: "llms-txt-valid",
@@ -4245,8 +4240,7 @@ var llmsTxtFreshness = {
       };
     }
     const sharedRegistrable = (a, b) => {
-      if (a === b)
-        return true;
+      if (a === b) return true;
       const aParts = a.split(".");
       const bParts = b.split(".");
       const tail = (parts) => parts.slice(-2).join(".");
@@ -4255,8 +4249,7 @@ var llmsTxtFreshness = {
     const keyFor = (raw) => {
       try {
         const u = new URL(raw, ctx.baseUrl.origin);
-        if (!sharedRegistrable(u.hostname, ctx.baseUrl.hostname))
-          return null;
+        if (!sharedRegistrable(u.hostname, ctx.baseUrl.hostname)) return null;
         let path = u.pathname.length > 1 ? u.pathname.replace(/\/+$/, "") : u.pathname;
         path = path.replace(/\.(md|mdx|markdown)$/i, "");
         return path.toLowerCase();
@@ -4269,14 +4262,12 @@ var llmsTxtFreshness = {
     let match;
     while ((match = linkRegex.exec(ctx.llmsTxt)) !== null) {
       const k = keyFor(match[1]);
-      if (k)
-        llmsKeys.add(k);
+      if (k) llmsKeys.add(k);
     }
     const sitemapKeys = /* @__PURE__ */ new Set();
     for (const u of ctx.sitemapUrls) {
       const k = keyFor(u);
-      if (k)
-        sitemapKeys.add(k);
+      if (k) sitemapKeys.add(k);
     }
     if (sitemapKeys.size === 0 || llmsKeys.size === 0) {
       return {
@@ -4361,11 +4352,15 @@ var llmsTxtLinksResolve = {
       };
     }
     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;
+    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-txt-links-resolve",
@@ -4527,9 +4522,10 @@ var robotsTxtAgentRules = {
         currentAgent = agentMatch[1].trim();
         continue;
       }
-      const matchedAgent = aiAgents.find((a) => currentAgent === a || currentAgent === "*");
-      if (!matchedAgent)
-        continue;
+      const matchedAgent = aiAgents.find(
+        (a) => currentAgent === a || currentAgent === "*"
+      );
+      if (!matchedAgent) continue;
       if (/^Disallow:\s*\/\s*$/i.test(line) && currentAgent !== "*") {
         blocked.push(currentAgent);
       } else if (/^Allow:\s*\//i.test(line) && currentAgent !== "*") {
@@ -4567,8 +4563,6 @@ var contentDiscoverabilityChecks = [
   sitemapExists,
   robotsTxtAgentRules
 ];
-
-// node_modules/@agentimization/core/dist/utils/fetch.js
 var makeHeaders = (config) => ({
   "User-Agent": config.userAgent ?? DEFAULT_CONFIG.userAgent,
   Accept: "text/html,application/xhtml+xml,text/markdown,text/plain,*/*"
@@ -4638,7 +4632,9 @@ var fetchMany = async (urls, config = {}) => {
   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)));
+    const chunkResults = await Promise.allSettled(
+      chunk.map((url) => fetchPage(url, config))
+    );
     for (const result of chunkResults) {
       if (result.status === "fulfilled") {
         results.push(result.value);
@@ -4647,8 +4643,6 @@ var fetchMany = async (urls, config = {}) => {
   }
   return results;
 };
-
-// node_modules/@agentimization/core/dist/checks/markdown-availability.js
 var markdownUrlSupport = {
   id: "markdown-url-support",
   name: "Markdown URL Support",
@@ -4766,8 +4760,7 @@ var markdownContentParity = {
     let totalMissing = 0;
     let checked = 0;
     for (const page of pagesWithMarkdown) {
-      if (!page.markdown)
-        continue;
+      if (!page.markdown) continue;
       checked++;
       const htmlText = page.html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
       const htmlWords = new Set(htmlText.toLowerCase().split(/\s+/).filter((w) => w.length > 3));
@@ -4803,8 +4796,6 @@ var markdownAvailabilityChecks = [
   contentNegotiation,
   markdownContentParity
 ];
-
-// node_modules/@agentimization/core/dist/utils/html.js
 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 = [];
@@ -4824,11 +4815,11 @@ var extractMetaTags = (html) => {
   const metaRegex = /<meta[^>]+(?:name|property)=["']([^"']+)["'][^>]+content=["']([^"']+)["']/gi;
   let match;
   while ((match = metaRegex.exec(html)) !== null) {
-    meta[match[1]] = match[2];
+    meta[match[1].toLowerCase()] = match[2];
   }
   const metaRegex2 = /<meta[^>]+content=["']([^"']+)["'][^>]+(?:name|property)=["']([^"']+)["']/gi;
   while ((match = metaRegex2.exec(html)) !== null) {
-    meta[match[2]] = match[1];
+    meta[match[2].toLowerCase()] = match[1];
   }
   return meta;
 };
@@ -4844,6 +4835,24 @@ var extractJsonLd = (html) => {
   }
   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;
@@ -4912,8 +4921,6 @@ var parseSitemapUrls = (xml) => {
   }
   return urls;
 };
-
-// node_modules/@agentimization/core/dist/checks/page-size.js
 var MAX_HTML_CHARS = 5e4;
 var MAX_MD_CHARS = 5e4;
 var renderingStrategy = {
@@ -4935,8 +4942,7 @@ var renderingStrategy = {
     }
     let ssrCount = 0;
     for (const page of pages) {
-      if (hasServerRenderedContent(page.html))
-        ssrCount++;
+      if (hasServerRenderedContent(page.html)) ssrCount++;
     }
     if (ssrCount === pages.length) {
       return {
@@ -4958,6 +4964,53 @@ var renderingStrategy = {
     };
   }
 };
+var substantialTextContent = {
+  id: "substantial-text-content",
+  name: "Substantial Text Content",
+  category: "page-size",
+  description: "Checks for at least 100 words of readable body text",
+  weight: 0.8,
+  run: async (ctx) => {
+    const pages = ctx.sampledPages.slice(0, 10);
+    if (pages.length === 0) {
+      return {
+        id: "substantial-text-content",
+        name: "Substantial Text Content",
+        category: "page-size",
+        status: "skip",
+        message: "No pages sampled"
+      };
+    }
+    let withSubstantialContent = 0;
+    let totalWords = 0;
+    for (const page of pages) {
+      const text = stripHtml(page.html);
+      const words = text.split(/\s+/).filter((w) => w.length > 0).length;
+      totalWords += words;
+      if (words >= 100) withSubstantialContent++;
+    }
+    const avgWords = Math.round(totalWords / pages.length);
+    if (withSubstantialContent === pages.length) {
+      return {
+        id: "substantial-text-content",
+        name: "Substantial Text Content",
+        category: "page-size",
+        status: "pass",
+        message: `All ${pages.length} pages have \u2265100 words of body text (avg ${avgWords})`,
+        metadata: { withSubstantialContent, avgWords }
+      };
+    }
+    return {
+      id: "substantial-text-content",
+      name: "Substantial Text Content",
+      category: "page-size",
+      status: withSubstantialContent > 0 ? "warn" : "fail",
+      message: `${withSubstantialContent}/${pages.length} pages have \u2265100 words of body text (avg ${avgWords})`,
+      suggestion: "Generative engines can't cite pages that are mostly images or short copy. Add at least 100 words of substantive text content per page.",
+      metadata: { withSubstantialContent, avgWords }
+    };
+  }
+};
 var pageSizeHtml = {
   id: "page-size-html",
   name: "Page Size (HTML)",
@@ -5049,7 +5102,7 @@ var contentStartPosition = {
   id: "content-start-position",
   name: "Content Start Position",
   category: "page-size",
-  description: "Checks if main content starts within the first 10% of the HTML",
+  description: "Checks how soon main content starts relative to total HTML",
   weight: 0.5,
   run: async (ctx) => {
     const pages = ctx.sampledPages.slice(0, 10);
@@ -5066,15 +5119,16 @@ var contentStartPosition = {
       url: p.url,
       position: findContentStartPosition(p.html)
     }));
-    const earlyStart = positions.filter((p) => p.position <= 0.1);
-    const medianPct = Math.round(positions.map((p) => p.position).sort((a, b) => a - b)[Math.floor(positions.length / 2)] * 100);
-    if (earlyStart.length === pages.length) {
+    const medianPct = Math.round(
+      positions.map((p) => p.position).sort((a, b) => a - b)[Math.floor(positions.length / 2)] * 100
+    );
+    if (medianPct <= 30) {
       return {
         id: "content-start-position",
         name: "Content Start Position",
         category: "page-size",
         status: "pass",
-        message: `Content starts within first 10% on all ${pages.length} sampled pages (median ${medianPct}%)`,
+        message: `content starts at ${medianPct}% of html (median over ${pages.length} pages)`,
         metadata: { medianPct }
       };
     }
@@ -5082,21 +5136,20 @@ var contentStartPosition = {
       id: "content-start-position",
       name: "Content Start Position",
       category: "page-size",
-      status: "warn",
-      message: `Content starts late on ${pages.length - earlyStart.length}/${pages.length} pages (median ${medianPct}%)`,
-      suggestion: "Move main content higher in the HTML. AI agents may waste context window tokens on navigation, headers, and boilerplate before reaching actual content.",
-      metadata: { medianPct, earlyStart: earlyStart.length }
+      status: medianPct <= 50 ? "warn" : "fail",
+      message: `content starts at ${medianPct}% of html (median over ${pages.length} pages)`,
+      suggestion: "trim head metadata or move main content higher in the html so ai agents do not waste context tokens on boilerplate before reaching real content.",
+      metadata: { medianPct }
     };
   }
 };
 var pageSizeChecks = [
   renderingStrategy,
+  substantialTextContent,
   pageSizeHtml,
   pageSizeMarkdown,
   contentStartPosition
 ];
-
-// node_modules/@agentimization/core/dist/checks/content-structure.js
 var markdownCodeFenceValidity = {
   id: "markdown-code-fence-validity",
   name: "Markdown Code Fence Validity",
@@ -5111,8 +5164,7 @@ var markdownCodeFenceValidity = {
       for (const page of ctx.sampledPages.slice(0, 10)) {
         const codeBlockRegex = /<code[\s\S]*?<\/code>/gi;
         const matches = page.html.match(codeBlockRegex);
-        if (matches)
-          totalFences2 += matches.length;
+        if (matches) totalFences2 += matches.length;
       }
       if (totalFences2 === 0) {
         return {
@@ -5178,8 +5230,7 @@ var sectionHeaderQuality = {
     const issues = [];
     for (const page of pages) {
       const headings = extractHeadings(page.html);
-      if (headings.length === 0)
-        continue;
+      if (headings.length === 0) continue;
       let pageGood = true;
       const hasH1 = headings.some((h) => h.level === 1);
       if (!hasH1) {
@@ -5197,8 +5248,7 @@ var sectionHeaderQuality = {
           break;
         }
       }
-      if (pageGood)
-        goodPages++;
+      if (pageGood) goodPages++;
     }
     if (goodPages === pages.length) {
       return {
@@ -5267,13 +5317,103 @@ var tabbedContentSerialization = {
     };
   }
 };
+var imageAltText = {
+  id: "image-alt-text",
+  name: "Image Alt Text Coverage",
+  category: "content-structure",
+  description: "Checks that at least 50% of images have descriptive alt text",
+  weight: 0.5,
+  run: async (ctx) => {
+    const pages = ctx.sampledPages.slice(0, 10);
+    if (pages.length === 0) {
+      return {
+        id: "image-alt-text",
+        name: "Image Alt Text Coverage",
+        category: "content-structure",
+        status: "skip",
+        message: "No pages sampled"
+      };
+    }
+    const allImages = pages.flatMap((p) => extractImages(p.html));
+    const contentImages = allImages.filter((img) => img.alt === void 0 || img.alt.trim().length > 0);
+    const decorativeImages = allImages.length - contentImages.length;
+    const withAlt = contentImages.filter((img) => img.alt !== void 0 && img.alt.trim().length > 0).length;
+    if (allImages.length === 0) {
+      return {
+        id: "image-alt-text",
+        name: "Image Alt Text Coverage",
+        category: "content-structure",
+        status: "info",
+        message: `No images found across ${pages.length} sampled pages`
+      };
+    }
+    if (contentImages.length === 0) {
+      return {
+        id: "image-alt-text",
+        name: "Image Alt Text Coverage",
+        category: "content-structure",
+        status: "info",
+        message: `All ${allImages.length} sampled images are decorative (alt="")`,
+        metadata: { decorativeImages, totalImages: allImages.length }
+      };
+    }
+    const ratio = withAlt / contentImages.length;
+    const pct = Math.round(ratio * 100);
+    const summary = `${withAlt}/${contentImages.length} content images have descriptive alt text (${pct}%)${decorativeImages > 0 ? `; ${decorativeImages} decorative skipped` : ""}`;
+    if (ratio >= 0.5) {
+      return {
+        id: "image-alt-text",
+        name: "Image Alt Text Coverage",
+        category: "content-structure",
+        status: "pass",
+        message: summary,
+        metadata: { withAlt, contentImages: contentImages.length, decorativeImages, pct }
+      };
+    }
+    return {
+      id: "image-alt-text",
+      name: "Image Alt Text Coverage",
+      category: "content-structure",
+      status: ratio >= 0.25 ? "warn" : "fail",
+      message: summary,
+      suggestion: `Add descriptive alt text to at least 50% of content images. AI agents and screen readers rely on alt text to understand visual content. Mark purely decorative images with alt="" so they don't dilute the ratio.`,
+      metadata: { withAlt, contentImages: contentImages.length, decorativeImages, pct }
+    };
+  }
+};
 var contentStructureChecks = [
   markdownCodeFenceValidity,
   sectionHeaderQuality,
-  tabbedContentSerialization
+  tabbedContentSerialization,
+  imageAltText
 ];
-
-// node_modules/@agentimization/core/dist/checks/url-stability.js
+var httpsEnabled = {
+  id: "https-enabled",
+  name: "HTTPS Enabled",
+  category: "url-stability",
+  description: "Checks if the site is served over HTTPS",
+  weight: 0.7,
+  requiresNetwork: true,
+  run: async (ctx) => {
+    if (ctx.baseUrl.protocol === "https:") {
+      return {
+        id: "https-enabled",
+        name: "HTTPS Enabled",
+        category: "url-stability",
+        status: "pass",
+        message: "Site is served over HTTPS"
+      };
+    }
+    return {
+      id: "https-enabled",
+      name: "HTTPS Enabled",
+      category: "url-stability",
+      status: "fail",
+      message: `Site is served over ${ctx.baseUrl.protocol.replace(":", "")} \u2014 AI crawlers de-prioritize non-HTTPS sources`,
+      suggestion: "Serve your site over HTTPS. AI crawlers like GPTBot, ClaudeBot, and PerplexityBot strongly prefer HTTPS and may skip plain HTTP entirely."
+    };
+  }
+};
 var httpStatusCodes = {
   id: "http-status-codes",
   name: "HTTP Status Codes",
@@ -5290,8 +5430,7 @@ var httpStatusCodes = {
     for (const url of testUrls) {
       try {
         const resp = await fetch(url, { method: "GET", redirect: "follow" });
-        if (resp.status === 404)
-          proper404++;
+        if (resp.status === 404) proper404++;
       } catch {
       }
     }
@@ -5386,12 +5525,11 @@ var cacheHeaderHygiene = {
   }
 };
 var urlStabilityChecks = [
+  httpsEnabled,
   httpStatusCodes,
   redirectBehavior,
   cacheHeaderHygiene
 ];
-
-// node_modules/@agentimization/core/dist/checks/authentication.js
 var authGateDetection = {
   id: "auth-gate-detection",
   name: "Auth Gate Detection",
@@ -5439,7 +5577,9 @@ var authAlternativeAccess = {
   requiresNetwork: true,
   run: async (ctx) => {
     const pages = ctx.sampledPages.slice(0, 10);
-    const gated = pages.filter((p) => p.statusCode === 401 || p.statusCode === 403);
+    const gated = pages.filter(
+      (p) => p.statusCode === 401 || p.statusCode === 403
+    );
     if (gated.length === 0) {
       return {
         id: "auth-alternative-access",
@@ -5474,28 +5614,18 @@ var authenticationChecks = [
   authGateDetection,
   authAlternativeAccess
 ];
-
-// node_modules/@agentimization/core/dist/checks/geo-signals.js
 var detectFramework = (pages) => {
   for (const page of pages) {
     const xpb = (page.headers["x-powered-by"] ?? "").toLowerCase();
-    if (xpb.includes("next.js"))
-      return "next";
-    if (xpb.includes("nuxt"))
-      return "nuxt";
+    if (xpb.includes("next.js")) return "next";
+    if (xpb.includes("nuxt")) return "nuxt";
     const html = page.html;
-    if (/\/_next\/static\//.test(html) || /<script[^>]+id="__NEXT_DATA__"/.test(html))
-      return "next";
-    if (/__NUXT__\s*=/.test(html) || /\/_nuxt\//.test(html))
-      return "nuxt";
-    if (/data-sveltekit-/.test(html))
-      return "sveltekit";
-    if (/<meta\s+name="generator"\s+content="Astro/i.test(html))
-      return "astro";
-    if (/<meta\s+name="generator"\s+content="WordPress/i.test(html))
-      return "wordpress";
-    if (/\/build\/_assets\/.*\.js/.test(html) && /window\.__remixContext/.test(html))
-      return "remix";
+    if (/\/_next\/static\//.test(html) || /<script[^>]+id="__NEXT_DATA__"/.test(html)) return "next";
+    if (/__NUXT__\s*=/.test(html) || /\/_nuxt\//.test(html)) return "nuxt";
+    if (/data-sveltekit-/.test(html)) return "sveltekit";
+    if (/<meta\s+name="generator"\s+content="Astro/i.test(html)) return "astro";
+    if (/<meta\s+name="generator"\s+content="WordPress/i.test(html)) return "wordpress";
+    if (/\/build\/_assets\/.*\.js/.test(html) && /window\.__remixContext/.test(html)) return "remix";
   }
   return null;
 };
@@ -5508,8 +5638,7 @@ var FRAMEWORK_DOCS = {
   wordpress: "https://yoast.com/structured-data-with-schema-org-the-ultimate-guide/"
 };
 var frameworkHint = (fw) => {
-  if (fw && FRAMEWORK_DOCS[fw])
-    return ` See: ${FRAMEWORK_DOCS[fw]}`;
+  if (fw && FRAMEWORK_DOCS[fw]) return ` See: ${FRAMEWORK_DOCS[fw]}`;
   return " See: https://schema.org/docs/gs.html";
 };
 var structuredDataCoverage = {
@@ -5528,8 +5657,7 @@ var structuredDataCoverage = {
         withStructuredData++;
         for (const item of jsonLd) {
           const type = item?.["@type"];
-          if (typeof type === "string")
-            types.push(type);
+          if (typeof type === "string") types.push(type);
         }
       }
     }
@@ -5606,8 +5734,7 @@ var citationWorthiness = {
         signals.withLists++;
         pageCitable = true;
       }
-      if (pageCitable)
-        citablePages++;
+      if (pageCitable) citablePages++;
     }
     if (citablePages >= pages.length * 0.7) {
       return {
@@ -5640,9 +5767,10 @@ var topicalAuthoritySignals = {
     const pages = ctx.sampledPages.slice(0, 10);
     let totalInternalLinks = 0;
     let pagesWithGoodLinking = 0;
+    const resolveBase = ctx.mode === "local" ? ctx.baseUrl.href : ctx.baseUrl.origin;
     for (const page of pages) {
-      const links = extractLinks(page.html, ctx.baseUrl.origin);
-      const internalLinks = ctx.mode === "local" ? links.filter((l) => !l.startsWith("http://") && !l.startsWith("https://")) : links.filter((l) => {
+      const links = extractLinks(page.html, resolveBase);
+      const internalLinks = ctx.mode === "local" ? links.filter((l) => l.startsWith("file:")) : links.filter((l) => {
         try {
           return new URL(l).origin === ctx.baseUrl.origin;
         } catch {
@@ -5650,8 +5778,7 @@ var topicalAuthoritySignals = {
         }
       });
       totalInternalLinks += internalLinks.length;
-      if (internalLinks.length >= 3)
-        pagesWithGoodLinking++;
+      if (internalLinks.length >= 3) pagesWithGoodLinking++;
     }
     const avgLinks = pages.length > 0 ? Math.round(totalInternalLinks / pages.length) : 0;
     if (avgLinks >= 5 && pagesWithGoodLinking >= pages.length * 0.7) {
@@ -5737,12 +5864,11 @@ var eeatSignals = {
         return !!obj?.author;
       });
       const hasAuthorHtml = /class=["'][^"']*author[^"']*["']|rel=["']author["']/i.test(page.html);
-      if (hasAuthorMeta || hasAuthorJsonLd || hasAuthorHtml)
-        withAuthor++;
+      if (hasAuthorMeta || hasAuthorJsonLd || hasAuthorHtml) withAuthor++;
       const hasCredentials = /Ph\.?D|M\.?D|CPA|certified|licensed|expert|specialist/i.test(page.html);
-      const hasAboutPage = extractLinks(page.html, ctx.baseUrl.origin).some((l) => /about|team|author/i.test(l));
-      if (hasCredentials || hasAboutPage)
-        withExpertise++;
+      const linkBase = ctx.mode === "local" ? ctx.baseUrl.href : ctx.baseUrl.origin;
+      const hasAboutPage = extractLinks(page.html, linkBase).some((l) => /about|team|author/i.test(l));
+      if (hasCredentials || hasAboutPage) withExpertise++;
     }
     const score = (withAuthor + withExpertise) / (pages.length * 2);
     if (score >= 0.6) {
@@ -5782,8 +5908,7 @@ var faqSchema = {
         return type === "FAQPage" || type === "QAPage";
       });
       const hasFaqHtml = /<details|<summary|class=["'][^"']*faq[^"']*["']|id=["'][^"']*faq[^"']*["']/i.test(page.html);
-      if (hasFaqSchema || hasFaqHtml)
-        withFaq++;
+      if (hasFaqSchema || hasFaqHtml) withFaq++;
     }
     if (withFaq > 0) {
       return {
@@ -5806,6 +5931,185 @@ var faqSchema = {
     };
   }
 };
+var metaDescription = {
+  id: "meta-description",
+  name: "Meta Description",
+  category: "geo-signals",
+  description: "Checks for a meta description between 50 and 160 characters",
+  weight: 0.5,
+  run: async (ctx) => {
+    const pages = ctx.sampledPages.slice(0, 10);
+    if (pages.length === 0) {
+      return {
+        id: "meta-description",
+        name: "Meta Description",
+        category: "geo-signals",
+        status: "skip",
+        message: "No pages sampled"
+      };
+    }
+    let withGoodDescription = 0;
+    let missing = 0;
+    let tooShort = 0;
+    let tooLong = 0;
+    for (const page of pages) {
+      const meta = extractMetaTags(page.html);
+      const description = meta["description"]?.trim();
+      if (!description) {
+        missing++;
+        continue;
+      }
+      const len = description.length;
+      if (len >= 50 && len <= 160) withGoodDescription++;
+      else if (len < 50) tooShort++;
+      else tooLong++;
+    }
+    if (withGoodDescription === pages.length) {
+      return {
+        id: "meta-description",
+        name: "Meta Description",
+        category: "geo-signals",
+        status: "pass",
+        message: `All ${pages.length} pages have a meta description between 50\u2013160 characters`,
+        metadata: { withGoodDescription }
+      };
+    }
+    if (missing === pages.length) {
+      return {
+        id: "meta-description",
+        name: "Meta Description",
+        category: "geo-signals",
+        status: "fail",
+        message: "No meta description found on any sampled page",
+        suggestion: 'Add a <meta name="description"> between 50 and 160 characters to every page. Generative engines quote meta descriptions when summarizing your content.'
+      };
+    }
+    const detail = [
+      missing > 0 ? `${missing} missing` : null,
+      tooShort > 0 ? `${tooShort} too short` : null,
+      tooLong > 0 ? `${tooLong} too long` : null
+    ].filter(Boolean).join(" \xB7 ");
+    return {
+      id: "meta-description",
+      name: "Meta Description",
+      category: "geo-signals",
+      status: missing >= pages.length / 2 ? "fail" : "warn",
+      message: `${withGoodDescription}/${pages.length} pages have meta descriptions in the 50\u2013160 char range${detail ? ` \xB7 ${detail}` : ""}`,
+      suggestion: missing > 0 ? 'Add a <meta name="description"> between 50 and 160 characters to every page. Some pages are missing it entirely.' : "Aim for 50\u2013160 characters. Shorter descriptions lack context for AI; longer ones get truncated.",
+      metadata: { withGoodDescription, missing, tooShort, tooLong }
+    };
+  }
+};
+var openGraphTags = {
+  id: "open-graph-tags",
+  name: "Open Graph Tags",
+  category: "geo-signals",
+  description: "Checks for og:title, og:description, og:image, and og:url",
+  weight: 0.5,
+  run: async (ctx) => {
+    const pages = ctx.sampledPages.slice(0, 10);
+    if (pages.length === 0) {
+      return {
+        id: "open-graph-tags",
+        name: "Open Graph Tags",
+        category: "geo-signals",
+        status: "skip",
+        message: "No pages sampled"
+      };
+    }
+    const required = ["og:title", "og:description", "og:image", "og:url"];
+    let fullCoverage = 0;
+    let partialCoverage = 0;
+    const missingCounts = { "og:title": 0, "og:description": 0, "og:image": 0, "og:url": 0 };
+    for (const page of pages) {
+      const meta = extractMetaTags(page.html);
+      const missing = required.filter((tag) => !meta[tag]);
+      for (const tag of missing) missingCounts[tag] = (missingCounts[tag] ?? 0) + 1;
+      if (missing.length === 0) fullCoverage++;
+      else if (missing.length < required.length) partialCoverage++;
+    }
+    if (fullCoverage === pages.length) {
+      return {
+        id: "open-graph-tags",
+        name: "Open Graph Tags",
+        category: "geo-signals",
+        status: "pass",
+        message: `All ${pages.length} pages have complete Open Graph tags`
+      };
+    }
+    const mostMissing = Object.entries(missingCounts).filter(([, n]) => n > 0).sort(([, a], [, b]) => b - a).map(([tag]) => tag);
+    const noneCovered = pages.length - fullCoverage - partialCoverage;
+    return {
+      id: "open-graph-tags",
+      name: "Open Graph Tags",
+      category: "geo-signals",
+      status: fullCoverage + partialCoverage === 0 ? "fail" : "warn",
+      message: `${fullCoverage}/${pages.length} pages have complete Open Graph tags${partialCoverage > 0 ? ` \xB7 ${partialCoverage} partial` : ""}${noneCovered > 0 ? ` \xB7 ${noneCovered} with none` : ""}${mostMissing.length > 0 ? ` \xB7 most often missing: ${mostMissing.slice(0, 2).join(", ")}` : ""}`,
+      suggestion: "Add og:title, og:description, og:image, and og:url to every page. AI engines and link previews use these to render rich citations of your content.",
+      metadata: { fullCoverage, partialCoverage, noneCovered, missingCounts }
+    };
+  }
+};
+var externalCitations = {
+  id: "external-citations",
+  name: "External Citations",
+  category: "geo-signals",
+  description: "Checks for at least 2 outbound links to external sources per page",
+  weight: 0.5,
+  run: async (ctx) => {
+    if (ctx.mode === "local") {
+      return {
+        id: "external-citations",
+        name: "External Citations",
+        category: "geo-signals",
+        status: "info",
+        message: "External link detection requires a live origin to compare against"
+      };
+    }
+    const pages = ctx.sampledPages.slice(0, 10);
+    if (pages.length === 0) {
+      return {
+        id: "external-citations",
+        name: "External Citations",
+        category: "geo-signals",
+        status: "skip",
+        message: "No pages sampled"
+      };
+    }
+    const origin = ctx.baseUrl.origin;
+    let pagesWithCitations = 0;
+    let totalExternal = 0;
+    for (const page of pages) {
+      const links = extractLinks(page.html, origin);
+      const external = links.filter((l) => {
+        const u = new URL(l);
+        return u.protocol.startsWith("http") && u.origin !== origin;
+      });
+      totalExternal += external.length;
+      if (external.length >= 2) pagesWithCitations++;
+    }
+    const avgExternal = Math.round(totalExternal / pages.length);
+    if (pagesWithCitations >= pages.length * 0.7) {
+      return {
+        id: "external-citations",
+        name: "External Citations",
+        category: "geo-signals",
+        status: "pass",
+        message: `${pagesWithCitations}/${pages.length} pages have \u22652 outbound links (avg ${avgExternal}/page)`,
+        metadata: { pagesWithCitations, avgExternal }
+      };
+    }
+    return {
+      id: "external-citations",
+      name: "External Citations",
+      category: "geo-signals",
+      status: pagesWithCitations > 0 ? "warn" : "fail",
+      message: `Only ${pagesWithCitations}/${pages.length} pages have \u22652 outbound links (avg ${avgExternal}/page)`,
+      suggestion: "Add at least 2 outbound links to authoritative external sources per page. Citing sources signals credibility to generative engines, which weigh outbound links when deciding what to cite.",
+      metadata: { pagesWithCitations, avgExternal }
+    };
+  }
+};
 var canonicalUrlConsistency = {
   id: "canonical-url-consistency",
   name: "Canonical URL Consistency",
@@ -5813,6 +6117,15 @@ var canonicalUrlConsistency = {
   description: "Checks if pages have consistent canonical URLs",
   weight: 0.5,
   run: async (ctx) => {
+    if (ctx.mode === "local") {
+      return {
+        id: "canonical-url-consistency",
+        name: "Canonical URL Consistency",
+        category: "geo-signals",
+        status: "info",
+        message: "only meaningful for live urls. re-run against a deployed site to verify"
+      };
+    }
     const pages = ctx.sampledPages.slice(0, 10);
     let withCanonical = 0;
     let selfReferencing = 0;
@@ -5867,10 +6180,11 @@ var geoSignalChecks = [
   contentFreshness,
   eeatSignals,
   faqSchema,
+  metaDescription,
+  openGraphTags,
+  externalCitations,
   canonicalUrlConsistency
 ];
-
-// node_modules/@agentimization/core/dist/checks/agent-protocols.js
 var mcpServerCard = {
   id: "mcp-server-card",
   name: "MCP Server Card",
@@ -6004,12 +6318,9 @@ var contentSignals = {
     }
     const text = ctx.robotsTxt.toLowerCase();
     const signals = [];
-    if (/ai[-_]?train/i.test(ctx.robotsTxt))
-      signals.push("ai-train");
-    if (/ai[-_]?input/i.test(ctx.robotsTxt))
-      signals.push("ai-input");
-    if (/content[-_]?signals?/i.test(ctx.robotsTxt))
-      signals.push("content-signals");
+    if (/ai[-_]?train/i.test(ctx.robotsTxt)) signals.push("ai-train");
+    if (/ai[-_]?input/i.test(ctx.robotsTxt)) signals.push("ai-input");
+    if (/content[-_]?signals?/i.test(ctx.robotsTxt)) signals.push("content-signals");
     const hasGPTBot = text.includes("gptbot");
     const hasClaudeBot = text.includes("claudebot") || text.includes("claude-web");
     const hasGoogleExtended = text.includes("google-extended");
@@ -6244,8 +6555,6 @@ var agentProtocolChecks = [
   agentSkillsIndex,
   agentsMd
 ];
-
-// node_modules/@agentimization/core/dist/checks/index.js
 var ALL_CHECKS = [
   ...contentDiscoverabilityChecks,
   ...markdownAvailabilityChecks,
@@ -6256,13 +6565,31 @@ var ALL_CHECKS = [
   ...geoSignalChecks,
   ...agentProtocolChecks
 ];
-
-// node_modules/@agentimization/core/dist/utils/local.js
-import { readFileSync, readdirSync, existsSync } from "fs";
-import { join, relative, extname } from "path";
+var readIfExists = (path) => {
+  try {
+    if (existsSync(path)) {
+      return readFileSync(path, "utf-8");
+    }
+  } catch {
+  }
+  return void 0;
+};
+var findUpward = (start, names, maxDepth = 6) => {
+  let current = start;
+  for (let i = 0; i < maxDepth; i++) {
+    for (const name of names) {
+      const candidate = join(current, name);
+      const value = readIfExists(candidate);
+      if (value !== void 0) return value;
+    }
+    const parent = dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return void 0;
+};
 var walkDir = (dir, extensions, maxDepth = 10) => {
-  if (maxDepth <= 0)
-    return [];
+  if (maxDepth <= 0) return [];
   const results = [];
   try {
     const entries = readdirSync(dir, { withFileTypes: true });
@@ -6281,15 +6608,6 @@ var walkDir = (dir, extensions, maxDepth = 10) => {
   }
   return results;
 };
-var readIfExists = (path) => {
-  try {
-    if (existsSync(path)) {
-      return readFileSync(path, "utf-8");
-    }
-  } catch {
-  }
-  return void 0;
-};
 var buildLocalContext = (dirPath, config) => {
   const baseUrl = new URL(`file://${dirPath}`);
   const robotsTxt = readIfExists(join(dirPath, "robots.txt"));
@@ -6299,7 +6617,7 @@ var buildLocalContext = (dirPath, config) => {
   const mcpServerCard2 = readIfExists(join(dirPath, ".well-known", "mcp", "server-card.json"));
   const apiCatalog2 = readIfExists(join(dirPath, ".well-known", "api-catalog"));
   const agentSkillsIndex2 = readIfExists(join(dirPath, ".well-known", "agent-skills", "index.json"));
-  const agentsMd2 = readIfExists(join(dirPath, "AGENTS.md")) ?? readIfExists(join(dirPath, "AGENT.md"));
+  const agentsMd2 = findUpward(dirPath, ["AGENTS.md", "AGENT.md"]);
   const sitemapUrls = sitemapXml ? parseSitemapUrls(sitemapXml) : [];
   if (!sitemapXml && robotsTxt) {
     const sitemapMatch = robotsTxt.match(/Sitemap:\s*(.+)/i);
@@ -6316,8 +6634,8 @@ var buildLocalContext = (dirPath, config) => {
   }
   const htmlFiles = walkDir(dirPath, /* @__PURE__ */ new Set([".html", ".htm"]));
   const mdFiles = walkDir(dirPath, /* @__PURE__ */ new Set([".md", ".mdx"]));
-  const allFiles = [...htmlFiles, ...mdFiles];
-  const sampled = allFiles.slice(0, config.sampleSize);
+  const sampleSource = htmlFiles.length > 0 ? htmlFiles : mdFiles;
+  const sampled = sampleSource.slice(0, config.sampleSize);
   const sampledPages = sampled.map((filePath) => {
     const content = readFileSync(filePath, "utf-8");
     const relPath = relative(dirPath, filePath);
@@ -6368,19 +6686,12 @@ var wrapMarkdownAsHtml = (md, title) => {
   html = html.replace(/^([^<\n].+)$/gm, "<p>$1</p>");
   return `<!DOCTYPE html><html><head><title>${title}</title></head><body><main>${html}</main></body></html>`;
 };
-
-// node_modules/@agentimization/core/dist/index.js
 var computeGrade = (score) => {
-  if (score >= 95)
-    return "A+";
-  if (score >= 85)
-    return "A";
-  if (score >= 70)
-    return "B";
-  if (score >= 55)
-    return "C";
-  if (score >= 40)
-    return "D";
+  if (score >= 95) return "A+";
+  if (score >= 85) return "A";
+  if (score >= 70) return "B";
+  if (score >= 55) return "C";
+  if (score >= 40) return "D";
   return "F";
 };
 var buildRemoteContext = async (targetUrl, config) => {
@@ -6389,7 +6700,15 @@ var buildRemoteContext = async (targetUrl, config) => {
   emit({ type: "phase", phase: "fetching" });
   const baseUrl = new URL(targetUrl);
   const origin = baseUrl.origin;
-  const [robotsResult, llmsResult, llmsFullResult, sitemapResult, mcpCardResult, apiCatalogResult, agentSkillsResult] = await Promise.allSettled([
+  const [
+    robotsResult,
+    llmsResult,
+    llmsFullResult,
+    sitemapResult,
+    mcpCardResult,
+    apiCatalogResult,
+    agentSkillsResult
+  ] = await Promise.allSettled([
     fetchText(`${origin}/robots.txt`, config),
     fetchText(`${origin}/llms.txt`, config),
     fetchText(`${origin}/llms-full.txt`, config),
@@ -6523,7 +6842,9 @@ var runAudit = async (ctx, config, start) => {
     overallScore = 50;
   }
   const categories = {};
-  const activeCategories = config.categories.filter((cat) => results.some((r) => r.category === cat));
+  const activeCategories = config.categories.filter(
+    (cat) => results.some((r) => r.category === cat)
+  );
   for (const cat of activeCategories) {
     const catResults = results.filter((r) => r.category === cat);
     const catScorable = catResults.filter((r) => r.status !== "skip" && r.status !== "info");
@@ -7230,11 +7551,11 @@ var copyToClipboard = async (text) => {
 // src/ui/action-menu.tsx
 import { writeFileSync } from "fs";
 import { resolve } from "path";
-import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+import { Fragment as Fragment2, 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 MENU_OPTIONS = [
-  { label: "Copy fix prompt to clipboard", value: "copy", hint: "paste into Claude, ChatGPT, etc." },
+var buildMenuOptions = (hasIssues) => [
+  ...hasIssues ? [{ label: "Copy fix prompt to clipboard", value: "copy", hint: "paste into Claude, ChatGPT, etc." }] : [],
   { label: "Save JSON report", value: "json", hint: "agentimization-report.json" },
   { label: "Run another URL or path", value: "retry" },
   { label: "Exit", value: "exit" }
@@ -7251,6 +7572,8 @@ var ActionMenu = ({
   const [feedback, setFeedback] = useState2(null);
   const [input, setInput] = useState2("");
   const [done, setDone] = useState2(false);
+  const hasIssues = result.summary.failed > 0 || result.summary.warned > 0;
+  const menuOptions = buildMenuOptions(hasIssues);
   const handleAction = (action) => {
     const promptOpts = { mode: isLocal ? "local" : "remote", target };
     switch (action) {
@@ -7285,6 +7608,7 @@ var ActionMenu = ({
         setDone(true);
         setTimeout(() => {
           exit();
+          process.stdout.write("\n");
           if (result.overall_score < 50) process.exit(1);
         }, 50);
         break;
@@ -7297,13 +7621,16 @@ var ActionMenu = ({
       if (key.upArrow) {
         setSelected((prev) => Math.max(0, prev - 1));
       } else if (key.downArrow) {
-        setSelected((prev) => Math.min(MENU_OPTIONS.length - 1, prev + 1));
+        setSelected((prev) => Math.min(menuOptions.length - 1, prev + 1));
       } else if (key.return) {
-        const option = MENU_OPTIONS[selected];
+        const option = menuOptions[selected];
         handleAction(option.value);
       } else if (char === "q" || key.escape) {
         setDone(true);
-        setTimeout(() => exit(), 50);
+        setTimeout(() => {
+          exit();
+          process.stdout.write("\n");
+        }, 50);
       }
       return;
     }
@@ -7337,7 +7664,7 @@ var ActionMenu = ({
   return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", marginTop: 1, children: [
     /* @__PURE__ */ jsx4(Text4, { color: toInkColor(TEXT_DIM), children: "  \u2500\u2500\u2500 What next? \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" }),
     /* @__PURE__ */ jsx4(Text4, { color: toInkColor(TEXT_DIM), children: "  Use \u2191\u2193 arrows, enter to select, q to quit" }),
-    /* @__PURE__ */ jsx4(Box4, { flexDirection: "column", marginTop: 1, children: MENU_OPTIONS.map((opt, i) => {
+    /* @__PURE__ */ jsx4(Box4, { flexDirection: "column", marginTop: 1, children: menuOptions.map((opt, i) => {
       const isSelected = i === selected;
       return /* @__PURE__ */ jsxs4(Box4, { paddingLeft: 2, children: [
         /* @__PURE__ */ jsxs4(Text4, { color: isSelected ? toInkColor(ACCENT_BLUE) : void 0, children: [
@@ -7352,7 +7679,10 @@ var ActionMenu = ({
         ] }) : null
       ] }, opt.value);
     }) }),
-    feedback ? /* @__PURE__ */ jsx4(Box4, { marginTop: 1, paddingLeft: 2, children: /* @__PURE__ */ jsx4(Text4, { color: toInkColor(feedback.startsWith("\u2713") ? FEEDBACK_OK : FEEDBACK_ERR), children: feedback }) }) : null
+    feedback ? /* @__PURE__ */ jsxs4(Fragment2, { 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
   ] });
 };
 
@@ -7433,7 +7763,7 @@ var ErrorActions = ({ onRetry }) => {
 
 // src/ui/target.ts
 import { existsSync as existsSync2, statSync } from "fs";
-import { resolve as resolve2 } from "path";
+import { join as join2, resolve as resolve2 } from "path";
 var isLocalPath = (arg) => {
   if (arg === "." || arg === ".." || arg.startsWith("./") || arg.startsWith("../") || arg.startsWith("/")) {
     return true;
@@ -7449,11 +7779,30 @@ var normalizeUrl = (arg) => {
   const parsed = new URL(arg.startsWith("http") ? arg : `https://${arg}`);
   return parsed.href;
 };
+var BUILD_DIR_NAMES = ["dist", "build", "out", "_site", "public"];
+var hasIndex = (dir) => ["index.html", "index.htm", "index.md"].some((name) => existsSync2(join2(dir, name)));
+var findBuildDir = (root) => {
+  for (const name of BUILD_DIR_NAMES) {
+    const candidate = join2(root, name);
+    if (existsSync2(candidate) && statSync(candidate).isDirectory() && hasIndex(candidate)) {
+      return candidate;
+    }
+  }
+  return void 0;
+};
 var resolveTarget = (input) => {
   const trimmed = input.trim();
   if (!trimmed) return { error: "Please enter a URL or path." };
   if (isLocalPath(trimmed)) {
-    return { target: resolve2(trimmed), isLocal: true };
+    const requested = resolve2(trimmed);
+    if (hasIndex(requested)) {
+      return { target: requested, isLocal: true };
+    }
+    const buildDir = findBuildDir(requested);
+    if (buildDir) {
+      return { target: buildDir, isLocal: true, autoDetectedFrom: requested };
+    }
+    return { target: requested, isLocal: true };
   }
   try {
     return { target: normalizeUrl(trimmed), isLocal: false };
@@ -7464,7 +7813,13 @@ var resolveTarget = (input) => {
 
 // src/ui/app.tsx
 import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
-var App = ({ target: initialTarget, isLocal: initialIsLocal, categories, sampleSize }) => {
+var App = ({
+  target: initialTarget,
+  isLocal: initialIsLocal,
+  categories,
+  sampleSize,
+  autoDetectedFrom
+}) => {
   const [target, setTarget] = useState4(initialTarget);
   const [isLocal, setIsLocal] = useState4(initialIsLocal);
   const [phase, setPhase] = useState4("init");
@@ -7498,7 +7853,7 @@ var App = ({ target: initialTarget, isLocal: initialIsLocal, categories, sampleS
         const config = { categories, sampleSize, onEvent };
         const res = isLocal ? await auditLocal(target, config) : await audit(target, config);
         if (isLocal) {
-          setNetworkSkipped(35 - res.summary.total);
+          setNetworkSkipped(ALL_CHECKS.length - res.summary.total);
         }
         setResult(res);
         setPhase("done");
@@ -7573,6 +7928,11 @@ var App = ({ target: initialTarget, isLocal: initialIsLocal, categories, sampleS
         gradeColor: result ? GRADE_COLORS[result.grade] : void 0
       }
     ) }),
+    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"
@@ -7636,10 +7996,18 @@ Examples:
   $ agentimization ./docs --category content-structure
   $ agentimization ./public --md | pbcopy`).action(async (target, opts) => {
   const categories = opts.category ? [opts.category] : void 0;
-  const isLocal = isLocalPath(target);
+  const resolved = resolveTarget(target);
+  if ("error" in resolved) {
+    console.error(`Error: ${resolved.error}`);
+    return process.exit(1);
+  }
+  const { target: targetResolved, isLocal, autoDetectedFrom } = resolved;
+  if (autoDetectedFrom && !opts.json) {
+    console.error(`auditing built output at ${targetResolved}`);
+  }
   if (opts.json) {
     try {
-      const result = isLocal ? await auditLocal(resolve3(target), { categories, sampleSize: opts.sampleSize }) : await audit(normalizeUrl2(target), { categories, sampleSize: opts.sampleSize });
+      const result = isLocal ? await auditLocal(targetResolved, { categories, sampleSize: opts.sampleSize }) : await audit(targetResolved, { categories, sampleSize: opts.sampleSize });
       console.log(JSON.stringify(result, null, 2));
       if (result.overall_score < 50) process.exit(1);
     } catch (error) {
@@ -7651,8 +8019,8 @@ Examples:
   }
   if (opts.md) {
     try {
-      const result = isLocal ? await auditLocal(resolve3(target), { categories, sampleSize: opts.sampleSize }) : await audit(normalizeUrl2(target), { categories, sampleSize: opts.sampleSize });
-      console.log(generateAgentPrompt(result, { mode: isLocal ? "local" : "remote", target }));
+      const result = isLocal ? await auditLocal(targetResolved, { categories, sampleSize: opts.sampleSize }) : await audit(targetResolved, { categories, sampleSize: opts.sampleSize });
+      console.log(generateAgentPrompt(result, { mode: isLocal ? "local" : "remote", target: targetResolved }));
       if (result.overall_score < 50) process.exit(1);
     } catch (error) {
       const msg = error instanceof Error ? error.message : "Unknown error";
@@ -7661,24 +8029,16 @@ Examples:
     }
     return;
   }
-  const targetResolved = isLocal ? resolve3(target) : normalizeUrl2(target);
   render(
     React2.createElement(App, {
       target: targetResolved,
       isLocal,
       categories,
-      sampleSize: opts.sampleSize
+      sampleSize: opts.sampleSize,
+      autoDetectedFrom
     })
   );
 });
-var normalizeUrl2 = (arg) => {
-  try {
-    return normalizeUrl(arg);
-  } catch {
-    console.error(`Error: Invalid URL "${arg}"`);
-    process.exit(1);
-  }
-};
 try {
   program.parse();
 } catch (err) {