agentimization 0.1.0 → 0.1.1

package/README.md

@@ -1,193 +1,77 @@
-<p align="center">
-  <img src="https://img.shields.io/npm/v/agentimization?style=flat-square&color=blue" alt="npm version" />
-  <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="license" />
-  <img src="https://img.shields.io/badge/checks-35-purple?style=flat-square" alt="checks" />
-</p>
+# agentimization
 
-<h1 align="center">agentimization</h1>
+[![npm version](https://img.shields.io/npm/v/agentimization?style=flat-square&color=blue)](https://www.npmjs.com/package/agentimization)
 
-<p align="center">
-  GEO audit for agent-ready websites.<br/>
-  One command to check if AI agents can discover, parse, and cite your content.
-</p>
-
----
-
-## Why
+```text
+╭───────────────────────────────────────────────╮
+│ ▓░▒▓░░▒░▓▒░▓▓░▒░▓░░▒▓▒░▓░░▓▒░▓░▒░▓░░▒▓░░      │
+│ ░▓▒░▓░░▒▓▒░▓░░▒▓▓░▒░▓▒░░▓▒░▓░▒░░▓▒░░▓░▒       │
+│ ▓░▒▓░░▒▓▒░░▓░▒▓▒░░▓░░▓▒░▓░▒░░▓▒░▓░░▒▓░        │
+│ ░▒▓░▒░▓▒░░▓░▒▓░░▒▓▒░░▓░▒▓░░▒▓░ agentimization │
+╰───────────────────────────────────────────────╯
+```
 
-AI agents (Claude, ChatGPT, Perplexity, Gemini) are becoming a major source of traffic and citations. But most websites are invisible to them — no `llms.txt`, no markdown endpoints, no structured data, client-rendered content that crawlers can't read.
+geo audit for agent-ready websites and projects.
 
-**Agentimization** runs checks across 8 categories and gives you a GEO score from 0–100, with specific fixes you can hand off to an AI coding agent.
+geomaxx your site so ai agents can actually find, parse, and cite it.
 
-## Install
+## install
 
 ```bash
 npx agentimization https://your-site.com
 ```
 
-Or install globally:
-
-```bash
-npm install -g agentimization
-```
-
-## Usage
+## usage
 
-### Audit a live site
+audit a live site:
 
 ```bash
-agentimization https://docs.anthropic.com
+agentimization https://docs.your-site.com
 ```
 
-```text
-╭───────────────────────────────────────────────╮
-│ ▓░▒▓░░▒░▓▒░▓▓░▒░▓░░▒▓▒░▓░░▓▒░▓░▒░▓░░▒▓░░     │
-│ ░▓▒░▓░░▒▓▒░▓░░▒▓▓░▒░▓▒░░▓▒░▓░▒░░▓▒░░▓░▒      │
-│ ▓░▒▓░░▒▓▒░░▓░▒▓▒░░▓░░▓▒░▓░▒░░▓▒░▓░░▒▓░       │
-│ ░▒▓░▒░▓▒░░▓░▒▓░░▒▓▒░░▓░▒▓░░▒▓░ agentimization │
-│                                               │
-│ https://docs.anthropic.com                    │
-│                                               │
-│ Crawling the site, one sec…                   │
-╰───────────────────────────────────────────────╯
-```
-
-### Audit a local directory (great for CI)
+audit a local directory:
 
 ```bash
 agentimization .
-agentimization ./docs
 ```
 
-### Output formats
+pipe results to a tool or file:
 
 ```bash
-# JSON for CI pipelines
-agentimization https://example.com --json
-
-# Markdown report — paste into Claude, ChatGPT, etc.
-agentimization https://example.com --md
-
-# Filter by category
-agentimization https://example.com --category content-discoverability
+agentimization https://your-site.com --json > report.json
+agentimization https://your-site.com --md | pbcopy
 ```
 
-### After the audit
-
-Agentimization shows an interactive menu when the audit finishes:
-
-- **Copy fix prompt to clipboard** — structured markdown an AI coding agent can use to fix your GEO issues
-- **Save JSON report** — full audit data written to `agentimization-report.json`
-- **Run another URL or path** — keep the session open and audit the next site
-- **Exit**
-
-## Checks
-
-Agentimization runs **36 checks** across **8 categories**:
+## what it checks
 
-| Category | What it checks |
-|---|---|
-| **Content Discoverability** | `llms.txt` existence, structure, size, coverage, link resolution. Sitemap presence. `robots.txt` AI agent rules. |
-| **Markdown Availability** | `.md` URL support, `Accept: text/markdown` content negotiation, HTML↔markdown parity. |
-| **Content Structure** | Code fence validity, heading hierarchy, tabbed content serialization. |
-| **Page Size & Rendering** | SSR vs CSR detection, HTML/markdown page size, content start position (boilerplate ratio). |
-| **URL Stability** | HTTP status codes, redirect behavior, cache header hygiene. |
-| **Authentication & Access** | Auth gate detection, alternative access paths for gated content. |
-| **GEO Signals** | Structured data (JSON-LD), citation worthiness, topical authority, content freshness, E-E-A-T signals, FAQ schema, canonical URLs. |
-| **Agent Protocols** | AGENTS.md, MCP server card, API catalog (RFC 9727), content signals (AI usage declarations), Link headers (RFC 8288), agent skills index. |
+36 checks across 8 categories. each one is a thing ai agents need to discover, parse, or cite your content.
 
-## Scoring
+- content discoverability: `llms.txt`, sitemap, robots
+- markdown availability: `.md` urls, content negotiation
+- content structure: headings, code fences, hidden tabs
+- page size and rendering: ssr vs csr, boilerplate ratio
+- url stability: status codes, redirects, canonicals
+- authentication and access: gates, alternative paths
+- geo signals: json-ld, citations, freshness, e-e-a-t
+- agent protocols: mcp card, api catalog, agents.md, link headers
 
-Each check returns **pass**, **warn**, **fail**, **skip**, or **info**. Checks are weighted by importance, and scores roll up into category scores and an overall grade:
+## how it works
 
-| Grade | Score |
-|---|---|
-| A+ | 95–100 |
-| A | 85–94 |
-| B | 70–84 |
-| C | 55–69 |
-| D | 40–54 |
-| F | 0–39 |
+it samples up to 10 pages of your site, runs 36 checks against the html, headers, and well-known files, then weights them into a 0 to 100 score. failed checks come with a suggestion you can paste into your ai coding agent.
 
-## Example scores
+## requirements
 
-How popular sites score on Agentimization (approximate, scores change as sites update):
+node 18 or newer.
 
-| Site | Grade | Score | Notes |
-|---|---|---|---|
-| `docs.anthropic.com` | **A** | 88 | Strong `llms.txt`, good markdown, structured data |
-| `docs.stripe.com` | **A** | 91 | Excellent discoverability, markdown endpoints, great structure |
-| `nextjs.org/docs` | **B** | 76 | Good SSR, missing `llms.txt`, decent GEO signals |
-| `react.dev` | **B** | 72 | Good structure, no `llms.txt`, client-heavy rendering |
-| `en.wikipedia.org` | **A** | 86 | Great content structure, strong citations, no `llms.txt` |
-| `medium.com` | **D** | 45 | Auth gates, weak markdown, no `llms.txt` |
-| `substack.com` | **C** | 58 | Mixed access, some content gated |
-
-> These are illustrative examples. Run `agentimization <url>` to get real-time scores.
-
-## Local mode
-
-When you pass a directory path instead of a URL, Agentimization runs in **local mode**:
-
-- Scans your files on disk (HTML, markdown, `llms.txt`, `robots.txt`, `sitemap.xml`)
-- Skips network-only checks (content negotiation, auth detection, cache headers, etc.)
-- Perfect as a **CI pre-deploy step** — catch GEO regressions before they ship
-
-```bash
-# In CI
-agentimization . --json
-# Exit code 1 if score < 50
-```
-
-## Programmatic API
+## programmatic use
 
 ```typescript
-import { audit, auditLocal } from "@agentimization/core"
+import { audit } from "@agentimization/core"
 
-// Remote audit
-const result = await audit("https://docs.anthropic.com")
+const result = await audit("https://your-site.com")
 console.log(result.grade, result.overall_score)
-
-// Local audit
-const local = await auditLocal("./docs")
-console.log(local.grade, local.overall_score)
-
-// With options
-const result = await audit("https://example.com", {
-  sampleSize: 20,
-  categories: ["content-discoverability", "geo-signals"],
-  onEvent: (event) => console.log(event),
-})
-```
-
-## What is GEO?
-
-**Generative Engine Optimization** is like SEO, but for AI. Instead of optimizing for Google's crawlers and ranking algorithm, GEO optimizes for AI agents that need to:
-
-1. **Discover** your content (via `llms.txt`, sitemaps, `robots.txt`)
-2. **Parse** it efficiently (markdown availability, clean HTML, SSR)
-3. **Cite** it accurately (structured data, canonical URLs, E-E-A-T signals)
-
-Sites that score well on Agentimization are more likely to be surfaced and cited by Claude, ChatGPT, Perplexity, and other generative engines.
-
-## Contributing
-
-```bash
-git clone https://github.com/antlio/agentimization
-cd agentimization
-bun install
-bun run build
-bun run typecheck
-```
-
-The monorepo structure:
-
-```
-packages/shared  — Types, schemas, constants
-packages/core    — Audit engine + all 36 checks
-apps/cli         — CLI (Commander.js + Ink)
 ```
 
-## License
+## license
 
-MIT
+mit

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 = [];
@@ -4912,8 +4903,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 +4924,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 {
@@ -5049,7 +5037,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 +5054,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,10 +5071,10 @@ 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 }
     };
   }
 };
@@ -5095,8 +5084,6 @@ var pageSizeChecks = [
   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 +5098,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 +5164,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 +5182,7 @@ var sectionHeaderQuality = {
           break;
         }
       }
-      if (pageGood)
-        goodPages++;
+      if (pageGood) goodPages++;
     }
     if (goodPages === pages.length) {
       return {
@@ -5272,8 +5256,6 @@ var contentStructureChecks = [
   sectionHeaderQuality,
   tabbedContentSerialization
 ];
-
-// node_modules/@agentimization/core/dist/checks/url-stability.js
 var httpStatusCodes = {
   id: "http-status-codes",
   name: "HTTP Status Codes",
@@ -5290,8 +5272,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 {
       }
     }
@@ -5390,8 +5371,6 @@ var urlStabilityChecks = [
   redirectBehavior,
   cacheHeaderHygiene
 ];
-
-// node_modules/@agentimization/core/dist/checks/authentication.js
 var authGateDetection = {
   id: "auth-gate-detection",
   name: "Auth Gate Detection",
@@ -5439,7 +5418,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 +5455,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 +5479,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 +5498,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 +5575,7 @@ var citationWorthiness = {
         signals.withLists++;
         pageCitable = true;
       }
-      if (pageCitable)
-        citablePages++;
+      if (pageCitable) citablePages++;
     }
     if (citablePages >= pages.length * 0.7) {
       return {
@@ -5640,9 +5608,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 +5619,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 +5705,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 +5749,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 {
@@ -5813,6 +5779,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;
@@ -5869,8 +5844,6 @@ var geoSignalChecks = [
   faqSchema,
   canonicalUrlConsistency
 ];
-
-// node_modules/@agentimization/core/dist/checks/agent-protocols.js
 var mcpServerCard = {
   id: "mcp-server-card",
   name: "MCP Server Card",
@@ -6004,12 +5977,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 +6214,6 @@ var agentProtocolChecks = [
   agentSkillsIndex,
   agentsMd
 ];
-
-// node_modules/@agentimization/core/dist/checks/index.js
 var ALL_CHECKS = [
   ...contentDiscoverabilityChecks,
   ...markdownAvailabilityChecks,
@@ -6256,13 +6224,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 +6267,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 +6276,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 +6293,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 +6345,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 +6359,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 +6501,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 +7210,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 +7231,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 +7267,7 @@ var ActionMenu = ({
         setDone(true);
         setTimeout(() => {
           exit();
+          process.stdout.write("\n");
           if (result.overall_score < 50) process.exit(1);
         }, 50);
         break;
@@ -7297,13 +7280,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 +7323,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 +7338,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 +7422,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 +7438,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 +7472,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");
@@ -7573,6 +7587,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 +7655,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 +7678,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 +7688,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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentimization",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "GEO audit CLI — check if your website is agent-ready",
   "license": "MIT",
   "author": "Anthony Lio <hello@antl.io>",
@@ -40,7 +40,7 @@
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "prepublishOnly": "bun run build && cp ../../README.md ./README.md && cp ../../LICENSE ./LICENSE"
+    "prepublishOnly": "bun run build && cp -f ../../README.md ./README.md && cp -f ../../LICENSE ./LICENSE"
   },
   "dependencies": {
     "commander": "^14.0.3",