@canonry/canonry 4.129.1 → 4.130.0

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-GYAKRVE2.js";
+} from "./chunk-QR5U2K3O.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-WWZE7VDQ.js";
+} from "./chunk-WIALMCXM.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +54,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-LPEE5AYY.js";
+} from "./chunk-5XU6WEMK.js";
 import {
   AdsOperationKinds,
   AdsOperationStates,
@@ -66,6 +66,7 @@ import {
   CitationStates,
   READ_ONLY_SCOPE,
   REPORT_PERIOD_OPTIONS,
+  ResearchRunStatuses,
   RunStatuses,
   TrafficEventKinds,
   TrafficSeriesGranularities,
@@ -96,7 +97,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-K4FDDCYG.js";
+} from "./chunk-NVRJZU6V.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -2574,6 +2575,254 @@ var DISCOVER_CLI_COMMANDS = [
   }
 ];
 
+// src/commands/research.ts
+var TERMINAL_RESEARCH_STATUSES = /* @__PURE__ */ new Set([
+  ResearchRunStatuses.completed,
+  ResearchRunStatuses.partial,
+  ResearchRunStatuses.failed
+]);
+var POLL_INTERVAL_MS3 = 2e3;
+var POLL_TIMEOUT_MS2 = 15 * 60 * 1e3;
+function getClient5() {
+  return createApiClient();
+}
+async function researchRun(project, opts) {
+  const client = getClient5();
+  const request = {
+    queries: opts.queries,
+    provider: opts.provider,
+    model: opts.model,
+    location: opts.location,
+    idempotencyKey: opts.idempotencyKey
+  };
+  const started = await client.startResearchRun(project, request);
+  if (!opts.wait) {
+    if (opts.format === "jsonl") {
+      emitJsonl([{ project, ...started }]);
+      return;
+    }
+    if (opts.format === "json") {
+      console.log(JSON.stringify(started, null, 2));
+      return;
+    }
+    printStarted(project, started);
+    return;
+  }
+  const detail = await pollResearchRun(client, project, started.id, isMachineFormat(opts.format));
+  printDetail(project, detail, opts.format);
+}
+async function researchList(project, opts) {
+  const client = getClient5();
+  const { runs } = await client.listResearchRuns(project, opts.limit === void 0 ? void 0 : { limit: opts.limit });
+  if (opts.format === "json") {
+    console.log(JSON.stringify({ runs }, null, 2));
+    return;
+  }
+  if (opts.format === "jsonl") {
+    emitJsonl(runs.map((run) => ({ project, ...run })));
+    return;
+  }
+  if (runs.length === 0) {
+    console.log(`No saved research runs for "${project}".`);
+    return;
+  }
+  console.log(`Research history for "${project}" (${runs.length}):
+`);
+  console.log("  ID                                    STATUS      QUERIES  PROVIDER / MODEL                  CREATED");
+  console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  for (const run of runs) {
+    const model = run.resolvedModel ? `${run.provider} / ${run.resolvedModel}` : run.provider;
+    console.log(`  ${run.id.padEnd(36)}  ${run.status.padEnd(10)}  ${String(run.totalQueries).padStart(7)}  ${model.slice(0, 32).padEnd(32)}  ${run.createdAt}`);
+  }
+}
+async function researchShow(project, runId, opts) {
+  const detail = await getClient5().getResearchRun(project, runId);
+  printDetail(project, detail, opts.format);
+}
+async function pollResearchRun(client, project, runId, quiet) {
+  if (!quiet) process.stderr.write(`Waiting for research run ${runId}`);
+  const deadline = Date.now() + POLL_TIMEOUT_MS2;
+  for (; ; ) {
+    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS3));
+    if (Date.now() > deadline) {
+      throw new CliError({
+        code: "RESEARCH_TIMEOUT",
+        message: `Timed out waiting for research run ${runId} after ${POLL_TIMEOUT_MS2 / 1e3}s`
+      });
+    }
+    const detail = await client.getResearchRun(project, runId);
+    if (!quiet) process.stderr.write(".");
+    if (TERMINAL_RESEARCH_STATUSES.has(detail.status)) {
+      if (!quiet) process.stderr.write("\n");
+      return detail;
+    }
+  }
+}
+function printStarted(project, run) {
+  console.log(`Research run saved: ${run.id}`);
+  console.log(`  Status:   ${run.status}`);
+  console.log(`  Queries:  ${run.totalQueries}`);
+  console.log(`  Provider: ${run.provider}${run.resolvedModel ? ` / ${run.resolvedModel}` : ""}`);
+  console.log(`  Inspect:  canonry research show ${project} ${run.id}`);
+  console.log("  Nothing was added to tracked queries.");
+}
+function printDetail(project, detail, format) {
+  if (format === "json") {
+    console.log(JSON.stringify(detail, null, 2));
+    return;
+  }
+  if (format === "jsonl") {
+    emitJsonl(detail.queries.map((query) => ({ project, runId: detail.id, ...query })));
+    return;
+  }
+  console.log(`Research run: ${detail.id}`);
+  console.log(`  Status:   ${detail.status}`);
+  console.log(`  Provider: ${detail.provider}${detail.resolvedModel ? ` / ${detail.resolvedModel}` : ""}`);
+  if (detail.location) console.log(`  Location: ${detail.location.label}`);
+  console.log(`  Results:  ${detail.completedQueries} completed, ${detail.failedQueries} failed, ${detail.totalQueries} total`);
+  if (detail.error) console.log(`  Error:    ${detail.error}`);
+  console.log("  Nothing was added to tracked queries.");
+  if (detail.queries.length === 0) return;
+  console.log("\n  QUERY                                                       STATUS      CITED  MENTIONED");
+  for (const query of detail.queries) {
+    const cited = query.citationState === CitationStates.cited ? "yes" : query.citationState ? "no" : "\u2013";
+    const mentioned = query.answerMentioned === null ? "\u2013" : query.answerMentioned ? "yes" : "no";
+    console.log(`  ${query.query.slice(0, 58).padEnd(58)}  ${query.status.padEnd(10)}  ${cited.padEnd(5)}  ${mentioned}`);
+    if (query.error) console.log(`    Error: ${query.error}`);
+    if (query.answerText) console.log(`    Answer: ${query.answerText}`);
+    if (query.groundingSources.length > 0) {
+      console.log("    Sources:");
+      for (const source of query.groundingSources) {
+        console.log(`      - ${source.title ? `${source.title}: ` : ""}${source.uri}`);
+      }
+    }
+  }
+}
+
+// src/cli-commands/research.ts
+var RUN_USAGE = "canonry research run <project> <query...> [--query <text>] [--provider <name>] [--model <id>] [--location <label>|--no-location] [--idempotency-key <key>] [--wait] [--format json|jsonl]";
+function normalizeQueries(input, usage) {
+  const positional = input.positionals.slice(1);
+  const flagged = getStringArray(input.values, "query") ?? [];
+  const seen = /* @__PURE__ */ new Set();
+  const queries2 = [];
+  for (const raw of [...positional, ...flagged]) {
+    const query = raw.trim();
+    const key = query.toLocaleLowerCase();
+    if (query && !seen.has(key)) {
+      seen.add(key);
+      queries2.push(query);
+    }
+  }
+  if (queries2.length === 0) {
+    throw usageError(`Error: at least one research query is required
+Usage: ${usage}`, {
+      message: "at least one research query is required",
+      details: { command: "research.run", usage }
+    });
+  }
+  if (queries2.length > 50) {
+    throw usageError(`Error: at most 50 research queries are allowed
+Usage: ${usage}`, {
+      message: "at most 50 research queries are allowed",
+      details: { command: "research.run", usage, queryCount: queries2.length }
+    });
+  }
+  return queries2;
+}
+function parseResearchLimit(input, usage) {
+  const limit = parseIntegerOption(input, "limit", {
+    command: "research.list",
+    usage,
+    message: "--limit must be an integer"
+  });
+  if (limit === void 0) return void 0;
+  if (limit >= 1 && limit <= 100) return limit;
+  throw usageError(`Error: --limit must be between 1 and 100
+Usage: ${usage}`, {
+    message: "--limit must be between 1 and 100",
+    details: { command: "research.list", usage, option: "limit", value: limit }
+  });
+}
+async function resolveLocation(project, label, noLocation, usage) {
+  if (label && noLocation) {
+    throw usageError(`Error: --location and --no-location cannot be used together
+Usage: ${usage}`, {
+      message: "--location and --no-location cannot be used together",
+      details: { command: "research.run", usage }
+    });
+  }
+  if (noLocation) return null;
+  if (!label) return void 0;
+  const configured = await createApiClient().getProject(project);
+  const location = configured.locations.find((candidate) => candidate.label === label);
+  if (location) return location;
+  throw usageError(`Error: location "${label}" is not configured for project "${project}"
+Usage: ${usage}`, {
+    message: `location "${label}" is not configured for project "${project}"`,
+    details: { command: "research.run", usage, location: label, project }
+  });
+}
+var RESEARCH_CLI_COMMANDS = [
+  {
+    path: ["research", "run"],
+    usage: RUN_USAGE,
+    options: {
+      query: multiStringOption(),
+      provider: stringOption(),
+      model: stringOption(),
+      location: stringOption(),
+      "no-location": { type: "boolean", default: false },
+      "idempotency-key": stringOption(),
+      wait: { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const project = requireProject(input, "research.run", RUN_USAGE);
+      const provider = getString(input.values, "provider")?.trim() || void 0;
+      const model = getString(input.values, "model")?.trim() || void 0;
+      if (model && !provider) {
+        throw usageError(`Error: --model requires --provider
+Usage: ${RUN_USAGE}`, {
+          message: "--model requires --provider",
+          details: { command: "research.run", usage: RUN_USAGE }
+        });
+      }
+      await researchRun(project, {
+        queries: normalizeQueries(input, RUN_USAGE),
+        provider,
+        model,
+        location: await resolveLocation(project, getString(input.values, "location"), getBoolean(input.values, "no-location"), RUN_USAGE),
+        idempotencyKey: getString(input.values, "idempotency-key")?.trim() || void 0,
+        wait: getBoolean(input.values, "wait"),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["research", "list"],
+    usage: "canonry research list <project> [--limit <n>] [--format json|jsonl]",
+    options: { limit: stringOption() },
+    run: async (input) => {
+      const usage = "canonry research list <project> [--limit <n>] [--format json|jsonl]";
+      const project = requireProject(input, "research.list", usage);
+      await researchList(project, {
+        limit: parseResearchLimit(input, usage),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["research", "show"],
+    usage: "canonry research show <project> <run-id> [--format json|jsonl]",
+    run: async (input) => {
+      const usage = "canonry research show <project> <run-id> [--format json|jsonl]";
+      const project = requireProject(input, "research.show", usage);
+      const runId = requirePositional(input, 1, { command: "research.show", usage, message: "research run ID is required" });
+      await researchShow(project, runId, { format: input.format });
+    }
+  }
+];
+
 // src/commands/doctor.ts
 async function doctorCommand(opts) {
   if (opts.all) {
@@ -2730,7 +2979,7 @@ var DOCTOR_CLI_COMMANDS = [
 
 // src/commands/ads.ts
 import fs3 from "fs";
-function getClient5() {
+function getClient6() {
   return createApiClient();
 }
 function readRequest(inputPath, schema) {
@@ -2824,7 +3073,7 @@ async function adsConnect(project, opts) {
       details: { project }
     });
   }
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.adsConnect(project, { apiKey: opts.apiKey });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -2835,7 +3084,7 @@ async function adsConnect(project, opts) {
   console.log("Schedule daily syncs with: canonry schedule set " + project + " --kind ads-sync --preset daily");
 }
 async function adsDisconnect(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.adsDisconnect(project);
   if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -2844,7 +3093,7 @@ async function adsDisconnect(project, opts) {
   console.log(result.disconnected ? `Disconnected the ads connection for ${project}.` : "No ads connection to remove.");
 }
 async function adsStatus(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.getAdsStatus(project);
   if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -2856,7 +3105,7 @@ async function adsStatus(project, opts) {
   }
 }
 async function adsAccount(project, opts) {
-  const result = await getClient5().getAdsAccount(project);
+  const result = await getClient6().getAdsAccount(project);
   if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
@@ -2885,7 +3134,7 @@ async function adsGeoSearch(project, opts) {
     });
   }
   const query = parsed.data;
-  const result = await getClient5().searchAdsGeo(project, query);
+  const result = await getClient6().searchAdsGeo(project, query);
   if (opts.format === "jsonl") {
     emitJsonl(result.results.map((location) => ({ project, query: result.query, ...location })));
     return;
@@ -2904,7 +3153,7 @@ async function adsGeoSearch(project, opts) {
   }
 }
 async function adsConversionPixels(project, opts) {
-  const result = await getClient5().getAdsConversionPixels(project);
+  const result = await getClient6().getAdsConversionPixels(project);
   if (opts?.format === "jsonl") {
     emitJsonl(result.pixels.map((pixel) => ({ project, ...pixel })));
     return;
@@ -2925,7 +3174,7 @@ async function adsConversionPixels(project, opts) {
   }
 }
 async function adsConversionEventSettings(project, opts) {
-  const result = await getClient5().getAdsConversionEventSettings(project);
+  const result = await getClient6().getAdsConversionEventSettings(project);
   if (opts?.format === "jsonl") {
     emitJsonl(result.eventSettings.map((eventSetting) => ({ project, ...eventSetting })));
     return;
@@ -2950,7 +3199,7 @@ async function adsConversionEventSettings(project, opts) {
   }
 }
 async function adsOperationGet(project, opts) {
-  printOperation(await getClient5().getAdsOperation(project, opts.operationKey), opts.format);
+  printOperation(await getClient6().getAdsOperation(project, opts.operationKey), opts.format);
 }
 async function adsOperationsUnresolved(project, opts) {
   const query = {
@@ -2958,7 +3207,7 @@ async function adsOperationsUnresolved(project, opts) {
     limit: opts?.limit,
     cursor: opts?.cursor
   };
-  const client = getClient5();
+  const client = getClient6();
   const result = Object.values(query).some((value) => value !== void 0) ? await client.getUnresolvedAdsOperations(project, query) : await client.getUnresolvedAdsOperations(project);
   if (opts?.format === "jsonl") {
     emitJsonl(result.operations.map((operation) => ({ project, ...operation })));
@@ -2980,13 +3229,13 @@ async function adsOperationsUnresolved(project, opts) {
 }
 async function adsOperationReconcile(project, opts) {
   printReconciliation(
-    await getClient5().reconcileAdsOperation(project, opts.operationKey),
+    await getClient6().reconcileAdsOperation(project, opts.operationKey),
     opts.format
   );
 }
 async function adsOperationResumeActivation(project, opts) {
   printActivation(
-    await getClient5().resumeAdsActivation(project, opts.operationKey),
+    await getClient6().resumeAdsActivation(project, opts.operationKey),
     opts.format
   );
 }
@@ -2995,61 +3244,61 @@ async function adsActivationGrantCreate(project, opts) {
     opts.input,
     adsActivationGrantCreateRequestSchema
   );
-  printActivationGrant(await getClient5().createAdsActivationGrant(project, request), "Approved", opts.format);
+  printActivationGrant(await getClient6().createAdsActivationGrant(project, request), "Approved", opts.format);
 }
 async function adsActivationGrantRevoke(project, grantId, opts) {
   printActivationGrant(
-    await getClient5().revokeAdsActivationGrant(project, grantId),
+    await getClient6().revokeAdsActivationGrant(project, grantId),
     "Revoked",
     opts?.format
   );
 }
 async function adsImageUpload(project, opts) {
   const request = readRequest(opts.input, adsImageUploadRequestSchema);
-  printOperation(await getClient5().uploadAdsImage(project, request), opts.format);
+  printOperation(await getClient6().uploadAdsImage(project, request), opts.format);
 }
 async function adsCampaignCreate(project, opts) {
   const request = readRequest(opts.input, adsCampaignCreateRequestSchema);
-  printOperation(await getClient5().createAdsCampaign(project, request), opts.format);
+  printOperation(await getClient6().createAdsCampaign(project, request), opts.format);
 }
 async function adsCampaignUpdate(project, campaignId, opts) {
   const request = readRequest(opts.input, adsCampaignUpdateRequestSchema);
-  printOperation(await getClient5().updateAdsCampaign(project, campaignId, request), opts.format);
+  printOperation(await getClient6().updateAdsCampaign(project, campaignId, request), opts.format);
 }
 async function adsCampaignPause(project, campaignId, opts) {
   const request = readRequest(opts.input, adsPauseRequestSchema);
-  printOperation(await getClient5().pauseAdsCampaign(project, campaignId, request), opts.format);
+  printOperation(await getClient6().pauseAdsCampaign(project, campaignId, request), opts.format);
 }
 async function adsCampaignActivateTree(project, campaignId, opts) {
   const request = readRequest(opts.input, adsActivateTreeRequestSchema);
-  printActivation(await getClient5().activateAdsCampaignTree(project, campaignId, request), opts.format);
+  printActivation(await getClient6().activateAdsCampaignTree(project, campaignId, request), opts.format);
 }
 async function adsAdGroupCreate(project, opts) {
   const request = readRequest(opts.input, adsAdGroupCreateRequestSchema);
-  printOperation(await getClient5().createAdsAdGroup(project, request), opts.format);
+  printOperation(await getClient6().createAdsAdGroup(project, request), opts.format);
 }
 async function adsAdGroupUpdate(project, adGroupId, opts) {
   const request = readRequest(opts.input, adsAdGroupUpdateRequestSchema);
-  printOperation(await getClient5().updateAdsAdGroup(project, adGroupId, request), opts.format);
+  printOperation(await getClient6().updateAdsAdGroup(project, adGroupId, request), opts.format);
 }
 async function adsAdGroupPause(project, adGroupId, opts) {
   const request = readRequest(opts.input, adsPauseRequestSchema);
-  printOperation(await getClient5().pauseAdsAdGroup(project, adGroupId, request), opts.format);
+  printOperation(await getClient6().pauseAdsAdGroup(project, adGroupId, request), opts.format);
 }
 async function adsAdCreate(project, opts) {
   const request = readRequest(opts.input, adsAdCreateRequestSchema);
-  printOperation(await getClient5().createAdsAd(project, request), opts.format);
+  printOperation(await getClient6().createAdsAd(project, request), opts.format);
 }
 async function adsAdUpdate(project, adId, opts) {
   const request = readRequest(opts.input, adsAdUpdateRequestSchema);
-  printOperation(await getClient5().updateAdsAd(project, adId, request), opts.format);
+  printOperation(await getClient6().updateAdsAd(project, adId, request), opts.format);
 }
 async function adsAdPause(project, adId, opts) {
   const request = readRequest(opts.input, adsPauseRequestSchema);
-  printOperation(await getClient5().pauseAdsAd(project, adId, request), opts.format);
+  printOperation(await getClient6().pauseAdsAd(project, adId, request), opts.format);
 }
 async function adsSync(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.triggerAdsSync(project);
   if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -3058,7 +3307,7 @@ async function adsSync(project, opts) {
   console.log(`Ads sync queued (run ${result.runId}). Check progress with: canonry runs get ${result.runId}`);
 }
 async function adsCampaigns(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.getAdsCampaigns(project);
   if (opts?.format === "jsonl") {
     emitJsonl(result.campaigns.map((campaign) => ({ project, ...campaign })));
@@ -3085,7 +3334,7 @@ async function adsCampaigns(project, opts) {
   }
 }
 async function adsInsights(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.getAdsInsights(project, {
     level: opts?.level,
     entityId: opts?.entity,
@@ -3114,7 +3363,7 @@ async function adsInsights(project, opts) {
   }
 }
 async function adsSummary(project, opts) {
-  const client = getClient5();
+  const client = getClient6();
   const result = await client.getAdsSummary(project);
   if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -3491,7 +3740,7 @@ Usage: ${usage}`, {
 ];
 
 // src/commands/ga.ts
-function getClient6() {
+function getClient7() {
   return createApiClient();
 }
 async function gaConnect(project, opts) {
@@ -3524,7 +3773,7 @@ async function gaConnect(project, opts) {
   } else if (opts.keyJson) {
     body.keyJson = opts.keyJson;
   }
-  const client = getClient6();
+  const client = getClient7();
   const result = await client.gaConnect(project, body);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -3539,7 +3788,7 @@ async function gaConnect(project, opts) {
   }
 }
 async function gaDisconnect(project, format) {
-  const client = getClient6();
+  const client = getClient7();
   await client.gaDisconnect(project);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, disconnected: true }, null, 2));
@@ -3548,7 +3797,7 @@ async function gaDisconnect(project, format) {
   console.log(`GA4 disconnected from project "${project}".`);
 }
 async function gaStatus(project, format) {
-  const client = getClient6();
+  const client = getClient7();
   const result = await client.gaStatus(project);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -3574,7 +3823,7 @@ async function gaStatus(project, format) {
   console.log(`  Connected:    ${result.createdAt ?? "unknown"}`);
 }
 async function gaSync(project, opts) {
-  const client = getClient6();
+  const client = getClient7();
   const body = {};
   if (opts?.days) body.days = opts.days;
   if (opts?.only) body.only = opts.only;
@@ -3594,7 +3843,7 @@ async function gaSync(project, opts) {
   console.log(`  Synced at:   ${result.syncedAt}`);
 }
 async function gaTraffic(project, opts) {
-  const client = getClient6();
+  const client = getClient7();
   const params = {};
   if (opts?.limit) params.limit = String(opts.limit);
   if (opts?.window) params.window = opts.window;
@@ -3689,7 +3938,7 @@ async function gaTraffic(project, opts) {
   }
 }
 async function gaAiReferralHistory(project, opts) {
-  const client = getClient6();
+  const client = getClient7();
   const result = await client.gaAiReferralHistory(project, opts?.window ? { window: opts.window } : void 0);
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -3717,7 +3966,7 @@ async function gaAiReferralHistory(project, opts) {
   }
 }
 async function gaSocialReferralHistory(project, opts) {
-  const client = getClient6();
+  const client = getClient7();
   const result = await client.gaSocialReferralHistory(project, opts?.window ? { window: opts.window } : void 0);
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -3745,7 +3994,7 @@ async function gaSocialReferralHistory(project, opts) {
   }
 }
 async function gaSessionHistory(project, opts) {
-  const client = getClient6();
+  const client = getClient7();
   const result = await client.gaSessionHistory(project, opts?.window ? { window: opts.window } : void 0);
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -3776,7 +4025,7 @@ async function gaSessionHistory(project, opts) {
   }
 }
 async function gaCoverage(project, format) {
-  const client = getClient6();
+  const client = getClient7();
   const result = await client.gaCoverage(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -3802,7 +4051,7 @@ async function gaCoverage(project, format) {
   }
 }
 async function gaSocialReferralSummary(project, opts) {
-  const client = getClient6();
+  const client = getClient7();
   const traffic = await client.gaTraffic(project);
   if (opts?.trend) {
     const trend = await client.gaSocialReferralTrend(project);
@@ -3863,7 +4112,7 @@ async function gaSocialReferralSummary(project, opts) {
   }
 }
 async function gaAttribution(project, opts) {
-  const client = getClient6();
+  const client = getClient7();
   const traffic = await client.gaTraffic(project);
   const fmtTrend = (pct4) => pct4 === null ? "n/a" : `${pct4 >= 0 ? "+" : ""}${pct4}%`;
   if (opts?.trend) {
@@ -4229,7 +4478,7 @@ var GA_CLI_COMMANDS = [
 ];
 
 // src/commands/gbp.ts
-function getClient7() {
+function getClient8() {
   return createApiClient();
 }
 function formatLocationsTable(response) {
@@ -4247,7 +4496,7 @@ function formatLocationsTable(response) {
   return lines.join("\n");
 }
 async function gbpConnect(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const { authUrl, redirectUri } = await client.googleConnect(project, {
     type: "gbp",
     publicUrl: opts.publicUrl
@@ -4266,7 +4515,7 @@ async function gbpConnect(project, opts) {
   console.log("After authorizing, run `canonry gbp locations discover <project>` to fetch your locations.");
 }
 async function gbpDisconnect(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   await client.disconnectGbp(project);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify({ project, disconnected: true }, null, 2));
@@ -4275,7 +4524,7 @@ async function gbpDisconnect(project, opts) {
   console.log(`Disconnected GBP from project "${project}" and removed all discovered locations.`);
 }
 async function gbpLocationsList(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const response = await client.listGbpLocations(
     project,
     opts.selectedOnly ? { selected: true } : void 0
@@ -4287,7 +4536,7 @@ async function gbpLocationsList(project, opts) {
   console.log(formatLocationsTable(response));
 }
 async function gbpAccounts(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const response = await client.listGbpAccounts(project);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(response, null, 2));
@@ -4312,7 +4561,7 @@ function formatAccountsTable(response) {
   return lines.join("\n");
 }
 async function gbpLocationsDiscover(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const hasBody = opts.selectAllNew !== void 0 || opts.account !== void 0 || opts.switchAccount;
   const body = hasBody ? {
     ...opts.selectAllNew === void 0 ? {} : { selectAllNew: opts.selectAllNew },
@@ -4329,7 +4578,7 @@ Discovered ${response.totalDiscovered} location(s); ${response.totalSelected} se
   console.log(formatLocationsTable(response));
 }
 async function gbpLocationSelect(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const updated = await client.setGbpLocationSelection(project, opts.location, true);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(updated, null, 2));
@@ -4338,7 +4587,7 @@ async function gbpLocationSelect(project, opts) {
   console.log(`Selected ${opts.location} ("${updated.displayName}") for sync.`);
 }
 async function gbpLocationDeselect(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const updated = await client.setGbpLocationSelection(project, opts.location, false);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(updated, null, 2));
@@ -4347,7 +4596,7 @@ async function gbpLocationDeselect(project, opts) {
   console.log(`Deselected ${opts.location} ("${updated.displayName}"). Future syncs will skip this location.`);
 }
 async function gbpSync(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const { runId, status } = await client.triggerGbpSync(project, {
     locationNames: opts.location ? [opts.location] : void 0,
     daysOfMetrics: opts.days,
@@ -4383,7 +4632,7 @@ async function gbpSync(project, opts) {
   console.log(`GBP sync ${final} (run ${runId}).`);
 }
 async function gbpMetrics(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const response = await client.listGbpMetrics(project, { locationName: opts.location, metric: opts.metric });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(response, null, 2));
@@ -4401,7 +4650,7 @@ async function gbpMetrics(project, opts) {
   }
 }
 async function gbpKeywords(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const response = await client.listGbpKeywords(project, { locationName: opts.location });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(response, null, 2));
@@ -4418,7 +4667,7 @@ async function gbpKeywords(project, opts) {
   }
 }
 async function gbpPlaceActions(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const response = await client.listGbpPlaceActions(project, { locationName: opts.location });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(response, null, 2));
@@ -4435,7 +4684,7 @@ async function gbpPlaceActions(project, opts) {
   }
 }
 async function gbpLodging(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const response = await client.listGbpLodging(project, { locationName: opts.location });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(response, null, 2));
@@ -4452,7 +4701,7 @@ async function gbpLodging(project, opts) {
   }
 }
 async function gbpAttributes(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const response = await client.listGbpAttributes(project, { locationName: opts.location });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(response, null, 2));
@@ -4477,7 +4726,7 @@ async function gbpAttributes(project, opts) {
   }
 }
 async function gbpPlaces(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const response = await client.listGbpPlaces(project, { locationName: opts.location });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(response, null, 2));
@@ -4498,7 +4747,7 @@ function fmtDelta(pct4) {
   return `${pct4 >= 0 ? "+" : ""}${pct4}%`;
 }
 async function gbpSummary(project, opts) {
-  const client = getClient7();
+  const client = getClient8();
   const s = await client.getGbpSummary(project, { locationName: opts.location });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(s, null, 2));
@@ -4829,7 +5078,7 @@ var GET_CLI_COMMANDS = [
 ];
 
 // src/commands/traffic.ts
-function getClient8() {
+function getClient9() {
   return createApiClient();
 }
 function configString(value, fallback = "(unset)") {
@@ -4883,7 +5132,7 @@ async function trafficConnectWordpress(project, opts) {
       details: { project }
     });
   }
-  const client = getClient8();
+  const client = getClient9();
   const result = await client.trafficConnectWordpress(project, {
     baseUrl: opts.url,
     username: opts.username,
@@ -4934,7 +5183,7 @@ async function trafficConnectCloudRun(project, opts) {
       details: { project, keyFile: opts.serviceAccountKey }
     });
   }
-  const client = getClient8();
+  const client = getClient9();
   const result = await client.trafficConnectCloudRun(project, {
     gcpProjectId: opts.gcpProject,
     serviceName: opts.service,
@@ -5012,7 +5261,7 @@ async function trafficConnectVercel(project, opts) {
       details: { project, environment: opts.environment }
     });
   }
-  const client = getClient8();
+  const client = getClient9();
   const result = await client.trafficConnectVercel(project, {
     projectId: opts.projectId,
     teamId: opts.teamId,
@@ -5043,7 +5292,7 @@ async function trafficBackfill(project, opts) {
       details: { project }
     });
   }
-  const client = getClient8();
+  const client = getClient9();
   const submitted = await client.trafficBackfill(project, opts.source, {
     days: opts.days
   });
@@ -5112,7 +5361,7 @@ async function trafficSync(project, opts) {
       details: { project }
     });
   }
-  const client = getClient8();
+  const client = getClient9();
   const result = await client.trafficSync(project, opts.source, {
     sinceMinutes: opts.sinceMinutes
   });
@@ -5150,7 +5399,7 @@ async function trafficReset(project, opts) {
       details: { project, source: opts.source }
     });
   }
-  const client = getClient8();
+  const client = getClient9();
   const updated = await client.trafficReset(project, opts.source);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(updated, null, 2));
@@ -5593,11 +5842,11 @@ var TRAFFIC_CLI_COMMANDS = [
 ];
 
 // src/commands/competitor.ts
-function getClient9() {
+function getClient10() {
   return createApiClient();
 }
 async function addCompetitors(project, domains, format) {
-  const client = getClient9();
+  const client = getClient10();
   const existing = await client.listCompetitors(project);
   const existingDomains = existing.map((c) => c.domain);
   const existingSet = new Set(existingDomains);
@@ -5621,7 +5870,7 @@ async function addCompetitors(project, domains, format) {
   }
 }
 async function removeCompetitors(project, domains, format) {
-  const client = getClient9();
+  const client = getClient10();
   const existing = await client.listCompetitors(project);
   const existingDomains = existing.map((c) => c.domain);
   const requested = new Set(uniqueStrings(domains));
@@ -5650,7 +5899,7 @@ function uniqueStrings(values) {
   return result;
 }
 async function listCompetitors(project, format) {
-  const client = getClient9();
+  const client = getClient10();
   const comps = await client.listCompetitors(project);
   if (format === "json") {
     console.log(JSON.stringify(comps, null, 2));
@@ -5749,7 +5998,7 @@ var COMPETITOR_CLI_COMMANDS = [
 
 // src/commands/google.ts
 var INDEXING_API_SCOPE_NOTICE = "Note: Google's Indexing API officially supports only pages with JobPosting or BroadcastEvent (livestream VideoObject) structured data. For other URL types, submissions are accepted (HTTP 200) but not guaranteed to be prioritized for crawling. For general pages, submit a sitemap and use URL Inspection to monitor status.";
-function getClient10() {
+function getClient11() {
   return createApiClient();
 }
 async function waitForRunStatus2(client, runId, config) {
@@ -5789,7 +6038,7 @@ async function waitForRunStatus2(client, runId, config) {
   });
 }
 async function googleConnect(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const { authUrl, redirectUri } = await client.googleConnect(project, {
     type: opts.type,
     publicUrl: opts.publicUrl
@@ -5823,7 +6072,7 @@ Open this URL in your browser to authorize Google ${opts.type.toUpperCase()} acc
   }
 }
 async function googleDisconnect(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   await client.googleDisconnect(project, opts.type);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify({ project, type: opts.type, disconnected: true }, null, 2));
@@ -5832,7 +6081,7 @@ async function googleDisconnect(project, opts) {
   console.log(`Disconnected Google ${opts.type.toUpperCase()} from project "${project}".`);
 }
 async function googleStatus(project, format) {
-  const client = getClient10();
+  const client = getClient11();
   const connections = await client.googleConnections(project);
   if (format === "json") {
     console.log(JSON.stringify({ connections }, null, 2));
@@ -5859,7 +6108,7 @@ async function googleStatus(project, format) {
   }
 }
 async function googleProperties(project, format) {
-  const client = getClient10();
+  const client = getClient11();
   const { sites } = await client.googleProperties(project);
   if (format === "json") {
     console.log(JSON.stringify({ sites }, null, 2));
@@ -5883,7 +6132,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 = getClient10();
+  const client = getClient11();
   await client.googleSetProperty(project, "gsc", propertyUrl);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, type: "gsc", propertyUrl }, null, 2));
@@ -5892,7 +6141,7 @@ async function googleSetProperty(project, propertyUrl, format) {
   console.log(`GSC property set to "${propertyUrl}" for project "${project}".`);
 }
 async function googleSync(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const run = await client.gscSync(project, { days: opts.days, full: opts.full });
   if (!opts.wait && isMachineFormat(opts.format)) {
     console.log(JSON.stringify(run, null, 2));
@@ -5922,7 +6171,7 @@ async function googleSync(project, opts) {
   }
 }
 async function googlePerformanceDaily(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const params = {};
   if (opts.window) params.window = opts.window;
   if (opts.startDate) params.startDate = opts.startDate;
@@ -5955,7 +6204,7 @@ async function googlePerformanceDaily(project, opts) {
   }
 }
 async function googlePerformance(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const params = {};
   if (opts.days) {
     const end = /* @__PURE__ */ new Date();
@@ -5994,7 +6243,7 @@ async function googlePerformance(project, opts) {
   }
 }
 async function googleInspect(project, url, format) {
-  const client = getClient10();
+  const client = getClient11();
   const result = await client.gscInspect(project, url);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -6014,7 +6263,7 @@ URL Inspection: ${result.url}
   console.log(`  Inspected At:      ${result.inspectedAt}`);
 }
 async function googleInspections(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const params = {};
   if (opts.url) params.url = opts.url;
   const rows = await client.gscInspections(project, Object.keys(params).length > 0 ? params : void 0);
@@ -6042,7 +6291,7 @@ async function googleInspections(project, opts) {
   }
 }
 async function googleCoverage(project, format) {
-  const client = getClient10();
+  const client = getClient11();
   const result = await client.gscCoverage(project);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -6088,7 +6337,7 @@ Index Coverage for "${project}"
   }
 }
 async function googleSetSitemap(project, sitemapUrl, format) {
-  const client = getClient10();
+  const client = getClient11();
   await client.googleSetSitemap(project, "gsc", sitemapUrl);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, type: "gsc", sitemapUrl }, null, 2));
@@ -6097,7 +6346,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 = getClient10();
+  const client = getClient11();
   const result = await client.gscSitemaps(project);
   if (opts.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -6122,7 +6371,7 @@ Sitemaps for project "${project}":
   }
 }
 async function googleInspectSitemap(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const run = await client.gscInspectSitemap(project, {
     sitemapUrl: opts.sitemapUrl
   });
@@ -6158,7 +6407,7 @@ async function googleInspectSitemap(project, opts) {
   }
 }
 async function googleCoverageHistory(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const rows = await client.gscCoverageHistory(project, { limit: opts.limit });
   if (opts.format === "json") {
     console.log(JSON.stringify(rows, null, 2));
@@ -6183,7 +6432,7 @@ GSC Coverage History for "${project}" (${rows.length} snapshots):
   }
 }
 async function googleDiscoverSitemaps(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const result = await client.gscDiscoverSitemaps(project);
   if (!opts.wait && isMachineFormat(opts.format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -6235,7 +6484,7 @@ Primary sitemap: ${result.primarySitemapUrl}`);
   }
 }
 async function googleRequestIndexing(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const body = { urls: [] };
   if (opts.allUnindexed) {
     body.allUnindexed = true;
@@ -6330,7 +6579,7 @@ async function googleRequestIndexing(project, opts) {
   }
 }
 async function googleRefresh(project, format) {
-  const client = getClient10();
+  const client = getClient11();
   const run = await client.gscSync(project, {});
   if (!isMachineFormat(format)) {
     process.stderr.write("Refreshing GSC coverage data");
@@ -6353,7 +6602,7 @@ async function googleRefresh(project, format) {
   await googleCoverage(project, format);
 }
 async function googleDeindexed(project, format) {
-  const client = getClient10();
+  const client = getClient11();
   const rows = await client.gscDeindexed(project);
   if (format === "json") {
     console.log(JSON.stringify(rows, null, 2));
@@ -6662,14 +6911,14 @@ var GOOGLE_CLI_COMMANDS = [
 ];
 
 // src/commands/keys.ts
-function getClient11() {
+function getClient12() {
   return createApiClient();
 }
 function keyStatus(key) {
   return key.revokedAt ? "revoked" : "active";
 }
 async function listApiKeys(format) {
-  const client = getClient11();
+  const client = getClient12();
   const { keys } = await client.listApiKeys();
   if (format === "json") {
     console.log(JSON.stringify({ keys }, null, 2));
@@ -6702,7 +6951,7 @@ async function createApiKey(opts) {
       displayMessage: 'Error: --read-only cannot be combined with --scope (it already implies the "read" scope).'
     });
   }
-  const client = getClient11();
+  const client = getClient12();
   const body = { name: opts.name };
   const scopes = opts.readOnly ? [READ_ONLY_SCOPE] : explicitScopes;
   if (scopes) body.scopes = scopes;
@@ -6725,7 +6974,7 @@ async function createApiKey(opts) {
   console.log("\nSave this now \u2014 it will not be shown again.");
 }
 async function showApiKeySelf(format) {
-  const client = getClient11();
+  const client = getClient12();
   const key = await client.getApiKeySelf();
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(key, null, 2));
@@ -6737,7 +6986,7 @@ async function showApiKeySelf(format) {
   console.log(`  Status:    ${keyStatus(key)}`);
 }
 async function revokeApiKey(id, format) {
-  const client = getClient11();
+  const client = getClient12();
   const key = await client.revokeApiKey(id);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(key, null, 2));
@@ -6815,11 +7064,11 @@ var KEYS_CLI_COMMANDS = [
 
 // src/commands/keyword.ts
 import fs4 from "fs";
-function getClient12() {
+function getClient13() {
   return createApiClient();
 }
 async function addKeywords(project, keywords, format) {
-  const client = getClient12();
+  const client = getClient13();
   await client.appendKeywords(project, keywords);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({
@@ -6832,7 +7081,7 @@ async function addKeywords(project, keywords, format) {
   console.log(`Added ${keywords.length} key phrase(s) to "${project}".`);
 }
 async function replaceKeywords(project, keywords, format) {
-  const client = getClient12();
+  const client = getClient13();
   await client.putKeywords(project, keywords);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({
@@ -6845,7 +7094,7 @@ async function replaceKeywords(project, keywords, format) {
   console.log(`Set ${keywords.length} key phrase(s) for "${project}".`);
 }
 async function removeKeywords(project, keywords, format) {
-  const client = getClient12();
+  const client = getClient13();
   const existing = await client.listKeywords(project);
   const existingSet = new Set(existing.map((k) => k.keyword));
   const removedKeywords = keywords.filter((k) => existingSet.has(k));
@@ -6862,7 +7111,7 @@ async function removeKeywords(project, keywords, format) {
   console.log(`Removed ${removedKeywords.length} key phrase(s) from "${project}".`);
 }
 async function listKeywords(project, format) {
-  const client = getClient12();
+  const client = getClient13();
   const kws = await client.listKeywords(project);
   if (format === "json") {
     console.log(JSON.stringify(kws, null, 2));
@@ -6908,7 +7157,7 @@ async function importKeywords(project, filePath, format) {
     console.log("No key phrases found in file.");
     return;
   }
-  const client = getClient12();
+  const client = getClient13();
   await client.appendKeywords(project, keywords);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({
@@ -6922,7 +7171,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 = getClient12();
+  const client = getClient13();
   const result = await client.generateKeywords(project, provider, opts.count);
   const saved = Boolean(opts.save && result.keywords.length > 0);
   if (!isMachineFormat(opts.format)) {
@@ -7095,11 +7344,11 @@ var KEYWORD_CLI_COMMANDS = [
 
 // src/commands/query.ts
 import fs5 from "fs";
-function getClient13() {
+function getClient14() {
   return createApiClient();
 }
 async function addQueries(project, queries2, format) {
-  const client = getClient13();
+  const client = getClient14();
   await client.appendQueries(project, queries2);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({
@@ -7112,7 +7361,7 @@ async function addQueries(project, queries2, format) {
   console.log(`Added ${queries2.length} ${queries2.length === 1 ? "query" : "queries"} to "${project}".`);
 }
 async function replaceQueries(project, queries2, opts) {
-  const client = getClient13();
+  const client = getClient14();
   const isJson = isMachineFormat(opts?.format);
   if (opts?.dryRun) {
     const preview = await client.previewReplaceQueries(project, queries2);
@@ -7148,7 +7397,7 @@ async function replaceQueries(project, queries2, opts) {
   console.log(`Set ${queries2.length} ${queries2.length === 1 ? "query" : "queries"} for "${project}".`);
 }
 async function removeQueries(project, queries2, format) {
-  const client = getClient13();
+  const client = getClient14();
   const existing = await client.listQueries(project);
   const existingSet = new Set(existing.map((q) => q.query));
   const removedQueries = queries2.filter((q) => existingSet.has(q));
@@ -7165,7 +7414,7 @@ async function removeQueries(project, queries2, format) {
   console.log(`Removed ${removedQueries.length} ${removedQueries.length === 1 ? "query" : "queries"} from "${project}".`);
 }
 async function listQueries(project, format) {
-  const client = getClient13();
+  const client = getClient14();
   const qs = await client.listQueries(project);
   if (format === "json") {
     console.log(JSON.stringify(qs, null, 2));
@@ -7211,7 +7460,7 @@ async function importQueries(project, filePath, format) {
     console.log("No queries found in file.");
     return;
   }
-  const client = getClient13();
+  const client = getClient14();
   await client.appendQueries(project, queries2);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({
@@ -7225,7 +7474,7 @@ async function importQueries(project, filePath, format) {
   console.log(`Imported ${queries2.length} ${queries2.length === 1 ? "query" : "queries"} to "${project}".`);
 }
 async function generateQueries(project, provider, opts) {
-  const client = getClient13();
+  const client = getClient14();
   const result = await client.generateQueries(project, provider, opts.count);
   const saved = Boolean(opts.save && result.queries.length > 0);
   if (!isMachineFormat(opts.format)) {
@@ -7720,11 +7969,11 @@ var MCP_CLI_COMMANDS = [
 ];
 
 // src/commands/notify.ts
-function getClient14() {
+function getClient15() {
   return createApiClient();
 }
 async function addNotification(project, opts) {
-  const client = getClient14();
+  const client = getClient15();
   const result = await client.createNotification(project, {
     channel: "webhook",
     url: opts.webhook,
@@ -7738,7 +7987,7 @@ async function addNotification(project, opts) {
   printNotification(result);
 }
 async function listNotifications(project, format) {
-  const client = getClient14();
+  const client = getClient15();
   const results = await client.listNotifications(project);
   if (format === "json") {
     console.log(JSON.stringify(results, null, 2));
@@ -7759,7 +8008,7 @@ async function listNotifications(project, format) {
   }
 }
 async function removeNotification(project, id, format) {
-  const client = getClient14();
+  const client = getClient15();
   await client.deleteNotification(project, id);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, id, removed: true }, null, 2));
@@ -7768,7 +8017,7 @@ async function removeNotification(project, id, format) {
   console.log(`Notification ${id} removed from "${project}"`);
 }
 async function testNotification(project, id, format) {
-  const client = getClient14();
+  const client = getClient15();
   const result = await client.testNotification(project, id);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, id, ...result }, null, 2));
@@ -7963,11 +8212,11 @@ async function applyConfigs(filePaths, format) {
 }
 
 // src/commands/analytics.ts
-function getClient15() {
+function getClient16() {
   return createApiClient();
 }
 async function showAnalytics(project, options) {
-  const client = getClient15();
+  const client = getClient16();
   const features = options.feature ? [options.feature] : ["metrics", "gaps", "sources"];
   const results = {};
   for (const feature of features) {
@@ -8170,7 +8419,7 @@ Source Origin Breakdown`);
 }
 
 // src/commands/sources.ts
-function getClient16() {
+function getClient17() {
   return createApiClient();
 }
 var pct = (n) => `${(n * 100).toFixed(1)}%`;
@@ -8181,7 +8430,7 @@ async function showSources(project, options) {
       details: { command: "sources", option: "limit", value: options.limit }
     });
   }
-  const client = getClient16();
+  const client = getClient17();
   const data = await client.getAnalyticsSources(project, { window: options.window, limit: options.limit });
   if (options.format === "jsonl") {
     emitJsonl(data.ranked.entries.map((e) => ({ project, ...e })));
@@ -8232,11 +8481,11 @@ function printRankedEntries(list, indent = "") {
 }
 
 // src/commands/evidence.ts
-function getClient17() {
+function getClient18() {
   return createApiClient();
 }
 async function showEvidence(project, format) {
-  const client = getClient17();
+  const client = getClient18();
   const timeline = await client.getTimeline(project);
   if (format === "json") {
     const enriched = timeline.map((entry) => ({
@@ -8319,7 +8568,7 @@ async function exportResults(project, opts) {
 }
 
 // src/commands/history.ts
-function getClient18() {
+function getClient19() {
   return createApiClient();
 }
 function originLabel(entry) {
@@ -8330,7 +8579,7 @@ function originLabel(entry) {
   return entry.actor;
 }
 async function showHistory(project, format, opts = {}) {
-  const client = getClient18();
+  const client = getClient19();
   try {
     const entries = project ? await client.getHistory(project, opts) : await client.getGlobalHistory(opts);
     if (format === "json") {
@@ -8371,11 +8620,11 @@ async function showHistory(project, format, opts = {}) {
 }
 
 // src/commands/status.ts
-function getClient19() {
+function getClient20() {
   return createApiClient();
 }
 async function showStatus(project, format) {
-  const client = getClient19();
+  const client = getClient20();
   const projectData = await client.getProject(project);
   const latest = await getLatestRunSummary(client, project);
   if (isMachineFormat(format)) {
@@ -8574,11 +8823,11 @@ var OPERATOR_CLI_COMMANDS = [
 ];
 
 // src/commands/project.ts
-function getClient20() {
+function getClient21() {
   return createApiClient();
 }
 async function createProject(name, opts) {
-  const client = getClient20();
+  const client = getClient21();
   const result = await client.putProject(name, {
     displayName: opts.displayName,
     canonicalDomain: opts.domain,
@@ -8596,7 +8845,7 @@ async function createProject(name, opts) {
   console.log(`Project created: ${result.name} (${result.id})`);
 }
 async function listProjects(format) {
-  const client = getClient20();
+  const client = getClient21();
   const projects2 = await client.listProjects();
   if (format === "json") {
     console.log(JSON.stringify(projects2, null, 2));
@@ -8628,7 +8877,7 @@ async function listProjects(format) {
   }
 }
 async function showProject(name, format) {
-  const client = getClient20();
+  const client = getClient21();
   const project = await client.getProject(name);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(project, null, 2));
@@ -8660,7 +8909,7 @@ async function showProject(name, format) {
   if (project.updatedAt) console.log(`  Updated:          ${project.updatedAt}`);
 }
 async function updateProjectSettings(name, opts) {
-  const client = getClient20();
+  const client = getClient21();
   const project = await client.getProject(name);
   let ownedDomains = opts.ownedDomains ?? project.ownedDomains ?? [];
   if (opts.addOwnedDomain) {
@@ -8723,7 +8972,7 @@ async function updateProjectSettings(name, opts) {
   }
 }
 async function deleteProject(name, opts) {
-  const client = getClient20();
+  const client = getClient21();
   const isJson = isMachineFormat(opts?.format);
   if (opts?.dryRun) {
     const preview = await client.previewProjectDelete(name);
@@ -8753,7 +9002,7 @@ async function deleteProject(name, opts) {
   console.log(`Project deleted: ${name}`);
 }
 async function addLocation(project, opts) {
-  const client = getClient20();
+  const client = getClient21();
   const location = await client.addLocation(project, {
     label: opts.label,
     city: opts.city,
@@ -8768,7 +9017,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 = getClient20();
+  const client = getClient21();
   const result = await client.listLocations(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -8802,7 +9051,7 @@ async function listLocations(project, format) {
   }
 }
 async function removeLocation(project, label, format) {
-  const client = getClient20();
+  const client = getClient21();
   await client.removeLocation(project, label);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, label, removed: true }, null, 2));
@@ -8811,7 +9060,7 @@ async function removeLocation(project, label, format) {
   console.log(`Location removed: ${label}`);
 }
 async function setDefaultLocation(project, label, format) {
-  const client = getClient20();
+  const client = getClient21();
   const result = await client.setDefaultLocation(project, label);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, ...result }, null, 2));
@@ -9095,12 +9344,12 @@ var REPORT_CLI_COMMANDS = [
 ];
 
 // src/commands/run.ts
-function getClient21() {
+function getClient22() {
   return createApiClient();
 }
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
 async function triggerRun(project, opts) {
-  const client = getClient21();
+  const client = getClient22();
   const body = {};
   if (opts?.provider) {
     const providerInputs = opts.provider.split(",").map((s) => s.trim()).filter(Boolean);
@@ -9202,7 +9451,7 @@ async function triggerRun(project, opts) {
   }
 }
 async function triggerRunAll(opts) {
-  const client = getClient21();
+  const client = getClient22();
   const projects2 = await client.listProjects();
   if (projects2.length === 0) {
     if (isMachineFormat(opts?.format)) {
@@ -9285,7 +9534,7 @@ async function triggerRunAll(opts) {
   }
 }
 async function cancelRun(project, runId, format) {
-  const client = getClient21();
+  const client = getClient22();
   let targetId = runId;
   if (!targetId) {
     const runs = await client.listRuns(project);
@@ -9317,7 +9566,7 @@ To cancel by ID  : canonry run cancel ${project} <run-id>`,
   console.log(`Run ${result.id} cancelled.`);
 }
 async function showRun(id, format) {
-  const client = getClient21();
+  const client = getClient22();
   const run = await client.getRun(id);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(run, null, 2));
@@ -9326,7 +9575,7 @@ async function showRun(id, format) {
   printRunDetail(run);
 }
 async function listRuns(project, opts) {
-  const client = getClient21();
+  const client = getClient22();
   const runs = await client.listRuns(project, opts?.limit, opts?.kind);
   if (opts?.format === "json") {
     console.log(JSON.stringify(runs, null, 2));
@@ -9349,13 +9598,13 @@ async function listRuns(project, opts) {
     );
   }
 }
-var POLL_TIMEOUT_MS2 = 10 * 60 * 1e3;
+var POLL_TIMEOUT_MS3 = 10 * 60 * 1e3;
 async function pollRun2(client, runId) {
-  const deadline = Date.now() + POLL_TIMEOUT_MS2;
+  const deadline = Date.now() + POLL_TIMEOUT_MS3;
   for (; ; ) {
     await new Promise((r) => setTimeout(r, 2e3));
     if (Date.now() > deadline) {
-      throw new Error(`Timed out waiting for run ${runId} after ${POLL_TIMEOUT_MS2 / 1e3}s`);
+      throw new Error(`Timed out waiting for run ${runId} after ${POLL_TIMEOUT_MS3 / 1e3}s`);
     }
     const run = await client.getRun(runId);
     process.stderr.write(".");
@@ -9501,11 +9750,11 @@ var RUN_CLI_COMMANDS = [
 ];
 
 // src/commands/schedule.ts
-function getClient22() {
+function getClient23() {
   return createApiClient();
 }
 async function setSchedule(project, opts) {
-  const client = getClient22();
+  const client = getClient23();
   const body = {};
   if (opts.kind) body.kind = opts.kind;
   if (opts.sourceId) body.sourceId = opts.sourceId;
@@ -9522,7 +9771,7 @@ async function setSchedule(project, opts) {
   printSchedule(result);
 }
 async function showSchedule(project, format, kind) {
-  const client = getClient22();
+  const client = getClient23();
   const result = await client.getSchedule(project, kind);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -9531,7 +9780,7 @@ async function showSchedule(project, format, kind) {
   printSchedule(result);
 }
 async function enableSchedule(project, format, kind) {
-  const client = getClient22();
+  const client = getClient23();
   const current = await client.getSchedule(project, kind);
   const body = { kind: current.kind, timezone: current.timezone, enabled: true };
   if (current.preset) body.preset = current.preset;
@@ -9546,7 +9795,7 @@ async function enableSchedule(project, format, kind) {
   console.log(`Schedule enabled for "${project}" (kind: ${result.kind})`);
 }
 async function disableSchedule(project, format, kind) {
-  const client = getClient22();
+  const client = getClient23();
   const current = await client.getSchedule(project, kind);
   const body = { kind: current.kind, timezone: current.timezone, enabled: false };
   if (current.preset) body.preset = current.preset;
@@ -9561,7 +9810,7 @@ async function disableSchedule(project, format, kind) {
   console.log(`Schedule disabled for "${project}" (kind: ${result.kind})`);
 }
 async function removeSchedule(project, format, kind) {
-  const client = getClient22();
+  const client = getClient23();
   await client.deleteSchedule(project, kind);
   const resolvedKind = kind ?? "answer-visibility";
   if (isMachineFormat(format)) {
@@ -9679,11 +9928,11 @@ var SCHEDULE_CLI_COMMANDS = [
 ];
 
 // src/commands/settings.ts
-function getClient23() {
+function getClient24() {
   return createApiClient();
 }
 async function setProvider(name, opts) {
-  const client = getClient23();
+  const client = getClient24();
   const { format, ...payload } = opts;
   const result = await client.updateProvider(name, payload);
   if (isMachineFormat(format)) {
@@ -9699,7 +9948,7 @@ async function setProvider(name, opts) {
   }
 }
 async function showSettings(format) {
-  const client = getClient23();
+  const client = getClient24();
   const config = loadConfig();
   const settings = await client.getSettings();
   if (isMachineFormat(format)) {
@@ -10249,7 +10498,7 @@ function wrapText(font, text, size, maxWidth) {
 }
 
 // src/commands/snapshot.ts
-function getClient24() {
+function getClient25() {
   return createApiClient();
 }
 function slugify(value) {
@@ -10260,7 +10509,7 @@ function autoOutputPath(companyName, ext) {
   return `${slugify(companyName)}-snapshot-${date}.${ext}`;
 }
 async function createSnapshotReport(companyName, opts) {
-  const client = getClient24();
+  const client = getClient25();
   const report = await client.createSnapshot({
     companyName,
     domain: opts.domain,
@@ -12599,11 +12848,11 @@ var SYSTEM_CLI_COMMANDS = [
 ];
 
 // src/commands/technical-aeo.ts
-function getClient25() {
+function getClient26() {
   return createApiClient();
 }
 async function technicalAeoScore(project, opts) {
-  const client = getClient25();
+  const client = getClient26();
   const score = await client.getTechnicalAeoScore(project, { runId: opts.runId });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(score, null, 2));
@@ -12639,7 +12888,7 @@ async function technicalAeoScore(project, opts) {
   console.log(lines.join("\n"));
 }
 async function technicalAeoPages(project, opts) {
-  const client = getClient25();
+  const client = getClient26();
   const status = opts.status === "success" || opts.status === "error" ? opts.status : void 0;
   const res = await client.getTechnicalAeoPages(project, { runId: opts.runId, status, sort: opts.sort, limit: opts.limit });
   if (opts.format === "jsonl") {
@@ -12665,7 +12914,7 @@ async function technicalAeoPages(project, opts) {
   console.log(lines.join("\n"));
 }
 async function technicalAeoTrend(project, opts) {
-  const client = getClient25();
+  const client = getClient26();
   const res = await client.getTechnicalAeoTrend(project, { limit: opts.limit });
   if (opts.format === "jsonl") {
     emitJsonl(res.points.map((p) => ({ project, ...p })));
@@ -12687,7 +12936,7 @@ async function technicalAeoTrend(project, opts) {
   console.log(lines.join("\n"));
 }
 async function technicalAeoRun(project, opts) {
-  const client = getClient25();
+  const client = getClient26();
   const { runId, status } = await client.triggerSiteAudit(project, {
     sitemapUrl: opts.sitemapUrl,
     limit: opts.limit
@@ -13046,7 +13295,7 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
 import fs15 from "fs";
 
 // src/commands/wordpress.ts
-function getClient26() {
+function getClient27() {
   return createApiClient();
 }
 async function loadYamlModule() {
@@ -13196,7 +13445,7 @@ async function wordpressConnect(project, opts) {
       details: { project }
     });
   }
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressConnect(project, {
     url: opts.url,
     stagingUrl: opts.stagingUrl,
@@ -13213,7 +13462,7 @@ async function wordpressConnect(project, opts) {
   printWordpressStatus(project, result);
 }
 async function wordpressDisconnect(project, format) {
-  const client = getClient26();
+  const client = getClient27();
   await client.wordpressDisconnect(project);
   if (isMachineFormat(format)) {
     printJson2({ project, disconnected: true });
@@ -13222,7 +13471,7 @@ async function wordpressDisconnect(project, format) {
   console.log(`WordPress disconnected from project "${project}".`);
 }
 async function wordpressStatus(project, format) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressStatus(project);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -13231,7 +13480,7 @@ async function wordpressStatus(project, format) {
   printWordpressStatus(project, result);
 }
 async function wordpressPages(project, opts) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressPages(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -13240,7 +13489,7 @@ async function wordpressPages(project, opts) {
   printPages(project, result.env, result.pages);
 }
 async function wordpressPage(project, slug, opts) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressPage(project, slug, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -13249,7 +13498,7 @@ async function wordpressPage(project, slug, opts) {
   printPageDetail(result);
 }
 async function wordpressCreatePage(project, body) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressCreatePage(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -13260,7 +13509,7 @@ async function wordpressCreatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressUpdatePage(project, body) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressUpdatePage(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -13271,7 +13520,7 @@ async function wordpressUpdatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressSetMeta(project, body) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressSetMeta(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -13321,7 +13570,7 @@ async function wordpressBulkSetMeta(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressBulkSetMeta(project, { entries, env: opts.env });
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -13364,7 +13613,7 @@ async function wordpressBulkSetMeta(project, opts) {
 Total: ${applied.length} applied, ${skipped.length} skipped, ${manual.length} manual`);
 }
 async function wordpressSchema(project, slug, opts) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressSchema(project, slug, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -13375,7 +13624,7 @@ async function wordpressSchema(project, slug, opts) {
   printSchemaBlocks(result.blocks);
 }
 async function wordpressSetSchema(project, body) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressSetSchema(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -13423,7 +13672,7 @@ async function wordpressSchemaDeploy(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressSchemaDeploy(project, { profile: parsed, env: opts.env });
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -13462,7 +13711,7 @@ async function wordpressSchemaDeploy(project, opts) {
 Total: ${deployed} deployed, ${stripped} stripped, ${skipped} skipped, ${failed} failed`);
 }
 async function wordpressSchemaStatus(project, opts) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressSchemaStatus(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -13521,7 +13770,7 @@ async function wordpressOnboard(project, opts) {
       });
     }
   }
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressOnboard(project, {
     url: opts.url,
     username: opts.user,
@@ -13546,7 +13795,7 @@ async function wordpressOnboard(project, opts) {
   }
 }
 async function wordpressLlmsTxt(project, opts) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressLlmsTxt(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -13557,7 +13806,7 @@ async function wordpressLlmsTxt(project, opts) {
   console.log(result.content ?? "(not found)");
 }
 async function wordpressSetLlmsTxt(project, body) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressSetLlmsTxt(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -13566,7 +13815,7 @@ async function wordpressSetLlmsTxt(project, body) {
   printManualAssist(`llms.txt update for "${project}"`, result);
 }
 async function wordpressAudit(project, opts) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressAudit(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -13580,7 +13829,7 @@ async function wordpressAudit(project, opts) {
   printAuditIssues(result.issues);
 }
 async function wordpressDiff(project, slug, format) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressDiff(project, slug);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -13589,7 +13838,7 @@ async function wordpressDiff(project, slug, format) {
   printDiff(result);
 }
 async function wordpressStagingStatus(project, format) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressStagingStatus(project);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -13603,7 +13852,7 @@ async function wordpressStagingStatus(project, format) {
   console.log(`  Admin URL:         ${result.adminUrl}`);
 }
 async function wordpressStagingPush(project, format) {
-  const client = getClient26();
+  const client = getClient27();
   const result = await client.wordpressStagingPush(project);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -14646,6 +14895,7 @@ var REGISTERED_CLI_COMMANDS = [
   ...CONTENT_CLI_COMMANDS,
   ...AGENT_CLI_COMMANDS,
   ...DISCOVER_CLI_COMMANDS,
+  ...RESEARCH_CLI_COMMANDS,
   ...TECHNICAL_AEO_CLI_COMMANDS,
   ...DOCTOR_CLI_COMMANDS,
   ...GET_CLI_COMMANDS,