@canonry/canonry 7.12.0 → 7.14.0

package/dist/cli.js

@@ -33,11 +33,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-DXI2FTSW.js";
+} from "./chunk-KXHPQMBP.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-EPSHIH63.js";
+} from "./chunk-LUQ5G5OO.js";
 import {
   configExists,
   createApiClient,
@@ -54,13 +54,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-SM6ZZAPK.js";
+} from "./chunk-ZHXOR2LJ.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-7I64KEGM.js";
+import "./chunk-WHVEDCHY.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -72,7 +72,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-BTHEFJCI.js";
+} from "./chunk-4LQ4HKVK.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -104,7 +104,7 @@ import {
   rawEventSamples,
   readMarketCompetitorNames,
   runs
-} from "./chunk-GQMSJEMZ.js";
+} from "./chunk-EZRBFH77.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -234,7 +234,7 @@ import {
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-AU7OUDWR.js";
+} from "./chunk-A25FO3Z5.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -784,7 +784,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-WJUA4EIG.js");
+  const { createDemoServer } = await import("./demo-server-SIATTXXS.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -1198,7 +1198,7 @@ No DB writes performed. Re-run without --dry-run to apply.`);
   }
 }
 async function backfillInsightsCommand(project2, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-DJRH4Z3D.js");
+  const { IntelligenceService } = await import("./intelligence-service-UEEVETII.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -13444,1432 +13444,1485 @@ async function clearResults(project2, opts) {
   }
 }
 
-// src/commands/status.ts
+// src/commands/run.ts
 function getClient21() {
   return createApiClient();
 }
-async function showStatus(project2, format) {
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
+function shellArg(value) {
+  return /^[\w.-]+$/.test(value) ? value : `'${value.replaceAll("'", `'\\''`)}'`;
+}
+function providerAccountStreakLine(provider, streak) {
+  return `${provider} (${streak.code}): failed on its account in each of its last ${streak.consecutiveRuns} runs; called again after ${streak.retryAfter}`;
+}
+function providersThatKeepFailing(count) {
+  return count === 1 ? "a provider that keeps failing on its account" : `${count} providers that keep failing on their accounts`;
+}
+function providerAccountFixLine(project2) {
+  return `Fix the key, access or billing in the provider's console. Saving a new key, model or endpoint (canonry settings provider <name>) retries at once; canonry run ${shellArg(project2)} --force calls every provider now.`;
+}
+function admissionDecisionKey(admission) {
+  return JSON.stringify([
+    admission.refused,
+    admission.retryAfter,
+    Object.entries(admission.providers).sort(([left], [right]) => left.localeCompare(right)).map(([provider, streak]) => [provider, streak.code, streak.consecutiveRuns, streak.since, streak.latestRunId, streak.retryAfter])
+  ]);
+}
+function admissionScopeLines(admission, label, showAllowed) {
+  const held = Object.entries(admission.providers);
+  if (held.length === 0) return showAllowed ? [`${label}: no providers held back.`] : [];
+  const retry = label === "Manual sweep" ? `it can retry after ${admission.retryAfter}` : `scheduled sweeps skip their slots until ${admission.retryAfter}`;
+  return [
+    admission.refused ? `${label}: refused (PROVIDERS_FAILING). Every provider it would call keeps failing on its account; ${retry}.` : `${label}: skips ${providersThatKeepFailing(held.length)}; the rest run.`,
+    ...held.map(([provider, streak]) => `  ${providerAccountStreakLine(provider, streak)}`)
+  ];
+}
+function runAdmissionLines(project2, admission, manualAdmission) {
+  if (!admission) return [];
+  const differs = manualAdmission !== void 0 && admissionDecisionKey(admission) !== admissionDecisionKey(manualAdmission);
+  const lines = differs ? [...admissionScopeLines(admission, "Scheduled sweep", true), ...admissionScopeLines(manualAdmission, "Manual sweep", true)] : admissionScopeLines(admission, "Next sweep", false);
+  return lines.length > 0 ? [...lines, providerAccountFixLine(project2)] : [];
+}
+function printSkippedProviders(project2, skipped) {
+  const held = Object.entries(skipped ?? {});
+  if (held.length === 0) return;
+  console.log(`
+Not calling ${providersThatKeepFailing(held.length)}:`);
+  for (const [provider, streak] of held) console.log(`  ${providerAccountStreakLine(provider, streak)}`);
+  console.log(providerAccountFixLine(project2));
+}
+function throwIfWaitedRunFailed(waited) {
+  const failed = waited.filter((r) => r.status === RunStatuses.failed);
+  if (failed.length === 0) return;
+  const reason = (r) => r.error ? formatRunErrorOneLine(r.error) : null;
+  const label = (r) => [r.project, r.location ? `(${r.location})` : null, `run ${r.runId}`].filter(Boolean).join(" ");
+  const message = waited.length === 1 ? `Run ${failed[0].runId} failed${reason(failed[0]) ? `: ${reason(failed[0])}` : ""}` : `${failed.length} of ${waited.length} runs failed: ${failed.map((r) => `${label(r)}${reason(r) ? `: ${reason(r)}` : ""}`).join("; ")}`;
+  throw new CliError({
+    code: "RUN_FAILED",
+    message,
+    exitCode: EXIT_SYSTEM_ERROR,
+    details: {
+      waitedRunCount: waited.length,
+      failedRuns: failed.map((r) => ({
+        runId: r.runId,
+        ...r.project ? { project: r.project } : {},
+        ...r.location ? { location: r.location } : {},
+        error: reason(r)
+      }))
+    }
+  });
+}
+async function triggerRun(project2, opts) {
   const client = getClient21();
-  const projectData = await client.getProject(project2);
-  const latest = await getLatestRunSummary(client, project2);
-  if (isMachineFormat(format)) {
-    let runs2 = [];
-    try {
-      runs2 = await client.listRuns(project2);
-    } catch {
+  const body = {};
+  if (opts?.provider) {
+    const providerInputs = opts.provider.split(",").map((s) => s.trim()).filter(Boolean);
+    const resolved = providerInputs.flatMap((p) => resolveProviderInput(p));
+    body.providers = resolved.length > 0 ? resolved : providerInputs;
+  }
+  if (opts?.queries?.length) {
+    body.queries = opts.queries;
+  }
+  if (opts?.groups?.length || opts?.targets?.length) {
+    body.measurementScope = {
+      ...opts.groups?.length ? { groups: opts.groups } : {},
+      ...opts.targets?.length ? { targets: opts.targets } : {}
+    };
+  }
+  if (opts?.location) {
+    body.location = opts.location;
+  }
+  if (opts?.allLocations) {
+    body.allLocations = true;
+  }
+  if (opts?.noLocation) {
+    body.noLocation = true;
+  }
+  if (opts?.probe) {
+    body.trigger = "probe";
+  }
+  if (opts?.dispatchMode) {
+    body.dispatchMode = opts.dispatchMode;
+  }
+  if (opts?.force) {
+    body.force = true;
+  }
+  const response = await client.triggerRun(project2, body);
+  if (Array.isArray(response)) {
+    const locationRuns = response;
+    if (isMachineFormat(opts?.format)) {
+      if (opts?.wait) {
+        const finals = await Promise.all(
+          locationRuns.map(async (r) => !r.id || r.status === "conflict" ? null : pollRun2(client, r.id, false))
+        );
+        console.log(JSON.stringify(locationRuns.map((r, i) => finals[i] ? { ...r, ...finals[i] } : r), null, 2));
+        throwIfWaitedRunFailed(locationRuns.flatMap((r, i) => {
+          const final = finals[i];
+          return final ? [{ runId: final.id, status: final.status, project: project2, location: r.location ?? null, error: final.error }] : [];
+        }));
+      } else {
+        console.log(JSON.stringify(locationRuns, null, 2));
+      }
+      return;
+    }
+    console.log(`Triggered ${locationRuns.length} location sweep(s) \u2014 ${locationRuns.length}\xD7 API calls:
+`);
+    console.log("  LOCATION         RUN ID                                STATUS");
+    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");
+    for (const r of locationRuns) {
+      const loc = (r.location ?? "(unknown)").padEnd(15);
+      const id = (r.id ?? "(conflict)").padEnd(36);
+      console.log(`  ${loc}  ${id}  ${r.status}`);
+    }
+    printSkippedProviders(project2, locationRuns.find((r) => r.skippedProviders)?.skippedProviders);
+    if (opts?.wait) {
+      const pending = locationRuns.filter((r) => r.id && r.status !== "conflict" && !TERMINAL_STATUSES.has(r.status));
+      const errors = /* @__PURE__ */ new Map();
+      if (pending.length > 0) {
+        process.stderr.write(`Waiting for ${pending.length} run(s)`);
+        const batchWaits = /* @__PURE__ */ new Map();
+        await Promise.all(
+          pending.map(async (r) => {
+            const final = await pollRun2(client, r.id);
+            r.status = final.status;
+            errors.set(r.id, final.error);
+            const waiting = batchWaitLine(final);
+            if (waiting) batchWaits.set(r.id, waiting);
+          })
+        );
+        process.stderr.write("\n");
+        console.log("\nFinal statuses:");
+        for (const r of locationRuns) {
+          const loc = (r.location ?? "(unknown)").padEnd(15);
+          console.log(`  ${loc}  ${r.status}`);
+        }
+        if (batchWaits.size > 0) console.log("");
+        for (const r of locationRuns) {
+          const waiting = batchWaits.get(r.id);
+          if (waiting) console.log(`  ${r.location ?? "(unknown)"}: ${waiting}`);
+        }
+      }
+      throwIfWaitedRunFailed(locationRuns.filter((r) => r.id && r.status !== "conflict").map((r) => ({ runId: r.id, status: r.status, project: project2, location: r.location ?? null, error: errors.get(r.id) })));
     }
-    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})
-`);
-  console.log(`  Domain:   ${projectData.canonicalDomain}`);
-  console.log(`  Country:  ${projectData.country}`);
-  console.log(`  Language: ${projectData.language}`);
-  if (latest.run) {
-    console.log(`
-  Latest run:`);
-    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}`);
+  const run = response;
+  if (opts?.wait && run.id && !TERMINAL_STATUSES.has(run.status)) {
+    const showProgress = !isMachineFormat(opts?.format);
+    if (showProgress) process.stderr.write(`Run ${run.id} started`);
+    const result = await pollRun2(client, run.id, showProgress);
+    if (isMachineFormat(opts?.format)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      process.stderr.write("\n");
+      printRunDetail(result);
+      const waiting = batchWaitLine(result);
+      if (waiting) console.log(`
+${waiting}`);
     }
-    console.log(`
-  Total runs: ${latest.totalRuns}`);
-  } else {
-    const projectArg = /^[\w.-]+$/.test(project2) ? project2 : `'${project2.replaceAll("'", `'\\''`)}'`;
-    console.log(`
-  No runs yet. Capture Page Health with "canonry technical-aeo run ${projectArg}", or run an AI Visibility sweep after adding a provider.`);
+    throwIfWaitedRunFailed([{ runId: result.id, status: result.status, project: project2, error: result.error }]);
+    return;
   }
-}
-async function getLatestRunSummary(client, project2) {
-  try {
-    return await client.getLatestRun(project2);
-  } catch (err) {
-    if (!isEndpointMissing(err)) throw err;
-    const runs2 = await client.listRuns(project2);
-    if (runs2.length === 0) {
-      return { totalRuns: 0, run: null };
+  if (opts?.wait && (TERMINAL_STATUSES.has(run.status) || !run.id)) {
+    const result = run.id ? await client.getRun(run.id) : run;
+    if (isMachineFormat(opts?.format)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      printRunDetail(result);
     }
-    const latestRun = runs2.reduce(
-      (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
-    );
-    return {
-      totalRuns: runs2.length,
-      run: latestRun
-    };
+    throwIfWaitedRunFailed([{ runId: result.id, status: result.status, project: project2, error: result.error }]);
+    return;
   }
-}
-
-// src/cli-commands/operator.ts
-var RESULTS_EXPORT_USAGE = "canonry results export <project> [--format json|csv] [--since <ISO>] [--until <ISO>] [--include-probes] [--output <path>|-]";
-function parseResultsExportFormat(value) {
-  if (value === void 0 || value === "json") return "json";
-  if (value === "csv") return "csv";
-  throw usageError(`Error: --format must be "json" or "csv"
-
-Usage: ${RESULTS_EXPORT_USAGE}`);
-}
-var RESULTS_CLEAR_USAGE = "canonry results clear <project> [--run <id> ...] [--research-run <id> ...] [--confirm] [--format json|jsonl]";
-function parseHistoryPageOption(input, key, usage) {
-  const value = getString(input.values, key);
-  if (value === void 0) return void 0;
-  if (!/^\d+$/.test(value)) {
-    throw usageError(`Error: --${key} must be a ${key === "limit" ? "whole number from 1 to 500" : "nonnegative integer"}
-Usage: ${usage}`);
+  if (isMachineFormat(opts?.format)) {
+    console.log(JSON.stringify(run, null, 2));
+    return;
   }
-  const parsed = Number(value);
-  const valid = Number.isSafeInteger(parsed) && (key === "limit" ? parsed >= 1 && parsed <= 500 : parsed >= 0);
-  if (!valid) {
-    throw usageError(`Error: --${key} must be a ${key === "limit" ? "whole number from 1 to 500" : "nonnegative integer"}
-Usage: ${usage}`);
+  console.log(`Run created: ${run.id}`);
+  console.log(`  Kind:   ${run.kind}`);
+  console.log(`  Status: ${run.status}`);
+  if (opts?.provider) {
+    console.log(`  Provider: ${opts.provider}`);
   }
-  return parsed;
+  printSkippedProviders(project2, run.skippedProviders);
 }
-var OPERATOR_CLI_COMMANDS = [
-  {
-    path: ["results", "clear"],
-    usage: RESULTS_CLEAR_USAGE,
-    options: { run: multiStringOption(), "research-run": multiStringOption(), confirm: { type: "boolean", default: false } },
-    run: async (input) => {
-      await clearResults(requireProject(input, "results.clear", RESULTS_CLEAR_USAGE), {
-        runIds: getStringArray(input.values, "run") ?? [],
-        researchRunIds: getStringArray(input.values, "research-run") ?? [],
-        confirm: getBoolean(input.values, "confirm"),
-        format: input.format
-      });
+async function triggerRunAll(opts) {
+  const client = getClient21();
+  const projects2 = await client.listProjects();
+  if (projects2.length === 0) {
+    if (isMachineFormat(opts?.format)) {
+      console.log("[]");
+    } else {
+      console.log("No projects found.");
     }
-  },
-  {
-    path: ["results", "export"],
-    usage: RESULTS_EXPORT_USAGE,
-    options: {
-      since: stringOption(),
-      until: stringOption(),
-      "include-probes": { type: "boolean", default: false },
-      output: { type: "string", short: "o" }
-    },
-    run: async (input) => {
-      const project2 = requireProject(input, "results export", RESULTS_EXPORT_USAGE);
-      await exportResults(project2, {
-        format: parseResultsExportFormat(getString(input.values, "format")),
-        since: getString(input.values, "since"),
-        until: getString(input.values, "until"),
-        includeProbes: getBoolean(input.values, "include-probes"),
-        output: getString(input.values, "output")
-      });
+    return;
+  }
+  const baseBody = {};
+  if (opts?.provider) {
+    const providerInputs = opts.provider.split(",").map((s) => s.trim()).filter(Boolean);
+    const resolved = providerInputs.flatMap((p) => resolveProviderInput(p));
+    baseBody.providers = resolved.length > 0 ? resolved : providerInputs;
+  }
+  if (opts?.allLocations) {
+    baseBody.allLocations = true;
+  }
+  if (opts?.noLocation) {
+    baseBody.noLocation = true;
+  }
+  if (opts?.dispatchMode) {
+    baseBody.dispatchMode = opts.dispatchMode;
+  }
+  if (opts?.force) {
+    baseBody.force = true;
+  }
+  const results = [];
+  for (const p of projects2) {
+    const body = { ...baseBody };
+    if (body.allLocations && p.locations.length === 0) {
+      delete body.allLocations;
     }
-  },
-  {
-    path: ["status"],
-    usage: "canonry status <project> [--format json]",
-    run: async (input) => {
-      const project2 = requireProject(input, "status", "canonry status <project> [--format json]");
-      await showStatus(project2, input.format);
+    try {
+      const response = await client.triggerRun(p.name, body);
+      const dispatched = Array.isArray(response) ? response : [response];
+      for (const r of dispatched) {
+        results.push({
+          project: p.name,
+          runId: r.id,
+          status: r.status,
+          location: r.location ?? null
+        });
+      }
+    } catch (err) {
+      const msg = describeError(err);
+      results.push({ project: p.name, runId: "", status: "error", location: null, error: msg });
     }
-  },
-  {
-    path: ["evidence"],
-    usage: "canonry evidence <project> [--format json]",
-    run: async (input) => {
-      const project2 = requireProject(input, "evidence", "canonry evidence <project> [--format json]");
-      await showEvidence(project2, input.format);
+  }
+  const errors = /* @__PURE__ */ new Map();
+  const batchWaits = /* @__PURE__ */ new Map();
+  if (opts?.wait) {
+    const pending = results.filter((r) => r.runId && !TERMINAL_STATUSES.has(r.status));
+    if (pending.length > 0) {
+      const showProgress = !isMachineFormat(opts?.format);
+      if (showProgress) process.stderr.write(`Waiting for ${pending.length} run(s)`);
+      await Promise.all(pending.map(async (r) => {
+        const final = await pollRun2(client, r.runId, showProgress);
+        r.status = final.status;
+        errors.set(r.runId, final.error);
+        const waiting = batchWaitLine(final);
+        if (waiting) batchWaits.set(r.runId, waiting);
+      }));
+      if (showProgress) process.stderr.write("\n");
     }
-  },
-  {
-    path: ["history"],
-    usage: "canonry history <project> [--limit <1..500>] [--offset <n>] [--since <ISO>] [--action <action>] [--actor <actor>] [--entity-type <type>] [--format json|jsonl]\n       canonry history --all [same filters]",
-    options: {
-      all: { type: "boolean", default: false },
-      limit: stringOption(),
-      offset: stringOption(),
-      since: stringOption(),
-      action: stringOption(),
-      actor: stringOption(),
-      "entity-type": stringOption()
-    },
-    run: async (input) => {
-      const usage = "canonry history <project> [--limit <1..500>] [--offset <n>] [--since <ISO>] [--action <action>] [--actor <actor>] [--entity-type <type>] [--format json|jsonl]\n       canonry history --all [same filters]";
-      const project2 = getBoolean(input.values, "all") ? void 0 : requireProject(input, "history", usage);
-      await showHistory(project2, input.format, {
-        limit: parseHistoryPageOption(input, "limit", usage),
-        offset: parseHistoryPageOption(input, "offset", usage),
-        since: getString(input.values, "since"),
-        action: getString(input.values, "action"),
-        actor: getString(input.values, "actor"),
-        entityType: getString(input.values, "entity-type")
-      });
+  }
+  const waited = results.filter((r) => r.runId).map((r) => ({ runId: r.runId, status: r.status, project: r.project, location: r.location, error: errors.get(r.runId) }));
+  if (isMachineFormat(opts?.format)) {
+    console.log(JSON.stringify(results, null, 2));
+    if (opts?.wait) throwIfWaitedRunFailed(waited);
+    return;
+  }
+  const showLocationColumn = results.some((r) => r.location !== null);
+  const projectCount = new Set(results.map((r) => r.project)).size;
+  console.log(`Triggered ${results.length} run(s) across ${projectCount} project(s):
+`);
+  if (showLocationColumn) {
+    console.log("  PROJECT                          LOCATION         RUN ID                                STATUS");
+    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");
+    for (const r of results) {
+      const proj = r.project.padEnd(31);
+      const loc = (r.location ?? "\u2014").padEnd(15);
+      const id = (r.runId || "(failed)").padEnd(36);
+      console.log(`  ${proj}  ${loc}  ${id}  ${r.status}`);
     }
-  },
-  {
-    path: ["export"],
-    usage: "canonry export <project> [--include-results] [--format json]",
-    options: {
-      "include-results": { type: "boolean", default: false }
-    },
-    run: async (input) => {
-      const project2 = requireProject(input, "export", "canonry export <project> [--include-results] [--format json]");
-      await exportProject(project2, {
-        includeResults: getBoolean(input.values, "include-results"),
-        format: input.format
-      });
+  } else {
+    console.log("  PROJECT                          RUN ID                                STATUS");
+    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");
+    for (const r of results) {
+      const proj = r.project.padEnd(31);
+      const id = (r.runId || "(failed)").padEnd(36);
+      console.log(`  ${proj}  ${id}  ${r.status}`);
     }
-  },
-  {
-    path: ["analytics"],
-    usage: "canonry analytics <project> [--feature metrics|gaps|sources] [--window 7d|30d|90d|all] [--format json]",
-    options: {
-      feature: stringOption(),
-      window: stringOption()
-    },
-    run: async (input) => {
-      const project2 = requireProject(input, "analytics", "canonry analytics <project> [--feature metrics|gaps|sources] [--window 7d|30d|90d|all] [--format json]");
-      await showAnalytics(project2, {
-        feature: getString(input.values, "feature"),
-        window: getString(input.values, "window"),
-        format: input.format
+  }
+  if (batchWaits.size > 0) console.log("");
+  for (const r of results) {
+    const waiting = batchWaits.get(r.runId);
+    if (waiting) console.log(`  ${r.location ? `${r.project} (${r.location})` : r.project}: ${waiting}`);
+  }
+  if (opts?.wait) throwIfWaitedRunFailed(waited);
+}
+async function cancelRun(project2, runId, format) {
+  const client = getClient21();
+  let targetId = runId;
+  if (!targetId) {
+    const runs2 = await client.listRuns(project2);
+    const activeRuns = runs2.filter((r) => r.status === "queued" || r.status === "running");
+    if (activeRuns.length > 1) {
+      const candidates = activeRuns.map(({ id, kind, status }) => ({ id, kind, status }));
+      throw new CliError({
+        code: "MULTIPLE_ACTIVE_RUNS",
+        message: `Multiple active runs found for project "${project2}". Specify a run ID.`,
+        displayMessage: `Error: Multiple active runs found for project "${project2}". Specify a run ID.
+` + candidates.map((r) => `  ${r.id}  ${r.kind}  ${r.status}`).join("\n") + `
+To cancel by ID: canonry run cancel ${project2} <run-id>`,
+        details: {
+          project: project2,
+          activeRuns: candidates,
+          suggestedCommands: [`canonry run cancel ${project2} <run-id>`]
+        }
       });
     }
-  },
-  {
-    path: ["sources"],
-    usage: SOURCES_USAGE,
-    options: {
-      rank: { type: "boolean", default: false },
-      "by-provider": { type: "boolean", default: false },
-      limit: stringOption(),
-      window: stringOption(),
-      "query-class": stringOption(),
-      "run-id": stringOption(),
-      "include-by-query": stringOption()
-    },
-    run: async (input) => {
-      const project2 = requireProject(input, "sources", SOURCES_USAGE);
-      await showSources(project2, {
-        rank: getBoolean(input.values, "rank"),
-        byProvider: getBoolean(input.values, "by-provider"),
-        limit: parseIntegerOption(input, "limit", {
-          message: "--limit must be an integer",
-          usage: SOURCES_USAGE,
-          command: "sources"
-        }),
-        window: getString(input.values, "window"),
-        runId: getString(input.values, "run-id"),
-        queryClass: parseSourcesQueryClass(getString(input.values, "query-class")),
-        includeByQuery: parseSourcesIncludeByQuery(getString(input.values, "include-by-query")),
-        format: input.format
+    const active = activeRuns[0];
+    if (!active) {
+      throw new CliError({
+        code: "NO_ACTIVE_RUN",
+        message: `No active run found for project "${project2}"`,
+        displayMessage: `Error: canonry run cancel "${project2}" \u2014 no active run found (status must be queued or running).
+Check run status : canonry status ${project2}
+To cancel by ID  : canonry run cancel ${project2} <run-id>`,
+        details: {
+          project: project2,
+          allowedStatuses: ["queued", "running"],
+          suggestedCommands: [
+            `canonry status ${project2}`,
+            `canonry run cancel ${project2} <run-id>`
+          ]
+        }
       });
     }
-  },
-  {
-    path: ["apply"],
-    usage: "canonry apply <file...> [--format json]",
-    run: async (input) => {
-      if (input.positionals.length === 0) {
-        throw usageError("Error: at least one file path is required\nUsage: canonry apply <file...> [--format json]", {
-          message: "at least one file path is required",
-          details: {
-            command: "apply",
-            usage: "canonry apply <file...> [--format json]"
-          }
-        });
-      }
-      await applyConfigs(input.positionals, input.format);
-    }
+    targetId = active.id;
   }
-];
-
-// src/commands/project.ts
-function getClient22() {
-  return createApiClient();
+  const result = await client.cancelRun(targetId);
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Run ${result.id} cancelled.`);
 }
-async function createProject(name, opts) {
-  const client = getClient22();
-  const result = await client.putProject(name, {
-    displayName: opts.displayName,
-    canonicalDomain: opts.domain,
-    ownedDomains: opts.ownedDomains ?? [],
-    aliases: normalizeProjectAliases(opts.displayName, opts.aliases ?? []),
-    ...opts.qualifiedAliases?.length ? { qualifiedAliases: opts.qualifiedAliases } : {},
-    country: opts.country,
-    language: opts.language,
-    providers: opts.providers ?? [],
-    providerModels: opts.providerModels ?? {},
-    ...opts.providerDispatchModes && Object.keys(opts.providerDispatchModes).length > 0 ? { providerDispatchModes: opts.providerDispatchModes } : {},
-    // Sent only when given: this PUT also re-runs over an existing project,
-    // and an omitted budget keeps the stored one.
-    ...opts.siteAuditMaxPages !== void 0 ? { siteAuditMaxPages: opts.siteAuditMaxPages } : {}
-  });
-  warnDroppedDispatchModes(opts.providerDispatchModes ?? {}, result);
-  if (isMachineFormat(opts.format)) {
-    console.log(JSON.stringify(result, null, 2));
+async function showRun(id, format) {
+  const client = getClient21();
+  const run = await client.getRun(id);
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify(run, null, 2));
     return;
   }
-  console.log(`Project created: ${result.name} (${result.id})`);
-}
-function warnDroppedDispatchModes(sent, result) {
-  const kept = result.providerDispatchModes ?? {};
-  const dropped = Object.keys(sent).filter((provider) => !(provider in kept));
-  if (dropped.length > 0) {
-    console.error(`Warning: Dropped dispatch mode for engine(s) the project does not measure: ${dropped.join(", ")}`);
-  }
+  printRunDetail(run);
 }
-async function listProjects(format) {
-  const client = getClient22();
-  const projects2 = await client.listProjects();
-  if (format === "json") {
-    console.log(JSON.stringify(projects2, null, 2));
+async function listRuns(project2, opts) {
+  const client = getClient21();
+  const runs2 = await client.listRuns(project2, opts?.limit, opts?.kind, opts?.status, opts?.excludeKind, opts?.excludeKinds);
+  if (opts?.format === "json") {
+    console.log(JSON.stringify(runs2, null, 2));
     return;
-  }
-  if (format === "jsonl") {
-    emitJsonl(projects2);
+  } else if (opts?.format === "jsonl") {
+    emitJsonl(runs2.map((run) => ({ project: project2, ...run })));
     return;
   }
-  if (projects2.length === 0) {
-    console.log("No projects found.");
+  if (runs2.length === 0) {
+    console.log(`No runs found for "${project2}".`);
     return;
   }
-  console.log("Projects:\n");
-  const nameWidth = Math.max(4, ...projects2.map((p) => p.name.length));
-  const domainLabel = (p) => {
-    const extra = Math.max(0, effectiveDomains(p).length - 1);
-    return extra > 0 ? `${p.canonicalDomain} (+${extra})` : p.canonicalDomain;
-  };
-  const domainWidth = Math.max(6, ...projects2.map((p) => domainLabel(p).length));
-  console.log(
-    `  ${"NAME".padEnd(nameWidth)}  ${"DOMAIN".padEnd(domainWidth)}  COUNTRY  LANGUAGE`
-  );
-  console.log(`  ${"\u2500".repeat(nameWidth)}  ${"\u2500".repeat(domainWidth)}  \u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
-  for (const p of projects2) {
+  console.log(`Runs for "${project2}" (${runs2.length}):
+`);
+  console.log("  ID                                    STATUS      KIND                TRIGGER    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");
+  for (const run of runs2) {
     console.log(
-      `  ${p.name.padEnd(nameWidth)}  ${domainLabel(p).padEnd(domainWidth)}  ${p.country.padEnd(7)}  ${p.language}`
+      `  ${run.id}  ${run.status.padEnd(10)}  ${run.kind.padEnd(18)}  ${run.trigger.padEnd(9)}  ${run.createdAt}`
     );
   }
 }
-function storedQualifiedAliases(project2) {
-  return project2.qualifiedAliases ?? [];
-}
-async function showProject(name, format) {
-  const client = getClient22();
-  const project2 = await client.getProject(name);
-  if (isMachineFormat(format)) {
-    console.log(JSON.stringify(project2, null, 2));
-    return;
-  }
-  console.log(`Project: ${project2.displayName ?? project2.name}
-`);
-  console.log(`  Name:             ${project2.name}`);
-  console.log(`  ID:               ${project2.id}`);
-  console.log(`  Domain:           ${project2.canonicalDomain}`);
-  const secondaryDomains = effectiveDomains(project2).slice(1);
-  if (secondaryDomains.length > 0) {
-    console.log(`  Owned domains:    ${secondaryDomains.join(", ")}`);
+var POLL_TIMEOUT_MS3 = 10 * 60 * 1e3;
+async function pollRun2(client, runId, showProgress = true) {
+  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_MS3 / 1e3}s`);
+    }
+    const run = await client.getRun(runId);
+    if (showProgress) process.stderr.write(".");
+    if (TERMINAL_STATUSES.has(run.status) || outstandingBatches(run).length > 0) {
+      return run;
+    }
   }
-  if (project2.aliases && project2.aliases.length > 0) {
-    console.log(`  Aliases:          ${project2.aliases.join(", ")}`);
+}
+function outstandingBatches(run) {
+  if (TERMINAL_STATUSES.has(run.status)) return [];
+  return (run.providerBatches ?? []).filter((batch) => OUTSTANDING_PROVIDER_BATCH_STATUSES.includes(batch.status));
+}
+function batchWaitLine(run) {
+  const outstanding = outstandingBatches(run);
+  if (outstanding.length === 0) return null;
+  const batches = outstanding.map((batch) => `${batch.provider} \u2014 ${batch.requestCount} requests, submitted ${batch.submittedAt ?? "unknown"}, deadline ${batch.deadlineAt}`);
+  return `Waiting on provider batch(es): ${batches.join("; ")}; check with canonry run show ${run.id}`;
+}
+function printRunDetail(run) {
+  console.log(`Run: ${run.id}`);
+  console.log(`  Status:   ${run.status}`);
+  console.log(`  Kind:     ${run.kind}`);
+  if (run.trigger) console.log(`  Trigger:  ${run.trigger}`);
+  if (run.startedAt) console.log(`  Started:  ${run.startedAt}`);
+  if (run.finishedAt) console.log(`  Finished: ${run.finishedAt}`);
+  if (run.createdAt) console.log(`  Created:  ${run.createdAt}`);
+  const skipped = Object.entries(run.skippedProviders ?? {});
+  for (const [provider, streak] of skipped) console.log(`  Skipped:  ${providerAccountStreakLine(provider, streak)}`);
+  if (run.error) {
+    if (run.error.message) console.log(`  Error:    ${run.error.message}`);
+    if (run.error.providers) {
+      for (const [provider, detail] of Object.entries(run.error.providers)) {
+        if (detail.skipped && run.skippedProviders?.[provider]) continue;
+        console.log(`  Error (${provider}): ${detail.message}`);
+      }
+    }
   }
-  const qualifiedAliases = storedQualifiedAliases(project2);
-  if (qualifiedAliases.length > 0) {
-    console.log(`  Qualified:        ${qualifiedAliases.join(", ")} (sentiment)`);
+  const batched = Object.keys(run.dispatchModes ?? {}).sort();
+  if (batched.length > 0) console.log(`  Dispatch: ${batched.map((provider) => `${provider}=batch`).join(", ")} (other providers sync)`);
+  if (run.providerBatches && run.providerBatches.length > 0) {
+    console.log("\n  Provider batches:");
+    for (const batch of run.providerBatches) console.log(`    ${providerBatchLine(batch)}`);
   }
-  console.log(`  Country:          ${project2.country}`);
-  console.log(`  Language:         ${project2.language}`);
-  console.log(`  Config source:    ${project2.configSource}`);
-  console.log(`  Config revision:  ${project2.configRevision}`);
-  console.log(`  Providers:        ${(project2.providers ?? []).length > 0 ? project2.providers.join(", ") : "all configured"}`);
-  const providerModels = Object.entries(project2.providerModels ?? {});
-  console.log(`  Model overrides:  ${providerModels.length > 0 ? providerModels.map(([provider, model]) => `${provider}=${model}`).join(", ") : "(none; instance settings inherited)"}`);
-  const dispatchModes = Object.entries(project2.providerDispatchModes ?? {}).sort(([left], [right]) => left.localeCompare(right));
-  console.log(`  Dispatch modes:   ${dispatchModes.length > 0 ? `${dispatchModes.map(([provider, mode]) => `${provider}=${mode}`).join(", ")} (scheduled sweeps; others sync)` : "(none; every provider runs sync)"}`);
-  console.log(`  Negative reviews: ${resolveNegativeReviewMaxStars(project2.negativeReviewMaxStars)} stars or fewer${project2.negativeReviewMaxStars == null ? " (default)" : ""}`);
-  if (project2.siteAuditMaxPages !== void 0) {
-    console.log(`  Site Health page budget: ${formatSiteAuditPageBudget(project2.siteAuditMaxPages)}`);
+  if (run.usage && run.usage.length > 0) printUsageTable(run.usage);
+  if (run.snapshots && run.snapshots.length > 0) {
+    console.log(`
+  Snapshots: ${run.snapshots.length}  (cell = [citation][mention];  C=cited c=not, M=mentioned m=not, \u2013=no data)`);
+    for (const s of run.snapshots) {
+      const citationGlyph = s.citationState === CitationStates.cited ? "C" : "c";
+      const mentionGlyph = typeof s.answerMentioned === "boolean" ? s.answerMentioned ? "M" : "m" : "\u2013";
+      const modelLabel = s.model ? ` (${s.model})` : "";
+      console.log(`    [${citationGlyph}${mentionGlyph}]  ${s.provider}${modelLabel}  ${s.query}`);
+    }
   }
-  if (project2.competitorAutoAliases !== void 0) {
-    console.log(`  Competitor auto aliases: ${formatCompetitorAutoAliasMode(project2.competitorAutoAliases)}`);
+}
+function providerBatchLine(batch) {
+  const recorded = `${batch.recordedCount} of ${batch.requestCount} answers recorded`;
+  const withError = (text) => batch.error ? `${text} (${batch.error})` : text;
+  switch (batch.status) {
+    case ProviderBatchStatuses.submitting:
+      return `submitting provider batch: ${batch.provider} \u2014 ${batch.requestCount} requests`;
+    // The two outstanding statuses: the run stays `running` until they clear.
+    case ProviderBatchStatuses.submitted:
+    case ProviderBatchStatuses.ended:
+      return `waiting on provider batch: ${batch.provider} \u2014 ${batch.requestCount} requests, submitted ${batch.submittedAt ?? "unknown"}, deadline ${batch.deadlineAt}`;
+    case ProviderBatchStatuses.ingested:
+      return withError(`provider batch ${batch.provider}: ingested \u2014 ${recorded}`);
+    case ProviderBatchStatuses.cancelled:
+      return withError(`provider batch ${batch.provider}: cancelled \u2014 ${recorded}; the rest are missing and can be filled`);
+    case ProviderBatchStatuses.failed:
+      return withError(`provider batch ${batch.provider}: rejected by the provider \u2014 its ${batch.requestCount} answers ran sync instead`);
+    case ProviderBatchStatuses.unknown:
+      return withError(`provider batch ${batch.provider}: submit outcome unknown \u2014 never resubmitted; its ${batch.requestCount} answers stay missing`);
   }
-  console.log(`  Tags:             ${project2.tags.length > 0 ? project2.tags.join(", ") : "(none)"}`);
-  const labelEntries = Object.entries(project2.labels);
-  console.log(`  Labels:           ${labelEntries.length > 0 ? labelEntries.map(([k, v]) => `${k}=${v}`).join(", ") : "(none)"}`);
-  if (project2.createdAt) console.log(`  Created:          ${project2.createdAt}`);
-  if (project2.updatedAt) console.log(`  Updated:          ${project2.updatedAt}`);
 }
-function formatCompetitorAutoAliasMode(mode) {
-  if (mode === "apply") return "apply (names detected after each sweep are stored and counted)";
-  if (mode === "off") return "off (no detection after sweeps)";
-  return "preview (detected after each sweep and logged; nothing stored)";
+function printUsageTable(rows) {
+  const cost = (row) => row.estimatedCostMicros === null ? "unpriced" : `${formatMicros(row.estimatedCostMicros, "USD", { fractionDigits: 4, showTinyAsLessThan: true })}${row.unpricedAnswers > 0 ? ` (+${row.unpricedAnswers} unpriced)` : ""}`;
+  const table = rows.map((row) => [
+    row.provider,
+    row.pricingTier,
+    row.answers.toLocaleString("en-US"),
+    row.inputTokens.toLocaleString("en-US"),
+    row.cachedInputTokens.toLocaleString("en-US"),
+    row.cacheWriteTokens.toLocaleString("en-US"),
+    row.outputTokens.toLocaleString("en-US"),
+    row.searchCount.toLocaleString("en-US"),
+    cost(row)
+  ]);
+  const header = ["PROVIDER", "TIER", "ANSWERS", "INPUT", "CACHED", "CACHE WRITE", "OUTPUT", "SEARCHES", "EST. COST"];
+  const widths = header.map((title, index) => Math.max(title.length, ...table.map((cells) => cells[index].length)));
+  const line = (cells) => `    ${cells.map((cell2, index) => cell2.padEnd(widths[index])).join("  ").trimEnd()}`;
+  console.log("\n  Usage (answers with recorded usage; cost is an estimate):");
+  console.log(line(header));
+  for (const cells of table) console.log(line(cells));
 }
-async function updateProjectSettings(name, opts) {
-  const client = getClient22();
-  const project2 = await client.getProject(name);
-  let ownedDomains = opts.ownedDomains ?? project2.ownedDomains ?? [];
-  if (opts.addOwnedDomain) {
-    const toAdd = opts.addOwnedDomain.filter((d) => !ownedDomains.includes(d));
-    ownedDomains = [...ownedDomains, ...toAdd];
+var FILL_POLL_INTERVAL_MS = 3e3;
+var FILL_POLL_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
+function missingSummary(completeness) {
+  const parts = Object.entries(completeness.missingByProvider).sort(([left], [right]) => left.localeCompare(right)).map(([provider, count]) => `${provider} ${count}`);
+  return parts.length ? parts.join(", ") : "none";
+}
+function printCompleteness(completeness) {
+  console.log(`Run: ${completeness.runId}`);
+  console.log(`  Status:   ${completeness.status}`);
+  if (!completeness.planned) {
+    console.log("  Not a measurement-plan run: there are no expected answers to count.");
+    return;
   }
-  if (opts.removeOwnedDomain) {
-    const toRemove = new Set(opts.removeOwnedDomain);
-    ownedDomains = ownedDomains.filter((d) => !toRemove.has(d));
+  if (!completeness.readable) {
+    console.log("  Answers:  unknown (the run's manifest cannot be read)");
+  } else {
+    console.log(`  Answers:  ${completeness.executed}/${completeness.expected}`);
+    console.log(`  Missing:  ${completeness.missing} (${missingSummary(completeness)})`);
   }
-  const nextDisplayName = opts.displayName ?? project2.displayName ?? project2.name;
-  let aliases = opts.aliases ?? project2.aliases ?? [];
-  if (opts.addAlias) {
-    const existingKeys = new Set(aliases.map((a) => a.toLowerCase()));
-    const toAdd = opts.addAlias.filter((a) => !existingKeys.has(a.toLowerCase()));
-    aliases = [...aliases, ...toAdd];
+  if (completeness.refusal) console.log(`  Fillable: no. ${completeness.refusal.message}`);
+  else console.log(`  Fillable: ${completeness.fillable ? "yes" : "not right now (a sweep or another fill is running)"}`);
+  const fill = completeness.latestFill;
+  if (fill) {
+    console.log(`  Last fill: ${fill.id} ${fill.status}, ${fill.filled}/${fill.expected} recorded${fill.error ? `. ${fill.error}` : ""}`);
   }
-  if (opts.removeAlias) {
-    const toRemove = new Set(opts.removeAlias.map((a) => a.toLowerCase()));
-    aliases = aliases.filter((a) => !toRemove.has(a.toLowerCase()));
+}
+async function showRunCompleteness(runId, format) {
+  const completeness = await getClient21().getRunCompleteness(runId);
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify(completeness, null, 2));
+    return;
   }
-  const nextAliases = normalizeProjectAliases(nextDisplayName, aliases);
-  const touchesQualified = (opts.addQualifiedAlias?.length ?? 0) > 0 || (opts.removeQualifiedAlias?.length ?? 0) > 0;
-  let qualifiedAliases = resolveProjectQualifiedAliases(
-    { displayName: nextDisplayName, aliases: nextAliases },
-    storedQualifiedAliases(project2)
-  ).value;
-  if (opts.addQualifiedAlias) {
-    const existingKeys = new Set(qualifiedAliases.map((alias) => alias.toLowerCase()));
-    for (const alias of opts.addQualifiedAlias) {
-      if (existingKeys.has(alias.toLowerCase())) continue;
-      existingKeys.add(alias.toLowerCase());
-      qualifiedAliases = [...qualifiedAliases, alias];
-    }
-  }
-  if (opts.removeQualifiedAlias) {
-    const toRemove = new Set(opts.removeQualifiedAlias.map((alias) => alias.toLowerCase()));
-    qualifiedAliases = qualifiedAliases.filter((alias) => !toRemove.has(alias.toLowerCase()));
-  }
-  const providerModels = { ...project2.providerModels ?? {}, ...opts.providerModels ?? {} };
-  for (const provider of opts.clearProviderModels ?? []) delete providerModels[provider];
-  const nextProviders = opts.providers ?? project2.providers ?? [];
-  if (nextProviders.length > 0) {
-    const requested = Object.keys(opts.providerModels ?? {}).filter((p) => !nextProviders.includes(p));
-    if (requested.length > 0) {
-      throw usageError(
-        `Error: --provider-model set for ${requested.join(", ")}, which ${requested.length > 1 ? "are" : "is"} not a selected engine for "${name}"`,
-        {
-          message: "provider-model set for a provider the project does not run",
-          details: { command: "project.update", project: name, providers: nextProviders, unselected: requested }
-        }
-      );
-    }
-  }
-  const touchesDispatch = Object.keys(opts.dispatchModes ?? {}).length > 0 || (opts.clearDispatchModes ?? []).length > 0;
-  const providerDispatchModes = { ...project2.providerDispatchModes ?? {}, ...opts.dispatchModes ?? {} };
-  for (const provider of opts.clearDispatchModes ?? []) delete providerDispatchModes[provider];
-  const result = await client.putProject(name, {
-    displayName: nextDisplayName,
-    canonicalDomain: opts.domain ?? project2.canonicalDomain,
-    ownedDomains,
-    aliases: nextAliases,
-    ...touchesQualified ? { qualifiedAliases } : {},
-    country: opts.country ?? project2.country,
-    language: opts.language ?? project2.language,
-    tags: project2.tags,
-    labels: project2.labels,
-    providers: opts.providers ?? project2.providers,
-    providerModels,
-    ...touchesDispatch ? { providerDispatchModes } : {},
-    locations: project2.locations,
-    defaultLocation: project2.defaultLocation,
-    autoExtractBacklinks: project2.autoExtractBacklinks,
-    // Sent only when asked for: the server keeps the stored threshold when the
-    // field is absent, so a stale read cannot overwrite a newer setting.
-    ...opts.negativeReviewMaxStars !== void 0 ? { negativeReviewMaxStars: opts.negativeReviewMaxStars } : {},
-    // Same for the page budget: never echoed from the read above, so an edit
-    // that does not touch it cannot overwrite a newer one or send a stray null.
-    ...opts.siteAuditMaxPages !== void 0 ? { siteAuditMaxPages: opts.siteAuditMaxPages } : {},
-    // Same for the detection mode.
-    ...opts.competitorAutoAliases !== void 0 ? { competitorAutoAliases: opts.competitorAutoAliases } : {}
+  printCompleteness(completeness);
+}
+async function fillRun(runId, opts = {}) {
+  const client = getClient21();
+  const response = await client.fillRun(runId, {
+    ...opts.providers?.length ? { providers: opts.providers } : {},
+    ...opts.dryRun ? { dryRun: true } : {}
   });
-  warnDroppedDispatchModes(touchesDispatch ? providerDispatchModes : project2.providerDispatchModes ?? {}, result);
-  if (isMachineFormat(opts.format)) {
-    console.log(JSON.stringify(result, null, 2));
+  if (!opts.wait || response.outcome !== "queued" || !response.fill) {
+    if (isMachineFormat(opts.format)) {
+      console.log(JSON.stringify(response, null, 2));
+      return;
+    }
+    if (response.outcome === "already-complete") console.log(`Run ${runId} is already complete: nothing to fill.`);
+    else if (response.outcome === "dry-run") console.log("Dry run: nothing was queued.");
+    else if (response.fill) console.log(`Fill ${response.fill.id} queued: ${response.fill.expected} missing answer(s) (${missingSummary(response.completeness)}).`);
+    printCompleteness(response.completeness);
     return;
   }
-  console.log(`Project updated: ${result.name}`);
-  const dropped = Object.keys(providerModels).filter((provider) => !(provider in result.providerModels));
-  if (dropped.length > 0) {
-    console.log(`  Dropped model override for deselected engine(s): ${dropped.join(", ")}`);
+  const fillId = response.fill.id;
+  const deadline = Date.now() + FILL_POLL_TIMEOUT_MS;
+  let completeness = response.completeness;
+  if (!isMachineFormat(opts.format)) {
+    process.stderr.write(`Filling ${response.fill.expected} missing answer(s) in run ${runId}`);
   }
-}
-async function deleteProject(name, opts) {
-  const client = getClient22();
-  const isJson = isMachineFormat(opts?.format);
-  if (opts?.dryRun) {
-    const preview = await client.previewProjectDelete(name);
-    if (isJson) {
-      console.log(JSON.stringify({ dryRun: true, ...preview }, null, 2));
-      return;
+  for (; ; ) {
+    await new Promise((resolve) => setTimeout(resolve, FILL_POLL_INTERVAL_MS));
+    if (Date.now() > deadline) {
+      throw new CliError({
+        code: "RUN_FILL_INCOMPLETE",
+        message: `Timed out waiting for fill ${fillId}; it may still be running. Check with: canonry run completeness ${runId}`,
+        exitCode: EXIT_SYSTEM_ERROR,
+        details: { runId, fillId }
+      });
     }
-    const { cascadeRows: cr, detachedRows: dr } = preview;
-    console.log(`Project delete preview for "${name}":`);
-    console.log(`  Cascade-deletes:`);
-    console.log(`    queries:      ${cr.queries}`);
-    console.log(`    competitors:  ${cr.competitors}`);
-    console.log(`    runs:         ${cr.runs}`);
-    console.log(`    snapshots:    ${cr.snapshots}`);
-    console.log(`    insights:     ${cr.insights}`);
-    console.log(`  Detached (project_id set to NULL):`);
-    console.log(`    audit_log:    ${dr.auditLog}`);
-    console.log(``);
-    console.log(`No DB writes performed. Re-run without --dry-run to delete.`);
-    return;
+    completeness = await client.getRunCompleteness(runId);
+    if (!isMachineFormat(opts.format)) process.stderr.write(".");
+    const latest = completeness.latestFill;
+    const working = latest !== null && (latest.status === "queued" || latest.status === "running");
+    if (completeness.status === "completed" || !working) break;
   }
-  await client.deleteProject(name);
-  if (isJson) {
-    console.log(JSON.stringify({ name, deleted: true }, null, 2));
-    return;
+  if (!isMachineFormat(opts.format)) process.stderr.write("\n");
+  if (isMachineFormat(opts.format)) console.log(JSON.stringify(completeness, null, 2));
+  else printCompleteness(completeness);
+  if (completeness.status !== "completed") {
+    throw new CliError({
+      code: "RUN_FILL_INCOMPLETE",
+      message: `Run ${runId} is still ${completeness.status}: ${completeness.missing} answer(s) missing (${missingSummary(completeness)}).`,
+      exitCode: EXIT_SYSTEM_ERROR,
+      details: { runId, fillId, missing: completeness.missing, missingByProvider: completeness.missingByProvider }
+    });
   }
-  console.log(`Project deleted: ${name}`);
 }
-async function addLocation(project2, opts) {
-  const client = getClient22();
-  const location = await client.addLocation(project2, {
-    label: opts.label,
-    city: opts.city,
-    region: opts.region,
-    country: opts.country,
-    timezone: opts.timezone
-  });
-  if (isMachineFormat(opts.format)) {
-    console.log(JSON.stringify(location, null, 2));
-    return;
-  }
-  console.log(`Location added: ${opts.label} (${opts.city}, ${opts.region}, ${opts.country})`);
+
+// src/commands/status.ts
+function getClient22() {
+  return createApiClient();
 }
-async function listLocations(project2, format) {
+async function showStatus(project2, format) {
   const client = getClient22();
-  const result = await client.listLocations(project2);
-  if (format === "json") {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-  if (format === "jsonl") {
-    emitJsonl(result.locations.map((loc) => ({
-      project: project2,
-      isDefault: loc.label === result.defaultLocation,
-      ...loc
-    })));
-    return;
-  }
-  if (result.locations.length === 0) {
-    console.log(`No locations configured for "${project2}".`);
+  const projectData = await client.getProject(project2);
+  const latest = await getLatestRunSummary(client, project2);
+  if (isMachineFormat(format)) {
+    let runs2 = [];
+    try {
+      runs2 = await client.listRuns(project2);
+    } catch {
+    }
+    console.log(JSON.stringify({
+      project: projectData,
+      runs: runs2,
+      latestRun: latest.run,
+      totalRuns: latest.totalRuns,
+      // Absent from a server that predates it.
+      ...latest.admission ? { admission: latest.admission } : {},
+      ...latest.manualAdmission ? { manualAdmission: latest.manualAdmission } : {}
+    }, null, 2));
     return;
   }
-  console.log(`Locations for "${project2}" (${result.locations.length}):
+  console.log(`Status: ${projectData.displayName ?? projectData.name} (${projectData.name})
 `);
-  console.log("  LABEL            CITY                 REGION               COUNTRY  DEFAULT");
-  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");
-  for (const loc of result.locations) {
-    const isDefault = loc.label === result.defaultLocation ? "  *" : "";
-    console.log(
-      `  ${loc.label.padEnd(15)}  ${loc.city.padEnd(19)}  ${loc.region.padEnd(19)}  ${loc.country.padEnd(7)}${isDefault}`
-    );
-  }
-  if (result.defaultLocation) {
+  console.log(`  Domain:   ${projectData.canonicalDomain}`);
+  console.log(`  Country:  ${projectData.country}`);
+  console.log(`  Language: ${projectData.language}`);
+  if (latest.run) {
     console.log(`
-  Default: ${result.defaultLocation}`);
-  }
-}
-async function removeLocation(project2, label, format) {
-  const client = getClient22();
-  await client.removeLocation(project2, label);
-  if (isMachineFormat(format)) {
-    console.log(JSON.stringify({ project: project2, label, removed: true }, null, 2));
-    return;
+  Latest run:`);
+    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: ${latest.totalRuns}`);
+  } else {
+    const projectArg = /^[\w.-]+$/.test(project2) ? project2 : `'${project2.replaceAll("'", `'\\''`)}'`;
+    console.log(`
+  No runs yet. Capture Page Health with "canonry technical-aeo run ${projectArg}", or run an AI Visibility sweep after adding a provider.`);
   }
-  console.log(`Location removed: ${label}`);
+  const admission = runAdmissionLines(project2, latest.admission, latest.manualAdmission);
+  if (admission.length > 0) console.log(`
+${admission.map((line) => `  ${line}`).join("\n")}`);
 }
-async function setDefaultLocation(project2, label, format) {
-  const client = getClient22();
-  const result = await client.setDefaultLocation(project2, label);
-  if (isMachineFormat(format)) {
-    console.log(JSON.stringify({ project: project2, ...result }, null, 2));
-    return;
+async function getLatestRunSummary(client, project2) {
+  try {
+    return await client.getLatestRun(project2);
+  } catch (err) {
+    if (!isEndpointMissing(err)) throw err;
+    const runs2 = await client.listRuns(project2);
+    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
+    };
   }
-  console.log(`Default location set to: ${label}`);
 }
 
-// src/cli-commands/project.ts
-var PROJECT_CLI_COMMANDS = [
-  {
-    path: ["project", "create"],
-    usage: "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--qualified-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--dispatch-mode provider=sync|batch...] [--site-audit-max-pages <1-50000|full>] [--format json]",
-    help: "Create a project. Pass --domain for the public site to scan. Provider credentials are not required for Page Health.",
-    options: {
-      domain: { type: "string", short: "d" },
-      "owned-domain": multiStringOption(),
-      alias: multiStringOption(),
-      "qualified-alias": multiStringOption(),
-      country: stringOption(),
-      language: stringOption(),
-      "display-name": stringOption(),
-      provider: multiStringOption(),
-      "provider-model": multiStringOption(),
-      "dispatch-mode": multiStringOption(),
-      "site-audit-max-pages": stringOption()
-    },
+// src/cli-commands/operator.ts
+var RESULTS_EXPORT_USAGE = "canonry results export <project> [--format json|csv] [--since <ISO>] [--until <ISO>] [--include-probes] [--output <path>|-]";
+function parseResultsExportFormat(value) {
+  if (value === void 0 || value === "json") return "json";
+  if (value === "csv") return "csv";
+  throw usageError(`Error: --format must be "json" or "csv"
+
+Usage: ${RESULTS_EXPORT_USAGE}`);
+}
+var RESULTS_CLEAR_USAGE = "canonry results clear <project> [--run <id> ...] [--research-run <id> ...] [--confirm] [--format json|jsonl]";
+function parseHistoryPageOption(input, key, usage) {
+  const value = getString(input.values, key);
+  if (value === void 0) return void 0;
+  if (!/^\d+$/.test(value)) {
+    throw usageError(`Error: --${key} must be a ${key === "limit" ? "whole number from 1 to 500" : "nonnegative integer"}
+Usage: ${usage}`);
+  }
+  const parsed = Number(value);
+  const valid = Number.isSafeInteger(parsed) && (key === "limit" ? parsed >= 1 && parsed <= 500 : parsed >= 0);
+  if (!valid) {
+    throw usageError(`Error: --${key} must be a ${key === "limit" ? "whole number from 1 to 500" : "nonnegative integer"}
+Usage: ${usage}`);
+  }
+  return parsed;
+}
+var OPERATOR_CLI_COMMANDS = [
+  {
+    path: ["results", "clear"],
+    usage: RESULTS_CLEAR_USAGE,
+    options: { run: multiStringOption(), "research-run": multiStringOption(), confirm: { type: "boolean", default: false } },
     run: async (input) => {
-      const name = requireProject(
-        input,
-        "project.create",
-        "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--qualified-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--dispatch-mode provider=sync|batch...] [--site-audit-max-pages <1-50000|full>] [--format json]"
-      );
-      await createProject(name, {
-        domain: getString(input.values, "domain") ?? name,
-        ownedDomains: getStringArray(input.values, "owned-domain") ?? [],
-        aliases: getStringArray(input.values, "alias") ?? [],
-        qualifiedAliases: getStringArray(input.values, "qualified-alias") ?? [],
-        country: getString(input.values, "country") ?? "US",
-        language: getString(input.values, "language") ?? "en",
-        displayName: getString(input.values, "display-name") ?? name,
-        providers: getStringArray(input.values, "provider") ?? [],
-        providerModels: parseProviderModelAssignments(getStringArray(input.values, "provider-model")),
-        providerDispatchModes: parseDispatchModeAssignments(getStringArray(input.values, "dispatch-mode")),
-        siteAuditMaxPages: parseSiteAuditMaxPages(getString(input.values, "site-audit-max-pages"), "project.create"),
+      await clearResults(requireProject(input, "results.clear", RESULTS_CLEAR_USAGE), {
+        runIds: getStringArray(input.values, "run") ?? [],
+        researchRunIds: getStringArray(input.values, "research-run") ?? [],
+        confirm: getBoolean(input.values, "confirm"),
         format: input.format
       });
     }
   },
   {
-    path: ["project", "update"],
-    usage: "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--add-qualified-alias <name>...] [--remove-qualified-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--dispatch-mode provider=sync|batch...] [--clear-dispatch-mode <provider>...] [--negative-review-max-stars <1-4|default>] [--site-audit-max-pages <1-50000|full>] [--competitor-auto-aliases <off|preview|apply>] [--format json]",
+    path: ["results", "export"],
+    usage: RESULTS_EXPORT_USAGE,
     options: {
-      domain: { type: "string", short: "d" },
-      "owned-domain": multiStringOption(),
-      "add-domain": multiStringOption(),
-      "remove-domain": multiStringOption(),
-      alias: multiStringOption(),
-      "add-alias": multiStringOption(),
-      "remove-alias": multiStringOption(),
-      "add-qualified-alias": multiStringOption(),
-      "remove-qualified-alias": multiStringOption(),
-      country: stringOption(),
-      language: stringOption(),
-      "display-name": stringOption(),
-      provider: multiStringOption(),
-      "all-providers": { type: "boolean" },
-      "provider-model": multiStringOption(),
-      "clear-provider-model": multiStringOption(),
-      "dispatch-mode": multiStringOption(),
-      "clear-dispatch-mode": multiStringOption(),
-      "negative-review-max-stars": stringOption(),
-      "site-audit-max-pages": stringOption(),
-      "competitor-auto-aliases": stringOption()
+      since: stringOption(),
+      until: stringOption(),
+      "include-probes": { type: "boolean", default: false },
+      output: { type: "string", short: "o" }
     },
     run: async (input) => {
-      const name = requireProject(
-        input,
-        "project.update",
-        "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--add-qualified-alias <name>...] [--remove-qualified-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--dispatch-mode provider=sync|batch...] [--clear-dispatch-mode <provider>...] [--negative-review-max-stars <1-4|default>] [--site-audit-max-pages <1-50000|full>] [--competitor-auto-aliases <off|preview|apply>] [--format json]"
-      );
-      const providers = getStringArray(input.values, "provider");
-      const allProviders = getBoolean(input.values, "all-providers");
-      if (allProviders && providers?.length) throw usageError("Error: --all-providers conflicts with --provider");
-      const providerModels = parseProviderModelAssignments(getStringArray(input.values, "provider-model"));
-      const clearProviderModels = getStringArray(input.values, "clear-provider-model") ?? [];
-      for (const provider of clearProviderModels) {
-        if (provider in providerModels) throw usageError(`Error: --provider-model and --clear-provider-model conflict for ${provider}`);
-      }
-      const dispatchModes = parseDispatchModeAssignments(getStringArray(input.values, "dispatch-mode"));
-      const clearDispatchModes = getStringArray(input.values, "clear-dispatch-mode") ?? [];
-      for (const provider of clearDispatchModes) {
-        if (provider in dispatchModes) throw usageError(`Error: --dispatch-mode and --clear-dispatch-mode conflict for ${provider}`);
-      }
-      await updateProjectSettings(name, {
-        displayName: getString(input.values, "display-name"),
-        domain: getString(input.values, "domain"),
-        ownedDomains: getStringArray(input.values, "owned-domain"),
-        addOwnedDomain: getStringArray(input.values, "add-domain"),
-        removeOwnedDomain: getStringArray(input.values, "remove-domain"),
-        aliases: getStringArray(input.values, "alias"),
-        addAlias: getStringArray(input.values, "add-alias"),
-        removeAlias: getStringArray(input.values, "remove-alias"),
-        addQualifiedAlias: getStringArray(input.values, "add-qualified-alias"),
-        removeQualifiedAlias: getStringArray(input.values, "remove-qualified-alias"),
-        country: getString(input.values, "country"),
-        language: getString(input.values, "language"),
-        providers: allProviders ? [] : providers,
-        providerModels,
-        clearProviderModels,
-        dispatchModes,
-        clearDispatchModes,
-        negativeReviewMaxStars: parseNegativeReviewMaxStars(getString(input.values, "negative-review-max-stars")),
-        siteAuditMaxPages: parseSiteAuditMaxPages(getString(input.values, "site-audit-max-pages"), "project.update"),
-        competitorAutoAliases: parseCompetitorAutoAliasMode(getString(input.values, "competitor-auto-aliases")),
-        format: input.format
+      const project2 = requireProject(input, "results export", RESULTS_EXPORT_USAGE);
+      await exportResults(project2, {
+        format: parseResultsExportFormat(getString(input.values, "format")),
+        since: getString(input.values, "since"),
+        until: getString(input.values, "until"),
+        includeProbes: getBoolean(input.values, "include-probes"),
+        output: getString(input.values, "output")
       });
     }
   },
   {
-    path: ["project", "list"],
-    usage: "canonry project list [--format json]",
-    allowPositionals: false,
+    path: ["status"],
+    usage: "canonry status <project> [--format json]",
     run: async (input) => {
-      await listProjects(input.format);
+      const project2 = requireProject(input, "status", "canonry status <project> [--format json]");
+      await showStatus(project2, input.format);
     }
   },
   {
-    path: ["project", "show"],
-    usage: "canonry project show <name> [--format json]",
+    path: ["evidence"],
+    usage: "canonry evidence <project> [--format json]",
     run: async (input) => {
-      const name = requireProject(input, "project.show", "canonry project show <name>");
-      await showProject(name, input.format);
+      const project2 = requireProject(input, "evidence", "canonry evidence <project> [--format json]");
+      await showEvidence(project2, input.format);
     }
   },
   {
-    path: ["project", "delete"],
-    usage: "canonry project delete <name> [--dry-run] [--format json]",
-    supportsDryRun: true,
+    path: ["history"],
+    usage: "canonry history <project> [--limit <1..500>] [--offset <n>] [--since <ISO>] [--action <action>] [--actor <actor>] [--entity-type <type>] [--format json|jsonl]\n       canonry history --all [same filters]",
+    options: {
+      all: { type: "boolean", default: false },
+      limit: stringOption(),
+      offset: stringOption(),
+      since: stringOption(),
+      action: stringOption(),
+      actor: stringOption(),
+      "entity-type": stringOption()
+    },
     run: async (input) => {
-      const name = requireProject(input, "project.delete", "canonry project delete <name> [--dry-run] [--format json]");
-      await deleteProject(name, { dryRun: input.dryRun, format: input.format });
+      const usage = "canonry history <project> [--limit <1..500>] [--offset <n>] [--since <ISO>] [--action <action>] [--actor <actor>] [--entity-type <type>] [--format json|jsonl]\n       canonry history --all [same filters]";
+      const project2 = getBoolean(input.values, "all") ? void 0 : requireProject(input, "history", usage);
+      await showHistory(project2, input.format, {
+        limit: parseHistoryPageOption(input, "limit", usage),
+        offset: parseHistoryPageOption(input, "offset", usage),
+        since: getString(input.values, "since"),
+        action: getString(input.values, "action"),
+        actor: getString(input.values, "actor"),
+        entityType: getString(input.values, "entity-type")
+      });
     }
   },
   {
-    path: ["project", "add-location"],
-    usage: "canonry project add-location <name> --label <label> --city <city> --region <region> --country <country> [--format json]",
+    path: ["export"],
+    usage: "canonry export <project> [--include-results] [--format json]",
     options: {
-      label: stringOption(),
-      city: stringOption(),
-      region: stringOption(),
-      country: stringOption(),
-      timezone: stringOption()
+      "include-results": { type: "boolean", default: false }
     },
     run: async (input) => {
-      const name = requireProject(
-        input,
-        "project.add-location",
-        "canonry project add-location <name> --label <label> --city <city> --region <region> --country <country> [--format json]"
-      );
-      const label = getString(input.values, "label");
-      const city = getString(input.values, "city");
-      const region = getString(input.values, "region");
-      const country = getString(input.values, "country");
-      if (!label || !city || !region || !country) {
-        throw usageError("Error: --label, --city, --region, and --country are all required", {
-          message: "location label, city, region, and country are required",
-          details: {
-            command: "project.add-location",
-            usage: "canonry project add-location <name> --label <label> --city <city> --region <region> --country <country> [--format json]",
-            required: ["label", "city", "region", "country"]
-          }
-        });
-      }
-      await addLocation(name, {
-        label,
-        city,
-        region,
-        country,
-        timezone: getString(input.values, "timezone"),
+      const project2 = requireProject(input, "export", "canonry export <project> [--include-results] [--format json]");
+      await exportProject(project2, {
+        includeResults: getBoolean(input.values, "include-results"),
         format: input.format
       });
     }
   },
   {
-    path: ["project", "locations"],
-    usage: "canonry project locations <name> [--format json]",
-    run: async (input) => {
-      const name = requireProject(input, "project.locations", "canonry project locations <name> [--format json]");
-      await listLocations(name, input.format);
-    }
-  },
-  {
-    path: ["project", "remove-location"],
-    usage: "canonry project remove-location <name> <label> [--format json]",
+    path: ["analytics"],
+    usage: "canonry analytics <project> [--feature metrics|gaps|sources] [--window 7d|30d|90d|all] [--format json]",
+    options: {
+      feature: stringOption(),
+      window: stringOption()
+    },
     run: async (input) => {
-      const name = requireProject(input, "project.remove-location", "canonry project remove-location <name> <label> [--format json]");
-      const label = requirePositional(input, 1, {
-        command: "project.remove-location",
-        usage: "canonry project remove-location <name> <label> [--format json]",
-        message: "project name and location label are required"
+      const project2 = requireProject(input, "analytics", "canonry analytics <project> [--feature metrics|gaps|sources] [--window 7d|30d|90d|all] [--format json]");
+      await showAnalytics(project2, {
+        feature: getString(input.values, "feature"),
+        window: getString(input.values, "window"),
+        format: input.format
       });
-      await removeLocation(name, label, input.format);
     }
   },
   {
-    path: ["project", "set-default-location"],
-    usage: "canonry project set-default-location <name> <label> [--format json]",
-    run: async (input) => {
-      const name = requireProject(input, "project.set-default-location", "canonry project set-default-location <name> <label> [--format json]");
-      const label = requirePositional(input, 1, {
-        command: "project.set-default-location",
-        usage: "canonry project set-default-location <name> <label> [--format json]",
-        message: "project name and location label are required"
-      });
-      await setDefaultLocation(name, label, input.format);
-    }
+    path: ["sources"],
+    usage: SOURCES_USAGE,
+    options: {
+      rank: { type: "boolean", default: false },
+      "by-provider": { type: "boolean", default: false },
+      limit: stringOption(),
+      window: stringOption(),
+      "query-class": stringOption(),
+      "run-id": stringOption(),
+      "include-by-query": stringOption()
+    },
+    run: async (input) => {
+      const project2 = requireProject(input, "sources", SOURCES_USAGE);
+      await showSources(project2, {
+        rank: getBoolean(input.values, "rank"),
+        byProvider: getBoolean(input.values, "by-provider"),
+        limit: parseIntegerOption(input, "limit", {
+          message: "--limit must be an integer",
+          usage: SOURCES_USAGE,
+          command: "sources"
+        }),
+        window: getString(input.values, "window"),
+        runId: getString(input.values, "run-id"),
+        queryClass: parseSourcesQueryClass(getString(input.values, "query-class")),
+        includeByQuery: parseSourcesIncludeByQuery(getString(input.values, "include-by-query")),
+        format: input.format
+      });
+    }
   },
   {
-    path: ["project"],
-    usage: "canonry project <create|update|list|show|delete|add-location|locations|remove-location|set-default-location> [args]",
+    path: ["apply"],
+    usage: "canonry apply <file...> [--format json]",
     run: async (input) => {
-      unknownSubcommand(input.positionals[0], {
-        command: "project",
-        usage: "canonry project <create|update|list|show|delete|add-location|locations|remove-location|set-default-location> [args]",
-        available: ["create", "update", "list", "show", "delete", "add-location", "locations", "remove-location", "set-default-location"]
-      });
+      if (input.positionals.length === 0) {
+        throw usageError("Error: at least one file path is required\nUsage: canonry apply <file...> [--format json]", {
+          message: "at least one file path is required",
+          details: {
+            command: "apply",
+            usage: "canonry apply <file...> [--format json]"
+          }
+        });
+      }
+      await applyConfigs(input.positionals, input.format);
     }
   }
 ];
-function parseDispatchModeAssignments(assignments) {
-  const result = {};
-  for (const assignment of assignments ?? []) {
-    const separator = assignment.indexOf("=");
-    const provider = separator === -1 ? "" : assignment.slice(0, separator).trim();
-    const mode = providerDispatchModeSchema.safeParse(separator === -1 ? "" : assignment.slice(separator + 1).trim().toLowerCase());
-    if (!provider || !mode.success) throw usageError(`Error: --dispatch-mode must use provider=sync or provider=batch (received ${assignment})`);
-    if (provider in result) throw usageError(`Error: duplicate --dispatch-mode assignment for ${provider}`);
-    result[provider] = mode.data;
-  }
-  return result;
+
+// src/commands/project.ts
+function getClient23() {
+  return createApiClient();
 }
-function parseProviderModelAssignments(assignments) {
-  const result = {};
-  for (const assignment of assignments ?? []) {
-    const separator = assignment.indexOf("=");
-    const provider = separator === -1 ? "" : assignment.slice(0, separator).trim();
-    const model = separator === -1 ? "" : assignment.slice(separator + 1).trim();
-    if (!provider || !model) throw usageError(`Error: --provider-model must use provider=model (received ${assignment})`);
-    if (provider in result) throw usageError(`Error: duplicate --provider-model assignment for ${provider}`);
-    result[provider] = model;
+async function createProject(name, opts) {
+  const client = getClient23();
+  const result = await client.putProject(name, {
+    displayName: opts.displayName,
+    canonicalDomain: opts.domain,
+    ownedDomains: opts.ownedDomains ?? [],
+    aliases: normalizeProjectAliases(opts.displayName, opts.aliases ?? []),
+    ...opts.qualifiedAliases?.length ? { qualifiedAliases: opts.qualifiedAliases } : {},
+    country: opts.country,
+    language: opts.language,
+    providers: opts.providers ?? [],
+    providerModels: opts.providerModels ?? {},
+    ...opts.providerDispatchModes && Object.keys(opts.providerDispatchModes).length > 0 ? { providerDispatchModes: opts.providerDispatchModes } : {},
+    // Sent only when given: this PUT also re-runs over an existing project,
+    // and an omitted budget keeps the stored one.
+    ...opts.siteAuditMaxPages !== void 0 ? { siteAuditMaxPages: opts.siteAuditMaxPages } : {}
+  });
+  warnDroppedDispatchModes(opts.providerDispatchModes ?? {}, result);
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
   }
-  return result;
+  console.log(`Project created: ${result.name} (${result.id})`);
 }
-function parseNegativeReviewMaxStars(raw) {
-  if (raw === void 0) return void 0;
-  if (raw === "default") return null;
-  const parsed = gbpNegativeReviewMaxStarsSchema.safeParse(Number(raw));
-  if (!parsed.success) {
-    throw usageError('Error: --negative-review-max-stars must be 1, 2, 3, 4, or "default" (3)', {
-      message: '--negative-review-max-stars must be 1-4 or "default"',
-      details: { command: "project.update", value: raw }
-    });
+function warnDroppedDispatchModes(sent, result) {
+  const kept = result.providerDispatchModes ?? {};
+  const dropped = Object.keys(sent).filter((provider) => !(provider in kept));
+  if (dropped.length > 0) {
+    console.error(`Warning: Dropped dispatch mode for engine(s) the project does not measure: ${dropped.join(", ")}`);
   }
-  return parsed.data;
 }
-function parseSiteAuditMaxPages(raw, command) {
-  if (raw === void 0) return void 0;
-  const value = raw.trim();
-  if (value.toLowerCase() === "full") return null;
-  const parsed = /^\d+$/.test(value) ? siteAuditPageBudgetSchema.safeParse(Number(value)) : void 0;
-  if (!parsed?.success) {
-    throw usageError(`Error: --site-audit-max-pages must be a whole number of pages from 1 to ${SITE_AUDIT_MAX_PAGE_LIMIT}, or "full" for the full site`, {
-      message: `--site-audit-max-pages must be 1-${SITE_AUDIT_MAX_PAGE_LIMIT} or "full"`,
-      details: { command, option: "site-audit-max-pages", value: raw }
-    });
+async function listProjects(format) {
+  const client = getClient23();
+  const projects2 = await client.listProjects();
+  if (format === "json") {
+    console.log(JSON.stringify(projects2, null, 2));
+    return;
   }
-  return parsed.data;
-}
-function parseCompetitorAutoAliasMode(raw) {
-  if (raw === void 0) return void 0;
-  const parsed = competitorAutoAliasModeSchema.safeParse(raw.trim().toLowerCase());
-  if (!parsed.success) {
-    throw usageError("Error: --competitor-auto-aliases must be off, preview or apply", {
-      message: "--competitor-auto-aliases must be off, preview or apply",
-      details: { command: "project.update", option: "competitor-auto-aliases", value: raw }
-    });
+  if (format === "jsonl") {
+    emitJsonl(projects2);
+    return;
   }
-  return parsed.data;
-}
-
-// src/commands/organic-evidence.ts
-async function showOrganicEvidence(project2, opts) {
-  const data = await createApiClient().getOrganicEvidence(project2, opts.period);
-  if (isMachineFormat(opts.format)) {
-    console.log(JSON.stringify(data, null, 2));
+  if (projects2.length === 0) {
+    console.log("No projects found.");
     return;
   }
-  printOrganicEvidence(project2, data);
+  console.log("Projects:\n");
+  const nameWidth = Math.max(4, ...projects2.map((p) => p.name.length));
+  const domainLabel = (p) => {
+    const extra = Math.max(0, effectiveDomains(p).length - 1);
+    return extra > 0 ? `${p.canonicalDomain} (+${extra})` : p.canonicalDomain;
+  };
+  const domainWidth = Math.max(6, ...projects2.map((p) => domainLabel(p).length));
+  console.log(
+    `  ${"NAME".padEnd(nameWidth)}  ${"DOMAIN".padEnd(domainWidth)}  COUNTRY  LANGUAGE`
+  );
+  console.log(`  ${"\u2500".repeat(nameWidth)}  ${"\u2500".repeat(domainWidth)}  \u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+  for (const p of projects2) {
+    console.log(
+      `  ${p.name.padEnd(nameWidth)}  ${domainLabel(p).padEnd(domainWidth)}  ${p.country.padEnd(7)}  ${p.language}`
+    );
+  }
 }
-function formatCounts(clicks, impressions) {
-  return `${clicks} clicks / ${impressions} impressions`;
+function storedQualifiedAliases(project2) {
+  return project2.qualifiedAliases ?? [];
 }
-function printOrganicEvidence(project2, data) {
-  const asOf = data.asOfDate ? ` through ${data.asOfDate}` : "";
-  console.log(`Organic evidence: ${project2}  (${data.periodDays} days${asOf})`);
-  console.log(`Coverage: GSC ${data.coverage.gsc ? "yes" : "no"} \xB7 GA4 ${data.coverage.ga4 ? "yes" : "no"} \xB7 server ${data.coverage.server ? "yes" : "no"} \xB7 AI visibility ${data.coverage.visibility ? "yes" : "no"}`);
-  if (data.gsc) {
-    console.log(`Google Search: ${formatCounts(data.gsc.propertyTotals.clicks, data.gsc.propertyTotals.impressions)} (named non-brand: ${formatCounts(data.gsc.namedNonBrand.clicks, data.gsc.namedNonBrand.impressions)})`);
+async function showProject(name, format) {
+  const client = getClient23();
+  const project2 = await client.getProject(name);
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify(project2, null, 2));
+    return;
   }
-  if (data.ga4) console.log(`GA4 organic: ${data.ga4.organicSessions} sessions`);
-  if (data.gaAiReferrals) console.log(`GA4 AI referrals: ${data.gaAiReferrals.organicSessions} organic, ${data.gaAiReferrals.paidSessions} paid sessions`);
-  if (data.server) {
-    const s = data.server;
-    const fetchTotal = s.userFetchHits.verified + s.userFetchHits.claimedUnverified + s.userFetchHits.unknownAiLike;
-    console.log(`Server AI: ${s.crawlerHits.verified} verified + ${s.crawlerHits.claimedUnverified} claimed + ${s.crawlerHits.unknownAiLike} heuristic crawls; ${fetchTotal} user-agent fetches (${s.userFetchHits.verified} verified, ${s.userFetchHits.claimedUnverified} claimed, ${s.userFetchHits.unknownAiLike} heuristic); ${s.referralSessions.organic} organic referrals, ${s.referralSessions.paid} paid, ${s.referralSessions.unknown} unclassified`);
+  console.log(`Project: ${project2.displayName ?? project2.name}
+`);
+  console.log(`  Name:             ${project2.name}`);
+  console.log(`  ID:               ${project2.id}`);
+  console.log(`  Domain:           ${project2.canonicalDomain}`);
+  const secondaryDomains = effectiveDomains(project2).slice(1);
+  if (secondaryDomains.length > 0) {
+    console.log(`  Owned domains:    ${secondaryDomains.join(", ")}`);
   }
-  if (data.visibility) {
-    const v = data.visibility;
-    console.log(`Latest AI visibility: ${v.mentionedPairs}/${v.answerPairs} mentioned, ${v.citedPairs}/${v.answerPairs} cited (${Math.floor(v.ageDays)}d old)`);
+  if (project2.aliases && project2.aliases.length > 0) {
+    console.log(`  Aliases:          ${project2.aliases.join(", ")}`);
   }
-  if (data.findings.length > 0) {
-    console.log("\nFindings:");
-    for (const finding of data.findings) console.log(`- ${finding.title}: ${finding.detail}`);
+  const qualifiedAliases = storedQualifiedAliases(project2);
+  if (qualifiedAliases.length > 0) {
+    console.log(`  Qualified:        ${qualifiedAliases.join(", ")} (sentiment)`);
   }
-  if (data.limitations.length > 0) {
-    console.log("\nLimitations:");
-    for (const limitation of data.limitations) console.log(`- ${limitation.detail}`);
+  console.log(`  Country:          ${project2.country}`);
+  console.log(`  Language:         ${project2.language}`);
+  console.log(`  Config source:    ${project2.configSource}`);
+  console.log(`  Config revision:  ${project2.configRevision}`);
+  console.log(`  Providers:        ${(project2.providers ?? []).length > 0 ? project2.providers.join(", ") : "all configured"}`);
+  const providerModels = Object.entries(project2.providerModels ?? {});
+  console.log(`  Model overrides:  ${providerModels.length > 0 ? providerModels.map(([provider, model]) => `${provider}=${model}`).join(", ") : "(none; instance settings inherited)"}`);
+  const dispatchModes = Object.entries(project2.providerDispatchModes ?? {}).sort(([left], [right]) => left.localeCompare(right));
+  console.log(`  Dispatch modes:   ${dispatchModes.length > 0 ? `${dispatchModes.map(([provider, mode]) => `${provider}=${mode}`).join(", ")} (scheduled sweeps; others sync)` : "(none; every provider runs sync)"}`);
+  console.log(`  Negative reviews: ${resolveNegativeReviewMaxStars(project2.negativeReviewMaxStars)} stars or fewer${project2.negativeReviewMaxStars == null ? " (default)" : ""}`);
+  if (project2.siteAuditMaxPages !== void 0) {
+    console.log(`  Site Health page budget: ${formatSiteAuditPageBudget(project2.siteAuditMaxPages)}`);
   }
-}
-
-// src/cli-commands/organic-evidence.ts
-var USAGE3 = "canonry organic-evidence <project> [--period 60|90] [--format json|jsonl]";
-function parsePeriod(value) {
-  if (value === void 0) return void 0;
-  if (value === "60" || value === "90") return Number(value);
-  throw usageError(`Error: --period must be 60 or 90
-
-Usage: ${USAGE3}`);
-}
-var ORGANIC_EVIDENCE_CLI_COMMANDS = [
-  {
-    path: ["organic-evidence"],
-    usage: USAGE3,
-    options: { period: stringOption() },
-    run: async (input) => {
-      const project2 = requireProject(input, "organic-evidence", USAGE3);
-      await showOrganicEvidence(project2, {
-        period: parsePeriod(getString(input.values, "period")),
-        format: input.format
-      });
-    }
+  if (project2.competitorAutoAliases !== void 0) {
+    console.log(`  Competitor auto aliases: ${formatCompetitorAutoAliasMode(project2.competitorAutoAliases)}`);
   }
-];
-
-// src/commands/run.ts
-function getClient23() {
-  return createApiClient();
+  console.log(`  Tags:             ${project2.tags.length > 0 ? project2.tags.join(", ") : "(none)"}`);
+  const labelEntries = Object.entries(project2.labels);
+  console.log(`  Labels:           ${labelEntries.length > 0 ? labelEntries.map(([k, v]) => `${k}=${v}`).join(", ") : "(none)"}`);
+  if (project2.createdAt) console.log(`  Created:          ${project2.createdAt}`);
+  if (project2.updatedAt) console.log(`  Updated:          ${project2.updatedAt}`);
 }
-var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
-function throwIfWaitedRunFailed(waited) {
-  const failed = waited.filter((r) => r.status === RunStatuses.failed);
-  if (failed.length === 0) return;
-  const reason = (r) => r.error ? formatRunErrorOneLine(r.error) : null;
-  const label = (r) => [r.project, r.location ? `(${r.location})` : null, `run ${r.runId}`].filter(Boolean).join(" ");
-  const message = waited.length === 1 ? `Run ${failed[0].runId} failed${reason(failed[0]) ? `: ${reason(failed[0])}` : ""}` : `${failed.length} of ${waited.length} runs failed: ${failed.map((r) => `${label(r)}${reason(r) ? `: ${reason(r)}` : ""}`).join("; ")}`;
-  throw new CliError({
-    code: "RUN_FAILED",
-    message,
-    exitCode: EXIT_SYSTEM_ERROR,
-    details: {
-      waitedRunCount: waited.length,
-      failedRuns: failed.map((r) => ({
-        runId: r.runId,
-        ...r.project ? { project: r.project } : {},
-        ...r.location ? { location: r.location } : {},
-        error: reason(r)
-      }))
-    }
-  });
+function formatCompetitorAutoAliasMode(mode) {
+  if (mode === "apply") return "apply (names detected after each sweep are stored and counted)";
+  if (mode === "off") return "off (no detection after sweeps)";
+  return "preview (detected after each sweep and logged; nothing stored)";
 }
-async function triggerRun(project2, opts) {
+async function updateProjectSettings(name, opts) {
   const client = getClient23();
-  const body = {};
-  if (opts?.provider) {
-    const providerInputs = opts.provider.split(",").map((s) => s.trim()).filter(Boolean);
-    const resolved = providerInputs.flatMap((p) => resolveProviderInput(p));
-    body.providers = resolved.length > 0 ? resolved : providerInputs;
+  const project2 = await client.getProject(name);
+  let ownedDomains = opts.ownedDomains ?? project2.ownedDomains ?? [];
+  if (opts.addOwnedDomain) {
+    const toAdd = opts.addOwnedDomain.filter((d) => !ownedDomains.includes(d));
+    ownedDomains = [...ownedDomains, ...toAdd];
   }
-  if (opts?.queries?.length) {
-    body.queries = opts.queries;
+  if (opts.removeOwnedDomain) {
+    const toRemove = new Set(opts.removeOwnedDomain);
+    ownedDomains = ownedDomains.filter((d) => !toRemove.has(d));
   }
-  if (opts?.groups?.length || opts?.targets?.length) {
-    body.measurementScope = {
-      ...opts.groups?.length ? { groups: opts.groups } : {},
-      ...opts.targets?.length ? { targets: opts.targets } : {}
-    };
+  const nextDisplayName = opts.displayName ?? project2.displayName ?? project2.name;
+  let aliases = opts.aliases ?? project2.aliases ?? [];
+  if (opts.addAlias) {
+    const existingKeys = new Set(aliases.map((a) => a.toLowerCase()));
+    const toAdd = opts.addAlias.filter((a) => !existingKeys.has(a.toLowerCase()));
+    aliases = [...aliases, ...toAdd];
   }
-  if (opts?.location) {
-    body.location = opts.location;
+  if (opts.removeAlias) {
+    const toRemove = new Set(opts.removeAlias.map((a) => a.toLowerCase()));
+    aliases = aliases.filter((a) => !toRemove.has(a.toLowerCase()));
   }
-  if (opts?.allLocations) {
-    body.allLocations = true;
+  const nextAliases = normalizeProjectAliases(nextDisplayName, aliases);
+  const touchesQualified = (opts.addQualifiedAlias?.length ?? 0) > 0 || (opts.removeQualifiedAlias?.length ?? 0) > 0;
+  let qualifiedAliases = resolveProjectQualifiedAliases(
+    { displayName: nextDisplayName, aliases: nextAliases },
+    storedQualifiedAliases(project2)
+  ).value;
+  if (opts.addQualifiedAlias) {
+    const existingKeys = new Set(qualifiedAliases.map((alias) => alias.toLowerCase()));
+    for (const alias of opts.addQualifiedAlias) {
+      if (existingKeys.has(alias.toLowerCase())) continue;
+      existingKeys.add(alias.toLowerCase());
+      qualifiedAliases = [...qualifiedAliases, alias];
+    }
   }
-  if (opts?.noLocation) {
-    body.noLocation = true;
+  if (opts.removeQualifiedAlias) {
+    const toRemove = new Set(opts.removeQualifiedAlias.map((alias) => alias.toLowerCase()));
+    qualifiedAliases = qualifiedAliases.filter((alias) => !toRemove.has(alias.toLowerCase()));
   }
-  if (opts?.probe) {
-    body.trigger = "probe";
+  const providerModels = { ...project2.providerModels ?? {}, ...opts.providerModels ?? {} };
+  for (const provider of opts.clearProviderModels ?? []) delete providerModels[provider];
+  const nextProviders = opts.providers ?? project2.providers ?? [];
+  if (nextProviders.length > 0) {
+    const requested = Object.keys(opts.providerModels ?? {}).filter((p) => !nextProviders.includes(p));
+    if (requested.length > 0) {
+      throw usageError(
+        `Error: --provider-model set for ${requested.join(", ")}, which ${requested.length > 1 ? "are" : "is"} not a selected engine for "${name}"`,
+        {
+          message: "provider-model set for a provider the project does not run",
+          details: { command: "project.update", project: name, providers: nextProviders, unselected: requested }
+        }
+      );
+    }
   }
-  if (opts?.dispatchMode) {
-    body.dispatchMode = opts.dispatchMode;
+  const touchesDispatch = Object.keys(opts.dispatchModes ?? {}).length > 0 || (opts.clearDispatchModes ?? []).length > 0;
+  const providerDispatchModes = { ...project2.providerDispatchModes ?? {}, ...opts.dispatchModes ?? {} };
+  for (const provider of opts.clearDispatchModes ?? []) delete providerDispatchModes[provider];
+  const result = await client.putProject(name, {
+    displayName: nextDisplayName,
+    canonicalDomain: opts.domain ?? project2.canonicalDomain,
+    ownedDomains,
+    aliases: nextAliases,
+    ...touchesQualified ? { qualifiedAliases } : {},
+    country: opts.country ?? project2.country,
+    language: opts.language ?? project2.language,
+    tags: project2.tags,
+    labels: project2.labels,
+    providers: opts.providers ?? project2.providers,
+    providerModels,
+    ...touchesDispatch ? { providerDispatchModes } : {},
+    locations: project2.locations,
+    defaultLocation: project2.defaultLocation,
+    autoExtractBacklinks: project2.autoExtractBacklinks,
+    // Sent only when asked for: the server keeps the stored threshold when the
+    // field is absent, so a stale read cannot overwrite a newer setting.
+    ...opts.negativeReviewMaxStars !== void 0 ? { negativeReviewMaxStars: opts.negativeReviewMaxStars } : {},
+    // Same for the page budget: never echoed from the read above, so an edit
+    // that does not touch it cannot overwrite a newer one or send a stray null.
+    ...opts.siteAuditMaxPages !== void 0 ? { siteAuditMaxPages: opts.siteAuditMaxPages } : {},
+    // Same for the detection mode.
+    ...opts.competitorAutoAliases !== void 0 ? { competitorAutoAliases: opts.competitorAutoAliases } : {}
+  });
+  warnDroppedDispatchModes(touchesDispatch ? providerDispatchModes : project2.providerDispatchModes ?? {}, result);
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
   }
-  if (opts?.force) {
-    body.force = true;
+  console.log(`Project updated: ${result.name}`);
+  const dropped = Object.keys(providerModels).filter((provider) => !(provider in result.providerModels));
+  if (dropped.length > 0) {
+    console.log(`  Dropped model override for deselected engine(s): ${dropped.join(", ")}`);
   }
-  const response = await client.triggerRun(project2, body);
-  if (Array.isArray(response)) {
-    const locationRuns = response;
-    if (isMachineFormat(opts?.format)) {
-      if (opts?.wait) {
-        const finals = await Promise.all(
-          locationRuns.map(async (r) => !r.id || r.status === "conflict" ? null : pollRun2(client, r.id, false))
-        );
-        console.log(JSON.stringify(locationRuns.map((r, i) => finals[i] ? { ...r, ...finals[i] } : r), null, 2));
-        throwIfWaitedRunFailed(locationRuns.flatMap((r, i) => {
-          const final = finals[i];
-          return final ? [{ runId: final.id, status: final.status, project: project2, location: r.location ?? null, error: final.error }] : [];
-        }));
-      } else {
-        console.log(JSON.stringify(locationRuns, null, 2));
-      }
+}
+async function deleteProject(name, opts) {
+  const client = getClient23();
+  const isJson = isMachineFormat(opts?.format);
+  if (opts?.dryRun) {
+    const preview = await client.previewProjectDelete(name);
+    if (isJson) {
+      console.log(JSON.stringify({ dryRun: true, ...preview }, null, 2));
       return;
     }
-    console.log(`Triggered ${locationRuns.length} location sweep(s) \u2014 ${locationRuns.length}\xD7 API calls:
-`);
-    console.log("  LOCATION         RUN ID                                STATUS");
-    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");
-    for (const r of locationRuns) {
-      const loc = (r.location ?? "(unknown)").padEnd(15);
-      const id = (r.id ?? "(conflict)").padEnd(36);
-      console.log(`  ${loc}  ${id}  ${r.status}`);
-    }
-    if (opts?.wait) {
-      const pending = locationRuns.filter((r) => r.id && r.status !== "conflict" && !TERMINAL_STATUSES.has(r.status));
-      const errors = /* @__PURE__ */ new Map();
-      if (pending.length > 0) {
-        process.stderr.write(`Waiting for ${pending.length} run(s)`);
-        const batchWaits = /* @__PURE__ */ new Map();
-        await Promise.all(
-          pending.map(async (r) => {
-            const final = await pollRun2(client, r.id);
-            r.status = final.status;
-            errors.set(r.id, final.error);
-            const waiting = batchWaitLine(final);
-            if (waiting) batchWaits.set(r.id, waiting);
-          })
-        );
-        process.stderr.write("\n");
-        console.log("\nFinal statuses:");
-        for (const r of locationRuns) {
-          const loc = (r.location ?? "(unknown)").padEnd(15);
-          console.log(`  ${loc}  ${r.status}`);
-        }
-        if (batchWaits.size > 0) console.log("");
-        for (const r of locationRuns) {
-          const waiting = batchWaits.get(r.id);
-          if (waiting) console.log(`  ${r.location ?? "(unknown)"}: ${waiting}`);
-        }
-      }
-      throwIfWaitedRunFailed(locationRuns.filter((r) => r.id && r.status !== "conflict").map((r) => ({ runId: r.id, status: r.status, project: project2, location: r.location ?? null, error: errors.get(r.id) })));
-    }
+    const { cascadeRows: cr, detachedRows: dr } = preview;
+    console.log(`Project delete preview for "${name}":`);
+    console.log(`  Cascade-deletes:`);
+    console.log(`    queries:      ${cr.queries}`);
+    console.log(`    competitors:  ${cr.competitors}`);
+    console.log(`    runs:         ${cr.runs}`);
+    console.log(`    snapshots:    ${cr.snapshots}`);
+    console.log(`    insights:     ${cr.insights}`);
+    console.log(`  Detached (project_id set to NULL):`);
+    console.log(`    audit_log:    ${dr.auditLog}`);
+    console.log(``);
+    console.log(`No DB writes performed. Re-run without --dry-run to delete.`);
     return;
   }
-  const run = response;
-  if (opts?.wait && run.id && !TERMINAL_STATUSES.has(run.status)) {
-    const showProgress = !isMachineFormat(opts?.format);
-    if (showProgress) process.stderr.write(`Run ${run.id} started`);
-    const result = await pollRun2(client, run.id, showProgress);
-    if (isMachineFormat(opts?.format)) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      process.stderr.write("\n");
-      printRunDetail(result);
-      const waiting = batchWaitLine(result);
-      if (waiting) console.log(`
-${waiting}`);
-    }
-    throwIfWaitedRunFailed([{ runId: result.id, status: result.status, project: project2, error: result.error }]);
+  await client.deleteProject(name);
+  if (isJson) {
+    console.log(JSON.stringify({ name, deleted: true }, null, 2));
     return;
   }
-  if (opts?.wait && (TERMINAL_STATUSES.has(run.status) || !run.id)) {
-    const result = run.id ? await client.getRun(run.id) : run;
-    if (isMachineFormat(opts?.format)) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      printRunDetail(result);
-    }
-    throwIfWaitedRunFailed([{ runId: result.id, status: result.status, project: project2, error: result.error }]);
+  console.log(`Project deleted: ${name}`);
+}
+async function addLocation(project2, opts) {
+  const client = getClient23();
+  const location = await client.addLocation(project2, {
+    label: opts.label,
+    city: opts.city,
+    region: opts.region,
+    country: opts.country,
+    timezone: opts.timezone
+  });
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(location, null, 2));
     return;
   }
-  if (isMachineFormat(opts?.format)) {
-    console.log(JSON.stringify(run, null, 2));
+  console.log(`Location added: ${opts.label} (${opts.city}, ${opts.region}, ${opts.country})`);
+}
+async function listLocations(project2, format) {
+  const client = getClient23();
+  const result = await client.listLocations(project2);
+  if (format === "json") {
+    console.log(JSON.stringify(result, null, 2));
     return;
   }
-  console.log(`Run created: ${run.id}`);
-  console.log(`  Kind:   ${run.kind}`);
-  console.log(`  Status: ${run.status}`);
-  if (opts?.provider) {
-    console.log(`  Provider: ${opts.provider}`);
-  }
-}
-async function triggerRunAll(opts) {
-  const client = getClient23();
-  const projects2 = await client.listProjects();
-  if (projects2.length === 0) {
-    if (isMachineFormat(opts?.format)) {
-      console.log("[]");
-    } else {
-      console.log("No projects found.");
-    }
+  if (format === "jsonl") {
+    emitJsonl(result.locations.map((loc) => ({
+      project: project2,
+      isDefault: loc.label === result.defaultLocation,
+      ...loc
+    })));
     return;
   }
-  const baseBody = {};
-  if (opts?.provider) {
-    const providerInputs = opts.provider.split(",").map((s) => s.trim()).filter(Boolean);
-    const resolved = providerInputs.flatMap((p) => resolveProviderInput(p));
-    baseBody.providers = resolved.length > 0 ? resolved : providerInputs;
-  }
-  if (opts?.allLocations) {
-    baseBody.allLocations = true;
-  }
-  if (opts?.noLocation) {
-    baseBody.noLocation = true;
-  }
-  if (opts?.dispatchMode) {
-    baseBody.dispatchMode = opts.dispatchMode;
-  }
-  if (opts?.force) {
-    baseBody.force = true;
-  }
-  const results = [];
-  for (const p of projects2) {
-    const body = { ...baseBody };
-    if (body.allLocations && p.locations.length === 0) {
-      delete body.allLocations;
-    }
-    try {
-      const response = await client.triggerRun(p.name, body);
-      const dispatched = Array.isArray(response) ? response : [response];
-      for (const r of dispatched) {
-        results.push({
-          project: p.name,
-          runId: r.id,
-          status: r.status,
-          location: r.location ?? null
-        });
-      }
-    } catch (err) {
-      const msg = describeError(err);
-      results.push({ project: p.name, runId: "", status: "error", location: null, error: msg });
-    }
-  }
-  const errors = /* @__PURE__ */ new Map();
-  const batchWaits = /* @__PURE__ */ new Map();
-  if (opts?.wait) {
-    const pending = results.filter((r) => r.runId && !TERMINAL_STATUSES.has(r.status));
-    if (pending.length > 0) {
-      const showProgress = !isMachineFormat(opts?.format);
-      if (showProgress) process.stderr.write(`Waiting for ${pending.length} run(s)`);
-      await Promise.all(pending.map(async (r) => {
-        const final = await pollRun2(client, r.runId, showProgress);
-        r.status = final.status;
-        errors.set(r.runId, final.error);
-        const waiting = batchWaitLine(final);
-        if (waiting) batchWaits.set(r.runId, waiting);
-      }));
-      if (showProgress) process.stderr.write("\n");
-    }
-  }
-  const waited = results.filter((r) => r.runId).map((r) => ({ runId: r.runId, status: r.status, project: r.project, location: r.location, error: errors.get(r.runId) }));
-  if (isMachineFormat(opts?.format)) {
-    console.log(JSON.stringify(results, null, 2));
-    if (opts?.wait) throwIfWaitedRunFailed(waited);
+  if (result.locations.length === 0) {
+    console.log(`No locations configured for "${project2}".`);
     return;
   }
-  const showLocationColumn = results.some((r) => r.location !== null);
-  const projectCount = new Set(results.map((r) => r.project)).size;
-  console.log(`Triggered ${results.length} run(s) across ${projectCount} project(s):
+  console.log(`Locations for "${project2}" (${result.locations.length}):
 `);
-  if (showLocationColumn) {
-    console.log("  PROJECT                          LOCATION         RUN ID                                STATUS");
-    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");
-    for (const r of results) {
-      const proj = r.project.padEnd(31);
-      const loc = (r.location ?? "\u2014").padEnd(15);
-      const id = (r.runId || "(failed)").padEnd(36);
-      console.log(`  ${proj}  ${loc}  ${id}  ${r.status}`);
-    }
-  } else {
-    console.log("  PROJECT                          RUN ID                                STATUS");
-    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");
-    for (const r of results) {
-      const proj = r.project.padEnd(31);
-      const id = (r.runId || "(failed)").padEnd(36);
-      console.log(`  ${proj}  ${id}  ${r.status}`);
-    }
+  console.log("  LABEL            CITY                 REGION               COUNTRY  DEFAULT");
+  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");
+  for (const loc of result.locations) {
+    const isDefault = loc.label === result.defaultLocation ? "  *" : "";
+    console.log(
+      `  ${loc.label.padEnd(15)}  ${loc.city.padEnd(19)}  ${loc.region.padEnd(19)}  ${loc.country.padEnd(7)}${isDefault}`
+    );
   }
-  if (batchWaits.size > 0) console.log("");
-  for (const r of results) {
-    const waiting = batchWaits.get(r.runId);
-    if (waiting) console.log(`  ${r.location ? `${r.project} (${r.location})` : r.project}: ${waiting}`);
+  if (result.defaultLocation) {
+    console.log(`
+  Default: ${result.defaultLocation}`);
   }
-  if (opts?.wait) throwIfWaitedRunFailed(waited);
 }
-async function cancelRun(project2, runId, format) {
+async function removeLocation(project2, label, format) {
   const client = getClient23();
-  let targetId = runId;
-  if (!targetId) {
-    const runs2 = await client.listRuns(project2);
-    const activeRuns = runs2.filter((r) => r.status === "queued" || r.status === "running");
-    if (activeRuns.length > 1) {
-      const candidates = activeRuns.map(({ id, kind, status }) => ({ id, kind, status }));
-      throw new CliError({
-        code: "MULTIPLE_ACTIVE_RUNS",
-        message: `Multiple active runs found for project "${project2}". Specify a run ID.`,
-        displayMessage: `Error: Multiple active runs found for project "${project2}". Specify a run ID.
-` + candidates.map((r) => `  ${r.id}  ${r.kind}  ${r.status}`).join("\n") + `
-To cancel by ID: canonry run cancel ${project2} <run-id>`,
-        details: {
-          project: project2,
-          activeRuns: candidates,
-          suggestedCommands: [`canonry run cancel ${project2} <run-id>`]
-        }
-      });
-    }
-    const active = activeRuns[0];
-    if (!active) {
-      throw new CliError({
-        code: "NO_ACTIVE_RUN",
-        message: `No active run found for project "${project2}"`,
-        displayMessage: `Error: canonry run cancel "${project2}" \u2014 no active run found (status must be queued or running).
-Check run status : canonry status ${project2}
-To cancel by ID  : canonry run cancel ${project2} <run-id>`,
-        details: {
-          project: project2,
-          allowedStatuses: ["queued", "running"],
-          suggestedCommands: [
-            `canonry status ${project2}`,
-            `canonry run cancel ${project2} <run-id>`
-          ]
-        }
-      });
-    }
-    targetId = active.id;
-  }
-  const result = await client.cancelRun(targetId);
+  await client.removeLocation(project2, label);
   if (isMachineFormat(format)) {
-    console.log(JSON.stringify(result, null, 2));
+    console.log(JSON.stringify({ project: project2, label, removed: true }, null, 2));
     return;
   }
-  console.log(`Run ${result.id} cancelled.`);
+  console.log(`Location removed: ${label}`);
 }
-async function showRun(id, format) {
+async function setDefaultLocation(project2, label, format) {
   const client = getClient23();
-  const run = await client.getRun(id);
+  const result = await client.setDefaultLocation(project2, label);
   if (isMachineFormat(format)) {
-    console.log(JSON.stringify(run, null, 2));
-    return;
-  }
-  printRunDetail(run);
-}
-async function listRuns(project2, opts) {
-  const client = getClient23();
-  const runs2 = await client.listRuns(project2, opts?.limit, opts?.kind, opts?.status, opts?.excludeKind, opts?.excludeKinds);
-  if (opts?.format === "json") {
-    console.log(JSON.stringify(runs2, null, 2));
-    return;
-  } else if (opts?.format === "jsonl") {
-    emitJsonl(runs2.map((run) => ({ project: project2, ...run })));
-    return;
-  }
-  if (runs2.length === 0) {
-    console.log(`No runs found for "${project2}".`);
+    console.log(JSON.stringify({ project: project2, ...result }, null, 2));
     return;
   }
-  console.log(`Runs for "${project2}" (${runs2.length}):
-`);
-  console.log("  ID                                    STATUS      KIND                TRIGGER    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");
-  for (const run of runs2) {
-    console.log(
-      `  ${run.id}  ${run.status.padEnd(10)}  ${run.kind.padEnd(18)}  ${run.trigger.padEnd(9)}  ${run.createdAt}`
-    );
-  }
+  console.log(`Default location set to: ${label}`);
 }
-var POLL_TIMEOUT_MS3 = 10 * 60 * 1e3;
-async function pollRun2(client, runId, showProgress = true) {
-  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_MS3 / 1e3}s`);
+
+// src/cli-commands/project.ts
+var PROJECT_CLI_COMMANDS = [
+  {
+    path: ["project", "create"],
+    usage: "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--qualified-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--dispatch-mode provider=sync|batch...] [--site-audit-max-pages <1-50000|full>] [--format json]",
+    help: "Create a project. Pass --domain for the public site to scan. Provider credentials are not required for Page Health.",
+    options: {
+      domain: { type: "string", short: "d" },
+      "owned-domain": multiStringOption(),
+      alias: multiStringOption(),
+      "qualified-alias": multiStringOption(),
+      country: stringOption(),
+      language: stringOption(),
+      "display-name": stringOption(),
+      provider: multiStringOption(),
+      "provider-model": multiStringOption(),
+      "dispatch-mode": multiStringOption(),
+      "site-audit-max-pages": stringOption()
+    },
+    run: async (input) => {
+      const name = requireProject(
+        input,
+        "project.create",
+        "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--qualified-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--dispatch-mode provider=sync|batch...] [--site-audit-max-pages <1-50000|full>] [--format json]"
+      );
+      await createProject(name, {
+        domain: getString(input.values, "domain") ?? name,
+        ownedDomains: getStringArray(input.values, "owned-domain") ?? [],
+        aliases: getStringArray(input.values, "alias") ?? [],
+        qualifiedAliases: getStringArray(input.values, "qualified-alias") ?? [],
+        country: getString(input.values, "country") ?? "US",
+        language: getString(input.values, "language") ?? "en",
+        displayName: getString(input.values, "display-name") ?? name,
+        providers: getStringArray(input.values, "provider") ?? [],
+        providerModels: parseProviderModelAssignments(getStringArray(input.values, "provider-model")),
+        providerDispatchModes: parseDispatchModeAssignments(getStringArray(input.values, "dispatch-mode")),
+        siteAuditMaxPages: parseSiteAuditMaxPages(getString(input.values, "site-audit-max-pages"), "project.create"),
+        format: input.format
+      });
     }
-    const run = await client.getRun(runId);
-    if (showProgress) process.stderr.write(".");
-    if (TERMINAL_STATUSES.has(run.status) || outstandingBatches(run).length > 0) {
-      return run;
+  },
+  {
+    path: ["project", "update"],
+    usage: "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--add-qualified-alias <name>...] [--remove-qualified-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--dispatch-mode provider=sync|batch...] [--clear-dispatch-mode <provider>...] [--negative-review-max-stars <1-4|default>] [--site-audit-max-pages <1-50000|full>] [--competitor-auto-aliases <off|preview|apply>] [--format json]",
+    options: {
+      domain: { type: "string", short: "d" },
+      "owned-domain": multiStringOption(),
+      "add-domain": multiStringOption(),
+      "remove-domain": multiStringOption(),
+      alias: multiStringOption(),
+      "add-alias": multiStringOption(),
+      "remove-alias": multiStringOption(),
+      "add-qualified-alias": multiStringOption(),
+      "remove-qualified-alias": multiStringOption(),
+      country: stringOption(),
+      language: stringOption(),
+      "display-name": stringOption(),
+      provider: multiStringOption(),
+      "all-providers": { type: "boolean" },
+      "provider-model": multiStringOption(),
+      "clear-provider-model": multiStringOption(),
+      "dispatch-mode": multiStringOption(),
+      "clear-dispatch-mode": multiStringOption(),
+      "negative-review-max-stars": stringOption(),
+      "site-audit-max-pages": stringOption(),
+      "competitor-auto-aliases": stringOption()
+    },
+    run: async (input) => {
+      const name = requireProject(
+        input,
+        "project.update",
+        "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--add-qualified-alias <name>...] [--remove-qualified-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--dispatch-mode provider=sync|batch...] [--clear-dispatch-mode <provider>...] [--negative-review-max-stars <1-4|default>] [--site-audit-max-pages <1-50000|full>] [--competitor-auto-aliases <off|preview|apply>] [--format json]"
+      );
+      const providers = getStringArray(input.values, "provider");
+      const allProviders = getBoolean(input.values, "all-providers");
+      if (allProviders && providers?.length) throw usageError("Error: --all-providers conflicts with --provider");
+      const providerModels = parseProviderModelAssignments(getStringArray(input.values, "provider-model"));
+      const clearProviderModels = getStringArray(input.values, "clear-provider-model") ?? [];
+      for (const provider of clearProviderModels) {
+        if (provider in providerModels) throw usageError(`Error: --provider-model and --clear-provider-model conflict for ${provider}`);
+      }
+      const dispatchModes = parseDispatchModeAssignments(getStringArray(input.values, "dispatch-mode"));
+      const clearDispatchModes = getStringArray(input.values, "clear-dispatch-mode") ?? [];
+      for (const provider of clearDispatchModes) {
+        if (provider in dispatchModes) throw usageError(`Error: --dispatch-mode and --clear-dispatch-mode conflict for ${provider}`);
+      }
+      await updateProjectSettings(name, {
+        displayName: getString(input.values, "display-name"),
+        domain: getString(input.values, "domain"),
+        ownedDomains: getStringArray(input.values, "owned-domain"),
+        addOwnedDomain: getStringArray(input.values, "add-domain"),
+        removeOwnedDomain: getStringArray(input.values, "remove-domain"),
+        aliases: getStringArray(input.values, "alias"),
+        addAlias: getStringArray(input.values, "add-alias"),
+        removeAlias: getStringArray(input.values, "remove-alias"),
+        addQualifiedAlias: getStringArray(input.values, "add-qualified-alias"),
+        removeQualifiedAlias: getStringArray(input.values, "remove-qualified-alias"),
+        country: getString(input.values, "country"),
+        language: getString(input.values, "language"),
+        providers: allProviders ? [] : providers,
+        providerModels,
+        clearProviderModels,
+        dispatchModes,
+        clearDispatchModes,
+        negativeReviewMaxStars: parseNegativeReviewMaxStars(getString(input.values, "negative-review-max-stars")),
+        siteAuditMaxPages: parseSiteAuditMaxPages(getString(input.values, "site-audit-max-pages"), "project.update"),
+        competitorAutoAliases: parseCompetitorAutoAliasMode(getString(input.values, "competitor-auto-aliases")),
+        format: input.format
+      });
     }
-  }
-}
-function outstandingBatches(run) {
-  if (TERMINAL_STATUSES.has(run.status)) return [];
-  return (run.providerBatches ?? []).filter((batch) => OUTSTANDING_PROVIDER_BATCH_STATUSES.includes(batch.status));
-}
-function batchWaitLine(run) {
-  const outstanding = outstandingBatches(run);
-  if (outstanding.length === 0) return null;
-  const batches = outstanding.map((batch) => `${batch.provider} \u2014 ${batch.requestCount} requests, submitted ${batch.submittedAt ?? "unknown"}, deadline ${batch.deadlineAt}`);
-  return `Waiting on provider batch(es): ${batches.join("; ")}; check with canonry run show ${run.id}`;
-}
-function printRunDetail(run) {
-  console.log(`Run: ${run.id}`);
-  console.log(`  Status:   ${run.status}`);
-  console.log(`  Kind:     ${run.kind}`);
-  if (run.trigger) console.log(`  Trigger:  ${run.trigger}`);
-  if (run.startedAt) console.log(`  Started:  ${run.startedAt}`);
-  if (run.finishedAt) console.log(`  Finished: ${run.finishedAt}`);
-  if (run.createdAt) console.log(`  Created:  ${run.createdAt}`);
-  if (run.error) {
-    if (run.error.message) console.log(`  Error:    ${run.error.message}`);
-    if (run.error.providers) {
-      for (const [provider, detail] of Object.entries(run.error.providers)) {
-        console.log(`  Error (${provider}): ${detail.message}`);
+  },
+  {
+    path: ["project", "list"],
+    usage: "canonry project list [--format json]",
+    allowPositionals: false,
+    run: async (input) => {
+      await listProjects(input.format);
+    }
+  },
+  {
+    path: ["project", "show"],
+    usage: "canonry project show <name> [--format json]",
+    run: async (input) => {
+      const name = requireProject(input, "project.show", "canonry project show <name>");
+      await showProject(name, input.format);
+    }
+  },
+  {
+    path: ["project", "delete"],
+    usage: "canonry project delete <name> [--dry-run] [--format json]",
+    supportsDryRun: true,
+    run: async (input) => {
+      const name = requireProject(input, "project.delete", "canonry project delete <name> [--dry-run] [--format json]");
+      await deleteProject(name, { dryRun: input.dryRun, format: input.format });
+    }
+  },
+  {
+    path: ["project", "add-location"],
+    usage: "canonry project add-location <name> --label <label> --city <city> --region <region> --country <country> [--format json]",
+    options: {
+      label: stringOption(),
+      city: stringOption(),
+      region: stringOption(),
+      country: stringOption(),
+      timezone: stringOption()
+    },
+    run: async (input) => {
+      const name = requireProject(
+        input,
+        "project.add-location",
+        "canonry project add-location <name> --label <label> --city <city> --region <region> --country <country> [--format json]"
+      );
+      const label = getString(input.values, "label");
+      const city = getString(input.values, "city");
+      const region = getString(input.values, "region");
+      const country = getString(input.values, "country");
+      if (!label || !city || !region || !country) {
+        throw usageError("Error: --label, --city, --region, and --country are all required", {
+          message: "location label, city, region, and country are required",
+          details: {
+            command: "project.add-location",
+            usage: "canonry project add-location <name> --label <label> --city <city> --region <region> --country <country> [--format json]",
+            required: ["label", "city", "region", "country"]
+          }
+        });
       }
+      await addLocation(name, {
+        label,
+        city,
+        region,
+        country,
+        timezone: getString(input.values, "timezone"),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["project", "locations"],
+    usage: "canonry project locations <name> [--format json]",
+    run: async (input) => {
+      const name = requireProject(input, "project.locations", "canonry project locations <name> [--format json]");
+      await listLocations(name, input.format);
+    }
+  },
+  {
+    path: ["project", "remove-location"],
+    usage: "canonry project remove-location <name> <label> [--format json]",
+    run: async (input) => {
+      const name = requireProject(input, "project.remove-location", "canonry project remove-location <name> <label> [--format json]");
+      const label = requirePositional(input, 1, {
+        command: "project.remove-location",
+        usage: "canonry project remove-location <name> <label> [--format json]",
+        message: "project name and location label are required"
+      });
+      await removeLocation(name, label, input.format);
+    }
+  },
+  {
+    path: ["project", "set-default-location"],
+    usage: "canonry project set-default-location <name> <label> [--format json]",
+    run: async (input) => {
+      const name = requireProject(input, "project.set-default-location", "canonry project set-default-location <name> <label> [--format json]");
+      const label = requirePositional(input, 1, {
+        command: "project.set-default-location",
+        usage: "canonry project set-default-location <name> <label> [--format json]",
+        message: "project name and location label are required"
+      });
+      await setDefaultLocation(name, label, input.format);
+    }
+  },
+  {
+    path: ["project"],
+    usage: "canonry project <create|update|list|show|delete|add-location|locations|remove-location|set-default-location> [args]",
+    run: async (input) => {
+      unknownSubcommand(input.positionals[0], {
+        command: "project",
+        usage: "canonry project <create|update|list|show|delete|add-location|locations|remove-location|set-default-location> [args]",
+        available: ["create", "update", "list", "show", "delete", "add-location", "locations", "remove-location", "set-default-location"]
+      });
     }
   }
-  const batched = Object.keys(run.dispatchModes ?? {}).sort();
-  if (batched.length > 0) console.log(`  Dispatch: ${batched.map((provider) => `${provider}=batch`).join(", ")} (other providers sync)`);
-  if (run.providerBatches && run.providerBatches.length > 0) {
-    console.log("\n  Provider batches:");
-    for (const batch of run.providerBatches) console.log(`    ${providerBatchLine(batch)}`);
+];
+function parseDispatchModeAssignments(assignments) {
+  const result = {};
+  for (const assignment of assignments ?? []) {
+    const separator = assignment.indexOf("=");
+    const provider = separator === -1 ? "" : assignment.slice(0, separator).trim();
+    const mode = providerDispatchModeSchema.safeParse(separator === -1 ? "" : assignment.slice(separator + 1).trim().toLowerCase());
+    if (!provider || !mode.success) throw usageError(`Error: --dispatch-mode must use provider=sync or provider=batch (received ${assignment})`);
+    if (provider in result) throw usageError(`Error: duplicate --dispatch-mode assignment for ${provider}`);
+    result[provider] = mode.data;
   }
-  if (run.usage && run.usage.length > 0) printUsageTable(run.usage);
-  if (run.snapshots && run.snapshots.length > 0) {
-    console.log(`
-  Snapshots: ${run.snapshots.length}  (cell = [citation][mention];  C=cited c=not, M=mentioned m=not, \u2013=no data)`);
-    for (const s of run.snapshots) {
-      const citationGlyph = s.citationState === CitationStates.cited ? "C" : "c";
-      const mentionGlyph = typeof s.answerMentioned === "boolean" ? s.answerMentioned ? "M" : "m" : "\u2013";
-      const modelLabel = s.model ? ` (${s.model})` : "";
-      console.log(`    [${citationGlyph}${mentionGlyph}]  ${s.provider}${modelLabel}  ${s.query}`);
-    }
+  return result;
+}
+function parseProviderModelAssignments(assignments) {
+  const result = {};
+  for (const assignment of assignments ?? []) {
+    const separator = assignment.indexOf("=");
+    const provider = separator === -1 ? "" : assignment.slice(0, separator).trim();
+    const model = separator === -1 ? "" : assignment.slice(separator + 1).trim();
+    if (!provider || !model) throw usageError(`Error: --provider-model must use provider=model (received ${assignment})`);
+    if (provider in result) throw usageError(`Error: duplicate --provider-model assignment for ${provider}`);
+    result[provider] = model;
   }
+  return result;
 }
-function providerBatchLine(batch) {
-  const recorded = `${batch.recordedCount} of ${batch.requestCount} answers recorded`;
-  const withError = (text) => batch.error ? `${text} (${batch.error})` : text;
-  switch (batch.status) {
-    case ProviderBatchStatuses.submitting:
-      return `submitting provider batch: ${batch.provider} \u2014 ${batch.requestCount} requests`;
-    // The two outstanding statuses: the run stays `running` until they clear.
-    case ProviderBatchStatuses.submitted:
-    case ProviderBatchStatuses.ended:
-      return `waiting on provider batch: ${batch.provider} \u2014 ${batch.requestCount} requests, submitted ${batch.submittedAt ?? "unknown"}, deadline ${batch.deadlineAt}`;
-    case ProviderBatchStatuses.ingested:
-      return withError(`provider batch ${batch.provider}: ingested \u2014 ${recorded}`);
-    case ProviderBatchStatuses.cancelled:
-      return withError(`provider batch ${batch.provider}: cancelled \u2014 ${recorded}; the rest are missing and can be filled`);
-    case ProviderBatchStatuses.failed:
-      return withError(`provider batch ${batch.provider}: rejected by the provider \u2014 its ${batch.requestCount} answers ran sync instead`);
-    case ProviderBatchStatuses.unknown:
-      return withError(`provider batch ${batch.provider}: submit outcome unknown \u2014 never resubmitted; its ${batch.requestCount} answers stay missing`);
+function parseNegativeReviewMaxStars(raw) {
+  if (raw === void 0) return void 0;
+  if (raw === "default") return null;
+  const parsed = gbpNegativeReviewMaxStarsSchema.safeParse(Number(raw));
+  if (!parsed.success) {
+    throw usageError('Error: --negative-review-max-stars must be 1, 2, 3, 4, or "default" (3)', {
+      message: '--negative-review-max-stars must be 1-4 or "default"',
+      details: { command: "project.update", value: raw }
+    });
   }
+  return parsed.data;
 }
-function printUsageTable(rows) {
-  const cost = (row) => row.estimatedCostMicros === null ? "unpriced" : `${formatMicros(row.estimatedCostMicros, "USD", { fractionDigits: 4, showTinyAsLessThan: true })}${row.unpricedAnswers > 0 ? ` (+${row.unpricedAnswers} unpriced)` : ""}`;
-  const table = rows.map((row) => [
-    row.provider,
-    row.pricingTier,
-    row.answers.toLocaleString("en-US"),
-    row.inputTokens.toLocaleString("en-US"),
-    row.cachedInputTokens.toLocaleString("en-US"),
-    row.cacheWriteTokens.toLocaleString("en-US"),
-    row.outputTokens.toLocaleString("en-US"),
-    row.searchCount.toLocaleString("en-US"),
-    cost(row)
-  ]);
-  const header = ["PROVIDER", "TIER", "ANSWERS", "INPUT", "CACHED", "CACHE WRITE", "OUTPUT", "SEARCHES", "EST. COST"];
-  const widths = header.map((title, index) => Math.max(title.length, ...table.map((cells) => cells[index].length)));
-  const line = (cells) => `    ${cells.map((cell2, index) => cell2.padEnd(widths[index])).join("  ").trimEnd()}`;
-  console.log("\n  Usage (answers with recorded usage; cost is an estimate):");
-  console.log(line(header));
-  for (const cells of table) console.log(line(cells));
+function parseSiteAuditMaxPages(raw, command) {
+  if (raw === void 0) return void 0;
+  const value = raw.trim();
+  if (value.toLowerCase() === "full") return null;
+  const parsed = /^\d+$/.test(value) ? siteAuditPageBudgetSchema.safeParse(Number(value)) : void 0;
+  if (!parsed?.success) {
+    throw usageError(`Error: --site-audit-max-pages must be a whole number of pages from 1 to ${SITE_AUDIT_MAX_PAGE_LIMIT}, or "full" for the full site`, {
+      message: `--site-audit-max-pages must be 1-${SITE_AUDIT_MAX_PAGE_LIMIT} or "full"`,
+      details: { command, option: "site-audit-max-pages", value: raw }
+    });
+  }
+  return parsed.data;
 }
-var FILL_POLL_INTERVAL_MS = 3e3;
-var FILL_POLL_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
-function missingSummary(completeness) {
-  const parts = Object.entries(completeness.missingByProvider).sort(([left], [right]) => left.localeCompare(right)).map(([provider, count]) => `${provider} ${count}`);
-  return parts.length ? parts.join(", ") : "none";
+function parseCompetitorAutoAliasMode(raw) {
+  if (raw === void 0) return void 0;
+  const parsed = competitorAutoAliasModeSchema.safeParse(raw.trim().toLowerCase());
+  if (!parsed.success) {
+    throw usageError("Error: --competitor-auto-aliases must be off, preview or apply", {
+      message: "--competitor-auto-aliases must be off, preview or apply",
+      details: { command: "project.update", option: "competitor-auto-aliases", value: raw }
+    });
+  }
+  return parsed.data;
 }
-function printCompleteness(completeness) {
-  console.log(`Run: ${completeness.runId}`);
-  console.log(`  Status:   ${completeness.status}`);
-  if (!completeness.planned) {
-    console.log("  Not a measurement-plan run: there are no expected answers to count.");
+
+// src/commands/organic-evidence.ts
+async function showOrganicEvidence(project2, opts) {
+  const data = await createApiClient().getOrganicEvidence(project2, opts.period);
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(data, null, 2));
     return;
   }
-  if (!completeness.readable) {
-    console.log("  Answers:  unknown (the run's manifest cannot be read)");
-  } else {
-    console.log(`  Answers:  ${completeness.executed}/${completeness.expected}`);
-    console.log(`  Missing:  ${completeness.missing} (${missingSummary(completeness)})`);
+  printOrganicEvidence(project2, data);
+}
+function formatCounts(clicks, impressions) {
+  return `${clicks} clicks / ${impressions} impressions`;
+}
+function printOrganicEvidence(project2, data) {
+  const asOf = data.asOfDate ? ` through ${data.asOfDate}` : "";
+  console.log(`Organic evidence: ${project2}  (${data.periodDays} days${asOf})`);
+  console.log(`Coverage: GSC ${data.coverage.gsc ? "yes" : "no"} \xB7 GA4 ${data.coverage.ga4 ? "yes" : "no"} \xB7 server ${data.coverage.server ? "yes" : "no"} \xB7 AI visibility ${data.coverage.visibility ? "yes" : "no"}`);
+  if (data.gsc) {
+    console.log(`Google Search: ${formatCounts(data.gsc.propertyTotals.clicks, data.gsc.propertyTotals.impressions)} (named non-brand: ${formatCounts(data.gsc.namedNonBrand.clicks, data.gsc.namedNonBrand.impressions)})`);
   }
-  if (completeness.refusal) console.log(`  Fillable: no. ${completeness.refusal.message}`);
-  else console.log(`  Fillable: ${completeness.fillable ? "yes" : "not right now (a sweep or another fill is running)"}`);
-  const fill = completeness.latestFill;
-  if (fill) {
-    console.log(`  Last fill: ${fill.id} ${fill.status}, ${fill.filled}/${fill.expected} recorded${fill.error ? `. ${fill.error}` : ""}`);
+  if (data.ga4) console.log(`GA4 organic: ${data.ga4.organicSessions} sessions`);
+  if (data.gaAiReferrals) console.log(`GA4 AI referrals: ${data.gaAiReferrals.organicSessions} organic, ${data.gaAiReferrals.paidSessions} paid sessions`);
+  if (data.server) {
+    const s = data.server;
+    const fetchTotal = s.userFetchHits.verified + s.userFetchHits.claimedUnverified + s.userFetchHits.unknownAiLike;
+    console.log(`Server AI: ${s.crawlerHits.verified} verified + ${s.crawlerHits.claimedUnverified} claimed + ${s.crawlerHits.unknownAiLike} heuristic crawls; ${fetchTotal} user-agent fetches (${s.userFetchHits.verified} verified, ${s.userFetchHits.claimedUnverified} claimed, ${s.userFetchHits.unknownAiLike} heuristic); ${s.referralSessions.organic} organic referrals, ${s.referralSessions.paid} paid, ${s.referralSessions.unknown} unclassified`);
   }
-}
-async function showRunCompleteness(runId, format) {
-  const completeness = await getClient23().getRunCompleteness(runId);
-  if (isMachineFormat(format)) {
-    console.log(JSON.stringify(completeness, null, 2));
-    return;
+  if (data.visibility) {
+    const v = data.visibility;
+    console.log(`Latest AI visibility: ${v.mentionedPairs}/${v.answerPairs} mentioned, ${v.citedPairs}/${v.answerPairs} cited (${Math.floor(v.ageDays)}d old)`);
   }
-  printCompleteness(completeness);
-}
-async function fillRun(runId, opts = {}) {
-  const client = getClient23();
-  const response = await client.fillRun(runId, {
-    ...opts.providers?.length ? { providers: opts.providers } : {},
-    ...opts.dryRun ? { dryRun: true } : {}
-  });
-  if (!opts.wait || response.outcome !== "queued" || !response.fill) {
-    if (isMachineFormat(opts.format)) {
-      console.log(JSON.stringify(response, null, 2));
-      return;
-    }
-    if (response.outcome === "already-complete") console.log(`Run ${runId} is already complete: nothing to fill.`);
-    else if (response.outcome === "dry-run") console.log("Dry run: nothing was queued.");
-    else if (response.fill) console.log(`Fill ${response.fill.id} queued: ${response.fill.expected} missing answer(s) (${missingSummary(response.completeness)}).`);
-    printCompleteness(response.completeness);
-    return;
+  if (data.findings.length > 0) {
+    console.log("\nFindings:");
+    for (const finding of data.findings) console.log(`- ${finding.title}: ${finding.detail}`);
   }
-  const fillId = response.fill.id;
-  const deadline = Date.now() + FILL_POLL_TIMEOUT_MS;
-  let completeness = response.completeness;
-  if (!isMachineFormat(opts.format)) {
-    process.stderr.write(`Filling ${response.fill.expected} missing answer(s) in run ${runId}`);
+  if (data.limitations.length > 0) {
+    console.log("\nLimitations:");
+    for (const limitation of data.limitations) console.log(`- ${limitation.detail}`);
   }
-  for (; ; ) {
-    await new Promise((resolve) => setTimeout(resolve, FILL_POLL_INTERVAL_MS));
-    if (Date.now() > deadline) {
-      throw new CliError({
-        code: "RUN_FILL_INCOMPLETE",
-        message: `Timed out waiting for fill ${fillId}; it may still be running. Check with: canonry run completeness ${runId}`,
-        exitCode: EXIT_SYSTEM_ERROR,
-        details: { runId, fillId }
+}
+
+// src/cli-commands/organic-evidence.ts
+var USAGE3 = "canonry organic-evidence <project> [--period 60|90] [--format json|jsonl]";
+function parsePeriod(value) {
+  if (value === void 0) return void 0;
+  if (value === "60" || value === "90") return Number(value);
+  throw usageError(`Error: --period must be 60 or 90
+
+Usage: ${USAGE3}`);
+}
+var ORGANIC_EVIDENCE_CLI_COMMANDS = [
+  {
+    path: ["organic-evidence"],
+    usage: USAGE3,
+    options: { period: stringOption() },
+    run: async (input) => {
+      const project2 = requireProject(input, "organic-evidence", USAGE3);
+      await showOrganicEvidence(project2, {
+        period: parsePeriod(getString(input.values, "period")),
+        format: input.format
       });
     }
-    completeness = await client.getRunCompleteness(runId);
-    if (!isMachineFormat(opts.format)) process.stderr.write(".");
-    const latest = completeness.latestFill;
-    const working = latest !== null && (latest.status === "queued" || latest.status === "running");
-    if (completeness.status === "completed" || !working) break;
-  }
-  if (!isMachineFormat(opts.format)) process.stderr.write("\n");
-  if (isMachineFormat(opts.format)) console.log(JSON.stringify(completeness, null, 2));
-  else printCompleteness(completeness);
-  if (completeness.status !== "completed") {
-    throw new CliError({
-      code: "RUN_FILL_INCOMPLETE",
-      message: `Run ${runId} is still ${completeness.status}: ${completeness.missing} answer(s) missing (${missingSummary(completeness)}).`,
-      exitCode: EXIT_SYSTEM_ERROR,
-      details: { runId, fillId, missing: completeness.missing, missingByProvider: completeness.missingByProvider }
-    });
   }
-}
+];
 
 // src/cli-commands/run.ts
 var RUN_TRIGGER_USAGE = "canonry run trigger <project> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--dispatch-mode sync|batch] [--force] [--wait] [--format json]";
@@ -16364,6 +16417,9 @@ function renderHuman2(overview) {
   } else {
     console.log("\n  No runs yet.");
   }
+  const admission = runAdmissionLines(meta.name, latestRun.admission, latestRun.manualAdmission);
+  if (admission.length > 0) console.log(`
+${admission.map((line) => `  ${line}`).join("\n")}`);
   console.log("\nScores:");
   printScore("Mention          ", scores.mention);
   printScore("Visibility       ", scores.visibility);