@drowlink/aeo-linter-core 0.1.0

package/dist/__tests__/audit-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-contract.test.d.ts.map

package/dist/__tests__/audit-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/audit-contract.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/audit-contract.test.js

@@ -0,0 +1,120 @@
+import { describe, it, expect } from 'vitest';
+import { Audit } from '../audits/audit.js';
+import { defaultConfig } from '../config/default-config.js';
+class MockRobotsAudit extends Audit {
+    static meta = {
+        id: 'ai-robots-txt',
+        title: 'Robots.txt permite acceso a bots de IA',
+        failureTitle: 'Robots.txt bloquea rastreadores de IA',
+        description: 'Verifica directivas para GPTBot, PerplexityBot, etc.',
+        requiredArtifacts: ['RobotsTxt'],
+    };
+    static async audit(artifacts) {
+        const isAllowed = artifacts.RobotsTxt.aiBotsStatus.gptBot === 'allowed';
+        return this.generateAuditResult({
+            score: this.binaryScore(isAllowed),
+            displayValue: isAllowed ? 'GPTBot permitido' : 'GPTBot bloqueado',
+            details: this.makeTableDetails([
+                { key: 'bot', label: 'Bot de IA' },
+                { key: 'status', label: 'Estado' },
+            ], [{ bot: 'GPTBot', status: artifacts.RobotsTxt.aiBotsStatus.gptBot }]),
+        });
+    }
+}
+describe('AEO Linter Core Contracts (Lighthouse Architecture)', () => {
+    it('debe definir las 4 categorías clave de AEO con ponderaciones', () => {
+        const categories = Object.keys(defaultConfig.categories);
+        expect(categories).toContain('ai-accessibility');
+        expect(categories).toContain('structured-data');
+        expect(categories).toContain('content-chunking');
+        expect(categories).toContain('direct-answer-density');
+        // Verificar que la suma de pesos de categorías principales sea 100%
+        const totalWeight = Object.values(defaultConfig.categories).reduce((sum, cat) => sum + (cat.weight || 0), 0);
+        expect(totalWeight).toBe(100);
+    });
+    it('debe ejecutar una auditoría mock derivada de Audit y generar un AuditResult válido', async () => {
+        const mockArtifacts = {
+            URL: {
+                requestedUrl: 'https://example.com',
+                finalUrl: 'https://example.com',
+                domain: 'example.com',
+                pathname: '/',
+                protocol: 'https:',
+            },
+            RobotsTxt: {
+                rawContent: 'User-agent: GPTBot\nAllow: /',
+                statusCode: 200,
+                exists: true,
+                sitemaps: ['https://example.com/sitemap.xml'],
+                rulesByAgent: {
+                    gptbot: { userAgent: 'GPTBot', allow: ['/'], disallow: [] },
+                },
+                aiBotsStatus: {
+                    gptBot: 'allowed',
+                },
+            },
+            HttpHeaders: {
+                statusCode: 200,
+                headers: {},
+                xRobotsTag: null,
+                contentType: 'text/html',
+                cacheControl: null,
+                contentEncoding: null,
+            },
+            JSONLD: {
+                items: [],
+                schemasCountByType: {},
+                hasFAQPage: false,
+                hasHowTo: false,
+                hasArticle: false,
+                hasQAPage: false,
+                hasOrganization: false,
+                hasProduct: false,
+                hasSameAs: false,
+                sameAsUrls: [],
+            },
+            MetaTags: {
+                title: 'Ejemplo AEO',
+                description: 'Meta descripción optimizada',
+                canonicalUrl: 'https://example.com',
+                viewport: 'width=device-width',
+                charset: 'utf-8',
+                openGraph: {},
+                twitterCard: {},
+                robotsMeta: null,
+            },
+            HeadingsHierarchy: {
+                headings: [{ level: 1, text: 'Título H1', index: 0 }],
+                h1Count: 1,
+                h2Count: 0,
+                h3Count: 0,
+                hasSingleH1: true,
+                isHierarchySequential: true,
+                skippedLevels: [],
+            },
+            ContentChunks: {
+                chunks: [],
+                totalWordCount: 0,
+                totalEstimatedTokens: 0,
+                averageChunkTokenCount: 0,
+                semanticTagsUsed: ['main'],
+                hasSemanticMain: true,
+                hasSemanticArticle: false,
+                hasSemanticSections: false,
+            },
+            DirectAnswers: {
+                pairs: [],
+                directAnswerRatio: 0,
+                conciseAnswersCount: 0,
+                definitionPatternsFound: 0,
+            },
+        };
+        const result = await MockRobotsAudit.audit(mockArtifacts);
+        expect(result.id).toBe('ai-robots-txt');
+        expect(result.score).toBe(1);
+        expect(result.scoreDisplayMode).toBe('binary');
+        expect(result.displayValue).toBe('GPTBot permitido');
+        expect(result.details?.type).toBe('table');
+    });
+});
+//# sourceMappingURL=audit-contract.test.js.map

package/dist/__tests__/audit-contract.test.js.map

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

package/dist/__tests__/gatherers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gatherers.test.d.ts.map

package/dist/__tests__/gatherers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherers.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/gatherers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/gatherers.test.js

@@ -0,0 +1,139 @@
+import { describe, it, expect } from 'vitest';
+import { CheerioDriver } from '../gather/driver/cheerio-driver.js';
+import { RobotsTxtGatherer } from '../gather/gatherers/robots-txt-gatherer.js';
+import { JSONLDGatherer } from '../gather/gatherers/jsonld-gatherer.js';
+import { HeadingsHierarchyGatherer } from '../gather/gatherers/headings-hierarchy-gatherer.js';
+import { DirectAnswersGatherer } from '../gather/gatherers/direct-answers-gatherer.js';
+describe('Gatherers Pipeline', () => {
+    it('RobotsTxtGatherer parsea directivas de AI bots correctamente', async () => {
+        const mockRobotsContent = `
+User-agent: GPTBot
+Disallow: /private/
+Allow: /
+
+User-agent: PerplexityBot
+Disallow: /
+
+User-agent: *
+Allow: /
+
+Sitemap: https://example.com/sitemap.xml
+    `;
+        const mockDriver = new CheerioDriver({
+            url: 'https://example.com/test',
+            html: '<html><body>Hello</body></html>',
+        });
+        // Mock fetch for robots.txt
+        mockDriver.fetch = async () => new Response(mockRobotsContent, {
+            status: 200,
+            headers: { 'content-type': 'text/plain' },
+        });
+        const gatherer = new RobotsTxtGatherer();
+        const artifact = await gatherer.getArtifact({
+            url: 'https://example.com/test',
+            driver: mockDriver,
+        });
+        expect(artifact.exists).toBe(true);
+        expect(artifact.sitemaps).toContain('https://example.com/sitemap.xml');
+        expect(artifact.aiBotsStatus.gptBot).toBe('allowed');
+        expect(artifact.aiBotsStatus.perplexityBot).toBe('disallowed');
+    });
+    it('JSONLDGatherer extrae tipos de esquemas y sameAs', async () => {
+        const html = `
+      <!DOCTYPE html>
+      <html>
+      <head>
+        <script type="application/ld+json">
+        {
+          "@context": "https://schema.org",
+          "@type": "FAQPage",
+          "mainEntity": [{
+            "@type": "Question",
+            "name": "¿Qué es AEO?",
+            "acceptedAnswer": {
+              "@type": "Answer",
+              "text": "AEO es la optimización para motores de respuesta."
+            }
+          }]
+        }
+        </script>
+        <script type="application/ld+json">
+        {
+          "@context": "https://schema.org",
+          "@type": "Organization",
+          "name": "AEO Corp",
+          "sameAs": [
+            "https://www.wikidata.org/wiki/Q12345",
+            "https://twitter.com/aeocorp"
+          ]
+        }
+        </script>
+      </head>
+      <body></body>
+      </html>
+    `;
+        const mockDriver = new CheerioDriver({
+            url: 'https://example.com',
+            html,
+        });
+        const gatherer = new JSONLDGatherer();
+        const artifact = await gatherer.getArtifact({
+            url: 'https://example.com',
+            driver: mockDriver,
+        });
+        expect(artifact.items.length).toBe(2);
+        expect(artifact.hasFAQPage).toBe(true);
+        expect(artifact.hasOrganization).toBe(true);
+        expect(artifact.hasSameAs).toBe(true);
+        expect(artifact.sameAsUrls).toContain('https://www.wikidata.org/wiki/Q12345');
+    });
+    it('HeadingsHierarchyGatherer detecta jerarquías y saltos de nivel', async () => {
+        const html = `
+      <html>
+      <body>
+        <h1>Título Principal</h1>
+        <h3>Salto brusco H3 sin H2</h3>
+        <h2>Ahora un H2</h2>
+      </body>
+      </html>
+    `;
+        const mockDriver = new CheerioDriver({
+            url: 'https://example.com',
+            html,
+        });
+        const gatherer = new HeadingsHierarchyGatherer();
+        const artifact = await gatherer.getArtifact({
+            url: 'https://example.com',
+            driver: mockDriver,
+        });
+        expect(artifact.h1Count).toBe(1);
+        expect(artifact.hasSingleH1).toBe(true);
+        expect(artifact.isHierarchySequential).toBe(false);
+        expect(artifact.skippedLevels.length).toBe(1);
+        expect(artifact.skippedLevels[0]?.from).toBe(1);
+        expect(artifact.skippedLevels[0]?.to).toBe(3);
+    });
+    it('DirectAnswersGatherer detecta preguntas y respuestas directas concisas', async () => {
+        const html = `
+      <html>
+      <body>
+        <h2>¿Qué es Answer Engine Optimization?</h2>
+        <p>Answer Engine Optimization es un conjunto de técnicas de arquitectura web y datos estructurados orientadas a maximizar la visibilidad en motores de IA generativa y sistemas RAG.</p>
+      </body>
+      </html>
+    `;
+        const mockDriver = new CheerioDriver({
+            url: 'https://example.com',
+            html,
+        });
+        const gatherer = new DirectAnswersGatherer();
+        const artifact = await gatherer.getArtifact({
+            url: 'https://example.com',
+            driver: mockDriver,
+        });
+        expect(artifact.pairs.length).toBe(1);
+        expect(artifact.pairs[0]?.hasDirectDefinition).toBe(true);
+        expect(artifact.pairs[0]?.isConcise).toBe(true);
+    });
+});
+//# sourceMappingURL=gatherers.test.js.map

package/dist/__tests__/gatherers.test.js.map

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

package/dist/__tests__/runner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.test.d.ts.map

package/dist/__tests__/runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runner.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/runner.test.js

@@ -0,0 +1,77 @@
+import { describe, it, expect } from 'vitest';
+import { Runner } from '../runner/runner.js';
+import { CheerioDriver } from '../gather/driver/cheerio-driver.js';
+import { HtmlReporter } from '../report/html-reporter.js';
+import { TerminalReporter } from '../report/terminal-reporter.js';
+describe('Runner and Aggregator Full Pipeline', () => {
+    it('ejecuta el ciclo de vida completo de 3 fases y genera reportes', async () => {
+        const mockHtml = `
+      <!DOCTYPE html>
+      <html lang="es">
+      <head>
+        <title>AEO Testing Page</title>
+        <meta name="description" content="Página de prueba para linter AEO">
+        <script type="application/ld+json">
+        {
+          "@context": "https://schema.org",
+          "@type": "FAQPage",
+          "mainEntity": [{
+            "@type": "Question",
+            "name": "¿Qué es GEO?",
+            "acceptedAnswer": {
+              "@type": "Answer",
+              "text": "GEO es Generative Engine Optimization."
+            }
+          }]
+        }
+        </script>
+        <script type="application/ld+json">
+        {
+          "@context": "https://schema.org",
+          "@type": "Organization",
+          "name": "Acme AEO",
+          "sameAs": ["https://wikidata.org/wiki/Q999"]
+        }
+        </script>
+      </head>
+      <body>
+        <main>
+          <article>
+            <h1>Guía Completa de AEO</h1>
+            <h2>¿Qué es la densidad de respuestas directas?</h2>
+            <p>La densidad de respuestas directas es la proporción de consultas de usuario que reciben una definición clara y sintetizada en menos de 60 palabras al inicio de la sección temática.</p>
+            
+            <h2>Estructuración Semántica para RAG</h2>
+            <p>Dividir el texto en bloques de 200 a 400 tokens optimiza la precisión de búsqueda semántica vectorial en modelos como OpenAI y Cohere.</p>
+          </article>
+        </main>
+      </body>
+      </html>
+    `;
+        const mockDriver = new CheerioDriver({
+            url: 'https://aeo-example.com/test',
+            html: mockHtml,
+        });
+        mockDriver.fetch = async () => new Response('User-agent: GPTBot\nAllow: /\nSitemap: https://aeo-example.com/sitemap.xml', {
+            status: 200,
+        });
+        const report = await Runner.run('https://aeo-example.com/test', {
+            driver: mockDriver,
+        });
+        expect(report.url).toBe('https://aeo-example.com/test');
+        expect(report.overallScore).toBeGreaterThan(70);
+        expect(report.categories['ai-accessibility']?.score).toBe(1);
+        expect(report.categories['structured-data']?.score).toBeGreaterThanOrEqual(0.8);
+        expect(report.categories['content-chunking']?.score).toBeGreaterThanOrEqual(0.8);
+        expect(report.categories['direct-answer-density']?.score).toBe(1);
+        // Verificar generación de reportes
+        const terminalOutput = TerminalReporter.generate(report);
+        expect(terminalOutput).toContain('Score General AEO');
+        expect(terminalOutput).toContain('AI Accessibility & Crawling');
+        const htmlOutput = HtmlReporter.generate(report);
+        expect(htmlOutput).toContain('<!DOCTYPE html>');
+        expect(htmlOutput).toContain('https://aeo-example.com/test');
+        expect(htmlOutput).toContain('gauge-container');
+    });
+});
+//# sourceMappingURL=runner.test.js.map

package/dist/__tests__/runner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.test.js","sourceRoot":"","sources":["../../src/__tests__/runner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0ChB,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,aAAa,CAAC;YACnC,GAAG,EAAE,8BAA8B;YACnC,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,UAAU,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE,CAC5B,IAAI,QAAQ,CAAC,4EAA4E,EAAE;YACzF,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;QAEL,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,8BAA8B,EAAE;YAC9D,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAChF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAElE,mCAAmC;QACnC,MAAM,cAAc,GAAG,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzD,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACtD,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAEhE,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAChD,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QAC7D,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/audits/ai-accessibility/ai-bot-sitemap.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para verificar la declaración de Sitemaps accesibles
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class AiBotSitemapAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=ai-bot-sitemap.d.ts.map

package/dist/audits/ai-accessibility/ai-bot-sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-bot-sitemap.d.ts","sourceRoot":"","sources":["../../../src/audits/ai-accessibility/ai-bot-sitemap.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9E,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAc/E"}

package/dist/audits/ai-accessibility/ai-bot-sitemap.js

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Auditoría para verificar la declaración de Sitemaps accesibles
+ */
+import { Audit } from '../audit.js';
+export class AiBotSitemapAudit extends Audit {
+    static meta = {
+        id: 'ai-bot-sitemap',
+        title: 'El archivo robots.txt declara Sitemaps XML válidos',
+        failureTitle: 'No se encontraron declaraciones de Sitemap en robots.txt',
+        description: 'Los Sitemaps XML permiten a los rastreadores de Answer Engines descubrir URLs profundas y estructuradas con alta eficiencia de rastreo.',
+        requiredArtifacts: ['RobotsTxt'],
+    };
+    static async audit(artifacts) {
+        const sitemaps = artifacts.RobotsTxt.sitemaps;
+        const hasSitemap = sitemaps.length > 0;
+        return this.generateAuditResult({
+            score: hasSitemap ? 1 : 0.5,
+            displayValue: hasSitemap
+                ? `${sitemaps.length} sitemap(s) declarados`
+                : 'Ningún sitemap declarado en robots.txt',
+            details: hasSitemap
+                ? this.makeListDetails(sitemaps)
+                : undefined,
+        });
+    }
+}
+//# sourceMappingURL=ai-bot-sitemap.js.map

package/dist/audits/ai-accessibility/ai-bot-sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-bot-sitemap.js","sourceRoot":"","sources":["../../../src/audits/ai-accessibility/ai-bot-sitemap.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACnC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,oDAAoD;QAC3D,YAAY,EAAE,0DAA0D;QACxE,WAAW,EACT,yIAAyI;QAC3I,iBAAiB,EAAE,CAAC,WAAW,CAAC;KACjC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC;QAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAEvC,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;YAC3B,YAAY,EAAE,UAAU;gBACtB,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,wBAAwB;gBAC5C,CAAC,CAAC,wCAAwC;YAC5C,OAAO,EAAE,UAAU;gBACjB,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;gBAChC,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/ai-accessibility/ai-robots-txt.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría que verifica el acceso permitido a rastreadores de IA en robots.txt
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class AiRobotsTxtAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=ai-robots-txt.d.ts.map

package/dist/audits/ai-accessibility/ai-robots-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-robots-txt.d.ts","sourceRoot":"","sources":["../../../src/audits/ai-accessibility/ai-robots-txt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9E,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAgD/E"}

package/dist/audits/ai-accessibility/ai-robots-txt.js

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Auditoría que verifica el acceso permitido a rastreadores de IA en robots.txt
+ */
+import { Audit } from '../audit.js';
+export class AiRobotsTxtAudit extends Audit {
+    static meta = {
+        id: 'ai-robots-txt',
+        title: 'El archivo robots.txt permite el rastreo de los principales bots de IA',
+        failureTitle: 'El archivo robots.txt bloquea o restringe a rastreadores de IA',
+        description: 'Los Answer Engines y sistemas RAG (ChatGPT/SearchGPT, Perplexity, Claude, Gemini) utilizan crawlers dedicados como GPTBot, PerplexityBot y ClaudeBot para indexar y citar fuentes actualizadas.',
+        requiredArtifacts: ['RobotsTxt'],
+    };
+    static async audit(artifacts) {
+        const robots = artifacts.RobotsTxt;
+        if (!robots.exists || !robots.rawContent) {
+            // Si no existe robots.txt, por estándar todos los bots tienen permitido el acceso total
+            return this.generateAuditResult({
+                score: 1,
+                displayValue: 'Robots.txt no restringe el acceso (acceso libre)',
+                explanation: 'No se encontró archivo robots.txt restrictivo, por lo que los bots de IA pueden acceder al contenido.',
+            });
+        }
+        const aiBots = [
+            { id: 'GPTBot', name: 'OpenAI (SearchGPT/ChatGPT)', status: robots.aiBotsStatus.gptBot || 'not_specified' },
+            { id: 'PerplexityBot', name: 'Perplexity AI', status: robots.aiBotsStatus.perplexityBot || 'not_specified' },
+            { id: 'ClaudeBot', name: 'Anthropic Claude', status: robots.aiBotsStatus.claudeBot || 'not_specified' },
+            { id: 'Google-Extended', name: 'Google Gemini / Vertex', status: robots.aiBotsStatus.googleExtended || 'not_specified' },
+            { id: 'CCBot', name: 'Common Crawl (Dataset Open Source)', status: robots.aiBotsStatus.ccBot || 'not_specified' },
+            { id: 'Bytespider', name: 'ByteDance / Doubao', status: robots.aiBotsStatus.bytespider || 'not_specified' },
+        ];
+        let allowedCount = 0;
+        const tableItems = aiBots.map((bot) => {
+            const isAllowed = bot.status === 'allowed' || bot.status === 'not_specified';
+            if (isAllowed)
+                allowedCount++;
+            return {
+                bot: bot.id,
+                purpose: bot.name,
+                status: bot.status === 'disallowed' ? 'Bloqueado (Disallow)' : bot.status === 'partially_disallowed' ? 'Parcialmente restringido' : 'Permitido',
+            };
+        });
+        const score = allowedCount / aiBots.length;
+        return this.generateAuditResult({
+            score: score >= 0.8 ? 1 : score,
+            displayValue: `${allowedCount} de ${aiBots.length} bots de IA con acceso permitido`,
+            details: this.makeTableDetails([
+                { key: 'bot', label: 'User-Agent', valueType: 'code' },
+                { key: 'purpose', label: 'Plataforma / Motor', valueType: 'text' },
+                { key: 'status', label: 'Directiva', valueType: 'status' },
+            ], tableItems),
+        });
+    }
+}
+//# sourceMappingURL=ai-robots-txt.js.map

package/dist/audits/ai-accessibility/ai-robots-txt.js.map

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

package/dist/audits/ai-accessibility/ai-x-robots-tag.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría que verifica las cabeceras HTTP X-Robots-Tag para indexación por IA
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class AiXRobotsTagAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=ai-x-robots-tag.d.ts.map

package/dist/audits/ai-accessibility/ai-x-robots-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-x-robots-tag.d.ts","sourceRoot":"","sources":["../../../src/audits/ai-accessibility/ai-x-robots-tag.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9E,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CA0B/E"}

package/dist/audits/ai-accessibility/ai-x-robots-tag.js

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Auditoría que verifica las cabeceras HTTP X-Robots-Tag para indexación por IA
+ */
+import { Audit } from '../audit.js';
+export class AiXRobotsTagAudit extends Audit {
+    static meta = {
+        id: 'ai-x-robots-tag',
+        title: 'Las cabeceras HTTP no bloquean la indexación ni el archivo de IA',
+        failureTitle: 'Las cabeceras HTTP X-Robots-Tag restringen la indexación',
+        description: 'Directivas como `noindex`, `noarchive` o `noai` en la cabecera HTTP `X-Robots-Tag` impiden que los motores de IA almacenen en caché y procesen la página en sus pipelines de recuperación.',
+        requiredArtifacts: ['HttpHeaders'],
+    };
+    static async audit(artifacts) {
+        const xRobots = artifacts.HttpHeaders.xRobotsTag;
+        if (!xRobots) {
+            return this.generateAuditResult({
+                score: 1,
+                displayValue: 'Cabecera X-Robots-Tag limpia (sin restricciones)',
+            });
+        }
+        const lower = xRobots.toLowerCase();
+        const blockingDirectives = ['noindex', 'none', 'noarchive', 'noai'];
+        const foundBlocking = blockingDirectives.filter((d) => lower.includes(d));
+        const isBlocked = foundBlocking.length > 0;
+        return this.generateAuditResult({
+            score: isBlocked ? 0 : 1,
+            displayValue: isBlocked
+                ? `Directivas bloqueantes encontradas: ${foundBlocking.join(', ')}`
+                : `Directivas permisivas: ${xRobots}`,
+            explanation: isBlocked
+                ? `Se detectó '${xRobots}' en la cabecera X-Robots-Tag, lo cual impide el análisis por modelos de lenguaje.`
+                : undefined,
+        });
+    }
+}
+//# sourceMappingURL=ai-x-robots-tag.js.map

package/dist/audits/ai-accessibility/ai-x-robots-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-x-robots-tag.js","sourceRoot":"","sources":["../../../src/audits/ai-accessibility/ai-x-robots-tag.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACnC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,iBAAiB;QACrB,KAAK,EAAE,kEAAkE;QACzE,YAAY,EAAE,0DAA0D;QACxE,WAAW,EACT,4LAA4L;QAC9L,iBAAiB,EAAE,CAAC,aAAa,CAAC;KACnC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC;QAEjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,CAAC;gBACR,YAAY,EAAE,kDAAkD;aACjE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1E,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAE3C,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxB,YAAY,EAAE,SAAS;gBACrB,CAAC,CAAC,uCAAuC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACnE,CAAC,CAAC,0BAA0B,OAAO,EAAE;YACvC,WAAW,EAAE,SAAS;gBACpB,CAAC,CAAC,eAAe,OAAO,oFAAoF;gBAC5G,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/audit.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Clase base abstracta Audit y utilidades de resultado, siguiendo el diseño de Google Lighthouse.
+ * Cada auditoría concreta hereda de Audit e implementa su método estático `audit()` como una función pura
+ * que evalúa los artefactos requeridos y produce un `AuditResult`.
+ */
+import type { Artifacts, AuditResult, AuditMeta, AuditContext, AuditDetails, TableHeading, TableDetails, ListDetails, ScoreDisplayMode } from '../types/index.js';
+export declare abstract class Audit {
+    /**
+     * Metadatos estáticos de la auditoría.
+     * Debe ser sobrescrito por cada subclase de auditoría concreta.
+     */
+    static meta: AuditMeta;
+    /**
+     * Método puro de ejecución de la auditoría.
+     * @param artifacts Artefactos inmutables recolectados por los Gatherers
+     * @param context Contexto de ejecución opcional
+     */
+    static audit(artifacts: Artifacts, context?: AuditContext): Promise<AuditResult>;
+    /**
+     * Helper para generar un resultado de auditoría consistente
+     */
+    static generateAuditResult(options: {
+        id?: string;
+        score: number | null;
+        scoreDisplayMode?: ScoreDisplayMode;
+        title?: string;
+        description?: string;
+        numericValue?: number;
+        numericUnit?: string;
+        displayValue?: string;
+        explanation?: string;
+        errorMessage?: string;
+        details?: AuditDetails;
+        warnings?: string[];
+    }): AuditResult;
+    /**
+     * Helper para construir un detalle de tipo tabla (Lighthouse TableDetails)
+     */
+    static makeTableDetails(headings: TableHeading[], items: Array<Record<string, unknown>>, summary?: TableDetails['summary']): TableDetails;
+    /**
+     * Helper para construir un detalle de tipo lista
+     */
+    static makeListDetails(items: Array<string | {
+        text: string;
+        subItems?: string[];
+    }>): ListDetails;
+    /**
+     * Helper para calcular puntaje binario
+     */
+    static binaryScore(condition: boolean): number;
+    /**
+     * Helper para calcular puntaje normalizado lineal o acotado
+     */
+    static clampScore(value: number, min?: number, max?: number): number;
+}
+//# sourceMappingURL=audit.d.ts.map

package/dist/audits/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/audits/audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,8BAAsB,KAAK;IACzB;;;OAGG;IACH,OAAc,IAAI,EAAE,SAAS,CAAC;IAE9B;;;;OAIG;WACiB,KAAK,CACvB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC;IAIvB;;OAEG;WACW,mBAAmB,CAAC,OAAO,EAAE;QACzC,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,YAAY,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,GAAG,WAAW;IAiCf;;OAEG;WACW,gBAAgB,CAC5B,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACrC,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,GAChC,YAAY;IASf;;OAEG;WACW,eAAe,CAC3B,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAC3D,WAAW;IAOd;;OAEG;WACW,WAAW,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM;IAIrD;;OAEG;WACW,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,EAAE,GAAG,SAAI,GAAG,MAAM;CAGlE"}