@answerable-kit/audit 0.1.0

package/dist/crawler.js

@@ -0,0 +1,66 @@
+import { AnswerableError, parseAbsoluteUrl } from '@answerable-kit/core';
+import { loadHtml } from './parser.js';
+export const DEFAULT_USER_AGENT = 'Answerable/0.0.0 (+https://github.com/Anuj7411/answerable)';
+export const DEFAULT_TIMEOUT_MS = 15_000;
+/**
+ * Thrown when the crawler can't reach the target URL or the response
+ * isn't a 2xx with HTML-shaped content.
+ */
+export class CrawlError extends AnswerableError {
+    url;
+    httpStatus;
+    constructor(message, options) {
+        super('ANSWERABLE_CRAWL_FAILED', message, { cause: options.cause });
+        this.url = options.url;
+        this.httpStatus = options.status;
+        this.name = 'CrawlError';
+    }
+}
+/**
+ * Fetch a URL and parse the response into a cheerio DOM. Follows
+ * redirects (delegated to native fetch). Sets a polite User-Agent.
+ * Throws `CrawlError` on network failure or non-2xx response.
+ *
+ * @throws InvalidUrlError if `url` is not a valid absolute http(s) URL.
+ * @throws CrawlError on network failure, timeout, or non-2xx response.
+ */
+export async function fetchAndParse(url, options = {}) {
+    const target = parseAbsoluteUrl(url);
+    const userAgent = options.userAgent ?? DEFAULT_USER_AGENT;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const controller = new AbortController();
+    const timeoutHandle = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+        response = await fetchImpl(target, {
+            headers: {
+                'User-Agent': userAgent,
+                Accept: 'text/html,application/xhtml+xml',
+            },
+            redirect: 'follow',
+            signal: controller.signal,
+        });
+    }
+    catch (cause) {
+        throw new CrawlError(`Failed to fetch ${target}`, { url: target, cause });
+    }
+    finally {
+        clearTimeout(timeoutHandle);
+    }
+    if (!response.ok) {
+        throw new CrawlError(`Request to ${target} returned HTTP ${response.status}`, {
+            url: target,
+            status: response.status,
+        });
+    }
+    const html = await response.text();
+    return {
+        url: target,
+        finalUrl: response.url || target,
+        status: response.status,
+        html,
+        dom: loadHtml(html),
+    };
+}
+//# sourceMappingURL=crawler.js.map

package/dist/crawler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.js","sourceRoot":"","sources":["../src/crawler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAiB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,4DAA4D,CAAC;AAE/F,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAiBzC;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,eAAe;IACpC,GAAG,CAAS;IACZ,UAAU,CAAqB;IAExC,YACE,OAAe,EACf,OAAqF;QAErF,KAAK,CAAC,yBAAyB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAE7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAEtE,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE;YACjC,OAAO,EAAE;gBACP,YAAY,EAAE,SAAS;gBACvB,MAAM,EAAE,iCAAiC;aAC1C;YACD,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,mBAAmB,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAAC,cAAc,MAAM,kBAAkB,QAAQ,CAAC,MAAM,EAAE,EAAE;YAC5E,GAAG,EAAE,MAAM;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO;QACL,GAAG,EAAE,MAAM;QACX,QAAQ,EAAE,QAAQ,CAAC,GAAG,IAAI,MAAM;QAChC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI;QACJ,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC;KACpB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @answerable-kit/audit — audit engine for the Answerable SEO toolkit.
+ * Fetches a target URL, parses HTML, runs every registered check in
+ * parallel, and returns a structured report. Ships with foundations
+ * + the first 5 checks (A1, A3, A4, A5, C1); the remaining 45 land
+ * in subsequent PRs.
+ */
+export declare const VERSION = "0.0.0";
+export { CrawlError, DEFAULT_TIMEOUT_MS, DEFAULT_USER_AGENT, fetchAndParse, type FetchAndParseOptions, type FetchAndParseResult, } from './crawler.js';
+export { type AuditDom, loadHtml } from './parser.js';
+export { DEFAULT_CHECKS } from './checks/registry.js';
+export { audit, bandFromScore, runChecks, type AuditConvenienceOptions, type RunChecksInput, } from './runner.js';
+export { consoleReport, type ConsoleReportOptions } from './reporters/console.js';
+export type { AuditOptions, AuditReport, CheckRunResult, ScoreBand } from './types.js';
+export { a1Title } from './checks/a1-title.js';
+export { a3Description } from './checks/a3-description.js';
+export { a4Canonical } from './checks/a4-canonical.js';
+export { a5HtmlLang } from './checks/a5-html-lang.js';
+export { a6Viewport } from './checks/a6-viewport.js';
+export { a7Charset } from './checks/a7-charset.js';
+export { a8Robots } from './checks/a8-robots.js';
+export { a9Favicon } from './checks/a9-favicon.js';
+export { a10AppleTouchIcon } from './checks/a10-apple-touch.js';
+export { b1SingleH1 } from './checks/b1-single-h1.js';
+export { b3HeadingHierarchy } from './checks/b3-heading-hierarchy.js';
+export { b4H2Sections } from './checks/b4-h2-sections.js';
+export { b8ExternalCitations } from './checks/b8-external-citations.js';
+export { b11InternalLinks } from './checks/b11-internal-links.js';
+export { b14ListsOrTables } from './checks/b14-lists-or-tables.js';
+export { c1JsonLd } from './checks/c1-json-ld.js';
+export { c2Organization } from './checks/c2-organization.js';
+export { d1AboutPageLinked } from './checks/d1-about-page-linked.js';
+export { d2PrivacyLinked } from './checks/d2-privacy-linked.js';
+export { d3TermsLinked } from './checks/d3-terms-linked.js';
+export { d4ContactAccessible } from './checks/d4-contact-accessible.js';
+export { d5ChromeTrustLink } from './checks/d5-chrome-trust-link.js';
+export { d6FooterTrustLinks } from './checks/d6-footer-trust-links.js';
+export { e1ReviewProfile } from './checks/e1-review-profile.js';
+export { e7GithubLinked } from './checks/e7-github-linked.js';
+export { e10SameAsThree } from './checks/e10-same-as-three.js';
+export { e11LinkedinLinked } from './checks/e11-linkedin-linked.js';
+export { f1OgTitle } from './checks/f1-og-title.js';
+export { f2OgDescription } from './checks/f2-og-description.js';
+export { f3OgImage } from './checks/f3-og-image.js';
+export { f5OgUrl } from './checks/f5-og-url.js';
+export { f6TwitterCard } from './checks/f6-twitter-card.js';
+export { f7TwitterImage } from './checks/f7-twitter-image.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,KAAK,EACL,aAAa,EACb,SAAS,EACT,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAElF,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,47 @@
+/**
+ * @answerable-kit/audit — audit engine for the Answerable SEO toolkit.
+ * Fetches a target URL, parses HTML, runs every registered check in
+ * parallel, and returns a structured report. Ships with foundations
+ * + the first 5 checks (A1, A3, A4, A5, C1); the remaining 45 land
+ * in subsequent PRs.
+ */
+export const VERSION = '0.0.0';
+export { CrawlError, DEFAULT_TIMEOUT_MS, DEFAULT_USER_AGENT, fetchAndParse, } from './crawler.js';
+export { loadHtml } from './parser.js';
+export { DEFAULT_CHECKS } from './checks/registry.js';
+export { audit, bandFromScore, runChecks, } from './runner.js';
+export { consoleReport } from './reporters/console.js';
+export { a1Title } from './checks/a1-title.js';
+export { a3Description } from './checks/a3-description.js';
+export { a4Canonical } from './checks/a4-canonical.js';
+export { a5HtmlLang } from './checks/a5-html-lang.js';
+export { a6Viewport } from './checks/a6-viewport.js';
+export { a7Charset } from './checks/a7-charset.js';
+export { a8Robots } from './checks/a8-robots.js';
+export { a9Favicon } from './checks/a9-favicon.js';
+export { a10AppleTouchIcon } from './checks/a10-apple-touch.js';
+export { b1SingleH1 } from './checks/b1-single-h1.js';
+export { b3HeadingHierarchy } from './checks/b3-heading-hierarchy.js';
+export { b4H2Sections } from './checks/b4-h2-sections.js';
+export { b8ExternalCitations } from './checks/b8-external-citations.js';
+export { b11InternalLinks } from './checks/b11-internal-links.js';
+export { b14ListsOrTables } from './checks/b14-lists-or-tables.js';
+export { c1JsonLd } from './checks/c1-json-ld.js';
+export { c2Organization } from './checks/c2-organization.js';
+export { d1AboutPageLinked } from './checks/d1-about-page-linked.js';
+export { d2PrivacyLinked } from './checks/d2-privacy-linked.js';
+export { d3TermsLinked } from './checks/d3-terms-linked.js';
+export { d4ContactAccessible } from './checks/d4-contact-accessible.js';
+export { d5ChromeTrustLink } from './checks/d5-chrome-trust-link.js';
+export { d6FooterTrustLinks } from './checks/d6-footer-trust-links.js';
+export { e1ReviewProfile } from './checks/e1-review-profile.js';
+export { e7GithubLinked } from './checks/e7-github-linked.js';
+export { e10SameAsThree } from './checks/e10-same-as-three.js';
+export { e11LinkedinLinked } from './checks/e11-linkedin-linked.js';
+export { f1OgTitle } from './checks/f1-og-title.js';
+export { f2OgDescription } from './checks/f2-og-description.js';
+export { f3OgImage } from './checks/f3-og-image.js';
+export { f5OgUrl } from './checks/f5-og-url.js';
+export { f6TwitterCard } from './checks/f6-twitter-card.js';
+export { f7TwitterImage } from './checks/f7-twitter-image.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GAGd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAiB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,KAAK,EACL,aAAa,EACb,SAAS,GAGV,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAA6B,MAAM,wBAAwB,CAAC;AAIlF,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,15 @@
+import { type CheerioAPI } from 'cheerio';
+/**
+ * Parser handle for every check. Re-exporting cheerio's `CheerioAPI`
+ * type means consumers of this package can write their own checks
+ * without depending on cheerio directly (they pick up the type from
+ * `@answerable-kit/audit`).
+ */
+export type AuditDom = CheerioAPI;
+/**
+ * Parse raw HTML into the DOM handle every check receives.
+ * Thin wrapper around `cheerio.load` so we can swap parsers later
+ * without touching every call site.
+ */
+export declare function loadHtml(html: string): AuditDom;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,SAAS,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE/C"}

package/dist/parser.js

@@ -0,0 +1,10 @@
+import { load } from 'cheerio';
+/**
+ * Parse raw HTML into the DOM handle every check receives.
+ * Thin wrapper around `cheerio.load` so we can swap parsers later
+ * without touching every call site.
+ */
+export function loadHtml(html) {
+    return load(html);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,IAAI,EAAE,MAAM,SAAS,CAAC;AAUhD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/reporters/console.d.ts

@@ -0,0 +1,12 @@
+import type { AuditReport } from '../types.js';
+export interface ConsoleReportOptions {
+    /** Suppress ANSI color escapes (for testing or non-TTY pipelines). */
+    readonly color?: boolean;
+}
+/**
+ * Render an `AuditReport` as a human-readable, terminal-friendly string.
+ * Groups failures by severity descending, then lists every passing
+ * check at the bottom for confidence.
+ */
+export declare function consoleReport(report: AuditReport, options?: ConsoleReportOptions): string;
+//# sourceMappingURL=console.d.ts.map

package/dist/reporters/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/reporters/console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAC;AAmB1E,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAmD7F"}

package/dist/reporters/console.js

@@ -0,0 +1,110 @@
+import kleur from 'kleur';
+const SEVERITY_ORDER = ['critical', 'high', 'medium', 'low'];
+const SEVERITY_LABEL = {
+    critical: 'CRITICAL',
+    high: 'HIGH',
+    medium: 'MEDIUM',
+    low: 'LOW',
+};
+const BAND_LABEL = {
+    critical: 'Critical',
+    weak: 'Weak',
+    average: 'Average',
+    strong: 'Strong',
+    excellent: 'Excellent',
+};
+/**
+ * Render an `AuditReport` as a human-readable, terminal-friendly string.
+ * Groups failures by severity descending, then lists every passing
+ * check at the bottom for confidence.
+ */
+export function consoleReport(report, options = {}) {
+    const enableColor = options.color ?? true;
+    const c = enableColor ? kleur : disableKleur();
+    const failures = report.results.filter((r) => r.status === 'fail' || r.status === 'warn');
+    const skips = report.results.filter((r) => r.status === 'skip');
+    const passes = report.results.filter((r) => r.status === 'pass');
+    const lines = [];
+    lines.push(c.bold(`Audit · ${report.url}`));
+    lines.push(`Fetched ${report.fetchedAt}`);
+    lines.push('');
+    lines.push(`${c.bold('Score:')} ${scoreColor(c, report.score)(`${report.score}/100`)} ${c.dim(`(${BAND_LABEL[report.band]})`)}`);
+    lines.push(c.dim(`${report.summary.pass} pass · ${report.summary.fail} fail · ${report.summary.warn} warn · ${report.summary.skip} skip`));
+    // Failures + warnings grouped by severity.
+    for (const sev of SEVERITY_ORDER) {
+        const inGroup = failures.filter((r) => r.severity === sev);
+        if (inGroup.length === 0)
+            continue;
+        lines.push('');
+        lines.push(c.bold(severityColor(c, sev)(`[${SEVERITY_LABEL[sev]}] ${inGroup.length} issue(s)`)));
+        for (const r of inGroup) {
+            lines.push(...formatFinding(c, r));
+        }
+    }
+    if (skips.length > 0) {
+        lines.push('');
+        lines.push(c.bold(c.gray(`[SKIPPED] ${skips.length}`)));
+        for (const r of skips) {
+            lines.push(c.gray(`  ${r.id} · ${r.description}${r.error ? ` — ${r.error}` : ''}`));
+        }
+    }
+    if (passes.length > 0) {
+        lines.push('');
+        lines.push(c.bold(c.green(`[PASSED] ${passes.length}`)));
+        for (const r of passes) {
+            lines.push(c.dim(`  ${r.id} · ${r.description}`));
+        }
+    }
+    return lines.join('\n');
+}
+function formatFinding(c, r) {
+    const lines = [`  ${c.bold(r.id)} · ${r.description}`];
+    if (r.evidence !== undefined) {
+        lines.push(c.dim(`     ${truncate(r.evidence, 200)}`));
+    }
+    if (r.fixRecommendation !== undefined) {
+        lines.push(`     ${c.cyan('Fix:')} ${truncate(r.fixRecommendation, 200)}`);
+    }
+    lines.push(c.dim(`     ${r.docsUrl}`));
+    return lines;
+}
+function severityColor(c, severity) {
+    switch (severity) {
+        case 'critical':
+            return c.red;
+        case 'high':
+            return c.yellow;
+        case 'medium':
+            return c.blue;
+        case 'low':
+            return c.gray;
+    }
+}
+function scoreColor(c, score) {
+    if (score >= 81)
+        return c.green;
+    if (score >= 61)
+        return c.yellow;
+    if (score >= 41)
+        return c.magenta;
+    return c.red;
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return `${s.slice(0, max - 1)}…`;
+}
+/**
+ * Returns a no-op shim with the same shape as kleur so we can pass it
+ * through the formatter when color is disabled.
+ */
+function disableKleur() {
+    const identity = (s) => String(s);
+    const colors = ['red', 'yellow', 'blue', 'gray', 'green', 'magenta', 'cyan', 'bold', 'dim'];
+    const shim = identity;
+    for (const name of colors) {
+        shim[name] = identity;
+    }
+    return shim;
+}
+//# sourceMappingURL=console.js.map

package/dist/reporters/console.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,35 @@
+import type { AbsoluteUrl, Check } from '@answerable-kit/core';
+import { type FetchAndParseOptions } from './crawler.js';
+import { type AuditDom } from './parser.js';
+import type { AuditReport, ScoreBand } from './types.js';
+export interface RunChecksInput {
+    readonly url: AbsoluteUrl;
+    readonly html: string;
+    readonly dom: AuditDom;
+    /** Override the default check set. Defaults to every registered check. */
+    readonly checks?: readonly Check<AuditDom>[];
+}
+/**
+ * Pure runner: takes pre-parsed input and returns the report.
+ * No network. Tests use this exclusively so CI never hits live URLs.
+ *
+ * Each check runs in parallel via `Promise.all`. A thrown check is
+ * captured and recorded as a `skip` with the error message — the
+ * audit always completes.
+ */
+export declare function runChecks(input: RunChecksInput): Promise<AuditReport>;
+/**
+ * Map an integer score to its AUDIT-FRAMEWORK band.
+ * 0-40 critical · 41-60 weak · 61-80 average · 81-90 strong · 91-100 excellent
+ */
+export declare function bandFromScore(score: number): ScoreBand;
+export interface AuditConvenienceOptions extends FetchAndParseOptions {
+    readonly checks?: readonly Check<AuditDom>[];
+}
+/**
+ * Convenience wrapper: fetches the target URL and runs the audit.
+ * Real-world callers use this; tests use `runChecks` directly with
+ * fixture HTML.
+ */
+export declare function audit(url: string, options?: AuditConvenienceOptions): Promise<AuditReport>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAe,MAAM,sBAAsB,CAAC;AAG5E,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAkB,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CA2C3E;AAuCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAMtD;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,WAAW,CAAC,CAUtB"}

package/dist/runner.js

@@ -0,0 +1,120 @@
+import { parseAbsoluteUrl } from '@answerable-kit/core';
+import { DEFAULT_CHECKS } from './checks/registry.js';
+import { fetchAndParse } from './crawler.js';
+import { loadHtml } from './parser.js';
+/**
+ * Pure runner: takes pre-parsed input and returns the report.
+ * No network. Tests use this exclusively so CI never hits live URLs.
+ *
+ * Each check runs in parallel via `Promise.all`. A thrown check is
+ * captured and recorded as a `skip` with the error message — the
+ * audit always completes.
+ */
+export async function runChecks(input) {
+    const checks = input.checks ?? DEFAULT_CHECKS;
+    const fetchedAt = new Date().toISOString();
+    const results = await Promise.all(checks.map(async (check) => {
+        try {
+            const result = await check.run({ url: input.url, html: input.html, dom: input.dom });
+            return buildResult(check, result);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                id: check.id,
+                category: check.category,
+                severity: check.severity,
+                description: check.description,
+                maxPoints: check.points,
+                earnedPoints: 0,
+                status: 'skip',
+                docsUrl: check.docsUrl,
+                error: message,
+            };
+        }
+    }));
+    const summary = {
+        pass: results.filter((r) => r.status === 'pass').length,
+        fail: results.filter((r) => r.status === 'fail').length,
+        warn: results.filter((r) => r.status === 'warn').length,
+        skip: results.filter((r) => r.status === 'skip').length,
+    };
+    const score = computeScore(results);
+    return {
+        url: input.url,
+        fetchedAt,
+        results,
+        score,
+        band: bandFromScore(score),
+        summary,
+    };
+}
+function buildResult(check, result) {
+    const earnedPoints = result.status === 'pass' ? check.points : 0;
+    const out = {
+        id: check.id,
+        category: check.category,
+        severity: check.severity,
+        description: check.description,
+        maxPoints: check.points,
+        earnedPoints,
+        status: result.status,
+        docsUrl: check.docsUrl,
+    };
+    return result.evidence !== undefined || result.fixRecommendation !== undefined
+        ? {
+            ...out,
+            ...(result.evidence !== undefined && { evidence: result.evidence }),
+            ...(result.fixRecommendation !== undefined && {
+                fixRecommendation: result.fixRecommendation,
+            }),
+        }
+        : out;
+}
+/**
+ * Compute the integer score against the *checks that actually ran*
+ * (excluding skips). Lets category-filtered audits score on their
+ * own denominator rather than always against 100.
+ */
+function computeScore(results) {
+    const consideredResults = results.filter((r) => r.status !== 'skip');
+    if (consideredResults.length === 0)
+        return 0;
+    const maxPossible = consideredResults.reduce((sum, r) => sum + r.maxPoints, 0);
+    if (maxPossible === 0)
+        return 0;
+    const earned = consideredResults.reduce((sum, r) => sum + r.earnedPoints, 0);
+    return Math.round((earned / maxPossible) * 100);
+}
+/**
+ * Map an integer score to its AUDIT-FRAMEWORK band.
+ * 0-40 critical · 41-60 weak · 61-80 average · 81-90 strong · 91-100 excellent
+ */
+export function bandFromScore(score) {
+    if (score <= 40)
+        return 'critical';
+    if (score <= 60)
+        return 'weak';
+    if (score <= 80)
+        return 'average';
+    if (score <= 90)
+        return 'strong';
+    return 'excellent';
+}
+/**
+ * Convenience wrapper: fetches the target URL and runs the audit.
+ * Real-world callers use this; tests use `runChecks` directly with
+ * fixture HTML.
+ */
+export async function audit(url, options = {}) {
+    const parsed = parseAbsoluteUrl(url);
+    const fetched = await fetchAndParse(parsed, options);
+    const dom = fetched.dom ?? loadHtml(fetched.html);
+    return runChecks({
+        url: parsed,
+        html: fetched.html,
+        dom,
+        ...(options.checks !== undefined && { checks: options.checks }),
+    });
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+import type { AbsoluteUrl, Category, Severity } from '@answerable-kit/core';
+/**
+ * Outcome of a single check after the runner has resolved any errors
+ * and attached the check's static metadata.
+ */
+export interface CheckRunResult {
+    readonly id: string;
+    readonly category: Category;
+    readonly severity: Severity;
+    readonly description: string;
+    /** Max points this check is worth toward the 100-point total. */
+    readonly maxPoints: number;
+    /** Points actually earned (full on `pass`, otherwise 0). */
+    readonly earnedPoints: number;
+    readonly status: 'pass' | 'fail' | 'warn' | 'skip';
+    readonly evidence?: string | undefined;
+    readonly fixRecommendation?: string | undefined;
+    readonly docsUrl: string;
+    /** Populated when the check itself threw — the runner caught it. */
+    readonly error?: string | undefined;
+}
+export type ScoreBand = 'critical' | 'weak' | 'average' | 'strong' | 'excellent';
+/**
+ * Final audit report consumed by reporters and CI integrations.
+ *
+ * `score` is computed against the sum of `maxPoints` for the *checks
+ * that ran* — so partial-suite runs (e.g. category filters) score on
+ * their own denominator rather than always against 100.
+ */
+export interface AuditReport {
+    readonly url: AbsoluteUrl;
+    readonly fetchedAt: string;
+    readonly results: readonly CheckRunResult[];
+    /** 0–100. Integer, rounded. */
+    readonly score: number;
+    readonly band: ScoreBand;
+    readonly summary: {
+        readonly pass: number;
+        readonly fail: number;
+        readonly warn: number;
+        readonly skip: number;
+    };
+}
+export interface AuditOptions {
+    /** Override the default check registry (e.g. category subsets). */
+    readonly checks?: readonly never[];
+    /** Override the default User-Agent header. Rarely useful. */
+    readonly userAgent?: string;
+    /** Hard timeout in milliseconds for the initial fetch. */
+    readonly timeoutMs?: number;
+}
+//# 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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

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,48 @@
+{
+  "name": "@answerable-kit/audit",
+  "version": "0.1.0",
+  "description": "Audit engine for the Answerable SEO toolkit. Crawls a target URL, runs the 50-check framework, and reports findings with evidence + fix recommendations.",
+  "license": "MIT",
+  "author": "Anuj Ojha",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Anuj7411/answerable.git",
+    "directory": "packages/audit"
+  },
+  "homepage": "https://github.com/Anuj7411/answerable/tree/main/packages/audit#readme",
+  "bugs": "https://github.com/Anuj7411/answerable/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist .tsbuildinfo"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@answerable-kit/core": "workspace:*",
+    "cheerio": "^1.0.0",
+    "kleur": "^4.1.5"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}