@ainyc/canonry 2.2.1 → 2.3.1

package/dist/cli.js

@@ -17,6 +17,7 @@ import {
   getConfigDir,
   getConfigPath,
   getOrCreateAnonymousId,
+  isEndpointMissing,
   isFirstRun,
   isTelemetryEnabled,
   listAgentProviders,
@@ -35,7 +36,7 @@ import {
   showFirstRunNotice,
   trackEvent,
   usageError
-} from "./chunk-2QNWFP6R.js";
+} from "./chunk-JXOUZ6JH.js";
 import {
   apiKeys,
   competitors,
@@ -45,7 +46,7 @@ import {
   projects,
   querySnapshots,
   runs
-} from "./chunk-TAII35VC.js";
+} from "./chunk-CW6CAPBQ.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -292,7 +293,7 @@ async function backfillAnswerVisibilityCommand(opts) {
   console.log(`  Errors:   ${providerErrors}`);
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-C5LAYDFM.js");
+  const { IntelligenceService } = await import("./intelligence-service-232P7625.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -501,10 +502,308 @@ var BACKFILL_CLI_COMMANDS = [
   }
 ];
 
-// src/commands/bing.ts
+// src/commands/backlinks.ts
 function getClient() {
   return createApiClient();
 }
+function printJson(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+function formatInstallStatus(status) {
+  const lines = [];
+  lines.push(status.duckdbInstalled ? "DuckDB: installed" : "DuckDB: not installed");
+  if (status.duckdbVersion) lines.push(`Version: ${status.duckdbVersion}`);
+  lines.push(`Spec:    ${status.duckdbSpec}`);
+  lines.push(`Plugin:  ${status.pluginDir}`);
+  if (!status.duckdbInstalled) {
+    lines.push("");
+    lines.push("Run `canonry backlinks install` to enable backlinks.");
+  }
+  return lines.join("\n");
+}
+function formatSync(sync) {
+  const lines = [];
+  lines.push(`Release: ${sync.release}`);
+  lines.push(`Status:  ${sync.status}`);
+  if (sync.phaseDetail) lines.push(`Phase:   ${sync.phaseDetail}`);
+  if (typeof sync.projectsProcessed === "number") lines.push(`Projects: ${sync.projectsProcessed}`);
+  if (typeof sync.domainsDiscovered === "number") lines.push(`Domains:  ${sync.domainsDiscovered}`);
+  if (sync.error) lines.push(`Error:   ${sync.error}`);
+  return lines.join("\n");
+}
+function formatSummaryAndDomains(project, response) {
+  const lines = [];
+  lines.push(`Project: ${project}`);
+  if (!response.summary) {
+    lines.push("No ready release \u2014 run `canonry backlinks sync --release <id>` first.");
+    return lines.join("\n");
+  }
+  const s = response.summary;
+  lines.push(`Release: ${s.release}`);
+  lines.push(`Target:  ${s.targetDomain}`);
+  lines.push(`Linking domains: ${s.totalLinkingDomains}`);
+  lines.push(`Total hosts:     ${s.totalHosts}`);
+  lines.push(`Top-10 share:    ${s.top10HostsShare}`);
+  if (response.rows.length > 0) {
+    lines.push("");
+    lines.push(`Top ${response.rows.length} linking domains (of ${response.total}):`);
+    for (const r of response.rows) {
+      lines.push(`  ${String(r.numHosts).padStart(9)}  ${r.linkingDomain}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatCachedReleases(rows) {
+  if (rows.length === 0) return "No cached releases.";
+  const lines = [];
+  lines.push("Release                        Status       Bytes        Last used");
+  for (const r of rows) {
+    const status = (r.syncStatus ?? "unknown").padEnd(12);
+    const bytes = String(r.bytes).padStart(12);
+    const lastUsed = r.lastUsedAt ?? "-";
+    lines.push(`${r.release.padEnd(30)} ${status} ${bytes}  ${lastUsed}`);
+  }
+  return lines.join("\n");
+}
+function formatInstallResult(result) {
+  if (result.alreadyPresent) {
+    return `DuckDB already installed (${result.version}) at ${result.path}`;
+  }
+  return `DuckDB installed (${result.version}) at ${result.path}`;
+}
+async function pollSync(id, format) {
+  const client = getClient();
+  const terminal = /* @__PURE__ */ new Set(["ready", "failed"]);
+  while (true) {
+    const syncs = await client.backlinksListSyncs();
+    const row = syncs.find((s) => s.id === id);
+    if (!row) throw new Error(`Release sync ${id} not found`);
+    if (terminal.has(row.status)) return row;
+    if (format !== "json") {
+      process.stderr.write(`\r${row.status}${row.phaseDetail ? ": " + row.phaseDetail : ""}`.padEnd(80));
+    }
+    await new Promise((r) => setTimeout(r, 2e3));
+  }
+}
+async function pollRun(runId, format) {
+  const client = getClient();
+  const terminal = /* @__PURE__ */ new Set(["completed", "failed", "partial"]);
+  while (true) {
+    const run = await client.getRun(runId);
+    if (terminal.has(run.status)) return run;
+    if (format !== "json") {
+      process.stderr.write(`\r${run.status}`.padEnd(40));
+    }
+    await new Promise((r) => setTimeout(r, 2e3));
+  }
+}
+async function backlinksInstall(opts = {}) {
+  const result = await getClient().backlinksInstall();
+  if (opts.format === "json") {
+    printJson(result);
+    return;
+  }
+  console.log(formatInstallResult(result));
+}
+async function backlinksDoctor(opts = {}) {
+  const status = await getClient().backlinksStatus();
+  if (opts.format === "json") {
+    printJson(status);
+    return;
+  }
+  console.log(formatInstallStatus(status));
+}
+async function backlinksSync(opts) {
+  const client = getClient();
+  const sync = await client.backlinksTriggerSync(opts.release);
+  const final = opts.wait ? await pollSync(sync.id, opts.format) : sync;
+  if (opts.format === "json") {
+    printJson(final);
+    return;
+  }
+  if (opts.wait) process.stderr.write("\n");
+  console.log(formatSync(final));
+}
+async function backlinksStatus(opts = {}) {
+  const sync = await getClient().backlinksLatestSync();
+  if (opts.format === "json") {
+    printJson(sync);
+    return;
+  }
+  if (!sync) {
+    console.log("No release syncs yet.");
+    return;
+  }
+  console.log(formatSync(sync));
+}
+async function backlinksList(opts) {
+  const client = getClient();
+  const response = await client.backlinksDomains(opts.project, {
+    limit: opts.limit ?? 50,
+    release: opts.release
+  });
+  if (opts.format === "json") {
+    printJson(response);
+    return;
+  }
+  console.log(formatSummaryAndDomains(opts.project, response));
+}
+async function backlinksReleases(opts = {}) {
+  const rows = await getClient().backlinksCachedReleases();
+  if (opts.format === "json") {
+    printJson(rows);
+    return;
+  }
+  console.log(formatCachedReleases(rows));
+}
+async function backlinksExtract(opts) {
+  const client = getClient();
+  const run = await client.backlinksExtract(opts.project, opts.release);
+  const final = opts.wait ? await pollRun(run.id, opts.format) : run;
+  if (opts.format === "json") {
+    printJson(final);
+    return;
+  }
+  if (opts.wait) process.stderr.write("\n");
+  console.log(`Run ${final.id} (${final.status})${final.error ? " \u2014 " + final.error : ""}`);
+}
+async function backlinksCachePrune(opts) {
+  if (!opts.release) {
+    throw new Error("Usage: canonry backlinks cache prune --release <id>");
+  }
+  const result = await getClient().backlinksPruneCache(opts.release);
+  if (opts.format === "json") {
+    printJson({ pruned: opts.release, ...result });
+    return;
+  }
+  console.log(`Pruned cache for ${opts.release}`);
+}
+
+// src/cli-commands/backlinks.ts
+var BACKLINKS_CLI_COMMANDS = [
+  {
+    path: ["backlinks", "install"],
+    usage: "canonry backlinks install [--format json]",
+    options: {},
+    run: async (input) => {
+      await backlinksInstall({ format: input.format });
+    }
+  },
+  {
+    path: ["backlinks", "doctor"],
+    usage: "canonry backlinks doctor [--format json]",
+    options: {},
+    run: async (input) => {
+      await backlinksDoctor({ format: input.format });
+    }
+  },
+  {
+    path: ["backlinks", "sync"],
+    usage: "canonry backlinks sync --release <id> [--wait] [--format json]",
+    options: {
+      release: stringOption(),
+      wait: { type: "boolean" }
+    },
+    run: async (input) => {
+      const release = requireStringOption(input, "release", {
+        message: "--release is required",
+        usage: "canonry backlinks sync --release <id> [--wait]",
+        command: "backlinks sync"
+      });
+      await backlinksSync({
+        release,
+        wait: getBoolean(input.values, "wait"),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["backlinks", "status"],
+    usage: "canonry backlinks status [--format json]",
+    options: {},
+    run: async (input) => {
+      await backlinksStatus({ format: input.format });
+    }
+  },
+  {
+    path: ["backlinks", "list"],
+    usage: "canonry backlinks list <project> [--limit <n>] [--release <id>] [--format json]",
+    options: {
+      limit: stringOption(),
+      release: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "backlinks list",
+        "canonry backlinks list <project> [--limit <n>] [--release <id>]"
+      );
+      const limit = parseIntegerOption(input, "limit", {
+        message: "--limit must be an integer",
+        usage: "canonry backlinks list <project> --limit <n>",
+        command: "backlinks list"
+      });
+      await backlinksList({
+        project,
+        limit,
+        release: getString(input.values, "release"),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["backlinks", "releases"],
+    usage: "canonry backlinks releases [--format json]",
+    options: {},
+    run: async (input) => {
+      await backlinksReleases({ format: input.format });
+    }
+  },
+  {
+    path: ["backlinks", "extract"],
+    usage: "canonry backlinks extract <project> [--release <id>] [--wait] [--format json]",
+    options: {
+      release: stringOption(),
+      wait: { type: "boolean" }
+    },
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "backlinks extract",
+        "canonry backlinks extract <project> [--release <id>] [--wait]"
+      );
+      await backlinksExtract({
+        project,
+        release: getString(input.values, "release"),
+        wait: getBoolean(input.values, "wait"),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["backlinks", "cache", "prune"],
+    usage: "canonry backlinks cache prune --release <id> [--format json]",
+    options: {
+      release: stringOption()
+    },
+    run: async (input) => {
+      const release = requireStringOption(input, "release", {
+        message: "--release is required",
+        usage: "canonry backlinks cache prune --release <id>",
+        command: "backlinks cache prune"
+      });
+      await backlinksCachePrune({
+        release,
+        format: input.format
+      });
+    }
+  }
+];
+
+// src/commands/bing.ts
+function getClient2() {
+  return createApiClient();
+}
 async function bingConnect(project, opts) {
   const apiKey = opts?.apiKey;
   if (!apiKey) {
@@ -517,7 +816,7 @@ async function bingConnect(project, opts) {
       }
     });
   }
-  const client = getClient();
+  const client = getClient2();
   const result = await client.bingConnect(project, { apiKey });
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -538,7 +837,7 @@ Set the active site with: canonry bing set-site ${project} <url>`);
   }
 }
 async function bingDisconnect(project, format) {
-  const client = getClient();
+  const client = getClient2();
   await client.bingDisconnect(project);
   if (format === "json") {
     console.log(JSON.stringify({ project, disconnected: true }, null, 2));
@@ -547,7 +846,7 @@ async function bingDisconnect(project, format) {
   console.log(`Bing Webmaster Tools disconnected from project "${project}".`);
 }
 async function bingStatus(project, format) {
-  const client = getClient();
+  const client = getClient2();
   const result = await client.bingStatus(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -565,7 +864,7 @@ async function bingStatus(project, format) {
   console.log(`  Updated:      ${result.updatedAt}`);
 }
 async function bingSites(project, format) {
-  const client = getClient();
+  const client = getClient2();
   const result = await client.bingSites(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -587,7 +886,7 @@ async function bingSites(project, format) {
 Use "canonry bing set-site <project> <url>" to select a site.`);
 }
 async function bingSetSite(project, siteUrl, format) {
-  const client = getClient();
+  const client = getClient2();
   await client.bingSetSite(project, siteUrl);
   if (format === "json") {
     console.log(JSON.stringify({ project, siteUrl }, null, 2));
@@ -596,7 +895,7 @@ async function bingSetSite(project, siteUrl, format) {
   console.log(`Bing site set to "${siteUrl}" for project "${project}".`);
 }
 async function bingCoverage(project, format) {
-  const client = getClient();
+  const client = getClient2();
   const result = await client.bingCoverage(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -644,7 +943,7 @@ Bing Index Coverage for "${project}"
   }
 }
 async function bingCoverageHistory(project, opts) {
-  const client = getClient();
+  const client = getClient2();
   const rows = await client.bingCoverageHistory(project, { limit: opts.limit });
   if (opts.format === "json") {
     console.log(JSON.stringify(rows, null, 2));
@@ -664,7 +963,7 @@ Bing Coverage History for "${project}" (${rows.length} snapshots):
   }
 }
 async function bingInspect(project, url, format) {
-  const client = getClient();
+  const client = getClient2();
   const result = await client.bingInspectUrl(project, url);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -683,7 +982,7 @@ Bing URL Inspection: ${result.url}
   console.log(`  Inspected At:      ${result.inspectedAt}`);
 }
 async function bingInspections(project, opts) {
-  const client = getClient();
+  const client = getClient2();
   const params = {};
   if (opts.url) params.url = opts.url;
   const rows = await client.bingInspections(project, Object.keys(params).length > 0 ? params : void 0);
@@ -709,7 +1008,7 @@ async function bingInspections(project, opts) {
   }
 }
 async function bingRefresh(project, format) {
-  const client = getClient();
+  const client = getClient2();
   const rows = await client.bingInspections(project);
   const uniqueUrls = [...new Set(rows.map((r) => r.url))];
   if (uniqueUrls.length === 0) {
@@ -749,7 +1048,7 @@ async function bingRefresh(project, format) {
   await bingCoverage(project, format);
 }
 async function bingRequestIndexing(project, opts) {
-  const client = getClient();
+  const client = getClient2();
   const body = {};
   if (opts.allUnindexed) {
     body.allUnindexed = true;
@@ -784,7 +1083,7 @@ async function bingRequestIndexing(project, opts) {
   }
 }
 async function bingPerformance(project, format) {
-  const client = getClient();
+  const client = getClient2();
   const rows = await client.bingPerformance(project);
   if (format === "json") {
     console.log(JSON.stringify(rows, null, 2));
@@ -970,7 +1269,7 @@ var BING_CLI_COMMANDS = [
 ];
 
 // src/commands/cdp.ts
-function getClient2() {
+function getClient3() {
   return createApiClient();
 }
 async function cdpConnect(opts) {
@@ -996,7 +1295,7 @@ async function cdpConnect(opts) {
   console.log("Restart canonry server for changes to take effect.");
 }
 async function cdpStatus(format) {
-  const client = getClient2();
+  const client = getClient3();
   try {
     const status = await client.getCdpStatus();
     if (format === "json") {
@@ -1054,7 +1353,7 @@ async function cdpScreenshot(query, opts) {
       }
     });
   }
-  const client = getClient2();
+  const client = getClient3();
   const body = { query };
   if (opts?.targets) {
     body.targets = opts.targets.split(",").map((s) => s.trim());
@@ -1161,7 +1460,7 @@ var CDP_CLI_COMMANDS = [
 ];
 
 // src/commands/ga.ts
-function getClient3() {
+function getClient4() {
   return createApiClient();
 }
 async function gaConnect(project, opts) {
@@ -1194,7 +1493,7 @@ async function gaConnect(project, opts) {
   } else if (opts.keyJson) {
     body.keyJson = opts.keyJson;
   }
-  const client = getClient3();
+  const client = getClient4();
   const result = await client.gaConnect(project, body);
   if (opts.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1209,7 +1508,7 @@ async function gaConnect(project, opts) {
   }
 }
 async function gaDisconnect(project, format) {
-  const client = getClient3();
+  const client = getClient4();
   await client.gaDisconnect(project);
   if (format === "json") {
     console.log(JSON.stringify({ project, disconnected: true }, null, 2));
@@ -1218,7 +1517,7 @@ async function gaDisconnect(project, format) {
   console.log(`GA4 disconnected from project "${project}".`);
 }
 async function gaStatus(project, format) {
-  const client = getClient3();
+  const client = getClient4();
   const result = await client.gaStatus(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1244,7 +1543,7 @@ async function gaStatus(project, format) {
   console.log(`  Connected:    ${result.createdAt ?? "unknown"}`);
 }
 async function gaSync(project, opts) {
-  const client = getClient3();
+  const client = getClient4();
   const body = {};
   if (opts?.days) body.days = opts.days;
   if (opts?.only) body.only = opts.only;
@@ -1264,7 +1563,7 @@ async function gaSync(project, opts) {
   console.log(`  Synced at:   ${result.syncedAt}`);
 }
 async function gaTraffic(project, opts) {
-  const client = getClient3();
+  const client = getClient4();
   const params = {};
   if (opts?.limit) params.limit = String(opts.limit);
   if (opts?.window) params.window = opts.window;
@@ -1339,7 +1638,7 @@ async function gaTraffic(project, opts) {
   }
 }
 async function gaAiReferralHistory(project, opts) {
-  const client = getClient3();
+  const client = getClient4();
   const result = await client.gaAiReferralHistory(project, opts?.window ? { window: opts.window } : void 0);
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1364,7 +1663,7 @@ async function gaAiReferralHistory(project, opts) {
   }
 }
 async function gaSocialReferralHistory(project, opts) {
-  const client = getClient3();
+  const client = getClient4();
   const result = await client.gaSocialReferralHistory(project, opts?.window ? { window: opts.window } : void 0);
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1389,7 +1688,7 @@ async function gaSocialReferralHistory(project, opts) {
   }
 }
 async function gaSessionHistory(project, opts) {
-  const client = getClient3();
+  const client = getClient4();
   const result = await client.gaSessionHistory(project, opts?.window ? { window: opts.window } : void 0);
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1411,7 +1710,7 @@ async function gaSessionHistory(project, opts) {
   }
 }
 async function gaCoverage(project, format) {
-  const client = getClient3();
+  const client = getClient4();
   const result = await client.gaCoverage(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1434,7 +1733,7 @@ async function gaCoverage(project, format) {
   }
 }
 async function gaSocialReferralSummary(project, opts) {
-  const client = getClient3();
+  const client = getClient4();
   const traffic = await client.gaTraffic(project);
   if (opts?.trend) {
     const trend = await client.gaSocialReferralTrend(project);
@@ -1495,7 +1794,7 @@ async function gaSocialReferralSummary(project, opts) {
   }
 }
 async function gaAttribution(project, opts) {
-  const client = getClient3();
+  const client = getClient4();
   const traffic = await client.gaTraffic(project);
   const fmtTrend = (pct) => pct === null ? "n/a" : `${pct >= 0 ? "+" : ""}${pct}%`;
   if (opts?.trend) {
@@ -1788,11 +2087,11 @@ var GA_CLI_COMMANDS = [
 ];
 
 // src/commands/competitor.ts
-function getClient4() {
+function getClient5() {
   return createApiClient();
 }
 async function addCompetitors(project, domains, format) {
-  const client = getClient4();
+  const client = getClient5();
   const existing = await client.listCompetitors(project);
   const existingDomains = existing.map((c) => c.domain);
   const addedDomains = domains.filter((domain) => !existingDomains.includes(domain));
@@ -1814,7 +2113,7 @@ async function addCompetitors(project, domains, format) {
   }
 }
 async function listCompetitors(project, format) {
-  const client = getClient4();
+  const client = getClient5();
   const comps = await client.listCompetitors(project);
   if (format === "json") {
     console.log(JSON.stringify(comps, null, 2));
@@ -1873,7 +2172,7 @@ var COMPETITOR_CLI_COMMANDS = [
 ];
 
 // src/commands/google.ts
-function getClient5() {
+function getClient6() {
   return createApiClient();
 }
 async function waitForRunStatus(client, runId, config) {
@@ -1913,7 +2212,7 @@ async function waitForRunStatus(client, runId, config) {
   });
 }
 async function googleConnect(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const { authUrl, redirectUri } = await client.googleConnect(project, {
     type: opts.type,
     publicUrl: opts.publicUrl
@@ -1947,7 +2246,7 @@ Open this URL in your browser to authorize Google ${opts.type.toUpperCase()} acc
   }
 }
 async function googleDisconnect(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   await client.googleDisconnect(project, opts.type);
   if (opts.format === "json") {
     console.log(JSON.stringify({ project, type: opts.type, disconnected: true }, null, 2));
@@ -1956,7 +2255,7 @@ async function googleDisconnect(project, opts) {
   console.log(`Disconnected Google ${opts.type.toUpperCase()} from project "${project}".`);
 }
 async function googleStatus(project, format) {
-  const client = getClient5();
+  const client = getClient6();
   const connections = await client.googleConnections(project);
   if (format === "json") {
     console.log(JSON.stringify({ connections }, null, 2));
@@ -1980,7 +2279,7 @@ async function googleStatus(project, format) {
   }
 }
 async function googleProperties(project, format) {
-  const client = getClient5();
+  const client = getClient6();
   const { sites } = await client.googleProperties(project);
   if (format === "json") {
     console.log(JSON.stringify({ sites }, null, 2));
@@ -2001,7 +2300,7 @@ async function googleProperties(project, format) {
 Use "canonry google set-property <project> <siteUrl>" to select a property.`);
 }
 async function googleSetProperty(project, propertyUrl, format) {
-  const client = getClient5();
+  const client = getClient6();
   await client.googleSetProperty(project, "gsc", propertyUrl);
   if (format === "json") {
     console.log(JSON.stringify({ project, type: "gsc", propertyUrl }, null, 2));
@@ -2010,7 +2309,7 @@ async function googleSetProperty(project, propertyUrl, format) {
   console.log(`GSC property set to "${propertyUrl}" for project "${project}".`);
 }
 async function googleSync(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const run = await client.gscSync(project, { days: opts.days, full: opts.full });
   if (!opts.wait && opts.format === "json") {
     console.log(JSON.stringify(run, null, 2));
@@ -2040,7 +2339,7 @@ async function googleSync(project, opts) {
   }
 }
 async function googlePerformance(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const params = {};
   if (opts.days) {
     const end = /* @__PURE__ */ new Date();
@@ -2076,7 +2375,7 @@ async function googlePerformance(project, opts) {
   }
 }
 async function googleInspect(project, url, format) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.gscInspect(project, url);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -2096,7 +2395,7 @@ URL Inspection: ${result.url}
   console.log(`  Inspected At:      ${result.inspectedAt}`);
 }
 async function googleInspections(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const params = {};
   if (opts.url) params.url = opts.url;
   const rows = await client.gscInspections(project, Object.keys(params).length > 0 ? params : void 0);
@@ -2121,7 +2420,7 @@ async function googleInspections(project, opts) {
   }
 }
 async function googleCoverage(project, format) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.gscCoverage(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -2167,7 +2466,7 @@ Index Coverage for "${project}"
   }
 }
 async function googleSetSitemap(project, sitemapUrl, format) {
-  const client = getClient5();
+  const client = getClient6();
   await client.googleSetSitemap(project, "gsc", sitemapUrl);
   if (format === "json") {
     console.log(JSON.stringify({ project, type: "gsc", sitemapUrl }, null, 2));
@@ -2176,7 +2475,7 @@ async function googleSetSitemap(project, sitemapUrl, format) {
   console.log(`GSC sitemap URL set to "${sitemapUrl}" for project "${project}".`);
 }
 async function googleListSitemaps(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.gscSitemaps(project);
   if (opts.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -2198,7 +2497,7 @@ Sitemaps for project "${project}":
   }
 }
 async function googleInspectSitemap(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const run = await client.gscInspectSitemap(project, {
     sitemapUrl: opts.sitemapUrl
   });
@@ -2234,7 +2533,7 @@ async function googleInspectSitemap(project, opts) {
   }
 }
 async function googleCoverageHistory(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const rows = await client.gscCoverageHistory(project, { limit: opts.limit });
   if (opts.format === "json") {
     console.log(JSON.stringify(rows, null, 2));
@@ -2256,7 +2555,7 @@ GSC Coverage History for "${project}" (${rows.length} snapshots):
   }
 }
 async function googleDiscoverSitemaps(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.gscDiscoverSitemaps(project);
   if (!opts.wait && opts.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -2308,7 +2607,7 @@ Primary sitemap: ${result.primarySitemapUrl}`);
   }
 }
 async function googleRequestIndexing(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const body = { urls: [] };
   if (opts.allUnindexed) {
     body.allUnindexed = true;
@@ -2388,7 +2687,7 @@ async function googleRequestIndexing(project, opts) {
   }
 }
 async function googleRefresh(project, format) {
-  const client = getClient5();
+  const client = getClient6();
   const run = await client.gscSync(project, {});
   if (format !== "json") {
     process.stderr.write("Refreshing GSC coverage data");
@@ -2411,7 +2710,7 @@ async function googleRefresh(project, format) {
   await googleCoverage(project, format);
 }
 async function googleDeindexed(project, format) {
-  const client = getClient5();
+  const client = getClient6();
   const rows = await client.gscDeindexed(project);
   if (format === "json") {
     console.log(JSON.stringify(rows, null, 2));
@@ -2700,11 +2999,11 @@ var GOOGLE_CLI_COMMANDS = [
 
 // src/commands/keyword.ts
 import fs from "fs";
-function getClient6() {
+function getClient7() {
   return createApiClient();
 }
 async function addKeywords(project, keywords, format) {
-  const client = getClient6();
+  const client = getClient7();
   await client.appendKeywords(project, keywords);
   if (format === "json") {
     console.log(JSON.stringify({
@@ -2717,7 +3016,7 @@ async function addKeywords(project, keywords, format) {
   console.log(`Added ${keywords.length} key phrase(s) to "${project}".`);
 }
 async function removeKeywords(project, keywords, format) {
-  const client = getClient6();
+  const client = getClient7();
   const existing = await client.listKeywords(project);
   const existingSet = new Set(existing.map((k) => k.keyword));
   const removedKeywords = keywords.filter((k) => existingSet.has(k));
@@ -2734,7 +3033,7 @@ async function removeKeywords(project, keywords, format) {
   console.log(`Removed ${removedKeywords.length} key phrase(s) from "${project}".`);
 }
 async function listKeywords(project, format) {
-  const client = getClient6();
+  const client = getClient7();
   const kws = await client.listKeywords(project);
   if (format === "json") {
     console.log(JSON.stringify(kws, null, 2));
@@ -2777,7 +3076,7 @@ async function importKeywords(project, filePath, format) {
     console.log("No key phrases found in file.");
     return;
   }
-  const client = getClient6();
+  const client = getClient7();
   await client.appendKeywords(project, keywords);
   if (format === "json") {
     console.log(JSON.stringify({
@@ -2791,7 +3090,7 @@ async function importKeywords(project, filePath, format) {
   console.log(`Imported ${keywords.length} key phrase(s) to "${project}".`);
 }
 async function generateKeywords(project, provider, opts) {
-  const client = getClient6();
+  const client = getClient7();
   const result = await client.generateKeywords(project, provider, opts.count);
   const saved = Boolean(opts.save && result.keywords.length > 0);
   if (opts.format !== "json") {
@@ -2945,11 +3244,11 @@ var KEYWORD_CLI_COMMANDS = [
 ];
 
 // src/commands/notify.ts
-function getClient7() {
+function getClient8() {
   return createApiClient();
 }
 async function addNotification(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const result = await client.createNotification(project, {
     channel: "webhook",
     url: opts.webhook,
@@ -2963,7 +3262,7 @@ async function addNotification(project, opts) {
   printNotification(result);
 }
 async function listNotifications(project, format) {
-  const client = getClient7();
+  const client = getClient8();
   const results = await client.listNotifications(project);
   if (format === "json") {
     console.log(JSON.stringify(results, null, 2));
@@ -2981,7 +3280,7 @@ async function listNotifications(project, format) {
   }
 }
 async function removeNotification(project, id, format) {
-  const client = getClient7();
+  const client = getClient8();
   await client.deleteNotification(project, id);
   if (format === "json") {
     console.log(JSON.stringify({ project, id, removed: true }, null, 2));
@@ -2990,7 +3289,7 @@ async function removeNotification(project, id, format) {
   console.log(`Notification ${id} removed from "${project}"`);
 }
 async function testNotification(project, id, format) {
-  const client = getClient7();
+  const client = getClient8();
   const result = await client.testNotification(project, id);
   if (format === "json") {
     console.log(JSON.stringify({ project, id, ...result }, null, 2));
@@ -3181,11 +3480,11 @@ async function applyConfigs(filePaths, format) {
 }
 
 // src/commands/analytics.ts
-function getClient8() {
+function getClient9() {
   return createApiClient();
 }
 async function showAnalytics(project, options) {
-  const client = getClient8();
+  const client = getClient9();
   const features = options.feature ? [options.feature] : ["metrics", "gaps", "sources"];
   const results = {};
   for (const feature of features) {
@@ -3288,11 +3587,11 @@ Source Origin Breakdown`);
 }
 
 // src/commands/evidence.ts
-function getClient9() {
+function getClient10() {
   return createApiClient();
 }
 async function showEvidence(project, format) {
-  const client = getClient9();
+  const client = getClient10();
   const timeline = await client.getTimeline(project);
   if (format === "json") {
     const enriched = timeline.map((entry) => ({
@@ -3327,14 +3626,8 @@ async function exportProject(project, opts) {
   const client = createApiClient();
   const data = await client.getExport(project);
   if (opts.includeResults) {
-    try {
-      const runs2 = await client.listRuns(project);
-      if (runs2.length > 0) {
-        const latestRun = await client.getRun(runs2[runs2.length - 1].id);
-        data.results = latestRun;
-      }
-    } catch {
-    }
+    const results = await loadLatestRunForExport(client, project);
+    if (results) data.results = results;
   }
   if (opts.format === "json") {
     console.log(JSON.stringify(data, null, 2));
@@ -3342,13 +3635,27 @@ async function exportProject(project, opts) {
   }
   console.log(stringify(data));
 }
+async function loadLatestRunForExport(client, project) {
+  try {
+    const latest = await client.getLatestRun(project);
+    return latest.run ?? null;
+  } catch (err) {
+    if (!isEndpointMissing(err)) throw err;
+  }
+  const runs2 = await client.listRuns(project);
+  if (runs2.length === 0) return null;
+  const latestRun = runs2.reduce(
+    (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
+  );
+  return client.getRun(latestRun.id);
+}
 
 // src/commands/history.ts
-function getClient10() {
+function getClient11() {
   return createApiClient();
 }
 async function showHistory(project, format) {
-  const client = getClient10();
+  const client = getClient11();
   try {
     const entries = await client.getHistory(project);
     if (format === "json") {
@@ -3383,19 +3690,25 @@ async function showHistory(project, format) {
 }
 
 // src/commands/status.ts
-function getClient11() {
+function getClient12() {
   return createApiClient();
 }
 async function showStatus(project, format) {
-  const client = getClient11();
+  const client = getClient12();
   const projectData = await client.getProject(project);
-  let runs2 = [];
-  try {
-    runs2 = await client.listRuns(project);
-  } catch {
-  }
+  const latest = await getLatestRunSummary(client, project);
   if (format === "json") {
-    console.log(JSON.stringify({ project: projectData, runs: runs2 }, null, 2));
+    let runs2 = [];
+    try {
+      runs2 = await client.listRuns(project);
+    } catch {
+    }
+    console.log(JSON.stringify({
+      project: projectData,
+      runs: runs2,
+      latestRun: latest.run,
+      totalRuns: latest.totalRuns
+    }, null, 2));
     return;
   }
   console.log(`Status: ${projectData.displayName ?? projectData.name} (${projectData.name})
@@ -3403,24 +3716,39 @@ async function showStatus(project, format) {
   console.log(`  Domain:   ${projectData.canonicalDomain}`);
   console.log(`  Country:  ${projectData.country}`);
   console.log(`  Language: ${projectData.language}`);
-  if (runs2.length > 0) {
-    const latest = runs2.reduce(
-      (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
-    );
+  if (latest.run) {
     console.log(`
   Latest run:`);
-    console.log(`    ID:       ${latest.id}`);
-    console.log(`    Status:   ${latest.status}`);
-    console.log(`    Created:  ${latest.createdAt}`);
-    if (latest.finishedAt) {
-      console.log(`    Finished: ${latest.finishedAt}`);
+    console.log(`    ID:       ${latest.run.id}`);
+    console.log(`    Status:   ${latest.run.status}`);
+    console.log(`    Created:  ${latest.run.createdAt}`);
+    if (latest.run.finishedAt) {
+      console.log(`    Finished: ${latest.run.finishedAt}`);
     }
     console.log(`
-  Total runs: ${runs2.length}`);
+  Total runs: ${latest.totalRuns}`);
   } else {
     console.log('\n  No runs yet. Use "canonry run" to trigger one.');
   }
 }
+async function getLatestRunSummary(client, project) {
+  try {
+    return await client.getLatestRun(project);
+  } catch (err) {
+    if (!isEndpointMissing(err)) throw err;
+    const runs2 = await client.listRuns(project);
+    if (runs2.length === 0) {
+      return { totalRuns: 0, run: null };
+    }
+    const latestRun = runs2.reduce(
+      (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
+    );
+    return {
+      totalRuns: runs2.length,
+      run: latestRun
+    };
+  }
+}
 
 // src/cli-commands/operator.ts
 var OPERATOR_CLI_COMMANDS = [
@@ -3497,11 +3825,11 @@ var OPERATOR_CLI_COMMANDS = [
 ];
 
 // src/commands/project.ts
-function getClient12() {
+function getClient13() {
   return createApiClient();
 }
 async function createProject(name, opts) {
-  const client = getClient12();
+  const client = getClient13();
   const result = await client.putProject(name, {
     displayName: opts.displayName,
     canonicalDomain: opts.domain,
@@ -3516,7 +3844,7 @@ async function createProject(name, opts) {
   console.log(`Project created: ${result.name} (${result.id})`);
 }
 async function listProjects(format) {
-  const client = getClient12();
+  const client = getClient13();
   const projects2 = await client.listProjects();
   if (format === "json") {
     console.log(JSON.stringify(projects2, null, 2));
@@ -3544,7 +3872,7 @@ async function listProjects(format) {
   }
 }
 async function showProject(name, format) {
-  const client = getClient12();
+  const client = getClient13();
   const project = await client.getProject(name);
   if (format === "json") {
     console.log(JSON.stringify(project, null, 2));
@@ -3570,7 +3898,7 @@ async function showProject(name, format) {
   if (project.updatedAt) console.log(`  Updated:          ${project.updatedAt}`);
 }
 async function updateProjectSettings(name, opts) {
-  const client = getClient12();
+  const client = getClient13();
   const project = await client.getProject(name);
   let ownedDomains = opts.ownedDomains ?? project.ownedDomains ?? [];
   if (opts.addOwnedDomain) {
@@ -3595,7 +3923,7 @@ async function updateProjectSettings(name, opts) {
   console.log(`Project updated: ${result.name}`);
 }
 async function deleteProject(name, format) {
-  const client = getClient12();
+  const client = getClient13();
   await client.deleteProject(name);
   if (format === "json") {
     console.log(JSON.stringify({ name, deleted: true }, null, 2));
@@ -3604,7 +3932,7 @@ async function deleteProject(name, format) {
   console.log(`Project deleted: ${name}`);
 }
 async function addLocation(project, opts) {
-  const client = getClient12();
+  const client = getClient13();
   const location = await client.addLocation(project, {
     label: opts.label,
     city: opts.city,
@@ -3619,7 +3947,7 @@ async function addLocation(project, opts) {
   console.log(`Location added: ${opts.label} (${opts.city}, ${opts.region}, ${opts.country})`);
 }
 async function listLocations(project, format) {
-  const client = getClient12();
+  const client = getClient13();
   const result = await client.listLocations(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -3645,7 +3973,7 @@ async function listLocations(project, format) {
   }
 }
 async function removeLocation(project, label, format) {
-  const client = getClient12();
+  const client = getClient13();
   await client.removeLocation(project, label);
   if (format === "json") {
     console.log(JSON.stringify({ project, label, removed: true }, null, 2));
@@ -3654,7 +3982,7 @@ async function removeLocation(project, label, format) {
   console.log(`Location removed: ${label}`);
 }
 async function setDefaultLocation(project, label, format) {
-  const client = getClient12();
+  const client = getClient13();
   const result = await client.setDefaultLocation(project, label);
   if (format === "json") {
     console.log(JSON.stringify({ project, ...result }, null, 2));
@@ -3833,12 +4161,12 @@ var PROJECT_CLI_COMMANDS = [
 ];
 
 // src/commands/run.ts
-function getClient13() {
+function getClient14() {
   return createApiClient();
 }
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
 async function triggerRun(project, opts) {
-  const client = getClient13();
+  const client = getClient14();
   const body = {};
   if (opts?.provider) {
     const providerInputs = opts.provider.split(",").map((s) => s.trim()).filter(Boolean);
@@ -3862,7 +4190,7 @@ async function triggerRun(project, opts) {
         const settled = await Promise.all(
           locationRuns.map(async (r) => {
             if (!r.id || r.status === "conflict") return r;
-            const final = await pollRun(client, r.id);
+            const final = await pollRun2(client, r.id);
             return { ...r, ...final };
           })
         );
@@ -3887,7 +4215,7 @@ async function triggerRun(project, opts) {
         process.stderr.write(`Waiting for ${pending.length} run(s)`);
         await Promise.all(
           pending.map(async (r) => {
-            const final = await pollRun(client, r.id);
+            const final = await pollRun2(client, r.id);
             r.status = final.status;
           })
         );
@@ -3904,7 +4232,7 @@ async function triggerRun(project, opts) {
   const run = response;
   if (opts?.wait && run.id && !TERMINAL_STATUSES.has(run.status)) {
     process.stderr.write(`Run ${run.id} started`);
-    const result = await pollRun(client, run.id);
+    const result = await pollRun2(client, run.id);
     if (opts?.format === "json") {
       console.log(JSON.stringify(result, null, 2));
     } else {
@@ -3934,7 +4262,7 @@ async function triggerRun(project, opts) {
   }
 }
 async function triggerRunAll(opts) {
-  const client = getClient13();
+  const client = getClient14();
   const projects2 = await client.listProjects();
   if (projects2.length === 0) {
     if (opts?.format === "json") {
@@ -3971,7 +4299,7 @@ async function triggerRunAll(opts) {
     if (pending.length > 0) {
       process.stderr.write(`Waiting for ${pending.length} run(s)`);
       await Promise.all(pending.map(async (r) => {
-        const final = await pollRun(client, r.runId);
+        const final = await pollRun2(client, r.runId);
         r.status = final.status;
       }));
       process.stderr.write("\n");
@@ -3992,7 +4320,7 @@ async function triggerRunAll(opts) {
   }
 }
 async function cancelRun(project, runId, format) {
-  const client = getClient13();
+  const client = getClient14();
   let targetId = runId;
   if (!targetId) {
     const runs2 = await client.listRuns(project);
@@ -4024,7 +4352,7 @@ To cancel by ID  : canonry run cancel ${project} <run-id>`,
   console.log(`Run ${result.id} cancelled.`);
 }
 async function showRun(id, format) {
-  const client = getClient13();
+  const client = getClient14();
   const run = await client.getRun(id);
   if (format === "json") {
     console.log(JSON.stringify(run, null, 2));
@@ -4033,7 +4361,7 @@ async function showRun(id, format) {
   printRunDetail(run);
 }
 async function listRuns(project, opts) {
-  const client = getClient13();
+  const client = getClient14();
   const runs2 = await client.listRuns(project, opts?.limit);
   if (opts?.format === "json") {
     console.log(JSON.stringify(runs2, null, 2));
@@ -4054,7 +4382,7 @@ async function listRuns(project, opts) {
   }
 }
 var POLL_TIMEOUT_MS = 10 * 60 * 1e3;
-async function pollRun(client, runId) {
+async function pollRun2(client, runId) {
   const deadline = Date.now() + POLL_TIMEOUT_MS;
   for (; ; ) {
     await new Promise((r) => setTimeout(r, 2e3));
@@ -4178,11 +4506,11 @@ var RUN_CLI_COMMANDS = [
 ];
 
 // src/commands/schedule.ts
-function getClient14() {
+function getClient15() {
   return createApiClient();
 }
 async function setSchedule(project, opts) {
-  const client = getClient14();
+  const client = getClient15();
   const body = {};
   if (opts.preset) body.preset = opts.preset;
   if (opts.cron) body.cron = opts.cron;
@@ -4197,7 +4525,7 @@ async function setSchedule(project, opts) {
   printSchedule(result);
 }
 async function showSchedule(project, format) {
-  const client = getClient14();
+  const client = getClient15();
   const result = await client.getSchedule(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -4206,7 +4534,7 @@ async function showSchedule(project, format) {
   printSchedule(result);
 }
 async function enableSchedule(project, format) {
-  const client = getClient14();
+  const client = getClient15();
   const current = await client.getSchedule(project);
   const body = { timezone: current.timezone, enabled: true };
   if (current.preset) body.preset = current.preset;
@@ -4220,7 +4548,7 @@ async function enableSchedule(project, format) {
   console.log(`Schedule enabled for "${project}"`);
 }
 async function disableSchedule(project, format) {
-  const client = getClient14();
+  const client = getClient15();
   const current = await client.getSchedule(project);
   const body = { timezone: current.timezone, enabled: false };
   if (current.preset) body.preset = current.preset;
@@ -4234,7 +4562,7 @@ async function disableSchedule(project, format) {
   console.log(`Schedule disabled for "${project}"`);
 }
 async function removeSchedule(project, format) {
-  const client = getClient14();
+  const client = getClient15();
   await client.deleteSchedule(project);
   if (format === "json") {
     console.log(JSON.stringify({ project, removed: true }, null, 2));
@@ -4341,11 +4669,11 @@ var SCHEDULE_CLI_COMMANDS = [
 ];
 
 // src/commands/settings.ts
-function getClient15() {
+function getClient16() {
   return createApiClient();
 }
 async function setProvider(name, opts) {
-  const client = getClient15();
+  const client = getClient16();
   const { format, ...payload } = opts;
   const result = await client.updateProvider(name, payload);
   if (format === "json") {
@@ -4361,7 +4689,7 @@ async function setProvider(name, opts) {
   }
 }
 async function showSettings(format) {
-  const client = getClient15();
+  const client = getClient16();
   const config = loadConfig();
   const settings = await client.getSettings();
   if (format === "json") {
@@ -4864,7 +5192,7 @@ function wrapText(font, text, size, maxWidth) {
 }
 
 // src/commands/snapshot.ts
-function getClient16() {
+function getClient17() {
   return createApiClient();
 }
 function slugify(value) {
@@ -4875,7 +5203,7 @@ function autoOutputPath(companyName, ext) {
   return `${slugify(companyName)}-snapshot-${date}.${ext}`;
 }
 async function createSnapshotReport(companyName, opts) {
-  const client = getClient16();
+  const client = getClient17();
   const report = await client.createSnapshot({
     companyName,
     domain: opts.domain,
@@ -6168,10 +6496,10 @@ var SYSTEM_CLI_COMMANDS = [
 import fs7 from "fs";
 
 // src/commands/wordpress.ts
-function getClient17() {
+function getClient18() {
   return createApiClient();
 }
-function printJson(value) {
+function printJson2(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function printSiteStatus(label, status) {
@@ -6315,7 +6643,7 @@ async function wordpressConnect(project, opts) {
       details: { project }
     });
   }
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressConnect(project, {
     url: opts.url,
     stagingUrl: opts.stagingUrl,
@@ -6324,7 +6652,7 @@ async function wordpressConnect(project, opts) {
     defaultEnv: opts.defaultEnv
   });
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`WordPress connected for project "${project}".
@@ -6332,46 +6660,46 @@ async function wordpressConnect(project, opts) {
   printWordpressStatus(project, result);
 }
 async function wordpressDisconnect(project, format) {
-  const client = getClient17();
+  const client = getClient18();
   await client.wordpressDisconnect(project);
   if (format === "json") {
-    printJson({ project, disconnected: true });
+    printJson2({ project, disconnected: true });
     return;
   }
   console.log(`WordPress disconnected from project "${project}".`);
 }
 async function wordpressStatus(project, format) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressStatus(project);
   if (format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   printWordpressStatus(project, result);
 }
 async function wordpressPages(project, opts) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressPages(project, opts.env);
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   printPages(project, result.env, result.pages);
 }
 async function wordpressPage(project, slug, opts) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressPage(project, slug, opts.env);
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   printPageDetail(result);
 }
 async function wordpressCreatePage(project, body) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressCreatePage(project, body);
   if (body.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`Created WordPress page "${result.slug}" in ${result.env}.
@@ -6379,10 +6707,10 @@ async function wordpressCreatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressUpdatePage(project, body) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressUpdatePage(project, body);
   if (body.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`Updated WordPress page "${body.currentSlug}" in ${result.env}.
@@ -6390,10 +6718,10 @@ async function wordpressUpdatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressSetMeta(project, body) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressSetMeta(project, body);
   if (body.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`Updated SEO meta for "${body.slug}" in ${result.env}.
@@ -6440,10 +6768,10 @@ async function wordpressBulkSetMeta(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressBulkSetMeta(project, { entries, env: opts.env });
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   const applied = result.results.filter((r) => r.status === "applied");
@@ -6483,10 +6811,10 @@ async function wordpressBulkSetMeta(project, opts) {
 Total: ${applied.length} applied, ${skipped.length} skipped, ${manual.length} manual`);
 }
 async function wordpressSchema(project, slug, opts) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressSchema(project, slug, opts.env);
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`Schema for "${slug}" (${result.env}):
@@ -6494,10 +6822,10 @@ async function wordpressSchema(project, slug, opts) {
   printSchemaBlocks(result.blocks);
 }
 async function wordpressSetSchema(project, body) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressSetSchema(project, body);
   if (body.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   printManualAssist(`Schema update for "${body.slug}"`, result);
@@ -6542,10 +6870,10 @@ async function wordpressSchemaDeploy(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressSchemaDeploy(project, { profile: parsed, env: opts.env });
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`Schema deploy (${result.env}):
@@ -6581,10 +6909,10 @@ async function wordpressSchemaDeploy(project, opts) {
 Total: ${deployed} deployed, ${stripped} stripped, ${skipped} skipped, ${failed} failed`);
 }
 async function wordpressSchemaStatus(project, opts) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressSchemaStatus(project, opts.env);
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`Schema status (${result.env}):
@@ -6640,7 +6968,7 @@ async function wordpressOnboard(project, opts) {
       });
     }
   }
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressOnboard(project, {
     url: opts.url,
     username: opts.user,
@@ -6652,7 +6980,7 @@ async function wordpressOnboard(project, opts) {
     skipSubmit: opts.skipSubmit
   });
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`WordPress onboarding for "${project}":
@@ -6665,10 +6993,10 @@ async function wordpressOnboard(project, opts) {
   }
 }
 async function wordpressLlmsTxt(project, opts) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressLlmsTxt(project, opts.env);
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`llms.txt for "${project}" (${result.env}): ${result.url}
@@ -6676,19 +7004,19 @@ async function wordpressLlmsTxt(project, opts) {
   console.log(result.content ?? "(not found)");
 }
 async function wordpressSetLlmsTxt(project, body) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressSetLlmsTxt(project, body);
   if (body.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   printManualAssist(`llms.txt update for "${project}"`, result);
 }
 async function wordpressAudit(project, opts) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressAudit(project, opts.env);
   if (opts.format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`WordPress audit for "${project}" (${result.env}):
@@ -6699,19 +7027,19 @@ async function wordpressAudit(project, opts) {
   printAuditIssues(result.issues);
 }
 async function wordpressDiff(project, slug, format) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressDiff(project, slug);
   if (format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   printDiff(result);
 }
 async function wordpressStagingStatus(project, format) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressStagingStatus(project);
   if (format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   console.log(`WordPress staging status for "${project}":
@@ -6722,10 +7050,10 @@ async function wordpressStagingStatus(project, format) {
   console.log(`  Admin URL:         ${result.adminUrl}`);
 }
 async function wordpressStagingPush(project, format) {
-  const client = getClient17();
+  const client = getClient18();
   const result = await client.wordpressStagingPush(project);
   if (format === "json") {
-    printJson(result);
+    printJson2(result);
     return;
   }
   printManualAssist(`Staging push for "${project}"`, result);
@@ -7519,27 +7847,48 @@ var AGENT_CLI_COMMANDS = [
       scope: stringOption()
     },
     run: async (input) => {
-      const [project, ...rest] = input.positionals;
-      if (!project || rest.length === 0) {
-        console.error('Usage: canonry agent ask <project> "<prompt>"');
-        process.exitCode = 1;
-        return;
+      const usage = `canonry agent ask <project> "<prompt>" [--provider ${listAgentProviders().join("|")}] [--model <id>] [--scope all|read-only] [--format json]`;
+      const project = requireProject(input, "agent.ask", usage);
+      const prompt2 = input.positionals.slice(1).join(" ").trim();
+      if (!prompt2) {
+        throw usageError(`Error: prompt is required
+Usage: ${usage}`, {
+          message: "prompt is required",
+          details: {
+            command: "agent.ask",
+            usage
+          }
+        });
       }
       const providerInput = getString(input.values, "provider");
       if (providerInput && !coerceAgentProvider(providerInput)) {
-        console.error(`--provider must be one of: ${listAgentProviders().join(", ")}`);
-        process.exitCode = 1;
-        return;
+        throw usageError(`Error: --provider must be one of: ${listAgentProviders().join(", ")}
+Usage: ${usage}`, {
+          message: `--provider must be one of: ${listAgentProviders().join(", ")}`,
+          details: {
+            command: "agent.ask",
+            usage,
+            provider: providerInput,
+            validProviders: listAgentProviders()
+          }
+        });
       }
       const scopeInput = getString(input.values, "scope");
       if (scopeInput && !AGENT_ASK_SCOPES.includes(scopeInput)) {
-        console.error(`--scope must be one of: ${AGENT_ASK_SCOPES.join(", ")}`);
-        process.exitCode = 1;
-        return;
+        throw usageError(`Error: --scope must be one of: ${AGENT_ASK_SCOPES.join(", ")}
+Usage: ${usage}`, {
+          message: `--scope must be one of: ${AGENT_ASK_SCOPES.join(", ")}`,
+          details: {
+            command: "agent.ask",
+            usage,
+            scope: scopeInput,
+            validScopes: AGENT_ASK_SCOPES
+          }
+        });
       }
       await agentAsk({
         project,
-        prompt: rest.join(" "),
+        prompt: prompt2,
         provider: coerceAgentProvider(providerInput),
         modelId: getString(input.values, "model"),
         scope: scopeInput,
@@ -7552,12 +7901,7 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent providers <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent providers <project>");
-        process.exitCode = 1;
-        return;
-      }
+      const project = requireProject(input, "agent.providers", "canonry agent providers <project> [--format json]");
       await agentProviders({ project, format: input.format });
     }
   },
@@ -7568,18 +7912,16 @@ var AGENT_CLI_COMMANDS = [
       url: stringOption()
     },
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent attach <project> --url <webhook-url>");
-        process.exitCode = 1;
-        return;
-      }
-      const url = getString(input.values, "url");
-      if (!url) {
-        console.error("Missing required --url flag. Specify the agent webhook URL to attach.");
-        process.exitCode = 1;
-        return;
-      }
+      const usage = "canonry agent attach <project> --url <webhook-url> [--format json]";
+      const project = requireProject(input, "agent.attach", usage);
+      const url = requireStringOption(input, "url", {
+        command: "agent.attach",
+        usage,
+        message: "--url is required",
+        details: {
+          flag: "url"
+        }
+      });
       await agentAttach({ project, url, format: input.format });
     }
   },
@@ -7588,12 +7930,7 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent detach <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent detach <project>");
-        process.exitCode = 1;
-        return;
-      }
+      const project = requireProject(input, "agent.detach", "canonry agent detach <project> [--format json]");
       await agentDetach({ project, format: input.format });
     }
   },
@@ -7602,12 +7939,7 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent transcript <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent transcript <project>");
-        process.exitCode = 1;
-        return;
-      }
+      const project = requireProject(input, "agent.transcript", "canonry agent transcript <project> [--format json]");
       await agentTranscript({ project, format: input.format });
     }
   },
@@ -7616,12 +7948,7 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent reset <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent reset <project>");
-        process.exitCode = 1;
-        return;
-      }
+      const project = requireProject(input, "agent.reset", "canonry agent reset <project> [--format json]");
       await agentTranscriptReset({ project, format: input.format });
     }
   },
@@ -7630,12 +7957,8 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent memory list <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        throw usageError("Usage: canonry agent memory list <project>", {
-          message: "project name is required"
-        });
-      }
+      const usage = "canonry agent memory list <project> [--format json]";
+      const project = requireProject(input, "agent.memory.list", usage);
       await agentMemoryList({ project, format: input.format });
     }
   },
@@ -7647,19 +7970,24 @@ var AGENT_CLI_COMMANDS = [
       value: stringOption()
     },
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        throw usageError("Usage: canonry agent memory set <project> --key <k> --value <v>", {
-          message: "project name is required"
-        });
-      }
-      const key = getString(input.values, "key");
-      const value = getString(input.values, "value");
-      if (!key || !value) {
-        throw usageError("--key and --value are both required.", {
-          message: "--key and --value are both required"
-        });
-      }
+      const usage = "canonry agent memory set <project> --key <k> --value <v> [--format json]";
+      const project = requireProject(input, "agent.memory.set", usage);
+      const key = requireStringOption(input, "key", {
+        command: "agent.memory.set",
+        usage,
+        message: "--key is required",
+        details: {
+          flag: "key"
+        }
+      });
+      const value = requireStringOption(input, "value", {
+        command: "agent.memory.set",
+        usage,
+        message: "--value is required",
+        details: {
+          flag: "value"
+        }
+      });
       await agentMemorySet({ project, key, value, format: input.format });
     }
   },
@@ -7670,18 +7998,16 @@ var AGENT_CLI_COMMANDS = [
       key: stringOption()
     },
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        throw usageError("Usage: canonry agent memory forget <project> --key <k>", {
-          message: "project name is required"
-        });
-      }
-      const key = getString(input.values, "key");
-      if (!key) {
-        throw usageError("--key is required.", {
-          message: "--key is required"
-        });
-      }
+      const usage = "canonry agent memory forget <project> --key <k> [--format json]";
+      const project = requireProject(input, "agent.memory.forget", usage);
+      const key = requireStringOption(input, "key", {
+        command: "agent.memory.forget",
+        usage,
+        message: "--key is required",
+        details: {
+          flag: "key"
+        }
+      });
       await agentMemoryForget({ project, key, format: input.format });
     }
   }
@@ -7690,6 +8016,7 @@ var AGENT_CLI_COMMANDS = [
 // src/cli-commands.ts
 var REGISTERED_CLI_COMMANDS = [
   ...BACKFILL_CLI_COMMANDS,
+  ...BACKLINKS_CLI_COMMANDS,
   ...SYSTEM_CLI_COMMANDS,
   ...PROJECT_CLI_COMMANDS,
   ...KEYWORD_CLI_COMMANDS,