@ainyc/canonry 4.72.3 → 4.74.0

package/dist/cli.js

@@ -27,7 +27,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-SIB4NMEH.js";
+} from "./chunk-MRC4JMIH.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -44,7 +44,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-ZUBBADMR.js";
+} from "./chunk-W6GBIRFA.js";
 import {
   apiKeys,
   createClient,
@@ -52,7 +52,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-HSX32G47.js";
+} from "./chunk-ZRZHIS22.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -63,6 +63,7 @@ import {
   discoveryBucketSchema,
   discoveryCompetitorTypeSchema,
   effectiveDomains,
+  factorStatusFromScore,
   formatGbpMetricLabel,
   formatIsoDate,
   formatRunErrorOneLine,
@@ -71,7 +72,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-JXFNERK4.js";
+} from "./chunk-A7JX3FZB.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -8510,7 +8511,7 @@ function renderCover(pdf, report) {
     hour: "numeric",
     minute: "2-digit"
   }));
-  pdf.keyValue("AEO Audit", `${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
+  pdf.keyValue("AEO Audit", `${report.audit.overallScore}/100`);
   pdf.keyValue("Visibility Gap (Citations + Mentions)", report.summary.visibilityGap);
   pdf.paragraph(report.profile.summary, { size: 11, color: INK, lineHeight: 16 });
   pdf.rule();
@@ -8532,7 +8533,7 @@ function renderAudit(pdf, report) {
   const factorRows = [...report.audit.factors].sort((a, b) => a.score - b.score || a.name.localeCompare(b.name)).slice(0, 5).map((factor) => [
     factor.name,
     formatAuditFactorScore(factor),
-    factor.status
+    factorStatusFromScore(factor.score)
   ]);
   if (factorRows.length > 0) {
     pdf.table(["Weakest factor", "Score / Weight", "Status"], factorRows, [270, 120, 126]);
@@ -8664,7 +8665,7 @@ function formatSnapshotMarkdown(report) {
   lines.push("");
   lines.push(`**Domain:** ${report.domain}`);
   lines.push(`**Generated:** ${new Date(report.generatedAt).toLocaleString("en-US", { year: "numeric", month: "long", day: "numeric", hour: "numeric", minute: "2-digit" })}`);
-  lines.push(`**AEO Audit Score:** ${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
+  lines.push(`**AEO Audit Score:** ${report.audit.overallScore}/100`);
   lines.push("");
   lines.push("## Visibility Gap (Citations + Mentions)");
   lines.push("");
@@ -8725,7 +8726,7 @@ function formatSnapshotMarkdown(report) {
     lines.push("|--------|-------|--------|--------|");
     const sorted = [...report.audit.factors].sort((a, b) => a.score - b.score);
     for (const factor of sorted) {
-      lines.push(`| ${factor.name} | ${factor.score} | ${factor.weight} | ${factor.status} |`);
+      lines.push(`| ${factor.name} | ${factor.score} | ${factor.weight} | ${factorStatusFromScore(factor.score)} |`);
     }
     lines.push("");
   }
@@ -8736,7 +8737,7 @@ function formatSnapshotMarkdown(report) {
 function formatSnapshotText(report) {
   const lines = [];
   lines.push(`Snapshot: ${report.companyName} (${report.domain})`);
-  lines.push(`AEO audit: ${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
+  lines.push(`AEO audit: ${report.audit.overallScore}/100`);
   lines.push(report.summary.visibilityGap);
   lines.push("");
   if (report.summary.topCompetitors.length > 0) {
@@ -10698,11 +10699,215 @@ var SYSTEM_CLI_COMMANDS = [
   }
 ];
 
+// src/commands/technical-aeo.ts
+function getClient24() {
+  return createApiClient();
+}
+async function technicalAeoScore(project, opts) {
+  const client = getClient24();
+  const score = await client.getTechnicalAeoScore(project);
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(score, null, 2));
+    return;
+  }
+  if (!score.hasData) {
+    console.log(
+      `No technical audit yet for "${project}". Run \`canonry technical-aeo run ${project}\` to generate one.`
+    );
+    return;
+  }
+  const lines = [];
+  const delta = score.deltaScore == null ? "" : ` (${score.deltaScore >= 0 ? "+" : ""}${score.deltaScore} vs prev)`;
+  lines.push(`Technical AEO: ${score.aggregateScore}/100${delta}`);
+  lines.push(
+    `Audited ${score.pagesAudited} page(s) \xB7 ${score.pagesSkipped} skipped \xB7 ${score.pagesErrored} errored \xB7 sitemap ${score.sitemapUrl}`
+  );
+  lines.push(`As of ${score.auditedAt}`);
+  if (score.factors.length > 0) {
+    lines.push("");
+    lines.push(`${"Factor".padEnd(32)}${"Wt".padStart(4)}${"Avg".padStart(6)}${"Status".padStart(9)}   Pass/Part/Fail`);
+    for (const f of score.factors) {
+      lines.push(
+        `${f.name.slice(0, 31).padEnd(32)}${String(f.weight).padStart(4)}${String(f.avgScore).padStart(6)}${f.status.padStart(9)}   ${f.pagesPassing}/${f.pagesPartial}/${f.pagesFailing}`
+      );
+    }
+  }
+  if (score.prioritizedFixes.length > 0) {
+    lines.push("");
+    lines.push("Prioritized fixes:");
+    score.prioritizedFixes.forEach((fix, i) => lines.push(`  ${i + 1}. ${fix}`));
+  }
+  console.log(lines.join("\n"));
+}
+async function technicalAeoPages(project, opts) {
+  const client = getClient24();
+  const status = opts.status === "success" || opts.status === "error" ? opts.status : void 0;
+  const res = await client.getTechnicalAeoPages(project, { status, sort: opts.sort, limit: opts.limit });
+  if (opts.format === "jsonl") {
+    emitJsonl(res.pages.map((p) => ({ project, runId: res.runId, ...p })));
+    return;
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  if (res.pages.length === 0) {
+    console.log(`No audited pages for "${project}". Run \`canonry technical-aeo run ${project}\` first.`);
+    return;
+  }
+  const lines = [];
+  lines.push(`${res.pages.length} of ${res.total} page(s) from run ${res.runId}:
+`);
+  lines.push(`${"Score".padStart(5)}  ${"Status".padEnd(7)}  URL`);
+  for (const p of res.pages) {
+    const tail = p.status === "error" ? `  ${p.error ?? "error"}` : "";
+    lines.push(`${String(p.overallScore).padStart(5)}  ${p.status.padEnd(7)}  ${p.url}${tail}`);
+  }
+  console.log(lines.join("\n"));
+}
+async function technicalAeoTrend(project, opts) {
+  const client = getClient24();
+  const res = await client.getTechnicalAeoTrend(project, { limit: opts.limit });
+  if (opts.format === "jsonl") {
+    emitJsonl(res.points.map((p) => ({ project, ...p })));
+    return;
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  if (res.points.length === 0) {
+    console.log(`No audits yet for "${project}". Run \`canonry technical-aeo run ${project}\` first.`);
+    return;
+  }
+  const lines = [];
+  lines.push(`${"Date".padEnd(26)}  ${"Score".padStart(5)}  Pages`);
+  for (const p of res.points) {
+    lines.push(`${p.auditedAt.padEnd(26)}  ${String(p.aggregateScore).padStart(5)}  ${p.pagesAudited}`);
+  }
+  console.log(lines.join("\n"));
+}
+async function technicalAeoRun(project, opts) {
+  const client = getClient24();
+  const { runId, status } = await client.triggerSiteAudit(project, {
+    sitemapUrl: opts.sitemapUrl,
+    limit: opts.limit
+  });
+  if (!opts.wait) {
+    if (isMachineFormat(opts.format)) {
+      console.log(JSON.stringify({ runId, status }, null, 2));
+      return;
+    }
+    console.log(
+      `Site audit started (run ${runId}, status ${status}). Use \`canonry runs get ${runId}\` to check status, or pass --wait.`
+    );
+    return;
+  }
+  const terminal = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
+  const start = Date.now();
+  const timeoutMs = 15 * 60 * 1e3;
+  if (!isMachineFormat(opts.format)) process.stderr.write("Auditing");
+  let final = status;
+  while (!terminal.has(final) && Date.now() - start < timeoutMs) {
+    await new Promise((r) => setTimeout(r, 2e3));
+    const run = await client.getRun(runId);
+    if (!isMachineFormat(opts.format)) process.stderr.write(".");
+    final = run.status;
+  }
+  if (!isMachineFormat(opts.format)) process.stderr.write("\n");
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify({ runId, status: final }, null, 2));
+    return;
+  }
+  console.log(`Site audit ${final} (run ${runId}).`);
+}
+
+// src/cli-commands/technical-aeo.ts
+var TECHNICAL_AEO_CLI_COMMANDS = [
+  {
+    path: ["technical-aeo", "score"],
+    usage: "canonry technical-aeo score <project> [--format json]",
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "technical-aeo.score",
+        "canonry technical-aeo score <project> [--format json]"
+      );
+      await technicalAeoScore(project, { format: input.format });
+    }
+  },
+  {
+    path: ["technical-aeo", "pages"],
+    usage: "canonry technical-aeo pages <project> [--status success|error] [--sort score-asc|score-desc|url] [--limit <n>] [--format json|jsonl]",
+    options: {
+      status: stringOption(),
+      sort: stringOption(),
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry technical-aeo pages <project> [--status success|error] [--sort score-asc|score-desc|url] [--limit <n>] [--format json|jsonl]";
+      const project = requireProject(input, "technical-aeo.pages", usage);
+      await technicalAeoPages(project, {
+        status: getString(input.values, "status"),
+        sort: getString(input.values, "sort"),
+        limit: parseIntegerOption(input, "limit", {
+          command: "technical-aeo.pages",
+          usage,
+          message: "--limit must be an integer"
+        }),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["technical-aeo", "trend"],
+    usage: "canonry technical-aeo trend <project> [--limit <n>] [--format json|jsonl]",
+    options: {
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry technical-aeo trend <project> [--limit <n>] [--format json|jsonl]";
+      const project = requireProject(input, "technical-aeo.trend", usage);
+      await technicalAeoTrend(project, {
+        limit: parseIntegerOption(input, "limit", {
+          command: "technical-aeo.trend",
+          usage,
+          message: "--limit must be an integer"
+        }),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["technical-aeo", "run"],
+    usage: "canonry technical-aeo run <project> [--sitemap-url <url>] [--limit <n>] [--wait] [--format json]",
+    options: {
+      "sitemap-url": stringOption(),
+      limit: stringOption(),
+      wait: { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const usage = "canonry technical-aeo run <project> [--sitemap-url <url>] [--limit <n>] [--wait] [--format json]";
+      const project = requireProject(input, "technical-aeo.run", usage);
+      await technicalAeoRun(project, {
+        sitemapUrl: getString(input.values, "sitemap-url"),
+        limit: parseIntegerOption(input, "limit", {
+          command: "technical-aeo.run",
+          usage,
+          message: "--limit must be an integer"
+        }),
+        wait: getBoolean(input.values, "wait"),
+        format: input.format
+      });
+    }
+  }
+];
+
 // src/cli-commands/wordpress.ts
 import fs11 from "fs";
 
 // src/commands/wordpress.ts
-function getClient24() {
+function getClient25() {
   return createApiClient();
 }
 async function loadYamlModule() {
@@ -10852,7 +11057,7 @@ async function wordpressConnect(project, opts) {
       details: { project }
     });
   }
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressConnect(project, {
     url: opts.url,
     stagingUrl: opts.stagingUrl,
@@ -10869,7 +11074,7 @@ async function wordpressConnect(project, opts) {
   printWordpressStatus(project, result);
 }
 async function wordpressDisconnect(project, format) {
-  const client = getClient24();
+  const client = getClient25();
   await client.wordpressDisconnect(project);
   if (isMachineFormat(format)) {
     printJson2({ project, disconnected: true });
@@ -10878,7 +11083,7 @@ async function wordpressDisconnect(project, format) {
   console.log(`WordPress disconnected from project "${project}".`);
 }
 async function wordpressStatus(project, format) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressStatus(project);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -10887,7 +11092,7 @@ async function wordpressStatus(project, format) {
   printWordpressStatus(project, result);
 }
 async function wordpressPages(project, opts) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressPages(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10896,7 +11101,7 @@ async function wordpressPages(project, opts) {
   printPages(project, result.env, result.pages);
 }
 async function wordpressPage(project, slug, opts) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressPage(project, slug, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10905,7 +11110,7 @@ async function wordpressPage(project, slug, opts) {
   printPageDetail(result);
 }
 async function wordpressCreatePage(project, body) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressCreatePage(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -10916,7 +11121,7 @@ async function wordpressCreatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressUpdatePage(project, body) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressUpdatePage(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -10927,7 +11132,7 @@ async function wordpressUpdatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressSetMeta(project, body) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressSetMeta(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -10977,7 +11182,7 @@ async function wordpressBulkSetMeta(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressBulkSetMeta(project, { entries, env: opts.env });
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -11020,7 +11225,7 @@ async function wordpressBulkSetMeta(project, opts) {
 Total: ${applied.length} applied, ${skipped.length} skipped, ${manual.length} manual`);
 }
 async function wordpressSchema(project, slug, opts) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressSchema(project, slug, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -11031,7 +11236,7 @@ async function wordpressSchema(project, slug, opts) {
   printSchemaBlocks(result.blocks);
 }
 async function wordpressSetSchema(project, body) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressSetSchema(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -11079,7 +11284,7 @@ async function wordpressSchemaDeploy(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressSchemaDeploy(project, { profile: parsed, env: opts.env });
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -11118,7 +11323,7 @@ async function wordpressSchemaDeploy(project, opts) {
 Total: ${deployed} deployed, ${stripped} stripped, ${skipped} skipped, ${failed} failed`);
 }
 async function wordpressSchemaStatus(project, opts) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressSchemaStatus(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -11177,7 +11382,7 @@ async function wordpressOnboard(project, opts) {
       });
     }
   }
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressOnboard(project, {
     url: opts.url,
     username: opts.user,
@@ -11202,7 +11407,7 @@ async function wordpressOnboard(project, opts) {
   }
 }
 async function wordpressLlmsTxt(project, opts) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressLlmsTxt(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -11213,7 +11418,7 @@ async function wordpressLlmsTxt(project, opts) {
   console.log(result.content ?? "(not found)");
 }
 async function wordpressSetLlmsTxt(project, body) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressSetLlmsTxt(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -11222,7 +11427,7 @@ async function wordpressSetLlmsTxt(project, body) {
   printManualAssist(`llms.txt update for "${project}"`, result);
 }
 async function wordpressAudit(project, opts) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressAudit(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -11236,7 +11441,7 @@ async function wordpressAudit(project, opts) {
   printAuditIssues(result.issues);
 }
 async function wordpressDiff(project, slug, format) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressDiff(project, slug);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -11245,7 +11450,7 @@ async function wordpressDiff(project, slug, format) {
   printDiff(result);
 }
 async function wordpressStagingStatus(project, format) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressStagingStatus(project);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -11259,7 +11464,7 @@ async function wordpressStagingStatus(project, format) {
   console.log(`  Admin URL:         ${result.adminUrl}`);
 }
 async function wordpressStagingPush(project, format) {
-  const client = getClient24();
+  const client = getClient25();
   const result = await client.wordpressStagingPush(project);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -12284,6 +12489,7 @@ var REGISTERED_CLI_COMMANDS = [
   ...CONTENT_CLI_COMMANDS,
   ...AGENT_CLI_COMMANDS,
   ...DISCOVER_CLI_COMMANDS,
+  ...TECHNICAL_AEO_CLI_COMMANDS,
   ...DOCTOR_CLI_COMMANDS,
   ...GET_CLI_COMMANDS,
   ...MCP_CLI_COMMANDS

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-SIB4NMEH.js";
+} from "./chunk-MRC4JMIH.js";
 import {
   loadConfig
-} from "./chunk-ZUBBADMR.js";
-import "./chunk-HSX32G47.js";
-import "./chunk-JXFNERK4.js";
+} from "./chunk-W6GBIRFA.js";
+import "./chunk-ZRZHIS22.js";
+import "./chunk-A7JX3FZB.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-ZW3ARLJT.js → intelligence-service-GPO2VMEC.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-HSX32G47.js";
-import "./chunk-JXFNERK4.js";
+} from "./chunk-ZRZHIS22.js";
+import "./chunk-A7JX3FZB.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,8 +3,8 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-ZUBBADMR.js";
-import "./chunk-JXFNERK4.js";
+} from "./chunk-W6GBIRFA.js";
+import "./chunk-A7JX3FZB.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.72.3",
+  "version": "4.74.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -36,7 +36,7 @@
     "node": ">=22.14.0"
   },
   "dependencies": {
-    "@ainyc/aeo-audit": "1.3.2",
+    "@ainyc/aeo-audit": "3.0.0",
     "@anthropic-ai/sdk": "^0.78.0",
     "@fastify/static": "^8.1.0",
     "@google/genai": "^1.46.0",
@@ -62,22 +62,22 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "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-bing": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "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-api-client": "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-openai": "0.0.0",