@canonry/canonry 4.155.0 → 4.157.0

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

@@ -81,7 +81,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-VIKPFI6F.js";
+} from "./chunk-TRRVBTU5.js";
 
 // src/config.ts
 import fs from "fs";
@@ -107,6 +107,14 @@ function normalizeWordpressConfig(config) {
     defaultEnv: connection.defaultEnv ?? "live"
   }));
 }
+function normalizeCloudflareTrafficConfig(config) {
+  for (const connection of config.cloudflareTraffic?.connections ?? []) {
+    const legacy = connection;
+    if (legacy.deliveryMode === void 0) {
+      legacy.deliveryMode = "direct-push";
+    }
+  }
+}
 function getConfigDir() {
   const override = process.env.CANONRY_CONFIG_DIR?.trim();
   if (override) {
@@ -152,6 +160,7 @@ Do not write config.yaml by hand; use "canonry init", "canonry settings", or "ca
   }
   normalizeGoogleConfig(parsed);
   normalizeWordpressConfig(parsed);
+  normalizeCloudflareTrafficConfig(parsed);
   const portOverride = process.env.CANONRY_PORT?.trim();
   if (portOverride) {
     try {
@@ -4695,6 +4704,22 @@ var postApiV1ProjectsByNameTrafficConnectVercel = (options) => {
     }
   });
 };
+var postApiV1ProjectsByNameTrafficConnectCloudflare = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/traffic/connect/cloudflare",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 var postApiV1ProjectsByNameTrafficSourcesByIdSync = (options) => {
   return (options.client ?? client).post({
     security: [
@@ -4919,6 +4944,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: [
@@ -6934,6 +7007,15 @@ var ApiClient = class {
       })
     );
   }
+  async trafficConnectCloudflare(project, body) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameTrafficConnectCloudflare({
+        client: this.heyClient,
+        path: { name: project },
+        body
+      })
+    );
+  }
   async trafficSync(project, sourceId, body) {
     return this.invoke(
       () => postApiV1ProjectsByNameTrafficSourcesByIdSync({
@@ -7123,6 +7205,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 +7275,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 +8522,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 +10434,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",