@canonry/canonry 7.24.1 → 7.32.0

package/dist/{chunk-332IBSJJ.js → chunk-ZIETXJYU.js}

@@ -109,6 +109,7 @@ import {
   queryTrackingPreviewRequestSchema,
   referralAssessmentQuerySchema,
   reportMonthSchema,
+  reportedQueryClasses,
   researchBatchCreateSchema,
   researchRunCreateSchema,
   resultsClearRequestSchema,
@@ -144,7 +145,7 @@ import {
   trafficSeriesGranularitySchema,
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema
-} from "./chunk-656KW4RB.js";
+} from "./chunk-42XUY243.js";
 
 // src/support-links.ts
 var CANONRY_DISCORD_URL = "https://discord.gg/jnJ2H2z5Xh";
@@ -1969,7 +1970,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_queries_list",
     title: "List queries",
-    description: "List tracked queries for a Canonry project.",
+    description: "List tracked queries for a Canonry project. Each row carries queryClass as the server classes it: branded, non-brand, or null when no single class exists (no usable brand name, or the active measurement plan holds no single class for the query). A row with no queryClass comes from a server older than the field: the class is unknown, not null. Never infer a class from the query text.",
     access: "read",
     tier: "setup",
     inputSchema: projectInputSchema,
@@ -3275,14 +3276,15 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_queries_add",
     title: "Add queries",
-    description: "Append tracked queries to a Canonry project; existing queries are skipped by the API.",
+    description: "Append tracked queries to a Canonry project; existing queries are skipped by the API. Returns queryClasses: each requested query with the class the server gave it (branded, non-brand, or null when no single class exists). An entry with no queryClass means the server did not report one.",
     access: "write",
     tier: "setup",
     inputSchema: queriesInputSchema,
     annotations: writeAnnotations({ idempotentHint: true }),
     openApiOperations: ["POST /api/v1/projects/{name}/queries"],
     handler: async (client, input) => {
-      await client.appendQueries(input.project, uniqueStrings(input.request.queries));
+      const queries = uniqueStrings(input.request.queries);
+      return { ok: true, queryClasses: reportedQueryClasses(queries, await client.appendQueries(input.project, queries)) };
     }
   }),
   defineTool({

package/dist/cli.js

@@ -40,11 +40,11 @@ import {
   trackFeatureCompleted,
   trackIntegrationConnection,
   waitForServerRuntimeStartup
-} from "./chunk-35IRQYDW.js";
+} from "./chunk-K5EGSSXC.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-OAWFZAAJ.js";
+} from "./chunk-FW4GX2LO.js";
 import {
   clearDashboardPassword,
   configExists,
@@ -63,13 +63,13 @@ import {
   saveConfigPatch,
   shouldPrintServeSkillsNudge,
   withBootstrapProviderDefaults
-} from "./chunk-5ITYNLS3.js";
+} from "./chunk-QFXD7GR5.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-43FZZFOK.js";
+import "./chunk-2C6NWFN4.js";
 import {
   CANONRY_DISCORD_URL,
   CANONRY_ISSUES_URL,
@@ -83,7 +83,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-332IBSJJ.js";
+} from "./chunk-ZIETXJYU.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -116,7 +116,7 @@ import {
   rawEventSamples,
   readMarketCompetitorNames,
   runs
-} from "./chunk-H7UNFLYH.js";
+} from "./chunk-WRHA54BN.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -232,6 +232,7 @@ import {
   queryTrackingCommitRequestSchema,
   queryTrackingPreviewRequestSchema,
   referralAssessmentQuerySchema,
+  reportedQueryClasses,
   researchBatchCreateSchema,
   resolveNegativeReviewMaxStars,
   resolveProjectQualifiedAliases,
@@ -253,7 +254,7 @@ import {
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-656KW4RB.js";
+} from "./chunk-42XUY243.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -799,7 +800,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-NLD6B4WH.js");
+  const { createDemoServer } = await import("./demo-server-G5OK7SWE.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -1213,7 +1214,7 @@ No DB writes performed. Re-run without --dry-run to apply.`);
   }
 }
 async function backfillInsightsCommand(project2, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-JFHM2EAY.js");
+  const { IntelligenceService } = await import("./intelligence-service-3ZUVTIO7.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -2066,7 +2067,7 @@ async function backlinksList(opts) {
   }
   console.log(formatSummaryAndDomains(opts.project, response));
 }
-function formatSourceAvailability(res) {
+function formatSourceAvailability(project2, res) {
   const lines = [];
   lines.push(`Project: ${res.projectId}   Target: ${res.targetDomain}`);
   lines.push("");
@@ -2078,8 +2079,8 @@ function formatSourceAvailability(res) {
   }
   if (!res.anyConnected) {
     lines.push("");
-    lines.push("No active backlink source is set up. Enable Common Crawl on the project,");
-    lines.push("then run `canonry backlinks sync`.");
+    lines.push("No active backlink source is set up. Run `canonry backlinks sync` to download a");
+    lines.push(`Common Crawl release, or \`canonry backlinks extract ${project2}\` when one is already synced.`);
   }
   return lines.join("\n");
 }
@@ -2092,7 +2093,7 @@ async function backlinksSources(opts) {
     emitJsonl(res.sources.map((s) => ({ project: opts.project, targetDomain: res.targetDomain, ...s })));
     return;
   }
-  console.log(formatSourceAvailability(res));
+  console.log(formatSourceAvailability(opts.project, res));
 }
 async function backlinksReleases(opts = {}) {
   const rows = await getClient().backlinksCachedReleases();
@@ -11885,18 +11886,36 @@ import fs9 from "fs";
 function getClient15() {
   return createApiClient();
 }
+var NO_CLASS = "-";
+var CLASS_COLUMN_WIDTH = "non-brand".length;
+var NO_CLASS_NOTE = `${NO_CLASS} = no class: the project has no usable brand name, or its measurement plan holds no single class for that query (canonry query workspace shows the class per Property).`;
+var CLASS_NOT_REPORTED_NOTE = `${NO_CLASS} = class not reported: this server version does not send a query class. Upgrade the server to see it.`;
+function classCell(queryClass) {
+  return (queryClass ?? NO_CLASS).padEnd(CLASS_COLUMN_WIDTH);
+}
+function dashNotes(rows) {
+  return [
+    ...rows.some((row) => row.queryClass === null) ? [NO_CLASS_NOTE] : [],
+    ...rows.some((row) => row.queryClass === void 0) ? [CLASS_NOT_REPORTED_NOTE] : []
+  ];
+}
 async function addQueries(project2, queries2, format) {
   const client = getClient15();
-  await client.appendQueries(project2, queries2);
+  const queryClasses = reportedQueryClasses(queries2, await client.appendQueries(project2, queries2));
   if (isMachineFormat(format)) {
     console.log(JSON.stringify({
       project: project2,
       queries: queries2,
-      addedCount: queries2.length
+      addedCount: queries2.length,
+      queryClasses
     }, null, 2));
     return;
   }
   console.log(`Added ${queries2.length} ${queries2.length === 1 ? "query" : "queries"} to "${project2}".`);
+  for (const entry of queryClasses) {
+    console.log(`  ${classCell(entry.queryClass)}  ${entry.query}`);
+  }
+  for (const note of dashNotes(queryClasses)) console.log(`  ${note}`);
 }
 async function replaceQueries(project2, queries2, opts) {
   const client = getClient15();
@@ -11967,9 +11986,13 @@ async function listQueries(project2, format) {
   }
   console.log(`Queries for "${project2}" (${qs.length}):
 `);
+  console.log(`  ${"CLASS".padEnd(CLASS_COLUMN_WIDTH)}  QUERY`);
   for (const q of qs) {
-    console.log(`  ${q.query}`);
+    console.log(`  ${classCell(q.queryClass)}  ${q.query}`);
   }
+  const notes = dashNotes(qs);
+  if (notes.length > 0) console.log(`
+${notes.map((note) => `  ${note}`).join("\n")}`);
 }
 async function importQueries(project2, filePath, format) {
   if (!fs9.existsSync(filePath)) {
@@ -13048,7 +13071,7 @@ var EVENT_DESCRIPTIONS = {
   "run.failed": "An AEO sweep failed",
   "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.degraded": "A scheduled health check found the measurement degraded, daily data stopped arriving, or the website stopped answering (sent when a check starts failing or gets worse, not every pass)",
   "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)"

package/dist/{demo-server-NLD6B4WH.js → demo-server-G5OK7SWE.js}

@@ -5,11 +5,11 @@ import {
   computeFactorAverages,
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-43FZZFOK.js";
+} from "./chunk-2C6NWFN4.js";
 import {
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-332IBSJJ.js";
+} from "./chunk-ZIETXJYU.js";
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService,
@@ -85,7 +85,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-H7UNFLYH.js";
+} from "./chunk-WRHA54BN.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -115,7 +115,7 @@ import {
   roundPreservingTotal,
   siteAuditPageFactorSchema,
   wilsonInterval
-} from "./chunk-656KW4RB.js";
+} from "./chunk-42XUY243.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";

package/dist/index.js

@@ -3,14 +3,14 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-35IRQYDW.js";
+} from "./chunk-K5EGSSXC.js";
 import {
   loadConfig
-} from "./chunk-5ITYNLS3.js";
-import "./chunk-43FZZFOK.js";
-import "./chunk-332IBSJJ.js";
-import "./chunk-H7UNFLYH.js";
-import "./chunk-656KW4RB.js";
+} from "./chunk-QFXD7GR5.js";
+import "./chunk-2C6NWFN4.js";
+import "./chunk-ZIETXJYU.js";
+import "./chunk-WRHA54BN.js";
+import "./chunk-42XUY243.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-JFHM2EAY.js → intelligence-service-3ZUVTIO7.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-H7UNFLYH.js";
-import "./chunk-656KW4RB.js";
+} from "./chunk-WRHA54BN.js";
+import "./chunk-42XUY243.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-OAWFZAAJ.js";
+} from "./chunk-FW4GX2LO.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-5ITYNLS3.js";
-import "./chunk-332IBSJJ.js";
+} from "./chunk-QFXD7GR5.js";
+import "./chunk-ZIETXJYU.js";
 import {
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-656KW4RB.js";
+} from "./chunk-42XUY243.js";
 
 // src/mcp/cli.ts
 import { randomUUID } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "7.24.1",
+  "version": "7.32.0",
   "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.",
   "keywords": [
@@ -86,33 +86,33 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-web": "0.0.0",
-    "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-contracts": "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-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
-    "@ainyc/canonry-integration-google-ads": "0.0.0",
-    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "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-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "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-muse": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-integration-typesafe": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-integration-typesafe": "0.0.0"
   },
   "scripts": {
     "build": "pnpm run build:cli && pnpm run build:web",