@canonry/canonry 4.155.0 → 4.156.0

package/dist/{chunk-VIKPFI6F.js → chunk-AMPT2EP7.js}

@@ -8545,6 +8545,9 @@ var siteCrawlSummarySchema = z24.object({
   legacyAuditAvailable: z24.boolean(),
   runId: z24.string().nullable(),
   runStatus: nullableRunStatusSchema,
+  /** Root URL originally requested by the operator; null for legacy snapshots. */
+  requestedRootUrl: z24.string().nullable(),
+  /** Effective root followed by the crawl after any supported host redirect. */
   rootUrl: z24.string().nullable(),
   crawlSchemaVersion: z24.string().nullable().optional(),
   engineVersion: z24.string().nullable().optional(),
@@ -8558,6 +8561,65 @@ var siteCrawlSummarySchema = z24.object({
   counts: siteCrawlCountsSchema,
   deadLinks: siteCrawlDeadLinksSummarySchema
 });
+var siteHealthStateSchema = z24.enum(["eligible", "hidden", "failed", "unchecked"]);
+var SiteCrawlFetchStates = {
+  discovered: "discovered",
+  robotsBlocked: "robots-blocked",
+  html: "html",
+  redirect: "redirect",
+  nonHtml: "non-html",
+  fetchError: "fetch-error"
+};
+var SiteCrawlFetchedStates = [
+  SiteCrawlFetchStates.html,
+  SiteCrawlFetchStates.redirect,
+  SiteCrawlFetchStates.nonHtml,
+  SiteCrawlFetchStates.fetchError
+];
+var SiteCrawlIndexabilityStates = {
+  indexable: "indexable",
+  noindex: "noindex",
+  blocked: "blocked",
+  unknown: "unknown"
+};
+var SiteCrawlIndexabilityReasons = {
+  robotsDisallow: "robots-disallow",
+  redirectTerminal: "redirect-terminal",
+  metaRobotsNoindex: "meta-robots-noindex",
+  xRobotsNoindex: "x-robots-noindex",
+  canonicalToOther: "canonical-to-other",
+  notHtmlOrUnavailable: "not-html-or-unavailable"
+};
+function pointsToOtherCanonical(input) {
+  return input.indexabilityReasons?.some((reason) => reason === SiteCrawlIndexabilityReasons.canonicalToOther) === true || input.nodeKey !== void 0 && input.canonicalNodeKey !== null && input.canonicalNodeKey !== void 0 && input.canonicalNodeKey !== input.nodeKey;
+}
+function deriveSiteHealthState(input) {
+  switch (input.fetchState) {
+    case SiteCrawlFetchStates.fetchError:
+      return "failed";
+    case SiteCrawlFetchStates.discovered:
+      return "unchecked";
+    case SiteCrawlFetchStates.redirect:
+    case SiteCrawlFetchStates.robotsBlocked:
+    case SiteCrawlFetchStates.nonHtml:
+      return "hidden";
+    case SiteCrawlFetchStates.html:
+      break;
+    default:
+      return "unchecked";
+  }
+  if (pointsToOtherCanonical(input)) return "hidden";
+  switch (input.indexabilityState) {
+    case SiteCrawlIndexabilityStates.indexable:
+      return "eligible";
+    case SiteCrawlIndexabilityStates.noindex:
+    case SiteCrawlIndexabilityStates.blocked:
+      return "hidden";
+    case SiteCrawlIndexabilityStates.unknown:
+    default:
+      return "unchecked";
+  }
+}
 var siteCrawlPageSchema = z24.object({
   nodeKey: z24.string(),
   url: z24.string(),
@@ -8579,8 +8641,62 @@ var siteCrawlPageSchema = z24.object({
   inboundOccurrences: z24.number().int().nonnegative(),
   outboundOccurrences: z24.number().int().nonnegative(),
   linkScoreRaw: z24.number().nullable(),
-  linkScoreNormalized: z24.number().nullable()
+  linkScoreNormalized: z24.number().nullable(),
+  healthState: siteHealthStateSchema
+});
+var siteCrawlAuditFindingSchema = z24.object({
+  type: z24.enum(["found", "missing", "info", "timeout", "unreachable"]),
+  /** Stable machine code; UI and agents must not key behavior off `message`. */
+  code: z24.string().min(1),
+  message: z24.string().min(1)
 });
+var siteCrawlAuditFactorSchema = siteAuditPageFactorSchema.extend({
+  status: siteAuditFactorStatusSchema,
+  /** `null` means the engine did not explicitly classify applicability. */
+  applicable: z24.boolean().nullable(),
+  findings: z24.array(siteCrawlAuditFindingSchema).default([]),
+  recommendations: z24.array(z24.string()).default([])
+});
+var siteCrawlCriticalDefectSchema = z24.object({
+  id: z24.string().min(1),
+  severity: z24.enum(["critical", "warning"]),
+  detail: z24.string().min(1),
+  recommendation: z24.string().min(1)
+});
+var siteCrawlPageAuditProvenanceSchema = z24.object({
+  project: z24.string(),
+  runId: z24.string(),
+  complete: z24.boolean(),
+  termination: z24.string().nullable()
+});
+var siteCrawlPageAuditIdentitySchema = z24.object({
+  nodeKey: z24.string(),
+  url: z24.string(),
+  auditState: z24.string()
+});
+var siteCrawlPageAuditSchema = z24.discriminatedUnion("state", [
+  z24.object({
+    state: z24.literal("no-crawl"),
+    project: z24.string(),
+    runId: z24.null()
+  }),
+  siteCrawlPageAuditProvenanceSchema.extend({ state: z24.literal("details-unavailable") }),
+  siteCrawlPageAuditProvenanceSchema.extend({ state: z24.literal("not-found") }),
+  siteCrawlPageAuditProvenanceSchema.merge(siteCrawlPageAuditIdentitySchema).extend({
+    state: z24.literal("not-audited"),
+    auditScore: z24.null(),
+    factors: z24.array(siteCrawlAuditFactorSchema).length(0).default([]),
+    criticalDefects: z24.array(siteCrawlCriticalDefectSchema).length(0).default([])
+  }),
+  siteCrawlPageAuditProvenanceSchema.merge(siteCrawlPageAuditIdentitySchema).extend({
+    state: z24.literal("ready"),
+    auditScore: z24.number(),
+    /** Old crawl rows retain factor scores but did not persist evidence prose. */
+    evidenceState: z24.enum(["complete", "scores-only"]),
+    factors: z24.array(siteCrawlAuditFactorSchema).default([]),
+    criticalDefects: z24.array(siteCrawlCriticalDefectSchema).default([])
+  })
+]);
 var siteCrawlPagesResponseSchema = z24.object({
   project: z24.string(),
   hasCrawlData: z24.boolean(),
@@ -8620,6 +8736,194 @@ var siteCrawlEdgeSchema = z24.object({
   nofollowOccurrences: z24.number().int().nonnegative(),
   anchors: z24.array(z24.string()).default([])
 });
+var siteCrawlGraphNodeSchema = z24.object({
+  nodeKey: z24.string(),
+  url: z24.string(),
+  path: z24.string(),
+  depth: z24.number().int().nonnegative().nullable(),
+  indexabilityState: z24.string(),
+  fetchState: z24.string(),
+  auditState: z24.string(),
+  auditScore: z24.number().nullable(),
+  inventoryEligible: z24.boolean(),
+  inboundUniqueEdges: z24.number().int().nonnegative(),
+  outboundUniqueEdges: z24.number().int().nonnegative(),
+  linkScoreNormalized: z24.number().nullable(),
+  healthState: siteHealthStateSchema,
+  /** Publish-time ForceAtlas2 coordinate. Reads never run layout physics. */
+  x: z24.number(),
+  /** Publish-time ForceAtlas2 coordinate. Reads never run layout physics. */
+  y: z24.number()
+});
+var siteCrawlGraphEdgeSchema = z24.object({
+  edgeKey: z24.string(),
+  sourceNodeKey: z24.string(),
+  targetNodeKey: z24.string(),
+  followable: z24.boolean(),
+  occurrences: z24.number().int().positive()
+});
+var siteCrawlGraphLayoutSchema = z24.discriminatedUnion("state", [
+  z24.object({
+    state: z24.literal("ready"),
+    version: z24.string().min(1),
+    computedAt: z24.string().min(1)
+  }),
+  z24.object({
+    state: z24.literal("unavailable"),
+    version: z24.null(),
+    reason: z24.enum(["no-crawl", "legacy-snapshot", "details-unavailable", "layout-failed", "empty-crawl"])
+  })
+]);
+var siteCrawlGraphResponseSchema = z24.object({
+  project: z24.string(),
+  hasCrawlData: z24.boolean(),
+  runId: z24.string().nullable(),
+  layout: siteCrawlGraphLayoutSchema,
+  /** Total canonical pages in the persisted crawl before graph sampling. */
+  totalNodes: z24.number().int().nonnegative(),
+  /** Total graph-compatible internal anchor edges before graph sampling. */
+  totalEdges: z24.number().int().nonnegative(),
+  nodes: z24.array(siteCrawlGraphNodeSchema).default([]),
+  edges: z24.array(siteCrawlGraphEdgeSchema).default([]),
+  omittedNodes: z24.number().int().nonnegative(),
+  omittedEdges: z24.number().int().nonnegative(),
+  /** True when publish/read caps or a layout failure omit graph rows. */
+  sampled: z24.boolean()
+});
+var SITE_CRAWL_GRAPH_DEFAULT_MAX_NODES = 2e4;
+var SITE_CRAWL_GRAPH_MAX_NODES = 2e4;
+var SITE_CRAWL_GRAPH_DEFAULT_MAX_EDGES = 5e4;
+var SITE_CRAWL_GRAPH_MAX_EDGES = 5e4;
+var siteHealthSubgraphRelationSchema = z24.enum([
+  "focus",
+  "inbound",
+  "outbound",
+  "both",
+  "transitive"
+]);
+var siteHealthSubgraphNodeSchema = siteCrawlPageSchema.extend({
+  distance: z24.number().int().nonnegative(),
+  relationToFocus: siteHealthSubgraphRelationSchema
+});
+var siteHealthSubgraphResponseSchema = z24.object({
+  project: z24.string(),
+  hasCrawlData: z24.boolean(),
+  runId: z24.string().nullable(),
+  /** Selected snapshot provenance. Historical partial crawls stay explicit. */
+  complete: z24.boolean(),
+  termination: z24.string().nullable(),
+  state: z24.enum(["no-crawl", "details-unavailable", "ready"]),
+  focusNodeKey: z24.string().nullable(),
+  focusUrl: z24.string().nullable(),
+  hops: z24.number().int().min(0).max(3),
+  totalNodes: z24.number().int().nonnegative(),
+  totalEdges: z24.number().int().nonnegative(),
+  nodes: z24.array(siteHealthSubgraphNodeSchema).default([]),
+  edges: z24.array(siteCrawlEdgeSchema).default([]),
+  omittedNodes: z24.number().int().nonnegative(),
+  omittedEdges: z24.number().int().nonnegative(),
+  /** `lower-bound` means totals and omissions are minimums because traversal hit a cap. */
+  countAccuracy: z24.enum(["exact", "lower-bound"]),
+  truncated: z24.boolean()
+});
+var SITE_HEALTH_SUBGRAPH_DEFAULT_MAX_NODES = 25;
+var SITE_HEALTH_SUBGRAPH_MAX_NODES = 200;
+var SITE_HEALTH_SUBGRAPH_DEFAULT_MAX_EDGES = 50;
+var SITE_HEALTH_SUBGRAPH_MAX_EDGES = 500;
+var siteHealthNodeReferenceSchema = z24.object({
+  nodeKey: z24.string(),
+  url: z24.string(),
+  path: z24.string()
+});
+var siteHealthPathResponseSchema = z24.object({
+  project: z24.string(),
+  runId: z24.string().nullable(),
+  /** Selected snapshot provenance. `unreachable` on a partial crawl is not a site-wide claim. */
+  complete: z24.boolean(),
+  termination: z24.string().nullable(),
+  state: z24.enum(["no-crawl", "details-unavailable", "found", "unreachable", "truncated"]),
+  from: siteHealthNodeReferenceSchema.nullable(),
+  to: siteHealthNodeReferenceSchema.nullable(),
+  maxDepth: z24.number().int().positive(),
+  visitedNodes: z24.number().int().nonnegative(),
+  nodes: z24.array(siteCrawlPageSchema).default([]),
+  edges: z24.array(siteCrawlEdgeSchema).default([])
+});
+var SITE_HEALTH_PATH_DEFAULT_MAX_DEPTH = 12;
+var SITE_HEALTH_PATH_MAX_DEPTH = 24;
+var SITE_HEALTH_PATH_MAX_VISITED_NODES = 5e3;
+var siteHealthChangeKindSchema = z24.enum(["added", "removed", "changed"]);
+var siteHealthPageChangeSchema = z24.object({
+  entity: z24.literal("page"),
+  change: siteHealthChangeKindSchema,
+  key: z24.string(),
+  changedFields: z24.array(z24.string()).default([]),
+  before: siteCrawlPageSchema.nullable(),
+  after: siteCrawlPageSchema.nullable()
+});
+var siteHealthLinkChangeSchema = z24.object({
+  entity: z24.literal("link"),
+  change: siteHealthChangeKindSchema,
+  key: z24.string(),
+  changedFields: z24.array(z24.string()).default([]),
+  before: siteCrawlEdgeSchema.nullable(),
+  after: siteCrawlEdgeSchema.nullable()
+});
+var siteHealthChangeRecordSchema = z24.discriminatedUnion("entity", [
+  siteHealthPageChangeSchema,
+  siteHealthLinkChangeSchema
+]);
+var siteHealthChangeCountsSchema = z24.object({
+  added: z24.number().int().nonnegative(),
+  removed: z24.number().int().nonnegative(),
+  changed: z24.number().int().nonnegative()
+});
+var siteHealthChangesFiltersSchema = z24.object({
+  scope: z24.enum(["all", "pages", "links"]),
+  change: z24.enum(["all", "added", "removed", "changed"])
+});
+var siteHealthChangesResponseSchema = z24.discriminatedUnion("state", [
+  z24.object({
+    project: z24.string(),
+    state: z24.literal("unavailable"),
+    reason: z24.enum(["no-crawl", "insufficient-history", "details-unavailable", "partial-not-comparable"]),
+    fromRunId: z24.string().nullable(),
+    toRunId: z24.string().nullable()
+  }),
+  z24.object({
+    project: z24.string(),
+    state: z24.literal("incompatible"),
+    reason: z24.literal("incompatible-versions"),
+    fromRunId: z24.string(),
+    toRunId: z24.string(),
+    mismatchedVersions: z24.array(z24.string()).min(1)
+  }),
+  z24.object({
+    project: z24.string(),
+    state: z24.literal("ready"),
+    fromRunId: z24.string(),
+    toRunId: z24.string(),
+    versions: z24.object({
+      crawlSchema: z24.string(),
+      normalization: z24.string(),
+      indexability: z24.string(),
+      linkScore: z24.string()
+    }),
+    /** The filters whose post-filter counts and records this page represents. */
+    filters: siteHealthChangesFiltersSchema,
+    /** Continuations omit summary work; reuse the exact summary from the first page. */
+    summaryState: z24.enum(["exact", "omitted-on-continuation"]),
+    summary: z24.object({
+      pages: siteHealthChangeCountsSchema,
+      links: siteHealthChangeCountsSchema
+    }).nullable(),
+    total: z24.number().int().nonnegative().nullable(),
+    nextCursor: z24.string().nullable(),
+    changes: z24.array(siteHealthChangeRecordSchema).default([])
+  })
+]);
+var SITE_HEALTH_CHANGES_DEFAULT_LIMIT = 25;
+var SITE_HEALTH_CHANGES_MAX_LIMIT = 100;
 var siteCrawlInternalLinksResponseSchema = z24.object({
   project: z24.string(),
   hasCrawlData: z24.boolean(),
@@ -14326,11 +14630,34 @@ export {
   factorStatusFromScore,
   SiteAuditTrendDirections,
   siteAuditScoreSchema,
+  siteAuditPageFactorSchema,
   siteAuditPagesResponseSchema,
   siteAuditTrendResponseSchema,
   siteCrawlSummarySchema,
+  SiteCrawlFetchedStates,
+  deriveSiteHealthState,
+  siteCrawlAuditFactorSchema,
+  siteCrawlCriticalDefectSchema,
+  siteCrawlPageAuditSchema,
   siteCrawlPagesResponseSchema,
   siteCrawlStructureResponseSchema,
+  siteCrawlGraphResponseSchema,
+  SITE_CRAWL_GRAPH_DEFAULT_MAX_NODES,
+  SITE_CRAWL_GRAPH_MAX_NODES,
+  SITE_CRAWL_GRAPH_DEFAULT_MAX_EDGES,
+  SITE_CRAWL_GRAPH_MAX_EDGES,
+  siteHealthSubgraphResponseSchema,
+  SITE_HEALTH_SUBGRAPH_DEFAULT_MAX_NODES,
+  SITE_HEALTH_SUBGRAPH_MAX_NODES,
+  SITE_HEALTH_SUBGRAPH_DEFAULT_MAX_EDGES,
+  SITE_HEALTH_SUBGRAPH_MAX_EDGES,
+  siteHealthPathResponseSchema,
+  SITE_HEALTH_PATH_DEFAULT_MAX_DEPTH,
+  SITE_HEALTH_PATH_MAX_DEPTH,
+  SITE_HEALTH_PATH_MAX_VISITED_NODES,
+  siteHealthChangesResponseSchema,
+  SITE_HEALTH_CHANGES_DEFAULT_LIMIT,
+  SITE_HEALTH_CHANGES_MAX_LIMIT,
   siteCrawlInternalLinksResponseSchema,
   siteCrawlNeighborsResponseSchema,
   siteCrawlDeadLinksResponseSchema,

package/dist/{chunk-OSHRDV36.js → chunk-CPASKGUE.js}

@@ -81,7 +81,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-VIKPFI6F.js";
+} from "./chunk-AMPT2EP7.js";
 
 // src/config.ts
 import fs from "fs";
@@ -4919,6 +4919,54 @@ var getApiV1ProjectsByNameTechnicalAeoCrawl = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameTechnicalAeoSubgraph = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/technical-aeo/subgraph",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameTechnicalAeoPath = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/technical-aeo/path",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameTechnicalAeoChanges = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/technical-aeo/changes",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameTechnicalAeoCrawlPagesAudit = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/technical-aeo/crawl/pages/audit",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameTechnicalAeoCrawlPages = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -7123,6 +7171,57 @@ var ApiClient = class {
       })
     );
   }
+  /** Bounded semantic Site Health neighborhood; this never returns visualization layout. */
+  async getSiteHealthSubgraph(project, opts) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameTechnicalAeoSubgraph({
+        client: this.heyClient,
+        path: { name: project },
+        query: {
+          runId: opts?.runId,
+          nodeKey: opts?.nodeKey,
+          url: opts?.url,
+          hops: opts?.hops,
+          maxNodes: opts?.maxNodes,
+          maxEdges: opts?.maxEdges
+        }
+      })
+    );
+  }
+  /** Directed shortest path over persisted, followable internal links. */
+  async getSiteHealthPath(project, opts) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameTechnicalAeoPath({
+        client: this.heyClient,
+        path: { name: project },
+        query: {
+          runId: opts.runId,
+          fromNodeKey: opts.fromNodeKey,
+          fromUrl: opts.fromUrl,
+          toNodeKey: opts.toNodeKey,
+          toUrl: opts.toUrl,
+          maxDepth: opts.maxDepth
+        }
+      })
+    );
+  }
+  /** Cursor-paged canonical page/link changes between immutable complete crawls. */
+  async getSiteHealthChanges(project, opts) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameTechnicalAeoChanges({
+        client: this.heyClient,
+        path: { name: project },
+        query: {
+          fromRunId: opts?.fromRunId,
+          toRunId: opts?.toRunId,
+          scope: opts?.scope,
+          change: opts?.change,
+          cursor: opts?.cursor,
+          limit: opts?.limit
+        }
+      })
+    );
+  }
   /** Bounded, cursor-paged crawl nodes. */
   async getTechnicalAeoCrawlPages(project, opts) {
     return this.invoke(
@@ -7142,6 +7241,20 @@ var ApiClient = class {
       })
     );
   }
+  /** Exact page-scoped audit evidence tied to a persisted crawl node. */
+  async getTechnicalAeoPageAudit(project, opts) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameTechnicalAeoCrawlPagesAudit({
+        client: this.heyClient,
+        path: { name: project },
+        query: {
+          runId: opts.runId,
+          nodeKey: opts.nodeKey,
+          url: opts.url
+        }
+      })
+    );
+  }
   /** One bounded path level from a persisted crawl. */
   async getTechnicalAeoStructure(project, opts) {
     return this.invoke(
@@ -8375,6 +8488,59 @@ var technicalAeoCrawlInputSchema = z3.object({
   project: projectNameSchema,
   runId: runIdSchema.optional().describe("Historical crawl-bearing site-audit run ID. Omit for the latest persisted crawl.")
 });
+var siteHealthPageAuditInputSchema = z3.object({
+  project: projectNameSchema,
+  runId: runIdSchema.optional().describe("Historical crawl-bearing site-audit run ID. Omit for the latest persisted crawl."),
+  nodeKey: z3.string().min(1).optional().describe("Exact crawl node key, as returned by Site Health page or subgraph reads."),
+  url: z3.string().url().optional().describe("Exact page URL. Use this only when a crawl node key is unavailable.")
+}).refine((value) => Boolean(value.nodeKey || value.url), {
+  message: "Provide nodeKey or url.",
+  path: ["nodeKey"]
+}).refine((value) => !(value.nodeKey && value.url), {
+  message: "Provide nodeKey or url, not both.",
+  path: ["nodeKey"]
+});
+var SITE_HEALTH_MCP_MAX_NODES = 25;
+var SITE_HEALTH_MCP_MAX_EDGES = 50;
+var siteHealthSubgraphInputSchema = z3.object({
+  project: projectNameSchema,
+  runId: runIdSchema.optional().describe("Historical crawl-bearing site-audit run ID. Omit for the latest complete crawl."),
+  nodeKey: z3.string().min(1).optional().describe("Focus crawl node key. Omit with url to focus the crawl root."),
+  url: z3.string().url().optional().describe("Focus canonical URL. Omit with nodeKey to focus the crawl root."),
+  hops: z3.number().int().min(0).max(3).optional().describe("Neighborhood depth from the focus node. Keep this small."),
+  maxNodes: z3.number().int().positive().max(SITE_HEALTH_MCP_MAX_NODES).default(SITE_HEALTH_MCP_MAX_NODES).describe("Hard MCP cap: at most 25 nodes. Narrow or refocus instead of loading the site."),
+  maxEdges: z3.number().int().positive().max(SITE_HEALTH_MCP_MAX_EDGES).default(SITE_HEALTH_MCP_MAX_EDGES).describe("Hard MCP cap: at most 50 edges. Narrow or refocus instead of loading the site.")
+}).refine((value) => !(value.nodeKey && value.url), {
+  message: "Provide nodeKey or url, not both.",
+  path: ["nodeKey"]
+});
+var siteHealthPathInputSchema = z3.object({
+  project: projectNameSchema,
+  runId: runIdSchema.optional().describe("Historical crawl-bearing site-audit run ID. Omit for the latest complete crawl."),
+  fromNodeKey: z3.string().min(1).optional().describe("Origin node key. Omit with fromUrl to start at the crawl root."),
+  fromUrl: z3.string().url().optional().describe("Origin URL. Omit with fromNodeKey to start at the crawl root."),
+  toNodeKey: z3.string().min(1).optional().describe("Required destination node key."),
+  toUrl: z3.string().url().optional().describe("Required destination URL."),
+  maxDepth: z3.number().int().positive().max(24).optional().describe("Maximum directed-link depth to search.")
+}).refine((value) => !(value.fromNodeKey && value.fromUrl), {
+  message: "Provide fromNodeKey or fromUrl, not both.",
+  path: ["fromNodeKey"]
+}).refine((value) => Boolean(value.toNodeKey || value.toUrl), {
+  message: "Provide toNodeKey or toUrl.",
+  path: ["toNodeKey"]
+}).refine((value) => !(value.toNodeKey && value.toUrl), {
+  message: "Provide toNodeKey or toUrl, not both.",
+  path: ["toNodeKey"]
+});
+var siteHealthChangesInputSchema = z3.object({
+  project: projectNameSchema,
+  fromRunId: runIdSchema.optional().describe("Earlier complete crawl run ID. Omit to compare the previous complete crawl."),
+  toRunId: runIdSchema.optional().describe("Later complete crawl run ID. Omit to compare the latest complete crawl."),
+  scope: z3.enum(["all", "pages", "links"]).optional().describe("Limit the diff to page or link changes. Omit or use all for both."),
+  change: z3.enum(["all", "added", "removed", "changed"]).optional().describe("Limit the diff to one change kind. Omit or use all for every kind."),
+  cursor: z3.string().min(1).optional().describe("Opaque cursor from the previous Site Health changes result."),
+  limit: z3.number().int().positive().max(25).default(25).describe("Hard MCP cap: 25 records, because each change carries before and after DTOs.")
+});
 var technicalAeoCrawlPagesInputSchema = z3.object({
   project: projectNameSchema,
   runId: runIdSchema.optional(),
@@ -10234,6 +10400,86 @@ var canonryMcpTools = [
     openApiOperations: ["POST /api/v1/projects/{name}/discover/sessions/{id}/promote"],
     handler: (client2, input) => client2.promoteDiscovery(input.project, input.sessionId, input.request)
   }),
+  defineTool({
+    name: "canonry_site_health_overview",
+    title: "Get Site Health overview",
+    description: "Start a Site Health investigation with the latest or selected scan summary: root URL, completeness, crawl and link counts, budgets, versions, termination, and dead-link check state. Follow with a focused Site Health subgraph, shortest path, or scan changes; never request the interactive graph projection through MCP.",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: technicalAeoCrawlInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/technical-aeo/crawl"],
+    handler: (client2, input) => client2.getTechnicalAeoCrawl(input.project, { runId: input.runId })
+  }),
+  defineTool({
+    name: "canonry_site_health_page_audit",
+    title: "Get Site Health page audit",
+    description: "Connect one graph page's audit score to its exact persisted evidence: factor scores, stable finding codes and messages, recommendations, and critical defects. The response includes crawl provenance and explicit no-crawl, details-unavailable, not-found, not-audited, ready/scores-only states. Use nodeKey from a Site Health page or subgraph read when possible. Link score remains an importance signal, not an audit finding.",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: siteHealthPageAuditInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/technical-aeo/crawl/pages/audit"],
+    handler: (client2, input) => client2.getTechnicalAeoPageAudit(input.project, {
+      runId: input.runId,
+      nodeKey: input.nodeKey,
+      url: input.url
+    })
+  }),
+  defineTool({
+    name: "canonry_site_health_subgraph",
+    title: "Inspect focused Site Health subgraph",
+    description: "Read a compact canonical neighborhood around one page or the crawl root. Defaults to 25 nodes and 50 edges; expand hops or refocus only when needed. `countAccuracy=lower-bound` means traversal reached a cap, and `complete`/`termination` qualify partial-crawl results. This intentionally omits visualization coordinates and never materializes the full site graph.",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: siteHealthSubgraphInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/technical-aeo/subgraph"],
+    handler: (client2, input) => client2.getSiteHealthSubgraph(input.project, {
+      runId: input.runId,
+      nodeKey: input.nodeKey,
+      url: input.url,
+      hops: input.hops,
+      maxNodes: input.maxNodes,
+      maxEdges: input.maxEdges
+    })
+  }),
+  defineTool({
+    name: "canonry_site_health_path",
+    title: "Find shortest Site Health path",
+    description: "Find the shortest directed path of followable internal links from the crawl root or a selected page to one required destination. Use `complete` and `termination` to qualify unreachable or truncated outcomes from a partial crawl; it returns one path, not a graph traversal.",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: siteHealthPathInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/technical-aeo/path"],
+    handler: (client2, input) => client2.getSiteHealthPath(input.project, {
+      runId: input.runId,
+      fromNodeKey: input.fromNodeKey,
+      fromUrl: input.fromUrl,
+      toNodeKey: input.toNodeKey,
+      toUrl: input.toUrl,
+      maxDepth: input.maxDepth
+    })
+  }),
+  defineTool({
+    name: "canonry_site_health_changes",
+    title: "Compare Site Health scans",
+    description: "Compare two immutable complete scans (or the latest pair) for added, removed, and changed canonical pages or links. Results echo resolved filters and scan IDs; the first page has an exact summary, while continuations omit summary/total. MCP pages cap at 25 because every change carries before/after DTOs; filter before paging.",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: siteHealthChangesInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/technical-aeo/changes"],
+    handler: (client2, input) => client2.getSiteHealthChanges(input.project, {
+      fromRunId: input.fromRunId,
+      toRunId: input.toRunId,
+      scope: input.scope,
+      change: input.change,
+      cursor: input.cursor,
+      limit: input.limit
+    })
+  }),
   defineTool({
     name: "canonry_technical_aeo_score",
     title: "Get Technical AEO score",