aeo-ready 1.0.0 → 1.1.0

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch"
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aeo-ready",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Is your site AEO ready? Two scorecards: Agent Readiness + AI Visibility. One scan, one score.",
   "type": "module",
   "bin": {
@@ -29,7 +29,8 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "commander": "^12.0.0",
-    "chalk": "^5.3.0"
+    "afdocs": "^0.18.7",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0"
   }
 }

package/src/benchmark/cloudflare.js

@@ -0,0 +1,75 @@
+export async function runCloudflare(url) {
+  try {
+    const res = await fetch("https://isitagentready.com/mcp", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json, text/event-stream",
+      },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: {
+          name: "scan_site",
+          arguments: { url },
+        },
+      }),
+    });
+
+    const text = await res.text();
+    const dataLine = text.split("\n").find((l) => l.startsWith("data:"));
+    if (!dataLine) return { available: false, reason: "no data in response" };
+
+    const json = JSON.parse(dataLine.slice(5));
+    const content = json.result?.content?.[0]?.text || "";
+
+    const levelMatch = content.match(/Level (\d)\/5/i);
+    const level = levelMatch ? parseInt(levelMatch[1]) : 0;
+
+    const categories = {};
+    const catRegex = /## (.+?) \((\d+)\/(\d+) passing\)/g;
+    let match;
+    while ((match = catRegex.exec(content)) !== null) {
+      const name = match[1];
+      categories[name.toLowerCase().replace(/[^a-z]+/g, "-")] = {
+        name,
+        score: parseInt(match[2]),
+        maxScore: parseInt(match[3]),
+        percentage: Math.round((parseInt(match[2]) / parseInt(match[3])) * 100),
+      };
+    }
+
+    const checks = [];
+    const checkRegex =
+      /- (PASS|FAIL|OK) (\w+)(?:: (.+?))?(?:\n\s+(.+?))?(?=\n- |\n##|\n$)/g;
+    let cm;
+    while ((cm = checkRegex.exec(content)) !== null) {
+      checks.push({
+        status: cm[1].toLowerCase(),
+        id: cm[2],
+        message: cm[3] || "",
+      });
+    }
+
+    return {
+      score: level,
+      maxScore: 5,
+      grade: levelToGrade(level),
+      level,
+      checks,
+      categories,
+      available: true,
+    };
+  } catch (err) {
+    return { available: false, reason: err.message?.slice(0, 100) };
+  }
+}
+
+function levelToGrade(level) {
+  if (level >= 5) return "A";
+  if (level >= 4) return "B";
+  if (level >= 3) return "C";
+  if (level >= 2) return "D";
+  return "F";
+}

package/src/benchmark/fern.js

@@ -0,0 +1,51 @@
+export async function runFern(url) {
+  try {
+    const { runChecks, computeScore, toGrade, CATEGORIES } =
+      await import("afdocs");
+
+    const report = await runChecks(url);
+    const checks = report.results || [];
+    const computed = computeScore(report);
+    const score = computed.overall ?? 0;
+    const maxScore = 100;
+    const grade = computed.grade || toGrade(score);
+
+    const catMap = {};
+    for (const cat of CATEGORIES) {
+      catMap[cat.id] = { name: cat.name, score: 0, maxScore: 0 };
+    }
+
+    for (const check of checks) {
+      const catId = check.category || "other";
+      if (!catMap[catId]) {
+        catMap[catId] = { name: catId, score: 0, maxScore: 0 };
+      }
+      catMap[catId].maxScore += 1;
+      if (check.status === "pass") catMap[catId].score += 1;
+    }
+
+    for (const cat of Object.values(catMap)) {
+      cat.percentage =
+        cat.maxScore > 0 ? Math.round((cat.score / cat.maxScore) * 100) : 0;
+    }
+
+    const categories = Object.fromEntries(
+      Object.entries(catMap).filter(([, v]) => v.maxScore > 0),
+    );
+
+    return {
+      score,
+      maxScore,
+      grade,
+      categories,
+      checks: checks.map((c) => ({
+        id: c.id,
+        status: c.status,
+        message: c.message || "",
+      })),
+      available: true,
+    };
+  } catch (err) {
+    return { available: false, reason: err.message?.slice(0, 100) };
+  }
+}

package/src/benchmark/index.js

@@ -0,0 +1,119 @@
+import chalk from "chalk";
+import { runBenchmark as runAgenticSeo } from "./agentic-seo.js";
+import { runCloudflare } from "./cloudflare.js";
+import { runFern } from "./fern.js";
+
+const REFERENCE_SCORES = {
+  agenticSeo: {
+    Stripe: 17,
+    Vercel: 48,
+    Supabase: 52,
+    Cloudflare: 55,
+    Average: 25,
+  },
+  cloudflare: {
+    Stripe: 2,
+    Vercel: 4,
+    Supabase: 3,
+    Cloudflare: 5,
+    Average: 2,
+  },
+  fern: {
+    Stripe: 85,
+    Vercel: 60,
+    Supabase: 78,
+    Anthropic: 72,
+    Average: 45,
+  },
+};
+
+export async function runAllBenchmarks(target) {
+  const isUrl = target && target.startsWith("http");
+
+  const results = await Promise.allSettled([
+    runAgenticSeo(target),
+    isUrl ? runCloudflare(target) : Promise.resolve(null),
+    isUrl ? runFern(target) : Promise.resolve(null),
+  ]);
+
+  return {
+    agenticSeo: results[0].status === "fulfilled" ? results[0].value : null,
+    cloudflare: results[1].status === "fulfilled" ? results[1].value : null,
+    fern: results[2].status === "fulfilled" ? results[2].value : null,
+  };
+}
+
+export function printBenchmarks(benchmarks) {
+  const any = Object.values(benchmarks).some((b) => b && b.available);
+  if (!any) return;
+
+  console.log(
+    chalk.bold("\n  ─── Benchmarks ────────────────────────────────────\n"),
+  );
+
+  if (benchmarks.agenticSeo?.available) {
+    printBenchmarkBlock("agentic-seo", "agenticSeo", benchmarks.agenticSeo);
+  }
+  if (benchmarks.cloudflare?.available) {
+    printBenchmarkBlock("Cloudflare", "cloudflare", benchmarks.cloudflare);
+  }
+  if (benchmarks.fern?.available) {
+    printBenchmarkBlock("Fern", "fern", benchmarks.fern);
+  }
+}
+
+function printBenchmarkBlock(name, key, b) {
+  const pct = b.maxScore > 0 ? Math.round((b.score / b.maxScore) * 100) : 0;
+  const color = pct >= 80 ? chalk.green : pct >= 50 ? chalk.yellow : chalk.red;
+  const barW = 16;
+  const filled = Math.round((pct / 100) * barW);
+  const bar = color("█".repeat(filled)) + chalk.dim("░".repeat(barW - filled));
+
+  console.log(
+    `  ${bar} ${chalk.bold(name.padEnd(16))} ${chalk.dim(`${b.score}/${b.maxScore}`)}${b.grade ? chalk.dim(` (${b.grade})`) : ""}`,
+  );
+
+  if (b.checks && b.checks.length > 0) {
+    for (const check of b.checks) {
+      if (check.status === "pass") {
+        console.log(
+          chalk.green(`    + ${check.id}`) +
+            chalk.dim(check.message ? ` ${check.message.slice(0, 60)}` : ""),
+        );
+      } else if (check.status === "fail") {
+        console.log(
+          chalk.red(`    - ${check.id}`) +
+            chalk.dim(check.message ? ` ${check.message.slice(0, 60)}` : ""),
+        );
+      }
+    }
+  } else if (b.categories) {
+    for (const [, cat] of Object.entries(b.categories)) {
+      const catPct =
+        cat.percentage ??
+        (cat.maxScore > 0 ? Math.round((cat.score / cat.maxScore) * 100) : 0);
+      const icon =
+        catPct >= 80
+          ? chalk.green("✓")
+          : catPct >= 40
+            ? chalk.yellow("◑")
+            : chalk.red("✗");
+      console.log(
+        chalk.dim(
+          `    ${icon} ${(cat.name || "").padEnd(22)} ${cat.score}/${cat.maxScore}`,
+        ),
+      );
+    }
+  }
+
+  const refs = REFERENCE_SCORES[key];
+  if (refs) {
+    const names = Object.entries(refs)
+      .sort((a, b) => b[1] - a[1])
+      .map(([n, s]) => `${n} ${s}`)
+      .join(chalk.dim(" · "));
+    console.log(chalk.dim(`    compare: ${names}`));
+  }
+
+  console.log("");
+}

package/src/dashboard/sections/recommendations.js

@@ -1,3 +1,117 @@
+const HOW_TO_FIX = {
+  "llms.txt": {
+    time: "1 hour",
+    steps: [
+      "Create a file called <code>llms.txt</code> in your site root",
+      "First line: <code># Your Company Name</code>",
+      "Second line: one sentence describing what you do and for whom",
+      "List 3-5 key features, pricing model, and how to get started",
+      "Keep it under 5,000 tokens — this is NOT your homepage copy",
+      "Deploy it so it's accessible at <code>yoursite.com/llms.txt</code>",
+    ],
+    example: `# Acme Corp\n> API-first billing platform for SaaS companies.\n\n## What it does\n- Usage-based billing with real-time metering\n- Self-serve pricing pages\n- Revenue recognition automation\n\n## Pricing\n- Starter: $0/mo (up to $10K MRR)\n- Growth: $499/mo\n- Enterprise: custom\n\n## Get started\n1. Sign up at acme.com/signup\n2. Install SDK: npm install @acme/billing\n3. Add 3 lines of code to start metering`,
+  },
+  "robots.txt AI crawlers": {
+    time: "5 minutes",
+    steps: [
+      "Open your <code>robots.txt</code> file (or create one in your site root)",
+      "Add explicit Allow rules for each AI crawler",
+      "Deploy — most hosting platforms serve this automatically from root",
+    ],
+    example: `User-agent: GPTBot\nAllow: /\n\nUser-agent: ClaudeBot\nAllow: /\n\nUser-agent: Google-Extended\nAllow: /\n\nUser-agent: PerplexityBot\nAllow: /`,
+    auto: "Run <code>npx aeo-ready scan --fix</code> to generate this automatically.",
+  },
+  "AGENTS.md / CLAUDE.md": {
+    time: "30 minutes",
+    steps: [
+      "Create <code>AGENTS.md</code> in your repo root",
+      "Describe your project structure — key directories and what's in them",
+      "List development commands (install, run, test)",
+      "Note constraints: rate limits, auth requirements, external dependencies",
+      "Keep it factual and precise — LLM-generated AGENTS.md files hurt agent success rates",
+    ],
+    auto: "Run <code>npx aeo-ready scan --fix</code> to get a scaffold, then edit it.",
+  },
+  "agents.json manifest": {
+    time: "20 minutes",
+    steps: [
+      "Create <code>.well-known/agent.json</code> in your site root",
+      "Add name, description, and capabilities array",
+      "Link to your llms.txt and OpenAPI spec",
+      "Include contact info and auth method",
+    ],
+    example: `{\n  "schema_version": "1.0",\n  "name": "Your Product",\n  "description": "What it does in one sentence",\n  "capabilities": ["api-integration", "pricing-lookup"],\n  "interfaces": {\n    "human": "/",\n    "llm": "/llms.txt",\n    "api": "/openapi.json"\n  }\n}`,
+    auto: "Run <code>npx aeo-ready scan --fix</code> to generate a draft.",
+  },
+  "Question-based headings": {
+    time: "1-2 hours",
+    steps: [
+      "Find your top 10 pages by traffic or importance",
+      "Rewrite H2/H3 headings as questions users would ask AI",
+      'Example: change "Pricing" → "How much does [Product] cost?"',
+      'Example: change "Features" → "What can [Product] do?"',
+      "Aim for 30%+ of headings to be question-based",
+    ],
+  },
+  "Direct answer formatting": {
+    time: "1-2 hours",
+    steps: [
+      "On each key page, add a 40-60 word summary as the first paragraph",
+      "This paragraph should directly answer the question the page addresses",
+      "Don't start with background or context — lead with the answer",
+      "AI systems extract this as the citation snippet",
+    ],
+    example: `<!-- Before -->\n<h1>Our Billing Platform</h1>\n<p>Founded in 2020, we set out to solve...</p>\n\n<!-- After -->\n<h1>Our Billing Platform</h1>\n<p>Acme is a usage-based billing platform that helps SaaS companies meter API calls, automate invoicing, and recognize revenue. Plans start at $0/mo for up to $10K MRR.</p>`,
+  },
+  "FAQ markup": {
+    time: "30 minutes",
+    steps: [
+      "Identify 5-10 common questions about your product",
+      "Add them to your page as a FAQ section",
+      "Wrap them in FAQPage JSON-LD schema",
+      "Add the script tag to your page's <code>&lt;head&gt;</code>",
+    ],
+    example: `<script type="application/ld+json">\n{\n  "@context": "https://schema.org",\n  "@type": "FAQPage",\n  "mainEntity": [{\n    "@type": "Question",\n    "name": "What does Acme cost?",\n    "acceptedAnswer": {\n      "@type": "Answer",\n      "text": "Acme starts free for up to $10K MRR. Growth is $499/mo."\n    }\n  }]\n}\n</script>`,
+  },
+  "Schema.org markup": {
+    time: "30 minutes",
+    steps: [
+      "Determine your schema type: SoftwareApplication (SaaS), Person (portfolio), Article (blog)",
+      "Create a JSON-LD block with required fields (name, description, url)",
+      "Add it to your homepage <code>&lt;head&gt;</code> in a script tag",
+      "For SaaS: include <code>offers</code> with pricing per plan",
+    ],
+    example: `<script type="application/ld+json">\n{\n  "@context": "https://schema.org",\n  "@type": "SoftwareApplication",\n  "name": "Your Product",\n  "description": "One sentence",\n  "url": "https://yoursite.com",\n  "offers": [{\n    "@type": "Offer",\n    "name": "Starter",\n    "price": "0",\n    "priceCurrency": "USD"\n  }]\n}\n</script>`,
+  },
+  "E-E-A-T signals": {
+    time: "1 hour",
+    steps: [
+      "Add author bios with name, role, and credentials to content pages",
+      "Add a Person JSON-LD schema for each author",
+      "Include first-hand experience markers: 'We built...', 'In our experience...'",
+      "Link to author profiles on LinkedIn, GitHub, Twitter",
+    ],
+  },
+  "Content negotiation": {
+    time: "2-4 hours (requires code)",
+    steps: [
+      "Add middleware that checks the <code>Accept</code> header on requests",
+      "When <code>Accept: text/markdown</code> is present, return markdown instead of HTML",
+      "Strip navigation, footers, and chrome — return just the content",
+      "This saves agents thousands of tokens vs parsing your HTML",
+    ],
+  },
+  "Definitive statements": {
+    time: "1-2 hours",
+    steps: [
+      "Search your content for hedging words: 'might', 'perhaps', 'possibly', 'could be'",
+      "Replace with direct claims: 'is', 'does', 'provides', 'enables'",
+      "AI cites confident statements over uncertain ones",
+      "Back claims with data: '50% faster' is better than 'significantly faster'",
+    ],
+  },
+};
+
 export function renderRecommendations(result) {
   const failed = [];
 
@@ -19,15 +133,48 @@ export function renderRecommendations(result) {
     return `<h2 id="recommendations">Recommendations</h2>\n<p style="color:#3fb950;font-size:13px;">All checks passing. Nice.</p>`;
   }
 
-  let html = `<h2 id="recommendations">Top Recommendations</h2>\n<p style="color:#8b949e;font-size:12px;margin-bottom:12px;">Sorted by point impact — fix these first.</p>`;
+  let html = `<h2 id="recommendations">How To Fix It</h2>
+<p style="color:#8b949e;font-size:12px;margin-bottom:16px;">Sorted by point impact. Expand each for step-by-step instructions.</p>`;
 
   for (const rec of top) {
     const category = formatName(rec.category);
-    html += `\n<div class="rec">
-  <div class="rec-title">${escapeHtml(rec.name)}</div>
-  <div class="rec-fix">${escapeHtml(rec.fix)}</div>
-  <div class="rec-impact">+${rec.impact} points · ${category}</div>
-</div>`;
+    const howTo = HOW_TO_FIX[rec.name];
+
+    html += `\n<details class="rec" style="cursor:pointer;">
+  <summary style="display:flex;justify-content:space-between;align-items:center;">
+    <div>
+      <div class="rec-title">${esc(rec.name)}</div>
+      <div class="rec-fix">${esc(rec.fix)}</div>
+    </div>
+    <div style="text-align:right;white-space:nowrap;">
+      <span class="rec-impact">+${rec.impact} pts</span>
+      ${howTo?.time ? `<div style="font-size:11px;color:#8b949e;">${howTo.time}</div>` : ""}
+    </div>
+  </summary>`;
+
+    if (howTo) {
+      html += `\n  <div style="margin-top:12px;padding-top:12px;border-top:1px solid #21262d;">`;
+
+      if (howTo.auto) {
+        html += `\n    <div style="background:#3fb95010;border:1px solid #3fb95033;border-radius:4px;padding:8px 12px;margin-bottom:12px;font-size:12px;color:#3fb950;">${howTo.auto}</div>`;
+      }
+
+      html += `\n    <div style="font-size:12px;color:#c9d1d9;"><strong>Steps:</strong></div>
+    <ol style="margin:8px 0 0 20px;font-size:12px;color:#8b949e;">`;
+      for (const step of howTo.steps) {
+        html += `\n      <li style="margin:4px 0;">${step}</li>`;
+      }
+      html += `\n    </ol>`;
+
+      if (howTo.example) {
+        html += `\n    <div style="margin-top:12px;font-size:12px;color:#c9d1d9;"><strong>Example:</strong></div>
+    <pre style="background:#0d1117;border:1px solid #21262d;border-radius:4px;padding:12px;margin-top:6px;font-size:11px;color:#79c0ff;overflow-x:auto;white-space:pre-wrap;">${esc(howTo.example)}</pre>`;
+      }
+
+      html += `\n  </div>`;
+    }
+
+    html += `\n</details>`;
   }
 
   return html;
@@ -40,7 +187,7 @@ function formatName(camelCase) {
     .trim();
 }
 
-function escapeHtml(str) {
+function esc(str) {
   return str
     .replace(/&/g, "&amp;")
     .replace(/</g, "&lt;")

package/src/history/index.js

@@ -20,7 +20,11 @@ export async function saveResult(result, baseDir) {
     target: result.target,
     agentReadiness: result.agentReadiness.score,
     aiVisibility: result.aiVisibility.score,
-    benchmark: result.benchmark?.score ?? null,
+    benchmarks: {
+      agenticSeo: result.benchmarks?.agenticSeo?.score ?? null,
+      cloudflare: result.benchmarks?.cloudflare?.score ?? null,
+      fern: result.benchmarks?.fern?.score ?? null,
+    },
   });
 
   writeFileSync(historyPath, JSON.stringify(history, null, 2));

package/src/scan.js

@@ -9,7 +9,7 @@ import { runStructuredDataChecks } from "./checks/ai-visibility/structured-data.
 import { runCitationReadinessChecks } from "./checks/ai-visibility/citation-readiness.js";
 import { runAuthorityChecks } from "./checks/ai-visibility/authority.js";
 import { runFreshnessChecks } from "./checks/ai-visibility/freshness.js";
-import { runBenchmark } from "./benchmark/agentic-seo.js";
+import { runAllBenchmarks, printBenchmarks } from "./benchmark/index.js";
 import { saveResult } from "./history/index.js";
 import { generateDashboard } from "./dashboard/generate.js";
 import { readdirSync, readFileSync, existsSync } from "fs";
@@ -40,7 +40,7 @@ export async function scan(opts) {
 
   let benchmarkResult = null;
   if (benchmark) {
-    benchmarkResult = await runBenchmark(mode === "url" ? url : dir);
+    benchmarkResult = await runAllBenchmarks(mode === "url" ? url : dir);
   }
 
   const result = {
@@ -52,7 +52,7 @@ export async function scan(opts) {
     timestamp: new Date().toISOString(),
     agentReadiness,
     aiVisibility,
-    benchmark: benchmarkResult,
+    benchmarks: benchmarkResult,
   };
 
   if (!json) {
@@ -207,7 +207,7 @@ function scoreToGrade(score) {
 }
 
 function printReport(result) {
-  const { score, grade, agentReadiness, aiVisibility, benchmark } = result;
+  const { score, grade, agentReadiness, aiVisibility, benchmarks } = result;
 
   const gradeColor =
     grade === "A"
@@ -260,8 +260,32 @@ function printReport(result) {
     ),
   );
 
-  if (benchmark && benchmark.available) {
-    printBenchmark(benchmark);
+  if (benchmarks) {
+    printBenchmarks(benchmarks);
+  }
+
+  if (failed + partial > 0) {
+    console.log(chalk.bold("  Next steps:\n"));
+    const topFixes = allChecks
+      .filter((c) => !c.passed && c.fix)
+      .sort(
+        (a, b) =>
+          b.maxPoints - (b.points || 0) - (a.maxPoints - (a.points || 0)),
+      )
+      .slice(0, 3);
+    for (const fix of topFixes) {
+      console.log(chalk.dim(`    - ${fix.fix}`));
+    }
+    console.log(
+      chalk.dim(
+        `\n  Run ${chalk.bold("npx aeo-ready scan --fix")} to auto-fix what we can.`,
+      ),
+    );
+    console.log(
+      chalk.dim(
+        "  Open the dashboard for step-by-step guides on everything else.\n",
+      ),
+    );
   }
 }
 
@@ -306,32 +330,6 @@ function printScorecard(name, scorecard) {
   console.log("");
 }
 
-function printBenchmark(benchmark) {
-  console.log(
-    chalk.dim("  ─── Second opinion: agentic-seo ───────────────────\n"),
-  );
-  console.log(
-    `  ${bar(benchmark.score, benchmark.maxScore, 20)} ${chalk.dim(`${benchmark.score}/${benchmark.maxScore}`)}${benchmark.grade ? chalk.dim(` (${benchmark.grade})`) : ""}\n`,
-  );
-
-  if (benchmark.categories) {
-    for (const [, cat] of Object.entries(benchmark.categories)) {
-      const pct =
-        cat.percentage ?? Math.round((cat.score / cat.maxScore) * 100);
-      const icon =
-        pct >= 80
-          ? chalk.green("✓")
-          : pct >= 40
-            ? chalk.yellow("◑")
-            : chalk.red("✗");
-      console.log(
-        `  ${icon} ${cat.name.padEnd(24)} ${bar(cat.score, cat.maxScore, 16)} ${chalk.dim(`${cat.score}/${cat.maxScore} (${pct}%)`)}`,
-      );
-    }
-    console.log("");
-  }
-}
-
 function bar(value, max, width) {
   const filled = max > 0 ? Math.round((value / max) * width) : 0;
   const empty = width - filled;

package/.aeo-ready/dashboard.html

@@ -1,339 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<title>aeo-ready — AI Readiness Dashboard</title>
-<style>
-* { box-sizing: border-box; margin: 0; padding: 0; }
-body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: #0d1117; color: #c9d1d9; display: flex; }
-nav { position: fixed; top: 0; left: 0; width: 200px; height: 100vh; background: #010409; border-right: 1px solid #21262d; padding: 0; overflow-y: auto; z-index: 10; }
-nav h2 { color: #f0f6fc; font-size: 13px; letter-spacing: 0.02em; padding: 20px 16px 14px; border-bottom: 1px solid #21262d; margin: 0 0 8px; }
-nav a { display: block; padding: 6px 16px; font-size: 12px; color: #8b949e; text-decoration: none; transition: color 0.15s; }
-nav a:hover { color: #f0f6fc; }
-nav a.section-head { color: #c9d1d9; font-weight: 600; font-size: 11px; text-transform: uppercase; letter-spacing: 0.04em; margin-top: 12px; }
-main { margin-left: 200px; padding: 32px 40px; max-width: 900px; width: 100%; }
-h1 { color: #f0f6fc; font-size: 24px; margin-bottom: 4px; }
-.subtitle { color: #8b949e; font-size: 13px; margin-bottom: 32px; }
-h2 { color: #f0f6fc; font-size: 18px; margin-top: 40px; margin-bottom: 16px; padding-top: 16px; border-top: 1px solid #21262d; }
-h3 { color: #f0f6fc; font-size: 14px; margin-top: 16px; margin-bottom: 8px; }
-.score-hero { text-align: center; padding: 32px 0; }
-.score-hero .grade { font-size: 64px; font-weight: 700; }
-.score-hero .number { font-size: 24px; color: #8b949e; margin-top: 4px; }
-.score-hero .bar { margin: 16px auto; width: 300px; height: 8px; background: #21262d; border-radius: 4px; overflow: hidden; }
-.score-hero .bar-fill { height: 100%; border-radius: 4px; }
-.grade-a { color: #3fb950; } .grade-b { color: #79c0ff; } .grade-c { color: #d29922; } .grade-d { color: #f85149; } .grade-f { color: #f85149; }
-.bar-a { background: #3fb950; } .bar-b { background: #79c0ff; } .bar-c { background: #d29922; } .bar-d { background: #f85149; } .bar-f { background: #f85149; }
-.scorecard { background: #161b22; border: 1px solid #21262d; border-radius: 8px; padding: 20px; margin: 16px 0; }
-.scorecard-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 16px; }
-.scorecard-header h3 { margin: 0; }
-.scorecard-header .pct { font-size: 20px; font-weight: 600; }
-.category { margin: 12px 0; padding: 8px 0; border-bottom: 1px solid #21262d; }
-.category:last-child { border-bottom: none; }
-.cat-header { display: flex; align-items: center; gap: 8px; margin-bottom: 6px; }
-.cat-name { font-size: 13px; font-weight: 500; flex: 1; }
-.cat-score { font-size: 12px; color: #8b949e; }
-.cat-bar { width: 120px; height: 4px; background: #21262d; border-radius: 2px; overflow: hidden; }
-.cat-bar-fill { height: 100%; border-radius: 2px; }
-.check { font-size: 12px; padding: 2px 0 2px 16px; color: #8b949e; }
-.check.pass { color: #3fb950; }
-.check.fail { color: #f85149; }
-.check .fix { display: block; color: #8b949e; font-size: 11px; padding-left: 16px; margin-top: 2px; }
-table { width: 100%; border-collapse: collapse; margin: 12px 0; }
-th, td { text-align: left; padding: 8px 12px; font-size: 12px; border-bottom: 1px solid #21262d; }
-th { color: #8b949e; font-weight: 600; }
-.trend { color: #3fb950; } .regression { color: #f85149; }
-.rec { background: #161b22; border: 1px solid #21262d; border-radius: 6px; padding: 12px 16px; margin: 8px 0; }
-.rec-title { font-size: 13px; font-weight: 500; color: #f0f6fc; }
-.rec-fix { font-size: 12px; color: #8b949e; margin-top: 4px; }
-.rec-impact { font-size: 11px; color: #d29922; margin-top: 4px; }
-svg { display: block; margin: 16px 0; }
-</style>
-</head>
-<body>
-
-<nav>
-  <h2>aeo-ready</h2>
-  <a href="#overall" class="section-head">Overall Score</a>
-  <a href="#agent-readiness" class="section-head">Agent Readiness</a>
-  <a href="#ai-visibility" class="section-head">AI Visibility</a>
-  <a href="#trends" class="section-head">Trends</a>
-  <a href="#history" class="section-head">History</a>
-  <a href="#recommendations" class="section-head">Recommendations</a>
-</nav>
-
-<main>
-
-<h1>AI Readiness Dashboard</h1>
-<p class="subtitle">/Users/katlaszlo/Desktop/Github-Wiki/GitHub/agent-web · Updated 2026-05-18</p>
-
-<!-- SECTION:overall-score -->
-<div class="score-hero" id="overall">
-  <div class="grade grade-c">C</div>
-  <div class="number">50 / 100</div>
-  <div class="bar"><div class="bar-fill bar-c" style="width:50%"></div></div>
-  <div style="display:flex;justify-content:center;gap:40px;margin-top:16px;font-size:13px;">
-    <span>Agent Readiness: <strong>22/50</strong></span>
-    <span>AI Visibility: <strong>28/50</strong></span>
-  </div>
-</div>
-<div style="text-align:center;padding:12px 24px;margin:16px auto;max-width:500px;background:#d2992210;border:1px solid #d2992233;border-radius:6px;font-size:13px;color:#d29922;">
-  <strong>Agent Readiness is low.</strong> AI engines can't cite what they can't read.<br>
-  <span style="color:#8b949e;">Fix the agent side first. Visibility follows.</span>
-</div>
-<div style="margin-top:24px;padding:20px;background:#161b22;border:1px solid #21262d;border-radius:8px;">
-  <div style="font-size:13px;font-weight:600;color:#f0f6fc;margin-bottom:12px;">How you compare</div>
-  <div style="display:flex;align-items:center;gap:8px;margin:6px 0;">
-    <span style="width:120px;font-size:12px;color:#8b949e;">Cloudflare</span>
-    <div style="flex:1;height:4px;background:#21262d;border-radius:2px;overflow:hidden;">
-      <div style="width:55%;height:100%;background:#30363d;border-radius:2px;"></div>
-    </div>
-    <span style="font-size:11px;color:#8b949e;width:32px;text-align:right;">55</span>
-  </div>
-  <div style="display:flex;align-items:center;gap:8px;margin:6px 0;">
-    <span style="width:120px;font-size:12px;color:#8b949e;">Supabase</span>
-    <div style="flex:1;height:4px;background:#21262d;border-radius:2px;overflow:hidden;">
-      <div style="width:52%;height:100%;background:#30363d;border-radius:2px;"></div>
-    </div>
-    <span style="font-size:11px;color:#8b949e;width:32px;text-align:right;">52</span>
-  </div>
-  <div style="display:flex;align-items:center;gap:8px;margin:6px 0;">
-    <span style="width:120px;font-size:12px;color:#f0f6fc;font-weight:600;">You</span>
-    <div style="flex:1;height:4px;background:#21262d;border-radius:2px;overflow:hidden;">
-      <div style="width:50%;height:100%;background:#d29922;border-radius:2px;"></div>
-    </div>
-    <span style="font-size:11px;color:#f0f6fc;width:32px;text-align:right;font-weight:600;">50</span>
-  </div>
-  <div style="display:flex;align-items:center;gap:8px;margin:6px 0;">
-    <span style="width:120px;font-size:12px;color:#8b949e;">Vercel</span>
-    <div style="flex:1;height:4px;background:#21262d;border-radius:2px;overflow:hidden;">
-      <div style="width:48%;height:100%;background:#30363d;border-radius:2px;"></div>
-    </div>
-    <span style="font-size:11px;color:#8b949e;width:32px;text-align:right;">48</span>
-  </div>
-  <div style="display:flex;align-items:center;gap:8px;margin:6px 0;">
-    <span style="width:120px;font-size:12px;color:#8b949e;">Anthropic Docs</span>
-    <div style="flex:1;height:4px;background:#21262d;border-radius:2px;overflow:hidden;">
-      <div style="width:43%;height:100%;background:#30363d;border-radius:2px;"></div>
-    </div>
-    <span style="font-size:11px;color:#8b949e;width:32px;text-align:right;">43</span>
-  </div>
-  <div style="display:flex;align-items:center;gap:8px;margin:6px 0;">
-    <span style="width:120px;font-size:12px;color:#8b949e;">Stripe</span>
-    <div style="flex:1;height:4px;background:#21262d;border-radius:2px;overflow:hidden;">
-      <div style="width:33%;height:100%;background:#30363d;border-radius:2px;"></div>
-    </div>
-    <span style="font-size:11px;color:#8b949e;width:32px;text-align:right;">33</span>
-  </div>
-  <div style="display:flex;align-items:center;gap:8px;margin:6px 0;">
-    <span style="width:120px;font-size:12px;color:#8b949e;">Average site</span>
-    <div style="flex:1;height:4px;background:#21262d;border-radius:2px;overflow:hidden;">
-      <div style="width:25%;height:100%;background:#30363d;border-radius:2px;"></div>
-    </div>
-    <span style="font-size:11px;color:#8b949e;width:32px;text-align:right;">25</span>
-  </div>
-</div>
-<!-- /SECTION:overall-score -->
-
-<!-- SECTION:agent-readiness-scorecard -->
-<div class="scorecard" id="agent-readiness">
-  <div class="scorecard-header">
-    <h3>Agent Readiness</h3>
-    <span class="pct grade-c">22/50 (44%)</span>
-  </div>
-  <div class="category">
-    <div class="cat-header">
-      <span class="cat-name">Discovery</span>
-      <span class="cat-score">0/12</span>
-      <div class="cat-bar"><div class="cat-bar-fill" style="width:0%;background:#f85149"></div></div>
-    </div>
-    <div class="check fail">- llms.txt [0/4]<span class="fix">No llms.txt found. Create one describing what your site does for AI agents.</span></div>
-    <div class="check fail">- robots.txt AI crawlers [0/3]<span class="fix">No robots.txt found. Add one with explicit AI crawler rules.</span></div>
-    <div class="check fail">- sitemap.xml [0/2]<span class="fix">No sitemap.xml found.</span></div>
-    <div class="check fail">- AI-friendly meta tags [0/3]<span class="fix">No HTML available to check meta tags.</span></div>
-  </div>
-  <div class="category">
-    <div class="cat-header">
-      <span class="cat-name">Content Structure</span>
-      <span class="cat-score">10/15</span>
-      <div class="cat-bar"><div class="cat-bar-fill" style="width:67%;background:#d29922"></div></div>
-    </div>
-    <div class="check pass">+ Markdown content available [3]</div>
-    <div class="check pass">+ Heading hierarchy [3]</div>
-    <div class="check pass">+ Token budget compliance [4]</div>
-    <div class="check fail">- Front-loading (first 500 tokens) [1/3]<span class="fix">Most pages don't answer what/why/how in first 500 tokens. Lead with the point.</span></div>
-    <div class="check fail">- Copy-for-AI affordances [0/2]<span class="fix">No copy-for-AI affordances. Add a &quot;Copy as Markdown&quot; button on doc pages.</span></div>
-  </div>
-  <div class="category">
-    <div class="cat-header">
-      <span class="cat-name">Capability</span>
-      <span class="cat-score">4/13</span>
-      <div class="cat-bar"><div class="cat-bar-fill" style="width:31%;background:#f85149"></div></div>
-    </div>
-    <div class="check pass">+ AGENTS.md / CLAUDE.md [4]</div>
-    <div class="check fail">- agents.json manifest [0/3]<span class="fix">No agents.json or .well-known/agent.json found.</span></div>
-    <div class="check fail">- OpenAPI spec [0/3]<span class="fix">No OpenAPI spec found. Add openapi.json or openapi.yaml.</span></div>
-    <div class="check fail">- Content negotiation [0/3]<span class="fix">No content negotiation setup. Consider serving markdown for Accept: text/markdown requests.</span></div>
-  </div>
-  <div class="category">
-    <div class="cat-header">
-      <span class="cat-name">Actionable</span>
-      <span class="cat-score">8/10</span>
-      <div class="cat-bar"><div class="cat-bar-fill" style="width:80%;background:#3fb950"></div></div>
-    </div>
-    <div class="check pass">+ Machine-readable contact [3]</div>
-    <div class="check pass">+ Programmatic pricing [3]</div>
-    <div class="check fail">- API endpoint [1/2]<span class="fix">API references found but no formal spec. Add OpenAPI spec.</span></div>
-    <div class="check pass">+ SDK / integration manifest [2]</div>
-  </div>
-</div>
-<!-- /SECTION:agent-readiness-scorecard -->
-
-<!-- SECTION:ai-visibility-scorecard -->
-<div class="scorecard" id="ai-visibility">
-  <div class="scorecard-header">
-    <h3>AI Visibility</h3>
-    <span class="pct grade-c">28/50 (56%)</span>
-  </div>
-  <div class="category">
-    <div class="cat-header">
-      <span class="cat-name">Structured Data</span>
-      <span class="cat-score">6/12</span>
-      <div class="cat-bar"><div class="cat-bar-fill" style="width:50%;background:#d29922"></div></div>
-    </div>
-    <div class="check fail">- Schema.org markup [2/4]<span class="fix">Schema.org present but: type doesn't match site category, missing required fields.</span></div>
-    <div class="check pass">+ FAQ markup [3]</div>
-    <div class="check pass">+ Rich schemas (Breadcrumb/HowTo/Product) [3]</div>
-    <div class="check fail">- Open Graph + meta description [0/2]<span class="fix">No Open Graph or meta description tags. AI systems use these for page summaries.</span></div>
-  </div>
-  <div class="category">
-    <div class="cat-header">
-      <span class="cat-name">Citation Readiness</span>
-      <span class="cat-score">4/15</span>
-      <div class="cat-bar"><div class="cat-bar-fill" style="width:27%;background:#f85149"></div></div>
-    </div>
-    <div class="check fail">- Direct answer formatting [1/4]<span class="fix">Most pages don't lead with a concise summary (40-60 words). This is what AI systems cite.</span></div>
-    <div class="check fail">- Question-based headings [1/4]<span class="fix">Very few question-based headings. Rephrase key H2/H3s as questions users would ask AI.</span></div>
-    <div class="check pass">+ Citation-friendly structure [4]</div>
-    <div class="check fail">- Definitive statements [2/3]<span class="fix">Some definitive statements but too much hedging. AI cites confident claims over uncertain ones.</span></div>
-  </div>
-  <div class="category">
-    <div class="cat-header">
-      <span class="cat-name">Authority</span>
-      <span class="cat-score">10/13</span>
-      <div class="cat-bar"><div class="cat-bar-fill" style="width:77%;background:#d29922"></div></div>
-    </div>
-    <div class="check pass">+ E-E-A-T signals [4]</div>
-    <div class="check pass">+ Entity optimization [3]</div>
-    <div class="check pass">+ External validation & references [3]</div>
-  </div>
-  <div class="category">
-    <div class="cat-header">
-      <span class="cat-name">Freshness</span>
-      <span class="cat-score">8/10</span>
-      <div class="cat-bar"><div class="cat-bar-fill" style="width:80%;background:#3fb950"></div></div>
-    </div>
-    <div class="check pass">+ Last modified dates [3]</div>
-    <div class="check fail">- Publication cadence [0/2]<span class="fix">Infrequent updates (~541 day gaps). Regular publishing signals authority to AI systems.</span></div>
-    <div class="check pass">+ Content recency [3]</div>
-    <div class="check pass">+ Evergreen content flagged [2]</div>
-  </div>
-</div>
-<!-- /SECTION:ai-visibility-scorecard -->
-
-<!-- SECTION:trend-chart -->
-<h2 id="trends">Score Trends</h2>
-<svg width="700" height="200" xmlns="http://www.w3.org/2000/svg">
-<line x1="40" y1="170" x2="680" y2="170" stroke="#21262d" stroke-width="1"/>
-<text x="32" y="174" text-anchor="end" fill="#8b949e" font-size="10">0</text>
-<line x1="40" y1="132.5" x2="680" y2="132.5" stroke="#21262d" stroke-width="1"/>
-<text x="32" y="136.5" text-anchor="end" fill="#8b949e" font-size="10">25</text>
-<line x1="40" y1="95" x2="680" y2="95" stroke="#21262d" stroke-width="1"/>
-<text x="32" y="99" text-anchor="end" fill="#8b949e" font-size="10">50</text>
-<line x1="40" y1="57.5" x2="680" y2="57.5" stroke="#21262d" stroke-width="1"/>
-<text x="32" y="61.5" text-anchor="end" fill="#8b949e" font-size="10">75</text>
-<line x1="40" y1="20" x2="680" y2="20" stroke="#21262d" stroke-width="1"/>
-<text x="32" y="24" text-anchor="end" fill="#8b949e" font-size="10">100</text>
-<text x="40" y="195" text-anchor="middle" fill="#8b949e" font-size="10">05-18</text>
-<text x="680" y="195" text-anchor="middle" fill="#8b949e" font-size="10">05-18</text>
-<path d="M 40.0 80.0 L 680.0 104.0" fill="none" stroke="#79c0ff" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-<path d="M 40.0 89.0 L 680.0 86.0" fill="none" stroke="#d29922" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-<path d="M 40.0 84.5 L 680.0 95.0" fill="none" stroke="#f0f6fc" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-<circle cx="40.0" cy="84.5" r="3" fill="#f0f6fc"/>
-<circle cx="680.0" cy="95.0" r="3" fill="#f0f6fc"/>
-<text x="680" y="15" text-anchor="end" fill="#f0f6fc" font-size="10">Overall</text>
-<text x="600" y="15" text-anchor="end" fill="#79c0ff" font-size="10">Agent (x2)</text>
-<text x="500" y="15" text-anchor="end" fill="#d29922" font-size="10">Visibility (x2)</text>
-</svg>
-<!-- /SECTION:trend-chart -->
-
-<!-- SECTION:history-table -->
-<h2 id="history">Scan History</h2>
-<table>
-<tr><th>Date</th><th>Score</th><th>Grade</th><th>Agent</th><th>Visibility</th><th>Delta</th></tr>
-<tr>
-  <td>2026-05-18</td>
-  <td>50/100</td>
-  <td class="grade-c">C</td>
-  <td>22/50</td>
-  <td>28/50</td>
-  <td><span class="regression">-7</span></td>
-</tr>
-<tr>
-  <td>2026-05-18</td>
-  <td>57/100</td>
-  <td class="grade-c">C</td>
-  <td>30/50</td>
-  <td>27/50</td>
-  <td><span style="color:#8b949e">—</span></td>
-</tr>
-</table>
-<!-- /SECTION:history-table -->
-
-<!-- SECTION:recommendations -->
-<h2 id="recommendations">Top Recommendations</h2>
-<p style="color:#8b949e;font-size:12px;margin-bottom:12px;">Sorted by point impact — fix these first.</p>
-<div class="rec">
-  <div class="rec-title">llms.txt</div>
-  <div class="rec-fix">No llms.txt found. Create one describing what your site does for AI agents.</div>
-  <div class="rec-impact">+4 points · Discovery</div>
-</div>
-<div class="rec">
-  <div class="rec-title">robots.txt AI crawlers</div>
-  <div class="rec-fix">No robots.txt found. Add one with explicit AI crawler rules.</div>
-  <div class="rec-impact">+3 points · Discovery</div>
-</div>
-<div class="rec">
-  <div class="rec-title">AI-friendly meta tags</div>
-  <div class="rec-fix">No HTML available to check meta tags.</div>
-  <div class="rec-impact">+3 points · Discovery</div>
-</div>
-<div class="rec">
-  <div class="rec-title">agents.json manifest</div>
-  <div class="rec-fix">No agents.json or .well-known/agent.json found.</div>
-  <div class="rec-impact">+3 points · Capability</div>
-</div>
-<div class="rec">
-  <div class="rec-title">OpenAPI spec</div>
-  <div class="rec-fix">No OpenAPI spec found. Add openapi.json or openapi.yaml.</div>
-  <div class="rec-impact">+3 points · Capability</div>
-</div>
-<div class="rec">
-  <div class="rec-title">Content negotiation</div>
-  <div class="rec-fix">No content negotiation setup. Consider serving markdown for Accept: text/markdown requests.</div>
-  <div class="rec-impact">+3 points · Capability</div>
-</div>
-<div class="rec">
-  <div class="rec-title">Direct answer formatting</div>
-  <div class="rec-fix">Most pages don't lead with a concise summary (40-60 words). This is what AI systems cite.</div>
-  <div class="rec-impact">+3 points · Citation Readiness</div>
-</div>
-<div class="rec">
-  <div class="rec-title">Question-based headings</div>
-  <div class="rec-fix">Very few question-based headings. Rephrase key H2/H3s as questions users would ask AI.</div>
-  <div class="rec-impact">+3 points · Citation Readiness</div>
-</div>
-<!-- /SECTION:recommendations -->
-
-</main>
-</body>
-</html>