@canonry/canonry 4.155.0 → 4.156.0

package/dist/{chunk-VOL2BSM5.js → chunk-ABNN2ZVR.js}

@@ -72,9 +72,23 @@ import {
   RunKinds,
   RunStatuses,
   RunTriggers,
+  SITE_CRAWL_GRAPH_DEFAULT_MAX_EDGES,
+  SITE_CRAWL_GRAPH_DEFAULT_MAX_NODES,
+  SITE_CRAWL_GRAPH_MAX_EDGES,
+  SITE_CRAWL_GRAPH_MAX_NODES,
+  SITE_HEALTH_CHANGES_DEFAULT_LIMIT,
+  SITE_HEALTH_CHANGES_MAX_LIMIT,
+  SITE_HEALTH_PATH_DEFAULT_MAX_DEPTH,
+  SITE_HEALTH_PATH_MAX_DEPTH,
+  SITE_HEALTH_PATH_MAX_VISITED_NODES,
+  SITE_HEALTH_SUBGRAPH_DEFAULT_MAX_EDGES,
+  SITE_HEALTH_SUBGRAPH_DEFAULT_MAX_NODES,
+  SITE_HEALTH_SUBGRAPH_MAX_EDGES,
+  SITE_HEALTH_SUBGRAPH_MAX_NODES,
   SKILL_MANIFEST_FILENAME,
   SchedulableRunKinds,
   SiteAuditTrendDirections,
+  SiteCrawlFetchedStates,
   TrafficEventConfidences,
   TrafficEventKinds,
   TrafficEvidenceKinds,
@@ -209,6 +223,7 @@ import {
   deltaPercent,
   deltaTone,
   deriveCitedUrlCandidates,
+  deriveSiteHealthState,
   deriveWinnabilityClass,
   determineAnswerMentioned,
   discoveryBucketSchema,
@@ -228,6 +243,7 @@ import {
   escapeLikePattern,
   evaluateModelPointerExposure,
   extractAnswerMentions,
+  factorStatusFromScore,
   filterBrandedSeedCandidates,
   filterCapturedCitedUrls,
   findDuplicateLocationLabels,
@@ -469,18 +485,26 @@ import {
   segmentCrawlerHits,
   serializeRunError,
   settingsDtoSchema,
+  siteAuditPageFactorSchema,
   siteAuditPagesResponseSchema,
   siteAuditRequestIdentity,
   siteAuditRunRequestSchema,
   siteAuditRunResponseSchema,
   siteAuditScoreSchema,
   siteAuditTrendResponseSchema,
+  siteCrawlAuditFactorSchema,
+  siteCrawlCriticalDefectSchema,
   siteCrawlDeadLinksResponseSchema,
+  siteCrawlGraphResponseSchema,
   siteCrawlInternalLinksResponseSchema,
   siteCrawlNeighborsResponseSchema,
+  siteCrawlPageAuditSchema,
   siteCrawlPagesResponseSchema,
   siteCrawlStructureResponseSchema,
   siteCrawlSummarySchema,
+  siteHealthChangesResponseSchema,
+  siteHealthPathResponseSchema,
+  siteHealthSubgraphResponseSchema,
   snapshotDiffResponseSchema,
   snapshotListResponseSchema,
   snapshotReportSchema,
@@ -529,7 +553,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-VIKPFI6F.js";
+} from "./chunk-AMPT2EP7.js";
 
 // src/intelligence-service.ts
 import { eq as eq57, desc as desc26, asc as asc11, and as and45, ne as ne7, or as or12, inArray as inArray20, gte as gte13, lte as lte10 } from "drizzle-orm";
@@ -627,6 +651,9 @@ __export(schema_exports, {
   siteCrawlEdges: () => siteCrawlEdges,
   siteCrawlEventReceipts: () => siteCrawlEventReceipts,
   siteCrawlFindings: () => siteCrawlFindings,
+  siteCrawlGraphEdges: () => siteCrawlGraphEdges,
+  siteCrawlGraphLayouts: () => siteCrawlGraphLayouts,
+  siteCrawlGraphNodes: () => siteCrawlGraphNodes,
   siteCrawlPages: () => siteCrawlPages,
   siteCrawlRunRequests: () => siteCrawlRunRequests,
   siteCrawlSnapshots: () => siteCrawlSnapshots,
@@ -1251,6 +1278,8 @@ var siteCrawlSnapshots = sqliteTable("site_crawl_snapshots", {
   runId: text("run_id").notNull(),
   attemptId: text("attempt_id"),
   rootUrl: text("root_url").notNull(),
+  /** Original requested crawl root; null for snapshots written before v128. */
+  requestedRootUrl: text("requested_root_url"),
   crawlSchemaVersion: text("crawl_schema_version").notNull().default("1.0"),
   engineVersion: text("engine_version").notNull().default(""),
   normalizationVersion: text("normalization_version").notNull().default(""),
@@ -1361,12 +1390,116 @@ var siteCrawlEdges = sqliteTable("site_crawl_edges", {
   index("idx_site_crawl_edges_inbound").on(table.projectId, table.runId, table.attemptId, table.targetNodeKey, table.edgeKey),
   index("idx_site_crawl_edges_source_url").on(table.projectId, table.runId, table.attemptId, table.sourceUrl),
   index("idx_site_crawl_edges_target_url").on(table.projectId, table.runId, table.attemptId, table.targetUrl),
+  // Publish-time graph sampling filters this exact scope and consumes the
+  // highest-occurrence internal anchors first. The mixed-direction suffix
+  // avoids a million-row temporary ORDER BY at the maximum crawl budget.
+  index("idx_site_crawl_edges_graph_sample").on(
+    table.projectId,
+    table.runId,
+    table.attemptId,
+    table.internal,
+    table.relation,
+    sql`${table.occurrences} desc`,
+    table.edgeKey
+  ),
   foreignKey({
     name: "site_crawl_edges_attempt_fk",
     columns: [table.projectId, table.runId, table.attemptId],
     foreignColumns: [siteCrawlAttempts.projectId, siteCrawlAttempts.runId, siteCrawlAttempts.id]
   }).onDelete("cascade")
 ]);
+var siteCrawlGraphLayouts = sqliteTable("site_crawl_graph_layouts", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  runId: text("run_id").notNull(),
+  attemptId: text("attempt_id").notNull(),
+  state: text("state").notNull(),
+  layoutVersion: text("layout_version"),
+  failureCode: text("failure_code"),
+  totalNodes: integer("total_nodes").notNull().default(0),
+  totalEdges: integer("total_edges").notNull().default(0),
+  nodeCount: integer("node_count").notNull().default(0),
+  edgeCount: integer("edge_count").notNull().default(0),
+  createdAt: text("created_at").notNull(),
+  updatedAt: text("updated_at").notNull()
+}, (table) => [
+  uniqueIndex("idx_site_crawl_graph_layouts_attempt").on(table.projectId, table.runId, table.attemptId),
+  index("idx_site_crawl_graph_layouts_run").on(table.projectId, table.runId),
+  check("site_crawl_graph_layouts_state_check", sql`${table.state} in ('ready', 'unavailable')`),
+  foreignKey({
+    name: "site_crawl_graph_layouts_attempt_fk",
+    columns: [table.projectId, table.runId, table.attemptId],
+    foreignColumns: [siteCrawlAttempts.projectId, siteCrawlAttempts.runId, siteCrawlAttempts.id]
+  }).onDelete("cascade")
+]);
+var siteCrawlGraphNodes = sqliteTable("site_crawl_graph_nodes", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  runId: text("run_id").notNull(),
+  attemptId: text("attempt_id").notNull(),
+  nodeKey: text("node_key").notNull(),
+  sampleRank: integer("sample_rank").notNull(),
+  x: real("x").notNull(),
+  y: real("y").notNull(),
+  createdAt: text("created_at").notNull()
+}, (table) => [
+  uniqueIndex("idx_site_crawl_graph_nodes_attempt_node").on(table.projectId, table.runId, table.attemptId, table.nodeKey),
+  uniqueIndex("idx_site_crawl_graph_nodes_attempt_rank").on(table.projectId, table.runId, table.attemptId, table.sampleRank),
+  index("idx_site_crawl_graph_nodes_read").on(table.projectId, table.runId, table.attemptId, table.sampleRank),
+  check("site_crawl_graph_nodes_rank_check", sql`${table.sampleRank} >= 0`),
+  foreignKey({
+    name: "site_crawl_graph_nodes_layout_fk",
+    columns: [table.projectId, table.runId, table.attemptId],
+    foreignColumns: [siteCrawlGraphLayouts.projectId, siteCrawlGraphLayouts.runId, siteCrawlGraphLayouts.attemptId]
+  }).onDelete("cascade"),
+  foreignKey({
+    name: "site_crawl_graph_nodes_page_fk",
+    columns: [table.projectId, table.runId, table.attemptId, table.nodeKey],
+    foreignColumns: [siteCrawlPages.projectId, siteCrawlPages.runId, siteCrawlPages.attemptId, siteCrawlPages.nodeKey]
+  }).onDelete("cascade")
+]);
+var siteCrawlGraphEdges = sqliteTable("site_crawl_graph_edges", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  runId: text("run_id").notNull(),
+  attemptId: text("attempt_id").notNull(),
+  edgeKey: text("edge_key").notNull(),
+  sampleRank: integer("sample_rank").notNull(),
+  sourceNodeKey: text("source_node_key").notNull(),
+  targetNodeKey: text("target_node_key").notNull(),
+  followable: integer("followable", { mode: "boolean" }).notNull(),
+  occurrences: integer("occurrences").notNull(),
+  createdAt: text("created_at").notNull()
+}, (table) => [
+  uniqueIndex("idx_site_crawl_graph_edges_attempt_edge").on(table.projectId, table.runId, table.attemptId, table.edgeKey),
+  uniqueIndex("idx_site_crawl_graph_edges_attempt_rank").on(table.projectId, table.runId, table.attemptId, table.sampleRank),
+  index("idx_site_crawl_graph_edges_read").on(table.projectId, table.runId, table.attemptId, table.sampleRank),
+  // These FKs otherwise make a layout cascade scan graph edges once per node.
+  index("idx_site_crawl_graph_edges_source_node").on(table.projectId, table.runId, table.attemptId, table.sourceNodeKey),
+  index("idx_site_crawl_graph_edges_target_node").on(table.projectId, table.runId, table.attemptId, table.targetNodeKey),
+  check("site_crawl_graph_edges_rank_check", sql`${table.sampleRank} >= 0`),
+  check("site_crawl_graph_edges_occurrences_check", sql`${table.occurrences} > 0`),
+  foreignKey({
+    name: "site_crawl_graph_edges_layout_fk",
+    columns: [table.projectId, table.runId, table.attemptId],
+    foreignColumns: [siteCrawlGraphLayouts.projectId, siteCrawlGraphLayouts.runId, siteCrawlGraphLayouts.attemptId]
+  }).onDelete("cascade"),
+  foreignKey({
+    name: "site_crawl_graph_edges_source_node_fk",
+    columns: [table.projectId, table.runId, table.attemptId, table.sourceNodeKey],
+    foreignColumns: [siteCrawlGraphNodes.projectId, siteCrawlGraphNodes.runId, siteCrawlGraphNodes.attemptId, siteCrawlGraphNodes.nodeKey]
+  }).onDelete("cascade"),
+  foreignKey({
+    name: "site_crawl_graph_edges_target_node_fk",
+    columns: [table.projectId, table.runId, table.attemptId, table.targetNodeKey],
+    foreignColumns: [siteCrawlGraphNodes.projectId, siteCrawlGraphNodes.runId, siteCrawlGraphNodes.attemptId, siteCrawlGraphNodes.nodeKey]
+  }).onDelete("cascade"),
+  foreignKey({
+    name: "site_crawl_graph_edges_canonical_edge_fk",
+    columns: [table.projectId, table.runId, table.attemptId, table.edgeKey],
+    foreignColumns: [siteCrawlEdges.projectId, siteCrawlEdges.runId, siteCrawlEdges.attemptId, siteCrawlEdges.edgeKey]
+  }).onDelete("cascade")
+]);
 var siteCrawlFindings = sqliteTable("site_crawl_findings", {
   id: text("id").primaryKey(),
   projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
@@ -5526,6 +5659,100 @@ var MIGRATION_VERSIONS = [
       `CREATE INDEX IF NOT EXISTS idx_site_crawl_receipts_project_run
         ON site_crawl_event_receipts(project_id, run_id, attempt_id)`
     ]
+  },
+  {
+    // Graph coordinates are optional derived snapshot data. Separate tables
+    // preserve the canonical crawl-page shape and make a missing row the
+    // truthful compatibility signal for snapshots published before v127.
+    version: 127,
+    name: "site-crawl-persisted-graph-layout",
+    statements: [
+      `CREATE TABLE IF NOT EXISTS site_crawl_graph_layouts (
+        id             TEXT PRIMARY KEY,
+        project_id     TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        run_id         TEXT NOT NULL,
+        attempt_id     TEXT NOT NULL,
+        state          TEXT NOT NULL CHECK (state IN ('ready', 'unavailable')),
+        layout_version TEXT,
+        failure_code   TEXT,
+        total_nodes    INTEGER NOT NULL DEFAULT 0,
+        total_edges    INTEGER NOT NULL DEFAULT 0,
+        node_count     INTEGER NOT NULL DEFAULT 0,
+        edge_count     INTEGER NOT NULL DEFAULT 0,
+        created_at     TEXT NOT NULL,
+        updated_at     TEXT NOT NULL,
+        FOREIGN KEY (project_id, run_id, attempt_id)
+          REFERENCES site_crawl_attempts(project_id, run_id, id) ON DELETE CASCADE
+      )`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_site_crawl_graph_layouts_attempt
+        ON site_crawl_graph_layouts(project_id, run_id, attempt_id)`,
+      `CREATE INDEX IF NOT EXISTS idx_site_crawl_graph_layouts_run
+        ON site_crawl_graph_layouts(project_id, run_id)`,
+      `CREATE INDEX IF NOT EXISTS idx_site_crawl_edges_graph_sample
+        ON site_crawl_edges(project_id, run_id, attempt_id, internal, relation, occurrences DESC, edge_key ASC)`,
+      `CREATE TABLE IF NOT EXISTS site_crawl_graph_nodes (
+        id          TEXT PRIMARY KEY,
+        project_id  TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        run_id      TEXT NOT NULL,
+        attempt_id  TEXT NOT NULL,
+        node_key    TEXT NOT NULL,
+        sample_rank INTEGER NOT NULL CHECK (sample_rank >= 0),
+        x           REAL NOT NULL,
+        y           REAL NOT NULL,
+        created_at  TEXT NOT NULL,
+        FOREIGN KEY (project_id, run_id, attempt_id)
+          REFERENCES site_crawl_graph_layouts(project_id, run_id, attempt_id) ON DELETE CASCADE,
+        FOREIGN KEY (project_id, run_id, attempt_id, node_key)
+          REFERENCES site_crawl_pages(project_id, run_id, attempt_id, node_key) ON DELETE CASCADE
+      )`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_site_crawl_graph_nodes_attempt_node
+        ON site_crawl_graph_nodes(project_id, run_id, attempt_id, node_key)`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_site_crawl_graph_nodes_attempt_rank
+        ON site_crawl_graph_nodes(project_id, run_id, attempt_id, sample_rank)`,
+      `CREATE INDEX IF NOT EXISTS idx_site_crawl_graph_nodes_read
+        ON site_crawl_graph_nodes(project_id, run_id, attempt_id, sample_rank)`,
+      `CREATE TABLE IF NOT EXISTS site_crawl_graph_edges (
+        id              TEXT PRIMARY KEY,
+        project_id      TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        run_id          TEXT NOT NULL,
+        attempt_id      TEXT NOT NULL,
+        edge_key        TEXT NOT NULL,
+        sample_rank     INTEGER NOT NULL CHECK (sample_rank >= 0),
+        source_node_key TEXT NOT NULL,
+        target_node_key TEXT NOT NULL,
+        followable      INTEGER NOT NULL,
+        occurrences     INTEGER NOT NULL CHECK (occurrences > 0),
+        created_at      TEXT NOT NULL,
+        FOREIGN KEY (project_id, run_id, attempt_id)
+          REFERENCES site_crawl_graph_layouts(project_id, run_id, attempt_id) ON DELETE CASCADE,
+        FOREIGN KEY (project_id, run_id, attempt_id, source_node_key)
+          REFERENCES site_crawl_graph_nodes(project_id, run_id, attempt_id, node_key) ON DELETE CASCADE,
+        FOREIGN KEY (project_id, run_id, attempt_id, target_node_key)
+          REFERENCES site_crawl_graph_nodes(project_id, run_id, attempt_id, node_key) ON DELETE CASCADE,
+        FOREIGN KEY (project_id, run_id, attempt_id, edge_key)
+          REFERENCES site_crawl_edges(project_id, run_id, attempt_id, edge_key) ON DELETE CASCADE
+      )`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_site_crawl_graph_edges_attempt_edge
+        ON site_crawl_graph_edges(project_id, run_id, attempt_id, edge_key)`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_site_crawl_graph_edges_attempt_rank
+        ON site_crawl_graph_edges(project_id, run_id, attempt_id, sample_rank)`,
+      `CREATE INDEX IF NOT EXISTS idx_site_crawl_graph_edges_read
+        ON site_crawl_graph_edges(project_id, run_id, attempt_id, sample_rank)`
+    ]
+  },
+  {
+    // Keep the operator-requested root beside the terminal root without
+    // rewriting immutable historical snapshots. The edge indexes make layout
+    // cleanup/cascades linear at the graph's 20k/50k publish cap.
+    version: 128,
+    name: "site-crawl-requested-root-and-graph-edge-cleanup-indexes",
+    statements: [
+      `ALTER TABLE site_crawl_snapshots ADD COLUMN requested_root_url TEXT`,
+      `CREATE INDEX IF NOT EXISTS idx_site_crawl_graph_edges_source_node
+        ON site_crawl_graph_edges(project_id, run_id, attempt_id, source_node_key)`,
+      `CREATE INDEX IF NOT EXISTS idx_site_crawl_graph_edges_target_node
+        ON site_crawl_graph_edges(project_id, run_id, attempt_id, target_node_key)`
+    ]
   }
 ];
 function addRunsMeasurementPlanVersionForeignKey(tx) {
@@ -7465,7 +7692,7 @@ function buildMentionShare(snapshots, options) {
     competitorCounts.set(competitor.domain, 0);
     competitorAliases.set(
       competitor.domain,
-      competitor.brandTokens.filter((alias) => brandKeyFromText(alias).length >= 3)
+      competitor.brandTokens.filter((alias2) => brandKeyFromText(alias2).length >= 3)
     );
   }
   for (const snap of snapshots) {
@@ -8398,7 +8625,7 @@ function isOverviewRead(url) {
 }
 function isTechnicalAeoRead(url) {
   const rest = projectRouteRest(url);
-  return rest === "technical-aeo" || rest === "technical-aeo/pages" || rest === "technical-aeo/trend" || rest === "technical-aeo/crawl" || rest === "technical-aeo/crawl/pages" || rest === "technical-aeo/structure" || rest === "technical-aeo/internal-links" || rest === "technical-aeo/internal-links/neighbors" || rest === "technical-aeo/dead-links";
+  return rest === "technical-aeo" || rest === "technical-aeo/pages" || rest === "technical-aeo/trend" || rest === "technical-aeo/crawl" || rest === "technical-aeo/graph" || rest === "technical-aeo/subgraph" || rest === "technical-aeo/path" || rest === "technical-aeo/changes" || rest === "technical-aeo/crawl/pages/audit" || rest === "technical-aeo/crawl/pages" || rest === "technical-aeo/structure" || rest === "technical-aeo/internal-links" || rest === "technical-aeo/internal-links/neighbors" || rest === "technical-aeo/dead-links";
 }
 function isReportRead(url) {
   const rest = projectRouteRest(url);
@@ -9766,9 +9993,9 @@ function aliasMatchesAt(textWords, aliasWords, start) {
 }
 function containsAnyAlias(answerText, aliases) {
   const textWords = words(answerText);
-  const candidates = aliases.map(words).filter((alias) => alias.length > 0);
+  const candidates = aliases.map(words).filter((alias2) => alias2.length > 0);
   for (let start = 0; start < textWords.length; start++) {
-    if (candidates.some((alias) => aliasMatchesAt(textWords, alias, start))) return true;
+    if (candidates.some((alias2) => aliasMatchesAt(textWords, alias2, start))) return true;
   }
   return false;
 }
@@ -9776,9 +10003,9 @@ function mentionedTargets(answerText, targets) {
   const result = /* @__PURE__ */ new Set();
   if (answerText === null) return result;
   const textWords = words(answerText);
-  const aliases = targets.flatMap((target) => target.aliases.map((alias) => ({ targetId: target.id, words: words(alias) }))).filter((alias) => alias.words.length > 0);
+  const aliases = targets.flatMap((target) => target.aliases.map((alias2) => ({ targetId: target.id, words: words(alias2) }))).filter((alias2) => alias2.words.length > 0);
   for (let start = 0; start < textWords.length; ) {
-    const matches = aliases.filter((alias) => aliasMatchesAt(textWords, alias.words, start));
+    const matches = aliases.filter((alias2) => aliasMatchesAt(textWords, alias2.words, start));
     if (matches.length === 0) {
       start++;
       continue;
@@ -9862,7 +10089,7 @@ function prepareReport(input) {
   }
   const answers = [];
   const mentionableIds = new Set(
-    input.targets.filter((target) => target.aliases.some((alias) => words(alias).length > 0)).map((target) => target.id)
+    input.targets.filter((target) => target.aliases.some((alias2) => words(alias2).length > 0)).map((target) => target.id)
   );
   for (const observation of observationsBySlot.values()) {
     const edges = [...edgesByExecution.get(observation.slot.executionId) ?? []].sort((left, right) => compareText(left.id, right.id));
@@ -9985,7 +10212,7 @@ function targetCoverageRate(targetIds, slots, edges, prepared) {
 }
 function mentionRate(target, slots, prepared) {
   const numerator = slots.filter((slot) => prepared.observationsBySlot.get(slot.id)?.mentionedTargetIds.has(target.id)).length;
-  if (target.aliases.every((alias) => words(alias).length === 0)) {
+  if (target.aliases.every((alias2) => words(alias2).length === 0)) {
     return { numerator: null, denominator: null, rate: null, reason: "aliasless" };
   }
   if (slots.length === 0) return { numerator: null, denominator: null, rate: null, reason: "no-population" };
@@ -10013,11 +10240,11 @@ function buildSovForSlots(slots, competitors2, projectBrandNames, projectDomain,
     let reason = null;
     if (selected.length === 0) reason = "no-population";
     else if (!status.complete || !status.answerComplete) reason = "incomplete";
-    else if (projectBrandNames.every((alias) => words(alias).length === 0)) reason = "no-project-aliases";
+    else if (projectBrandNames.every((alias2) => words(alias2).length === 0)) reason = "no-project-aliases";
     else if (sortedCompetitors.length === 0) reason = "no-competitors";
     return rows.map((row) => {
       if (reason !== null) return { domain: row.domain, own: row.own, presentIn: null, of: null, reason };
-      if (row.aliases.every((alias) => words(alias).length === 0)) {
+      if (row.aliases.every((alias2) => words(alias2).length === 0)) {
         return { domain: row.domain, own: row.own, presentIn: null, of: null, reason: "aliasless" };
       }
       const presentIn = selected.filter((slot) => {
@@ -10167,7 +10394,7 @@ function mentionedForEdge(observation, edge, mentionableIds) {
   return observation.mentionedTargetIds.has(edge.targetId);
 }
 function mentionableTargets(input, targetIds) {
-  return input.targets.filter((target) => targetIds.has(target.id) && target.aliases.some((alias) => words(alias).length > 0));
+  return input.targets.filter((target) => targetIds.has(target.id) && target.aliases.some((alias2) => words(alias2).length > 0));
 }
 function scopeMentionRate(input, targetIds, slots, answered, prepared) {
   const mentionable = mentionableTargets(input, targetIds);
@@ -10193,7 +10420,7 @@ function indexedScopeCitationRate(slots, edges, indexes) {
   return { numerator, denominator: basis.length, rate: numerator / basis.length };
 }
 function targetMentionRate(targets, slots, answered, indexes) {
-  const mentionable = targets?.filter((target) => target.aliases.some((alias) => words(alias).length > 0)) ?? [];
+  const mentionable = targets?.filter((target) => target.aliases.some((alias2) => words(alias2).length > 0)) ?? [];
   if (mentionable.length === 0) return unavailable("aliasless");
   if (slots.length === 0) return unavailable("no-population");
   if (answered.length === 0) return unavailable("evidence-incomplete");
@@ -10209,7 +10436,7 @@ function presenceIn(slots, aliases, prepared) {
 }
 function scopeBrandPresence(input, slots, answered, prepared) {
   if (slots.length === 0) return unavailable("no-population");
-  if (input.projectBrandNames.every((alias) => words(alias).length === 0)) return unavailable("no-project-aliases");
+  if (input.projectBrandNames.every((alias2) => words(alias2).length === 0)) return unavailable("no-project-aliases");
   if (answered.length === 0) return unavailable("evidence-incomplete");
   const numerator = presenceIn(answered, input.projectBrandNames, prepared);
   return { numerator, denominator: answered.length, rate: numerator / answered.length };
@@ -10508,8 +10735,8 @@ function reportInput(revision, plan, manifest, snapshots, legacy) {
       label: group.label,
       targetIds: group.targetKeys,
       competitors: (group.competitors ?? []).map((domain) => {
-        const alias = brandLabelFromDomain(domain);
-        return { domain, aliases: brandKeyFromText(alias).length >= 4 ? [alias] : [] };
+        const alias2 = brandLabelFromDomain(domain);
+        return { domain, aliases: brandKeyFromText(alias2).length >= 4 ? [alias2] : [] };
       })
     })),
     expectedSlots: slots,
@@ -12029,7 +12256,7 @@ function compileRules(input) {
   const aliases = (input.rules.aliases ?? []).map(
     (rule, index2) => compileRouteRule(rule, `rules.aliases[${index2}]`, ownedHosts)
   );
-  if (aliases.some((alias) => alias.host === primary.host)) {
+  if (aliases.some((alias2) => alias2.host === primary.host)) {
     throw new MeasurementDiscoveryConfigurationError("alias rules must use another owned host");
   }
   const excludedSlugSuffixes = sortedUnique3(
@@ -12947,14 +13174,14 @@ function compileMeasurementDraft(authoring, context) {
       matcherClaims.set(identity, target.stableKey);
       matchers.push(matcher);
     });
-    target.aliases.forEach((alias, aliasIndex) => {
-      const identity = measurementMentionAliasKey(alias);
+    target.aliases.forEach((alias2, aliasIndex) => {
+      const identity = measurementMentionAliasKey(alias2);
       if (!identity) return;
       const claimedBy = aliasClaims.get(identity);
       if (claimedBy !== void 0 && claimedBy !== target.stableKey) {
         sink.fail(
           "target-alias-ambiguous",
-          `Target alias normalizes to the same mention identity claimed by Target ${claimedBy}: ${alias}`,
+          `Target alias normalizes to the same mention identity claimed by Target ${claimedBy}: ${alias2}`,
           ["targets", targetIndex, "aliases", aliasIndex]
         );
         return;
@@ -27123,11 +27350,16 @@ var SCHEMA_TABLE = {
   SiteAuditScoreDto: siteAuditScoreSchema,
   SiteAuditTrendResponseDto: siteAuditTrendResponseSchema,
   SiteCrawlDeadLinksResponseDto: siteCrawlDeadLinksResponseSchema,
+  SiteCrawlGraphResponseDto: siteCrawlGraphResponseSchema,
   SiteCrawlInternalLinksResponseDto: siteCrawlInternalLinksResponseSchema,
   SiteCrawlNeighborsResponseDto: siteCrawlNeighborsResponseSchema,
+  SiteCrawlPageAuditDto: siteCrawlPageAuditSchema,
   SiteCrawlPagesResponseDto: siteCrawlPagesResponseSchema,
   SiteCrawlStructureResponseDto: siteCrawlStructureResponseSchema,
   SiteCrawlSummaryDto: siteCrawlSummarySchema,
+  SiteHealthChangesResponseDto: siteHealthChangesResponseSchema,
+  SiteHealthPathResponseDto: siteHealthPathResponseSchema,
+  SiteHealthSubgraphResponseDto: siteHealthSubgraphResponseSchema,
   SnapshotDiffResponse: snapshotDiffResponseSchema,
   SnapshotListResponse: snapshotListResponseSchema,
   SnapshotReportDto: snapshotReportSchema,
@@ -33062,6 +33294,103 @@ var routeCatalog = [
       404: errorResponse("Project or crawl-bearing site-audit run not found.")
     }
   },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/technical-aeo/graph",
+    summary: "Get a persisted Site Health graph projection",
+    description: "Returns the deterministic graph projection computed once when the latest complete or selected historical crawl was published. ForceAtlas2 positions and the exact internal-anchor edge sample are persisted, so reads run no layout physics and never rescan the crawl edge table. The response is bounded to 20,000 nodes / 50,000 edges; `layout`, `omittedNodes`, `omittedEdges`, and `sampled` disclose legacy/unavailable layouts and intentional truncation.",
+    tags: ["technical-aeo"],
+    parameters: [
+      nameParameter,
+      { name: "runId", in: "query", description: "Historical site-audit run ID. Omit for the latest complete crawl.", schema: stringSchema },
+      { name: "maxNodes", in: "query", description: "Maximum graph nodes. Defaults to and is capped at 20,000.", schema: { type: "integer", minimum: 1, maximum: 2e4 } },
+      { name: "maxEdges", in: "query", description: "Maximum graph edges. Defaults to and is capped at 50,000.", schema: { type: "integer", minimum: 1, maximum: 5e4 } }
+    ],
+    responses: {
+      200: jsonResponse("Bounded Site Health graph projection returned.", "SiteCrawlGraphResponseDto"),
+      404: errorResponse("Project or crawl-bearing site-audit run not found.")
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/technical-aeo/subgraph",
+    summary: "Get a bounded canonical Site Health neighborhood",
+    description: "Agent-oriented canonical crawl neighborhood around one page. Reads full crawl page/link rows rather than the sampled visualization, excludes layout coordinates, and returns snapshot completeness/termination. When a hard bound is reached, countAccuracy=lower-bound makes totalNodes, totalEdges, omittedNodes, and omittedEdges explicit minimums rather than false exact totals.",
+    tags: ["technical-aeo"],
+    parameters: [
+      nameParameter,
+      { name: "runId", in: "query", description: "Historical site-audit run ID. Omit for the latest complete crawl.", schema: stringSchema },
+      { name: "nodeKey", in: "query", description: "Focus page canonical node key. Omit nodeKey and url to use the crawl root.", schema: stringSchema },
+      { name: "url", in: "query", description: "Focus page canonical URL. Omit nodeKey and url to use the crawl root.", schema: stringSchema },
+      { name: "hops", in: "query", description: "Undirected neighborhood radius. Defaults to 1; maximum 3.", schema: { type: "integer", minimum: 0, maximum: 3 } },
+      { name: "maxNodes", in: "query", description: "Maximum canonical nodes. Defaults to 25; maximum 200.", schema: { type: "integer", minimum: 1, maximum: 200 } },
+      { name: "maxEdges", in: "query", description: "Maximum canonical edges. Defaults to 50; maximum 500.", schema: { type: "integer", minimum: 1, maximum: 500 } }
+    ],
+    responses: {
+      200: jsonResponse("Bounded canonical Site Health neighborhood returned.", "SiteHealthSubgraphResponseDto"),
+      404: errorResponse("Project, crawl-bearing run, or focus page not found.")
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/technical-aeo/path",
+    summary: "Find a directed internal-link path between pages",
+    description: "Returns the shortest directed path over followable internal anchor links. The source defaults to the crawl root; the target must be identified by toNodeKey or toUrl. Exploration is bounded to 5,000 nodes and returns an explicit unreachable or truncated state. Snapshot complete and termination provenance prevents an unreachable result from a selected partial crawl being mistaken for a site-wide claim.",
+    tags: ["technical-aeo"],
+    parameters: [
+      nameParameter,
+      { name: "runId", in: "query", description: "Historical site-audit run ID. Omit for the latest complete crawl.", schema: stringSchema },
+      { name: "fromNodeKey", in: "query", description: "Source canonical node key. Omit both source selectors to start at the crawl root.", schema: stringSchema },
+      { name: "fromUrl", in: "query", description: "Source canonical URL. Omit both source selectors to start at the crawl root.", schema: stringSchema },
+      { name: "toNodeKey", in: "query", description: "Target canonical node key. Required when toUrl is omitted.", schema: stringSchema },
+      { name: "toUrl", in: "query", description: "Target canonical URL. Required when toNodeKey is omitted.", schema: stringSchema },
+      { name: "maxDepth", in: "query", description: "Maximum directed link depth. Defaults to 12; maximum 24.", schema: { type: "integer", minimum: 1, maximum: 24 } }
+    ],
+    responses: {
+      200: jsonResponse("Directed internal-link path result returned.", "SiteHealthPathResponseDto"),
+      400: errorResponse("A target selector is required."),
+      404: errorResponse("Project, crawl-bearing run, source page, or target page not found.")
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/technical-aeo/changes",
+    summary: "Compare canonical Site Health snapshots",
+    description: "Returns exact page and internal-link additions, removals, and semantic field changes between immutable complete crawl snapshots. Omitted toRunId selects the latest complete crawl; omitted fromRunId selects the complete crawl immediately before the target. ForceAtlas2 positions are presentation data and never count as a change. The first page includes exact post-filter summary counts; cursor pages set summary and total to null so they never repeat full snapshot joins or trust caller-carried counts. Results use a snapshot- and filter-bound keyset cursor.",
+    tags: ["technical-aeo"],
+    parameters: [
+      nameParameter,
+      { name: "fromRunId", in: "query", description: "Baseline complete crawl. Omit for the complete crawl immediately before the target.", schema: stringSchema },
+      { name: "toRunId", in: "query", description: "Target complete crawl. Omit for the latest complete crawl.", schema: stringSchema },
+      { name: "scope", in: "query", description: "Restrict records and first-page summary counts to pages, links, or both.", schema: { type: "string", enum: ["all", "pages", "links"], default: "all" } },
+      { name: "change", in: "query", description: "Restrict records and first-page summary counts to one change kind.", schema: { type: "string", enum: ["all", "added", "removed", "changed"], default: "all" } },
+      { name: "cursor", in: "query", description: "Opaque keyset cursor bound to both run IDs and the selected filters.", schema: stringSchema },
+      { name: "limit", in: "query", description: "Maximum change records. Defaults to 25; maximum 100.", schema: { type: "integer", minimum: 1, maximum: 100 } }
+    ],
+    responses: {
+      200: jsonResponse("Canonical Site Health snapshot comparison returned.", "SiteHealthChangesResponseDto"),
+      400: errorResponse("Invalid filters, run direction, or cursor context."),
+      404: errorResponse("Project or selected crawl-bearing run not found.")
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/technical-aeo/crawl/pages/audit",
+    summary: "Get exact audit evidence for one persisted crawl page",
+    description: "Returns one page score with the exact weighted-factor findings, recommendations, applicability, and independent critical defects persisted for the selected crawl. Exactly one of nodeKey or url is required. The discriminated state preserves crawl completeness and termination provenance, distinguishes a page that was not audited from one that was not found, and marks legacy score-only rows without fabricating missing evidence. This one-page read keeps verbose evidence out of the bounded interactive graph projection.",
+    tags: ["technical-aeo"],
+    parameters: [
+      nameParameter,
+      { name: "runId", in: "query", description: "Historical site-audit run ID. Omit for the latest complete crawl.", schema: stringSchema },
+      { name: "nodeKey", in: "query", description: "Exact canonical crawl node key. Required when url is omitted.", schema: stringSchema },
+      { name: "url", in: "query", description: "Exact persisted crawl URL. Required when nodeKey is omitted.", schema: stringSchema }
+    ],
+    responses: {
+      200: jsonResponse("Page audit evidence state returned.", "SiteCrawlPageAuditDto"),
+      400: errorResponse("Exactly one page selector is required."),
+      404: errorResponse("Project or explicitly selected crawl-bearing run not found.")
+    }
+  },
   {
     method: "get",
     path: "/api/v1/projects/{name}/technical-aeo/crawl/pages",
@@ -46482,7 +46811,7 @@ async function queryBacklinks(opts) {
   const reversed = opts.targets.map(reverseDomain);
   const targetList = reversed.map(quote).join(", ");
   const limitClause = opts.limitPerTarget ? `QUALIFY row_number() OVER (PARTITION BY t.target_rev_domain ORDER BY v.num_hosts DESC) <= ${Math.floor(opts.limitPerTarget)}` : "";
-  const sql20 = `
+  const sql21 = `
     WITH vertices AS (
       SELECT * FROM read_csv(
         ${quote(opts.vertexPath)},
@@ -46518,7 +46847,7 @@ async function queryBacklinks(opts) {
   const conn = await instance.connect();
   let rows;
   try {
-    const reader = await conn.runAndReadAll(sql20);
+    const reader = await conn.runAndReadAll(sql21);
     rows = reader.getRowObjects();
   } finally {
     conn.disconnectSync?.();
@@ -55385,7 +55714,15 @@ function dedupeStrings(input) {
 
 // ../api-routes/src/technical-aeo.ts
 import crypto43 from "crypto";
-import { and as and43, asc as asc10, count, desc as desc24, eq as eq55, inArray as inArray19, lt as lt7, or as or11 } from "drizzle-orm";
+import { and as and43, asc as asc10, count, desc as desc24, eq as eq55, inArray as inArray19, isNotNull as isNotNull3, lt as lt7, or as or11, sql as sql20 } from "drizzle-orm";
+import { alias } from "drizzle-orm/sqlite-core";
+var FETCHED_SITE_CRAWL_STATES = /* @__PURE__ */ new Set([
+  ...SiteCrawlFetchedStates,
+  // Snapshots published before the full-crawl contract used this aggregate
+  // state. Keep historical structure counts truthful without admitting it to
+  // the current crawler vocabulary.
+  "fetched"
+]);
 var SURFACEABLE_STATUSES = [RunStatuses.completed, RunStatuses.partial];
 function emptyScore(projectName) {
   return {
@@ -55478,7 +55815,32 @@ function mapCrawlPage(row) {
     inboundOccurrences: row.inboundOccurrences,
     outboundOccurrences: row.outboundOccurrences,
     linkScoreRaw: row.linkScoreRaw,
-    linkScoreNormalized: row.linkScoreNormalized
+    linkScoreNormalized: row.linkScoreNormalized,
+    healthState: deriveSiteHealthState(row)
+  };
+}
+function mapCrawlPageAuditEvidence(row) {
+  const fields = row.auditFields;
+  const rawFactors = Array.isArray(fields.factors) ? fields.factors : [];
+  const rawCriticalDefects = Array.isArray(fields.criticalDefects) ? fields.criticalDefects : [];
+  const parsedFactors = rawFactors.map((factor) => siteCrawlAuditFactorSchema.safeParse(factor));
+  const parsedCriticalDefects = rawCriticalDefects.map((defect) => siteCrawlCriticalDefectSchema.safeParse(defect));
+  const complete = fields.schemaVersion === "1.0" && Array.isArray(fields.factors) && Array.isArray(fields.criticalDefects) && parsedFactors.every((result) => result.success) && parsedCriticalDefects.every((result) => result.success);
+  const factors = parsedFactors.flatMap((result, index2) => {
+    if (result.success) return [result.data];
+    const legacy = siteAuditPageFactorSchema.safeParse(rawFactors[index2]);
+    return legacy.success ? [{
+      ...legacy.data,
+      status: factorStatusFromScore(legacy.data.score),
+      applicable: null,
+      findings: [],
+      recommendations: []
+    }] : [];
+  });
+  return {
+    evidenceState: complete ? "complete" : "scores-only",
+    factors,
+    criticalDefects: parsedCriticalDefects.flatMap((result) => result.success ? [result.data] : [])
   };
 }
 function mapCrawlEdge(row) {
@@ -55497,6 +55859,105 @@ function mapCrawlEdge(row) {
     anchors: row.anchors
   };
 }
+var graphSourceNode = alias(siteCrawlGraphNodes, "site_crawl_graph_source_node");
+var graphTargetNode = alias(siteCrawlGraphNodes, "site_crawl_graph_target_node");
+var PAGE_CHANGE_PREDICATE = sql20`(
+  current.url IS NOT previous.url
+  OR current.final_url IS NOT previous.final_url
+  OR current.path IS NOT previous.path
+  OR current.parent_path IS NOT previous.parent_path
+  OR current.discovery_source IS NOT previous.discovery_source
+  OR current.fetch_state IS NOT previous.fetch_state
+  OR current.http_status IS NOT previous.http_status
+  OR current.canonical_url IS NOT previous.canonical_url
+  OR current.indexability_state IS NOT previous.indexability_state
+  OR current.indexability_reasons IS NOT previous.indexability_reasons
+  OR current.audit_state IS NOT previous.audit_state
+  OR current.audit_score IS NOT previous.audit_score
+  OR current.inventory_eligible IS NOT previous.inventory_eligible
+  OR current.depth IS NOT previous.depth
+  OR current.inbound_unique_edges IS NOT previous.inbound_unique_edges
+  OR current.outbound_unique_edges IS NOT previous.outbound_unique_edges
+  OR current.inbound_occurrences IS NOT previous.inbound_occurrences
+  OR current.outbound_occurrences IS NOT previous.outbound_occurrences
+  OR current.link_score_raw IS NOT previous.link_score_raw
+  OR current.link_score_normalized IS NOT previous.link_score_normalized
+)`;
+var LINK_CHANGE_PREDICATE = sql20`(
+  current.source_node_key IS NOT previous.source_node_key
+  OR current.source_url IS NOT previous.source_url
+  OR current.target_node_key IS NOT previous.target_node_key
+  OR current.target_url IS NOT previous.target_url
+  OR current.relation IS NOT previous.relation
+  OR current.followable IS NOT previous.followable
+  OR current.occurrences IS NOT previous.occurrences
+  OR current.followable_occurrences IS NOT previous.followable_occurrences
+  OR current.nofollow_occurrences IS NOT previous.nofollow_occurrences
+  OR current.anchors IS NOT previous.anchors
+)`;
+function encodeSiteHealthChangesCursor(cursor) {
+  return Buffer.from(JSON.stringify(cursor)).toString("base64url");
+}
+function decodeSiteHealthChangesCursor(value, context) {
+  if (value == null || value === "") return null;
+  if (typeof value !== "string" || value.length > 2048) throw validationError("Invalid Site Health changes cursor");
+  try {
+    const parsed = JSON.parse(Buffer.from(value, "base64url").toString("utf8"));
+    const valid = parsed.v === 1 && parsed.fromRunId === context.fromRunId && parsed.toRunId === context.toRunId && parsed.scope === context.scope && parsed.change === context.change && (parsed.entity === "page" || parsed.entity === "link") && typeof parsed.key === "string" && parsed.key.length > 0 && parsed.key.length <= 2048;
+    if (!valid) throw new Error("context mismatch");
+    return parsed;
+  } catch {
+    throw validationError("Site Health changes cursor does not match this snapshot comparison and filter");
+  }
+}
+function compareChangeKeys(left, right) {
+  return Buffer.compare(Buffer.from(left.key), Buffer.from(right.key));
+}
+function valueChanged(before, after) {
+  if (Array.isArray(before) || Array.isArray(after) || before && typeof before === "object" || after && typeof after === "object") {
+    return JSON.stringify(before) !== JSON.stringify(after);
+  }
+  return before !== after;
+}
+var PAGE_CHANGE_FIELDS = [
+  "url",
+  "finalUrl",
+  "path",
+  "parentPath",
+  "discoverySource",
+  "fetchState",
+  "httpStatus",
+  "canonicalUrl",
+  "indexabilityState",
+  "indexabilityReasons",
+  "auditState",
+  "auditScore",
+  "inventoryEligible",
+  "depth",
+  "inboundUniqueEdges",
+  "outboundUniqueEdges",
+  "inboundOccurrences",
+  "outboundOccurrences",
+  "linkScoreRaw",
+  "linkScoreNormalized"
+];
+var LINK_CHANGE_FIELDS = [
+  "sourceNodeKey",
+  "sourceUrl",
+  "targetNodeKey",
+  "targetUrl",
+  "relation",
+  "internal",
+  "followable",
+  "occurrences",
+  "followableOccurrences",
+  "nofollowOccurrences",
+  "anchors"
+];
+function changedFields(before, after, fields) {
+  if (!before || !after) return [];
+  return fields.filter((field) => valueChanged(before[field], after[field])).map(String);
+}
 async function technicalAeoRoutes(app, opts) {
   const resolveCrawl = (projectId, runId) => {
     const filters = [
@@ -55511,8 +55972,24 @@ async function technicalAeoRoutes(app, opts) {
     } else {
       filters.push(eq55(siteCrawlSnapshots.complete, true), eq55(runs.status, RunStatuses.completed));
     }
-    return app.db.select({ snapshot: siteCrawlSnapshots, runStatus: runs.status }).from(siteCrawlSnapshots).innerJoin(runs, eq55(siteCrawlSnapshots.runId, runs.id)).where(and43(...filters)).orderBy(desc24(siteCrawlSnapshots.createdAt)).limit(1).get();
-  };
+    return app.db.select({ snapshot: siteCrawlSnapshots, runStatus: runs.status }).from(siteCrawlSnapshots).innerJoin(runs, eq55(siteCrawlSnapshots.runId, runs.id)).where(and43(...filters)).orderBy(desc24(siteCrawlSnapshots.createdAt), desc24(siteCrawlSnapshots.runId)).limit(1).get();
+  };
+  const detailScopeFor = (projectId, snapshot) => snapshot.detailsAvailable && snapshot.attemptId ? { projectId, runId: snapshot.runId, attemptId: snapshot.attemptId } : null;
+  const pageInScope = (scope, selector) => {
+    if (!selector.nodeKey && !selector.url) return null;
+    return app.db.select().from(siteCrawlPages).where(and43(
+      eq55(siteCrawlPages.projectId, scope.projectId),
+      eq55(siteCrawlPages.runId, scope.runId),
+      eq55(siteCrawlPages.attemptId, scope.attemptId),
+      selector.nodeKey ? eq55(siteCrawlPages.nodeKey, selector.nodeKey) : eq55(siteCrawlPages.url, selector.url)
+    )).orderBy(asc10(siteCrawlPages.nodeKey)).limit(1).get() ?? null;
+  };
+  const rootPageInScope = (scope, rootUrl) => pageInScope(scope, { url: rootUrl }) ?? app.db.select().from(siteCrawlPages).where(and43(
+    eq55(siteCrawlPages.projectId, scope.projectId),
+    eq55(siteCrawlPages.runId, scope.runId),
+    eq55(siteCrawlPages.attemptId, scope.attemptId),
+    eq55(siteCrawlPages.depth, 0)
+  )).orderBy(asc10(siteCrawlPages.nodeKey)).limit(1).get() ?? null;
   const hasLegacyAudit = (projectId) => Boolean(app.db.select({ runId: siteAuditSnapshots.runId }).from(siteAuditSnapshots).innerJoin(runs, eq55(siteAuditSnapshots.runId, runs.id)).where(and43(
     eq55(siteAuditSnapshots.projectId, projectId),
     eq55(runs.projectId, projectId),
@@ -55526,6 +56003,7 @@ async function technicalAeoRoutes(app, opts) {
     legacyAuditAvailable,
     runId: null,
     runStatus: null,
+    requestedRootUrl: null,
     rootUrl: null,
     effectiveOptions: {},
     complete: false,
@@ -55643,6 +56121,7 @@ async function technicalAeoRoutes(app, opts) {
       legacyAuditAvailable,
       runId: snapshot.runId,
       runStatus: target.runStatus,
+      requestedRootUrl: snapshot.requestedRootUrl,
       rootUrl: snapshot.rootUrl,
       crawlSchemaVersion: snapshot.crawlSchemaVersion,
       engineVersion: snapshot.engineVersion,
@@ -55663,6 +56142,827 @@ async function technicalAeoRoutes(app, opts) {
       deadLinks
     };
   });
+  app.get("/projects/:name/technical-aeo/graph", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const target = resolveCrawl(project.id, request.query.runId);
+    if (!target) {
+      if (request.query.runId) throw notFound("Site crawl run", request.query.runId);
+      return {
+        project: project.name,
+        hasCrawlData: false,
+        runId: null,
+        layout: { state: "unavailable", version: null, reason: "no-crawl" },
+        totalNodes: 0,
+        totalEdges: 0,
+        nodes: [],
+        edges: [],
+        omittedNodes: 0,
+        omittedEdges: 0,
+        sampled: false
+      };
+    }
+    const snapshot = target.snapshot;
+    if (!snapshot.detailsAvailable || !snapshot.attemptId) {
+      return {
+        project: project.name,
+        hasCrawlData: true,
+        runId: snapshot.runId,
+        layout: { state: "unavailable", version: null, reason: "details-unavailable" },
+        totalNodes: 0,
+        totalEdges: 0,
+        nodes: [],
+        edges: [],
+        omittedNodes: 0,
+        omittedEdges: 0,
+        sampled: false
+      };
+    }
+    const persistedLayout = app.db.select().from(siteCrawlGraphLayouts).where(and43(
+      eq55(siteCrawlGraphLayouts.projectId, project.id),
+      eq55(siteCrawlGraphLayouts.runId, snapshot.runId),
+      eq55(siteCrawlGraphLayouts.attemptId, snapshot.attemptId)
+    )).limit(1).get();
+    if (!persistedLayout) {
+      return {
+        project: project.name,
+        hasCrawlData: true,
+        runId: snapshot.runId,
+        layout: { state: "unavailable", version: null, reason: "legacy-snapshot" },
+        totalNodes: 0,
+        totalEdges: 0,
+        nodes: [],
+        edges: [],
+        omittedNodes: 0,
+        omittedEdges: 0,
+        sampled: false
+      };
+    }
+    if (persistedLayout.state !== "ready" || !persistedLayout.layoutVersion) {
+      const totalNodes2 = persistedLayout.totalNodes;
+      const totalEdges2 = persistedLayout.totalEdges;
+      return {
+        project: project.name,
+        hasCrawlData: true,
+        runId: snapshot.runId,
+        layout: {
+          state: "unavailable",
+          version: null,
+          reason: persistedLayout.failureCode === "empty-crawl" ? "empty-crawl" : "layout-failed"
+        },
+        totalNodes: totalNodes2,
+        totalEdges: totalEdges2,
+        nodes: [],
+        edges: [],
+        omittedNodes: totalNodes2,
+        omittedEdges: totalEdges2,
+        sampled: totalNodes2 > 0 || totalEdges2 > 0
+      };
+    }
+    const maxNodes = parseBoundedLimit(request.query.maxNodes, SITE_CRAWL_GRAPH_DEFAULT_MAX_NODES, SITE_CRAWL_GRAPH_MAX_NODES);
+    const maxEdges = parseBoundedLimit(request.query.maxEdges, SITE_CRAWL_GRAPH_DEFAULT_MAX_EDGES, SITE_CRAWL_GRAPH_MAX_EDGES);
+    const graphScope = [
+      eq55(siteCrawlGraphNodes.projectId, project.id),
+      eq55(siteCrawlGraphNodes.runId, snapshot.runId),
+      eq55(siteCrawlGraphNodes.attemptId, snapshot.attemptId)
+    ];
+    const nodeRows = app.db.select({
+      nodeKey: siteCrawlPages.nodeKey,
+      url: siteCrawlPages.url,
+      path: siteCrawlPages.path,
+      depth: siteCrawlPages.depth,
+      indexabilityState: siteCrawlPages.indexabilityState,
+      indexabilityReasons: siteCrawlPages.indexabilityReasons,
+      canonicalNodeKey: siteCrawlPages.canonicalNodeKey,
+      fetchState: siteCrawlPages.fetchState,
+      auditState: siteCrawlPages.auditState,
+      auditScore: siteCrawlPages.auditScore,
+      inventoryEligible: siteCrawlPages.inventoryEligible,
+      inboundUniqueEdges: siteCrawlPages.inboundUniqueEdges,
+      outboundUniqueEdges: siteCrawlPages.outboundUniqueEdges,
+      linkScoreNormalized: siteCrawlPages.linkScoreNormalized,
+      x: siteCrawlGraphNodes.x,
+      y: siteCrawlGraphNodes.y
+    }).from(siteCrawlGraphNodes).innerJoin(siteCrawlPages, and43(
+      eq55(siteCrawlPages.projectId, siteCrawlGraphNodes.projectId),
+      eq55(siteCrawlPages.runId, siteCrawlGraphNodes.runId),
+      eq55(siteCrawlPages.attemptId, siteCrawlGraphNodes.attemptId),
+      eq55(siteCrawlPages.nodeKey, siteCrawlGraphNodes.nodeKey)
+    )).where(and43(...graphScope, lt7(siteCrawlGraphNodes.sampleRank, maxNodes))).orderBy(asc10(siteCrawlGraphNodes.sampleRank)).all();
+    const nodes = nodeRows.map(({ indexabilityReasons, canonicalNodeKey, ...row }) => ({
+      ...row,
+      healthState: deriveSiteHealthState({ ...row, indexabilityReasons, canonicalNodeKey })
+    }));
+    const edges = app.db.select({
+      edgeKey: siteCrawlGraphEdges.edgeKey,
+      sourceNodeKey: siteCrawlGraphEdges.sourceNodeKey,
+      targetNodeKey: siteCrawlGraphEdges.targetNodeKey,
+      followable: siteCrawlGraphEdges.followable,
+      occurrences: siteCrawlGraphEdges.occurrences
+    }).from(siteCrawlGraphEdges).innerJoin(graphSourceNode, and43(
+      eq55(graphSourceNode.projectId, siteCrawlGraphEdges.projectId),
+      eq55(graphSourceNode.runId, siteCrawlGraphEdges.runId),
+      eq55(graphSourceNode.attemptId, siteCrawlGraphEdges.attemptId),
+      eq55(graphSourceNode.nodeKey, siteCrawlGraphEdges.sourceNodeKey),
+      lt7(graphSourceNode.sampleRank, maxNodes)
+    )).innerJoin(graphTargetNode, and43(
+      eq55(graphTargetNode.projectId, siteCrawlGraphEdges.projectId),
+      eq55(graphTargetNode.runId, siteCrawlGraphEdges.runId),
+      eq55(graphTargetNode.attemptId, siteCrawlGraphEdges.attemptId),
+      eq55(graphTargetNode.nodeKey, siteCrawlGraphEdges.targetNodeKey),
+      lt7(graphTargetNode.sampleRank, maxNodes)
+    )).where(and43(
+      eq55(siteCrawlGraphEdges.projectId, project.id),
+      eq55(siteCrawlGraphEdges.runId, snapshot.runId),
+      eq55(siteCrawlGraphEdges.attemptId, snapshot.attemptId),
+      lt7(siteCrawlGraphEdges.sampleRank, maxEdges)
+    )).orderBy(asc10(siteCrawlGraphEdges.sampleRank)).all();
+    const totalNodes = persistedLayout.totalNodes;
+    const totalEdges = persistedLayout.totalEdges;
+    const omittedNodes = Math.max(0, totalNodes - nodes.length);
+    const omittedEdges = Math.max(0, totalEdges - edges.length);
+    return {
+      project: project.name,
+      hasCrawlData: true,
+      runId: snapshot.runId,
+      layout: { state: "ready", version: persistedLayout.layoutVersion, computedAt: persistedLayout.createdAt },
+      totalNodes,
+      totalEdges,
+      nodes,
+      edges,
+      omittedNodes,
+      omittedEdges,
+      sampled: omittedNodes > 0 || omittedEdges > 0
+    };
+  });
+  app.get("/projects/:name/technical-aeo/subgraph", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const hops = Math.min(3, parsePositiveInt(request.query.hops, 1, 3));
+    const maxNodes = parseBoundedLimit(
+      request.query.maxNodes,
+      SITE_HEALTH_SUBGRAPH_DEFAULT_MAX_NODES,
+      SITE_HEALTH_SUBGRAPH_MAX_NODES
+    );
+    const maxEdges = parseBoundedLimit(
+      request.query.maxEdges,
+      SITE_HEALTH_SUBGRAPH_DEFAULT_MAX_EDGES,
+      SITE_HEALTH_SUBGRAPH_MAX_EDGES
+    );
+    const target = resolveCrawl(project.id, request.query.runId);
+    const empty = (state, runId, hasCrawlData, complete, termination) => ({
+      project: project.name,
+      hasCrawlData,
+      runId,
+      complete,
+      termination,
+      state,
+      focusNodeKey: null,
+      focusUrl: null,
+      hops,
+      totalNodes: 0,
+      totalEdges: 0,
+      nodes: [],
+      edges: [],
+      omittedNodes: 0,
+      omittedEdges: 0,
+      countAccuracy: state === "no-crawl" ? "exact" : "lower-bound",
+      truncated: false
+    });
+    if (!target) {
+      if (request.query.runId) throw notFound("Site crawl run", request.query.runId);
+      return empty("no-crawl", null, false, false, null);
+    }
+    const snapshot = target.snapshot;
+    const scope = detailScopeFor(project.id, snapshot);
+    if (!scope) return empty("details-unavailable", snapshot.runId, true, snapshot.complete, snapshot.termination);
+    const explicitFocus = Boolean(request.query.nodeKey || request.query.url);
+    const focus = explicitFocus ? pageInScope(scope, { nodeKey: request.query.nodeKey, url: request.query.url }) : rootPageInScope(scope, snapshot.rootUrl);
+    if (!focus) {
+      if (explicitFocus) throw notFound("Site crawl page", request.query.nodeKey ?? request.query.url);
+      return {
+        ...empty("details-unavailable", snapshot.runId, true, snapshot.complete, snapshot.termination),
+        truncated: false
+      };
+    }
+    const distances = /* @__PURE__ */ new Map([[focus.nodeKey, 0]]);
+    const directRelations = /* @__PURE__ */ new Map();
+    const edgeRows = /* @__PURE__ */ new Map();
+    const omittedNodeKeys = /* @__PURE__ */ new Set();
+    const omittedEdgeKeys = /* @__PURE__ */ new Set();
+    const seenEdgeKeys = /* @__PURE__ */ new Set();
+    let frontier = [focus.nodeKey];
+    let queryTruncated = false;
+    for (let distance = 0; distance < hops && frontier.length > 0; distance += 1) {
+      const candidates = app.db.select().from(siteCrawlEdges).where(and43(
+        eq55(siteCrawlEdges.projectId, scope.projectId),
+        eq55(siteCrawlEdges.runId, scope.runId),
+        eq55(siteCrawlEdges.attemptId, scope.attemptId),
+        eq55(siteCrawlEdges.internal, true),
+        isNotNull3(siteCrawlEdges.targetNodeKey),
+        or11(
+          inArray19(siteCrawlEdges.sourceNodeKey, frontier),
+          inArray19(siteCrawlEdges.targetNodeKey, frontier)
+        )
+      )).orderBy(asc10(siteCrawlEdges.edgeKey)).limit(maxEdges + maxNodes + 1).all();
+      if (candidates.length > maxEdges + maxNodes) queryTruncated = true;
+      const next = /* @__PURE__ */ new Set();
+      for (const edge of candidates.slice(0, maxEdges + maxNodes)) {
+        if (!edge.targetNodeKey || seenEdgeKeys.has(edge.edgeKey)) continue;
+        seenEdgeKeys.add(edge.edgeKey);
+        const sourceInFrontier = frontier.includes(edge.sourceNodeKey);
+        const neighborKey = sourceInFrontier ? edge.targetNodeKey : edge.sourceNodeKey;
+        if (!distances.has(neighborKey)) {
+          if (distances.size < maxNodes) {
+            distances.set(neighborKey, distance + 1);
+            next.add(neighborKey);
+          } else {
+            omittedNodeKeys.add(neighborKey);
+          }
+        }
+        if (distance === 0 && neighborKey !== focus.nodeKey) {
+          const direction = edge.sourceNodeKey === focus.nodeKey ? "outbound" : "inbound";
+          const prior = directRelations.get(neighborKey);
+          directRelations.set(neighborKey, prior && prior !== direction ? "both" : direction);
+        }
+        if (distances.has(edge.sourceNodeKey) && distances.has(edge.targetNodeKey)) {
+          if (edgeRows.size < maxEdges) edgeRows.set(edge.edgeKey, edge);
+          else omittedEdgeKeys.add(edge.edgeKey);
+        } else {
+          omittedEdgeKeys.add(edge.edgeKey);
+        }
+      }
+      frontier = [...next].sort();
+    }
+    const nodeKeys = [...distances.keys()];
+    const pageRows = nodeKeys.length === 0 ? [] : app.db.select().from(siteCrawlPages).where(and43(
+      eq55(siteCrawlPages.projectId, scope.projectId),
+      eq55(siteCrawlPages.runId, scope.runId),
+      eq55(siteCrawlPages.attemptId, scope.attemptId),
+      inArray19(siteCrawlPages.nodeKey, nodeKeys)
+    )).all();
+    const persistedNodeKeys = new Set(pageRows.map((row) => row.nodeKey));
+    const outermostNodeKeys = pageRows.filter((row) => distances.get(row.nodeKey) === hops).map((row) => row.nodeKey);
+    const omittedOutermostEdge = outermostNodeKeys.length === 0 ? void 0 : app.db.select({ edgeKey: siteCrawlEdges.edgeKey }).from(siteCrawlEdges).where(and43(
+      eq55(siteCrawlEdges.projectId, scope.projectId),
+      eq55(siteCrawlEdges.runId, scope.runId),
+      eq55(siteCrawlEdges.attemptId, scope.attemptId),
+      eq55(siteCrawlEdges.internal, true),
+      isNotNull3(siteCrawlEdges.targetNodeKey),
+      inArray19(siteCrawlEdges.sourceNodeKey, outermostNodeKeys),
+      inArray19(siteCrawlEdges.targetNodeKey, outermostNodeKeys)
+    )).limit(1).get();
+    if (omittedOutermostEdge && !seenEdgeKeys.has(omittedOutermostEdge.edgeKey)) {
+      omittedEdgeKeys.add(omittedOutermostEdge.edgeKey);
+    }
+    const nodes = pageRows.map((row) => ({
+      ...mapCrawlPage(row),
+      distance: distances.get(row.nodeKey) ?? 0,
+      relationToFocus: row.nodeKey === focus.nodeKey ? "focus" : directRelations.get(row.nodeKey) ?? "transitive"
+    })).sort((a, b) => a.distance - b.distance || a.nodeKey.localeCompare(b.nodeKey));
+    const edges = [...edgeRows.values()].filter((edge) => edge.targetNodeKey && persistedNodeKeys.has(edge.sourceNodeKey) && persistedNodeKeys.has(edge.targetNodeKey)).sort((a, b) => a.edgeKey.localeCompare(b.edgeKey)).map(mapCrawlEdge);
+    const omittedNodes = omittedNodeKeys.size + Math.max(0, distances.size - pageRows.length);
+    const omittedEdges = omittedEdgeKeys.size + (queryTruncated ? 1 : 0) + Math.max(0, edgeRows.size - edges.length);
+    const truncated = omittedNodes > 0 || omittedEdges > 0;
+    return {
+      project: project.name,
+      hasCrawlData: true,
+      runId: snapshot.runId,
+      complete: snapshot.complete,
+      termination: snapshot.termination,
+      state: "ready",
+      focusNodeKey: focus.nodeKey,
+      focusUrl: focus.url,
+      hops,
+      totalNodes: nodes.length + omittedNodes,
+      totalEdges: edges.length + omittedEdges,
+      nodes,
+      edges,
+      omittedNodes,
+      omittedEdges,
+      countAccuracy: truncated ? "lower-bound" : "exact",
+      truncated
+    };
+  });
+  app.get("/projects/:name/technical-aeo/path", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const maxDepth = parseBoundedLimit(
+      request.query.maxDepth,
+      SITE_HEALTH_PATH_DEFAULT_MAX_DEPTH,
+      SITE_HEALTH_PATH_MAX_DEPTH
+    );
+    if (!request.query.toNodeKey && !request.query.toUrl) {
+      throw validationError("toNodeKey or toUrl is required");
+    }
+    const target = resolveCrawl(project.id, request.query.runId);
+    if (!target) {
+      if (request.query.runId) throw notFound("Site crawl run", request.query.runId);
+      return {
+        project: project.name,
+        runId: null,
+        state: "no-crawl",
+        from: null,
+        to: null,
+        complete: false,
+        termination: null,
+        maxDepth,
+        visitedNodes: 0,
+        nodes: [],
+        edges: []
+      };
+    }
+    const snapshot = target.snapshot;
+    const scope = detailScopeFor(project.id, snapshot);
+    if (!scope) {
+      return {
+        project: project.name,
+        runId: snapshot.runId,
+        state: "details-unavailable",
+        from: null,
+        to: null,
+        complete: snapshot.complete,
+        termination: snapshot.termination,
+        maxDepth,
+        visitedNodes: 0,
+        nodes: [],
+        edges: []
+      };
+    }
+    const explicitFrom = Boolean(request.query.fromNodeKey || request.query.fromUrl);
+    const fromPage = explicitFrom ? pageInScope(scope, { nodeKey: request.query.fromNodeKey, url: request.query.fromUrl }) : rootPageInScope(scope, snapshot.rootUrl);
+    if (!fromPage) throw notFound("Site crawl page", request.query.fromNodeKey ?? request.query.fromUrl ?? snapshot.rootUrl);
+    const toPage = pageInScope(scope, { nodeKey: request.query.toNodeKey, url: request.query.toUrl });
+    if (!toPage) throw notFound("Site crawl page", request.query.toNodeKey ?? request.query.toUrl);
+    const reference = (row) => ({
+      nodeKey: row.nodeKey,
+      url: row.url,
+      path: row.path
+    });
+    const predecessor = /* @__PURE__ */ new Map();
+    const visited = /* @__PURE__ */ new Set([fromPage.nodeKey]);
+    let frontier = [fromPage.nodeKey];
+    let found = fromPage.nodeKey === toPage.nodeKey;
+    let truncated = false;
+    for (let depth = 0; depth < maxDepth && frontier.length > 0 && !found; depth += 1) {
+      const candidates = app.db.select().from(siteCrawlEdges).where(and43(
+        eq55(siteCrawlEdges.projectId, scope.projectId),
+        eq55(siteCrawlEdges.runId, scope.runId),
+        eq55(siteCrawlEdges.attemptId, scope.attemptId),
+        eq55(siteCrawlEdges.internal, true),
+        eq55(siteCrawlEdges.followable, true),
+        eq55(siteCrawlEdges.relation, "anchor"),
+        isNotNull3(siteCrawlEdges.targetNodeKey),
+        inArray19(siteCrawlEdges.sourceNodeKey, frontier)
+      )).orderBy(asc10(siteCrawlEdges.edgeKey)).limit(SITE_HEALTH_PATH_MAX_VISITED_NODES + 1).all();
+      if (candidates.length > SITE_HEALTH_PATH_MAX_VISITED_NODES) truncated = true;
+      const candidateTargetKeys = [...new Set(candidates.map((edge) => edge.targetNodeKey).filter((nodeKey) => nodeKey != null))];
+      const persistedTargetKeys = new Set(candidateTargetKeys.length === 0 ? [] : app.db.select({ nodeKey: siteCrawlPages.nodeKey }).from(siteCrawlPages).where(and43(
+        eq55(siteCrawlPages.projectId, scope.projectId),
+        eq55(siteCrawlPages.runId, scope.runId),
+        eq55(siteCrawlPages.attemptId, scope.attemptId),
+        inArray19(siteCrawlPages.nodeKey, candidateTargetKeys)
+      )).all().map((row) => row.nodeKey));
+      const next = /* @__PURE__ */ new Set();
+      for (const edge of candidates.slice(0, SITE_HEALTH_PATH_MAX_VISITED_NODES)) {
+        if (!edge.targetNodeKey || !persistedTargetKeys.has(edge.targetNodeKey) || visited.has(edge.targetNodeKey)) continue;
+        if (visited.size >= SITE_HEALTH_PATH_MAX_VISITED_NODES) {
+          truncated = true;
+          break;
+        }
+        visited.add(edge.targetNodeKey);
+        predecessor.set(edge.targetNodeKey, { nodeKey: edge.sourceNodeKey, edge });
+        next.add(edge.targetNodeKey);
+        if (edge.targetNodeKey === toPage.nodeKey) {
+          found = true;
+          break;
+        }
+      }
+      frontier = [...next].sort();
+    }
+    if (!found) {
+      return {
+        project: project.name,
+        runId: snapshot.runId,
+        complete: snapshot.complete,
+        termination: snapshot.termination,
+        state: truncated || frontier.length > 0 ? "truncated" : "unreachable",
+        from: reference(fromPage),
+        to: reference(toPage),
+        maxDepth,
+        visitedNodes: visited.size,
+        nodes: [],
+        edges: []
+      };
+    }
+    const pathKeys = [toPage.nodeKey];
+    const pathEdges = [];
+    while (pathKeys[0] !== fromPage.nodeKey) {
+      const step = predecessor.get(pathKeys[0]);
+      if (!step) break;
+      pathEdges.unshift(step.edge);
+      pathKeys.unshift(step.nodeKey);
+    }
+    const pathRows = app.db.select().from(siteCrawlPages).where(and43(
+      eq55(siteCrawlPages.projectId, scope.projectId),
+      eq55(siteCrawlPages.runId, scope.runId),
+      eq55(siteCrawlPages.attemptId, scope.attemptId),
+      inArray19(siteCrawlPages.nodeKey, pathKeys)
+    )).all();
+    const pageByKey = new Map(pathRows.map((row) => [row.nodeKey, row]));
+    return {
+      project: project.name,
+      runId: snapshot.runId,
+      complete: snapshot.complete,
+      termination: snapshot.termination,
+      state: "found",
+      from: reference(fromPage),
+      to: reference(toPage),
+      maxDepth,
+      visitedNodes: visited.size,
+      nodes: pathKeys.map((key) => mapCrawlPage(pageByKey.get(key))),
+      edges: pathEdges.map(mapCrawlEdge)
+    };
+  });
+  app.get("/projects/:name/technical-aeo/changes", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const scopeFilter = request.query.scope ?? "all";
+    if (scopeFilter !== "all" && scopeFilter !== "pages" && scopeFilter !== "links") {
+      throw validationError("scope must be all, pages, or links");
+    }
+    const changeFilter = request.query.change ?? "all";
+    if (changeFilter !== "all" && changeFilter !== "added" && changeFilter !== "removed" && changeFilter !== "changed") {
+      throw validationError("change must be all, added, removed, or changed");
+    }
+    const completeSnapshotFilters = [
+      eq55(siteCrawlSnapshots.projectId, project.id),
+      eq55(runs.projectId, project.id),
+      eq55(runs.kind, RunKinds["site-audit"]),
+      eq55(runs.status, RunStatuses.completed),
+      eq55(siteCrawlSnapshots.complete, true),
+      notProbeRun()
+    ];
+    const afterTarget = request.query.toRunId ? resolveCrawl(project.id, request.query.toRunId) : app.db.select({ snapshot: siteCrawlSnapshots, runStatus: runs.status }).from(siteCrawlSnapshots).innerJoin(runs, eq55(siteCrawlSnapshots.runId, runs.id)).where(and43(...completeSnapshotFilters)).orderBy(desc24(siteCrawlSnapshots.createdAt), desc24(siteCrawlSnapshots.runId)).limit(1).get();
+    if (request.query.toRunId && !afterTarget) throw notFound("Site crawl run", request.query.toRunId);
+    const beforeTarget = request.query.fromRunId ? resolveCrawl(project.id, request.query.fromRunId) : afterTarget ? app.db.select({ snapshot: siteCrawlSnapshots, runStatus: runs.status }).from(siteCrawlSnapshots).innerJoin(runs, eq55(siteCrawlSnapshots.runId, runs.id)).where(and43(
+      ...completeSnapshotFilters,
+      or11(
+        lt7(siteCrawlSnapshots.createdAt, afterTarget.snapshot.createdAt),
+        and43(
+          eq55(siteCrawlSnapshots.createdAt, afterTarget.snapshot.createdAt),
+          lt7(siteCrawlSnapshots.runId, afterTarget.snapshot.runId)
+        )
+      )
+    )).orderBy(desc24(siteCrawlSnapshots.createdAt), desc24(siteCrawlSnapshots.runId)).limit(1).get() : void 0;
+    if (request.query.fromRunId && !beforeTarget) throw notFound("Site crawl run", request.query.fromRunId);
+    if (!afterTarget) {
+      return { project: project.name, state: "unavailable", reason: "no-crawl", fromRunId: null, toRunId: null };
+    }
+    if (!beforeTarget) {
+      return {
+        project: project.name,
+        state: "unavailable",
+        reason: "insufficient-history",
+        fromRunId: null,
+        toRunId: afterTarget.snapshot.runId
+      };
+    }
+    const beforeSnapshot = beforeTarget.snapshot;
+    const afterSnapshot = afterTarget.snapshot;
+    if (beforeSnapshot.runId === afterSnapshot.runId) {
+      throw validationError("fromRunId and toRunId must identify different crawls");
+    }
+    const crawlOrder = beforeSnapshot.createdAt.localeCompare(afterSnapshot.createdAt);
+    if (crawlOrder > 0 || crawlOrder === 0 && beforeSnapshot.runId >= afterSnapshot.runId) {
+      throw validationError("fromRunId must identify a crawl earlier than toRunId");
+    }
+    if (!beforeSnapshot.complete || !afterSnapshot.complete || beforeTarget.runStatus !== RunStatuses.completed || afterTarget.runStatus !== RunStatuses.completed) {
+      return {
+        project: project.name,
+        state: "unavailable",
+        reason: "partial-not-comparable",
+        fromRunId: beforeSnapshot.runId,
+        toRunId: afterSnapshot.runId
+      };
+    }
+    const beforeScope = detailScopeFor(project.id, beforeSnapshot);
+    const afterScope = detailScopeFor(project.id, afterSnapshot);
+    if (!beforeScope || !afterScope) {
+      return {
+        project: project.name,
+        state: "unavailable",
+        reason: "details-unavailable",
+        fromRunId: beforeSnapshot.runId,
+        toRunId: afterSnapshot.runId
+      };
+    }
+    const versions = {
+      crawlSchema: [beforeSnapshot.crawlSchemaVersion, afterSnapshot.crawlSchemaVersion],
+      normalization: [beforeSnapshot.normalizationVersion, afterSnapshot.normalizationVersion],
+      indexability: [beforeSnapshot.indexabilityVersion, afterSnapshot.indexabilityVersion],
+      linkScore: [beforeSnapshot.linkScoreVersion, afterSnapshot.linkScoreVersion]
+    };
+    const mismatchedVersions = Object.entries(versions).filter(([, pair]) => pair[0] !== pair[1]).map(([name]) => name);
+    if (mismatchedVersions.length > 0) {
+      return {
+        project: project.name,
+        state: "incompatible",
+        reason: "incompatible-versions",
+        fromRunId: beforeSnapshot.runId,
+        toRunId: afterSnapshot.runId,
+        mismatchedVersions
+      };
+    }
+    const cursor = decodeSiteHealthChangesCursor(request.query.cursor, {
+      fromRunId: beforeSnapshot.runId,
+      toRunId: afterSnapshot.runId,
+      scope: scopeFilter,
+      change: changeFilter
+    });
+    const loadSummary = () => {
+      const includeAdded = changeFilter === "all" || changeFilter === "added";
+      const includeRemoved = changeFilter === "all" || changeFilter === "removed";
+      const includeChanged = changeFilter === "all" || changeFilter === "changed";
+      const zero2 = () => ({ added: 0, removed: 0, changed: 0 });
+      const summary2 = { pages: zero2(), links: zero2() };
+      if (scopeFilter !== "links") {
+        if (includeAdded || includeChanged) {
+          const addedExpression = includeAdded ? sql20`COALESCE(SUM(CASE WHEN previous.id IS NULL THEN 1 ELSE 0 END), 0)` : sql20`0`;
+          const changedExpression = includeChanged ? sql20`COALESCE(SUM(CASE WHEN previous.id IS NOT NULL AND ${PAGE_CHANGE_PREDICATE} THEN 1 ELSE 0 END), 0)` : sql20`0`;
+          const [counts2 = { added: 0, changed: 0 }] = app.db.all(sql20`
+            SELECT ${addedExpression} AS added, ${changedExpression} AS changed
+            FROM site_crawl_pages AS current
+            LEFT JOIN site_crawl_pages AS previous
+              ON previous.project_id = ${beforeScope.projectId}
+              AND previous.run_id = ${beforeScope.runId}
+              AND previous.attempt_id = ${beforeScope.attemptId}
+              AND previous.node_key = current.node_key
+            WHERE current.project_id = ${afterScope.projectId}
+              AND current.run_id = ${afterScope.runId}
+              AND current.attempt_id = ${afterScope.attemptId}
+          `);
+          summary2.pages.added = Number(counts2.added);
+          summary2.pages.changed = Number(counts2.changed);
+        }
+        if (includeRemoved) {
+          const [counts2 = { removed: 0 }] = app.db.all(sql20`
+            SELECT COUNT(*) AS removed
+            FROM site_crawl_pages AS previous
+            LEFT JOIN site_crawl_pages AS current
+              ON current.project_id = ${afterScope.projectId}
+              AND current.run_id = ${afterScope.runId}
+              AND current.attempt_id = ${afterScope.attemptId}
+              AND current.node_key = previous.node_key
+            WHERE previous.project_id = ${beforeScope.projectId}
+              AND previous.run_id = ${beforeScope.runId}
+              AND previous.attempt_id = ${beforeScope.attemptId}
+              AND current.id IS NULL
+          `);
+          summary2.pages.removed = Number(counts2.removed);
+        }
+      }
+      if (scopeFilter !== "pages") {
+        if (includeAdded || includeChanged) {
+          const addedExpression = includeAdded ? sql20`COALESCE(SUM(CASE WHEN previous.id IS NULL THEN 1 ELSE 0 END), 0)` : sql20`0`;
+          const changedExpression = includeChanged ? sql20`COALESCE(SUM(CASE WHEN previous.id IS NOT NULL AND ${LINK_CHANGE_PREDICATE} THEN 1 ELSE 0 END), 0)` : sql20`0`;
+          const [counts2 = { added: 0, changed: 0 }] = app.db.all(sql20`
+            SELECT ${addedExpression} AS added, ${changedExpression} AS changed
+            FROM site_crawl_edges AS current
+            LEFT JOIN site_crawl_edges AS previous
+              ON previous.project_id = ${beforeScope.projectId}
+              AND previous.run_id = ${beforeScope.runId}
+              AND previous.attempt_id = ${beforeScope.attemptId}
+              AND previous.internal = 1
+              AND previous.edge_key = current.edge_key
+            WHERE current.project_id = ${afterScope.projectId}
+              AND current.run_id = ${afterScope.runId}
+              AND current.attempt_id = ${afterScope.attemptId}
+              AND current.internal = 1
+          `);
+          summary2.links.added = Number(counts2.added);
+          summary2.links.changed = Number(counts2.changed);
+        }
+        if (includeRemoved) {
+          const [counts2 = { removed: 0 }] = app.db.all(sql20`
+            SELECT COUNT(*) AS removed
+            FROM site_crawl_edges AS previous
+            LEFT JOIN site_crawl_edges AS current
+              ON current.project_id = ${afterScope.projectId}
+              AND current.run_id = ${afterScope.runId}
+              AND current.attempt_id = ${afterScope.attemptId}
+              AND current.internal = 1
+              AND current.edge_key = previous.edge_key
+            WHERE previous.project_id = ${beforeScope.projectId}
+              AND previous.run_id = ${beforeScope.runId}
+              AND previous.attempt_id = ${beforeScope.attemptId}
+              AND previous.internal = 1
+              AND current.id IS NULL
+          `);
+          summary2.links.removed = Number(counts2.removed);
+        }
+      }
+      return summary2;
+    };
+    const summary = cursor ? null : loadSummary();
+    const limit = parseBoundedLimit(request.query.limit, SITE_HEALTH_CHANGES_DEFAULT_LIMIT, SITE_HEALTH_CHANGES_MAX_LIMIT);
+    const sumCounts = (counts2) => counts2.added + counts2.removed + counts2.changed;
+    const total = summary ? sumCounts(summary.pages) + sumCounts(summary.links) : null;
+    const collectEntity = (entity, afterKey, wanted2) => {
+      if (wanted2 <= 0) return [];
+      const includeAfter = changeFilter === "all" || changeFilter === "added" || changeFilter === "changed";
+      const includeRemoved = changeFilter === "all" || changeFilter === "removed";
+      const table = entity === "page" ? "site_crawl_pages" : "site_crawl_edges";
+      const keyColumn = entity === "page" ? "node_key" : "edge_key";
+      const internalCurrent = entity === "link" ? sql20`AND current.internal = 1` : sql20``;
+      const internalPreviousJoin = entity === "link" ? sql20`AND previous.internal = 1` : sql20``;
+      const internalPrevious = entity === "link" ? sql20`AND previous.internal = 1` : sql20``;
+      const internalCurrentJoin = entity === "link" ? sql20`AND current.internal = 1` : sql20``;
+      const difference2 = entity === "page" ? PAGE_CHANGE_PREDICATE : LINK_CHANGE_PREDICATE;
+      const afterKind = changeFilter === "added" ? sql20`previous.id IS NULL` : changeFilter === "changed" ? sql20`previous.id IS NOT NULL AND ${difference2}` : sql20`previous.id IS NULL OR (previous.id IS NOT NULL AND ${difference2})`;
+      const afterRows = includeAfter ? app.db.all(sql20`
+        SELECT ${entity} AS entity,
+          CASE WHEN previous.id IS NULL THEN 'added' ELSE 'changed' END AS change,
+          current.${sql20.raw(keyColumn)} AS key
+        FROM ${sql20.raw(table)} AS current
+        LEFT JOIN ${sql20.raw(table)} AS previous
+          ON previous.project_id = ${beforeScope.projectId}
+          AND previous.run_id = ${beforeScope.runId}
+          AND previous.attempt_id = ${beforeScope.attemptId}
+          ${internalPreviousJoin}
+          AND previous.${sql20.raw(keyColumn)} = current.${sql20.raw(keyColumn)}
+        WHERE current.project_id = ${afterScope.projectId}
+          AND current.run_id = ${afterScope.runId}
+          AND current.attempt_id = ${afterScope.attemptId}
+          ${internalCurrent}
+          AND current.${sql20.raw(keyColumn)} > ${afterKey}
+          AND (${afterKind})
+        ORDER BY current.${sql20.raw(keyColumn)} ASC
+        LIMIT ${wanted2}
+      `) : [];
+      const removedRows = includeRemoved ? app.db.all(sql20`
+        SELECT ${entity} AS entity, 'removed' AS change, previous.${sql20.raw(keyColumn)} AS key
+        FROM ${sql20.raw(table)} AS previous
+        LEFT JOIN ${sql20.raw(table)} AS current
+          ON current.project_id = ${afterScope.projectId}
+          AND current.run_id = ${afterScope.runId}
+          AND current.attempt_id = ${afterScope.attemptId}
+          ${internalCurrentJoin}
+          AND current.${sql20.raw(keyColumn)} = previous.${sql20.raw(keyColumn)}
+        WHERE previous.project_id = ${beforeScope.projectId}
+          AND previous.run_id = ${beforeScope.runId}
+          AND previous.attempt_id = ${beforeScope.attemptId}
+          ${internalPrevious}
+          AND previous.${sql20.raw(keyColumn)} > ${afterKey}
+          AND current.id IS NULL
+        ORDER BY previous.${sql20.raw(keyColumn)} ASC
+        LIMIT ${wanted2}
+      `) : [];
+      const merged = [];
+      let afterIndex = 0;
+      let removedIndex = 0;
+      while (merged.length < wanted2 && (afterIndex < afterRows.length || removedIndex < removedRows.length)) {
+        const afterRow = afterRows.at(afterIndex);
+        const removedRow = removedRows.at(removedIndex);
+        if (!removedRow || afterRow && compareChangeKeys(afterRow, removedRow) <= 0) {
+          merged.push(afterRow);
+          afterIndex += 1;
+        } else {
+          merged.push(removedRow);
+          removedIndex += 1;
+        }
+      }
+      return merged;
+    };
+    const keyRows = [];
+    const wanted = limit + 1;
+    if (scopeFilter !== "links" && cursor?.entity !== "link") {
+      keyRows.push(...collectEntity("page", cursor?.entity === "page" ? cursor.key : "", wanted));
+    }
+    if (keyRows.length < wanted && scopeFilter !== "pages") {
+      keyRows.push(...collectEntity("link", cursor?.entity === "link" ? cursor.key : "", wanted - keyRows.length));
+    }
+    const visibleKeys = keyRows.slice(0, limit);
+    const pageKeys = visibleKeys.filter((row) => row.entity === "page").map((row) => row.key);
+    const linkKeys = visibleKeys.filter((row) => row.entity === "link").map((row) => row.key);
+    const pageRowsFor = (scope) => pageKeys.length === 0 ? [] : app.db.select().from(siteCrawlPages).where(and43(
+      eq55(siteCrawlPages.projectId, scope.projectId),
+      eq55(siteCrawlPages.runId, scope.runId),
+      eq55(siteCrawlPages.attemptId, scope.attemptId),
+      inArray19(siteCrawlPages.nodeKey, pageKeys)
+    )).all();
+    const edgeRowsFor = (scope) => linkKeys.length === 0 ? [] : app.db.select().from(siteCrawlEdges).where(and43(
+      eq55(siteCrawlEdges.projectId, scope.projectId),
+      eq55(siteCrawlEdges.runId, scope.runId),
+      eq55(siteCrawlEdges.attemptId, scope.attemptId),
+      eq55(siteCrawlEdges.internal, true),
+      inArray19(siteCrawlEdges.edgeKey, linkKeys)
+    )).all();
+    const beforePages = new Map(pageRowsFor(beforeScope).map((row) => [row.nodeKey, mapCrawlPage(row)]));
+    const afterPages = new Map(pageRowsFor(afterScope).map((row) => [row.nodeKey, mapCrawlPage(row)]));
+    const beforeLinks = new Map(edgeRowsFor(beforeScope).map((row) => [row.edgeKey, mapCrawlEdge(row)]));
+    const afterLinks = new Map(edgeRowsFor(afterScope).map((row) => [row.edgeKey, mapCrawlEdge(row)]));
+    const changes = visibleKeys.map((row) => {
+      if (row.entity === "page") {
+        const before2 = beforePages.get(row.key) ?? null;
+        const after2 = afterPages.get(row.key) ?? null;
+        const pageChangedFields = changedFields(before2, after2, PAGE_CHANGE_FIELDS);
+        if (before2 && after2 && before2.healthState !== after2.healthState) pageChangedFields.push("healthState");
+        return {
+          entity: "page",
+          change: row.change,
+          key: row.key,
+          changedFields: pageChangedFields,
+          before: before2,
+          after: after2
+        };
+      }
+      const before = beforeLinks.get(row.key) ?? null;
+      const after = afterLinks.get(row.key) ?? null;
+      return {
+        entity: "link",
+        change: row.change,
+        key: row.key,
+        changedFields: changedFields(before, after, LINK_CHANGE_FIELDS),
+        before,
+        after
+      };
+    });
+    return {
+      project: project.name,
+      state: "ready",
+      fromRunId: beforeSnapshot.runId,
+      toRunId: afterSnapshot.runId,
+      versions: {
+        crawlSchema: afterSnapshot.crawlSchemaVersion,
+        normalization: afterSnapshot.normalizationVersion,
+        indexability: afterSnapshot.indexabilityVersion,
+        linkScore: afterSnapshot.linkScoreVersion
+      },
+      filters: { scope: scopeFilter, change: changeFilter },
+      summaryState: cursor ? "omitted-on-continuation" : "exact",
+      summary,
+      total,
+      nextCursor: keyRows.length > limit && visibleKeys.length > 0 ? encodeSiteHealthChangesCursor({
+        v: 1,
+        fromRunId: beforeSnapshot.runId,
+        toRunId: afterSnapshot.runId,
+        scope: scopeFilter,
+        change: changeFilter,
+        entity: visibleKeys.at(-1).entity,
+        key: visibleKeys.at(-1).key
+      }) : null,
+      changes
+    };
+  });
+  app.get("/projects/:name/technical-aeo/crawl/pages/audit", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const scalarQueryString = (value, name) => {
+      if (value === void 0) return void 0;
+      if (typeof value !== "string") throw validationError(`${name} must be provided once`);
+      return value;
+    };
+    const runId = scalarQueryString(request.query.runId, "runId");
+    const nodeKey = scalarQueryString(request.query.nodeKey, "nodeKey")?.trim();
+    const url = scalarQueryString(request.query.url, "url")?.trim();
+    if (Number(Boolean(nodeKey)) + Number(Boolean(url)) !== 1) {
+      throw validationError("Provide exactly one of nodeKey or url");
+    }
+    const target = resolveCrawl(project.id, runId);
+    if (!target) {
+      if (runId) throw notFound("Site crawl run", runId);
+      return { state: "no-crawl", project: project.name, runId: null };
+    }
+    const snapshot = target.snapshot;
+    const provenance = {
+      project: project.name,
+      runId: snapshot.runId,
+      complete: snapshot.complete,
+      termination: snapshot.termination
+    };
+    const scope = detailScopeFor(project.id, snapshot);
+    if (!scope) return { state: "details-unavailable", ...provenance };
+    const page = pageInScope(scope, nodeKey ? { nodeKey } : { url });
+    if (!page) return { state: "not-found", ...provenance };
+    const identity = {
+      nodeKey: page.nodeKey,
+      url: page.url,
+      auditState: page.auditState
+    };
+    if (page.auditScore == null) {
+      return {
+        state: "not-audited",
+        ...provenance,
+        ...identity,
+        auditScore: null,
+        factors: [],
+        criticalDefects: []
+      };
+    }
+    return {
+      state: "ready",
+      ...provenance,
+      ...identity,
+      auditScore: page.auditScore,
+      ...mapCrawlPageAuditEvidence(page)
+    };
+  });
   app.get("/projects/:name/technical-aeo/crawl/pages", async (request) => {
     const project = resolveProject(app.db, request.params.name);
     const target = resolveCrawl(project.id, request.query.runId);
@@ -55738,7 +57038,7 @@ async function technicalAeoRoutes(app, opts) {
       };
       child.pageCount++;
       if (row.inventoryEligible) child.inventoryEligibleCount++;
-      if (["html", "redirect", "non-html", "fetch-error", "fetched"].includes(row.fetchState)) child.fetchedCount++;
+      if (FETCHED_SITE_CRAWL_STATES.has(row.fetchState)) child.fetchedCount++;
       if (structureHierarchyPath(row.path) === childPath) {
         child.hasPage = true;
         if (child.url == null || row.url > child.url) child.url = row.url;
@@ -56544,7 +57844,7 @@ function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, com
   }
   const ownKeys = new Set([...ownBrandAliases].map(brandKeyFromText));
   const knownCompetitorAliases = new Set(
-    [...citedDomains, ...competitorDomains].flatMap((domain) => collectBrandAliasesFromDomain(domain)).filter((alias) => !ownKeys.has(brandKeyFromText(alias)))
+    [...citedDomains, ...competitorDomains].flatMap((domain) => collectBrandAliasesFromDomain(domain)).filter((alias2) => !ownKeys.has(brandKeyFromText(alias2)))
   );
   if (knownCompetitorAliases.size === 0) return [];
   const candidatePatterns = [
@@ -56616,7 +57916,7 @@ function collectBrandAliasesFromDomain(domain) {
   return [...aliases];
 }
 function matchesBrandAlias(candidate, aliases) {
-  return [...aliases].some((alias) => textContainsBrandAlias(candidate, alias));
+  return [...aliases].some((alias2) => textContainsBrandAlias(candidate, alias2));
 }
 
 // src/intelligence-service.ts
@@ -57260,6 +58560,9 @@ export {
   siteCrawlSnapshots,
   siteCrawlPages,
   siteCrawlEdges,
+  siteCrawlGraphLayouts,
+  siteCrawlGraphNodes,
+  siteCrawlGraphEdges,
   siteCrawlFindings,
   siteCrawlEventReceipts,
   bingCoverageSnapshots,