npm - aeo-ready - Versions diffs - 1.7.1 → 1.7.3 - Mend

aeo-ready 1.7.1 → 1.7.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "aeo-ready",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "AEO benchmark aggregator. One scan, every score. Collects agentic-seo, Cloudflare, Fern, Vercel, and AgentGrade in one report.",
   "type": "module",
   "bin": {

package/src/recommendations.js CHANGED Viewed

@@ -1,9 +1,6 @@
 import chalk from "chalk";
 import { execSync } from "child_process";
-import { existsSync } from "fs";
-import { join } from "path";
 import { createInterface } from "readline";
-import { runFixes } from "./fix.js";
 const BENCHMARK_NAMES = {
   cloudflare: "Cloudflare",
@@ -24,9 +21,11 @@ const RECOMMENDATION_MAP = [
     key: "llms-txt",
     label: "Create and link llms.txt",
     detail:
-      'Create llms.txt with site overview, then add <link rel="llms-txt" href="/llms.txt"> to your HTML <head>',
+      'Create llms.txt with site overview, then add <link rel="llms-txt" href="/llms.txt"> to your HTML <head>. Also add a <link rel="alternate" type="text/markdown"> on each page that has a markdown version.',
     match: (id) =>
-      /llms-txt|llms.*linked|llms-full.*linked|llms.*coverage/i.test(id),
+      /llms-txt|llms.*linked|llms-full.*linked|llms.*coverage|markdown link alternate/i.test(
+        id,
+      ),
   },
   {
     key: "agents-txt",
@@ -39,7 +38,7 @@ const RECOMMENDATION_MAP = [
     key: "content-negotiation",
     label: "Support content negotiation",
     detail:
-      "Return markdown when requests include Accept: text/markdown. Add Vary: Accept header for proper caching.",
+      "Return markdown when requests include Accept: text/markdown. Return the content type the client actually preferred, respecting order and q-values per RFC 9110. Add Vary: Accept header for caching.",
     match: (id) =>
       /content.negotiation|agent ua.*markdown|accept.*markdown|accept.*text.*returns|accept.*json.*returns|preferred content.type|^vary/i.test(
         id,
@@ -49,16 +48,18 @@ const RECOMMENDATION_MAP = [
     key: "md-urls",
     label: "Serve markdown at .md URLs",
     detail:
-      "Make pages available at .md extensions (e.g. /docs/page.md returns markdown)",
+      "Make pages available at .md extensions (e.g. /docs/page.md returns markdown). Missing pages should return markdown 404, not HTML.",
     match: (id) =>
-      /markdown.url.support|\.md.*url.*markdown|\.md url/i.test(id),
+      /markdown.url.support|\.md.*url.*markdown|\.md url|missing page.*markdown/i.test(
+        id,
+      ),
   },
   {
     key: "content-structure",
     label: "Improve content structure for agents",
     detail:
-      "Move nav/chrome below main content so agents find content earlier. Add frontmatter to markdown pages.",
-    match: (id) => /content.start.position|frontmatter/i.test(id),
+      "Move nav/chrome below main content so agents find content earlier. Add YAML frontmatter (title, description, date) to markdown pages.",
+    match: (id) => /content.start.position|^frontmatter$/i.test(id),
   },
   {
     key: "markdown-parity",
@@ -93,7 +94,7 @@ const RECOMMENDATION_MAP = [
     detail:
       "Implement WebFinger, DID Document, A2A Agent Card, and/or WebMCP manifest for agent discovery",
     match: (id) =>
-      /webfinger|did document|nostr|at protocol|agent card|webmcp|apple app links|android asset links/i.test(
+      /webfinger|did document|nostr|at protocol|agent card.*published|agent card.*verified|webmcp|apple app links|android asset links/i.test(
         id,
       ),
   },
@@ -120,22 +121,17 @@ const RECOMMENDATION_MAP = [
   },
   {
     key: "signatures",
-    label: "Publish signatures directory",
+    label: "Publish signatures directory and public keys",
     detail:
-      "Serve /.well-known/http-message-signatures-directory for request verification",
-    match: (id) => /signatures directory|public keys/i.test(id),
-  },
-  {
-    key: "members",
-    label: "Declare team members",
-    detail: "Add a members array to your signatures directory or agent card",
-    match: (id) => /members declared/i.test(id),
+      "Serve /.well-known/http-message-signatures-directory with agent identity and public keys (RFC 9421)",
+    match: (id) =>
+      /signatures directory|public keys|members declared/i.test(id),
   },
   {
     key: "form-annotations",
     label: "Add form tool annotations",
     detail:
-      "Add tool-name and tool-description attributes to forms for agent understanding",
+      "Add tool-name and tool-description attributes to <form> elements for browser AI agents",
     match: (id) => /form tool annotations/i.test(id),
   },
   {
@@ -225,41 +221,21 @@ function tierDescription(count) {
   return "flagged by 1 benchmark";
 }
-function printRecommendations(recs) {
-  let currentTier = null;
-  let num = 1;
-  console.log("");
-  for (const rec of recs) {
-    const tier = tierLabel(rec.priority);
-    if (tier !== currentTier) {
-      currentTier = tier;
-      const color =
-        rec.priority >= 3
-          ? chalk.red
-          : rec.priority >= 2
-            ? chalk.yellow
-            : chalk.dim;
-      console.log(
-        `  ${color.bold(tier)} ${chalk.dim(`(${tierDescription(rec.priority)})`)}`,
-      );
-    }
-    const benchmarkList = rec.benchmarks
-      .map((b) => BENCHMARK_NAMES[b])
-      .join(" · ");
-    console.log(`    ${chalk.dim(`${num}.`)} ${rec.label}`);
-    console.log(`       ${chalk.dim(benchmarkList)}`);
-    num++;
-  }
-  console.log("");
-}
 function generateAgentPrompt(result, recs) {
   const lines = [];
   lines.push(
     `My site ${result.url} scored ${result.averageScore}/100 on aeo-ready (AEO readiness scanner).`,
   );
-  lines.push(`Fix these issues to improve AI/agent discoverability:\n`);
+  lines.push("Fix these issues to improve AI/agent discoverability.");
+  lines.push(
+    "Items are ordered by priority — issues flagged by multiple benchmarks matter most.",
+  );
+  lines.push(
+    "This scan covers benchmarks across different site types (content sites, APIs, developer platforms).",
+  );
+  lines.push(
+    "Not every recommendation may apply to this site — review each and prioritize accordingly.\n",
+  );
   let currentTier = null;
   let num = 1;
@@ -281,11 +257,15 @@ function generateAgentPrompt(result, recs) {
   }
   lines.push("");
+  lines.push("## Instructions");
   lines.push(
-    "For any issues that can't be fixed programmatically, outline them for me",
+    "- Fix what you can programmatically. For each fix, explain what you changed.",
   );
   lines.push(
-    "with clear step-by-step instructions on how to address them manually.",
+    "- For anything that requires infrastructure or configuration changes you can't make,",
+  );
+  lines.push(
+    "  list it separately with clear step-by-step instructions I can follow manually.",
   );
   lines.push("");
   lines.push(`Re-scan after: npx aeo-ready scan ${result.url}`);
@@ -318,31 +298,6 @@ function copyToClipboard(text) {
   }
 }
-function detectLocalProject(dir) {
-  if (dir) return dir;
-  const cwd = process.cwd();
-  const indicators = [
-    "package.json",
-    "index.html",
-    "next.config.js",
-    "next.config.mjs",
-    "next.config.ts",
-    "nuxt.config.ts",
-    "astro.config.mjs",
-    "vite.config.ts",
-    "vite.config.js",
-    "gatsby-config.js",
-    "angular.json",
-    "svelte.config.js",
-    "remix.config.js",
-    "public",
-  ];
-  for (const f of indicators) {
-    if (existsSync(join(cwd, f))) return cwd;
-  }
-  return null;
-}
 function ask(question) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
@@ -353,7 +308,7 @@ function ask(question) {
   });
 }
-export async function showRecommendations(result, dir) {
+export async function showRecommendations(result) {
   const recs = buildRecommendations(result);
   if (recs.length === 0) return;
@@ -365,17 +320,13 @@ export async function showRecommendations(result, dir) {
   console.log(`\n  ${chalk.bold(summary)}\n`);
-  const localDir = detectLocalProject(dir);
+  const prompt = generateAgentPrompt(result, recs);
-  const options = [];
-  options.push(["v", "View recommendations"]);
-  options.push(["c", "Copy prompt for AI agent"]);
-  if (localDir) {
-    options.push(["f", "Fix now"]);
-  }
-  options.push(["q", "Done"]);
-  const optStr = options
+  const optStr = [
+    ["v", "View prompt"],
+    ["c", "Copy prompt"],
+    ["q", "Done"],
+  ]
     .map(([key, label]) => `${chalk.bold(`[${key}]`)} ${label}`)
     .join("  ");
@@ -383,21 +334,21 @@ export async function showRecommendations(result, dir) {
     const answer = await ask(`  ${optStr} `);
     if (answer === "v") {
-      printRecommendations(recs);
+      console.log("");
+      console.log(
+        prompt
+          .split("\n")
+          .map((line) => `  ${line}`)
+          .join("\n"),
+      );
+      console.log("");
     } else if (answer === "c") {
-      const prompt = generateAgentPrompt(result, recs);
       const copied = copyToClipboard(prompt);
       if (copied) {
         console.log(chalk.green("\n  Copied to clipboard.\n"));
       } else {
-        console.log(
-          chalk.dim("\n  Could not copy — here are the instructions:\n"),
-        );
-        console.log(prompt);
-        console.log("");
+        console.log(chalk.dim("\n  Could not copy to clipboard.\n"));
       }
-    } else if (answer === "f" && localDir) {
-      await runFixes(result, localDir);
       break;
     } else {
       break;

package/src/scan.js CHANGED Viewed

@@ -37,7 +37,7 @@ export async function scan(opts) {
   await saveResult(result, baseDir);
   if (!json && averageScore < 100 && process.stdin.isTTY) {
-    await showRecommendations(result, dir);
+    await showRecommendations(result);
   }
   return result;