@drowlink/aeo-linter-core 0.1.0

package/dist/audits/audit.js

@@ -0,0 +1,86 @@
+/**
+ * @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`.
+ */
+export class Audit {
+    /**
+     * Metadatos estáticos de la auditoría.
+     * Debe ser sobrescrito por cada subclase de auditoría concreta.
+     */
+    static meta;
+    /**
+     * 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 async audit(artifacts, context) {
+        throw new Error(`El método audit() no ha sido implementado en ${this.name}`);
+    }
+    /**
+     * Helper para generar un resultado de auditoría consistente
+     */
+    static generateAuditResult(options) {
+        const meta = this.meta || {
+            id: options.id ?? 'unknown-audit',
+            title: options.title ?? 'Unknown Audit',
+            description: options.description ?? '',
+        };
+        const isPassing = options.score !== null && options.score >= 0.9;
+        const title = options.title ?? (isPassing ? meta.title : (meta.failureTitle || meta.title));
+        let scoreDisplayMode = options.scoreDisplayMode ?? 'numeric';
+        if (options.score === null && !options.scoreDisplayMode) {
+            scoreDisplayMode = 'notApplicable';
+        }
+        else if (typeof options.score === 'number' && (options.score === 0 || options.score === 1) && !options.scoreDisplayMode) {
+            scoreDisplayMode = 'binary';
+        }
+        return {
+            id: meta.id,
+            score: options.score,
+            scoreDisplayMode,
+            title,
+            description: options.description ?? meta.description,
+            numericValue: options.numericValue,
+            numericUnit: options.numericUnit,
+            displayValue: options.displayValue,
+            explanation: options.explanation,
+            errorMessage: options.errorMessage,
+            details: options.details,
+            warnings: options.warnings,
+        };
+    }
+    /**
+     * Helper para construir un detalle de tipo tabla (Lighthouse TableDetails)
+     */
+    static makeTableDetails(headings, items, summary) {
+        return {
+            type: 'table',
+            headings,
+            items,
+            summary,
+        };
+    }
+    /**
+     * Helper para construir un detalle de tipo lista
+     */
+    static makeListDetails(items) {
+        return {
+            type: 'list',
+            items,
+        };
+    }
+    /**
+     * Helper para calcular puntaje binario
+     */
+    static binaryScore(condition) {
+        return condition ? 1 : 0;
+    }
+    /**
+     * Helper para calcular puntaje normalizado lineal o acotado
+     */
+    static clampScore(value, min = 0, max = 1) {
+        return Math.min(Math.max(value, min), max);
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/audits/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/audits/audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,OAAgB,KAAK;IACzB;;;OAGG;IACI,MAAM,CAAC,IAAI,CAAY;IAE9B;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,KAAK,CACvB,SAAoB,EACpB,OAAsB;QAEtB,MAAM,IAAI,KAAK,CAAC,gDAAgD,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,mBAAmB,CAAC,OAajC;QACC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI;YACxB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,eAAe;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,eAAe;YACvC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;SACvC,CAAC;QAEF,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;QACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAE5F,IAAI,gBAAgB,GAAqB,OAAO,CAAC,gBAAgB,IAAI,SAAS,CAAC;QAC/E,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACxD,gBAAgB,GAAG,eAAe,CAAC;QACrC,CAAC;aAAM,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC1H,gBAAgB,GAAG,QAAQ,CAAC;QAC9B,CAAC;QAED,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB;YAChB,KAAK;YACL,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW;YACpD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,gBAAgB,CAC5B,QAAwB,EACxB,KAAqC,EACrC,OAAiC;QAEjC,OAAO;YACL,IAAI,EAAE,OAAO;YACb,QAAQ;YACR,KAAK;YACL,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,eAAe,CAC3B,KAA4D;QAE5D,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,WAAW,CAAC,SAAkB;QAC1C,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,UAAU,CAAC,KAAa,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/audits/content-chunking/chunk-token-density.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para evaluar el tamaño y densidad de tokens de los bloques de contenido (para RAG)
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class ChunkTokenDensityAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=chunk-token-density.d.ts.map

package/dist/audits/content-chunking/chunk-token-density.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-token-density.d.ts","sourceRoot":"","sources":["../../../src/audits/content-chunking/chunk-token-density.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,sBAAuB,SAAQ,KAAK;IAC/C,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAqC/E"}

package/dist/audits/content-chunking/chunk-token-density.js

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Auditoría para evaluar el tamaño y densidad de tokens de los bloques de contenido (para RAG)
+ */
+import { Audit } from '../audit.js';
+export class ChunkTokenDensityAudit extends Audit {
+    static meta = {
+        id: 'chunk-token-density',
+        title: 'Los bloques de contenido mantienen una densidad óptima de tokens para RAG (150 - 500 tokens)',
+        failureTitle: 'Los bloques de contenido son excesivamente largos o fragmentados',
+        description: 'La mayoría de modelos de embeddings de RAG (OpenAI text-embedding-3, Cohere Embed, Voyage) rinden con mayor precisión cuando los pasajes tienen entre 150 y 500 tokens estructurados bajo un encabezado temático.',
+        requiredArtifacts: ['ContentChunks'],
+    };
+    static async audit(artifacts) {
+        const contentChunks = artifacts.ContentChunks;
+        const chunks = contentChunks.chunks;
+        if (chunks.length === 0) {
+            return this.generateAuditResult({
+                score: 0.5,
+                displayValue: 'No se encontraron bloques sustanciales de texto',
+            });
+        }
+        const optimalChunks = chunks.filter((c) => c.estimatedTokens >= 100 && c.estimatedTokens <= 600);
+        const ratio = optimalChunks.length / chunks.length;
+        const tableItems = chunks.slice(0, 10).map((c) => ({
+            id: c.id,
+            heading: c.headingText || '(Sin encabezado)',
+            words: c.wordCount,
+            tokens: `~${c.estimatedTokens}`,
+            status: c.estimatedTokens >= 100 && c.estimatedTokens <= 600 ? 'Óptimo' : c.estimatedTokens < 100 ? 'Muy corto' : 'Muy extenso',
+        }));
+        return this.generateAuditResult({
+            score: ratio >= 0.7 ? 1 : Math.max(0.4, ratio),
+            displayValue: `${optimalChunks.length} de ${chunks.length} bloques con tamaño óptimo (Promedio: ~${contentChunks.averageChunkTokenCount} tokens)`,
+            details: this.makeTableDetails([
+                { key: 'id', label: 'ID', valueType: 'code' },
+                { key: 'heading', label: 'Encabezado Asociado', valueType: 'text' },
+                { key: 'words', label: 'Palabras', valueType: 'numeric' },
+                { key: 'tokens', label: 'Tokens Estimados', valueType: 'numeric' },
+                { key: 'status', label: 'Diagnóstico', valueType: 'status' },
+            ], tableItems),
+        });
+    }
+}
+//# sourceMappingURL=chunk-token-density.js.map

package/dist/audits/content-chunking/chunk-token-density.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-token-density.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/chunk-token-density.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACxC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,8FAA8F;QACrG,YAAY,EAAE,kEAAkE;QAChF,WAAW,EACT,mNAAmN;QACrN,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QAEpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,iDAAiD;aAChE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAEnD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,OAAO,EAAE,CAAC,CAAC,WAAW,IAAI,kBAAkB;YAC5C,KAAK,EAAE,CAAC,CAAC,SAAS;YAClB,MAAM,EAAE,IAAI,CAAC,CAAC,eAAe,EAAE;YAC/B,MAAM,EAAE,CAAC,CAAC,eAAe,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa;SAChI,CAAC,CAAC,CAAC;QAEJ,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;YAC9C,YAAY,EAAE,GAAG,aAAa,CAAC,MAAM,OAAO,MAAM,CAAC,MAAM,0CAA0C,aAAa,CAAC,sBAAsB,UAAU;YACjJ,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE;gBAC7C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,EAAE;gBACnE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE;gBACzD,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE;gBAClE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE;aAC7D,EACD,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/content-chunking/heading-hierarchy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para validar la jerarquía secuencial de encabezados H1-H6
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class HeadingHierarchyAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=heading-hierarchy.d.ts.map

package/dist/audits/content-chunking/heading-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-hierarchy.d.ts","sourceRoot":"","sources":["../../../src/audits/content-chunking/heading-hierarchy.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,qBAAsB,SAAQ,KAAK;IAC9C,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAgD/E"}

package/dist/audits/content-chunking/heading-hierarchy.js

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Auditoría para validar la jerarquía secuencial de encabezados H1-H6
+ */
+import { Audit } from '../audit.js';
+export class HeadingHierarchyAudit extends Audit {
+    static meta = {
+        id: 'heading-hierarchy',
+        title: 'La estructura de encabezados H1-H6 es secuencial y cuenta con un único H1',
+        failureTitle: 'La jerarquía de encabezados contiene saltos de nivel o múltiples H1',
+        description: 'Una jerarquía clara y secuencial (H1 -> H2 -> H3) permite a los algoritmos de segmentación de RAG indexar el documento en fragmentos con contexto semántico preciso.',
+        requiredArtifacts: ['HeadingsHierarchy'],
+    };
+    static async audit(artifacts) {
+        const hierarchy = artifacts.HeadingsHierarchy;
+        if (hierarchy.headings.length === 0) {
+            return this.generateAuditResult({
+                score: 0,
+                displayValue: 'No se encontraron encabezados (H1-H6)',
+                explanation: 'El documento carece de encabezados semánticos para estructurar el contenido.',
+            });
+        }
+        let deductions = 0;
+        const issues = [];
+        if (hierarchy.h1Count === 0) {
+            deductions += 0.4;
+            issues.push('Falta el encabezado principal H1');
+        }
+        else if (hierarchy.h1Count > 1) {
+            deductions += 0.2;
+            issues.push(`Se detectaron ${hierarchy.h1Count} etiquetas H1 (se recomienda exactamente una)`);
+        }
+        if (!hierarchy.isHierarchySequential) {
+            deductions += 0.3;
+            issues.push(`Se encontraron ${hierarchy.skippedLevels.length} saltos bruscos de nivel (e.g. H1 a H3)`);
+        }
+        const score = this.clampScore(1 - deductions);
+        return this.generateAuditResult({
+            score,
+            displayValue: issues.length === 0 ? 'Jerarquía óptima y secuencial' : issues.join(', '),
+            details: hierarchy.skippedLevels.length > 0
+                ? this.makeTableDetails([
+                    { key: 'from', label: 'Desde Nivel', valueType: 'code' },
+                    { key: 'to', label: 'Hacia Nivel', valueType: 'code' },
+                    { key: 'text', label: 'Texto del Encabezado', valueType: 'text' },
+                ], hierarchy.skippedLevels.map((s) => ({
+                    from: `H${s.from}`,
+                    to: `H${s.to}`,
+                    text: s.text,
+                })))
+                : undefined,
+        });
+    }
+}
+//# sourceMappingURL=heading-hierarchy.js.map

package/dist/audits/content-chunking/heading-hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-hierarchy.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/heading-hierarchy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACvC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,mBAAmB;QACvB,KAAK,EAAE,2EAA2E;QAClF,YAAY,EAAE,qEAAqE;QACnF,WAAW,EACT,sKAAsK;QACxK,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;KACzC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,SAAS,GAAG,SAAS,CAAC,iBAAiB,CAAC;QAE9C,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,CAAC;gBACR,YAAY,EAAE,uCAAuC;gBACrD,WAAW,EAAE,8EAA8E;aAC5F,CAAC,CAAC;QACL,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,SAAS,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YAC5B,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,SAAS,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACjC,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,OAAO,+CAA+C,CAAC,CAAC;QACjG,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC;YACrC,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,kBAAkB,SAAS,CAAC,aAAa,CAAC,MAAM,yCAAyC,CAAC,CAAC;QACzG,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;QAE9C,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACvF,OAAO,EAAE,SAAS,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;gBACzC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CACnB;oBACE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE;oBACxD,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE;oBACtD,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,EAAE;iBAClE,EACD,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE;oBAClB,EAAE,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,CAAC,CAAC,CACJ;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/content-chunking/semantic-containers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para evaluar el uso de etiquetas HTML5 semánticas (<article>, <section>, <main>)
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class SemanticContainersAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=semantic-containers.d.ts.map

package/dist/audits/content-chunking/semantic-containers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-containers.d.ts","sourceRoot":"","sources":["../../../src/audits/content-chunking/semantic-containers.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,uBAAwB,SAAQ,KAAK;IAChD,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAuB/E"}

package/dist/audits/content-chunking/semantic-containers.js

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Auditoría para evaluar el uso de etiquetas HTML5 semánticas (<article>, <section>, <main>)
+ */
+import { Audit } from '../audit.js';
+export class SemanticContainersAudit extends Audit {
+    static meta = {
+        id: 'semantic-containers',
+        title: 'El contenido utiliza contenedores semánticos (<main>, <article>, <section>)',
+        failureTitle: 'El contenido depende de <div> genéricos sin estructura semántica HTML5',
+        description: 'Las etiquetas semánticas como <main>, <article> y <section> delimitan el contenido principal respecto al boilerplate (nav, sidebar, footer), facilitando el chunking limpio en parsers de IA.',
+        requiredArtifacts: ['ContentChunks'],
+    };
+    static async audit(artifacts) {
+        const chunks = artifacts.ContentChunks;
+        const hasMain = chunks.hasSemanticMain;
+        const hasArticleOrSection = chunks.hasSemanticArticle || chunks.hasSemanticSections;
+        let score = 0.3;
+        if (hasMain && hasArticleOrSection) {
+            score = 1;
+        }
+        else if (hasMain || hasArticleOrSection) {
+            score = 0.7;
+        }
+        const tags = chunks.semanticTagsUsed.length > 0 ? chunks.semanticTagsUsed.join(', ') : 'Ninguna (<div/body>)';
+        return this.generateAuditResult({
+            score,
+            displayValue: `Etiquetas semánticas detectadas: ${tags}`,
+            explanation: score < 1
+                ? 'Recomendamos encapsular el contenido clave dentro de <main> y subdividirlo en <article> o <section>.'
+                : undefined,
+        });
+    }
+}
+//# sourceMappingURL=semantic-containers.js.map

package/dist/audits/content-chunking/semantic-containers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-containers.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/semantic-containers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACzC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,6EAA6E;QACpF,YAAY,EAAE,wEAAwE;QACtF,WAAW,EACT,+LAA+L;QACjM,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC;QACvC,MAAM,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,mBAAmB,CAAC;QAEpF,IAAI,KAAK,GAAG,GAAG,CAAC;QAChB,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;YACnC,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;aAAM,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;YAC1C,KAAK,GAAG,GAAG,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;QAE9G,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,oCAAoC,IAAI,EAAE;YACxD,WAAW,EAAE,KAAK,GAAG,CAAC;gBACpB,CAAC,CAAC,sGAAsG;gBACxG,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/direct-answer-density/concise-answer-wordcount.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para evaluar la concisión de respuestas (ideal 30 a 60 palabras)
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class ConciseAnswerWordCountAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=concise-answer-wordcount.d.ts.map

package/dist/audits/direct-answer-density/concise-answer-wordcount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concise-answer-wordcount.d.ts","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/concise-answer-wordcount.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,2BAA4B,SAAQ,KAAK;IACpD,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAkC/E"}

package/dist/audits/direct-answer-density/concise-answer-wordcount.js

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Auditoría para evaluar la concisión de respuestas (ideal 30 a 60 palabras)
+ */
+import { Audit } from '../audit.js';
+export class ConciseAnswerWordCountAudit extends Audit {
+    static meta = {
+        id: 'concise-answer-wordcount',
+        title: 'Las respuestas directas tienen una extensión concisa óptima (30 - 60 palabras)',
+        failureTitle: 'Las respuestas directas son excesivamente extensas o demasiado escuetas',
+        description: 'Los modelos de lenguaje prefieren respuestas de 30 a 60 palabras como respuesta inicial o fragmento destacado para sintetizar en sus resúmenes.',
+        requiredArtifacts: ['DirectAnswers'],
+    };
+    static async audit(artifacts) {
+        const directAnswers = artifacts.DirectAnswers;
+        const pairs = directAnswers.pairs;
+        if (pairs.length === 0) {
+            return this.generateAuditResult({
+                score: 0.5,
+                displayValue: 'Sin preguntas detectadas',
+            });
+        }
+        const conciseCount = directAnswers.conciseAnswersCount;
+        const ratio = conciseCount / pairs.length;
+        const score = ratio >= 0.6 ? 1 : Math.max(0.3, ratio);
+        return this.generateAuditResult({
+            score,
+            displayValue: `${conciseCount} de ${pairs.length} respuestas con longitud concisa óptima`,
+            numericValue: conciseCount,
+            numericUnit: 'respuestas',
+            details: this.makeTableDetails([
+                { key: 'question', label: 'Pregunta', valueType: 'text' },
+                { key: 'words', label: 'Conteo de Palabras', valueType: 'numeric' },
+                { key: 'status', label: 'Evaluación', valueType: 'status' },
+            ], pairs.map((p) => ({
+                question: p.question,
+                words: p.answerWordCount,
+                status: p.isConcise ? 'Conciso (30-60 palabras)' : p.answerWordCount < 20 ? 'Demasiado breve' : 'Extenso (>75 palabras)',
+            }))),
+        });
+    }
+}
+//# sourceMappingURL=concise-answer-wordcount.js.map

package/dist/audits/direct-answer-density/concise-answer-wordcount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concise-answer-wordcount.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/concise-answer-wordcount.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC7C,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,0BAA0B;QAC9B,KAAK,EAAE,gFAAgF;QACvF,YAAY,EAAE,yEAAyE;QACvF,WAAW,EACT,iJAAiJ;QACnJ,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,0BAA0B;aACzC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,YAAY,GAAG,aAAa,CAAC,mBAAmB,CAAC;QACvD,MAAM,KAAK,GAAG,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEtD,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,GAAG,YAAY,OAAO,KAAK,CAAC,MAAM,yCAAyC;YACzF,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,YAAY;YACzB,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;gBACzD,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,SAAS,EAAE;gBACnE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE;aAC5D,EACD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,eAAe;gBACxB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,wBAAwB;aACzH,CAAC,CAAC,CACJ;SACF,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/direct-answer-density/direct-definition-answering.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para evaluar la presencia de definiciones directas a preguntas clave
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class DirectDefinitionAnsweringAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=direct-definition-answering.d.ts.map

package/dist/audits/direct-answer-density/direct-definition-answering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-definition-answering.d.ts","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/direct-definition-answering.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,8BAA+B,SAAQ,KAAK;IACvD,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAoC/E"}

package/dist/audits/direct-answer-density/direct-definition-answering.js

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Auditoría para evaluar la presencia de definiciones directas a preguntas clave
+ */
+import { Audit } from '../audit.js';
+export class DirectDefinitionAnsweringAudit extends Audit {
+    static meta = {
+        id: 'direct-definition-answering',
+        title: 'Las preguntas clave se responden de forma directa con definiciones claras en el primer párrafo',
+        failureTitle: 'Faltan respuestas directas o definiciones claras tras las preguntas clave',
+        description: 'Los Answer Engines (Perplexity, SearchGPT, Google AI Overviews) seleccionan pasajes que entregan una respuesta directa en las primeras líneas (e.g. "X es un...", "El proceso consiste en..."), en lugar de rodeos introductorios.',
+        requiredArtifacts: ['DirectAnswers'],
+    };
+    static async audit(artifacts) {
+        const directAnswers = artifacts.DirectAnswers;
+        const pairs = directAnswers.pairs;
+        if (pairs.length === 0) {
+            return this.generateAuditResult({
+                score: 0.5,
+                displayValue: 'No se detectaron preguntas en encabezados para evaluar respuestas directas',
+                explanation: 'Incorporar encabezados con formato de pregunta (e.g. "¿Qué es X?") favorece la captura de snippets en Answer Engines.',
+            });
+        }
+        const definitionPairs = pairs.filter((p) => p.hasDirectDefinition);
+        const score = Math.max(0.3, definitionPairs.length / pairs.length);
+        const tableItems = pairs.map((p) => ({
+            question: p.question,
+            words: p.answerWordCount,
+            hasDef: p.hasDirectDefinition ? 'Sí (Definición clara)' : 'No (Indirecto o descriptivo)',
+            preview: p.answerText.length > 80 ? p.answerText.slice(0, 80) + '...' : p.answerText,
+        }));
+        return this.generateAuditResult({
+            score: definitionPairs.length > 0 ? (score >= 0.5 ? 1 : 0.7) : 0.4,
+            displayValue: `${definitionPairs.length} de ${pairs.length} preguntas responden con definición directa inmediata`,
+            details: this.makeTableDetails([
+                { key: 'question', label: 'Pregunta Detectada', valueType: 'text' },
+                { key: 'hasDef', label: 'Patrón de Respuesta', valueType: 'status' },
+                { key: 'words', label: 'Palabras', valueType: 'numeric' },
+                { key: 'preview', label: 'Extracto de Respuesta', valueType: 'text' },
+            ], tableItems),
+        });
+    }
+}
+//# sourceMappingURL=direct-definition-answering.js.map

package/dist/audits/direct-answer-density/direct-definition-answering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-definition-answering.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/direct-definition-answering.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAChD,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,6BAA6B;QACjC,KAAK,EAAE,gGAAgG;QACvG,YAAY,EAAE,2EAA2E;QACzF,WAAW,EACT,oOAAoO;QACtO,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,4EAA4E;gBAC1F,WAAW,EAAE,uHAAuH;aACrI,CAAC,CAAC;QACL,CAAC;QAED,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAEnE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,eAAe;YACxB,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,8BAA8B;YACxF,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;SACrF,CAAC,CAAC,CAAC;QAEJ,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG;YAClE,YAAY,EAAE,GAAG,eAAe,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,uDAAuD;YACjH,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,EAAE;gBACnE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,QAAQ,EAAE;gBACpE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE;gBACzD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE;aACtE,EACD,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/direct-answer-density/question-heading-alignment.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para evaluar la formulación de preguntas orientadas a intención de búsqueda en encabezados
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class QuestionHeadingAlignmentAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=question-heading-alignment.d.ts.map

package/dist/audits/direct-answer-density/question-heading-alignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-heading-alignment.d.ts","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/question-heading-alignment.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,6BAA8B,SAAQ,KAAK;IACtD,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAyB/E"}

package/dist/audits/direct-answer-density/question-heading-alignment.js

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Auditoría para evaluar la formulación de preguntas orientadas a intención de búsqueda en encabezados
+ */
+import { Audit } from '../audit.js';
+export class QuestionHeadingAlignmentAudit extends Audit {
+    static meta = {
+        id: 'question-heading-alignment',
+        title: 'Se estructuran encabezados explícitos en formato de pregunta o consulta de usuario',
+        failureTitle: 'Faltan encabezados orientados a consultas de búsqueda o preguntas frecuentes',
+        description: 'Formular encabezados (H2/H3) como preguntas naturales (e.g. "¿Cómo funciona X?", "¿Por qué elegir Y?") incrementa sustancialmente el match semántico en búsquedas vectoriales y RAG.',
+        requiredArtifacts: ['HeadingsHierarchy', 'DirectAnswers'],
+    };
+    static async audit(artifacts) {
+        const headings = artifacts.HeadingsHierarchy.headings;
+        const directAnswers = artifacts.DirectAnswers;
+        const questionHeadings = directAnswers.pairs.length;
+        const totalSubheadings = headings.filter((h) => h.level === 2 || h.level === 3).length;
+        if (totalSubheadings === 0) {
+            return this.generateAuditResult({
+                score: 0.5,
+                displayValue: 'No se encontraron subtítulos H2 o H3',
+            });
+        }
+        const ratio = questionHeadings / Math.max(1, totalSubheadings);
+        const score = questionHeadings >= 1 ? (ratio >= 0.25 ? 1 : 0.8) : 0.4;
+        return this.generateAuditResult({
+            score,
+            displayValue: `${questionHeadings} de ${totalSubheadings} subtítulos estructurados como pregunta`,
+            explanation: questionHeadings === 0
+                ? 'Recomendamos redactar al menos 1 o 2 subtítulos H2/H3 como preguntas directas que los usuarios suelen consultar.'
+                : undefined,
+        });
+    }
+}
+//# sourceMappingURL=question-heading-alignment.js.map

package/dist/audits/direct-answer-density/question-heading-alignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-heading-alignment.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/question-heading-alignment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC/C,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,4BAA4B;QAChC,KAAK,EAAE,oFAAoF;QAC3F,YAAY,EAAE,8EAA8E;QAC5F,WAAW,EACT,sLAAsL;QACxL,iBAAiB,EAAE,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC1D,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,QAAQ,GAAG,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QACtD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAE9C,MAAM,gBAAgB,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QACpD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAEvF,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,sCAAsC;aACrD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAEtE,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,GAAG,gBAAgB,OAAO,gBAAgB,yCAAyC;YACjG,WAAW,EAAE,gBAAgB,KAAK,CAAC;gBACjC,CAAC,CAAC,kHAAkH;gBACpH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Exportación y registro central de todas las auditorías disponibles
+ */
+import { Audit } from './audit.js';
+import { AiRobotsTxtAudit } from './ai-accessibility/ai-robots-txt.js';
+import { AiXRobotsTagAudit } from './ai-accessibility/ai-x-robots-tag.js';
+import { AiBotSitemapAudit } from './ai-accessibility/ai-bot-sitemap.js';
+import { JsonLdSyntaxValidityAudit } from './structured-data/jsonld-syntax-validity.js';
+import { RagSchemaPresenceAudit } from './structured-data/rag-schema-presence.js';
+import { EntitySameAsLinksAudit } from './structured-data/entity-sameas-links.js';
+import { HeadingHierarchyAudit } from './content-chunking/heading-hierarchy.js';
+import { SemanticContainersAudit } from './content-chunking/semantic-containers.js';
+import { ChunkTokenDensityAudit } from './content-chunking/chunk-token-density.js';
+import { DirectDefinitionAnsweringAudit } from './direct-answer-density/direct-definition-answering.js';
+import { ConciseAnswerWordCountAudit } from './direct-answer-density/concise-answer-wordcount.js';
+import { QuestionHeadingAlignmentAudit } from './direct-answer-density/question-heading-alignment.js';
+export { Audit, AiRobotsTxtAudit, AiXRobotsTagAudit, AiBotSitemapAudit, JsonLdSyntaxValidityAudit, RagSchemaPresenceAudit, EntitySameAsLinksAudit, HeadingHierarchyAudit, SemanticContainersAudit, ChunkTokenDensityAudit, DirectDefinitionAnsweringAudit, ConciseAnswerWordCountAudit, QuestionHeadingAlignmentAudit, };
+export declare const auditRegistry: Record<string, typeof Audit>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audits/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAGzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAGlF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wDAAwD,CAAC;AACxG,OAAO,EAAE,2BAA2B,EAAE,MAAM,qDAAqD,CAAC;AAClG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uDAAuD,CAAC;AAEtG,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,EAC3B,6BAA6B,GAC9B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,KAAK,CAatD,CAAC"}

package/dist/audits/index.js

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Exportación y registro central de todas las auditorías disponibles
+ */
+import { Audit } from './audit.js';
+// AI Accessibility
+import { AiRobotsTxtAudit } from './ai-accessibility/ai-robots-txt.js';
+import { AiXRobotsTagAudit } from './ai-accessibility/ai-x-robots-tag.js';
+import { AiBotSitemapAudit } from './ai-accessibility/ai-bot-sitemap.js';
+// Structured Data
+import { JsonLdSyntaxValidityAudit } from './structured-data/jsonld-syntax-validity.js';
+import { RagSchemaPresenceAudit } from './structured-data/rag-schema-presence.js';
+import { EntitySameAsLinksAudit } from './structured-data/entity-sameas-links.js';
+// Content Chunking
+import { HeadingHierarchyAudit } from './content-chunking/heading-hierarchy.js';
+import { SemanticContainersAudit } from './content-chunking/semantic-containers.js';
+import { ChunkTokenDensityAudit } from './content-chunking/chunk-token-density.js';
+// Direct Answer Density
+import { DirectDefinitionAnsweringAudit } from './direct-answer-density/direct-definition-answering.js';
+import { ConciseAnswerWordCountAudit } from './direct-answer-density/concise-answer-wordcount.js';
+import { QuestionHeadingAlignmentAudit } from './direct-answer-density/question-heading-alignment.js';
+export { Audit, AiRobotsTxtAudit, AiXRobotsTagAudit, AiBotSitemapAudit, JsonLdSyntaxValidityAudit, RagSchemaPresenceAudit, EntitySameAsLinksAudit, HeadingHierarchyAudit, SemanticContainersAudit, ChunkTokenDensityAudit, DirectDefinitionAnsweringAudit, ConciseAnswerWordCountAudit, QuestionHeadingAlignmentAudit, };
+export const auditRegistry = {
+    'ai-robots-txt': AiRobotsTxtAudit,
+    'ai-x-robots-tag': AiXRobotsTagAudit,
+    'ai-bot-sitemap': AiBotSitemapAudit,
+    'jsonld-syntax-validity': JsonLdSyntaxValidityAudit,
+    'rag-schema-presence': RagSchemaPresenceAudit,
+    'entity-sameas-links': EntitySameAsLinksAudit,
+    'heading-hierarchy': HeadingHierarchyAudit,
+    'semantic-containers': SemanticContainersAudit,
+    'chunk-token-density': ChunkTokenDensityAudit,
+    'direct-definition-answering': DirectDefinitionAnsweringAudit,
+    'concise-answer-wordcount': ConciseAnswerWordCountAudit,
+    'question-heading-alignment': QuestionHeadingAlignmentAudit,
+};
+//# sourceMappingURL=index.js.map

package/dist/audits/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audits/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,kBAAkB;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,wBAAwB;AACxB,OAAO,EAAE,8BAA8B,EAAE,MAAM,wDAAwD,CAAC;AACxG,OAAO,EAAE,2BAA2B,EAAE,MAAM,qDAAqD,CAAC;AAClG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uDAAuD,CAAC;AAEtG,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,EAC3B,6BAA6B,GAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,eAAe,EAAE,gBAAgB;IACjC,iBAAiB,EAAE,iBAAiB;IACpC,gBAAgB,EAAE,iBAAiB;IACnC,wBAAwB,EAAE,yBAAyB;IACnD,qBAAqB,EAAE,sBAAsB;IAC7C,qBAAqB,EAAE,sBAAsB;IAC7C,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,qBAAqB,EAAE,sBAAsB;IAC7C,6BAA6B,EAAE,8BAA8B;IAC7D,0BAA0B,EAAE,2BAA2B;IACvD,4BAA4B,EAAE,6BAA6B;CAC5D,CAAC"}

package/dist/audits/structured-data/entity-sameas-links.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para evaluar la presencia de enlaces de desambiguación de entidades sameAs
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class EntitySameAsLinksAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=entity-sameas-links.d.ts.map

package/dist/audits/structured-data/entity-sameas-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-sameas-links.d.ts","sourceRoot":"","sources":["../../../src/audits/structured-data/entity-sameas-links.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,sBAAuB,SAAQ,KAAK;IAC/C,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAiC/E"}

package/dist/audits/structured-data/entity-sameas-links.js

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Auditoría para evaluar la presencia de enlaces de desambiguación de entidades sameAs
+ */
+import { Audit } from '../audit.js';
+export class EntitySameAsLinksAudit extends Audit {
+    static meta = {
+        id: 'entity-sameas-links',
+        title: 'Se definen propiedades sameAs para desambiguación en Grafos de Conocimiento',
+        failureTitle: 'No se encontraron enlaces sameAs en los datos estructurados',
+        description: 'La propiedad `sameAs` (con enlaces a Wikidata, Wikipedia, Crunchbase o perfiles oficiales) conecta la marca o tema con entidades verificadas en el Knowledge Graph de los LLMs.',
+        requiredArtifacts: ['JSONLD'],
+    };
+    static async audit(artifacts) {
+        const jsonld = artifacts.JSONLD;
+        const sameAsUrls = jsonld.sameAsUrls;
+        const hasSameAs = sameAsUrls.length > 0;
+        const score = hasSameAs ? 1 : 0.4;
+        const tableItems = sameAsUrls.map((url) => {
+            let authority = 'Enlace de Autoridad Externa';
+            if (url.includes('wikidata.org'))
+                authority = 'Wikidata (Alta Confianza)';
+            else if (url.includes('wikipedia.org'))
+                authority = 'Wikipedia (Alta Confianza)';
+            else if (url.includes('linkedin.com') || url.includes('twitter.com') || url.includes('x.com'))
+                authority = 'Red Social Oficial';
+            return {
+                url,
+                type: authority,
+            };
+        });
+        return this.generateAuditResult({
+            score,
+            displayValue: hasSameAs ? `${sameAsUrls.length} enlace(s) sameAs encontrados` : 'Sin enlaces sameAs',
+            details: hasSameAs
+                ? this.makeTableDetails([
+                    { key: 'url', label: 'URL sameAs', valueType: 'url' },
+                    { key: 'type', label: 'Tipo de Entidad', valueType: 'text' },
+                ], tableItems)
+                : undefined,
+        });
+    }
+}
+//# sourceMappingURL=entity-sameas-links.js.map

package/dist/audits/structured-data/entity-sameas-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-sameas-links.js","sourceRoot":"","sources":["../../../src/audits/structured-data/entity-sameas-links.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACxC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,6EAA6E;QACpF,YAAY,EAAE,6DAA6D;QAC3E,WAAW,EACT,iLAAiL;QACnL,iBAAiB,EAAE,CAAC,QAAQ,CAAC;KAC9B,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAErC,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAElC,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACxC,IAAI,SAAS,GAAG,6BAA6B,CAAC;YAC9C,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,SAAS,GAAG,2BAA2B,CAAC;iBACrE,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAAE,SAAS,GAAG,4BAA4B,CAAC;iBAC5E,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS,GAAG,oBAAoB,CAAC;YAEhI,OAAO;gBACL,GAAG;gBACH,IAAI,EAAE,SAAS;aAChB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,+BAA+B,CAAC,CAAC,CAAC,oBAAoB;YACpG,OAAO,EAAE,SAAS;gBAChB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CACnB;oBACE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE;oBACrD,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE;iBAC7D,EACD,UAAU,CACX;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}