ai-search-auditor 0.1.1 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.1.4](https://github.com/a-bibikov/ai-search-audit/compare/v0.1.3...v0.1.4) (2026-11-03)
+
+
+### Internal
+
+* release 0.1.4 ([2c8056d](https://github.com/a-bibikov/ai-search-audit/commit/2c8056d386588262362e66c5fce78726df9127d8))
+
+## [0.1.3](https://github.com/a-bibikov/ai-search-audit/compare/v0.1.2...v0.1.3) (2026-11-03)
+
+
+### Fixes
+
+* CLI help names the npm package, --version flag ([31887fa](https://github.com/a-bibikov/ai-search-audit/commit/31887fada369eb41024f119b79359e5a98c03126))
+
+## [0.1.2](https://github.com/a-bibikov/ai-search-audit/compare/v0.1.1...v0.1.2) (2026-11-03)
+
+
+### New checks and features
+
+* checklist by section at the end of the report ([c43423c](https://github.com/a-bibikov/ai-search-audit/commit/c43423c6f1c522de056552980c39db7cb411b082))
+
 ## [0.1.1](https://github.com/a-bibikov/ai-search-audit/compare/v0.1.0...v0.1.1) (2026-11-03)
 
 

package/README.md

@@ -68,6 +68,8 @@ Gaps in the numbering are taken by the checks on the [roadmap](#roadmap).
 
 Levels: `error` — AI search cannot read the page or reads it wrong; `warn` — lowers the chance of a citation; `info` — a recommendation.
 
+The report lists the findings with fixes first, then ends with a checklist of every check by group: ✓ OK, ✖ error, ⚠ warning, ℹ note.
+
 **Score:** 100 minus 15 per rule with an error and 5 per rule with a warning. A rule counts once, not per page, so one template bug does not sink a large site. A ≥ 90, B ≥ 80, C ≥ 70, D ≥ 60, F below.
 
 ## Usage

package/dist/cli.js

@@ -2,11 +2,16 @@
 import { existsSync, readFileSync, writeFileSync, appendFileSync } from "node:fs";
 import { parseArgs } from "node:util";
 import { DEFAULT_LANG, LANGS, audit, isLang, rules, toMarkdown } from "./index.js";
-const HELP = `ai-search-audit — can ChatGPT, Claude and Perplexity read, understand and cite your site?
+// package.json sits one level up both from src/cli.ts (development) and dist/cli.js (published package).
+const { version } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+const HELP = `ai-search-auditor ${version} — can ChatGPT, Claude and Perplexity read, understand and cite your site?
 
 Usage:
-  ai-search-audit <url> [options]
-  ai-search-audit llms-txt <url>        check only llms.txt and llms-full.txt
+  ai-search-auditor <url> [options]
+  ai-search-auditor llms-txt <url>      check only llms.txt and llms-full.txt
+
+  npm package: ai-search-auditor (npx ai-search-auditor, npm i -g ai-search-auditor).
+  After install the command also works as ai-search-audit.
 
 Options:
   --base <url>        public origin when auditing a local build (links in sitemap point there)
@@ -16,6 +21,7 @@ Options:
   --json              print the JSON report instead of Markdown
   --out <file>        also write the report to a file (.json or .md)
   --config <file>     config file (default: ai-search-audit.config.json if present)
+  -v, --version       print the version
   -h, --help
 
 Examples:
@@ -34,8 +40,13 @@ const { values, positionals } = parseArgs({
         out: { type: "string" },
         config: { type: "string" },
         help: { type: "boolean", short: "h", default: false },
+        version: { type: "boolean", short: "v", default: false },
     },
 });
+if (values.version) {
+    process.stdout.write(`${version}\n`);
+    process.exit(0);
+}
 const llmsOnly = positionals[0] === "llms-txt";
 const target = llmsOnly ? positionals[1] : positionals[0];
 if (values.help || !target) {

package/dist/i18n/en.d.ts

@@ -15,8 +15,17 @@ export declare const en: {
         }) => string;
         clean: string;
         fix: string;
+        /** Label instead of «Fix» when a rule has only notes: nothing is broken, it is advice. */
+        recommendation: string;
         more: (n: number) => string;
-        passed: string;
+        checklist: string;
+        legend: string;
+        /** Findings of one rule in the checklist: «2 errors, 1 warning». */
+        count: (o: {
+            errors: number;
+            warnings: number;
+            notes: number;
+        }) => string;
         site: string;
         footer: (pages: number, date: string) => string;
         groups: {

package/dist/i18n/en.js

@@ -8,8 +8,19 @@ export const en = {
         summary: (o) => `**${o.score}/100 (${o.grade})** · ${o.errors} errors · ${o.warnings} warnings · ${o.notes} notes · ${o.pages} pages`,
         clean: "Nothing to fix: AI search can read, understand and cite these pages.",
         fix: "Fix",
+        /** Label instead of «Fix» when a rule has only notes: nothing is broken, it is advice. */
+        recommendation: "Recommendation",
         more: (n) => `…and ${n} more`,
-        passed: "Passed",
+        checklist: "Checklist",
+        legend: "✓ OK · ✖ error · ⚠ warning · ℹ note",
+        /** Findings of one rule in the checklist: «2 errors, 1 warning». */
+        count: (o) => [
+            o.errors && `${o.errors} ${o.errors === 1 ? "error" : "errors"}`,
+            o.warnings && `${o.warnings} ${o.warnings === 1 ? "warning" : "warnings"}`,
+            o.notes && `${o.notes} ${o.notes === 1 ? "note" : "notes"}`,
+        ]
+            .filter(Boolean)
+            .join(", "),
         site: "site",
         footer: (pages, date) => `Checked ${pages} pages on ${date}. Also check by hand after each deploy: the live CDN and bot protection with real AI agents (A-3), Google Search Console, Bing Webmaster Tools (ChatGPT search uses Bing), Yandex Webmaster.`,
         groups: {

package/dist/i18n/index.d.ts

@@ -15,8 +15,15 @@ export declare const LANGS: {
             }) => string;
             clean: string;
             fix: string;
+            recommendation: string;
             more: (n: number) => string;
-            passed: string;
+            checklist: string;
+            legend: string;
+            count: (o: {
+                errors: number;
+                warnings: number;
+                notes: number;
+            }) => string;
             site: string;
             footer: (pages: number, date: string) => string;
             groups: {
@@ -166,8 +173,15 @@ export declare const LANGS: {
             }) => string;
             clean: string;
             fix: string;
+            recommendation: string;
             more: (n: number) => string;
-            passed: string;
+            checklist: string;
+            legend: string;
+            count: (o: {
+                errors: number;
+                warnings: number;
+                notes: number;
+            }) => string;
             site: string;
             footer: (pages: number, date: string) => string;
             groups: {

package/dist/i18n/ru.js

@@ -5,8 +5,11 @@ export const ru = {
         summary: (o) => `**${o.score}/100 (${o.grade})** · ошибок: ${o.errors} · предупреждений: ${o.warnings} · заметок: ${o.notes} · страниц: ${o.pages}`,
         clean: "Исправлять нечего: AI-поиск может прочитать, понять и процитировать эти страницы.",
         fix: "Как исправить",
+        recommendation: "Рекомендация",
         more: (n) => `…и ещё ${n}`,
-        passed: "Пройдено",
+        checklist: "Чек-лист",
+        legend: "✓ в порядке · ✖ ошибка · ⚠ предупреждение · ℹ заметка",
+        count: (o) => [o.errors && `ошибок: ${o.errors}`, o.warnings && `предупреждений: ${o.warnings}`, o.notes && `заметок: ${o.notes}`].filter(Boolean).join(", "),
         site: "сайт",
         footer: (pages, date) => `Проверено страниц: ${pages}, ${date}. После каждого деплоя проверьте вручную: боевой CDN и защиту от ботов с настоящими AI-агентами (A-3), Google Search Console, Bing Webmaster Tools (поиск ChatGPT опирается на Bing), Яндекс Вебмастер.`,
         groups: {

package/dist/report.js

@@ -27,15 +27,21 @@ export function toMarkdown(r) {
             lines.push(`- ${f.level === worst ? "" : `${ICON[f.level]} `}\`${short(f.where)}\` — ${f.message}`);
         if (findings.length > MAX_PER_RULE)
             lines.push(`- ${t.more(findings.length - MAX_PER_RULE)}`);
-        lines.push("", `**${t.fix}:** ${rule.fix}`, "");
+        lines.push("", `**${worst === "info" ? t.recommendation : t.fix}:** ${rule.fix}`, "");
     }
-    const passed = r.rules.filter((rule) => !byRule.has(rule.id));
-    if (passed.length) {
-        lines.push(`## ✓ ${t.passed}`, "");
-        for (const g of Object.keys(t.groups)) {
-            const list = passed.filter((p) => p.group === g);
-            if (list.length)
-                lines.push(`- **${t.groups[g]}:** ${list.map((p) => `${p.id} ${p.title}`).join("; ")}`);
+    // Every audited check by group, as in the README: what is fine and what is not, at a glance.
+    lines.push(`## ${t.checklist}`, "", t.legend, "");
+    for (const g of Object.keys(t.groups)) {
+        const list = r.rules.filter((rule) => rule.group === g).sort((a, b) => a.id.localeCompare(b.id, "en", { numeric: true }));
+        if (!list.length)
+            continue;
+        lines.push(`**${g}. ${t.groups[g]}**`, "");
+        for (const rule of list) {
+            const found = byRule.get(rule.id) ?? [];
+            const n = (level) => found.filter((f) => f.level === level).length;
+            const icon = found.length ? ICON[found.reduce((w, f) => (ORDER[f.level] < ORDER[w] ? f.level : w), "info")] : "✓";
+            const count = found.length ? ` — ${t.count({ errors: n("error"), warnings: n("warn"), notes: n("info") })}` : "";
+            lines.push(`- ${icon} ${rule.id} ${rule.title}${count}`);
         }
         lines.push("");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-search-auditor",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "Checks whether AI search (ChatGPT, Claude, Perplexity, Google AI Overviews) can read, understand and cite your site: robots.txt for AI agents, text without JavaScript, JSON-LD authorship, llms.txt, freshness.",
   "keywords": [
     "ai search audit",