@ainyc/canonry 4.71.1 → 4.72.2

package/dist/cli.js

@@ -27,7 +27,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-CWEV3YMZ.js";
+} from "./chunk-BRXQKUGY.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -44,7 +44,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-ZNWMVYYU.js";
+} from "./chunk-NYZSY5QJ.js";
 import {
   apiKeys,
   createClient,
@@ -52,7 +52,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-ETJDAMGA.js";
+} from "./chunk-J7SDOU2J.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -69,8 +69,9 @@ import {
   normalizeProjectAliases,
   notificationEventSchema,
   providerQuotaPolicySchema,
-  resolveProviderInput
-} from "./chunk-5FM7QRYD.js";
+  resolveProviderInput,
+  winnabilityClassSchema
+} from "./chunk-SJI6JGPN.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -2548,7 +2549,7 @@ async function gaSocialReferralSummary(project, opts) {
     console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
     console.log(`  Users:    ${traffic.socialUsers}`);
     console.log();
-    const fmtTrend = (pct2) => pct2 === null ? "n/a" : `${pct2 >= 0 ? "+" : ""}${pct2}%`;
+    const fmtTrend = (pct3) => pct3 === null ? "n/a" : `${pct3 >= 0 ? "+" : ""}${pct3}%`;
     console.log(`  7d trend:  ${fmtTrend(trend.trend7dPct)} (${trend.socialSessions7d} vs ${trend.socialSessionsPrev7d})`);
     console.log(`  30d trend: ${fmtTrend(trend.trend30dPct)} (${trend.socialSessions30d} vs ${trend.socialSessionsPrev30d})`);
     if (trend.biggestMover) {
@@ -2591,7 +2592,7 @@ async function gaSocialReferralSummary(project, opts) {
 async function gaAttribution(project, opts) {
   const client = getClient5();
   const traffic = await client.gaTraffic(project);
-  const fmtTrend = (pct2) => pct2 === null ? "n/a" : `${pct2 >= 0 ? "+" : ""}${pct2}%`;
+  const fmtTrend = (pct3) => pct3 === null ? "n/a" : `${pct3 >= 0 ? "+" : ""}${pct3}%`;
   if (opts?.trend) {
     const trend = await client.gaAttributionTrend(project);
     if (isMachineFormat(opts.format)) {
@@ -3155,9 +3156,9 @@ async function gbpPlaces(project, opts) {
     console.log(`  ${p.locationName}  [${p.tier}]  ${amenities}`);
   }
 }
-function fmtDelta(pct2) {
-  if (pct2 === null) return "n/a";
-  return `${pct2 >= 0 ? "+" : ""}${pct2}%`;
+function fmtDelta(pct3) {
+  if (pct3 === null) return "n/a";
+  return `${pct3 >= 0 ? "+" : ""}${pct3}%`;
 }
 async function gbpSummary(project, opts) {
   const client = getClient6();
@@ -6575,7 +6576,7 @@ async function showAnalytics(project, options) {
         break;
       }
       case "sources": {
-        const data = await client.getAnalyticsSources(project, options.window);
+        const data = await client.getAnalyticsSources(project, { window: options.window });
         results.sources = data;
         if (!isMachineFormat(options.format)) printSources(data);
         break;
@@ -6600,14 +6601,14 @@ function printMetrics(data) {
   console.log(`
 Citation Rate Trends (${data.window})`);
   console.log("\u2500".repeat(50));
-  const pct2 = (n) => `${(n * 100).toFixed(1)}%`;
-  console.log(`  Overall: ${pct2(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
+  const pct3 = (n) => `${(n * 100).toFixed(1)}%`;
+  console.log(`  Overall: ${pct3(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
   console.log(`  Trend:   ${data.trend}`);
   if (Object.keys(data.byProvider).length > 0) {
     console.log(`
   By Provider:`);
     for (const [provider, metric] of Object.entries(data.byProvider)) {
-      console.log(`    ${provider.padEnd(10)} ${pct2(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
+      console.log(`    ${provider.padEnd(10)} ${pct3(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
     }
   }
   if (data.buckets.length > 0) {
@@ -6616,7 +6617,7 @@ Citation Rate Trends (${data.window})`);
     for (const bucket of data.buckets) {
       const start = bucket.startDate.slice(0, 10);
       const bar = bucket.total > 0 ? "\u2588".repeat(Math.round(bucket.citationRate * 20)) : "";
-      console.log(`    ${start}  ${pct2(bucket.citationRate).padStart(6)}  ${bar}`);
+      console.log(`    ${start}  ${pct3(bucket.citationRate).padStart(6)}  ${bar}`);
     }
   }
   const providersInBuckets = [...new Set(data.buckets.flatMap((b) => Object.keys(b.byProvider ?? {})))].sort();
@@ -6630,7 +6631,7 @@ Citation Rate Trends (${data.window})`);
         if (!metric) continue;
         const start = bucket.startDate.slice(0, 10);
         const bar = metric.total > 0 ? "\u2588".repeat(Math.round(metric.citationRate * 20)) : "";
-        console.log(`      ${start}  ${pct2(metric.citationRate).padStart(6)}  ${bar}`);
+        console.log(`      ${start}  ${pct3(metric.citationRate).padStart(6)}  ${bar}`);
       }
     }
   }
@@ -6668,18 +6669,80 @@ Source Origin Breakdown`);
     return;
   }
   for (const cat of data.overall) {
-    const pct2 = `${(cat.percentage * 100).toFixed(1)}%`;
+    const pct3 = `${(cat.percentage * 100).toFixed(1)}%`;
     const domains = cat.topDomains.slice(0, 3).map((d) => d.domain).join(", ");
-    console.log(`  ${cat.label.padEnd(20)} ${pct2.padStart(6)}  (${cat.count})  ${domains}`);
+    console.log(`  ${cat.label.padEnd(20)} ${pct3.padStart(6)}  (${cat.count})  ${domains}`);
   }
 }
 
-// src/commands/evidence.ts
+// src/commands/sources.ts
 function getClient15() {
   return createApiClient();
 }
-async function showEvidence(project, format) {
+var pct = (n) => `${(n * 100).toFixed(1)}%`;
+async function showSources(project, options) {
+  if (options.limit !== void 0 && (!Number.isInteger(options.limit) || options.limit <= 0)) {
+    throw usageError("Error: --limit must be a positive integer\nUsage: canonry sources <project> [--rank] [--limit N] [--by-provider] [--window 7d|30d|90d|all] [--format json|jsonl]", {
+      message: "--limit must be a positive integer",
+      details: { command: "sources", option: "limit", value: options.limit }
+    });
+  }
   const client = getClient15();
+  const data = await client.getAnalyticsSources(project, { window: options.window, limit: options.limit });
+  if (options.format === "jsonl") {
+    emitJsonl(data.ranked.entries.map((e) => ({ project, ...e })));
+    return;
+  }
+  if (isMachineFormat(options.format)) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  printSourceRankings(data, options);
+}
+function printSourceRankings(data, options) {
+  console.log(`
+Source Rankings (${data.window})`);
+  console.log("\u2500".repeat(50));
+  if (data.ranked.totalCitedSlots === 0) {
+    console.log("  No source data available");
+    return;
+  }
+  console.log("\n  By surface class:");
+  printSurfaceClasses(data.ranked);
+  if (options.rank) {
+    console.log("\n  Top sources:");
+    printRankedEntries(data.ranked);
+  }
+  if (options.byProvider) {
+    console.log("\n  By provider:");
+    for (const [provider, list] of Object.entries(data.byProvider)) {
+      console.log(`
+    ${provider} (${list.totalCitedSlots} cited slots):`);
+      printRankedEntries(list, "    ");
+    }
+  }
+}
+function printSurfaceClasses(list) {
+  for (const c of list.bySurfaceClass) {
+    const noun = c.domainCount === 1 ? "domain" : "domains";
+    console.log(`    ${c.label.padEnd(28)} ${pct(c.percentage).padStart(6)}  (${c.count})  ${c.domainCount} ${noun}`);
+  }
+}
+function printRankedEntries(list, indent = "") {
+  for (const e of list.entries) {
+    console.log(`${indent}    ${e.domain.padEnd(32)} ${String(e.count).padStart(4)}  ${pct(e.percentage).padStart(6)}  ${e.surfaceClass}`);
+  }
+  if (list.truncatedDomainCount > 0) {
+    console.log(`${indent}    \u2026 +${list.truncatedDomainCount} more domains (${list.truncatedCitedSlots} cited slots)`);
+  }
+}
+
+// src/commands/evidence.ts
+function getClient16() {
+  return createApiClient();
+}
+async function showEvidence(project, format) {
+  const client = getClient16();
   const timeline = await client.getTimeline(project);
   if (format === "json") {
     const enriched = timeline.map((entry) => ({
@@ -6746,11 +6809,11 @@ async function loadLatestRunForExport(client, project) {
 }
 
 // src/commands/history.ts
-function getClient16() {
+function getClient17() {
   return createApiClient();
 }
 async function showHistory(project, format) {
-  const client = getClient16();
+  const client = getClient17();
   try {
     const entries = await client.getHistory(project);
     if (format === "json") {
@@ -6789,11 +6852,11 @@ async function showHistory(project, format) {
 }
 
 // src/commands/status.ts
-function getClient17() {
+function getClient18() {
   return createApiClient();
 }
 async function showStatus(project, format) {
-  const client = getClient17();
+  const client = getClient18();
   const projectData = await client.getProject(project);
   const latest = await getLatestRunSummary(client, project);
   if (isMachineFormat(format)) {
@@ -6905,6 +6968,31 @@ var OPERATOR_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["sources"],
+    usage: "canonry sources <project> [--rank] [--limit N] [--by-provider] [--window 7d|30d|90d|all] [--format json|jsonl]",
+    options: {
+      rank: { type: "boolean", default: false },
+      "by-provider": { type: "boolean", default: false },
+      limit: stringOption(),
+      window: stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry sources <project> [--rank] [--limit N] [--by-provider] [--window 7d|30d|90d|all] [--format json|jsonl]";
+      const project = requireProject(input, "sources", usage);
+      await showSources(project, {
+        rank: getBoolean(input.values, "rank"),
+        byProvider: getBoolean(input.values, "by-provider"),
+        limit: parseIntegerOption(input, "limit", {
+          message: "--limit must be an integer",
+          usage,
+          command: "sources"
+        }),
+        window: getString(input.values, "window"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["apply"],
     usage: "canonry apply <file...> [--format json]",
@@ -6924,11 +7012,11 @@ var OPERATOR_CLI_COMMANDS = [
 ];
 
 // src/commands/project.ts
-function getClient18() {
+function getClient19() {
   return createApiClient();
 }
 async function createProject(name, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.putProject(name, {
     displayName: opts.displayName,
     canonicalDomain: opts.domain,
@@ -6944,7 +7032,7 @@ async function createProject(name, opts) {
   console.log(`Project created: ${result.name} (${result.id})`);
 }
 async function listProjects(format) {
-  const client = getClient18();
+  const client = getClient19();
   const projects2 = await client.listProjects();
   if (format === "json") {
     console.log(JSON.stringify(projects2, null, 2));
@@ -6976,7 +7064,7 @@ async function listProjects(format) {
   }
 }
 async function showProject(name, format) {
-  const client = getClient18();
+  const client = getClient19();
   const project = await client.getProject(name);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(project, null, 2));
@@ -7005,7 +7093,7 @@ async function showProject(name, format) {
   if (project.updatedAt) console.log(`  Updated:          ${project.updatedAt}`);
 }
 async function updateProjectSettings(name, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const project = await client.getProject(name);
   let ownedDomains = opts.ownedDomains ?? project.ownedDomains ?? [];
   if (opts.addOwnedDomain) {
@@ -7042,7 +7130,7 @@ async function updateProjectSettings(name, opts) {
   console.log(`Project updated: ${result.name}`);
 }
 async function deleteProject(name, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const isJson = isMachineFormat(opts?.format);
   if (opts?.dryRun) {
     const preview = await client.previewProjectDelete(name);
@@ -7072,7 +7160,7 @@ async function deleteProject(name, opts) {
   console.log(`Project deleted: ${name}`);
 }
 async function addLocation(project, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const location = await client.addLocation(project, {
     label: opts.label,
     city: opts.city,
@@ -7087,7 +7175,7 @@ async function addLocation(project, opts) {
   console.log(`Location added: ${opts.label} (${opts.city}, ${opts.region}, ${opts.country})`);
 }
 async function listLocations(project, format) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.listLocations(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -7121,7 +7209,7 @@ async function listLocations(project, format) {
   }
 }
 async function removeLocation(project, label, format) {
-  const client = getClient18();
+  const client = getClient19();
   await client.removeLocation(project, label);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, label, removed: true }, null, 2));
@@ -7130,7 +7218,7 @@ async function removeLocation(project, label, format) {
   console.log(`Location removed: ${label}`);
 }
 async function setDefaultLocation(project, label, format) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.setDefaultLocation(project, label);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({ project, ...result }, null, 2));
@@ -7371,12 +7459,12 @@ var REPORT_CLI_COMMANDS = [
 ];
 
 // src/commands/run.ts
-function getClient19() {
+function getClient20() {
   return createApiClient();
 }
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
 async function triggerRun(project, opts) {
-  const client = getClient19();
+  const client = getClient20();
   const body = {};
   if (opts?.provider) {
     const providerInputs = opts.provider.split(",").map((s) => s.trim()).filter(Boolean);
@@ -7478,7 +7566,7 @@ async function triggerRun(project, opts) {
   }
 }
 async function triggerRunAll(opts) {
-  const client = getClient19();
+  const client = getClient20();
   const projects2 = await client.listProjects();
   if (projects2.length === 0) {
     if (isMachineFormat(opts?.format)) {
@@ -7561,7 +7649,7 @@ async function triggerRunAll(opts) {
   }
 }
 async function cancelRun(project, runId, format) {
-  const client = getClient19();
+  const client = getClient20();
   let targetId = runId;
   if (!targetId) {
     const runs = await client.listRuns(project);
@@ -7593,7 +7681,7 @@ To cancel by ID  : canonry run cancel ${project} <run-id>`,
   console.log(`Run ${result.id} cancelled.`);
 }
 async function showRun(id, format) {
-  const client = getClient19();
+  const client = getClient20();
   const run = await client.getRun(id);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(run, null, 2));
@@ -7602,7 +7690,7 @@ async function showRun(id, format) {
   printRunDetail(run);
 }
 async function listRuns(project, opts) {
-  const client = getClient19();
+  const client = getClient20();
   const runs = await client.listRuns(project, opts?.limit, opts?.kind);
   if (opts?.format === "json") {
     console.log(JSON.stringify(runs, null, 2));
@@ -7777,11 +7865,11 @@ var RUN_CLI_COMMANDS = [
 ];
 
 // src/commands/schedule.ts
-function getClient20() {
+function getClient21() {
   return createApiClient();
 }
 async function setSchedule(project, opts) {
-  const client = getClient20();
+  const client = getClient21();
   const body = {};
   if (opts.kind) body.kind = opts.kind;
   if (opts.sourceId) body.sourceId = opts.sourceId;
@@ -7798,7 +7886,7 @@ async function setSchedule(project, opts) {
   printSchedule(result);
 }
 async function showSchedule(project, format, kind) {
-  const client = getClient20();
+  const client = getClient21();
   const result = await client.getSchedule(project, kind);
   if (isMachineFormat(format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -7807,7 +7895,7 @@ async function showSchedule(project, format, kind) {
   printSchedule(result);
 }
 async function enableSchedule(project, format, kind) {
-  const client = getClient20();
+  const client = getClient21();
   const current = await client.getSchedule(project, kind);
   const body = { kind: current.kind, timezone: current.timezone, enabled: true };
   if (current.preset) body.preset = current.preset;
@@ -7822,7 +7910,7 @@ async function enableSchedule(project, format, kind) {
   console.log(`Schedule enabled for "${project}" (kind: ${result.kind})`);
 }
 async function disableSchedule(project, format, kind) {
-  const client = getClient20();
+  const client = getClient21();
   const current = await client.getSchedule(project, kind);
   const body = { kind: current.kind, timezone: current.timezone, enabled: false };
   if (current.preset) body.preset = current.preset;
@@ -7837,7 +7925,7 @@ async function disableSchedule(project, format, kind) {
   console.log(`Schedule disabled for "${project}" (kind: ${result.kind})`);
 }
 async function removeSchedule(project, format, kind) {
-  const client = getClient20();
+  const client = getClient21();
   await client.deleteSchedule(project, kind);
   const resolvedKind = kind ?? "answer-visibility";
   if (isMachineFormat(format)) {
@@ -7955,11 +8043,11 @@ var SCHEDULE_CLI_COMMANDS = [
 ];
 
 // src/commands/settings.ts
-function getClient21() {
+function getClient22() {
   return createApiClient();
 }
 async function setProvider(name, opts) {
-  const client = getClient21();
+  const client = getClient22();
   const { format, ...payload } = opts;
   const result = await client.updateProvider(name, payload);
   if (isMachineFormat(format)) {
@@ -7975,7 +8063,7 @@ async function setProvider(name, opts) {
   }
 }
 async function showSettings(format) {
-  const client = getClient21();
+  const client = getClient22();
   const config = loadConfig();
   const settings = await client.getSettings();
   if (isMachineFormat(format)) {
@@ -8522,7 +8610,7 @@ function wrapText(font, text, size, maxWidth) {
 }
 
 // src/commands/snapshot.ts
-function getClient22() {
+function getClient23() {
   return createApiClient();
 }
 function slugify(value) {
@@ -8533,7 +8621,7 @@ function autoOutputPath(companyName, ext) {
   return `${slugify(companyName)}-snapshot-${date}.${ext}`;
 }
 async function createSnapshotReport(companyName, opts) {
-  const client = getClient22();
+  const client = getClient23();
   const report = await client.createSnapshot({
     companyName,
     domain: opts.domain,
@@ -8930,8 +9018,8 @@ function renderHuman(overview) {
   printScore("Competitor press.", scores.competitorPressure);
   printScore("Run status       ", scores.runStatus);
   console.log(`
-  Queries cited:     ${queryCounts.citedQueries}/${queryCounts.totalQueries} (${pct(queryCounts.citedRate)})`);
-  console.log(`  Queries mentioned: ${queryCounts.mentionedQueries}/${queryCounts.totalQueries} (${pct(queryCounts.mentionRate)})`);
+  Queries cited:     ${queryCounts.citedQueries}/${queryCounts.totalQueries} (${pct2(queryCounts.citedRate)})`);
+  console.log(`  Queries mentioned: ${queryCounts.mentionedQueries}/${queryCounts.totalQueries} (${pct2(queryCounts.mentionRate)})`);
   if (movementSummary.hasPreviousRun) {
     console.log(`  Movement: +${movementSummary.gained} gained, -${movementSummary.lost} lost (${movementSummary.tone})`);
   } else if (movementSummary.gained > 0) {
@@ -8940,7 +9028,7 @@ function renderHuman(overview) {
   if (providers.length > 0) {
     console.log("\n  Providers:");
     for (const p of providers) {
-      console.log(`    ${p.provider.padEnd(12)} ${p.cited}/${p.total} (${pct(p.citedRate)})`);
+      console.log(`    ${p.provider.padEnd(12)} ${p.cited}/${p.total} (${pct2(p.citedRate)})`);
     }
   }
   if (providerScores.length > 0) {
@@ -8969,7 +9057,7 @@ function renderHuman(overview) {
   }
   if (health) {
     console.log(`
-  Health: ${pct(health.overallCitedRate)} cited (${health.citedPairs}/${health.totalPairs} pairs)`);
+  Health: ${pct2(health.overallCitedRate)} cited (${health.citedPairs}/${health.totalPairs} pairs)`);
   }
   if (topInsights.length > 0) {
     console.log("\n  Top insights:");
@@ -9009,14 +9097,14 @@ function printMentionShareBreakdown(mentionShare) {
   const youPct = (breakdown.projectMentionSnapshots / total * 100).toFixed(1);
   console.log(`      you${" ".repeat(28)} ${breakdown.projectMentionSnapshots} mentions (${youPct}% of combined)`);
   for (const row of breakdown.perCompetitor.slice(0, 3)) {
-    const pct2 = (row.mentionSnapshots / total * 100).toFixed(1);
-    console.log(`      ${row.domain.padEnd(30)} ${row.mentionSnapshots} mentions (${pct2}% of combined)`);
+    const pct3 = (row.mentionSnapshots / total * 100).toFixed(1);
+    console.log(`      ${row.domain.padEnd(30)} ${row.mentionSnapshots} mentions (${pct3}% of combined)`);
   }
   if (breakdown.perCompetitor.length > 3) {
     console.log(`      + ${breakdown.perCompetitor.length - 3} more competitor${breakdown.perCompetitor.length - 3 === 1 ? "" : "s"} (--format json for full breakdown)`);
   }
 }
-function pct(value) {
+function pct2(value) {
   return `${(value * 100).toFixed(1)}%`;
 }
 
@@ -9244,11 +9332,14 @@ var INTELLIGENCE_CLI_COMMANDS = [
 ];
 
 // src/commands/content.ts
+var WINNABILITY_COVERAGE_CHECK_ID = "content.winnability.coverage";
 async function listContentTargets(project, opts) {
   const client = createApiClient();
   const response = await client.getContentTargets(project, {
     limit: opts.limit,
-    includeInProgress: opts.includeInProgress
+    includeInProgress: opts.includeInProgress,
+    winnabilityClass: opts.winnabilityClass,
+    ownable: opts.ownable
   });
   if (opts.format === "json") {
     console.log(JSON.stringify(response, null, 2));
@@ -9276,7 +9367,8 @@ async function listContentTargets(project, opts) {
     const action = target.action.toUpperCase().padEnd(11);
     const score = target.score.toFixed(1).padStart(6);
     const conf = target.actionConfidence.padEnd(6);
-    console.log(`${action} ${score}  conf=${conf}  ${target.query}`);
+    const surface = target.winnabilityClass === "ceded" ? "CEDED  " : "ownable";
+    console.log(`${action} ${score}  conf=${conf}  [${surface}]  ${target.query}`);
     if (target.ourBestPage) {
       const posLabel = target.ourBestPage.gscAvgPosition !== null ? `pos #${target.ourBestPage.gscAvgPosition}` : "no GSC ranking";
       console.log(`            our page: ${target.ourBestPage.url} (${posLabel})`);
@@ -9345,27 +9437,123 @@ async function listContentGaps(project, opts) {
     console.log("");
   }
 }
+async function generateContentBrief(project, targetRef, opts) {
+  const client = createApiClient();
+  await warnIfWinnabilityCoverageIsLow(client, project, opts.format);
+  const response = await client.synthesizeContentBrief(project, targetRef, {
+    provider: opts.provider,
+    model: opts.model,
+    forceRefresh: opts.force
+  });
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(response, null, 2));
+    return;
+  }
+  const b = response.brief;
+  console.log(`Brief for: ${b.targetQuery}`);
+  console.log(`Surface:   ${b.winnabilityClass}`);
+  console.log(`Provider:  ${response.provider} / ${response.model}`);
+  console.log("");
+  console.log(`Angle:               ${b.angle}`);
+  console.log(`Why winnable:        ${b.whyWinnable}`);
+  console.log(`Schema hookup:       ${b.schemaHookup}`);
+  console.log(`Controllable surface: ${b.controllableSurfaceRationale}`);
+}
+async function tryGetBrief(client, project, targetRef) {
+  try {
+    return await client.getContentBrief(project, targetRef);
+  } catch (err) {
+    if (err instanceof CliError && err.code === "NOT_FOUND") return null;
+    throw err;
+  }
+}
+async function contentMap(project, opts) {
+  const client = createApiClient();
+  await warnIfWinnabilityCoverageIsLow(client, project, opts.format);
+  const [classifications, targets] = await Promise.all([
+    client.getDomainClassifications(project),
+    client.getContentTargets(project, { ownable: true })
+  ]);
+  const ownable = await Promise.all(
+    targets.targets.map(async (target) => ({
+      ...target,
+      brief: (await tryGetBrief(client, project, target.targetRef))?.brief ?? null
+    }))
+  );
+  if (opts.format === "json") {
+    console.log(JSON.stringify({ classifications: classifications.classifications, ownable }, null, 2));
+    return;
+  }
+  if (opts.format === "jsonl") {
+    emitJsonl(ownable.map((row) => ({ project, ...row })));
+    return;
+  }
+  const ceded = classifications.classifications.filter(
+    (c) => c.competitorType === "ota-aggregator" || c.competitorType === "editorial-media"
+  );
+  console.log(
+    `${classifications.classifications.length} domain(s) classified (${ceded.length} ceded surface${ceded.length === 1 ? "" : "s"}) \xB7 ${ownable.length} ownable target(s)`
+  );
+  console.log("");
+  for (const row of ownable) {
+    const score = row.score.toFixed(1).padStart(6);
+    const briefMark = row.brief ? "brief \u2713" : "brief \u2014";
+    console.log(`${score}  ${briefMark}  ${row.query}`);
+    if (row.brief) {
+      console.log(`        angle: ${row.brief.angle}`);
+    }
+  }
+}
+function shouldWarn(check) {
+  return check?.status === "warn" || check?.status === "fail";
+}
+async function warnIfWinnabilityCoverageIsLow(client, project, format) {
+  if (isMachineFormat(format)) return;
+  let check;
+  try {
+    const report = await client.runDoctor({ project, checkIds: [WINNABILITY_COVERAGE_CHECK_ID] });
+    check = report.checks.find((candidate) => candidate.id === WINNABILITY_COVERAGE_CHECK_ID);
+  } catch {
+    return;
+  }
+  if (!shouldWarn(check)) return;
+  const remediation = check.remediation ? ` ${check.remediation}` : "";
+  console.error(`Warning: ${check.summary}${remediation}`);
+}
 
 // src/cli-commands/content.ts
 var CONTENT_CLI_COMMANDS = [
   {
     path: ["content", "targets"],
-    usage: "canonry content targets <project> [--limit <n>] [--include-in-progress] [--format json]",
+    usage: "canonry content targets <project> [--limit <n>] [--include-in-progress] [--ownable] [--winnability-class <ownable|ceded>] [--format json]",
     options: {
       limit: { type: "string" },
-      "include-in-progress": { type: "boolean" }
+      "include-in-progress": { type: "boolean" },
+      ownable: { type: "boolean" },
+      "winnability-class": { type: "string" }
     },
     run: async (input) => {
-      const usage = "canonry content targets <project> [--limit <n>] [--include-in-progress] [--format json]";
+      const usage = "canonry content targets <project> [--limit <n>] [--include-in-progress] [--ownable] [--winnability-class <ownable|ceded>] [--format json]";
       const project = requireProject(input, "content targets", usage);
       const limit = parseIntegerOption(input, "limit", {
         command: "content targets",
         usage,
         message: "--limit must be a non-negative integer"
       });
+      const rawWinnabilityClass = input.values["winnability-class"];
+      let winnabilityClass;
+      if (typeof rawWinnabilityClass === "string") {
+        const parsed = winnabilityClassSchema.safeParse(rawWinnabilityClass);
+        if (!parsed.success) {
+          throw usageError('Error: --winnability-class must be "ownable" or "ceded"', { message: usage });
+        }
+        winnabilityClass = parsed.data;
+      }
       await listContentTargets(project, {
         limit,
         includeInProgress: input.values["include-in-progress"] === true,
+        ownable: input.values.ownable === true,
+        winnabilityClass,
         format: input.format
       });
     }
@@ -9389,6 +9577,40 @@ var CONTENT_CLI_COMMANDS = [
       const project = requireProject(input, "content gaps", usage);
       await listContentGaps(project, { format: input.format });
     }
+  },
+  {
+    path: ["content", "brief"],
+    usage: "canonry content brief <project> <targetRef> [--provider <p>] [--model <m>] [--force] [--format json]",
+    options: {
+      provider: { type: "string" },
+      model: { type: "string" },
+      force: { type: "boolean" }
+    },
+    run: async (input) => {
+      const usage = "canonry content brief <project> <targetRef> [--provider <p>] [--model <m>] [--force] [--format json]";
+      const project = requireProject(input, "content brief", usage);
+      const targetRef = requirePositional(input, 1, {
+        command: "content brief",
+        usage,
+        message: "targetRef is required (from `canonry content targets`)"
+      });
+      await generateContentBrief(project, targetRef, {
+        provider: typeof input.values.provider === "string" ? input.values.provider : void 0,
+        model: typeof input.values.model === "string" ? input.values.model : void 0,
+        force: input.values.force === true,
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["content", "map"],
+    usage: "canonry content map <project> [--format json]",
+    options: {},
+    run: async (input) => {
+      const usage = "canonry content map <project> [--format json]";
+      const project = requireProject(input, "content map", usage);
+      await contentMap(project, { format: input.format });
+    }
   }
 ];
 
@@ -10480,7 +10702,7 @@ var SYSTEM_CLI_COMMANDS = [
 import fs11 from "fs";
 
 // src/commands/wordpress.ts
-function getClient23() {
+function getClient24() {
   return createApiClient();
 }
 async function loadYamlModule() {
@@ -10630,7 +10852,7 @@ async function wordpressConnect(project, opts) {
       details: { project }
     });
   }
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressConnect(project, {
     url: opts.url,
     stagingUrl: opts.stagingUrl,
@@ -10647,7 +10869,7 @@ async function wordpressConnect(project, opts) {
   printWordpressStatus(project, result);
 }
 async function wordpressDisconnect(project, format) {
-  const client = getClient23();
+  const client = getClient24();
   await client.wordpressDisconnect(project);
   if (isMachineFormat(format)) {
     printJson2({ project, disconnected: true });
@@ -10656,7 +10878,7 @@ async function wordpressDisconnect(project, format) {
   console.log(`WordPress disconnected from project "${project}".`);
 }
 async function wordpressStatus(project, format) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressStatus(project);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -10665,7 +10887,7 @@ async function wordpressStatus(project, format) {
   printWordpressStatus(project, result);
 }
 async function wordpressPages(project, opts) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressPages(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10674,7 +10896,7 @@ async function wordpressPages(project, opts) {
   printPages(project, result.env, result.pages);
 }
 async function wordpressPage(project, slug, opts) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressPage(project, slug, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10683,7 +10905,7 @@ async function wordpressPage(project, slug, opts) {
   printPageDetail(result);
 }
 async function wordpressCreatePage(project, body) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressCreatePage(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -10694,7 +10916,7 @@ async function wordpressCreatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressUpdatePage(project, body) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressUpdatePage(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -10705,7 +10927,7 @@ async function wordpressUpdatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressSetMeta(project, body) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressSetMeta(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -10755,7 +10977,7 @@ async function wordpressBulkSetMeta(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressBulkSetMeta(project, { entries, env: opts.env });
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10798,7 +11020,7 @@ async function wordpressBulkSetMeta(project, opts) {
 Total: ${applied.length} applied, ${skipped.length} skipped, ${manual.length} manual`);
 }
 async function wordpressSchema(project, slug, opts) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressSchema(project, slug, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10809,7 +11031,7 @@ async function wordpressSchema(project, slug, opts) {
   printSchemaBlocks(result.blocks);
 }
 async function wordpressSetSchema(project, body) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressSetSchema(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -10857,7 +11079,7 @@ async function wordpressSchemaDeploy(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressSchemaDeploy(project, { profile: parsed, env: opts.env });
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10896,7 +11118,7 @@ async function wordpressSchemaDeploy(project, opts) {
 Total: ${deployed} deployed, ${stripped} stripped, ${skipped} skipped, ${failed} failed`);
 }
 async function wordpressSchemaStatus(project, opts) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressSchemaStatus(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10955,7 +11177,7 @@ async function wordpressOnboard(project, opts) {
       });
     }
   }
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressOnboard(project, {
     url: opts.url,
     username: opts.user,
@@ -10980,7 +11202,7 @@ async function wordpressOnboard(project, opts) {
   }
 }
 async function wordpressLlmsTxt(project, opts) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressLlmsTxt(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -10991,7 +11213,7 @@ async function wordpressLlmsTxt(project, opts) {
   console.log(result.content ?? "(not found)");
 }
 async function wordpressSetLlmsTxt(project, body) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressSetLlmsTxt(project, body);
   if (isMachineFormat(body.format)) {
     printJson2(result);
@@ -11000,7 +11222,7 @@ async function wordpressSetLlmsTxt(project, body) {
   printManualAssist(`llms.txt update for "${project}"`, result);
 }
 async function wordpressAudit(project, opts) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressAudit(project, opts.env);
   if (isMachineFormat(opts.format)) {
     printJson2(result);
@@ -11014,7 +11236,7 @@ async function wordpressAudit(project, opts) {
   printAuditIssues(result.issues);
 }
 async function wordpressDiff(project, slug, format) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressDiff(project, slug);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -11023,7 +11245,7 @@ async function wordpressDiff(project, slug, format) {
   printDiff(result);
 }
 async function wordpressStagingStatus(project, format) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressStagingStatus(project);
   if (isMachineFormat(format)) {
     printJson2(result);
@@ -11037,7 +11259,7 @@ async function wordpressStagingStatus(project, format) {
   console.log(`  Admin URL:         ${result.adminUrl}`);
 }
 async function wordpressStagingPush(project, format) {
-  const client = getClient23();
+  const client = getClient24();
   const result = await client.wordpressStagingPush(project);
   if (isMachineFormat(format)) {
     printJson2(result);