@canonry/canonry 4.154.1 → 4.155.0

package/dist/cli.js

@@ -30,7 +30,7 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-JOP2DGXL.js";
+} from "./chunk-YSESZNVT.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -50,7 +50,7 @@ import {
   saveConfigPatch,
   systemError,
   usageError
-} from "./chunk-ANSQ6JNO.js";
+} from "./chunk-OSHRDV36.js";
 import {
   apiKeys,
   createClient,
@@ -58,7 +58,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-KRMLGFY3.js";
+} from "./chunk-VOL2BSM5.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -122,7 +122,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-NNW7TJUZ.js";
+} from "./chunk-VIKPFI6F.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -13829,11 +13829,154 @@ async function technicalAeoTrend(project, opts) {
   }
   console.log(lines.join("\n"));
 }
+async function technicalAeoCrawl(project, opts) {
+  const crawl = await getClient27().getTechnicalAeoCrawl(project, { runId: opts.runId });
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(crawl, null, 2));
+    return;
+  }
+  if (!crawl.hasCrawlData) {
+    console.log(`No persisted site crawl for "${project}". Run \`canonry technical-aeo run ${project}\` first.`);
+    return;
+  }
+  const lines = [
+    `Site crawl: ${crawl.complete ? "complete" : "partial"} (${crawl.runStatus ?? "unknown"})`,
+    `Root: ${crawl.rootUrl ?? "-"}`,
+    `Pages: ${crawl.counts.pagesFetched} fetched \xB7 ${crawl.counts.pagesDiscovered} discovered \xB7 ${crawl.counts.pagesEligible} eligible`,
+    `Links: ${crawl.counts.edges} internal/external observations \xB7 ${crawl.counts.findings} findings`,
+    `Dead links: ${formatDeadLinkState(crawl.deadLinks)}`
+  ];
+  if (crawl.termination) lines.push(`Stopped: ${crawl.termination}`);
+  console.log(lines.join("\n"));
+}
+async function technicalAeoCrawlPages(project, opts) {
+  const res = await getClient27().getTechnicalAeoCrawlPages(project, opts);
+  if (opts.format === "jsonl") {
+    emitJsonl(res.pages.map((page) => ({ project, runId: res.runId, ...page })));
+    return;
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  if (res.pages.length === 0) {
+    console.log(`No persisted crawl pages for "${project}".`);
+    return;
+  }
+  const lines = [`${res.pages.length} of ${res.total} crawl page(s)${res.nextCursor ? " (more available)" : ""}:`, ""];
+  lines.push(`${"Depth".padStart(5)}  ${"Score".padStart(5)}  ${"Indexability".padEnd(15)}  URL`);
+  for (const page of res.pages) {
+    lines.push(`${String(page.depth ?? "-").padStart(5)}  ${String(page.auditScore ?? "-").padStart(5)}  ${page.indexabilityState.slice(0, 15).padEnd(15)}  ${page.url}`);
+  }
+  if (res.nextCursor) lines.push(`
+Next cursor: ${res.nextCursor}`);
+  console.log(lines.join("\n"));
+}
+async function technicalAeoStructure(project, opts) {
+  const res = await getClient27().getTechnicalAeoStructure(project, opts);
+  if (opts.format === "jsonl") {
+    emitJsonl(res.children.map((child) => ({ project, runId: res.runId, parentPath: res.parentPath, ...child })));
+    return;
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  if (res.children.length === 0) {
+    console.log(`No crawl structure below ${res.parentPath} for "${project}".`);
+    return;
+  }
+  const lines = [`${res.children.length} child path(s) below ${res.parentPath}${res.nextCursor ? " (more available)" : ""}:`, ""];
+  for (const child of res.children) {
+    lines.push(`${String(child.pageCount).padStart(5)} pages  ${String(child.inventoryEligibleCount).padStart(5)} eligible  ${child.path}`);
+  }
+  if (res.nextCursor) lines.push(`
+Next cursor: ${res.nextCursor}`);
+  console.log(lines.join("\n"));
+}
+async function technicalAeoInternalLinks(project, opts) {
+  const res = await getClient27().getTechnicalAeoInternalLinks(project, opts);
+  if (opts.format === "jsonl") {
+    emitJsonl(res.edges.map((edge) => ({ project, runId: res.runId, ...edge })));
+    return;
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  if (res.edges.length === 0) {
+    console.log(`No persisted internal links for "${project}".`);
+    return;
+  }
+  const lines = [`${res.edges.length} of ${res.total} internal link(s)${res.nextCursor ? " (more available)" : ""}:`, ""];
+  for (const edge of res.edges) {
+    lines.push(`${edge.followable ? "follow" : "nofollow"} \xD7${edge.occurrences}  ${edge.sourceUrl} \u2192 ${edge.targetUrl}`);
+  }
+  if (res.nextCursor) lines.push(`
+Next cursor: ${res.nextCursor}`);
+  console.log(lines.join("\n"));
+}
+async function technicalAeoLinkNeighbors(project, opts) {
+  const res = await getClient27().getTechnicalAeoInternalLinkNeighbors(project, opts);
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  const title = res.url ?? res.nodeKey ?? "page";
+  const lines = [`Internal links for ${title}:`, "", "Inbound:"];
+  for (const edge of res.inbound) lines.push(`  ${edge.sourceUrl} \u2192 ${edge.targetUrl}`);
+  if (res.inbound.length === 0) lines.push("  (none)");
+  if (res.inboundTruncated) lines.push("  (truncated)");
+  lines.push("", "Outbound:");
+  for (const edge of res.outbound) lines.push(`  ${edge.sourceUrl} \u2192 ${edge.targetUrl}`);
+  if (res.outbound.length === 0) lines.push("  (none)");
+  if (res.outboundTruncated) lines.push("  (truncated)");
+  console.log(lines.join("\n"));
+}
+async function technicalAeoDeadLinks(project, opts) {
+  const res = await getClient27().getTechnicalAeoDeadLinks(project, opts);
+  if (opts.format === "jsonl") {
+    if ("deadLinks" in res) {
+      const { deadLinks, ...header } = res;
+      emitJsonl([{ kind: "technical-aeo-dead-links-header", ...header }]);
+      emitJsonl(deadLinks.map((finding) => ({ project, runId: res.runId, state: res.state, ...finding })));
+    } else {
+      emitJsonl([{ kind: "technical-aeo-dead-links-header", ...res }]);
+    }
+    return;
+  }
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  if (res.state === "disabled") {
+    console.log(`Dead-link checks were disabled for crawl ${res.runId}. Re-run with \`--check-dead-links\` to enable them.`);
+    return;
+  }
+  if (res.state === "unavailable") {
+    console.log(`No dead-link check is available for "${project}".`);
+    return;
+  }
+  const lines = [`Dead links: ${res.found} found from ${res.checked} checked (${res.state})`];
+  for (const finding of res.deadLinks) lines.push(`${finding.sourceUrl ?? "-"} \u2192 ${finding.targetUrl ?? "-"}`);
+  if (res.nextCursor) lines.push(`Next cursor: ${res.nextCursor}`);
+  console.log(lines.join("\n"));
+}
+function formatDeadLinkState(value) {
+  if (value.state === "disabled") return "disabled (opt in with --check-dead-links)";
+  if (value.state === "unavailable") return "unavailable";
+  return `${value.found ?? 0} found / ${value.checked ?? 0} checked (${value.state})`;
+}
 async function technicalAeoRun(project, opts) {
   const client = getClient27();
   const { runId, status } = await client.triggerSiteAudit(project, {
     sitemapUrl: opts.sitemapUrl,
-    limit: opts.limit
+    limit: opts.limit,
+    maxPages: opts.maxPages,
+    maxEdges: opts.maxEdges,
+    maxDepth: opts.maxDepth,
+    // Explicit opt-in: absence and false are both intentionally disabled.
+    checkDeadLinks: opts.checkDeadLinks === true
   });
   if (!opts.wait) {
     if (isMachineFormat(opts.format)) {
@@ -13865,6 +14008,17 @@ async function technicalAeoRun(project, opts) {
 }
 
 // src/cli-commands/technical-aeo.ts
+function parseOptionalBoolean(input, key, config) {
+  const value = getString(input.values, key);
+  if (value === void 0) return void 0;
+  if (value === "true") return true;
+  if (value === "false") return false;
+  throw usageError(`Error: --${key} must be true or false
+Usage: ${config.usage}`, {
+    message: `--${key} must be true or false`,
+    details: { command: config.command, usage: config.usage, option: key, value }
+  });
+}
 var TECHNICAL_AEO_CLI_COMMANDS = [
   {
     path: ["technical-aeo", "score"],
@@ -13927,14 +14081,18 @@ var TECHNICAL_AEO_CLI_COMMANDS = [
   },
   {
     path: ["technical-aeo", "run"],
-    usage: "canonry technical-aeo run <project> [--sitemap-url <url>] [--limit <n>] [--wait] [--format json]",
+    usage: "canonry technical-aeo run <project> [--sitemap-url <url>] [--max-pages <n>] [--max-edges <n>] [--max-depth <n>] [--check-dead-links] [--wait] [--format json]",
     options: {
       "sitemap-url": stringOption(),
       limit: stringOption(),
+      "max-pages": stringOption(),
+      "max-edges": stringOption(),
+      "max-depth": stringOption(),
+      "check-dead-links": { type: "boolean", default: false },
       wait: { type: "boolean", default: false }
     },
     run: async (input) => {
-      const usage = "canonry technical-aeo run <project> [--sitemap-url <url>] [--limit <n>] [--wait] [--format json]";
+      const usage = "canonry technical-aeo run <project> [--sitemap-url <url>] [--max-pages <n>] [--max-edges <n>] [--max-depth <n>] [--check-dead-links] [--wait] [--format json]";
       const project = requireProject(input, "technical-aeo.run", usage);
       await technicalAeoRun(project, {
         sitemapUrl: getString(input.values, "sitemap-url"),
@@ -13943,10 +14101,164 @@ var TECHNICAL_AEO_CLI_COMMANDS = [
           usage,
           message: "--limit must be an integer"
         }),
+        maxPages: parseIntegerOption(input, "max-pages", {
+          command: "technical-aeo.run",
+          usage,
+          message: "--max-pages must be an integer"
+        }),
+        maxEdges: parseIntegerOption(input, "max-edges", {
+          command: "technical-aeo.run",
+          usage,
+          message: "--max-edges must be an integer"
+        }),
+        maxDepth: parseIntegerOption(input, "max-depth", {
+          command: "technical-aeo.run",
+          usage,
+          message: "--max-depth must be an integer"
+        }),
+        checkDeadLinks: getBoolean(input.values, "check-dead-links"),
         wait: getBoolean(input.values, "wait"),
         format: input.format
       });
     }
+  },
+  {
+    path: ["technical-aeo", "crawl"],
+    usage: "canonry technical-aeo crawl <project> [--run-id <id>] [--format json]",
+    options: { "run-id": stringOption() },
+    run: async (input) => {
+      const usage = "canonry technical-aeo crawl <project> [--run-id <id>] [--format json]";
+      const project = requireProject(input, "technical-aeo.crawl", usage);
+      await technicalAeoCrawl(project, { runId: getString(input.values, "run-id"), format: input.format });
+    }
+  },
+  {
+    path: ["technical-aeo", "crawl-pages"],
+    usage: "canonry technical-aeo crawl-pages <project> [--run-id <id>] [--inventory-eligible true|false] [--fetch-state <state>] [--indexability-state <state>] [--audit-state <state>] [--sort url|path|score-asc|score-desc] [--cursor <cursor>] [--limit <n>] [--format json|jsonl]",
+    options: {
+      "run-id": stringOption(),
+      "inventory-eligible": stringOption(),
+      "fetch-state": stringOption(),
+      "indexability-state": stringOption(),
+      "audit-state": stringOption(),
+      sort: stringOption(),
+      cursor: stringOption(),
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry technical-aeo crawl-pages <project> [--run-id <id>] [--inventory-eligible true|false] [--fetch-state <state>] [--indexability-state <state>] [--audit-state <state>] [--sort url|path|score-asc|score-desc] [--cursor <cursor>] [--limit <n>] [--format json|jsonl]";
+      const project = requireProject(input, "technical-aeo.crawl-pages", usage);
+      const sort = getString(input.values, "sort");
+      if (sort !== void 0 && !["url", "path", "score-asc", "score-desc"].includes(sort)) {
+        throw usageError(`Error: --sort must be url, path, score-asc, or score-desc
+Usage: ${usage}`, {
+          message: "--sort must be url, path, score-asc, or score-desc",
+          details: { command: "technical-aeo.crawl-pages", usage, option: "sort", value: sort }
+        });
+      }
+      await technicalAeoCrawlPages(project, {
+        runId: getString(input.values, "run-id"),
+        inventoryEligible: parseOptionalBoolean(input, "inventory-eligible", { command: "technical-aeo.crawl-pages", usage }),
+        fetchState: getString(input.values, "fetch-state"),
+        indexabilityState: getString(input.values, "indexability-state"),
+        auditState: getString(input.values, "audit-state"),
+        sort,
+        cursor: getString(input.values, "cursor"),
+        limit: parseIntegerOption(input, "limit", { command: "technical-aeo.crawl-pages", usage, message: "--limit must be an integer" }),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["technical-aeo", "structure"],
+    usage: "canonry technical-aeo structure <project> [--run-id <id>] [--parent-path <path>] [--cursor <cursor>] [--limit <n>] [--format json|jsonl]",
+    options: { "run-id": stringOption(), "parent-path": stringOption(), cursor: stringOption(), limit: stringOption() },
+    run: async (input) => {
+      const usage = "canonry technical-aeo structure <project> [--run-id <id>] [--parent-path <path>] [--cursor <cursor>] [--limit <n>] [--format json|jsonl]";
+      const project = requireProject(input, "technical-aeo.structure", usage);
+      await technicalAeoStructure(project, {
+        runId: getString(input.values, "run-id"),
+        parentPath: getString(input.values, "parent-path"),
+        cursor: getString(input.values, "cursor"),
+        limit: parseIntegerOption(input, "limit", { command: "technical-aeo.structure", usage, message: "--limit must be an integer" }),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["technical-aeo", "links"],
+    usage: "canonry technical-aeo links <project> [--run-id <id>] [--source-url <url>] [--target-url <url>] [--followable|--nofollow] [--cursor <cursor>] [--limit <n>] [--format json|jsonl]",
+    options: {
+      "run-id": stringOption(),
+      "source-url": stringOption(),
+      "target-url": stringOption(),
+      followable: { type: "boolean", default: false },
+      nofollow: { type: "boolean", default: false },
+      cursor: stringOption(),
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry technical-aeo links <project> [--run-id <id>] [--source-url <url>] [--target-url <url>] [--followable|--nofollow] [--cursor <cursor>] [--limit <n>] [--format json|jsonl]";
+      const project = requireProject(input, "technical-aeo.links", usage);
+      const followable = getBoolean(input.values, "followable");
+      const nofollow = getBoolean(input.values, "nofollow");
+      if (followable && nofollow) {
+        throw usageError(`Error: --followable and --nofollow cannot be combined
+Usage: ${usage}`, {
+          message: "--followable and --nofollow cannot be combined",
+          details: { command: "technical-aeo.links", usage }
+        });
+      }
+      await technicalAeoInternalLinks(project, {
+        runId: getString(input.values, "run-id"),
+        sourceUrl: getString(input.values, "source-url"),
+        targetUrl: getString(input.values, "target-url"),
+        followable: followable ? true : nofollow ? false : void 0,
+        cursor: getString(input.values, "cursor"),
+        limit: parseIntegerOption(input, "limit", { command: "technical-aeo.links", usage, message: "--limit must be an integer" }),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["technical-aeo", "links", "neighbors"],
+    usage: "canonry technical-aeo links neighbors <project> (--node-key <key>|--url <url>) [--run-id <id>] [--limit <n>] [--format json]",
+    options: { "run-id": stringOption(), "node-key": stringOption(), url: stringOption(), limit: stringOption() },
+    run: async (input) => {
+      const usage = "canonry technical-aeo links neighbors <project> (--node-key <key>|--url <url>) [--run-id <id>] [--limit <n>] [--format json]";
+      const project = requireProject(input, "technical-aeo.links.neighbors", usage);
+      const nodeKey = getString(input.values, "node-key");
+      const url = getString(input.values, "url");
+      if (!nodeKey && !url) {
+        throw usageError(`Error: --node-key or --url is required
+Usage: ${usage}`, {
+          message: "--node-key or --url is required",
+          details: { command: "technical-aeo.links.neighbors", usage }
+        });
+      }
+      await technicalAeoLinkNeighbors(project, {
+        runId: getString(input.values, "run-id"),
+        nodeKey,
+        url,
+        limit: parseIntegerOption(input, "limit", { command: "technical-aeo.links.neighbors", usage, message: "--limit must be an integer" }),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["technical-aeo", "dead-links"],
+    usage: "canonry technical-aeo dead-links <project> [--run-id <id>] [--cursor <cursor>] [--limit <n>] [--format json|jsonl]",
+    options: { "run-id": stringOption(), cursor: stringOption(), limit: stringOption() },
+    run: async (input) => {
+      const usage = "canonry technical-aeo dead-links <project> [--run-id <id>] [--cursor <cursor>] [--limit <n>] [--format json|jsonl]";
+      const project = requireProject(input, "technical-aeo.dead-links", usage);
+      await technicalAeoDeadLinks(project, {
+        runId: getString(input.values, "run-id"),
+        cursor: getString(input.values, "cursor"),
+        limit: parseIntegerOption(input, "limit", { command: "technical-aeo.dead-links", usage, message: "--limit must be an integer" }),
+        format: input.format
+      });
+    }
   }
 ];
 

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-JOP2DGXL.js";
+} from "./chunk-YSESZNVT.js";
 import {
   loadConfig
-} from "./chunk-ANSQ6JNO.js";
-import "./chunk-KRMLGFY3.js";
-import "./chunk-NNW7TJUZ.js";
+} from "./chunk-OSHRDV36.js";
+import "./chunk-VOL2BSM5.js";
+import "./chunk-VIKPFI6F.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-ZY5KOSZV.js → intelligence-service-G4NV3X36.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-KRMLGFY3.js";
-import "./chunk-NNW7TJUZ.js";
+} from "./chunk-VOL2BSM5.js";
+import "./chunk-VIKPFI6F.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-ANSQ6JNO.js";
+} from "./chunk-OSHRDV36.js";
 import {
   isReadOnlyKey
-} from "./chunk-NNW7TJUZ.js";
+} from "./chunk-VIKPFI6F.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "4.154.1",
+  "version": "4.155.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -39,7 +39,7 @@
     "node": ">=22.14.0"
   },
   "dependencies": {
-    "@ainyc/aeo-audit": "4.0.1",
+    "@canonry/aeo-audit": "4.6.2",
     "@anthropic-ai/sdk": "^0.91.1",
     "@fastify/rate-limit": "^11.2.0",
     "@fastify/static": "^9.1.1",
@@ -68,21 +68,21 @@
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0",