@ainyc/canonry 4.180.8 → 4.182.3

package/dist/cli.js

@@ -28,11 +28,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-GFVZOVG3.js";
+} from "./chunk-BDJT7XZL.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-G7M2KM7Q.js";
+} from "./chunk-I3KSOMJA.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -57,7 +57,7 @@ import {
   saveConfigPatch,
   systemError,
   usageError
-} from "./chunk-IM4HFNGF.js";
+} from "./chunk-FVC7PGYQ.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -71,7 +71,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-ZJ2VGTYU.js";
+} from "./chunk-K45YKXE4.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -140,7 +140,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-GN2G7VFK.js";
+} from "./chunk-DY5ZDKQW.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -7569,8 +7569,95 @@ async function listCompetitors(project, format) {
     console.log(`  ${c.domain}`);
   }
 }
+async function showCompetitorLandscape(project, options) {
+  const client = getClient10();
+  const data = await client.getCompetitorLandscape(project, {
+    window: options.window,
+    scope: options.scope,
+    groupKey: options.groupKey,
+    provider: options.provider,
+    ...options.groupBy ? { groupBy: options.groupBy } : {},
+    ...options.model !== void 0 ? { model: options.model } : {},
+    queryClass: options.queryClass,
+    location: options.location,
+    runId: options.runId
+  });
+  if (options.format === "json") {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  if (options.format === "jsonl") {
+    console.log(JSON.stringify(data));
+    return;
+  }
+  printCompetitorLandscape(data);
+}
+function printCompetitorLandscape(data) {
+  const scope = data.scope.kind === "group" ? `market ${data.scope.groupKey}` : data.scope.kind === "all-markets" ? "all markets" : "project";
+  console.log(`Competitor landscape \xB7 ${scope} \xB7 ${data.window}`);
+  if (data.filters.model !== void 0) {
+    console.log(`Requested model filter: ${data.filters.provider} \xB7 ${data.filters.model}`);
+  }
+  console.log("Mention share is answer-text evidence; citations are independent source-list evidence.");
+  console.log(
+    data.filters.queryClass === "all" ? "Share of voice is blank: branded and non-brand queries are pooled here. Add --query-class non-brand for a ratio." : `Counting ${data.filters.queryClass} queries only.`
+  );
+  if (data.truncated) console.log("Top 100 observed competitors and top 100 other cited sources shown; pinned competitors are complete.");
+  console.log("");
+  printLandscapeRows("Your brand", [data.project]);
+  printLandscapeRows("Pinned competitors", data.pinned);
+  printLandscapeRows("Observed competitors", data.observed);
+  printLandscapeRows("Other cited sources", data.otherSources);
+  console.log("");
+  console.log(
+    `Evidence: ${data.evidence.answeredResults} answer-text result(s), ${data.evidence.sourceResults} source result(s); excluded: ${data.evidence.excludedProbeResults} probe, ${data.evidence.excludedNonCompletedResults} non-completed.`
+  );
+  if (data.modelComparison) printModelComparison(data.modelComparison);
+}
+function describeServedModels(evidence) {
+  if (evidence.status === "unknown") return "Unknown (not disclosed)";
+  if (evidence.status === "known") return evidence.model;
+  return [...evidence.models, ...evidence.includesUnknown ? ["Unknown (not disclosed)"] : []].join(", ");
+}
+function printModelComparison(comparison) {
+  console.log("");
+  console.log(`Model comparison \xB7 requested-model basis \xB7 ${comparison.groups.length} of ${comparison.totalGroups} groups`);
+  console.log("Groups use stored observations. They do not form a matched-query or equal-weight comparison.");
+  if (comparison.truncated) console.log("The first 50 provider/model groups are shown. Additional groups are omitted.");
+  for (const group of comparison.groups) {
+    console.log("");
+    console.log(`${group.provider} \xB7 requested model: ${group.model ?? "Unknown (not recorded)"}`);
+    console.log(`Served model evidence: ${describeServedModels(group.servedModels)}`);
+    console.log(`Samples: ${group.snapshotCount} snapshot(s), ${group.evidence.answeredResults} answer-text result(s), ${group.evidence.sourceResults} source result(s).`);
+    printLandscapeRows("Your brand", [group.project], true);
+    printLandscapeRows("Pinned competitors", group.pinned, true);
+    printLandscapeRows("Observed competitors", group.observed, true);
+    printLandscapeRows("Other cited sources", group.otherSources, true);
+    if (group.truncated) console.log("Top 100 observed competitors and top 100 other sources shown. Pinned competitors are complete.");
+  }
+}
+function printLandscapeRows(heading, rows, showSampleCount = false) {
+  console.log(`${heading}:`);
+  if (rows.length === 0) {
+    console.log("  \u2014");
+    return;
+  }
+  for (const row of rows) {
+    const sov = row.shareOfVoice === null ? "\u2014" : `${row.shareOfVoice.toFixed(1)}%`;
+    console.log(`  ${row.domain}  mention ${row.mentionCount} \xB7 citation ${row.citationCount} \xB7 SOV ${sov}${showSampleCount ? ` \xB7 answers ${row.answeredResults}` : ""}`);
+  }
+}
 
 // src/cli-commands/competitor.ts
+var LANDSCAPE_USAGE = "canonry competitor landscape <project> [--window 7d|30d|90d|all] [--group-key <key>|--scope all-markets] [--by-model] [--provider <provider> [--model <id>]] [--query-class all|branded|non-brand] [--location <label>] [--run-id <id>] [--format json|jsonl]";
+function parseLandscapeScope(value) {
+  if (value === void 0 || value === "") return void 0;
+  if (value !== "all-markets") throw usageError(`--scope must be "all-markets" (got "${value}")`, {
+    message: '--scope must be "all-markets"',
+    details: { command: "competitor.landscape", usage: LANDSCAPE_USAGE }
+  });
+  return value;
+}
 var COMPETITOR_CLI_COMMANDS = [
   {
     path: ["competitor", "add"],
@@ -7634,14 +7721,60 @@ var COMPETITOR_CLI_COMMANDS = [
       await listCompetitors(project, input.format);
     }
   },
+  {
+    path: ["competitor", "landscape"],
+    usage: LANDSCAPE_USAGE,
+    options: {
+      window: stringOption(),
+      "group-key": stringOption(),
+      scope: stringOption(),
+      provider: stringOption(),
+      "by-model": { type: "boolean" },
+      model: stringOption(),
+      "query-class": stringOption(),
+      location: stringOption(),
+      "run-id": stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(input, "competitor.landscape", LANDSCAPE_USAGE);
+      const scope = parseLandscapeScope(getString(input.values, "scope"));
+      const groupKey = getString(input.values, "group-key");
+      const provider = getString(input.values, "provider");
+      const model = getString(input.values, "model");
+      if (model !== void 0 && !provider?.trim()) {
+        throw usageError("--model requires --provider", {
+          message: "--model requires --provider",
+          details: { command: "competitor.landscape", usage: LANDSCAPE_USAGE }
+        });
+      }
+      if (scope === "all-markets" && groupKey) {
+        throw usageError("--group-key cannot be combined with --scope all-markets", {
+          message: "--group-key cannot be combined with --scope all-markets",
+          details: { command: "competitor.landscape", usage: LANDSCAPE_USAGE }
+        });
+      }
+      await showCompetitorLandscape(project, {
+        window: getString(input.values, "window"),
+        groupKey,
+        scope,
+        provider,
+        ...getBoolean(input.values, "by-model") ? { groupBy: "model" } : {},
+        ...model !== void 0 ? { model } : {},
+        queryClass: getString(input.values, "query-class"),
+        location: getString(input.values, "location"),
+        runId: getString(input.values, "run-id"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["competitor"],
-    usage: "canonry competitor <add|remove|delete|list> <project> [args]",
+    usage: "canonry competitor <add|remove|delete|list|landscape> <project> [args]",
     run: async (input) => {
       unknownSubcommand(input.positionals[0], {
         command: "competitor",
-        usage: "canonry competitor <add|remove|delete|list> <project> [args]",
-        available: ["add", "remove", "delete", "list"]
+        usage: "canonry competitor <add|remove|delete|list|landscape> <project> [args]",
+        available: ["add", "remove", "delete", "list", "landscape"]
       });
     }
   }

package/dist/index.js

@@ -3,12 +3,12 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-GFVZOVG3.js";
+} from "./chunk-BDJT7XZL.js";
 import {
   loadConfig
-} from "./chunk-IM4HFNGF.js";
-import "./chunk-ZJ2VGTYU.js";
-import "./chunk-GN2G7VFK.js";
+} from "./chunk-FVC7PGYQ.js";
+import "./chunk-K45YKXE4.js";
+import "./chunk-DY5ZDKQW.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-IURLYRB3.js → intelligence-service-HGA553GT.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-ZJ2VGTYU.js";
-import "./chunk-GN2G7VFK.js";
+} from "./chunk-K45YKXE4.js";
+import "./chunk-DY5ZDKQW.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -1,13 +1,13 @@
 import {
   autoSyncSkills
-} from "./chunk-G7M2KM7Q.js";
+} from "./chunk-I3KSOMJA.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-IM4HFNGF.js";
+} from "./chunk-FVC7PGYQ.js";
 import {
   isReadOnlyKey
-} from "./chunk-GN2G7VFK.js";
+} from "./chunk-DY5ZDKQW.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.180.8",
+  "version": "4.182.3",
   "type": "module",
   "description": "Self-hosted AI visibility (AEO) platform: track how ChatGPT, Claude, Gemini, and Perplexity cite your domain, join it with Search Console, GA4, server-side traffic, and paid media, and fix what you find through agent tools (CLI, REST, MCP). Local SQLite.",
   "license": "FSL-1.1-ALv2",
@@ -72,29 +72,29 @@
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-google-ads": "0.0.0",
-    "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-openai-ads": "0.0.0",
+    "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0"
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",