@agentsean/analyzers 1.0.0

package/dist/schemaorg.d.ts

@@ -0,0 +1,28 @@
+import type { JsonLdBlock } from "@agentsean/crawler";
+type Vocab = {
+    version: string;
+    types: Record<string, string[]>;
+    enums: Record<string, string[]>;
+};
+type Supported = {
+    version: string;
+    fetched: string;
+    supported: string[];
+    deprecated: Record<string, string>;
+    features: Record<string, {
+        required: string[];
+        recommended: string[];
+    }>;
+};
+export declare function schemaVocab(): Vocab;
+export declare function googleSupportedTypes(): Supported;
+export type JsonLdIssue = {
+    code: "PARSE_ERROR" | "MISSING_CONTEXT" | "MISSING_TYPE" | "UNKNOWN_TYPE" | "TYPE_DEPRECATED" | "MISSING_REQUIRED_PROP" | "MISSING_RECOMMENDED_PROP" | "INVALID_ENUM" | "INVALID_DATE" | "INVALID_DURATION";
+    message: string;
+    type: string | null;
+    property: string | null;
+};
+export declare function validateJsonLdBlocks(blocks: JsonLdBlock[]): JsonLdIssue[];
+export declare function flattenTypes(node: unknown, acc?: string[]): string[];
+export {};
+//# sourceMappingURL=schemaorg.d.ts.map

package/dist/schemaorg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaorg.d.ts","sourceRoot":"","sources":["../src/schemaorg.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,KAAK,KAAK,GAAG;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACzE,CAAC;AAsBF,wBAAgB,WAAW,IAAI,KAAK,CAGnC;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAGhD;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EACA,aAAa,GACb,iBAAiB,GACjB,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,uBAAuB,GACvB,0BAA0B,GAC1B,cAAc,GACd,cAAc,GACd,kBAAkB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAezE;AAyID,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAexE"}

package/dist/schemaorg.js

@@ -0,0 +1,198 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+function loadJson(name) {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        path.join(here, "data", name),
+        path.join(here, "../src/data", name),
+        path.join(here, "../../src/data", name),
+    ];
+    for (const p of candidates) {
+        try {
+            return JSON.parse(readFileSync(p, "utf8"));
+        }
+        catch {
+            /* try next */
+        }
+    }
+    throw new Error(`missing data file ${name}`);
+}
+let vocabCache;
+let supportedCache;
+export function schemaVocab() {
+    vocabCache ??= loadJson("schemaorg-vocab.json");
+    return vocabCache;
+}
+export function googleSupportedTypes() {
+    supportedCache ??= loadJson("supported_types.json");
+    return supportedCache;
+}
+export function validateJsonLdBlocks(blocks) {
+    const issues = [];
+    for (const block of blocks) {
+        if (block.error) {
+            issues.push({
+                code: "PARSE_ERROR",
+                message: block.error,
+                type: null,
+                property: null,
+            });
+            continue;
+        }
+        issues.push(...validateNode(block.parsed));
+    }
+    return issues;
+}
+function validateNode(node, acc = []) {
+    if (Array.isArray(node)) {
+        for (const n of node)
+            validateNode(n, acc);
+        return acc;
+    }
+    if (!node || typeof node !== "object")
+        return acc;
+    const obj = node;
+    if (obj["@graph"]) {
+        validateNode(obj["@graph"], acc);
+        return acc;
+    }
+    const ctx = obj["@context"];
+    const typeVal = obj["@type"];
+    if (ctx === undefined) {
+        acc.push({
+            code: "MISSING_CONTEXT",
+            message: "No @context",
+            type: null,
+            property: "@context",
+        });
+    }
+    else if (typeof ctx === "string" && !ctx.includes("schema.org")) {
+        acc.push({
+            code: "MISSING_CONTEXT",
+            message: `@context is not schema.org: ${ctx}`,
+            type: null,
+            property: "@context",
+        });
+    }
+    if (typeVal === undefined) {
+        acc.push({
+            code: "MISSING_TYPE",
+            message: "No @type",
+            type: null,
+            property: "@type",
+        });
+        return acc;
+    }
+    const types = Array.isArray(typeVal) ? typeVal.map(String) : [String(typeVal)];
+    const vocab = schemaVocab();
+    const gallery = googleSupportedTypes();
+    for (const t of types) {
+        const short = t.replace(/^https?:\/\/schema\.org\//, "");
+        if (!(short in vocab.types) && !gallery.supported.includes(short)) {
+            acc.push({
+                code: "UNKNOWN_TYPE",
+                message: `Unknown @type ${short}`,
+                type: short,
+                property: "@type",
+            });
+        }
+        if (short in gallery.deprecated) {
+            acc.push({
+                code: "TYPE_DEPRECATED",
+                message: gallery.deprecated[short] ?? "deprecated",
+                type: short,
+                property: "@type",
+            });
+        }
+        const feature = gallery.features[short];
+        if (feature) {
+            for (const req of feature.required) {
+                if (obj[req] === undefined) {
+                    acc.push({
+                        code: "MISSING_REQUIRED_PROP",
+                        message: `${short} missing required ${req}`,
+                        type: short,
+                        property: req,
+                    });
+                }
+            }
+            for (const rec of feature.recommended) {
+                if (obj[rec] === undefined) {
+                    acc.push({
+                        code: "MISSING_RECOMMENDED_PROP",
+                        message: `${short} missing recommended ${rec}`,
+                        type: short,
+                        property: rec,
+                    });
+                }
+            }
+        }
+        if (typeof obj["availability"] === "string") {
+            const allowed = vocab.enums["ItemAvailability"] ?? [];
+            const v = String(obj["availability"]);
+            if (allowed.length &&
+                !allowed.includes(v) &&
+                !allowed.includes(`https://schema.org/${v}`)) {
+                acc.push({
+                    code: "INVALID_ENUM",
+                    message: `Bad availability ${v}`,
+                    type: short,
+                    property: "availability",
+                });
+            }
+        }
+        for (const key of [
+            "datePublished",
+            "dateModified",
+            "startDate",
+            "endDate",
+            "datePosted",
+        ]) {
+            const v = obj[key];
+            if (typeof v === "string" && !isIsoDate(v)) {
+                acc.push({
+                    code: "INVALID_DATE",
+                    message: `${key} is not ISO 8601`,
+                    type: short,
+                    property: key,
+                });
+            }
+        }
+        for (const key of ["prepTime", "cookTime", "duration"]) {
+            const v = obj[key];
+            if (typeof v === "string" && !v.startsWith("P")) {
+                acc.push({
+                    code: "INVALID_DURATION",
+                    message: `${key} is not ISO 8601 duration`,
+                    type: short,
+                    property: key,
+                });
+            }
+        }
+    }
+    return acc;
+}
+function isIsoDate(v) {
+    return /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})?)?$/.test(v);
+}
+export function flattenTypes(node, acc = []) {
+    if (Array.isArray(node)) {
+        for (const n of node)
+            flattenTypes(n, acc);
+        return acc;
+    }
+    if (!node || typeof node !== "object")
+        return acc;
+    const obj = node;
+    if (obj["@graph"])
+        return flattenTypes(obj["@graph"], acc);
+    const t = obj["@type"];
+    if (t) {
+        for (const x of Array.isArray(t) ? t : [t]) {
+            acc.push(String(x).replace(/^https?:\/\/schema\.org\//, ""));
+        }
+    }
+    return acc;
+}
+//# sourceMappingURL=schemaorg.js.map

package/dist/schemaorg.js.map

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

package/dist/score.d.ts

@@ -0,0 +1,10 @@
+import type { FindingDraft, SiteScore } from "./types.js";
+import type { CrawlResult } from "@agentsean/crawler";
+/** Published, versioned Site Score formula. Never retro-compute old scores. */
+export declare const SITE_SCORE_VERSION = "ss-1.0.0";
+export declare const SITE_SCORE_FORMULA = "SiteScore = round(100 \u00D7 \u03A3(w\u1D62 \u00D7 s\u1D62)) where \u03A3w\u1D62 = 1, each s\u1D62 \u2208 [0,1]\nPillars (ss-1.0.0):\n  1. Indexability & crawlability  w=0.25\n  2. On-page fundamentals         w=0.20\n  3. Structured data              w=0.10\n  4. Internal linking             w=0.10\n  5. Performance / CWV            w=0.10\n  6. Search performance trend     w=0.15  (redistributed when no GSC)\n  7. AI visibility                w=0.05  (robots AI-bot access until Phase 9)\n  8. Content freshness & quality  w=0.05\nBands: 0\u201330 Poor \u00B7 31\u201370 Needs work \u00B7 71\u201390 Good \u00B7 91\u2013100 Excellent.\nA pillar with no applicable signal is excluded and weights renormalised.\n<50 crawled URLs \u2192 provisional. No GSC \u2192 partial.";
+export declare function computeSiteScore(crawl: CrawlResult, findings: FindingDraft[], opts?: {
+    hasGsc?: boolean | undefined;
+    hasCrux?: boolean | undefined;
+}): SiteScore;
+//# sourceMappingURL=score.d.ts.map

package/dist/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAe,SAAS,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C,eAAO,MAAM,kBAAkB,4wBAYmB,CAAC;AAanD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,GACrE,SAAS,CAiKX"}

package/dist/score.js

@@ -0,0 +1,177 @@
+import { selfCanonical } from "./detectors/predicates.js";
+/** Published, versioned Site Score formula. Never retro-compute old scores. */
+export const SITE_SCORE_VERSION = "ss-1.0.0";
+export const SITE_SCORE_FORMULA = `SiteScore = round(100 × Σ(wᵢ × sᵢ)) where Σwᵢ = 1, each sᵢ ∈ [0,1]
+Pillars (ss-1.0.0):
+  1. Indexability & crawlability  w=0.25
+  2. On-page fundamentals         w=0.20
+  3. Structured data              w=0.10
+  4. Internal linking             w=0.10
+  5. Performance / CWV            w=0.10
+  6. Search performance trend     w=0.15  (redistributed when no GSC)
+  7. AI visibility                w=0.05  (robots AI-bot access until Phase 9)
+  8. Content freshness & quality  w=0.05
+Bands: 0–30 Poor · 31–70 Needs work · 71–90 Good · 91–100 Excellent.
+A pillar with no applicable signal is excluded and weights renormalised.
+<50 crawled URLs → provisional. No GSC → partial.`;
+const PILLARS = [
+    { id: "indexability", name: "Indexability & crawlability", weight: 0.25 },
+    { id: "onpage", name: "On-page fundamentals", weight: 0.2 },
+    { id: "structured", name: "Structured data & rich results", weight: 0.1 },
+    { id: "linking", name: "Internal linking", weight: 0.1 },
+    { id: "performance", name: "Performance / CWV", weight: 0.1 },
+    { id: "search", name: "Search performance trend", weight: 0.15 },
+    { id: "ai", name: "AI visibility", weight: 0.05 },
+    { id: "content", name: "Content freshness & quality", weight: 0.05 },
+];
+export function computeSiteScore(crawl, findings, opts) {
+    const notes = [];
+    const htmlPages = crawl.pages.filter((p) => p.extract && p.statusCode === 200);
+    const n = Math.max(1, htmlPages.length);
+    const ids = new Set(findings.map((f) => f.ruleId));
+    const errorUrls = crawl.pages.filter((p) => p.isInternal &&
+        p.statusCode !== null &&
+        (p.statusCode >= 400 || p.redirectChain.length >= 3 || !p.robotsAllowed)).length;
+    const indexability = clamp01(1 - errorUrls / Math.max(1, crawl.pages.length));
+    const onpagePass = htmlPages.filter((p) => {
+        const t = p.extract?.title ?? "";
+        const d = p.extract?.metaDescription ?? "";
+        return (t.length >= 15 &&
+            t.length <= 60 &&
+            d.length >= 70 &&
+            d.length <= 160 &&
+            (p.extract?.h1.length ?? 0) === 1 &&
+            selfCanonical(p));
+    }).length;
+    const onpage = onpagePass / n;
+    const schemaPages = htmlPages.filter((p) => (p.extract?.jsonLd.length ?? 0) > 0);
+    const schemaErrors = findings.filter((f) => f.ruleId.startsWith("SD.") && f.severity === "critical").length;
+    const structured = htmlPages.length === 0
+        ? 0
+        : clamp01(schemaPages.length / n - schemaErrors / Math.max(1, schemaPages.length));
+    const orphans = findings.find((f) => f.ruleId === "CRAWL.ORPHAN")?.urls.length ?? 0;
+    const deep = htmlPages.filter((p) => p.depth > 3).length;
+    const linking = clamp01(1 - orphans / n - 0.5 * (deep / n));
+    let performance = 0.7;
+    let performanceApplied = false;
+    let performanceNote = "No CrUX or Lighthouse data; using crawl TTFB proxy.";
+    if (opts?.hasCrux) {
+        performanceApplied = true;
+        performanceNote = null;
+        const fail = ["CWV.LCP_FAIL", "CWV.INP_FAIL", "CWV.CLS_FAIL"].filter((id) => ids.has(id)).length;
+        performance = clamp01(1 - fail / 3);
+    }
+    else {
+        const slow = crawl.pages.filter((p) => p.ttfbMs > 800).length;
+        performance = clamp01(1 - slow / Math.max(1, crawl.pages.length));
+        performanceApplied = true;
+    }
+    const searchApplied = Boolean(opts?.hasGsc);
+    const search = searchApplied ? 0.5 : 0;
+    const aiBlocked = ids.has("ROBOTS.BLOCKS_AI_UNINTENDED");
+    const ai = aiBlocked ? 0.3 : 0.8;
+    const thin = findings.find((f) => f.ruleId === "THIN.LOW_WORDCOUNT")?.urls.length ?? 0;
+    const content = clamp01(1 - thin / n);
+    const raw = [
+        {
+            id: "indexability",
+            name: PILLARS[0].name,
+            weight: 0.25,
+            score: indexability,
+            applied: true,
+            note: null,
+        },
+        {
+            id: "onpage",
+            name: PILLARS[1].name,
+            weight: 0.2,
+            score: onpage,
+            applied: true,
+            note: null,
+        },
+        {
+            id: "structured",
+            name: PILLARS[2].name,
+            weight: 0.1,
+            score: structured,
+            applied: true,
+            note: null,
+        },
+        {
+            id: "linking",
+            name: PILLARS[3].name,
+            weight: 0.1,
+            score: linking,
+            applied: true,
+            note: null,
+        },
+        {
+            id: "performance",
+            name: PILLARS[4].name,
+            weight: 0.1,
+            score: performance,
+            applied: performanceApplied,
+            note: performanceNote,
+        },
+        {
+            id: "search",
+            name: PILLARS[5].name,
+            weight: 0.15,
+            score: search,
+            applied: searchApplied,
+            note: searchApplied ? null : "No GSC data; weight redistributed.",
+        },
+        {
+            id: "ai",
+            name: PILLARS[6].name,
+            weight: 0.05,
+            score: ai,
+            applied: true,
+            note: "AI-crawler robots.txt only (Phase 1).",
+        },
+        {
+            id: "content",
+            name: PILLARS[7].name,
+            weight: 0.05,
+            score: content,
+            applied: true,
+            note: null,
+        },
+    ];
+    const applied = raw.filter((p) => p.applied);
+    const weightSum = applied.reduce((s, p) => s + p.weight, 0) || 1;
+    const pillars = raw.map((p) => p.applied ? { ...p, weight: p.weight / weightSum } : { ...p, weight: 0 });
+    const value = Math.round(100 * pillars.filter((p) => p.applied).reduce((s, p) => s + p.weight * p.score, 0));
+    const partial = !searchApplied;
+    const provisional = crawl.pages.length < 50;
+    if (partial)
+        notes.push("Partial score: Search Console is not connected.");
+    if (provisional)
+        notes.push("Provisional: fewer than 50 URLs crawled.");
+    if (!opts?.hasCrux)
+        notes.push("Performance pillar uses crawl TTFB until CrUX is connected.");
+    return {
+        version: SITE_SCORE_VERSION,
+        value,
+        band: band(value),
+        pillars,
+        partial,
+        provisional,
+        notes,
+    };
+}
+function band(value) {
+    if (value <= 30)
+        return "Poor";
+    if (value <= 70)
+        return "Needs work";
+    if (value <= 90)
+        return "Good";
+    return "Excellent";
+}
+function clamp01(n) {
+    if (Number.isNaN(n))
+        return 0;
+    return Math.max(0, Math.min(1, n));
+}
+//# sourceMappingURL=score.js.map

package/dist/score.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,109 @@
+import type { CrawlResult } from "@agentsean/crawler";
+export type Severity = "critical" | "high" | "medium" | "low" | "insight";
+export type AutonomyTier = "T0" | "T1" | "T2" | "T3" | "T4";
+export type DetectScope = "url" | "site" | "template" | "resource" | "domain";
+export type CheckDefinition = {
+    id: string;
+    category: string;
+    name: string;
+    severity: Severity;
+    detectScope: DetectScope;
+    requires: readonly string[];
+    autonomyTier: AutonomyTier;
+    fixKind: string;
+    fixTemplate: string;
+    explanation: string;
+};
+export type FindingDraft = {
+    ruleId: string;
+    severity: Severity;
+    autonomyTier: AutonomyTier;
+    title: string;
+    explanation: string;
+    fixTemplate: string;
+    urls: string[];
+    evidence: unknown;
+    confidence: number;
+};
+export type PrioritizedFinding = FindingDraft & {
+    priority: number;
+    coverage: number;
+    indexability: number;
+    traffic: number;
+    effort: number;
+};
+export type GscData = {
+    clicksByUrl?: Record<string, number> | undefined;
+    impressionsByUrl?: Record<string, number> | undefined;
+    googleCanonicalByUrl?: Record<string, string> | undefined;
+    coverageStateByUrl?: Record<string, string> | undefined;
+    submittedSitemaps?: string[] | undefined;
+    sitemapErrors?: boolean | undefined;
+    lastDownloaded?: string | undefined;
+};
+export type CruxData = {
+    lcpP75Ms?: number | undefined;
+    inpP75Ms?: number | undefined;
+    clsP75?: number | undefined;
+    ttfbP75Ms?: number | undefined;
+    phoneLcpP75Ms?: number | undefined;
+    desktopLcpP75Ms?: number | undefined;
+    urlLevel?: boolean | undefined;
+};
+export type LighthouseData = {
+    version: string;
+    audits: Record<string, {
+        score: number | null;
+        id: string;
+    }>;
+};
+export type LogData = {
+    googlebotHitsByUrl?: Record<string, number> | undefined;
+    googlebotStatusMix?: Record<string, number> | undefined;
+    fakeBotHits?: number | undefined;
+};
+export type MigrationData = {
+    urlMap?: Record<string, string> | undefined;
+    oldOrigin?: string | undefined;
+    newOrigin?: string | undefined;
+};
+export type AuditContext = {
+    crawl: CrawlResult;
+    gsc?: GscData | undefined;
+    crux?: CruxData | undefined;
+    lighthouse?: LighthouseData | undefined;
+    logs?: LogData | undefined;
+    migration?: MigrationData | undefined;
+    previousRobotsHash?: string | undefined;
+    now?: Date | undefined;
+};
+export type PillarScore = {
+    id: string;
+    name: string;
+    weight: number;
+    score: number;
+    applied: boolean;
+    note: string | null;
+};
+export type SiteScore = {
+    version: string;
+    value: number;
+    band: "Poor" | "Needs work" | "Good" | "Excellent";
+    pillars: PillarScore[];
+    partial: boolean;
+    provisional: boolean;
+    notes: string[];
+};
+export type AuditReport = {
+    url: string;
+    origin: string;
+    pages: number;
+    elapsedMs: number;
+    score: SiteScore;
+    findings: PrioritizedFinding[];
+    formula: {
+        siteScore: string;
+        priority: string;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@agentsean/analyzers",
+  "version": "1.0.0",
+  "license": "AGPL-3.0-only",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dependencies": {
+    "@agentsean/crawler": "1.0.0",
+    "@agentsean/db": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seziro-team/agentsean.git",
+    "directory": "packages/analyzers"
+  },
+  "homepage": "https://github.com/seziro-team/agentsean#readme",
+  "bugs": {
+    "url": "https://github.com/seziro-team/agentsean/issues"
+  },
+  "author": "Seziro (https://seziro.com)",
+  "description": "Agent Sean — analyzers module",
+  "keywords": [
+    "seo",
+    "agent",
+    "agentsean",
+    "seo-automation"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/data','dist/data',{recursive:true})\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts"
+  }
+}