@reddoorla/maintenance 0.85.2 → 0.87.0

package/dist/prospect/types.d.ts

@@ -0,0 +1,267 @@
+import { a as AuditResult } from '../types-OIQZ5hWN.js';
+
+/** Every pipeline stage resolves to this. A failed stage degrades its report
+ *  section to "not measured" — it never kills the run (spec: error handling). */
+type StageResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+};
+type RobotsAgentAccess = {
+    agent: string;
+    /** May this agent fetch "/" per robots.txt? (No robots.txt → allowed.) */
+    allowed: boolean;
+    /** The deciding rule, e.g. "User-agent: GPTBot → Disallow: /". Null = no rule matched. */
+    matchedRule: string | null;
+};
+type PageExtract = {
+    title: string | null;
+    metaDescription: string | null;
+    canonical: string | null;
+    /** property/name → content for og:* and twitter:* metas. */
+    social: Record<string, string>;
+    /** `level` is 1-6 (H1-H6). */
+    headings: {
+        level: number;
+        text: string;
+    }[];
+    /** Raw text of each <script type="application/ld+json"> block. */
+    jsonLd: string[];
+    images: {
+        total: number;
+        withAlt: number;
+    };
+    hasViewportMeta: boolean;
+    /** Visible text, whitespace-collapsed. */
+    text: string;
+};
+type PageCapture = {
+    url: string;
+    /** HTTP status of the raw fetch. Null = the fetch itself failed. */
+    status: number | null;
+    /** Extract of the raw HTTP HTML (what non-JS crawlers see). */
+    raw: PageExtract | null;
+    /** Extract of the Playwright-rendered DOM (what a browser sees). */
+    rendered: PageExtract | null;
+    error: string | null;
+};
+type CrawlResult = {
+    /** Normalized origin, e.g. "https://example.com". */
+    origin: string;
+    robotsTxt: string | null;
+    /** One entry per agent in crawl.ts's ALL_AGENTS (6 AI + 2 classical). */
+    agentAccess: RobotsAgentAccess[];
+    sitemap: {
+        present: boolean;
+        urlCount: number;
+    };
+    llmsTxt: {
+        present: boolean;
+        firstLine: string | null;
+    };
+    /** Per sidecar, the error that stopped us fetching it, or null. A fetch that
+     *  FAILED must never be reported as "the site has no robots.txt" — that would
+     *  claim the crawlers are unrestricted when we simply did not look. */
+    sidecarErrors: {
+        robots: string | null;
+        llms: string | null;
+        sitemap: string | null;
+    };
+    /** Lower-cased homepage response headers (security-header check input). */
+    homeHeaders: Record<string, string>;
+    pages: PageCapture[];
+};
+type ChecksResult = {
+    /** False when the robots.txt fetch itself failed, so "no AI crawler is
+     *  blocked" would be our silence rather than the site's answer. The report
+     *  must say "not measured" for crawler access when this is false. */
+    crawlerAccessMeasured: boolean;
+    crawlerAccess: {
+        blockedAi: string[];
+        allowedAi: string[];
+        blockedClassical: string[];
+    };
+    jsDependence: {
+        /** 0..1 — fraction of rendered words absent from the raw HTML, weighted by
+         *  page size (total missing words / total rendered words across every
+         *  comparable page) — or null when no page produced a comparable pair.
+         *  Never 0 for "nothing measured": a page whose raw fetch was blocked, or
+         *  whose rendered text tokenizes to nothing, drops out of the average
+         *  rather than forcing it toward a false "perfectly crawlable". */
+        avgMissing: number | null;
+        perPage: {
+            url: string;
+            /** 0..1 — this page's own missing fraction (unweighted). */
+            missing: number;
+            /** Token count wordSet(rendered.text) produced for this page — the
+             *  weight avgMissing gives it, and why a "coming soon" stub can't swing
+             *  the headline number the way a full page does. */
+            renderedWords: number;
+        }[];
+    };
+    schema: {
+        typesFound: string[];
+        missingExpected: string[];
+        invalidBlocks: number;
+    };
+    meta: {
+        pageCount: number;
+        missingTitle: number;
+        missingDescription: number;
+        missingCanonical: number;
+        missingSocial: number;
+        /** Pages where neither the raw nor the rendered fetch produced an extract
+         *  — excluded from pageCount and every other meta denominator above, so a
+         *  report reading "1 of 2 pages missing a description" doesn't silently
+         *  hide the third page that produced nothing at all. */
+        pagesWithoutExtract: number;
+    };
+    headings: {
+        pagesWithoutH1: number;
+        pagesWithLevelSkips: number;
+    };
+    securityHeaders: {
+        present: string[];
+        missing: string[];
+    };
+    /** False when the sitemap.xml fetch itself failed (crawl.sidecarErrors.sitemap
+     *  !== null), so `sitemapPresent: false` would otherwise read as "confirmed
+     *  absent" rather than "we never got an answer". The report must say "not
+     *  measured" for sitemap presence when this is false, and computeScores must
+     *  treat it as neutral rather than penalizing the technical component for a
+     *  fetch we could not complete. */
+    sitemapMeasured: boolean;
+    sitemapPresent: boolean;
+    /** Same as sitemapMeasured, for the llms.txt fetch (crawl.sidecarErrors.llms). */
+    llmsTxtMeasured: boolean;
+    llmsTxtPresent: boolean;
+    viewportOk: boolean;
+};
+type BuyerQuestion = {
+    question: string;
+    answered: "yes" | "partial" | "no";
+    /** Is there a passage an AI answer could quote verbatim? */
+    quotable: boolean;
+    page: string | null;
+    evidence: string | null;
+};
+type Fix = {
+    title: string;
+    why: string;
+    impact: "high" | "medium" | "low";
+    effort: "low" | "medium" | "high";
+    tier: "crawl" | "content" | "technical";
+};
+type AnalyzeResult = {
+    /** The business's proper name, as a searchable proper noun — "Acme Roofing",
+     *  not a description of it. Empty string when the site never states one,
+     *  which is itself a finding. This is what the visibility probes query and
+     *  brand-match against; `business` below is prose and unsearchable. */
+    businessName: string;
+    /** The model's read of what this company does, for whom, where. */
+    business: string;
+    entityClarity: {
+        score: number;
+        missing: string[];
+    };
+    buyerQuestions: BuyerQuestion[];
+    /** Standalone searches for the visibility probes — what a buyer types before
+     *  they know this company exists. Distinct from `buyerQuestions`, which are
+     *  phrased about this site and are unanswerable on their own; see the schema
+     *  comment in analyze.ts for what that cost us. Never mentions the business. */
+    categoryQueries: string[];
+    fixes: Fix[];
+    narrative: {
+        findability: string;
+        readability: string;
+        answers: string;
+    };
+};
+type ProbeAnswer = {
+    engine: string;
+    query: string;
+    /** "branded" ("who is X" / "X reviews") always echoes the name back even when
+     *  an engine knows nothing real, so it cannot be trusted as a discoverability
+     *  signal. "category" is a real buyer question — the one the score is built
+     *  from. "competitor" is a head-to-head comparison query. */
+    kind: "branded" | "category" | "competitor";
+    domainCited: boolean;
+    brandMentioned: boolean;
+    citedDomains: string[];
+    /** First ~300 chars of the engine's answer — the report's receipt. */
+    snippet: string;
+    /** True when `snippet` is a truncated prefix of a longer answer — set
+     *  right where the truncation happens (probes.ts's SNIPPET_CHARS), so the
+     *  renderer never has to re-derive "was this cut short?" from a length
+     *  check of its own against a constant it can't see. */
+    truncated: boolean;
+    /** ISO-8601, set when the answer came back — this stage's whole output is
+     *  quotable claims about a live third party, and answer engines' answers
+     *  drift, so a disputed line in a report needs a date attached. */
+    askedAt: string;
+};
+type ProbesResult = {
+    answers: ProbeAnswer[];
+    /** 0..100 — fraction of CATEGORY answers (real buyer questions) where the
+     *  prospect was cited or mentioned. Null — never 0 — when no category query
+     *  ran at all, e.g. the analyze stage failed and supplied no buyer questions.
+     *  Deliberately excludes branded answers: "who is X"/"X reviews" echo the name
+     *  back even when the engine knows nothing real, which would put a floor
+     *  under the score that has nothing to do with discoverability. */
+    visibilityScore: number | null;
+    /** Did any branded query produce a real citation of the prospect's own
+     *  domain — not merely an echo of the name in prose. Reported separately from
+     *  visibilityScore because it answers a different question ("does the engine
+     *  know this business exists at all") from the one the score answers ("would
+     *  it surface this business to someone who didn't already name it"). */
+    brandedRecognized: boolean;
+    competitorsSeen: {
+        domain: string;
+        count: number;
+    }[];
+};
+type LighthouseScores = {
+    performance: number | null;
+    accessibility: number | null;
+    bestPractices: number | null;
+    seo: number | null;
+    summary: string;
+    status: AuditResult["status"];
+};
+type Scores = {
+    findability: number | null;
+    readability: number | null;
+    answers: number | null;
+    aiVisibility: number | null;
+};
+type ProspectAuditResult = {
+    url: string;
+    /** The resolved searchable proper NOUN — "Acme Roofing", not a description
+     *  of it (mirrors `AnalyzeResult.businessName`, the value this is usually
+     *  copied from). Distinct from `AnalyzeResult.business` (prose, nested
+     *  under `analyze.data`) — the two share a root name only because they're
+     *  one level apart, not because they hold the same kind of value. Null
+     *  when no name was ever resolved (operator override empty, model returned
+     *  none) — itself a finding, not an error. Persisted verbatim into the
+     *  database's `business` COLUMN (kept as-is; a rename there would need its
+     *  own migration for no benefit) — map at that one boundary, not here. */
+    businessName: string | null;
+    generatedAt: string;
+    scores: Scores;
+    /** The crawl is the one fatal stage (see pipeline.ts): a crawl failure
+     *  throws before a ProspectAuditResult is ever built, so the `ok:false`
+     *  branch of StageResult can never appear here. Narrowed to the success
+     *  shape only, so consumers never handle the impossible branch. */
+    crawl: {
+        ok: true;
+        data: CrawlResult;
+    };
+    checks: StageResult<ChecksResult>;
+    lighthouse: StageResult<LighthouseScores>;
+    analyze: StageResult<AnalyzeResult>;
+    probes: StageResult<ProbesResult>;
+};
+
+export type { AnalyzeResult, BuyerQuestion, ChecksResult, CrawlResult, Fix, LighthouseScores, PageCapture, PageExtract, ProbeAnswer, ProbesResult, ProspectAuditResult, RobotsAgentAccess, Scores, StageResult };

package/dist/prospect/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/prospect/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/prospect-audit-KSXUNQ5J.js

@@ -0,0 +1,174 @@
+import {
+  hostnameOf,
+  isHttpUrl
+} from "./chunk-EVBCK2KC.js";
+
+// src/cli/commands/prospect-audit.ts
+import { mkdir, writeFile } from "fs/promises";
+import { resolve } from "path";
+
+// src/dashboard/handler-helpers.ts
+var DEFAULT_DASHBOARD_BASE_URL = "https://reddoor-maintenance.netlify.app";
+function resolveDashboardBaseUrl(raw) {
+  return (raw?.trim() || DEFAULT_DASHBOARD_BASE_URL).replace(/\/$/, "");
+}
+
+// src/cli/commands/prospect-audit.ts
+function fail(message) {
+  return { output: message, code: 2 };
+}
+function errorMessage(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+function scoreLine(label, value) {
+  return `${label.padEnd(14)} ${value === null ? "not measured" : String(value).padStart(3)}`;
+}
+function auditStatus(result) {
+  const allStagesOk = result.checks.ok && result.lighthouse.ok && result.analyze.ok && result.probes.ok;
+  return allStagesOk ? "complete" : "partial";
+}
+function slugify(s) {
+  const slug = s.toLowerCase().replace(/[^a-z0-9.-]+/g, "-").replace(/^-+|-+$/g, "");
+  return slug || "prospect";
+}
+async function writeRecoveryFiles(result, html) {
+  const dir = resolve("reports");
+  await mkdir(dir, { recursive: true });
+  const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const base = `prospect-audit-${slugify(hostnameOf(result.url))}-${stamp}`;
+  const htmlPath = resolve(dir, `${base}.html`);
+  const jsonPath = resolve(dir, `${base}.json`);
+  await writeFile(htmlPath, html, "utf-8");
+  await writeFile(jsonPath, JSON.stringify(result, null, 2), "utf-8");
+  return { htmlPath, jsonPath };
+}
+function summarize(result, link, file, warnings, recovery, email) {
+  const lines = [
+    `Prospect audit \u2014 ${result.businessName ?? result.url}`,
+    "",
+    scoreLine("Findability", result.scores.findability),
+    scoreLine("Readability", result.scores.readability),
+    scoreLine("Answers", result.scores.answers),
+    scoreLine("AI Visibility", result.scores.aiVisibility)
+  ];
+  for (const [name, stage] of [
+    ["checks", result.checks],
+    ["lighthouse", result.lighthouse],
+    ["analyze", result.analyze],
+    ["probes", result.probes]
+  ]) {
+    if (!stage.ok) lines.push(`  ! ${name} not measured \u2014 ${stage.error}`);
+  }
+  if (file) lines.push("", `Report written to ${file}`);
+  if (link) lines.push("", `Shareable link: ${link}`);
+  if (email?.sent) {
+    lines.push("", `Emailed to ${email.recipients.join(", ")} (${email.messageId})`);
+  }
+  for (const w of warnings) lines.push("", `! ${w}`);
+  if (recovery) {
+    lines.push(
+      "",
+      "Neither --out nor the database took this report \u2014 wrote a recovery copy instead:",
+      `  ${recovery.htmlPath}`,
+      `  ${recovery.jsonPath}`
+    );
+  }
+  return lines.join("\n");
+}
+async function runProspectAuditCommand(url, opts) {
+  if (!isHttpUrl(url)) {
+    return fail(`"${url}" is not a URL. Pass the full address, e.g. https://example.com`);
+  }
+  const canPersist = Boolean(process.env.TURSO_DATABASE_URL);
+  if (!canPersist && !opts.out) {
+    return fail(
+      "No TURSO_DATABASE_URL, so the report cannot be saved or shared. Re-run with --out <file>, or set the Turso credentials."
+    );
+  }
+  const { runProspectAudit } = await import("./pipeline-3AANZFCR.js");
+  const onStage = (name, status, detail) => {
+    if (status === "start") console.error(`\u2026 ${name}`);
+    else if (status === "ok") console.error(`\u2713 ${name}`);
+    else console.error(`! ${name} \u2014 ${detail ?? "failed"}`);
+  };
+  const business = opts.business?.trim();
+  const result = await runProspectAudit(
+    url,
+    {
+      ...business ? { business } : {},
+      ...opts.competitors ? {
+        competitors: opts.competitors.split(",").map((c) => c.trim()).filter(Boolean)
+      } : {},
+      ...opts.probes === false ? { probes: false } : {}
+    },
+    { ...opts.deps ?? {}, onStage }
+  );
+  const { renderProspectReport } = await import("./render-IFOGFB5T.js");
+  const html = renderProspectReport(result);
+  const warnings = [];
+  let file = null;
+  if (opts.out) {
+    try {
+      await writeFile(opts.out, html, "utf-8");
+      file = opts.out;
+    } catch (err) {
+      warnings.push(`Could not write --out (${opts.out}): ${errorMessage(err)}`);
+    }
+  }
+  let link = null;
+  let token = null;
+  let auditId = null;
+  if (canPersist) {
+    try {
+      const { openDb, readDbConfig } = await import("./client-AUE3XUPO.js");
+      const { createProspectAudit } = await import("./prospect-audits-3PMIO73D.js");
+      const db = await openDb(readDbConfig());
+      const created = await createProspectAudit(db, {
+        url: result.url,
+        // Map at the boundary: ProspectAuditResult.businessName is the field
+        // name (Item 2 — it's a resolved NAME, not a description); the
+        // `prospect_audits.business` column keeps its existing name, since
+        // renaming a column needs its own migration for no benefit here.
+        business: result.businessName,
+        status: auditStatus(result),
+        resultJson: JSON.stringify(result)
+      });
+      auditId = created.id;
+      token = created.token;
+      link = `${resolveDashboardBaseUrl(process.env.DASHBOARD_BASE_URL)}/r/${token}`;
+    } catch (err) {
+      warnings.push(`Could not save to the database: ${errorMessage(err)}`);
+    }
+  }
+  const delivered = file !== null || link !== null;
+  const recovery = delivered ? null : await writeRecoveryFiles(result, html);
+  const code = delivered ? 0 : 1;
+  let email = null;
+  if (opts.email) {
+    try {
+      const { sendAuditEmail, parseProspectAuditRecipients } = await import("./email-KJXASVH5.js");
+      const recipients = parseProspectAuditRecipients(process.env.PROSPECT_AUDIT_RECIPIENTS);
+      email = await sendAuditEmail(result, { link, recipients, auditId });
+      if (!email.sent) {
+        warnings.push(`Could not email the audit sheet: ${email.reason}`);
+      }
+    } catch (err) {
+      warnings.push(`Could not email the audit sheet: ${errorMessage(err)}`);
+    }
+  }
+  if (opts.json) {
+    return {
+      output: JSON.stringify(
+        { result, out: file, link, token, recovery, warnings, email },
+        null,
+        2
+      ),
+      code
+    };
+  }
+  return { output: summarize(result, link, file, warnings, recovery, email), code };
+}
+export {
+  runProspectAuditCommand
+};
+//# sourceMappingURL=prospect-audit-KSXUNQ5J.js.map

package/dist/prospect-audit-KSXUNQ5J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/prospect-audit.ts","../src/dashboard/handler-helpers.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { hostnameOf, isHttpUrl } from \"../../util/url.js\";\nimport { resolveDashboardBaseUrl } from \"../../dashboard/handler-helpers.js\";\nimport type { ProspectAuditStatus } from \"../../db/prospect-audits.js\";\nimport type { PipelineDeps, StageName } from \"../../prospect/pipeline.js\";\nimport type { ProspectAuditResult } from \"../../prospect/types.js\";\nimport type { SendAuditEmailResult } from \"../../prospect/email.js\";\n\nexport type ProspectAuditCliOptions = {\n  business?: string;\n  /** Comma-separated competitor domains. */\n  competitors?: string;\n  /** cac sets this false for `--no-probes`. */\n  probes?: boolean;\n  out?: string;\n  json?: boolean;\n  /**\n   * Email the internal sheet (scores, what wasn't measured and why, top\n   * fixes, and the shareable link) to `PROSPECT_AUDIT_RECIPIENTS`, once the\n   * report is rendered and the `--out`/Turso delivery attempts finish. A\n   * missing/empty recipients var, or a Resend failure, is a warning — never a\n   * crash — because by the time this runs the audit is already delivered (or\n   * recovered) by the code above it.\n   */\n  email?: boolean;\n  /** Test seam: injected pipeline deps. Never set from the CLI. */\n  deps?: PipelineDeps;\n};\n\ntype RecoveryWrite = { htmlPath: string; jsonPath: string };\n\nfunction fail(message: string): { output: string; code: number } {\n  return { output: message, code: 2 };\n}\n\nfunction errorMessage(err: unknown): string {\n  return err instanceof Error ? err.message : String(err);\n}\n\nfunction scoreLine(label: string, value: number | null): string {\n  return `${label.padEnd(14)} ${value === null ? \"not measured\" : String(value).padStart(3)}`;\n}\n\n/** Item 3: the `status` column exists to answer, without deserializing the\n *  whole result_json, whether this was a clean run or a degraded one. crawl\n *  is excluded — it's the one fatal stage (see pipeline.ts), so by the time a\n *  ProspectAuditResult exists it was always ok. Every other stage's\n *  StageResult already collapses \"failed\" and \"deliberately skipped\"\n *  (--no-probes, the checks→analyze cascade) into the same `ok: false` — both\n *  mean the report has a \"not measured\" section, so both count as partial\n *  here too. */\nfunction auditStatus(result: ProspectAuditResult): ProspectAuditStatus {\n  const allStagesOk =\n    result.checks.ok && result.lighthouse.ok && result.analyze.ok && result.probes.ok;\n  return allStagesOk ? \"complete\" : \"partial\";\n}\n\n/** Filesystem-safe, never empty. Collapses anything outside [a-z0-9.-] to a\n *  single dash so a hostname becomes a sane filename fragment. */\nfunction slugify(s: string): string {\n  const slug = s\n    .toLowerCase()\n    .replace(/[^a-z0-9.-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return slug || \"prospect\";\n}\n\n/**\n * Last-resort write when NEITHER `--out` nor the database persist made it —\n * the one situation a paid, already-run audit must never end in silently. Lands\n * in `reports/`, mirroring header-image.ts's own convention for CLI-written\n * artifacts (mkdir -p, resolved against cwd), rather than a bare file dropped\n * into whatever directory the operator happened to be standing in when they\n * ran the command — often unrelated to this repo at all in fleet-tool usage.\n */\nasync function writeRecoveryFiles(\n  result: ProspectAuditResult,\n  html: string,\n): Promise<RecoveryWrite> {\n  const dir = resolve(\"reports\");\n  await mkdir(dir, { recursive: true });\n  const stamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const base = `prospect-audit-${slugify(hostnameOf(result.url))}-${stamp}`;\n  const htmlPath = resolve(dir, `${base}.html`);\n  const jsonPath = resolve(dir, `${base}.json`);\n  await writeFile(htmlPath, html, \"utf-8\");\n  await writeFile(jsonPath, JSON.stringify(result, null, 2), \"utf-8\");\n  return { htmlPath, jsonPath };\n}\n\nfunction summarize(\n  result: ProspectAuditResult,\n  link: string | null,\n  file: string | null,\n  warnings: string[],\n  recovery: RecoveryWrite | null,\n  email: SendAuditEmailResult | null,\n): string {\n  const lines = [\n    `Prospect audit — ${result.businessName ?? result.url}`,\n    \"\",\n    scoreLine(\"Findability\", result.scores.findability),\n    scoreLine(\"Readability\", result.scores.readability),\n    scoreLine(\"Answers\", result.scores.answers),\n    scoreLine(\"AI Visibility\", result.scores.aiVisibility),\n  ];\n  for (const [name, stage] of [\n    [\"checks\", result.checks],\n    [\"lighthouse\", result.lighthouse],\n    [\"analyze\", result.analyze],\n    [\"probes\", result.probes],\n  ] as const) {\n    if (!stage.ok) lines.push(`  ! ${name} not measured — ${stage.error}`);\n  }\n  if (file) lines.push(\"\", `Report written to ${file}`);\n  if (link) lines.push(\"\", `Shareable link: ${link}`);\n  if (email?.sent) {\n    lines.push(\"\", `Emailed to ${email.recipients.join(\", \")} (${email.messageId})`);\n  }\n  for (const w of warnings) lines.push(\"\", `! ${w}`);\n  if (recovery) {\n    lines.push(\n      \"\",\n      \"Neither --out nor the database took this report — wrote a recovery copy instead:\",\n      `  ${recovery.htmlPath}`,\n      `  ${recovery.jsonPath}`,\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Run one prospect audit end to end. Progress goes to stderr so `--json` stdout\n * stays pipeable. Persistence needs Turso; without it `--out` is mandatory,\n * because an audit nobody can read afterwards is just a bill.\n *\n * By the time `runProspectAudit` resolves, the money is already spent — only\n * the crawl is fatal, every other stage degrades rather than throwing. So the\n * `--out` write and the database persist below are each wrapped in their own\n * try/catch and attempted independently: a bad `--out` path must not cost a\n * working Turso persist (or vice versa), and if BOTH fail — or persist fails\n * with no `--out` given at all — a recovery copy goes to `reports/` rather\n * than the run ending with nothing anywhere. `--json` only changes the SHAPE\n * of stdout; it still runs the same `--out`/persist/recovery logic beneath it.\n */\nexport async function runProspectAuditCommand(\n  url: string,\n  opts: ProspectAuditCliOptions,\n): Promise<{ output: string; code: number }> {\n  if (!isHttpUrl(url)) {\n    return fail(`\"${url}\" is not a URL. Pass the full address, e.g. https://example.com`);\n  }\n  const canPersist = Boolean(process.env.TURSO_DATABASE_URL);\n  if (!canPersist && !opts.out) {\n    return fail(\n      \"No TURSO_DATABASE_URL, so the report cannot be saved or shared. Re-run with --out <file>, or set the Turso credentials.\",\n    );\n  }\n\n  const { runProspectAudit } = await import(\"../../prospect/pipeline.js\");\n  const onStage = (name: StageName, status: \"start\" | \"ok\" | \"fail\", detail?: string): void => {\n    if (status === \"start\") console.error(`… ${name}`);\n    else if (status === \"ok\") console.error(`✓ ${name}`);\n    else console.error(`! ${name} — ${detail ?? \"failed\"}`);\n  };\n\n  const business = opts.business?.trim();\n  const result = await runProspectAudit(\n    url,\n    {\n      ...(business ? { business } : {}),\n      ...(opts.competitors\n        ? {\n            competitors: opts.competitors\n              .split(\",\")\n              .map((c) => c.trim())\n              .filter(Boolean),\n          }\n        : {}),\n      ...(opts.probes === false ? { probes: false } : {}),\n    },\n    { ...(opts.deps ?? {}), onStage },\n  );\n\n  const { renderProspectReport } = await import(\"../../prospect/render.js\");\n  const html = renderProspectReport(result);\n\n  const warnings: string[] = [];\n\n  let file: string | null = null;\n  if (opts.out) {\n    try {\n      await writeFile(opts.out, html, \"utf-8\");\n      file = opts.out;\n    } catch (err) {\n      warnings.push(`Could not write --out (${opts.out}): ${errorMessage(err)}`);\n    }\n  }\n\n  let link: string | null = null;\n  let token: string | null = null;\n  let auditId: string | null = null;\n  if (canPersist) {\n    try {\n      const { openDb, readDbConfig } = await import(\"../../db/client.js\");\n      const { createProspectAudit } = await import(\"../../db/prospect-audits.js\");\n      const db = await openDb(readDbConfig());\n      const created = await createProspectAudit(db, {\n        url: result.url,\n        // Map at the boundary: ProspectAuditResult.businessName is the field\n        // name (Item 2 — it's a resolved NAME, not a description); the\n        // `prospect_audits.business` column keeps its existing name, since\n        // renaming a column needs its own migration for no benefit here.\n        business: result.businessName,\n        status: auditStatus(result),\n        resultJson: JSON.stringify(result),\n      });\n      auditId = created.id;\n      token = created.token;\n      link = `${resolveDashboardBaseUrl(process.env.DASHBOARD_BASE_URL)}/r/${token}`;\n    } catch (err) {\n      warnings.push(`Could not save to the database: ${errorMessage(err)}`);\n    }\n  }\n\n  const delivered = file !== null || link !== null;\n  const recovery = delivered ? null : await writeRecoveryFiles(result, html);\n  const code = delivered ? 0 : 1;\n\n  // The audit is already delivered (or recovered) above — an email failure\n  // must never take that away. Same independent try/catch shape as the\n  // --out write and the Turso persist: record a warning, keep going, never\n  // touch `code`. Dynamically imported for the same reason db/client.js and\n  // prospect/render.js are above: it reaches `resend` (a devDependency) and\n  // must stay out of bin.js's static import graph (see bin.ts's\n  // central-dep-blocker comment).\n  let email: SendAuditEmailResult | null = null;\n  if (opts.email) {\n    try {\n      const { sendAuditEmail, parseProspectAuditRecipients } =\n        await import(\"../../prospect/email.js\");\n      const recipients = parseProspectAuditRecipients(process.env.PROSPECT_AUDIT_RECIPIENTS);\n      email = await sendAuditEmail(result, { link, recipients, auditId });\n      if (!email.sent) {\n        warnings.push(`Could not email the audit sheet: ${email.reason}`);\n      }\n    } catch (err) {\n      warnings.push(`Could not email the audit sheet: ${errorMessage(err)}`);\n    }\n  }\n\n  if (opts.json) {\n    return {\n      output: JSON.stringify(\n        { result, out: file, link, token, recovery, warnings, email },\n        null,\n        2,\n      ),\n      code,\n    };\n  }\n\n  return { output: summarize(result, link, file, warnings, recovery, email), code };\n}\n","/**\n * Small pure helpers extracted from the Netlify dashboard handlers\n * (fleet-homepage.mts, site-dashboard.mts) so their non-glue logic is\n * unit-testable without booting a Netlify function.\n */\n\nconst DEFAULT_DASHBOARD_BASE_URL = \"https://reddoor-maintenance.netlify.app\";\n\n/**\n * Resolve the dashboard's public base URL from the optional DASHBOARD_BASE_URL\n * env var: trim it, fall back to the canonical Netlify URL when unset/blank,\n * and strip a trailing slash so callers can append `/s/:slug` cleanly.\n */\nexport function resolveDashboardBaseUrl(raw: string | undefined): string {\n  return (raw?.trim() || DEFAULT_DASHBOARD_BASE_URL).replace(/\\/$/, \"\");\n}\n\n/**\n * Resolve the requested site slug from the path param (Netlify\n * `ctx.params.slug`) or, lacking it, the `?slug=` query param. Null when\n * neither is present (→ the handler's presence-only health check).\n */\nexport function resolveSlug(\n  paramSlug: string | undefined,\n  querySlug: string | null,\n): string | null {\n  return paramSlug ?? querySlug ?? null;\n}\n\n/**\n * Build a 502 for an UNEXPECTED handler failure (an Airtable 429/500, a network\n * timeout). Logs the real error server-side so the operator sees it in the\n * function logs, but returns a generic, retry-able body — never the error/stack\n * itself — so a transient backend hiccup degrades to a clean \"try again\" rather\n * than an unhandled rejection (whose surfaced status/body we don't control).\n * Use in each handler's top-level catch around the Airtable + render section.\n */\nexport function handlerError(service: string, err: unknown): Response {\n  const detail = err instanceof Error ? (err.stack ?? err.message) : String(err);\n  console.error(`[${service}] unexpected failure: ${detail}`);\n  return new Response(\"Temporarily unavailable — please retry in a moment.\", {\n    status: 502,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\" },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/prospect-audits-3PMIO73D.js

@@ -0,0 +1,19 @@
+import {
+  MAX_RECENT_PROSPECT_AUDITS,
+  createProspectAudit,
+  generateToken,
+  getProspectAuditByToken,
+  isValidToken,
+  listRecentProspectAudits,
+  newProspectAuditId
+} from "./chunk-NYUYNYQL.js";
+export {
+  MAX_RECENT_PROSPECT_AUDITS,
+  createProspectAudit,
+  generateToken,
+  getProspectAuditByToken,
+  isValidToken,
+  listRecentProspectAudits,
+  newProspectAuditId
+};
+//# sourceMappingURL=prospect-audits-3PMIO73D.js.map

package/dist/prospect-audits-3PMIO73D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{protection-audit-64PLLBLI.js → protection-audit-SJO53MEQ.js}

@@ -3,8 +3,8 @@ import {
 } from "./chunk-MNDIED4M.js";
 import {
   makeGitHub
-} from "./chunk-VRWUL4TR.js";
-import "./chunk-4DHQCN5H.js";
+} from "./chunk-XHHMM5HX.js";
+import "./chunk-LBYOLBW7.js";
 
 // src/audits/protection-coverage.ts
 var RENOVATE_WORKFLOW_FILE = "renovate.yml";
@@ -165,4 +165,4 @@ export {
   protectionAuditExitCode,
   runProtectionAuditCommand
 };
-//# sourceMappingURL=protection-audit-64PLLBLI.js.map
+//# sourceMappingURL=protection-audit-SJO53MEQ.js.map

package/dist/recipes/sync-configs.js

@@ -2,11 +2,11 @@ import {
   ALL_CONFIG_NAMES,
   isConfigName,
   syncConfigs
-} from "../chunk-Q276MZ7E.js";
+} from "../chunk-7UAYMAKR.js";
 import "../chunk-73UFRZKY.js";
-import "../chunk-ZTPPCHDB.js";
-import "../chunk-XXTZBPUY.js";
+import "../chunk-3G25KIWW.js";
 import "../chunk-XTK5VIQB.js";
+import "../chunk-XXTZBPUY.js";
 export {
   ALL_CONFIG_NAMES,
   isConfigName,

package/dist/render-IFOGFB5T.js

@@ -0,0 +1,10 @@
+import {
+  renderProspectReport
+} from "./chunk-DEWJMMG3.js";
+import "./chunk-HSI6Q7MI.js";
+import "./chunk-DJZWYIPP.js";
+import "./chunk-EVBCK2KC.js";
+export {
+  renderProspectReport
+};
+//# sourceMappingURL=render-IFOGFB5T.js.map

package/dist/render-IFOGFB5T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/render-from-row-BWSOIYDS.js

@@ -0,0 +1,17 @@
+import {
+  renderReportFromRow,
+  requireLighthouse,
+  windowDays
+} from "./chunk-ZGBEIWSC.js";
+import "./chunk-GECESMVS.js";
+import "./chunk-MT2JINSS.js";
+import "./chunk-DJZWYIPP.js";
+import "./chunk-5UINJNAJ.js";
+import "./chunk-7NYN2P6I.js";
+import "./chunk-EVBCK2KC.js";
+export {
+  renderReportFromRow,
+  requireLighthouse,
+  windowDays
+};
+//# sourceMappingURL=render-from-row-BWSOIYDS.js.map

package/dist/render-from-row-BWSOIYDS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{renovate-dispatch-ICJGSFCE.js → renovate-dispatch-6GQWTRKX.js}

@@ -2,19 +2,19 @@ import {
   isRenovatePR
 } from "./chunk-PZQ3WED2.js";
 import {
-  makeGitHub
-} from "./chunk-VRWUL4TR.js";
-import "./chunk-4DHQCN5H.js";
+  openBase,
+  readAirtableConfig
+} from "./chunk-HN6I2XWI.js";
 import {
   allActionableVulnsTransitive,
   isDashboardVisible,
   listWebsites,
   updateAutoFixAttempts
-} from "./chunk-577HCGZO.js";
+} from "./chunk-7NYN2P6I.js";
 import {
-  openBase,
-  readAirtableConfig
-} from "./chunk-HN6I2XWI.js";
+  makeGitHub
+} from "./chunk-XHHMM5HX.js";
+import "./chunk-LBYOLBW7.js";
 import "./chunk-6VAL7XJT.js";
 
 // src/github/renovate-dispatch.ts
@@ -130,10 +130,10 @@ async function runRenovateDispatchCommand(opts) {
     for (const f of result.failed) lines.push(`  \u21B3 ${f.repo}: ${f.error}`);
   }
   const attemptUpdates = computeAutoFixAttemptUpdates(websites, result);
-  const attemptTally = await applyAutoFixAttemptUpdates(
-    attemptUpdates,
-    (id, attempts) => updateAutoFixAttempts(base, id, attempts)
-  );
+  const attemptTally = await applyAutoFixAttemptUpdates(attemptUpdates, async (id, attempts) => {
+    const fields = await updateAutoFixAttempts(base, id, attempts);
+    await opts.siteMirror?.health(id, fields);
+  });
   lines.push(formatRenovateDispatchSummary(result));
   lines.push(formatAutoFixAttemptsSummary(attemptTally));
   return { output: lines.join("\n"), code: 0 };
@@ -141,4 +141,4 @@ async function runRenovateDispatchCommand(opts) {
 export {
   runRenovateDispatchCommand
 };
-//# sourceMappingURL=renovate-dispatch-ICJGSFCE.js.map
+//# sourceMappingURL=renovate-dispatch-6GQWTRKX.js.map