aiseo-audit 1.4.1 → 1.4.3

package/README.md

@@ -16,11 +16,12 @@
 Deterministic CLI that audits web pages for **AI search readiness**. Think Lighthouse, but for how well AI engines can fetch, extract, understand, and cite your content.
 
 > [!TIP]
-> Run `aiseo-audit https://www.aiseo-audit.com` to see a 100/100 [A+ Score](https://www.aiseo-audit.com/).
+> Run `aiseo-audit https://www.aiseo-audit.com` to see a 100/100 [A Score](https://www.aiseo-audit.com/).
 
 **AI SEO measures how reusable your content is for generative engines, not traditional search rankings.**
 
 - [Quick Start](#quick-start)
+- [CI/CD](#cicd)
 - [CLI Options](#cli-options)
 - [Site-Wide Auditing](#site-wide-auditing)
 - [Local Development](#local-development)
@@ -51,6 +52,11 @@ aiseo-audit goes deeper:
 
 ## Quick Start
 
+```bash
+# Try it instantly — no install required
+npx aiseo-audit https://yoursite.com
+```
+
 ```bash
 # As a project dependency
 npm install aiseo-audit
@@ -95,6 +101,25 @@ aiseo-audit https://example.com --user-agent "MyBot/1.0"
 aiseo-audit https://example.com --config aiseo.config.json
 ```
 
+## CI/CD
+
+Drop this into any GitHub Actions workflow to gate PRs on AI search readiness:
+
+```yaml
+# .github/workflows/aiseo-audit.yml
+name: AI SEO Audit
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - run: npx aiseo-audit https://yoursite.com --fail-under 70
+```
+
 ## CLI Options
 
 | Option                 | Description                                                                 | Default                                       |
@@ -155,23 +180,6 @@ aiseo-audit --sitemap https://example.com/projects/sitemap.xml --signals-base ht
 
 Every report format explicitly shows which URL domain signals were fetched from, so there is no guesswork about where `robots.txt`, `llms.txt`, and `llms-full.txt` were checked.
 
-## CI/CD
-
-```yaml
-# .github/workflows/aiseo-audit.yml
-name: AI SEO Audit
-on:
-  pull_request:
-  push:
-    branches: [main]
-
-jobs:
-  audit:
-    runs-on: ubuntu-latest
-    steps:
-      - run: npx aiseo-audit https://yoursite.com --fail-under 70
-```
-
 ## User Agent
 
 By default, all HTTP requests (page fetch, `robots.txt`, `llms.txt`) are sent with the header `User-Agent: AISEOAudit/<version>`. This is intentional. If a site blocks unknown bots, that is a meaningful negative signal for AI search readiness, and the audit should surface it as a failing "Fetch Success" score.

package/dist/cli.js

@@ -28,7 +28,7 @@ var import_zod3 = require("zod");
 
 // src/modules/analyzer/constants.ts
 var DOMAIN_SIGNAL_TIMEOUT_CAP = 5e3;
-var VERSION = true ? "1.4.1" : "0.0.0";
+var VERSION = true ? "1.4.3" : "0.0.0";
 
 // src/modules/fetcher/constants.ts
 var MAX_RESPONSE_SIZE = 10 * 1024 * 1024;
@@ -1136,13 +1136,14 @@ function auditEntityClarity(page) {
     }
   }
   const consistencyRatio = keyWords.length > 0 ? topicOverlap / keyWords.length : 0;
-  const consistencyScore = consistencyRatio >= 0.5 ? 25 : consistencyRatio > 0 ? 15 : 5;
+  const consistencyScore = keyWords.length === 0 ? 0 : consistencyRatio >= 0.5 ? 25 : consistencyRatio > 0 ? 15 : 0;
   factors.push(
     makeFactor(
       "Topic Consistency",
       consistencyScore,
       25,
-      `${topicOverlap}/${keyWords.length} title keywords align with content topics`
+      `${topicOverlap}/${keyWords.length} title keywords align with content topics`,
+      keyWords.length === 0 ? "neutral" : void 0
     )
   );
   const wordCount = countWords(text);
@@ -1855,16 +1856,17 @@ function generateRecommendations(auditResult) {
 
 // src/modules/scoring/constants.ts
 var GRADE_THRESHOLDS = [
-  [95, "A+"],
-  [90, "A"],
-  [85, "A-"],
-  [80, "B+"],
-  [75, "B"],
-  [70, "B-"],
-  [65, "C+"],
-  [60, "C"],
-  [55, "C-"],
-  [45, "D"],
+  [93, "A"],
+  [90, "A-"],
+  [87, "B+"],
+  [83, "B"],
+  [80, "B-"],
+  [77, "C+"],
+  [73, "C"],
+  [70, "C-"],
+  [67, "D+"],
+  [63, "D"],
+  [60, "D-"],
   [0, "F"]
 ];
 

package/dist/cli.mjs

@@ -4,7 +4,7 @@ import { z as z3 } from "zod";
 
 // src/modules/analyzer/constants.ts
 var DOMAIN_SIGNAL_TIMEOUT_CAP = 5e3;
-var VERSION = true ? "1.4.1" : "0.0.0";
+var VERSION = true ? "1.4.3" : "0.0.0";
 
 // src/modules/fetcher/constants.ts
 var MAX_RESPONSE_SIZE = 10 * 1024 * 1024;
@@ -1112,13 +1112,14 @@ function auditEntityClarity(page) {
     }
   }
   const consistencyRatio = keyWords.length > 0 ? topicOverlap / keyWords.length : 0;
-  const consistencyScore = consistencyRatio >= 0.5 ? 25 : consistencyRatio > 0 ? 15 : 5;
+  const consistencyScore = keyWords.length === 0 ? 0 : consistencyRatio >= 0.5 ? 25 : consistencyRatio > 0 ? 15 : 0;
   factors.push(
     makeFactor(
       "Topic Consistency",
       consistencyScore,
       25,
-      `${topicOverlap}/${keyWords.length} title keywords align with content topics`
+      `${topicOverlap}/${keyWords.length} title keywords align with content topics`,
+      keyWords.length === 0 ? "neutral" : void 0
     )
   );
   const wordCount = countWords(text);
@@ -1831,16 +1832,17 @@ function generateRecommendations(auditResult) {
 
 // src/modules/scoring/constants.ts
 var GRADE_THRESHOLDS = [
-  [95, "A+"],
-  [90, "A"],
-  [85, "A-"],
-  [80, "B+"],
-  [75, "B"],
-  [70, "B-"],
-  [65, "C+"],
-  [60, "C"],
-  [55, "C-"],
-  [45, "D"],
+  [93, "A"],
+  [90, "A-"],
+  [87, "B+"],
+  [83, "B"],
+  [80, "B-"],
+  [77, "C+"],
+  [73, "C"],
+  [70, "C-"],
+  [67, "D+"],
+  [63, "D"],
+  [60, "D-"],
   [0, "F"]
 ];
 

package/dist/index.d.mts

@@ -703,12 +703,13 @@ declare const GradeSchema: z.ZodEnum<{
     C: "C";
     D: "D";
     F: "F";
-    "A+": "A+";
     "A-": "A-";
     "B+": "B+";
     "B-": "B-";
     "C+": "C+";
     "C-": "C-";
+    "D+": "D+";
+    "D-": "D-";
 }>;
 declare const ScoreSummarySchema: z.ZodObject<{
     overallScore: z.ZodNumber;
@@ -718,12 +719,13 @@ declare const ScoreSummarySchema: z.ZodObject<{
         C: "C";
         D: "D";
         F: "F";
-        "A+": "A+";
         "A-": "A-";
         "B+": "B+";
         "B-": "B-";
         "C+": "C+";
         "C-": "C-";
+        "D+": "D+";
+        "D-": "D-";
     }>;
     totalPoints: z.ZodNumber;
     maxPoints: z.ZodNumber;

package/dist/index.d.ts

@@ -703,12 +703,13 @@ declare const GradeSchema: z.ZodEnum<{
     C: "C";
     D: "D";
     F: "F";
-    "A+": "A+";
     "A-": "A-";
     "B+": "B+";
     "B-": "B-";
     "C+": "C+";
     "C-": "C-";
+    "D+": "D+";
+    "D-": "D-";
 }>;
 declare const ScoreSummarySchema: z.ZodObject<{
     overallScore: z.ZodNumber;
@@ -718,12 +719,13 @@ declare const ScoreSummarySchema: z.ZodObject<{
         C: "C";
         D: "D";
         F: "F";
-        "A+": "A+";
         "A-": "A-";
         "B+": "B+";
         "B-": "B-";
         "C+": "C+";
         "C-": "C-";
+        "D+": "D+";
+        "D-": "D-";
     }>;
     totalPoints: z.ZodNumber;
     maxPoints: z.ZodNumber;

package/dist/index.js

@@ -1135,13 +1135,14 @@ function auditEntityClarity(page) {
     }
   }
   const consistencyRatio = keyWords.length > 0 ? topicOverlap / keyWords.length : 0;
-  const consistencyScore = consistencyRatio >= 0.5 ? 25 : consistencyRatio > 0 ? 15 : 5;
+  const consistencyScore = keyWords.length === 0 ? 0 : consistencyRatio >= 0.5 ? 25 : consistencyRatio > 0 ? 15 : 0;
   factors.push(
     makeFactor(
       "Topic Consistency",
       consistencyScore,
       25,
-      `${topicOverlap}/${keyWords.length} title keywords align with content topics`
+      `${topicOverlap}/${keyWords.length} title keywords align with content topics`,
+      keyWords.length === 0 ? "neutral" : void 0
     )
   );
   const wordCount = countWords(text);
@@ -1527,7 +1528,7 @@ var import_zod = require("zod");
 
 // src/modules/analyzer/constants.ts
 var DOMAIN_SIGNAL_TIMEOUT_CAP = 5e3;
-var VERSION = true ? "1.4.1" : "0.0.0";
+var VERSION = true ? "1.4.3" : "0.0.0";
 
 // src/modules/fetcher/schema.ts
 var FetchOptionsSchema = import_zod.z.object({
@@ -1860,16 +1861,17 @@ function generateRecommendations(auditResult) {
 
 // src/modules/scoring/constants.ts
 var GRADE_THRESHOLDS = [
-  [95, "A+"],
-  [90, "A"],
-  [85, "A-"],
-  [80, "B+"],
-  [75, "B"],
-  [70, "B-"],
-  [65, "C+"],
-  [60, "C"],
-  [55, "C-"],
-  [45, "D"],
+  [93, "A"],
+  [90, "A-"],
+  [87, "B+"],
+  [83, "B"],
+  [80, "B-"],
+  [77, "C+"],
+  [73, "C"],
+  [70, "C-"],
+  [67, "D+"],
+  [63, "D"],
+  [60, "D-"],
   [0, "F"]
 ];
 

package/dist/index.mjs

@@ -1095,13 +1095,14 @@ function auditEntityClarity(page) {
     }
   }
   const consistencyRatio = keyWords.length > 0 ? topicOverlap / keyWords.length : 0;
-  const consistencyScore = consistencyRatio >= 0.5 ? 25 : consistencyRatio > 0 ? 15 : 5;
+  const consistencyScore = keyWords.length === 0 ? 0 : consistencyRatio >= 0.5 ? 25 : consistencyRatio > 0 ? 15 : 0;
   factors.push(
     makeFactor(
       "Topic Consistency",
       consistencyScore,
       25,
-      `${topicOverlap}/${keyWords.length} title keywords align with content topics`
+      `${topicOverlap}/${keyWords.length} title keywords align with content topics`,
+      keyWords.length === 0 ? "neutral" : void 0
     )
   );
   const wordCount = countWords(text);
@@ -1487,7 +1488,7 @@ import { z } from "zod";
 
 // src/modules/analyzer/constants.ts
 var DOMAIN_SIGNAL_TIMEOUT_CAP = 5e3;
-var VERSION = true ? "1.4.1" : "0.0.0";
+var VERSION = true ? "1.4.3" : "0.0.0";
 
 // src/modules/fetcher/schema.ts
 var FetchOptionsSchema = z.object({
@@ -1820,16 +1821,17 @@ function generateRecommendations(auditResult) {
 
 // src/modules/scoring/constants.ts
 var GRADE_THRESHOLDS = [
-  [95, "A+"],
-  [90, "A"],
-  [85, "A-"],
-  [80, "B+"],
-  [75, "B"],
-  [70, "B-"],
-  [65, "C+"],
-  [60, "C"],
-  [55, "C-"],
-  [45, "D"],
+  [93, "A"],
+  [90, "A-"],
+  [87, "B+"],
+  [83, "B"],
+  [80, "B-"],
+  [77, "C+"],
+  [73, "C"],
+  [70, "C-"],
+  [67, "D+"],
+  [63, "D"],
+  [60, "D-"],
   [0, "F"]
 ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiseo-audit",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "Lighthouse for AI SEO. Audit any webpage for AI search readiness. 7 categories, 30+ factors, research-backed scoring. Deterministic, engine-agnostic, zero API keys.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",