ax-audit 4.2.1 → 6.0.0

package/dist/checks/llms-txt.d.ts

@@ -1,19 +0,0 @@
-import type { CheckContext, CheckResult, CheckMeta } from '../types.js';
-/**
- * "llms-txt" — the curated index a site publishes for language models.
- *
- * Two things are worth being honest about in the report. Google has stated
- * plainly that Search ignores llms.txt, and adoption studies find the large
- * majority of published files are never fetched by any AI search crawler. The
- * consumers that *do* read it are coding agents — Claude Code, Cursor,
- * OpenCode — which makes it a developer-tooling signal rather than a search
- * visibility one. A report that implies otherwise is selling something.
- *
- * The specification was revised in 2026 ("v2"), adding three things this check
- * now looks for: files scoped to a subpath, a `describedby` link relation
- * pointing a page at the file that covers it, and per-page Markdown mirrors
- * reached by appending `.md`.
- */
-export declare const meta: CheckMeta;
-export default function check(ctx: CheckContext): Promise<CheckResult>;
-//# sourceMappingURL=llms-txt.d.ts.map

package/dist/checks/llms-txt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../../src/checks/llms-txt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAW,MAAM,aAAa,CAAC;AAKjF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI,EAAE,SAKlB,CAAC;AAOF,wBAA8B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6H3E"}

package/dist/checks/llms-txt.js

@@ -1,281 +0,0 @@
-import { guideUrl } from '../guide-urls.js';
-import { buildResult, checkContentType } from './utils.js';
-import { findLinkTags } from './html-utils.js';
-import { parseLinkHeader } from './http-headers.js';
-/**
- * "llms-txt" — the curated index a site publishes for language models.
- *
- * Two things are worth being honest about in the report. Google has stated
- * plainly that Search ignores llms.txt, and adoption studies find the large
- * majority of published files are never fetched by any AI search crawler. The
- * consumers that *do* read it are coding agents — Claude Code, Cursor,
- * OpenCode — which makes it a developer-tooling signal rather than a search
- * visibility one. A report that implies otherwise is selling something.
- *
- * The specification was revised in 2026 ("v2"), adding three things this check
- * now looks for: files scoped to a subpath, a `describedby` link relation
- * pointing a page at the file that covers it, and per-page Markdown mirrors
- * reached by appending `.md`.
- */
-export const meta = {
-    id: 'llms-txt',
-    name: 'LLMs.txt',
-    description: 'Checks /llms.txt presence, spec compliance, and link health',
-    category: 'discovery',
-};
-/** How many links to sample for liveness. Enough to catch rot without a crawl. */
-const LINK_SAMPLE_SIZE = 15;
-/** A file larger than this is unlikely to fit an agent's context budget usefully. */
-const LARGE_FILE_BYTES = 50_000;
-export default async function check(ctx) {
-    const start = performance.now();
-    const findings = [];
-    let score = 100;
-    const res = await ctx.fetch(`${ctx.url}/llms.txt`);
-    if (!res.ok) {
-        findings.push({
-            status: 'fail',
-            message: '/llms.txt not found',
-            detail: `HTTP ${res.status || 'network error'}`,
-            hint: 'Create a /llms.txt file at your site root following the llmstxt.org specification. It should be a Markdown file starting with "# Your Site Name" and include a description, sections, and links.',
-            learnMoreUrl: guideUrl(meta.id, 'not-found'),
-        });
-        return buildResult(meta, 0, findings, start);
-    }
-    findings.push({ status: 'pass', message: '/llms.txt exists' });
-    const ctFinding = checkContentType(res, ['text/plain', 'text/markdown'], {
-        checkId: meta.id,
-        resourceLabel: '/llms.txt',
-        anchor: 'wrong-content-type',
-    });
-    if (ctFinding) {
-        findings.push(ctFinding);
-        score -= 5;
-    }
-    else {
-        findings.push({
-            status: 'pass',
-            message: `/llms.txt Content-Type OK (${res.headers['content-type']?.split(';')[0]})`,
-        });
-    }
-    const text = res.body;
-    const lines = text
-        .split('\n')
-        .map((l) => l.trim())
-        .filter(Boolean);
-    if (!lines[0]?.startsWith('# ')) {
-        findings.push({
-            status: 'warn',
-            message: 'Missing H1 heading (first line should start with "# ")',
-            hint: 'Add an H1 heading as the first line of your llms.txt file, e.g.: # Your Site Name',
-            learnMoreUrl: guideUrl(meta.id, 'missing-h1'),
-        });
-        score -= 15;
-    }
-    else {
-        findings.push({ status: 'pass', message: `H1 heading: "${lines[0].slice(2)}"` });
-    }
-    const hasBlockquote = lines.some((l) => l.startsWith('> '));
-    if (!hasBlockquote) {
-        findings.push({
-            status: 'warn',
-            message: 'No blockquote description found ("> ...")',
-            hint: 'Add a blockquote description after the H1 heading, e.g.: > A brief summary of your site for AI agents.',
-            learnMoreUrl: guideUrl(meta.id, 'missing-blockquote'),
-        });
-        score -= 10;
-    }
-    else {
-        findings.push({ status: 'pass', message: 'Blockquote description present' });
-    }
-    const sections = lines.filter((l) => l.startsWith('## '));
-    if (sections.length === 0) {
-        findings.push({
-            status: 'warn',
-            message: 'No section headings found (## ...)',
-            hint: 'Organize your llms.txt content with ## section headings (e.g., ## About, ## API, ## Documentation).',
-            learnMoreUrl: guideUrl(meta.id, 'missing-sections'),
-        });
-        score -= 10;
-    }
-    else {
-        findings.push({ status: 'pass', message: `${sections.length} section heading(s) found` });
-    }
-    const linkPattern = /\[([^\]]+)\]\((https?:\/\/[^)]+)\)/g;
-    const links = [...text.matchAll(linkPattern)];
-    if (links.length === 0) {
-        findings.push({
-            status: 'warn',
-            message: 'No Markdown links found',
-            hint: 'Add Markdown links to relevant pages: [Page Title](https://example.com/page). This helps AI agents navigate your site.',
-            learnMoreUrl: guideUrl(meta.id, 'no-links'),
-        });
-        score -= 10;
-    }
-    else {
-        findings.push({ status: 'pass', message: `${links.length} link(s) found` });
-    }
-    if (text.length < 100) {
-        findings.push({
-            status: 'warn',
-            message: 'Content appears minimal (< 100 characters)',
-            hint: 'Expand your llms.txt with more descriptive content about your site, its purpose, and available resources.',
-            learnMoreUrl: guideUrl(meta.id, 'minimal-content'),
-        });
-        score -= 10;
-    }
-    const fullRes = await ctx.fetch(`${ctx.url}/llms-full.txt`);
-    if (fullRes.ok) {
-        findings.push({ status: 'pass', message: '/llms-full.txt also available (bonus)' });
-        score = Math.min(100, score + 10);
-    }
-    else {
-        findings.push({
-            status: 'warn',
-            message: '/llms-full.txt not found (optional but recommended)',
-            hint: 'Create a /llms-full.txt with expanded content — full documentation, API details, and comprehensive site information for AI agents.',
-            learnMoreUrl: guideUrl(meta.id, 'missing-full'),
-        });
-    }
-    // Everything below is informational in 3.x: new findings inside a weighted
-    // check must not move the score.
-    reportSize(text, findings);
-    reportDescribedBy(ctx, findings);
-    await reportLinkHealth(ctx, links, findings);
-    await reportMarkdownMirror(ctx, findings);
-    reportConsumers(findings);
-    return buildResult(meta, score, findings, start);
-}
-/* ── llms.txt v2 additions and link health (informational in 3.x) ───────── */
-/** A file too large to be read whole is a file an agent truncates. */
-function reportSize(text, findings) {
-    const bytes = Buffer.byteLength(text, 'utf-8');
-    if (bytes <= LARGE_FILE_BYTES)
-        return;
-    findings.push({
-        status: 'warn',
-        message: `/llms.txt is ${Math.round(bytes / 1024)} KB`,
-        hint: 'An index this large competes with the content it points at for context budget. Keep llms.txt to a map of links ' +
-            'and move the prose into llms-full.txt or the pages themselves.',
-        learnMoreUrl: guideUrl(meta.id, 'large-file'),
-    });
-}
-/**
- * llms.txt v2 added a `describedby` relation so a page can point at the file
- * covering it. Without it, an agent that landed deep in the site has to guess
- * that a root llms.txt exists.
- */
-function reportDescribedBy(ctx, findings) {
-    const inHeader = parseLinkHeader(ctx.headers?.['link'] ?? '').some((entry) => (entry.params['rel'] ?? '').split(/\s+/).includes('describedby'));
-    const inHtml = findLinkTags(ctx.html ?? '', 'describedby').length > 0;
-    if (inHeader || inHtml) {
-        findings.push({
-            status: 'pass',
-            message: `Pages point at their llms.txt via rel="describedby" (${inHeader ? 'Link header' : 'HTML link'})`,
-        });
-        return;
-    }
-    findings.push({
-        status: 'warn',
-        message: 'No rel="describedby" link to llms.txt',
-        hint: 'llms.txt v2 uses this relation so a page can name the file that covers it. Add ' +
-            '<link rel="describedby" href="/llms.txt"> or the equivalent Link header, so an agent that landed on a deep ' +
-            'page does not have to guess that an index exists.',
-        learnMoreUrl: guideUrl(meta.id, 'no-describedby'),
-    });
-}
-/**
- * Sample the links and report the dead ones. An index of broken links is the
- * failure mode this file is most prone to: it is written once and never
- * revalidated, while the site moves underneath it.
- */
-async function reportLinkHealth(ctx, links, findings) {
-    const urls = [...new Set(links.map((m) => m[2]))];
-    if (urls.length === 0)
-        return;
-    const duplicates = links.length - urls.length;
-    if (duplicates > 0) {
-        findings.push({
-            status: 'warn',
-            message: `${duplicates} duplicate link(s) in llms.txt`,
-            hint: 'Each URL should appear once. Duplicates spend an agent’s budget re-reading what it already has.',
-            learnMoreUrl: guideUrl(meta.id, 'duplicate-links'),
-        });
-    }
-    const sample = urls.slice(0, LINK_SAMPLE_SIZE);
-    const dead = [];
-    const redirected = [];
-    for (const url of sample) {
-        const head = await ctx.fetch(url, { method: 'HEAD', redirect: 'manual' });
-        // Some origins refuse HEAD; a GET settles it rather than reporting a live
-        // page as dead.
-        const res = head.status === 405 || head.status === 501 ? await ctx.fetch(url, { redirect: 'manual' }) : head;
-        if (res.status >= 300 && res.status < 400) {
-            redirected.push(`${url} → ${res.redirectLocation ?? '(no Location)'}`);
-            continue;
-        }
-        if (!res.ok)
-            dead.push(`${url} (HTTP ${res.status || 'network error'})`);
-    }
-    if (dead.length > 0) {
-        findings.push({
-            status: 'fail',
-            message: `${dead.length}/${sample.length} sampled llms.txt link(s) are broken`,
-            detail: dead.join('\n'),
-            hint: 'An index of dead links wastes exactly the budget it was meant to save, and an agent has no way to tell a ' +
-                'moved page from a removed one. Revalidate llms.txt when you move pages.',
-            learnMoreUrl: guideUrl(meta.id, 'broken-links'),
-        });
-    }
-    else {
-        findings.push({ status: 'pass', message: `${sample.length} sampled link(s) resolve` });
-    }
-    if (redirected.length > 0) {
-        findings.push({
-            status: 'warn',
-            message: `${redirected.length} sampled link(s) redirect`,
-            detail: redirected.join('\n'),
-            hint: 'Point llms.txt at the final URL. Each redirect is a round trip the agent pays for on every visit.',
-            learnMoreUrl: guideUrl(meta.id, 'redirecting-links'),
-        });
-    }
-}
-/**
- * llms.txt v2 documents per-page Markdown mirrors reached by appending `.md`.
- * They matter more than the index itself: an agent that found a page still has
- * to read it, and the HTML costs several times the tokens.
- */
-async function reportMarkdownMirror(ctx, findings) {
-    for (const path of ['/index.md', '/index.html.md']) {
-        const res = await ctx.fetch(`${ctx.url}${path}`);
-        if (!res.ok || res.body.trim().length === 0)
-            continue;
-        if (/^\s*(?:<!doctype\s+html|<html[\s>])/i.test(res.body))
-            continue;
-        findings.push({
-            status: 'pass',
-            message: `Per-page Markdown mirror available at ${path}`,
-            detail: 'Agents that cannot negotiate on Accept can still read the cheap representation.',
-        });
-        return;
-    }
-    findings.push({
-        status: 'warn',
-        message: 'No per-page Markdown mirror found',
-        detail: 'Tried /index.md and /index.html.md.',
-        hint: 'llms.txt v2 documents appending .md to a URL for its Markdown version. The index tells an agent which pages ' +
-            'exist; the mirrors are what make reading them cheap.',
-        learnMoreUrl: guideUrl(meta.id, 'no-markdown-mirror'),
-    });
-}
-/** State plainly who reads this file, so nobody over-invests on the wrong premise. */
-function reportConsumers(findings) {
-    findings.push({
-        status: 'pass',
-        message: 'Consumer note: llms.txt is read by coding agents, not by search',
-        detail: 'Google has stated that Search ignores llms.txt, and adoption studies find most published files are never ' +
-            'fetched by an AI search crawler. Claude Code, Cursor and OpenCode do fetch it. Treat it as developer tooling, ' +
-            'not as a search-visibility signal.',
-    });
-}
-//# sourceMappingURL=llms-txt.js.map

package/dist/checks/llms-txt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"llms-txt.js","sourceRoot":"","sources":["../../src/checks/llms-txt.ts"],"names":[],"mappings":"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"}

package/dist/checks/mcp-discovery.d.ts

@@ -1,30 +0,0 @@
-import type { CheckContext, CheckResult, CheckMeta } from '../types.js';
-/**
- * "mcp-discovery" — how an agent finds this site's MCP server.
- *
- * ax-audit used to look for `/.well-known/mcp.json` and validate a `tools[]`
- * array inside it. That path was never part of the Model Context Protocol
- * specification — it was a plausible-looking convention that several tools,
- * this one included, recommended before the ecosystem settled. Advertising
- * static tool lists was the wrong idea anyway: tools come from a live
- * `tools/list` call, and a copy in a static file starts drifting the day it is
- * written.
- *
- * What actually emerged is the **server card**: a small document identifying
- * the server and listing its remote endpoints, deliberately without tools.
- * SEP-2127 and the `experimental-ext-server-card` repository recommend serving
- * it at `<streamable-http-url>/server-card`, or referencing it from
- * `/.well-known/ai-catalog.json`. Cloudflare and Mintlify serve one at
- * `/.well-known/mcp/server-card.json`.
- *
- * All of that is still draft, and drafts get renamed — so this check probes the
- * whole chain, labels each hit with its standing, and never treats one draft
- * path as the single correct answer.
- *
- * Scoring note for 3.x: a site whose only MCP document is the legacy
- * `/.well-known/mcp.json` is validated with the pre-3.7 rules, so its score is
- * exactly what 3.6 produced. The path itself is reported, not penalised.
- */
-export declare const meta: CheckMeta;
-export default function check(ctx: CheckContext): Promise<CheckResult>;
-//# sourceMappingURL=mcp-discovery.d.ts.map

package/dist/checks/mcp-discovery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-discovery.d.ts","sourceRoot":"","sources":["../../src/checks/mcp-discovery.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AAKhG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,IAAI,EAAE,SAMlB,CAAC;AAqFF,wBAA8B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA2D3E"}