@drowlink/aeo-linter-core 0.1.0

package/dist/types/artifacts.d.ts

@@ -0,0 +1,188 @@
+/**
+ * @fileoverview Tipos y contratos para los artefactos recolectados por los Gatherers.
+ * Siguiendo el patrón de Google Lighthouse, los Gatherers extraen datos crudos del DOM/red
+ * y producen un objeto tipado `Artifacts` que las auditorías consumen como funciones puras.
+ */
+/**
+ * Información de URL navegada y redirigida
+ */
+export interface URLArtifact {
+    requestedUrl: string;
+    finalUrl: string;
+    domain: string;
+    pathname: string;
+    protocol: string;
+}
+/**
+ * Regla de acceso para un User-Agent específico en robots.txt
+ */
+export interface RobotsAgentRule {
+    userAgent: string;
+    allow: string[];
+    disallow: string[];
+    crawlDelay?: number;
+}
+/**
+ * Artefacto con el contenido e interpretación del archivo robots.txt
+ */
+export interface RobotsTxtArtifact {
+    rawContent: string | null;
+    statusCode: number | null;
+    exists: boolean;
+    sitemaps: string[];
+    /** Reglas por User-Agent mapeadas por nombre en minúsculas */
+    rulesByAgent: Record<string, RobotsAgentRule>;
+    /** Directivas específicas identificadas para bots de IA conocidos */
+    aiBotsStatus: {
+        gptBot?: 'allowed' | 'disallowed' | 'partially_disallowed' | 'not_specified';
+        perplexityBot?: 'allowed' | 'disallowed' | 'partially_disallowed' | 'not_specified';
+        claudeBot?: 'allowed' | 'disallowed' | 'partially_disallowed' | 'not_specified';
+        googleExtended?: 'allowed' | 'disallowed' | 'partially_disallowed' | 'not_specified';
+        ccBot?: 'allowed' | 'disallowed' | 'partially_disallowed' | 'not_specified';
+        bytespider?: 'allowed' | 'disallowed' | 'partially_disallowed' | 'not_specified';
+        cohereAi?: 'allowed' | 'disallowed' | 'partially_disallowed' | 'not_specified';
+    };
+}
+/**
+ * Encabezados HTTP recolectados de la respuesta principal
+ */
+export interface HttpHeadersArtifact {
+    statusCode: number;
+    headers: Record<string, string | string[]>;
+    xRobotsTag: string | null;
+    contentType: string | null;
+    cacheControl: string | null;
+    contentEncoding: string | null;
+}
+/**
+ * Item o nodo JSON-LD individual extraído del documento
+ */
+export interface JSONLDItem {
+    raw: string;
+    parsed: Record<string, unknown> | null;
+    type: string | string[] | null;
+    context: string | null;
+    isValid: boolean;
+    syntaxErrors?: string[];
+}
+/**
+ * Artefacto de datos estructurados JSON-LD
+ */
+export interface JSONLDArtifact {
+    items: JSONLDItem[];
+    schemasCountByType: Record<string, number>;
+    hasFAQPage: boolean;
+    hasHowTo: boolean;
+    hasArticle: boolean;
+    hasQAPage: boolean;
+    hasOrganization: boolean;
+    hasProduct: boolean;
+    hasSameAs: boolean;
+    sameAsUrls: string[];
+}
+/**
+ * Meta etiquetas y atributos de cabecera HTML
+ */
+export interface MetaTagsArtifact {
+    title: string | null;
+    description: string | null;
+    canonicalUrl: string | null;
+    viewport: string | null;
+    charset: string | null;
+    openGraph: Record<string, string>;
+    twitterCard: Record<string, string>;
+    robotsMeta: string | null;
+}
+/**
+ * Elemento de encabezado en la jerarquía del DOM
+ */
+export interface HeadingNode {
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    text: string;
+    id?: string;
+    index: number;
+    parentHeadingIndex?: number;
+}
+/**
+ * Artefacto con el análisis de jerarquía de encabezados (H1-H6)
+ */
+export interface HeadingsHierarchyArtifact {
+    headings: HeadingNode[];
+    h1Count: number;
+    h2Count: number;
+    h3Count: number;
+    hasSingleH1: boolean;
+    isHierarchySequential: boolean;
+    skippedLevels: Array<{
+        from: number;
+        to: number;
+        text: string;
+    }>;
+}
+/**
+ * Bloque o chunk de contenido semántico orientado a ingestión RAG / LLM
+ */
+export interface ContentChunk {
+    id: string;
+    headingText?: string;
+    headingLevel?: number;
+    text: string;
+    wordCount: number;
+    estimatedTokens: number;
+    parentTag: string;
+    hasList: boolean;
+    hasTable: boolean;
+    hasCode: boolean;
+    isSemanticContainer: boolean;
+}
+/**
+ * Artefacto de fragmentación de contenido semántico (Chunking)
+ */
+export interface ContentChunksArtifact {
+    chunks: ContentChunk[];
+    totalWordCount: number;
+    totalEstimatedTokens: number;
+    averageChunkTokenCount: number;
+    semanticTagsUsed: string[];
+    hasSemanticMain: boolean;
+    hasSemanticArticle: boolean;
+    hasSemanticSections: boolean;
+}
+/**
+ * Detección de patrones de pregunta y respuesta directa en el contenido
+ */
+export interface DirectAnswerPair {
+    question: string;
+    questionSource: 'heading' | 'bold_text' | 'faq_schema' | 'paragraph';
+    answerText: string;
+    answerWordCount: number;
+    isConcise: boolean;
+    hasDirectDefinition: boolean;
+    confidenceScore: number;
+}
+/**
+ * Artefacto con la densidad de respuestas directas identificadas
+ */
+export interface DirectAnswersArtifact {
+    pairs: DirectAnswerPair[];
+    directAnswerRatio: number;
+    conciseAnswersCount: number;
+    definitionPatternsFound: number;
+}
+/**
+ * Contrato principal de artefactos recopilados por el pipeline de Gatherers.
+ * Este objeto es inmutable y se entrega a cada Audit.
+ */
+export interface Artifacts {
+    URL: URLArtifact;
+    RobotsTxt: RobotsTxtArtifact;
+    HttpHeaders: HttpHeadersArtifact;
+    JSONLD: JSONLDArtifact;
+    MetaTags: MetaTagsArtifact;
+    HeadingsHierarchy: HeadingsHierarchyArtifact;
+    ContentChunks: ContentChunksArtifact;
+    DirectAnswers: DirectAnswersArtifact;
+    /** Espacio para artefactos personalizados de extensiones o plugins */
+    [customArtifact: string]: unknown;
+}
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/types/artifacts.d.ts.map

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

package/dist/types/artifacts.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Tipos y contratos para los artefactos recolectados por los Gatherers.
+ * Siguiendo el patrón de Google Lighthouse, los Gatherers extraen datos crudos del DOM/red
+ * y producen un objeto tipado `Artifacts` que las auditorías consumen como funciones puras.
+ */
+export {};
+//# sourceMappingURL=artifacts.js.map

package/dist/types/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/types/artifacts.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/audit.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Tipos y contratos para las auditorías, resultados y detalles.
+ * Diseñado replicando fielmente la estructura de Google Lighthouse.
+ */
+import type { Artifacts } from './artifacts.js';
+/**
+ * Modo de presentación visual del puntaje
+ */
+export type ScoreDisplayMode = 'binary' | 'numeric' | 'informative' | 'notApplicable' | 'error' | 'manual';
+/**
+ * Encabezado de columna para detalles tabulares
+ */
+export interface TableHeading {
+    key: string;
+    label: string;
+    valueType?: 'text' | 'url' | 'numeric' | 'code' | 'bytes' | 'ms' | 'status';
+    subItemsHeading?: {
+        key: string;
+        valueType?: string;
+    };
+}
+/**
+ * Detalle tipo tabla para mostrar elementos evaluados
+ */
+export interface TableDetails {
+    type: 'table';
+    headings: TableHeading[];
+    items: Array<Record<string, unknown>>;
+    summary?: {
+        wastedMs?: number;
+        wastedBytes?: number;
+        totalItems?: number;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Detalle tipo lista simple de hallazgos
+ */
+export interface ListDetails {
+    type: 'list';
+    items: Array<string | {
+        text: string;
+        subItems?: string[];
+    }>;
+}
+/**
+ * Detalle para datos de depuración / inspección cruda
+ */
+export interface DebugDataDetails {
+    type: 'debugdata';
+    data: Record<string, unknown>;
+}
+/**
+ * Detalle para oportunidades de mejora con ahorros o ganancias
+ */
+export interface OpportunityDetails {
+    type: 'opportunity';
+    headings: TableHeading[];
+    items: Array<Record<string, unknown>>;
+    potentialGain?: string;
+}
+/**
+ * Unión de tipos de detalles admitidos en el resultado de auditoría
+ */
+export type AuditDetails = TableDetails | ListDetails | DebugDataDetails | OpportunityDetails;
+/**
+ * Resultado formal retornado por la ejecución de una auditoría
+ */
+export interface AuditResult {
+    /** Identificador único de la auditoría (e.g. 'ai-robots-txt') */
+    id: string;
+    /** Puntaje normalizado entre 0 y 1 (o null si es notApplicable / informative) */
+    score: number | null;
+    /** Modo de visualización del score */
+    scoreDisplayMode: ScoreDisplayMode;
+    /** Título descriptivo (en estado exitoso o general) */
+    title: string;
+    /** Explicación detallada de la auditoría y por qué es importante para AEO */
+    description: string;
+    /** Valor numérico crudo asociado (e.g. 85 para 85 palabras o 3 para 3 errores) */
+    numericValue?: number;
+    /** Unidad del valor numérico (e.g. 'words', 'ms', 'items', '%') */
+    numericUnit?: string;
+    /** Texto formateado para presentación directa (e.g. "3 direct answers found") */
+    displayValue?: string;
+    /** Razón por la cual la auditoría falló o dio este score */
+    explanation?: string;
+    /** Mensaje de error si la auditoría falló al ejecutarse */
+    errorMessage?: string;
+    /** Detalles estructurados para rendering en UI/CLI */
+    details?: AuditDetails;
+    /** Advertencias opcionales que no invalidan el score pero informan al usuario */
+    warnings?: string[];
+}
+/**
+ * Metadatos estáticos requeridos por cada definición de auditoría
+ */
+export interface AuditMeta {
+    /** ID único de la auditoría */
+    id: string;
+    /** Título cuando pasa o título neutral */
+    title: string;
+    /** Título cuando la auditoría falla o no alcanza el score deseado */
+    failureTitle?: string;
+    /** Explicación y enlaces de documentación (Markdown) */
+    description: string;
+    /** Artefactos que esta auditoría requiere para poder ejecutarse */
+    requiredArtifacts: Array<keyof Artifacts>;
+}
+/**
+ * Contexto de ejecución pasado a la función de auditoría
+ */
+export interface AuditContext {
+    options?: Record<string, unknown>;
+    settings?: {
+        locale?: string;
+        maxWaitForFulfill?: number;
+        [key: string]: unknown;
+    };
+    computedCache?: Map<string, unknown>;
+}
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/types/audit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,SAAS,GACT,aAAa,GACb,eAAe,GACf,OAAO,GACP,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAC;IAC5E,eAAe,CAAC,EAAE;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,WAAW,GACX,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sCAAsC;IACtC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,iBAAiB,EAAE,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC"}

package/dist/types/audit.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Tipos y contratos para las auditorías, resultados y detalles.
+ * Diseñado replicando fielmente la estructura de Google Lighthouse.
+ */
+export {};
+//# sourceMappingURL=audit.js.map

package/dist/types/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/types/audit.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview Tipos para la configuración, categorías y cálculo ponderado de scores.
+ */
+import type { AuditMeta } from './audit.js';
+/**
+ * Referencia a una auditoría dentro de una categoría, con su peso específico
+ */
+export interface AuditRef {
+    /** Identificador de la auditoría */
+    id: string;
+    /** Peso relativo de la auditoría en la categoría (e.g. 1 a 10) */
+    weight: number;
+    /** Grupo visual opcional para organizar en la UI / reporte */
+    group?: string;
+}
+/**
+ * Categoría que agrupa auditorías temáticas
+ */
+export interface CategoryConfig {
+    /** Título de la categoría */
+    title: string;
+    /** Descripción del propósito y su relevancia en AEO */
+    description: string;
+    /** Lista de auditorías ponderadas que pertenecen a esta categoría */
+    auditRefs: AuditRef[];
+    /** Peso global de la categoría respecto al score total (opcional) */
+    weight?: number;
+}
+/**
+ * Configuración completa del linter
+ */
+export interface LinterConfig {
+    /** Categorías configuradas */
+    categories: Record<string, CategoryConfig>;
+    /** Auditorías registradas en esta configuración (IDs o Metas) */
+    audits?: Array<string | AuditMeta>;
+    /** Configuración global y banderas */
+    settings?: {
+        locale?: string;
+        maxWaitForFulfill?: number;
+        userAgent?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Resultado evaluado de una categoría con su puntaje ponderado
+ */
+export interface CategoryResult {
+    id: string;
+    title: string;
+    description: string;
+    /** Score ponderado de la categoría (0 - 1) */
+    score: number | null;
+    /** Auditorías ejecutadas asociadas a esta categoría con sus resultados */
+    auditRefs: Array<AuditRef & {
+        result: import('./audit.js').AuditResult;
+    }>;
+}
+/**
+ * Resultado completo del análisis AEO
+ */
+export interface AeoReportResult {
+    url: string;
+    fetchTime: string;
+    aeoVersion: string;
+    userAgent: string;
+    /** Puntuación general agregada (0 - 100) */
+    overallScore: number;
+    /** Resultados por categoría */
+    categories: Record<string, CategoryResult>;
+    /** Mapa directo de auditorías por id */
+    audits: Record<string, import('./audit.js').AuditResult>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,iEAAiE;IACjE,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnC,sCAAsC;IACtC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,0EAA0E;IAC1E,SAAS,EAAE,KAAK,CAAC,QAAQ,GAAG;QAAE,MAAM,EAAE,OAAO,YAAY,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,YAAY,EAAE,WAAW,CAAC,CAAC;CAC1D"}

package/dist/types/config.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Tipos para la configuración, categorías y cálculo ponderado de scores.
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/gatherer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Tipos y contratos para la fase de Gatherers (recolección).
+ */
+import type { Artifacts } from './artifacts.js';
+/**
+ * Driver abstracto o adaptador de protocolo para extraer información de la página/DOM
+ */
+export interface Driver {
+    evaluate<T>(script: string | (() => T)): Promise<T>;
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+    getUrl(): Promise<string>;
+    getHtml(): Promise<string>;
+    getHttpHeaders(): Promise<Record<string, string | string[]>>;
+}
+/**
+ * Contexto de recolección entregado a cada Gatherer
+ */
+export interface GathererContext {
+    url: string;
+    driver: Driver;
+    settings?: Record<string, unknown>;
+}
+/**
+ * Interfaz base para un Gatherer
+ */
+export interface IGatherer<K extends keyof Artifacts = keyof Artifacts> {
+    /** Nombre del artefacto que produce */
+    name: K;
+    /** Método de recolección */
+    getArtifact(context: GathererContext): Promise<Artifacts[K]>;
+}
+//# sourceMappingURL=gatherer.d.ts.map

package/dist/types/gatherer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherer.d.ts","sourceRoot":"","sources":["../../src/types/gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS;IACpE,uCAAuC;IACvC,IAAI,EAAE,CAAC,CAAC;IACR,4BAA4B;IAC5B,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9D"}

package/dist/types/gatherer.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Tipos y contratos para la fase de Gatherers (recolección).
+ */
+export {};
+//# sourceMappingURL=gatherer.js.map

package/dist/types/gatherer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherer.js","sourceRoot":"","sources":["../../src/types/gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Exportaciones de todos los tipos del motor AEO Linter
+ */
+export * from './artifacts.js';
+export * from './audit.js';
+export * from './config.js';
+export * from './gatherer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Exportaciones de todos los tipos del motor AEO Linter
+ */
+export * from './artifacts.js';
+export * from './audit.js';
+export * from './config.js';
+export * from './gatherer.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@drowlink/aeo-linter-core",
+  "version": "0.1.0",
+  "description": "Core engine and audit pipeline for AEO/GEO linter (Lighthouse architecture)",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/default-config.d.ts",
+      "import": "./dist/config/default-config.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DrowLink/aeo-audit-linter.git",
+    "directory": "core"
+  },
+  "keywords": [
+    "aeo",
+    "geo",
+    "linter",
+    "lighthouse",
+    "seo",
+    "ai-search",
+    "rag"
+  ],
+  "author": "DrowLink",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "dependencies": {
+    "cheerio": "^1.2.0"
+  }
+}