@forkpoint/agent-lighthouse-core 0.2.0 → 0.2.1

package/README.md

@@ -0,0 +1,27 @@
+# @forkpoint/agent-lighthouse-core
+
+Core TypeScript scanner engine for Agent Lighthouse.
+
+Use this package when you want to embed AI-agent readiness audits in your own service, build tooling, CI system, or reporting flow.
+
+## Usage
+
+```typescript
+import { runScan } from "@forkpoint/agent-lighthouse-core";
+
+const report = await runScan("https://example.com");
+
+console.log(report.overallScore);
+```
+
+The engine runs deterministic audits for `llms.txt`, AI crawler access, Schema.org, WebMCP, OpenAPI discovery, AEO/GEO content structure, accessibility, and technical readiness.
+
+## Links
+
+- Documentation: https://forkpoint.github.io/agent-lighthouse/
+- Repository: https://github.com/ForkPoint/agent-lighthouse
+- CLI package: https://www.npmjs.com/package/@forkpoint/agent-lighthouse
+
+## License
+
+GPL-3.0-only

package/dist/index.d.mts

@@ -368,6 +368,7 @@ declare function extractImages($: CheerioAPI): Array<{
     height?: string;
     loading?: string;
     role?: string;
+    ariaHidden?: string;
 }>;
 declare function extractForms($: CheerioAPI): Array<{
     action: string;

package/dist/index.d.ts

@@ -368,6 +368,7 @@ declare function extractImages($: CheerioAPI): Array<{
     height?: string;
     loading?: string;
     role?: string;
+    ariaHidden?: string;
 }>;
 declare function extractForms($: CheerioAPI): Array<{
     action: string;

package/dist/index.js

@@ -603,7 +603,8 @@ function extractImages($) {
       width: $(el).attr("width") ?? void 0,
       height: $(el).attr("height") ?? void 0,
       loading: $(el).attr("loading") ?? void 0,
-      role: $(el).attr("role") ?? void 0
+      role: $(el).attr("role") ?? void 0,
+      ariaHidden: $(el).attr("aria-hidden") ?? void 0
     });
   });
   return images;
@@ -4743,9 +4744,6 @@ function matchesAnyType2(schema, types) {
 function allSchemas3(ctx) {
   return ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
 }
-function hasProps3(obj, keys) {
-  return keys.filter((k) => !obj[k]);
-}
 var ServiceProductSchemaAudit = class extends Audit {
   static meta = {
     id: "3.8",
@@ -4798,13 +4796,19 @@ var ServiceProductSchemaAudit = class extends Audit {
         }
       );
     }
-    const requiredProps = ["name", "description", "provider"];
     const first2 = serviceProducts[0];
-    const missing = hasProps3(first2, requiredProps);
+    const isProduct = matchesAnyType2(first2, ["Product"]);
+    const hasName = Boolean(first2["name"]);
+    const hasDescription = Boolean(first2["description"]);
+    const hasProviderOrBrand = isProduct ? Boolean(first2["brand"] || first2["manufacturer"] || first2["provider"] || first2["offers"]) : Boolean(first2["provider"]);
+    const missing = [];
+    if (!hasName) missing.push("name");
+    if (!hasDescription) missing.push("description");
+    if (!hasProviderOrBrand) missing.push(isProduct ? "brand/offers" : "provider");
     const valid = missing.length === 0;
     if (valid) {
       return this.pass(
-        `Service/Product schema found with name, description, and provider.`,
+        `Service/Product schema found with name, description, and ${isProduct ? "brand/offers" : "provider"}.`,
         "Service or Product schema with name, description, and provider.",
         `Complete Service/Product schema (${serviceProducts.length} total)`
       );
@@ -5450,7 +5454,7 @@ function matchesAnyType7(schema, types) {
 function allSchemas8(ctx) {
   return ctx.pages.flatMap((p) => flattenJsonLd(p.structuredData ?? p.jsonLd));
 }
-function hasProps4(obj, keys) {
+function hasProps3(obj, keys) {
   return keys.filter((k) => !obj[k]);
 }
 var AuthorSchemaAudit = class extends Audit {
@@ -5531,11 +5535,11 @@ var AuthorSchemaAudit = class extends Audit {
     }
     const requiredProps = ["name", "jobTitle", "sameAs", "affiliation"];
     const bestPerson = allPersons.reduce((best, p) => {
-      const bestMissing = hasProps4(best, requiredProps).length;
-      const currentMissing = hasProps4(p, requiredProps).length;
+      const bestMissing = hasProps3(best, requiredProps).length;
+      const currentMissing = hasProps3(p, requiredProps).length;
       return currentMissing < bestMissing ? p : best;
     }, allPersons[0]);
-    const missing = hasProps4(bestPerson, requiredProps);
+    const missing = hasProps3(bestPerson, requiredProps);
     const complete = missing.length === 0;
     if (complete) {
       return this.pass(
@@ -11456,7 +11460,7 @@ var DecorativeImagesAudit = class extends Audit {
       for (const img of images) {
         if (img.alt === "") {
           decorativeCount++;
-          if (img.role === "presentation") {
+          if (img.role === "presentation" || img.role === "none" || img.ariaHidden === "true") {
             correctlyMarked++;
           }
         }
@@ -12680,8 +12684,19 @@ var CorsAiFilesAudit = class extends Audit {
   async audit(ctx) {
     const page = ctx.pages?.[0];
     const aiPaths = ["/llms.txt", "/.well-known/ai-catalog.json"];
+    const hasRootFiles = ctx.rootFiles && Object.keys(ctx.rootFiles).length > 0;
+    const existingAiPaths = hasRootFiles ? aiPaths.filter((p) => ctx.rootFiles[p]?.status === 200) : aiPaths;
+    if (hasRootFiles && existingAiPaths.length === 0) {
+      return this.warn(
+        "No AI files (/llms.txt, /.well-known/ai-catalog.json) found to check CORS headers.",
+        "OPTIONS requests to /llms.txt and /.well-known/ai-catalog.json return Access-Control-Allow-Origin",
+        "No applicable AI files found",
+        void 0,
+        page?.url
+      );
+    }
     const corsResults = [];
-    for (const path of aiPaths) {
+    for (const path of existingAiPaths) {
       try {
         const result = await ctx.fetch({
           url: `${ctx.baseUrl}${path}`,
@@ -15171,9 +15186,33 @@ var AboutCredentialsAudit = class extends Audit {
     }
   };
   async audit(ctx) {
-    const aboutPaths = ["/about/", "/about-us/", "/about"];
-    let aboutResult = ctx.rootFiles["/about/"] ?? ctx.rootFiles["/about-us/"];
-    if (!aboutResult || aboutResult.status !== 200) {
+    const aboutPaths = [
+      "/about/",
+      "/about-us/",
+      "/about",
+      "/pages/about",
+      "/pages/about-us",
+      "/pages/our-story",
+      "/our-story"
+    ];
+    let aboutResult = void 0;
+    for (const path of aboutPaths) {
+      const file = ctx.rootFiles[path];
+      if (file && file.status === 200 && file.body) {
+        aboutResult = file;
+        break;
+      }
+    }
+    if (!aboutResult && ctx.pages) {
+      const matchingPage = ctx.pages.find((p) => {
+        const urlLower = p.url.toLowerCase();
+        return urlLower.includes("/about") || urlLower.includes("/our-story") || urlLower.includes("/who-we-are");
+      });
+      if (matchingPage?.fetchResult?.status === 200 && matchingPage.fetchResult.body) {
+        aboutResult = matchingPage.fetchResult;
+      }
+    }
+    if (!aboutResult) {
       for (const path of aboutPaths) {
         try {
           const result = await ctx.fetch({
@@ -15442,7 +15481,11 @@ var TRUST_PATTERNS = [
   /\baward/i,
   /\bas\s+seen\s+(in|on)\b/i,
   /\bpartner(s|ed|ship)?\b/i,
-  /\bcertif(ied|icate|ication)\b/i
+  /\bcertif(ied|icate|ication)\b/i,
+  /\b(money[-\s]back\s+guarantee|satisfaction\s+guarantee|guaranteed)\b/i,
+  /\b(reviews|customer\s+rating|verified\s+(buyer|customer|review)|happy\s+customers)\b/i,
+  /\b(sustainable|organic|fair\s+trade|b\s+corp|handcrafted|handmade)\b/i,
+  /\b(secure\s+checkout|free\s+returns|free\s+shipping)\b/i
 ];
 var TrustSignalsAudit = class extends Audit {
   static meta = {
@@ -22148,7 +22191,11 @@ async function runScan(url, onProgress, pageOverrides, signal) {
     "/policies/terms-of-service",
     "/about/",
     "/about-us/",
-    "/about"
+    "/about",
+    "/pages/about",
+    "/pages/about-us",
+    "/pages/our-story",
+    "/our-story"
   ];
   logger.debug({ count: rootFilePaths.length }, "[orchestrator] Phase 1: Fetching root files");
   const rootResults = await Promise.all(