aiseo-audit 1.4.2 → 1.4.3

package/README.md

@@ -21,6 +21,7 @@ Deterministic CLI that audits web pages for **AI search readiness**. Think Light
 **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.2" : "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);

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.2" : "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);

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.2" : "0.0.0";
+var VERSION = true ? "1.4.3" : "0.0.0";
 
 // src/modules/fetcher/schema.ts
 var FetchOptionsSchema = import_zod.z.object({

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.2" : "0.0.0";
+var VERSION = true ? "1.4.3" : "0.0.0";
 
 // src/modules/fetcher/schema.ts
 var FetchOptionsSchema = z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiseo-audit",
-  "version": "1.4.2",
+  "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",