@canonry/canonry 5.21.0 → 5.28.1

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-NFN5GSEJ.js";
+} from "./chunk-EP4STEPI.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-MEAKE5W7.js";
+} from "./chunk-DX2JUC5H.js";
 import {
   configExists,
   createApiClient,
@@ -56,13 +56,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-FRWZWJB3.js";
+} from "./chunk-FNGITGDF.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-HDJHQPW3.js";
+import "./chunk-ONTEFAA7.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -74,7 +74,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-WUT3G2GM.js";
+} from "./chunk-MPICT6V7.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -89,7 +89,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-FAVYLZQV.js";
+} from "./chunk-7RKCDOWO.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -103,6 +103,8 @@ import {
   CheckStatuses,
   CitationStates,
   MeasurementEvidenceShapes,
+  OUTSTANDING_PROVIDER_BATCH_STATUSES,
+  ProviderBatchStatuses,
   READ_ONLY_SCOPE,
   REPORT_PERIOD_OPTIONS,
   ResearchRunStatuses,
@@ -145,6 +147,7 @@ import {
   formatRatio,
   formatRunErrorOneLine,
   formatWholePercent,
+  gbpNegativeReviewMaxStarsSchema,
   googleAdsMetricsWindowSchema,
   isVisibilityCompareClassMetric,
   logQuerySchema,
@@ -166,11 +169,14 @@ import {
   normalizeProjectAliases,
   normalizeTelemetryStatus,
   notificationEventSchema,
+  providerDispatchModeSchema,
   queryClassFilterSchema,
   queryTrackingCommitRequestSchema,
   queryTrackingPreviewRequestSchema,
+  referralAssessmentQuerySchema,
   reportUnattributedAnswers,
   researchBatchCreateSchema,
+  resolveNegativeReviewMaxStars,
   resolveProviderInput,
   resultsClearRequestSchema,
   shareOfVoiceLabel,
@@ -179,7 +185,7 @@ import {
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-2LO7FLVD.js";
+} from "./chunk-KVQHG3WB.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -444,7 +450,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-7BVVVXPM.js");
+  const { createDemoServer } = await import("./demo-server-HWWIMGD6.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -3051,7 +3057,8 @@ async function doctorCommand(opts) {
   const client = createApiClient();
   const report = await client.runDoctor({
     project: opts.project,
-    checkIds: opts.checks
+    checkIds: opts.checks,
+    ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {}
   });
   if (opts.format === "json") {
     console.log(JSON.stringify(report, null, 2));
@@ -3077,8 +3084,8 @@ async function runDoctorAll(opts) {
   const client = createApiClient();
   const projects2 = await client.listProjects();
   const [globalReport, ...projectReports] = await Promise.all([
-    client.runDoctor({ checkIds: opts.checks }),
-    ...projects2.map((p) => client.runDoctor({ project: p.name, checkIds: opts.checks }))
+    client.runDoctor({ checkIds: opts.checks, ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {} }),
+    ...projects2.map((p) => client.runDoctor({ project: p.name, checkIds: opts.checks, ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {} }))
   ]);
   const byKey = { __global__: globalReport };
   projects2.forEach((p, i) => {
@@ -3174,13 +3181,14 @@ ${header}`);
 }
 
 // src/cli-commands/doctor.ts
-var USAGE = "canonry doctor [--project <name>|--all] [--check <id>...] [--format json|jsonl]";
+var USAGE = "canonry doctor [--project <name>|--all] [--check <id>...] [--report-month YYYY-MM] [--format json|jsonl]";
 var DOCTOR_CLI_COMMANDS = [
   {
     path: ["doctor"],
     usage: USAGE,
     options: {
       project: stringOption(),
+      "report-month": stringOption(),
       check: multiStringOption(),
       all: { type: "boolean" }
     },
@@ -3188,6 +3196,7 @@ var DOCTOR_CLI_COMMANDS = [
     run: async (input) => {
       await doctorCommand({
         project: getString(input.values, "project"),
+        reportMonth: getString(input.values, "report-month"),
         all: getBoolean(input.values, "all"),
         checks: getStringArray(input.values, "check"),
         format: input.format
@@ -5223,6 +5232,45 @@ async function gbpPlaces(project, opts) {
     console.log(`  ${p.locationName}  [${p.tier}]  ${amenities}`);
   }
 }
+async function gbpReviews(project, opts) {
+  const client = getClient8();
+  const response = await client.listGbpReviews(project, {
+    locationName: opts.location,
+    ...opts.negative ? { negative: true } : {},
+    ...opts.limit !== void 0 ? { limit: opts.limit } : {}
+  });
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(response, null, 2));
+    return;
+  }
+  if (response.locations.length === 0 && response.reviews.length === 0) {
+    console.log('No reviews yet. Run "canonry gbp sync" first.');
+    return;
+  }
+  const names = new Map(response.locations.map((loc) => [loc.locationName, loc.displayName]));
+  for (const loc of response.locations) {
+    const rating = loc.rating !== null ? `${Number(loc.rating.toFixed(2))} from ${loc.reviewCount ?? "?"} reviews (${loc.ratingOrigin === "gbp" ? "Business Profile" : "public listing"})` : "no rating yet";
+    const access = loc.reviewsAccess === "ok" ? "every review" : loc.reviewsAccess === null ? "review access not checked yet" : `Business Profile reviews ${loc.reviewsAccess}${loc.reviewsAccessReason ? ` (${loc.reviewsAccessReason})` : ""}`;
+    console.log(`${loc.displayName}  ${loc.locationName}`);
+    console.log(`  ${rating}; ${access}`);
+  }
+  const label = opts.negative ? "negative review(s)" : "review(s)";
+  if (response.reviews.length === 0) {
+    console.log(`
+No ${label} stored.`);
+    return;
+  }
+  const shown = response.reviews.length < response.total ? `, newest ${response.reviews.length} shown` : "";
+  console.log(`
+${response.total} ${label}${shown}:`);
+  const manyLocations = response.locations.length > 1;
+  for (const r of response.reviews) {
+    const stars = r.starRating !== null ? `${r.starRating}\u2605` : "--";
+    const where = manyLocations ? `  ${names.get(r.locationName) ?? r.locationName}` : "";
+    const text = r.comment ? `"${r.comment.length > 80 ? `${r.comment.slice(0, 79)}\u2026` : r.comment}"` : "(rating only)";
+    console.log(`  ${r.updateTime.slice(0, 10)}  ${stars}${where}  ${r.reviewerName ?? "Anonymous"}  ${text}  [${r.origin}, ${r.alertState}]`);
+  }
+}
 function fmtDelta(pct4) {
   if (pct4 === null) return "n/a";
   return `${pct4 >= 0 ? "+" : ""}${pct4}%`;
@@ -5443,6 +5491,25 @@ var GBP_CLI_COMMANDS = [
       await gbpPlaces(project, { location: getString(input.values, "location"), format: input.format });
     }
   },
+  {
+    path: ["gbp", "reviews"],
+    usage: "canonry gbp reviews <project> [--location <name>] [--negative] [--limit N] [--format json]",
+    options: {
+      location: stringOption(),
+      negative: { type: "boolean" },
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry gbp reviews <project> [--location <name>] [--negative] [--limit N] [--format json]";
+      const project = requireProject(input, "gbp.reviews", usage);
+      await gbpReviews(project, {
+        location: getString(input.values, "location"),
+        negative: getBoolean(input.values, "negative") ?? false,
+        limit: parseIntegerOption(input, "limit", { message: "--limit must be an integer", usage, command: "gbp.reviews" }),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["gbp", "summary"],
     usage: "canonry gbp summary <project> [--location <name>] [--format json]",
@@ -7362,9 +7429,47 @@ async function trafficEvents(project, opts) {
     console.log(`  ${formatEventLine(event)}`);
   }
 }
+async function trafficReferralAssessment(project, options) {
+  const { format, ...query } = options;
+  const parsed = referralAssessmentQuerySchema.safeParse(query);
+  if (!parsed.success) throw new CliError({ code: "TRAFFIC_INVALID_ASSESSMENT", message: parsed.error.message });
+  const result = await createApiClient().trafficReferralAssessment(project, parsed.data);
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`AI referral assessment for "${project}" \xB7 ${result.window.startDate} to ${result.window.endDate} UTC`);
+  console.log(`  Raw stored hits: ${result.totals.raw.total}`);
+  console.log(`  Countable stored hits: ${result.totals.countable.total}`);
+  console.log(`  Suspected burst hits: ${result.totals.suspected.total} (not confirmed automation)`);
+  console.log(`  Adjusted estimate: ${result.totals.adjustedEstimate.total} (countable minus candidate bursts)`);
+  console.log(`  Rule: ${result.rule.version}; threshold ${result.rule.burstThreshold}; ${result.rule.calibration}`);
+  console.log(`  Observed server/GA quotient: ${result.comparison.observedRatio ?? "unavailable"}; comparable coverage: unavailable`);
+  console.log(`  Evidence: ${result.evidence.returned} of ${result.evidence.total} candidate groups (source, product, normalized path, UTC hour)`);
+  for (const burst of result.bursts) console.log(`  ${burst.tsHour} ${burst.sourceId} ${burst.product} ${burst.landingPathNormalized} ${burst.counts.total}`);
+  for (const caveat of result.caveats) console.log(`  ${caveat}`);
+}
 
 // src/cli-commands/traffic.ts
 var TRAFFIC_CLI_COMMANDS = [
+  {
+    path: ["traffic", "referral-assessment"],
+    usage: "canonry traffic referral-assessment <project> --start-date YYYY-MM-DD --end-date YYYY-MM-DD [--source <id>] [--burst-threshold 100] [--ratio-threshold 3] [--limit 100] [--format json]",
+    help: "DB-only diagnostic. Raw headlines stay unchanged. Candidate bursts are not confirmed automation; adjusted counts are estimates. Property, Target and market attribution are unavailable. The observed GA quotient has unknown comparable coverage.",
+    options: { "start-date": stringOption(), "end-date": stringOption(), source: stringOption(), "burst-threshold": stringOption(), "ratio-threshold": stringOption(), limit: stringOption() },
+    run: async (input) => {
+      const project = requireProject(input, "traffic.referral-assessment", "canonry traffic referral-assessment <project> --start-date YYYY-MM-DD --end-date YYYY-MM-DD");
+      await trafficReferralAssessment(project, {
+        startDate: getString(input.values, "start-date"),
+        endDate: getString(input.values, "end-date"),
+        sourceId: getString(input.values, "source"),
+        burstThreshold: getString(input.values, "burst-threshold") === void 0 ? void 0 : Number(getString(input.values, "burst-threshold")),
+        ratioThreshold: getString(input.values, "ratio-threshold") === void 0 ? void 0 : Number(getString(input.values, "ratio-threshold")),
+        limit: getString(input.values, "limit") === void 0 ? void 0 : Number(getString(input.values, "limit")),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["traffic", "connect", "cloudflare"],
     usage: "canonry traffic connect cloudflare <project> [--delivery-mode direct-push|queue-pull] [--display-name <name>] [--zone-id <id>] [--account-id <id>] [--queue-id <id> --queue-name <name> --api-token-file <path> --retention-seconds 345600] [--output-dir <dir>] [--deploy --confirm-route --confirm-fail-open] [--format json]",
@@ -8307,6 +8412,65 @@ async function googleTopPages(project, opts) {
     console.log('  Adding up the page rows would not give it. Run "canonry google sync" to fetch it.');
   }
 }
+async function googleQueryTotals(project, opts) {
+  const client = getClient11();
+  const params = {};
+  if (opts.startDate) params.startDate = opts.startDate;
+  if (opts.endDate) params.endDate = opts.endDate;
+  if (opts.window) params.window = opts.window;
+  if (opts.limit !== void 0) params.limit = String(opts.limit);
+  if (opts.offset !== void 0) params.offset = String(opts.offset);
+  const data = await client.gscQueryTotals(project, Object.keys(params).length > 0 ? params : void 0);
+  const { rows, totalMatching, truncated, window } = data;
+  if (opts.format === "json") {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  } else if (opts.format === "jsonl") {
+    emitJsonl(rows.map((row) => ({ project, window, ...row })));
+    return;
+  }
+  if (rows.length === 0) {
+    if (totalMatching > 0) {
+      console.log(
+        `Offset ${opts.offset ?? 0} is past the end of the result set (${totalMatching.toLocaleString()} queries). Lower --offset to page through them.`
+      );
+      return;
+    }
+    console.log('No GSC query data found in this window. Run "canonry google sync" first.');
+    return;
+  }
+  const range = `${window.startDate ?? "earliest"} to ${window.endDate ?? "latest"}`;
+  console.log(`GSC query totals (${rows.length.toLocaleString()} of ${totalMatching.toLocaleString()} queries, ${range}):
+`);
+  const showSource = rows.some((row) => row.source !== "google");
+  console.log(
+    `  ${"QUERY".padEnd(40)}${"CLICKS".padStart(8)}${"IMPR".padStart(10)}${"CTR".padStart(8)}${"POS".padStart(7)}${"DAYS".padStart(6)}${showSource ? "  SOURCE" : ""}`
+  );
+  console.log(`  ${"\u2500".repeat(40)}${"\u2500".repeat(8)}${"\u2500".repeat(10)}${"\u2500".repeat(8)}${"\u2500".repeat(7)}${"\u2500".repeat(6)}${showSource ? `  ${"\u2500".repeat(11)}` : ""}`);
+  for (const row of rows.slice(0, 50)) {
+    const query = row.query.length > 38 ? row.query.slice(0, 35) + "..." : row.query;
+    console.log(
+      `  ${query.padEnd(40)}${row.clicks.toLocaleString().padStart(8)}${row.impressions.toLocaleString().padStart(10)}${`${(row.ctr * 100).toFixed(1)}%`.padStart(8)}${row.position.toFixed(1).padStart(7)}${String(row.days).padStart(6)}${showSource ? `  ${row.source}` : ""}`
+    );
+  }
+  if (rows.length > 50) {
+    console.log(`
+  ... and ${rows.length - 50} more rows on this page (use --format json for full output)`);
+  }
+  if (truncated) {
+    const nextOffset = (opts.offset ?? 0) + rows.length;
+    console.log(`
+  This is one page. Use --offset ${nextOffset} (with the same --limit) to read the next.`);
+  }
+  console.log();
+  if (showSource) {
+    console.log("  Rows marked page-summed or mixed use the legacy page table for some days. Their impressions");
+    console.log("  over-count, because one search showing several of your pages was stored once per page.");
+    console.log(`  Run "canonry google sync" over the window to replace them with Google's per-query totals.`);
+  }
+  console.log("  These are the queries Google names. Google leaves rare queries out, so the rows do not add up");
+  console.log('  to the property total. Use "canonry google performance-daily" for that.');
+}
 async function googlePerformance(project, opts) {
   const client = getClient11();
   const params = {};
@@ -8889,6 +9053,7 @@ async function googleDeindexed(project, format) {
 
 // src/cli-commands/google.ts
 var GOOGLE_PERFORMANCE_USAGE = "canonry google performance <project> [--days <n> | --start <YYYY-MM-DD> --end <YYYY-MM-DD>] [--keyword <kw>] [--page <url>] [--limit <n>] [--offset <n>] [--order-by clicks|impressions|date] [--format json]";
+var GOOGLE_QUERY_TOTALS_USAGE = "canonry google query-totals <project> [--start <YYYY-MM-DD>] [--end <YYYY-MM-DD>] [--window 7d|30d|90d|all] [--limit <n>] [--offset <n>] [--format json]";
 var GOOGLE_CLI_COMMANDS = [
   {
     path: ["google", "connect"],
@@ -9122,6 +9287,36 @@ Usage: ${GOOGLE_PERFORMANCE_USAGE}`,
       });
     }
   },
+  {
+    path: ["google", "query-totals"],
+    usage: GOOGLE_QUERY_TOTALS_USAGE,
+    options: {
+      window: stringOption(),
+      start: stringOption(),
+      end: stringOption(),
+      limit: stringOption(),
+      offset: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(input, "google.query-totals", GOOGLE_QUERY_TOTALS_USAGE);
+      await googleQueryTotals(project, {
+        window: getString(input.values, "window"),
+        startDate: getString(input.values, "start"),
+        endDate: getString(input.values, "end"),
+        limit: parseIntegerOption(input, "limit", {
+          command: "google.query-totals",
+          usage: GOOGLE_QUERY_TOTALS_USAGE,
+          message: "--limit must be an integer"
+        }),
+        offset: parseIntegerOption(input, "offset", {
+          command: "google.query-totals",
+          usage: GOOGLE_QUERY_TOTALS_USAGE,
+          message: "--offset must be an integer"
+        }),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["google", "inspect"],
     usage: "canonry google inspect <project> <url> [--format json]",
@@ -9251,12 +9446,12 @@ Usage: ${GOOGLE_PERFORMANCE_USAGE}`,
   },
   {
     path: ["google"],
-    usage: "canonry google <connect|disconnect|status|properties|set-property|set-sitemap|list-sitemaps|submit-sitemap|discover-sitemaps|sync|performance|performance-daily|inspect|inspect-sitemap|coverage|coverage-history|inspections|deindexed|request-indexing|refresh> <project> [args]",
+    usage: "canonry google <connect|disconnect|status|properties|set-property|set-sitemap|list-sitemaps|submit-sitemap|discover-sitemaps|sync|performance|performance-daily|top-pages|query-totals|inspect|inspect-sitemap|coverage|coverage-history|inspections|deindexed|request-indexing|refresh> <project> [args]",
     run: async (input) => {
       unknownSubcommand(input.positionals[0], {
         command: "google",
-        usage: "canonry google <connect|disconnect|status|properties|set-property|set-sitemap|list-sitemaps|submit-sitemap|discover-sitemaps|sync|performance|performance-daily|inspect|inspect-sitemap|coverage|coverage-history|inspections|deindexed|request-indexing|refresh> <project> [args]",
-        available: ["connect", "disconnect", "status", "properties", "set-property", "set-sitemap", "list-sitemaps", "submit-sitemap", "discover-sitemaps", "sync", "performance", "performance-daily", "inspect", "inspect-sitemap", "coverage", "coverage-history", "inspections", "deindexed", "request-indexing", "refresh"]
+        usage: "canonry google <connect|disconnect|status|properties|set-property|set-sitemap|list-sitemaps|submit-sitemap|discover-sitemaps|sync|performance|performance-daily|top-pages|query-totals|inspect|inspect-sitemap|coverage|coverage-history|inspections|deindexed|request-indexing|refresh> <project> [args]",
+        available: ["connect", "disconnect", "status", "properties", "set-property", "set-sitemap", "list-sitemaps", "submit-sitemap", "discover-sitemaps", "sync", "performance", "performance-daily", "top-pages", "query-totals", "inspect", "inspect-sitemap", "coverage", "coverage-history", "inspections", "deindexed", "request-indexing", "refresh"]
       });
     }
   }
@@ -9886,7 +10081,7 @@ var KEYWORD_CLI_COMMANDS = [
       const provider = requireStringOption(input, "provider", {
         command: "keyword.generate",
         usage: "canonry keyword generate <project> --provider <name> [--count <n>] [--save] [--format json]",
-        message: "--provider is required (e.g. gemini, openai, claude, perplexity, local)"
+        message: "--provider is required (e.g. gemini, openai, claude, perplexity, muse, local)"
       });
       await generateKeywords(project, provider, {
         count: parseIntegerOption(input, "count", {
@@ -10630,7 +10825,7 @@ var QUERY_CLI_COMMANDS = [
       const provider = requireStringOption(input, "provider", {
         command: "query.generate",
         usage: "canonry query generate <project> --provider <name> [--count <n>] [--save] [--format json]",
-        message: "--provider is required (e.g. gemini, openai, claude, perplexity, local)"
+        message: "--provider is required (e.g. gemini, openai, claude, perplexity, muse, local)"
       });
       await generateQueries(project, provider, {
         count: parseIntegerOption(input, "count", {
@@ -11047,7 +11242,9 @@ var EVENT_DESCRIPTIONS = {
   "insight.critical": "A critical-severity insight was generated",
   "insight.high": "A high-severity insight was generated",
   "health.degraded": "A scheduled health check found the measurement degraded, daily data stopped arriving, or the website stopped answering (sent on change, not every pass)",
-  "health.recovered": "A degraded health check is passing again, or a website that was paged as down answers again"
+  "health.recovered": "A degraded health check is passing again, or a website that was paged as down answers again",
+  "review.negative": "A new or edited Google review at or below the project's negative-review threshold, 3 stars by default (Business Profile reviews, or the public listing when Google has not enabled review access)",
+  "review.rating-dropped": "A location's public Google rating fell (sent for locations without Business Profile review access)"
 };
 function listEvents(format, target = "local") {
   if (target === "server") return getClient16().listNotificationEvents().then((events) => printEvents(events, format));
@@ -11953,14 +12150,23 @@ async function createProject(name, opts) {
     country: opts.country,
     language: opts.language,
     providers: opts.providers ?? [],
-    providerModels: opts.providerModels ?? {}
+    providerModels: opts.providerModels ?? {},
+    ...opts.providerDispatchModes && Object.keys(opts.providerDispatchModes).length > 0 ? { providerDispatchModes: opts.providerDispatchModes } : {}
   });
+  warnDroppedDispatchModes(opts.providerDispatchModes ?? {}, result);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(result, 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(", ")}`);
+  }
+}
 async function listProjects(format) {
   const client = getClient22();
   const projects2 = await client.listProjects();
@@ -12019,6 +12225,9 @@ async function showProject(name, format) {
   console.log(`  Providers:        ${(project.providers ?? []).length > 0 ? project.providers.join(", ") : "all configured"}`);
   const providerModels = Object.entries(project.providerModels ?? {});
   console.log(`  Model overrides:  ${providerModels.length > 0 ? providerModels.map(([provider, model]) => `${provider}=${model}`).join(", ") : "(none; instance settings inherited)"}`);
+  const dispatchModes = Object.entries(project.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(project.negativeReviewMaxStars)} stars or fewer${project.negativeReviewMaxStars == null ? " (default)" : ""}`);
   console.log(`  Tags:             ${project.tags.length > 0 ? project.tags.join(", ") : "(none)"}`);
   const labelEntries = Object.entries(project.labels);
   console.log(`  Labels:           ${labelEntries.length > 0 ? labelEntries.map(([k, v]) => `${k}=${v}`).join(", ") : "(none)"}`);
@@ -12063,6 +12272,9 @@ async function updateProjectSettings(name, opts) {
       );
     }
   }
+  const touchesDispatch = Object.keys(opts.dispatchModes ?? {}).length > 0 || (opts.clearDispatchModes ?? []).length > 0;
+  const providerDispatchModes = { ...project.providerDispatchModes ?? {}, ...opts.dispatchModes ?? {} };
+  for (const provider of opts.clearDispatchModes ?? []) delete providerDispatchModes[provider];
   const result = await client.putProject(name, {
     displayName: nextDisplayName,
     canonicalDomain: opts.domain ?? project.canonicalDomain,
@@ -12074,10 +12286,15 @@ async function updateProjectSettings(name, opts) {
     labels: project.labels,
     providers: opts.providers ?? project.providers,
     providerModels,
+    ...touchesDispatch ? { providerDispatchModes } : {},
     locations: project.locations,
     defaultLocation: project.defaultLocation,
-    autoExtractBacklinks: project.autoExtractBacklinks
+    autoExtractBacklinks: project.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 } : {}
   });
+  warnDroppedDispatchModes(touchesDispatch ? providerDispatchModes : project.providerDispatchModes ?? {}, result);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
@@ -12190,7 +12407,7 @@ async function setDefaultLocation(project, label, format) {
 var PROJECT_CLI_COMMANDS = [
   {
     path: ["project", "create"],
-    usage: "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--format json]",
+    usage: "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--dispatch-mode provider=sync|batch...] [--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" },
@@ -12200,13 +12417,14 @@ var PROJECT_CLI_COMMANDS = [
       language: stringOption(),
       "display-name": stringOption(),
       provider: multiStringOption(),
-      "provider-model": multiStringOption()
+      "provider-model": multiStringOption(),
+      "dispatch-mode": multiStringOption()
     },
     run: async (input) => {
       const name = requireProject(
         input,
         "project.create",
-        "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--format json]"
+        "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--dispatch-mode provider=sync|batch...] [--format json]"
       );
       await createProject(name, {
         domain: getString(input.values, "domain") ?? name,
@@ -12217,13 +12435,14 @@ var PROJECT_CLI_COMMANDS = [
         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")),
         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>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--format json]",
+    usage: "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-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>] [--format json]",
     options: {
       domain: { type: "string", short: "d" },
       "owned-domain": multiStringOption(),
@@ -12238,13 +12457,16 @@ var PROJECT_CLI_COMMANDS = [
       provider: multiStringOption(),
       "all-providers": { type: "boolean" },
       "provider-model": multiStringOption(),
-      "clear-provider-model": multiStringOption()
+      "clear-provider-model": multiStringOption(),
+      "dispatch-mode": multiStringOption(),
+      "clear-dispatch-mode": multiStringOption(),
+      "negative-review-max-stars": 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>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--format json]"
+        "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-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>] [--format json]"
       );
       const providers = getStringArray(input.values, "provider");
       const allProviders = getBoolean(input.values, "all-providers");
@@ -12254,6 +12476,11 @@ var PROJECT_CLI_COMMANDS = [
       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"),
@@ -12268,6 +12495,9 @@ var PROJECT_CLI_COMMANDS = [
         providers: allProviders ? [] : providers,
         providerModels,
         clearProviderModels,
+        dispatchModes,
+        clearDispatchModes,
+        negativeReviewMaxStars: parseNegativeReviewMaxStars(getString(input.values, "negative-review-max-stars")),
         format: input.format
       });
     }
@@ -12383,6 +12613,18 @@ var PROJECT_CLI_COMMANDS = [
     }
   }
 ];
+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;
+}
 function parseProviderModelAssignments(assignments) {
   const result = {};
   for (const assignment of assignments ?? []) {
@@ -12395,6 +12637,18 @@ function parseProviderModelAssignments(assignments) {
   }
   return result;
 }
+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;
+}
 
 // src/commands/report.ts
 import fs13 from "fs";
@@ -12530,6 +12784,27 @@ function getClient23() {
   return createApiClient();
 }
 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)
+      }))
+    }
+  });
+}
 async function triggerRun(project, opts) {
   const client = getClient23();
   const body = {};
@@ -12559,19 +12834,22 @@ async function triggerRun(project, opts) {
   if (opts?.probe) {
     body.trigger = "probe";
   }
+  if (opts?.dispatchMode) {
+    body.dispatchMode = opts.dispatchMode;
+  }
   const response = await client.triggerRun(project, body);
   if (Array.isArray(response)) {
     const locationRuns = response;
     if (isMachineFormat(opts?.format)) {
       if (opts?.wait) {
-        const settled = await Promise.all(
-          locationRuns.map(async (r) => {
-            if (!r.id || r.status === "conflict") return r;
-            const final = await pollRun2(client, r.id);
-            return { ...r, ...final };
-          })
+        const finals = await Promise.all(
+          locationRuns.map(async (r) => !r.id || r.status === "conflict" ? null : pollRun2(client, r.id, false))
         );
-        console.log(JSON.stringify(settled, null, 2));
+        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, location: r.location ?? null, error: final.error }] : [];
+        }));
       } else {
         console.log(JSON.stringify(locationRuns, null, 2));
       }
@@ -12588,12 +12866,17 @@ async function triggerRun(project, opts) {
     }
     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");
@@ -12602,20 +12885,31 @@ async function triggerRun(project, opts) {
           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, location: r.location ?? null, error: errors.get(r.id) })));
     }
     return;
   }
   const run = response;
   if (opts?.wait && run.id && !TERMINAL_STATUSES.has(run.status)) {
-    process.stderr.write(`Run ${run.id} started`);
-    const result = await pollRun2(client, run.id);
+    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, error: result.error }]);
     return;
   }
   if (opts?.wait && (TERMINAL_STATUSES.has(run.status) || !run.id)) {
@@ -12625,6 +12919,7 @@ async function triggerRun(project, opts) {
     } else {
       printRunDetail(result);
     }
+    throwIfWaitedRunFailed([{ runId: result.id, status: result.status, project, error: result.error }]);
     return;
   }
   if (isMachineFormat(opts?.format)) {
@@ -12661,6 +12956,9 @@ async function triggerRunAll(opts) {
   if (opts?.noLocation) {
     baseBody.noLocation = true;
   }
+  if (opts?.dispatchMode) {
+    baseBody.dispatchMode = opts.dispatchMode;
+  }
   const results = [];
   for (const p of projects2) {
     const body = { ...baseBody };
@@ -12683,19 +12981,27 @@ async function triggerRunAll(opts) {
       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) {
-      process.stderr.write(`Waiting for ${pending.length} run(s)`);
+      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);
+        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);
       }));
-      process.stderr.write("\n");
+      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);
     return;
   }
   const showLocationColumn = results.some((r) => r.location !== null);
@@ -12720,6 +13026,12 @@ async function triggerRunAll(opts) {
       console.log(`  ${proj}  ${id}  ${r.status}`);
     }
   }
+  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(project, runId, format) {
   const client = getClient23();
@@ -12803,7 +13115,7 @@ async function listRuns(project, opts) {
   }
 }
 var POLL_TIMEOUT_MS3 = 10 * 60 * 1e3;
-async function pollRun2(client, runId) {
+async function pollRun2(client, runId, showProgress = true) {
   const deadline = Date.now() + POLL_TIMEOUT_MS3;
   for (; ; ) {
     await new Promise((r) => setTimeout(r, 2e3));
@@ -12811,12 +13123,22 @@ async function pollRun2(client, runId) {
       throw new Error(`Timed out waiting for run ${runId} after ${POLL_TIMEOUT_MS3 / 1e3}s`);
     }
     const run = await client.getRun(runId);
-    process.stderr.write(".");
-    if (TERMINAL_STATUSES.has(run.status)) {
+    if (showProgress) process.stderr.write(".");
+    if (TERMINAL_STATUSES.has(run.status) || outstandingBatches(run).length > 0) {
       return run;
     }
   }
 }
+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}`);
@@ -12833,6 +13155,13 @@ function printRunDetail(run) {
       }
     }
   }
+  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)}`);
+  }
+  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)`);
@@ -12844,6 +13173,46 @@ function printRunDetail(run) {
     }
   }
 }
+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 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));
+}
 var FILL_POLL_INTERVAL_MS = 3e3;
 var FILL_POLL_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
 function missingSummary(completeness) {
@@ -12931,8 +13300,8 @@ async function fillRun(runId, opts = {}) {
 }
 
 // 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] [--wait] [--format json]";
-var RUN_USAGE2 = "canonry run <project|--all> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--wait] [--format json]";
+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] [--wait] [--format json]";
+var RUN_USAGE2 = "canonry run <project|--all> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--dispatch-mode sync|batch] [--wait] [--format json]";
 var RUN_FILL_USAGE = "canonry run fill <run-id> [--provider <name>[,<name>]] [--dry-run] [--wait] [--format json]";
 var RUNS_USAGE = "canonry runs <project> [--limit <n>] [--kind <kind>] [--status <status>] [--format json]";
 var RUN_TRIGGER_OPTIONS = {
@@ -12951,13 +13320,26 @@ var RUN_TRIGGER_OPTIONS = {
   // for inspection but are excluded from dashboard / analytics /
   // intelligence / notifications. Use when you want to verify a
   // provider works without polluting the project's metrics.
-  probe: { type: "boolean", default: false }
+  probe: { type: "boolean", default: false },
+  // `batch` sends every provider that can to its asynchronous batch API (a
+  // full plan sweep, enabled in config.yaml); refused when none can.
+  "dispatch-mode": stringOption()
 };
+function parseDispatchMode(value, command, usage) {
+  if (value === void 0) return void 0;
+  const parsed = providerDispatchModeSchema.safeParse(value.trim().toLowerCase());
+  if (parsed.success) return parsed.data;
+  throw usageError(`Error: --dispatch-mode must be one of: ${providerDispatchModeSchema.options.join(", ")} (received ${value})`, {
+    message: "--dispatch-mode must be sync or batch",
+    details: { command, usage }
+  });
+}
 async function triggerRunCommand(input, command) {
   const groups = getStringArray(input.values, "group") ?? [];
   const targets = getStringArray(input.values, "target") ?? [];
   const queries2 = getStringArray(input.values, "query") ?? [];
   const usage = command === "run" ? RUN_USAGE2 : RUN_TRIGGER_USAGE;
+  const dispatchMode = parseDispatchMode(getString(input.values, "dispatch-mode"), command, usage);
   if (getBoolean(input.values, "all")) {
     if (input.positionals.length > 0) {
       throw usageError("Error: --all cannot be combined with a project name", {
@@ -12988,6 +13370,7 @@ async function triggerRunCommand(input, command) {
       wait: getBoolean(input.values, "wait"),
       allLocations: getBoolean(input.values, "all-locations"),
       noLocation: getBoolean(input.values, "no-location"),
+      dispatchMode,
       format: input.format
     });
     return;
@@ -13014,6 +13397,7 @@ async function triggerRunCommand(input, command) {
     allLocations: getBoolean(input.values, "all-locations"),
     noLocation: getBoolean(input.values, "no-location"),
     probe: getBoolean(input.values, "probe"),
+    dispatchMode,
     format: input.format
   });
 }
@@ -13471,7 +13855,7 @@ var SETTINGS_CLI_COMMANDS = [
       const name = requirePositional(input, 0, {
         command: "settings.provider",
         usage: "canonry settings provider <name> [--api-key <key>] [--base-url <url>] [--model <model>] [--max-concurrent <n>] [--max-per-minute <n>] [--max-per-day <n>] [--format json]",
-        message: "provider name is required (e.g. gemini, openai, claude, perplexity, local)"
+        message: "provider name is required (e.g. gemini, openai, claude, perplexity, muse, local)"
       });
       const apiKey = getString(input.values, "api-key");
       const baseUrl = getString(input.values, "base-url");
@@ -15057,6 +15441,7 @@ async function bootstrapCommand(opts) {
   if (providers.openai) mergedProviders.openai = providers.openai;
   if (providers.claude) mergedProviders.claude = providers.claude;
   if (providers.perplexity) mergedProviders.perplexity = providers.perplexity;
+  if (providers.muse) mergedProviders.muse = providers.muse;
   if (providers.local) mergedProviders.local = providers.local;
   if (env.googleClientId && !env.googleClientSecret || !env.googleClientId && env.googleClientSecret) {
     console.warn("Warning: GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET must both be set to configure Google OAuth. Skipping Google auth config.");
@@ -15450,6 +15835,7 @@ async function initCommand(opts) {
     OPENAI_API_KEY: opts?.openaiKey,
     ANTHROPIC_API_KEY: opts?.claudeKey,
     PERPLEXITY_API_KEY: opts?.perplexityKey,
+    MUSE_API_KEY: opts?.museKey,
     LOCAL_BASE_URL: opts?.localUrl,
     LOCAL_MODEL: opts?.localModel,
     LOCAL_API_KEY: opts?.localKey,
@@ -15468,7 +15854,7 @@ async function initCommand(opts) {
   }
   const envProviders = bootstrapEnv.providers;
   const envGoogleConfigured = !!(bootstrapEnv.googleClientId && bootstrapEnv.googleClientSecret);
-  const nonInteractive = !!(envProviders.gemini || envProviders.openai || envProviders.claude || envProviders.perplexity || envProviders.local || envGoogleConfigured);
+  const nonInteractive = !!(envProviders.gemini || envProviders.openai || envProviders.claude || envProviders.perplexity || envProviders.muse || envProviders.local || envGoogleConfigured);
   const providers = {};
   let google;
   if (isMachineFormat(format) && !nonInteractive) {
@@ -15494,6 +15880,7 @@ async function initCommand(opts) {
     console.log("Configure AI providers (at least one required):\n");
     console.log("Tip: For non-interactive setup, pass provider flags or set");
     console.log("GEMINI_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, PERPLEXITY_API_KEY,");
+    console.log("MUSE_API_KEY,");
     console.log("GOOGLE_CLIENT_ID, and GOOGLE_CLIENT_SECRET env vars.");
     console.log('Or use "canonry bootstrap".\n');
     const geminiApiKey = await promptProviderApiKey("Gemini", "GEMINI_API_KEY");
@@ -15516,6 +15903,11 @@ async function initCommand(opts) {
       const perplexityModel = await prompt("  Perplexity preset or model [fast]: ") || "fast";
       providers.perplexity = { apiKey: perplexityApiKey, model: perplexityModel, quota: DEFAULT_QUOTA };
     }
+    const museApiKey = await promptProviderApiKey("Muse", "MUSE_API_KEY");
+    if (museApiKey) {
+      const museModel = await prompt("  Muse model [muse-spark-1.3]: ") || "muse-spark-1.3";
+      providers.muse = { apiKey: museApiKey, model: museModel, quota: DEFAULT_QUOTA };
+    }
     console.log("\nLocal LLM (Ollama, LM Studio, llama.cpp, vLLM \u2014 any OpenAI-compatible API):");
     const localBaseUrl = await prompt("Local LLM base URL (press Enter to skip, e.g. http://localhost:11434/v1): ");
     if (localBaseUrl) {
@@ -15544,7 +15936,7 @@ async function initCommand(opts) {
       };
     }
   }
-  const hasProvider = providers.gemini || providers.openai || providers.claude || providers.perplexity || providers.local;
+  const hasProvider = providers.gemini || providers.openai || providers.claude || providers.perplexity || providers.muse || providers.local;
   if (!hasProvider) {
     throw new CliError({
       code: "INIT_PROVIDER_REQUIRED",
@@ -16261,7 +16653,7 @@ var SYSTEM_CLI_COMMANDS = [
   },
   {
     path: ["init"],
-    usage: "canonry init [--force] [--gemini-key <key>] [--openai-key <key>] [--claude-key <key>] [--perplexity-key <key>] [--local-url <url>] [--local-model <name>] [--local-key <key>] [--google-client-id <id>] [--google-client-secret <key>] [--skip-skills] [--skip-mcp] [--skills-dir <path>] [--format json]",
+    usage: "canonry init [--force] [--gemini-key <key>] [--openai-key <key>] [--claude-key <key>] [--perplexity-key <key>] [--muse-key <key>] [--local-url <url>] [--local-model <name>] [--local-key <key>] [--google-client-id <id>] [--google-client-secret <key>] [--skip-skills] [--skip-mcp] [--skills-dir <path>] [--format json]",
     help: 'Optional interactive provider and OAuth setup. First-run Page Health does not need this: use "canonry bootstrap", then "canonry serve". At least one provider is required here. --format json needs provider flags or environment variables.',
     options: {
       force: { type: "boolean", short: "f", default: false },
@@ -16269,6 +16661,7 @@ var SYSTEM_CLI_COMMANDS = [
       "openai-key": stringOption(),
       "claude-key": stringOption(),
       "perplexity-key": stringOption(),
+      "muse-key": stringOption(),
       "local-url": stringOption(),
       "local-model": stringOption(),
       "local-key": stringOption(),
@@ -16286,6 +16679,7 @@ var SYSTEM_CLI_COMMANDS = [
         openaiKey: getString(input.values, "openai-key"),
         claudeKey: getString(input.values, "claude-key"),
         perplexityKey: getString(input.values, "perplexity-key"),
+        museKey: getString(input.values, "muse-key"),
         localUrl: getString(input.values, "local-url"),
         localModel: getString(input.values, "local-model"),
         localKey: getString(input.values, "local-key"),
@@ -19786,6 +20180,7 @@ var TELEMETRY_ERROR_CODES = /* @__PURE__ */ new Set([
   "RUN_FILL_REFUSED",
   "RUN_FILL_IN_PROGRESS",
   "RUN_FILL_INCOMPLETE",
+  "RUN_FAILED",
   "API_ERROR",
   "CLI_ERROR",
   "CLI_USAGE_ERROR",