@ainyc/canonry 4.72.3 → 4.74.0

package/dist/{chunk-HSX32G47.js → chunk-ZRZHIS22.js}

@@ -21,6 +21,7 @@ import {
   RunTriggers,
   SKILL_MANIFEST_FILENAME,
   SchedulableRunKinds,
+  SiteAuditTrendDirections,
   TrafficEventConfidences,
   TrafficEventKinds,
   TrafficEvidenceKinds,
@@ -186,6 +187,11 @@ import {
   scheduleUpsertRequestSchema,
   serializeRunError,
   settingsDtoSchema,
+  siteAuditPagesResponseSchema,
+  siteAuditRunRequestSchema,
+  siteAuditRunResponseSchema,
+  siteAuditScoreSchema,
+  siteAuditTrendResponseSchema,
   snapshotDiffResponseSchema,
   snapshotListResponseSchema,
   snapshotReportSchema,
@@ -223,10 +229,10 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-JXFNERK4.js";
+} from "./chunk-A7JX3FZB.js";
 
 // src/intelligence-service.ts
-import { eq as eq32, desc as desc16, asc as asc3, and as and23, ne as ne5, or as or5, inArray as inArray11, gte as gte6, lte as lte3 } from "drizzle-orm";
+import { eq as eq33, desc as desc17, asc as asc4, and as and24, ne as ne5, or as or5, inArray as inArray12, gte as gte6, lte as lte3 } from "drizzle-orm";
 
 // ../db/src/client.ts
 import { mkdirSync } from "fs";
@@ -285,6 +291,8 @@ __export(schema_exports, {
   recommendationExplanations: () => recommendationExplanations,
   runs: () => runs,
   schedules: () => schedules,
+  siteAuditPages: () => siteAuditPages,
+  siteAuditSnapshots: () => siteAuditSnapshots,
   trafficSources: () => trafficSources,
   usageCounters: () => usageCounters
 });
@@ -533,6 +541,39 @@ var gscCoverageSnapshots = sqliteTable("gsc_coverage_snapshots", {
   index("idx_gsc_coverage_snap_project_date").on(table.projectId, table.date),
   index("idx_gsc_coverage_snap_run").on(table.syncRunId)
 ]);
+var siteAuditSnapshots = sqliteTable("site_audit_snapshots", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  runId: text("run_id").notNull().references(() => runs.id, { onDelete: "cascade" }),
+  sitemapUrl: text("sitemap_url").notNull(),
+  auditedAt: text("audited_at").notNull(),
+  aggregateScore: integer("aggregate_score").notNull().default(0),
+  pagesDiscovered: integer("pages_discovered").notNull().default(0),
+  pagesAudited: integer("pages_audited").notNull().default(0),
+  pagesSkipped: integer("pages_skipped").notNull().default(0),
+  pagesErrored: integer("pages_errored").notNull().default(0),
+  factorAverages: text("factor_averages", { mode: "json" }).$type().notNull().default([]),
+  crossCuttingIssues: text("cross_cutting_issues", { mode: "json" }).$type().notNull().default([]),
+  prioritizedFixes: text("prioritized_fixes", { mode: "json" }).$type().notNull().default([]),
+  createdAt: text("created_at").notNull()
+}, (table) => [
+  index("idx_site_audit_snap_project_created").on(table.projectId, table.createdAt),
+  index("idx_site_audit_snap_run").on(table.runId)
+]);
+var siteAuditPages = sqliteTable("site_audit_pages", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  runId: text("run_id").notNull().references(() => runs.id, { onDelete: "cascade" }),
+  url: text("url").notNull(),
+  overallScore: integer("overall_score").notNull().default(0),
+  status: text("status").notNull(),
+  error: text("error"),
+  factors: text("factors", { mode: "json" }).$type().notNull().default([]),
+  createdAt: text("created_at").notNull()
+}, (table) => [
+  index("idx_site_audit_pages_run").on(table.runId),
+  index("idx_site_audit_pages_project_score").on(table.projectId, table.overallScore)
+]);
 var bingCoverageSnapshots = sqliteTable("bing_coverage_snapshots", {
   id: text("id").primaryKey(),
   projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
@@ -2780,6 +2821,47 @@ var MIGRATION_VERSIONS = [
       `CREATE UNIQUE INDEX IF NOT EXISTS idx_recommendation_briefs_unique ON recommendation_briefs(project_id, target_ref, prompt_version)`,
       `CREATE INDEX IF NOT EXISTS idx_recommendation_briefs_project ON recommendation_briefs(project_id)`
     ]
+  },
+  {
+    // Technical AEO — site-wide audit persistence. `site_audit_snapshots` is the
+    // per-run summary (drives the score + trend); `site_audit_pages` is the
+    // per-page breakdown (drives the drill-down table). Both cascade off runs so
+    // a run delete cleans up its audit data.
+    version: 75,
+    name: "site-audit-tables",
+    statements: [
+      `CREATE TABLE IF NOT EXISTS site_audit_snapshots (
+        id                   TEXT PRIMARY KEY,
+        project_id           TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        run_id               TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
+        sitemap_url          TEXT NOT NULL,
+        audited_at           TEXT NOT NULL,
+        aggregate_score      INTEGER NOT NULL DEFAULT 0,
+        pages_discovered     INTEGER NOT NULL DEFAULT 0,
+        pages_audited        INTEGER NOT NULL DEFAULT 0,
+        pages_skipped        INTEGER NOT NULL DEFAULT 0,
+        pages_errored        INTEGER NOT NULL DEFAULT 0,
+        factor_averages      TEXT NOT NULL DEFAULT '[]',
+        cross_cutting_issues TEXT NOT NULL DEFAULT '[]',
+        prioritized_fixes    TEXT NOT NULL DEFAULT '[]',
+        created_at           TEXT NOT NULL
+      )`,
+      `CREATE INDEX IF NOT EXISTS idx_site_audit_snap_project_created ON site_audit_snapshots(project_id, created_at)`,
+      `CREATE INDEX IF NOT EXISTS idx_site_audit_snap_run ON site_audit_snapshots(run_id)`,
+      `CREATE TABLE IF NOT EXISTS site_audit_pages (
+        id            TEXT PRIMARY KEY,
+        project_id    TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        run_id        TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
+        url           TEXT NOT NULL,
+        overall_score INTEGER NOT NULL DEFAULT 0,
+        status        TEXT NOT NULL,
+        error         TEXT,
+        factors       TEXT NOT NULL DEFAULT '[]',
+        created_at    TEXT NOT NULL
+      )`,
+      `CREATE INDEX IF NOT EXISTS idx_site_audit_pages_run ON site_audit_pages(run_id)`,
+      `CREATE INDEX IF NOT EXISTS idx_site_audit_pages_project_score ON site_audit_pages(project_id, overall_score)`
+    ]
   }
 ];
 function isDuplicateColumnError(err) {
@@ -4098,15 +4180,15 @@ function buildAiSourceOrigin(snapshots, projectDomains, competitorDomains, topDo
       totalCitations++;
     }
   }
-  const categories = [...categoryCounts.entries()].map(([category, { label, count }]) => ({
+  const categories = [...categoryCounts.entries()].map(([category, { label, count: count2 }]) => ({
     category,
     label,
-    count,
-    sharePct: totalCitations > 0 ? Math.round(count / totalCitations * 100) : 0
+    count: count2,
+    sharePct: totalCitations > 0 ? Math.round(count2 / totalCitations * 100) : 0
   })).sort((a, b) => b.count - a.count);
-  const topDomains = [...domainCounts.entries()].map(([domain, count]) => ({
+  const topDomains = [...domainCounts.entries()].map(([domain, count2]) => ({
     domain,
-    count,
+    count: count2,
     isCompetitor: citedDomainBelongsToProject(domain, competitorDomains)
   })).sort((a, b) => b.count - a.count).slice(0, topDomainsLimit);
   return { categories, topDomains };
@@ -5203,7 +5285,7 @@ async function projectRoutes(app, opts) {
   app.get("/projects/:name/delete-preview", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
     const pid = project.id;
-    const count = (n) => n ?? 0;
+    const count2 = (n) => n ?? 0;
     const queryCount = app.db.select({ n: sql3`count(*)` }).from(queries).where(eq3(queries.projectId, pid)).get();
     const competitorCount = app.db.select({ n: sql3`count(*)` }).from(competitors).where(eq3(competitors.projectId, pid)).get();
     const runCount = app.db.select({ n: sql3`count(*)` }).from(runs).where(eq3(runs.projectId, pid)).get();
@@ -5213,14 +5295,14 @@ async function projectRoutes(app, opts) {
     return reply.send({
       project: { id: project.id, name: project.name },
       cascadeRows: {
-        queries: count(queryCount?.n),
-        competitors: count(competitorCount?.n),
-        runs: count(runCount?.n),
-        snapshots: count(snapshotCount?.n),
-        insights: count(insightCount?.n)
+        queries: count2(queryCount?.n),
+        competitors: count2(competitorCount?.n),
+        runs: count2(runCount?.n),
+        snapshots: count2(snapshotCount?.n),
+        insights: count2(insightCount?.n)
       },
       detachedRows: {
-        auditLog: count(auditLogCount?.n)
+        auditLog: count2(auditLogCount?.n)
       }
     });
   });
@@ -5552,14 +5634,14 @@ async function queryRoutes(app, opts) {
         validProviders: validNames
       });
     }
-    const count = body.count ?? 5;
+    const count2 = body.count ?? 5;
     if (!opts.onGenerateQueries) {
       throw notImplemented("Query generation is not supported in this deployment");
     }
     const existingRows = app.db.select().from(queries).where(eq4(queries.projectId, project.id)).all();
     const existingQueries = existingRows.map((r) => r.query);
     try {
-      const generated = await opts.onGenerateQueries(provider, count, {
+      const generated = await opts.onGenerateQueries(provider, count2, {
         domain: project.canonicalDomain,
         displayName: project.displayName,
         country: project.country,
@@ -5689,14 +5771,14 @@ async function queryRoutes(app, opts) {
         validProviders: validNames
       });
     }
-    const count = body.count ?? 5;
+    const count2 = body.count ?? 5;
     if (!opts.onGenerateQueries) {
       throw notImplemented("Keyword generation is not supported in this deployment");
     }
     const existingRows = app.db.select().from(queries).where(eq4(queries.projectId, project.id)).all();
     const existingQueries = existingRows.map((r) => r.query);
     try {
-      const generated = await opts.onGenerateQueries(provider, count, {
+      const generated = await opts.onGenerateQueries(provider, count2, {
         domain: project.canonicalDomain,
         displayName: project.displayName,
         country: project.country,
@@ -7438,10 +7520,10 @@ function computeQueryChanges(projectQueries, cutoff) {
   }
   const days = [...byDay.entries()].sort((a, b) => a[0].localeCompare(b[0]));
   if (days.length <= 1) return [];
-  return days.slice(1).map(([date, count]) => ({
+  return days.slice(1).map(([date, count2]) => ({
     date: (/* @__PURE__ */ new Date(date + "T00:00:00.000Z")).toISOString(),
-    delta: count,
-    label: `+${count} kp`
+    delta: count2,
+    label: `+${count2} kp`
   }));
 }
 function computeTrend(buckets, rateKey) {
@@ -7506,15 +7588,15 @@ function buildRankedList(domains, limit) {
 function buildCategoryCounts(counts) {
   let grandTotal = 0;
   for (const domains of counts.values()) {
-    for (const count of domains.values()) grandTotal += count;
+    for (const count2 of domains.values()) grandTotal += count2;
   }
   const result = [];
   for (const [category, domains] of counts) {
     let categoryTotal = 0;
     const domainEntries = [];
-    for (const [domain, count] of domains) {
-      categoryTotal += count;
-      domainEntries.push({ domain, count });
+    for (const [domain, count2] of domains) {
+      categoryTotal += count2;
+      domainEntries.push({ domain, count: count2 });
     }
     domainEntries.sort((a, b) => b.count - a.count);
     result.push({
@@ -8488,8 +8570,8 @@ function gscDateRange(report) {
   const end = summary?.periodEnd || gsc?.periodEnd || gsc?.trend.at(-1)?.date || "";
   return formatDateRange(start, end);
 }
-function pluralize(count, singular, plural = `${singular}s`) {
-  return count === 1 ? singular : plural;
+function pluralize(count2, singular, plural = `${singular}s`) {
+  return count2 === 1 ? singular : plural;
 }
 var PROVIDER_DISPLAY_NAMES = {
   gemini: "Gemini",
@@ -10292,9 +10374,9 @@ function renderInsights(report) {
     );
   }
   const haveDeduped = list.every((i) => typeof i.instanceCount === "number");
-  const rows = (haveDeduped ? list.map((i) => ({ rep: i, count: i.instanceCount })) : groupInsights(list).map((g) => ({ rep: g.representative, count: g.count }))).map(({ rep: i, count }) => {
+  const rows = (haveDeduped ? list.map((i) => ({ rep: i, count: i.instanceCount })) : groupInsights(list).map((g) => ({ rep: g.representative, count: g.count }))).map(({ rep: i, count: count2 }) => {
     const tone = severityTone(i.severity);
-    const countChip = count > 1 ? ` <span class="badge tone-neutral">\xD7 ${count}</span>` : "";
+    const countChip = count2 > 1 ? ` <span class="badge tone-neutral">\xD7 ${count2}</span>` : "";
     return `<tr>
         <td class="col-severity"><span class="badge tone-${tone}">${escapeHtml(reportSeverityLabel(i.severity))}</span></td>
         <td class="col-title">${escapeHtml(i.title)}${countChip}</td>
@@ -11494,9 +11576,9 @@ function contentActionVerb(action) {
       return "Add schema to";
   }
 }
-function confidenceFromEvidence(count) {
-  if (count >= 3) return "high";
-  if (count >= 1) return "medium";
+function confidenceFromEvidence(count2) {
+  if (count2 >= 3) return "high";
+  if (count2 >= 1) return "medium";
   return "low";
 }
 function actionAudienceMatches2(action, audience) {
@@ -13003,6 +13085,10 @@ var SCHEMA_TABLE = {
   SchedulableRunKind: schedulableRunKindSchema,
   ScheduleDto: scheduleDtoSchema,
   SettingsDto: settingsDtoSchema,
+  SiteAuditPagesResponseDto: siteAuditPagesResponseSchema,
+  SiteAuditRunResponseDto: siteAuditRunResponseSchema,
+  SiteAuditScoreDto: siteAuditScoreSchema,
+  SiteAuditTrendResponseDto: siteAuditTrendResponseSchema,
   SnapshotDiffResponse: snapshotDiffResponseSchema,
   SnapshotListResponse: snapshotListResponseSchema,
   SnapshotReportDto: snapshotReportSchema,
@@ -16688,6 +16774,78 @@ var routeCatalog = [
       400: errorResponse("Session is not completed, or invalid request body."),
       404: errorResponse("Project or session not found.")
     }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/technical-aeo",
+    summary: "Get the Technical AEO scorecard for a project",
+    description: "Returns the latest completed/partial site-audit: aggregate 0\u2013100 score, page counts, the full per-factor scorecard (site-level averages with pass/partial/fail distribution), cross-cutting issues, prioritized fixes, and the delta vs the previous audit. When the project has never been audited, `hasData` is false and the numeric fields are zeroed \u2014 render an onboarding state.",
+    tags: ["technical-aeo"],
+    parameters: [nameParameter],
+    responses: {
+      200: jsonResponse("Technical AEO scorecard returned.", "SiteAuditScoreDto"),
+      404: errorResponse("Project not found.")
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/technical-aeo/pages",
+    summary: "List audited pages from the latest site-audit run",
+    description: "Returns the per-page breakdown of the latest completed/partial site-audit run (paginated). Filter to `status=error` to surface unreachable pages; sort `score-asc` (default) to surface the worst-scoring pages first.",
+    tags: ["technical-aeo"],
+    parameters: [
+      nameParameter,
+      { name: "status", in: "query", description: "Filter by page audit status: `success` or `error`.", schema: { type: "string", enum: ["success", "error"] } },
+      { name: "sort", in: "query", description: "Sort order: `score-asc` (default), `score-desc`, or `url`.", schema: { type: "string", enum: ["score-asc", "score-desc", "url"] } },
+      limitQueryParameter,
+      offsetQueryParameter
+    ],
+    responses: {
+      200: jsonResponse("Audited pages returned.", "SiteAuditPagesResponseDto"),
+      404: errorResponse("Project not found.")
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/technical-aeo/trend",
+    summary: "Get the Technical AEO aggregate-score trend",
+    description: "Returns historical aggregate scores across completed/partial site-audit runs, oldest-first, for the trend chart.",
+    tags: ["technical-aeo"],
+    parameters: [
+      nameParameter,
+      { name: "limit", in: "query", description: "Max data points returned (most recent runs). Default 30.", schema: integerSchema }
+    ],
+    responses: {
+      200: jsonResponse("Technical AEO trend returned.", "SiteAuditTrendResponseDto"),
+      404: errorResponse("Project not found.")
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/technical-aeo/runs",
+    summary: "Trigger a Technical AEO site-audit run",
+    description: "Queues a `site-audit` run that crawls the project sitemap and audits every reachable page. Idempotent: if a site-audit run is already queued/running for the project, returns that run instead of starting a second.",
+    tags: ["technical-aeo"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: false,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            properties: {
+              sitemapUrl: { ...stringSchema, description: "Override the sitemap URL. Defaults to https://<canonicalDomain>/sitemap.xml." },
+              limit: { ...integerSchema, description: "Cap pages audited (highest sitemap <priority> first). Max 2000." }
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: jsonResponse("Site-audit run queued (or the in-flight run returned).", "SiteAuditRunResponseDto"),
+      400: errorResponse("Invalid site-audit request."),
+      404: errorResponse("Project not found.")
+    }
   }
 ];
 var canonryLocalRouteCatalog = [
@@ -17201,6 +17359,9 @@ async function scheduleRoutes(app, opts) {
     if (kind === SchedulableRunKinds["backlinks-sync"] && providers && providers.length > 0) {
       throw validationError('"providers" is not valid for kind "backlinks-sync"');
     }
+    if (kind === SchedulableRunKinds["site-audit"] && providers && providers.length > 0) {
+      throw validationError('"providers" is not valid for kind "site-audit"');
+    }
     const validNames = opts.validProviderNames ?? [];
     if (validNames.length && providers?.length) {
       const invalid = providers.filter((p) => !validNames.includes(p));
@@ -18898,12 +19059,12 @@ async function getLodging(accessToken, locationName, opts = {}) {
   }
 }
 function countPopulatedGroups(lodging) {
-  let count = 0;
+  let count2 = 0;
   for (const [key, value] of Object.entries(lodging)) {
     if (key === "name" || key === "metadata") continue;
-    if (isPopulated(value)) count++;
+    if (isPopulated(value)) count2++;
   }
-  return count;
+  return count2;
 }
 function isPopulated(value) {
   if (value === null || value === void 0) return false;
@@ -30949,11 +31110,41 @@ var scopesCheck3 = {
     return summarizePerSourceResults("scopes", "scopes", results);
   }
 };
+var cacheBlindSpotCheck = {
+  id: "traffic.source.cache-blindspot",
+  category: CheckCategories.integrations,
+  scope: CheckScopes.project,
+  title: "WordPress traffic cache blind spot",
+  run: (ctx) => {
+    if (!ctx.project) return skippedNoProject4();
+    const wpSources = loadProbes(ctx).filter(
+      (s) => s.sourceType === TrafficSourceTypes.wordpress
+    );
+    if (wpSources.length === 0) {
+      return {
+        status: CheckStatuses.skipped,
+        code: "traffic.cache-blindspot.no-wordpress-source",
+        summary: "No WordPress traffic source connected, so the plugin cache blind spot does not apply (log and edge adapters see cache-served requests)."
+      };
+    }
+    return {
+      status: CheckStatuses.warn,
+      code: "traffic.cache-blindspot.wordpress-plugin",
+      summary: `${wpSources.length} WordPress traffic source(s) capture via the Canonry Traffic Logger plugin, which only logs requests that execute PHP. A full-page cache (LiteSpeed, WP Rocket, W3 Total Cache, WP Super Cache) or CDN serves cached pages before PHP runs, so cache-served page views, including live AI user-fetches such as Claude-User and ChatGPT-User, are not captured. Bot crawls of uncached endpoints (sitemap, feeds, assets, cache misses) still appear, which can make capture look healthy while real page views go uncounted.`,
+      remediation: 'Exclude AI user-agents from the page cache so their requests reach PHP: LiteSpeed Cache has "Do Not Cache User Agents" under Cache > Excludes; WP Rocket uses the `rocket_cache_reject_ua` filter; W3 Total Cache and WP Super Cache have a "Rejected User Agents" box. Mirror the rule at any CDN in front. For cache-independent capture, ingest from server or edge access logs (a `cloud-run` or `vercel` source, or an edge worker) instead of the WordPress plugin.',
+      details: {
+        wordpressSourceCount: wpSources.length,
+        wordpressSourceIds: wpSources.map((s) => s.id)
+      }
+    };
+  }
+};
 var TRAFFIC_SOURCE_CHECKS = [
   sourceConnectedCheck,
   recentDataCheck,
   credentialsCheck,
-  scopesCheck3
+  scopesCheck3,
+  cacheBlindSpotCheck
 ];
 
 // ../api-routes/src/doctor/checks/wordpress-publish.ts
@@ -31645,6 +31836,151 @@ function dedupeStrings(input) {
   return out;
 }
 
+// ../api-routes/src/technical-aeo.ts
+import crypto27 from "crypto";
+import { and as and23, asc as asc3, count, desc as desc16, eq as eq32, inArray as inArray11 } from "drizzle-orm";
+var SURFACEABLE_STATUSES = [RunStatuses.completed, RunStatuses.partial];
+function emptyScore(projectName) {
+  return {
+    project: projectName,
+    hasData: false,
+    runId: null,
+    runStatus: null,
+    sitemapUrl: null,
+    auditedAt: null,
+    aggregateScore: 0,
+    pagesDiscovered: 0,
+    pagesAudited: 0,
+    pagesSkipped: 0,
+    pagesErrored: 0,
+    deltaScore: null,
+    trend: null,
+    previousScore: null,
+    previousAuditedAt: null,
+    factors: [],
+    crossCuttingIssues: [],
+    prioritizedFixes: []
+  };
+}
+function parsePositiveInt(value, fallback, max) {
+  const n = typeof value === "string" ? Number.parseInt(value, 10) : typeof value === "number" ? value : NaN;
+  if (!Number.isFinite(n) || n < 0) return fallback;
+  return Math.min(max, Math.floor(n));
+}
+async function technicalAeoRoutes(app, opts) {
+  app.get("/projects/:name/technical-aeo", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const rows = app.db.select({ snap: siteAuditSnapshots, runStatus: runs.status }).from(siteAuditSnapshots).innerJoin(runs, eq32(siteAuditSnapshots.runId, runs.id)).where(and23(
+      eq32(siteAuditSnapshots.projectId, project.id),
+      eq32(runs.kind, RunKinds["site-audit"]),
+      inArray11(runs.status, SURFACEABLE_STATUSES),
+      notProbeRun()
+    )).orderBy(desc16(siteAuditSnapshots.createdAt)).limit(2).all();
+    const latest = rows[0];
+    if (!latest) return emptyScore(project.name);
+    const snap = latest.snap;
+    const previous = rows[1]?.snap ?? null;
+    const deltaScore = previous ? snap.aggregateScore - previous.aggregateScore : null;
+    const trend = deltaScore == null ? null : deltaScore > 0 ? SiteAuditTrendDirections.up : deltaScore < 0 ? SiteAuditTrendDirections.down : SiteAuditTrendDirections.flat;
+    return {
+      project: project.name,
+      hasData: true,
+      runId: snap.runId,
+      runStatus: latest.runStatus,
+      sitemapUrl: snap.sitemapUrl,
+      auditedAt: snap.auditedAt,
+      aggregateScore: snap.aggregateScore,
+      pagesDiscovered: snap.pagesDiscovered,
+      pagesAudited: snap.pagesAudited,
+      pagesSkipped: snap.pagesSkipped,
+      pagesErrored: snap.pagesErrored,
+      deltaScore,
+      trend,
+      previousScore: previous?.aggregateScore ?? null,
+      previousAuditedAt: previous?.auditedAt ?? null,
+      factors: snap.factorAverages,
+      crossCuttingIssues: snap.crossCuttingIssues,
+      prioritizedFixes: snap.prioritizedFixes
+    };
+  });
+  app.get("/projects/:name/technical-aeo/pages", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const latest = app.db.select({ runId: siteAuditSnapshots.runId, auditedAt: siteAuditSnapshots.auditedAt }).from(siteAuditSnapshots).innerJoin(runs, eq32(siteAuditSnapshots.runId, runs.id)).where(and23(
+      eq32(siteAuditSnapshots.projectId, project.id),
+      eq32(runs.kind, RunKinds["site-audit"]),
+      inArray11(runs.status, SURFACEABLE_STATUSES),
+      notProbeRun()
+    )).orderBy(desc16(siteAuditSnapshots.createdAt)).limit(1).get();
+    if (!latest) {
+      return { project: project.name, runId: null, auditedAt: null, total: 0, pages: [] };
+    }
+    const statusFilter = request.query.status === "success" || request.query.status === "error" ? request.query.status : null;
+    const conds = [eq32(siteAuditPages.runId, latest.runId)];
+    if (statusFilter) conds.push(eq32(siteAuditPages.status, statusFilter));
+    const where = and23(...conds);
+    const totalRow = app.db.select({ value: count() }).from(siteAuditPages).where(where).get();
+    const total = totalRow?.value ?? 0;
+    const limit = parsePositiveInt(request.query.limit, 100, 500);
+    const offset = parsePositiveInt(request.query.offset, 0, Number.MAX_SAFE_INTEGER);
+    const orderBy = request.query.sort === "score-desc" ? desc16(siteAuditPages.overallScore) : request.query.sort === "url" ? asc3(siteAuditPages.url) : asc3(siteAuditPages.overallScore);
+    const rows = app.db.select().from(siteAuditPages).where(where).orderBy(orderBy).limit(limit).offset(offset).all();
+    const pages = rows.map((row) => ({
+      url: row.url,
+      overallScore: row.overallScore,
+      status: row.status === "error" ? "error" : "success",
+      error: row.error,
+      factors: row.factors
+    }));
+    return { project: project.name, runId: latest.runId, auditedAt: latest.auditedAt, total, pages };
+  });
+  app.get("/projects/:name/technical-aeo/trend", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const limit = parsePositiveInt(request.query.limit, 30, 365);
+    const rows = app.db.select({
+      runId: siteAuditSnapshots.runId,
+      auditedAt: siteAuditSnapshots.auditedAt,
+      aggregateScore: siteAuditSnapshots.aggregateScore,
+      pagesAudited: siteAuditSnapshots.pagesAudited
+    }).from(siteAuditSnapshots).innerJoin(runs, eq32(siteAuditSnapshots.runId, runs.id)).where(and23(
+      eq32(siteAuditSnapshots.projectId, project.id),
+      eq32(runs.kind, RunKinds["site-audit"]),
+      inArray11(runs.status, SURFACEABLE_STATUSES),
+      notProbeRun()
+    )).orderBy(desc16(siteAuditSnapshots.createdAt)).limit(limit).all();
+    return { project: project.name, points: rows.reverse() };
+  });
+  app.post("/projects/:name/technical-aeo/runs", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const parsed = siteAuditRunRequestSchema.safeParse(request.body ?? {});
+    if (!parsed.success) {
+      throw validationError(parsed.error.issues[0]?.message ?? "Invalid site-audit request");
+    }
+    const existing = app.db.select({ id: runs.id, status: runs.status }).from(runs).where(and23(
+      eq32(runs.projectId, project.id),
+      eq32(runs.kind, RunKinds["site-audit"]),
+      inArray11(runs.status, [RunStatuses.queued, RunStatuses.running])
+    )).get();
+    if (existing) {
+      return { runId: existing.id, status: existing.status };
+    }
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const runId = crypto27.randomUUID();
+    app.db.insert(runs).values({
+      id: runId,
+      projectId: project.id,
+      kind: RunKinds["site-audit"],
+      status: RunStatuses.queued,
+      trigger: RunTriggers.manual,
+      createdAt: now
+    }).run();
+    opts.onSiteAuditRequested?.(runId, project.id, {
+      sitemapUrl: parsed.data.sitemapUrl,
+      limit: parsed.data.limit
+    });
+    return { runId, status: RunStatuses.queued };
+  });
+}
+
 // ../api-routes/src/index.ts
 async function apiRoutes(app, opts) {
   app.decorate("db", opts.db);
@@ -31809,6 +32145,9 @@ async function apiRoutes(app, opts) {
     await api.register(discoveryRoutes, {
       onDiscoveryRunRequested: opts.onDiscoveryRunRequested
     });
+    await api.register(technicalAeoRoutes, {
+      onSiteAuditRequested: opts.onSiteAuditRequested
+    });
     await api.register(doctorRoutes, {
       googleConnectionStore: opts.googleConnectionStore,
       bingConnectionStore: opts.bingConnectionStore,
@@ -31964,7 +32303,7 @@ function buildTrafficSourceValidators(opts) {
 }
 
 // src/intelligence-service.ts
-import crypto27 from "crypto";
+import crypto28 from "crypto";
 
 // src/logger.ts
 var IS_TTY = process.stdout.isTTY === true;
@@ -32195,16 +32534,16 @@ var IntelligenceService = class {
    */
   analyzeAndPersist(runId, projectId) {
     const recentRuns = this.db.select().from(runs).where(
-      and23(
-        eq32(runs.projectId, projectId),
-        or5(eq32(runs.status, "completed"), eq32(runs.status, "partial")),
+      and24(
+        eq33(runs.projectId, projectId),
+        or5(eq33(runs.status, "completed"), eq33(runs.status, "partial")),
         // Defensive: RunCoordinator already skips probes before this is
         // called, but if a future call site invokes analyzeAndPersist
         // directly for a probe, probes still must not pollute the
         // intelligence window.
         ne5(runs.trigger, RunTriggers.probe)
       )
-    ).orderBy(desc16(runs.finishedAt), desc16(runs.createdAt)).limit(HISTORY_WINDOW_RUNS).all();
+    ).orderBy(desc17(runs.finishedAt), desc17(runs.createdAt)).limit(HISTORY_WINDOW_RUNS).all();
     if (recentRuns.length === 0) {
       log.info("intelligence.skip", { runId, reason: "no completed runs" });
       return null;
@@ -32279,7 +32618,7 @@ var IntelligenceService = class {
    * Returns the persisted insights so the coordinator can count critical/high.
    */
   analyzeAndPersistGbp(runId, projectId) {
-    const runRow = this.db.select({ createdAt: runs.createdAt, startedAt: runs.startedAt, finishedAt: runs.finishedAt }).from(runs).where(eq32(runs.id, runId)).get();
+    const runRow = this.db.select({ createdAt: runs.createdAt, startedAt: runs.startedAt, finishedAt: runs.finishedAt }).from(runs).where(eq33(runs.id, runId)).get();
     if (!runRow) {
       log.info("gbp-intelligence.skip", { runId, reason: "run not found" });
       this.persistGbpInsights(runId, projectId, [], []);
@@ -32287,9 +32626,9 @@ var IntelligenceService = class {
     }
     const windowStart = runRow.startedAt ?? runRow.createdAt;
     const windowEnd = runRow.finishedAt ?? (/* @__PURE__ */ new Date()).toISOString();
-    const selected = this.db.select().from(gbpLocations).where(and23(
-      eq32(gbpLocations.projectId, projectId),
-      eq32(gbpLocations.selected, true),
+    const selected = this.db.select().from(gbpLocations).where(and24(
+      eq33(gbpLocations.projectId, projectId),
+      eq33(gbpLocations.selected, true),
       gte6(gbpLocations.syncedAt, windowStart),
       lte3(gbpLocations.syncedAt, windowEnd)
     )).all();
@@ -32324,10 +32663,10 @@ var IntelligenceService = class {
   }
   /** Build the per-location signal bundle the GBP analyzer consumes. */
   buildGbpLocationSignals(projectId, locationName, displayName, fallbackDate) {
-    const metricRows = this.db.select({ metric: gbpDailyMetrics.metric, date: gbpDailyMetrics.date, value: gbpDailyMetrics.value }).from(gbpDailyMetrics).where(and23(eq32(gbpDailyMetrics.projectId, projectId), eq32(gbpDailyMetrics.locationName, locationName))).all();
-    const placeActionRows = this.db.select({ placeActionType: gbpPlaceActions.placeActionType, providerType: gbpPlaceActions.providerType }).from(gbpPlaceActions).where(and23(eq32(gbpPlaceActions.projectId, projectId), eq32(gbpPlaceActions.locationName, locationName))).all();
-    const lodgingRow = this.db.select({ populatedGroupCount: gbpLodgingSnapshots.populatedGroupCount }).from(gbpLodgingSnapshots).where(and23(eq32(gbpLodgingSnapshots.projectId, projectId), eq32(gbpLodgingSnapshots.locationName, locationName))).orderBy(desc16(gbpLodgingSnapshots.syncedAt)).limit(1).get();
-    const placeRow = this.db.select({ attributes: gbpPlaceDetails.attributes }).from(gbpPlaceDetails).where(and23(eq32(gbpPlaceDetails.projectId, projectId), eq32(gbpPlaceDetails.locationName, locationName))).orderBy(desc16(gbpPlaceDetails.syncedAt)).limit(1).get();
+    const metricRows = this.db.select({ metric: gbpDailyMetrics.metric, date: gbpDailyMetrics.date, value: gbpDailyMetrics.value }).from(gbpDailyMetrics).where(and24(eq33(gbpDailyMetrics.projectId, projectId), eq33(gbpDailyMetrics.locationName, locationName))).all();
+    const placeActionRows = this.db.select({ placeActionType: gbpPlaceActions.placeActionType, providerType: gbpPlaceActions.providerType }).from(gbpPlaceActions).where(and24(eq33(gbpPlaceActions.projectId, projectId), eq33(gbpPlaceActions.locationName, locationName))).all();
+    const lodgingRow = this.db.select({ populatedGroupCount: gbpLodgingSnapshots.populatedGroupCount }).from(gbpLodgingSnapshots).where(and24(eq33(gbpLodgingSnapshots.projectId, projectId), eq33(gbpLodgingSnapshots.locationName, locationName))).orderBy(desc17(gbpLodgingSnapshots.syncedAt)).limit(1).get();
+    const placeRow = this.db.select({ attributes: gbpPlaceDetails.attributes }).from(gbpPlaceDetails).where(and24(eq33(gbpPlaceDetails.projectId, projectId), eq33(gbpPlaceDetails.locationName, locationName))).orderBy(desc17(gbpPlaceDetails.syncedAt)).limit(1).get();
     const placesAmenities = placeRow ? extractPlaceAmenities(placeRow.attributes) : [];
     const summary = buildGbpSummary({
       locationName,
@@ -32359,7 +32698,7 @@ var IntelligenceService = class {
   /** Build the month-over-month keyword series for a location from the
    *  accumulating gbp_keyword_monthly table (latest complete month vs prior). */
   buildGbpKeywordTrend(projectId, locationName) {
-    const rows = this.db.select({ month: gbpKeywordMonthly.month, keyword: gbpKeywordMonthly.keyword, valueCount: gbpKeywordMonthly.valueCount }).from(gbpKeywordMonthly).where(and23(eq32(gbpKeywordMonthly.projectId, projectId), eq32(gbpKeywordMonthly.locationName, locationName))).all();
+    const rows = this.db.select({ month: gbpKeywordMonthly.month, keyword: gbpKeywordMonthly.keyword, valueCount: gbpKeywordMonthly.valueCount }).from(gbpKeywordMonthly).where(and24(eq33(gbpKeywordMonthly.projectId, projectId), eq33(gbpKeywordMonthly.locationName, locationName))).all();
     if (rows.length === 0) return { recentMonth: null, priorMonth: null, points: [] };
     const months = [...new Set(rows.map((r) => r.month))].sort().reverse();
     const recentMonth = months[0] ?? null;
@@ -32390,7 +32729,7 @@ var IntelligenceService = class {
    */
   persistGbpInsights(runId, projectId, gbpInsights, coveredLocationNames) {
     const covered = new Set(coveredLocationNames);
-    const existing = this.db.select({ id: insights.id, dismissed: insights.dismissed }).from(insights).where(and23(eq32(insights.projectId, projectId), eq32(insights.provider, GBP_INSIGHT_PROVIDER))).all();
+    const existing = this.db.select({ id: insights.id, dismissed: insights.dismissed }).from(insights).where(and24(eq33(insights.projectId, projectId), eq33(insights.provider, GBP_INSIGHT_PROVIDER))).all();
     const staleIds = [];
     const dismissedSlots = /* @__PURE__ */ new Set();
     for (const row of existing) {
@@ -32401,7 +32740,7 @@ var IntelligenceService = class {
     }
     this.db.transaction((tx) => {
       for (const id of staleIds) {
-        tx.delete(insights).where(eq32(insights.id, id)).run();
+        tx.delete(insights).where(eq33(insights.id, id)).run();
       }
       for (const insight of gbpInsights) {
         const parsed = parseGbpInsightId(insight.id);
@@ -32479,7 +32818,7 @@ var IntelligenceService = class {
    *     create per run + aggregate). DB is left untouched.
    */
   backfill(projectName, opts, onProgress) {
-    const project = this.db.select().from(projects).where(eq32(projects.name, projectName)).get();
+    const project = this.db.select().from(projects).where(eq33(projects.name, projectName)).get();
     if (!project) {
       throw new Error(`Project "${projectName}" not found`);
     }
@@ -32492,13 +32831,13 @@ var IntelligenceService = class {
       sinceTimestamp = parsed;
     }
     const allRuns = this.db.select().from(runs).where(
-      and23(
-        eq32(runs.projectId, project.id),
-        or5(eq32(runs.status, "completed"), eq32(runs.status, "partial")),
+      and24(
+        eq33(runs.projectId, project.id),
+        or5(eq33(runs.status, "completed"), eq33(runs.status, "partial")),
         // Backfill must not replay probe runs as if they were real sweeps.
         ne5(runs.trigger, RunTriggers.probe)
       )
-    ).orderBy(asc3(runs.finishedAt)).all();
+    ).orderBy(asc4(runs.finishedAt)).all();
     let startIdx = 0;
     let endIdx = allRuns.length;
     if (opts?.fromRunId) {
@@ -32527,7 +32866,7 @@ var IntelligenceService = class {
     let wouldDeleteTotal = 0;
     const existingByRunId = /* @__PURE__ */ new Map();
     if (isDryRun && targetRuns.length > 0) {
-      const rows = this.db.select({ runId: insights.runId }).from(insights).where(inArray11(insights.runId, targetRuns.map((r) => r.id))).all();
+      const rows = this.db.select({ runId: insights.runId }).from(insights).where(inArray12(insights.runId, targetRuns.map((r) => r.id))).all();
       for (const r of rows) {
         if (r.runId == null) continue;
         existingByRunId.set(r.runId, (existingByRunId.get(r.runId) ?? 0) + 1);
@@ -32573,7 +32912,7 @@ var IntelligenceService = class {
     return { processed, skipped, totalInsights };
   }
   loadTrackedCompetitors(projectId) {
-    return this.db.select({ domain: competitors.domain }).from(competitors).where(eq32(competitors.projectId, projectId)).all().map((r) => r.domain);
+    return this.db.select({ domain: competitors.domain }).from(competitors).where(eq33(competitors.projectId, projectId)).all().map((r) => r.domain);
   }
   /**
    * Wipe transition signals from an analysis result while keeping health.
@@ -32594,15 +32933,15 @@ var IntelligenceService = class {
   }
   persistResult(result, runId, projectId) {
     const previouslyDismissed = /* @__PURE__ */ new Set();
-    const existingInsights = this.db.select({ query: insights.query, provider: insights.provider, type: insights.type, dismissed: insights.dismissed }).from(insights).where(eq32(insights.runId, runId)).all();
+    const existingInsights = this.db.select({ query: insights.query, provider: insights.provider, type: insights.type, dismissed: insights.dismissed }).from(insights).where(eq33(insights.runId, runId)).all();
     for (const row of existingInsights) {
       if (row.dismissed) {
         previouslyDismissed.add(`${row.query}:${row.provider}:${row.type}`);
       }
     }
     this.db.transaction((tx) => {
-      tx.delete(insights).where(eq32(insights.runId, runId)).run();
-      tx.delete(healthSnapshots).where(eq32(healthSnapshots.runId, runId)).run();
+      tx.delete(insights).where(eq33(insights.runId, runId)).run();
+      tx.delete(healthSnapshots).where(eq33(healthSnapshots.runId, runId)).run();
       const now = (/* @__PURE__ */ new Date()).toISOString();
       for (const insight of result.insights) {
         const wasDismissed = previouslyDismissed.has(`${insight.query}:${insight.provider}:${insight.type}`);
@@ -32622,7 +32961,7 @@ var IntelligenceService = class {
         }).run();
       }
       tx.insert(healthSnapshots).values({
-        id: crypto27.randomUUID(),
+        id: crypto28.randomUUID(),
         projectId,
         runId,
         overallCitedRate: String(result.health.overallCitedRate),
@@ -32653,28 +32992,28 @@ var IntelligenceService = class {
   applySeverityTiering(rawInsights, excludeRunId, projectId) {
     const regressions = rawInsights.filter((i) => i.type === "regression");
     if (regressions.length === 0) return rawInsights;
-    const gscRows = this.db.select({ query: gscSearchData.query, impressions: gscSearchData.impressions }).from(gscSearchData).where(eq32(gscSearchData.projectId, projectId)).all();
+    const gscRows = this.db.select({ query: gscSearchData.query, impressions: gscSearchData.impressions }).from(gscSearchData).where(eq33(gscSearchData.projectId, projectId)).all();
     const gscConnected = gscRows.length > 0;
     const gscImpressionsByQuery = /* @__PURE__ */ new Map();
     for (const row of gscRows) {
       const key = row.query.toLowerCase();
       gscImpressionsByQuery.set(key, (gscImpressionsByQuery.get(key) ?? 0) + row.impressions);
     }
-    const projectRow = this.db.select({ locations: projects.locations }).from(projects).where(eq32(projects.id, projectId)).get();
+    const projectRow = this.db.select({ locations: projects.locations }).from(projects).where(eq33(projects.id, projectId)).get();
     const locationCount = Math.max(
       1,
       (projectRow?.locations ?? []).length
     );
     const ROWS_PER_GROUP_BUDGET = Math.max(2, locationCount);
     const recentRunRows = this.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(
-      and23(
-        eq32(runs.projectId, projectId),
-        eq32(runs.kind, RunKinds["answer-visibility"]),
-        or5(eq32(runs.status, "completed"), eq32(runs.status, "partial")),
+      and24(
+        eq33(runs.projectId, projectId),
+        eq33(runs.kind, RunKinds["answer-visibility"]),
+        or5(eq33(runs.status, "completed"), eq33(runs.status, "partial")),
         // Defensive — see top of file.
         ne5(runs.trigger, RunTriggers.probe)
       )
-    ).orderBy(desc16(runs.createdAt), desc16(runs.id)).limit((RECURRENCE_LOOKBACK_RUNS + 1) * ROWS_PER_GROUP_BUDGET).all();
+    ).orderBy(desc17(runs.createdAt), desc17(runs.id)).limit((RECURRENCE_LOOKBACK_RUNS + 1) * ROWS_PER_GROUP_BUDGET).all();
     const recentGroups = groupRunsByCreatedAt(recentRunRows);
     const recentRunIds = [];
     const recentRunIdToCreatedAt = /* @__PURE__ */ new Map();
@@ -32690,7 +33029,7 @@ var IntelligenceService = class {
     const haveHistory = recentRunIds.length > 0;
     const priorRegressionsByPair = /* @__PURE__ */ new Map();
     if (haveHistory) {
-      const priorRows = this.db.select({ query: insights.query, provider: insights.provider, runId: insights.runId }).from(insights).where(and23(eq32(insights.type, "regression"), inArray11(insights.runId, recentRunIds))).all();
+      const priorRows = this.db.select({ query: insights.query, provider: insights.provider, runId: insights.runId }).from(insights).where(and24(eq33(insights.type, "regression"), inArray12(insights.runId, recentRunIds))).all();
       const regressionGroups = /* @__PURE__ */ new Map();
       for (const row of priorRows) {
         if (!row.runId) continue;
@@ -32719,7 +33058,7 @@ var IntelligenceService = class {
     });
   }
   buildRunData(runId, projectId, completedAt, location = null) {
-    const projectDomainRow = this.db.select({ canonicalDomain: projects.canonicalDomain, ownedDomains: projects.ownedDomains }).from(projects).where(eq32(projects.id, projectId)).get();
+    const projectDomainRow = this.db.select({ canonicalDomain: projects.canonicalDomain, ownedDomains: projects.ownedDomains }).from(projects).where(eq33(projects.id, projectId)).get();
     const projectDomains = projectDomainRow ? effectiveDomains({
       canonicalDomain: projectDomainRow.canonicalDomain,
       ownedDomains: projectDomainRow.ownedDomains
@@ -32735,7 +33074,7 @@ var IntelligenceService = class {
       citedDomains: querySnapshots.citedDomains,
       competitorOverlap: querySnapshots.competitorOverlap,
       snapshotLocation: querySnapshots.location
-    }).from(querySnapshots).leftJoin(queries, eq32(querySnapshots.queryId, queries.id)).where(eq32(querySnapshots.runId, runId)).all();
+    }).from(querySnapshots).leftJoin(queries, eq33(querySnapshots.queryId, queries.id)).where(eq33(querySnapshots.runId, runId)).all();
     const snapshots = [];
     let orphanCount = 0;
     for (const r of rows) {
@@ -32786,6 +33125,8 @@ export {
   gscSearchData,
   gscUrlInspections,
   gscCoverageSnapshots,
+  siteAuditSnapshots,
+  siteAuditPages,
   bingCoverageSnapshots,
   bingUrlInspections,
   gaTrafficSnapshots,