@ainyc/canonry 3.6.4 → 4.1.3

package/dist/cli.js

@@ -18,7 +18,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-JMVBV3AT.js";
+} from "./chunk-JV6X6AFT.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -33,7 +33,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-RQMOJEJT.js";
+} from "./chunk-KCETXLDF.js";
 import {
   apiKeys,
   competitors,
@@ -45,11 +45,12 @@ import {
   projects,
   querySnapshots,
   runs
-} from "./chunk-GP2P2WPS.js";
+} from "./chunk-AXMSAMKN.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
   CheckStatuses,
+  CitationStates,
   CodingAgents,
   ProviderNames,
   RunKinds,
@@ -63,7 +64,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-O7EVT3AF.js";
+} from "./chunk-O5JZQUPX.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -579,7 +580,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-NL4BG3SM.js");
+  const { IntelligenceService } = await import("./intelligence-service-WPY4PDBU.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -2017,9 +2018,9 @@ async function gaConnect(project, opts) {
     propertyId: opts.propertyId
   };
   if (opts.keyFile) {
-    const fs11 = await import("fs");
+    const fs12 = await import("fs");
     try {
-      const content = fs11.readFileSync(opts.keyFile, "utf-8");
+      const content = fs12.readFileSync(opts.keyFile, "utf-8");
       JSON.parse(content);
       body.keyJson = content;
     } catch (e) {
@@ -3947,8 +3948,285 @@ var KEYWORD_CLI_COMMANDS = [
   }
 ];
 
-// src/commands/mcp.ts
+// src/commands/query.ts
 import fs2 from "fs";
+function getClient8() {
+  return createApiClient();
+}
+async function addQueries(project, queries, format) {
+  const client = getClient8();
+  await client.appendQueries(project, queries);
+  if (format === "json") {
+    console.log(JSON.stringify({
+      project,
+      queries,
+      addedCount: queries.length
+    }, null, 2));
+    return;
+  }
+  console.log(`Added ${queries.length} ${queries.length === 1 ? "query" : "queries"} to "${project}".`);
+}
+async function replaceQueries(project, queries, format) {
+  const client = getClient8();
+  await client.putQueries(project, queries);
+  if (format === "json") {
+    console.log(JSON.stringify({
+      project,
+      queries,
+      replacedCount: queries.length
+    }, null, 2));
+    return;
+  }
+  console.log(`Set ${queries.length} ${queries.length === 1 ? "query" : "queries"} for "${project}".`);
+}
+async function removeQueries(project, queries, format) {
+  const client = getClient8();
+  const existing = await client.listQueries(project);
+  const existingSet = new Set(existing.map((q) => q.query));
+  const removedQueries = queries.filter((q) => existingSet.has(q));
+  await client.deleteQueries(project, queries);
+  if (format === "json") {
+    console.log(JSON.stringify({
+      project,
+      queries,
+      removedQueries,
+      removedCount: removedQueries.length
+    }, null, 2));
+    return;
+  }
+  console.log(`Removed ${removedQueries.length} ${removedQueries.length === 1 ? "query" : "queries"} from "${project}".`);
+}
+async function listQueries(project, format) {
+  const client = getClient8();
+  const qs = await client.listQueries(project);
+  if (format === "json") {
+    console.log(JSON.stringify(qs, null, 2));
+    return;
+  }
+  if (qs.length === 0) {
+    console.log(`No queries found for "${project}".`);
+    return;
+  }
+  console.log(`Queries for "${project}" (${qs.length}):
+`);
+  for (const q of qs) {
+    console.log(`  ${q.query}`);
+  }
+}
+async function importQueries(project, filePath, format) {
+  if (!fs2.existsSync(filePath)) {
+    throw new CliError({
+      code: "QUERY_IMPORT_FILE_NOT_FOUND",
+      message: `File not found: ${filePath}`,
+      displayMessage: `Error: file not found: ${filePath}`,
+      details: {
+        project,
+        filePath
+      }
+    });
+  }
+  const content = fs2.readFileSync(filePath, "utf-8");
+  const queries = content.split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  if (queries.length === 0) {
+    if (format === "json") {
+      console.log(JSON.stringify({
+        project,
+        filePath,
+        queries: [],
+        importedCount: 0
+      }, null, 2));
+      return;
+    }
+    console.log("No queries found in file.");
+    return;
+  }
+  const client = getClient8();
+  await client.appendQueries(project, queries);
+  if (format === "json") {
+    console.log(JSON.stringify({
+      project,
+      filePath,
+      queries,
+      importedCount: queries.length
+    }, null, 2));
+    return;
+  }
+  console.log(`Imported ${queries.length} ${queries.length === 1 ? "query" : "queries"} to "${project}".`);
+}
+async function generateQueries(project, provider, opts) {
+  const client = getClient8();
+  const result = await client.generateQueries(project, provider, opts.count);
+  const saved = Boolean(opts.save && result.queries.length > 0);
+  if (opts.format !== "json") {
+    console.log(`Generated ${result.queries.length} ${result.queries.length === 1 ? "query" : "queries"} using ${result.provider}:
+`);
+    for (const q of result.queries) {
+      console.log(`  ${q}`);
+    }
+    if (result.queries.length > 0 && !saved) {
+      console.log(`
+To add these, run: canonry query add ${project} <query>...`);
+    }
+  }
+  if (saved) {
+    await client.appendQueries(project, result.queries);
+    if (opts.format !== "json") {
+      console.log(`
+Saved ${result.queries.length} ${result.queries.length === 1 ? "query" : "queries"} to "${project}".`);
+    }
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify({
+      project,
+      provider: result.provider,
+      queries: result.queries,
+      generatedCount: result.queries.length,
+      saved,
+      savedCount: saved ? result.queries.length : 0
+    }, null, 2));
+  }
+}
+
+// src/cli-commands/query.ts
+var QUERY_CLI_COMMANDS = [
+  {
+    path: ["query", "add"],
+    usage: "canonry query add <project> <query...> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "query.add", "canonry query add <project> <query...> [--format json]");
+      const queries = input.positionals.slice(1);
+      if (queries.length === 0) {
+        throw usageError("Error: project name and at least one query required\nUsage: canonry query add <project> <query...> [--format json]", {
+          message: "project name and at least one query required",
+          details: {
+            command: "query.add",
+            usage: "canonry query add <project> <query...> [--format json]"
+          }
+        });
+      }
+      await addQueries(project, queries, input.format);
+    }
+  },
+  {
+    path: ["query", "replace"],
+    usage: "canonry query replace <project> <query...> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "query.replace", "canonry query replace <project> <query...> [--format json]");
+      const queries = input.positionals.slice(1);
+      if (queries.length === 0) {
+        throw usageError("Error: project name and at least one query required\nUsage: canonry query replace <project> <query...> [--format json]", {
+          message: "project name and at least one query required",
+          details: {
+            command: "query.replace",
+            usage: "canonry query replace <project> <query...> [--format json]"
+          }
+        });
+      }
+      await replaceQueries(project, queries, input.format);
+    }
+  },
+  {
+    path: ["query", "remove"],
+    usage: "canonry query remove <project> <query...> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "query.remove", "canonry query remove <project> <query...> [--format json]");
+      const queries = input.positionals.slice(1);
+      if (queries.length === 0) {
+        throw usageError("Error: project name and at least one query required\nUsage: canonry query remove <project> <query...> [--format json]", {
+          message: "project name and at least one query required",
+          details: {
+            command: "query.remove",
+            usage: "canonry query remove <project> <query...> [--format json]"
+          }
+        });
+      }
+      await removeQueries(project, queries, input.format);
+    }
+  },
+  {
+    path: ["query", "delete"],
+    usage: "canonry query delete <project> <query...> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "query.delete", "canonry query delete <project> <query...> [--format json]");
+      const queries = input.positionals.slice(1);
+      if (queries.length === 0) {
+        throw usageError("Error: project name and at least one query required\nUsage: canonry query delete <project> <query...> [--format json]", {
+          message: "project name and at least one query required",
+          details: {
+            command: "query.delete",
+            usage: "canonry query delete <project> <query...> [--format json]"
+          }
+        });
+      }
+      await removeQueries(project, queries, input.format);
+    }
+  },
+  {
+    path: ["query", "list"],
+    usage: "canonry query list <project> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "query.list", "canonry query list <project> [--format json]");
+      await listQueries(project, input.format);
+    }
+  },
+  {
+    path: ["query", "import"],
+    usage: "canonry query import <project> <file> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "query.import", "canonry query import <project> <file> [--format json]");
+      const filePath = requirePositional(input, 1, {
+        command: "query.import",
+        usage: "canonry query import <project> <file> [--format json]",
+        message: "project name and file path required"
+      });
+      await importQueries(project, filePath, input.format);
+    }
+  },
+  {
+    path: ["query", "generate"],
+    usage: "canonry query generate <project> --provider <name> [--count <n>] [--save] [--format json]",
+    options: {
+      provider: stringOption(),
+      count: stringOption(),
+      save: { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "query.generate",
+        "canonry query generate <project> --provider <name> [--count <n>] [--save] [--format json]"
+      );
+      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)"
+      });
+      await generateQueries(project, provider, {
+        count: parseIntegerOption(input, "count", {
+          command: "query.generate",
+          usage: "canonry query generate <project> --provider <name> [--count <n>] [--save] [--format json]",
+          message: "--count must be an integer"
+        }),
+        save: getBoolean(input.values, "save"),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["query"],
+    usage: "canonry query <add|replace|remove|delete|list|import|generate> <project> [args]",
+    run: async (input) => {
+      unknownSubcommand(input.positionals[0], {
+        command: "query",
+        usage: "canonry query <add|replace|remove|delete|list|import|generate> <project> [args]",
+        available: ["add", "replace", "remove", "delete", "list", "import", "generate"]
+      });
+    }
+  }
+];
+
+// src/commands/mcp.ts
+import fs3 from "fs";
 import path2 from "path";
 import { createRequire } from "module";
 
@@ -4054,8 +4332,8 @@ function renderClientSnippet(client, serverName, entry) {
   return renderJsonSnippet(serverName, entry, client.format);
 }
 function readJsonConfig(configPath) {
-  if (!fs2.existsSync(configPath)) return {};
-  const raw = fs2.readFileSync(configPath, "utf-8").trim();
+  if (!fs3.existsSync(configPath)) return {};
+  const raw = fs3.readFileSync(configPath, "utf-8").trim();
   if (!raw) return {};
   try {
     const parsed = JSON.parse(raw);
@@ -4073,14 +4351,14 @@ function readJsonConfig(configPath) {
   }
 }
 function writeJsonConfig(configPath, value) {
-  fs2.mkdirSync(path2.dirname(configPath), { recursive: true });
-  fs2.writeFileSync(configPath, `${JSON.stringify(value, null, 2)}
+  fs3.mkdirSync(path2.dirname(configPath), { recursive: true });
+  fs3.writeFileSync(configPath, `${JSON.stringify(value, null, 2)}
 `, "utf-8");
 }
 function backupConfigIfPresent(configPath) {
-  if (!fs2.existsSync(configPath)) return void 0;
+  if (!fs3.existsSync(configPath)) return void 0;
   const backupPath = `${configPath}.canonry.bak`;
-  fs2.copyFileSync(configPath, backupPath);
+  fs3.copyFileSync(configPath, backupPath);
   return backupPath;
 }
 function findClientOrThrow(id) {
@@ -4260,11 +4538,11 @@ var MCP_CLI_COMMANDS = [
 ];
 
 // src/commands/notify.ts
-function getClient8() {
+function getClient9() {
   return createApiClient();
 }
 async function addNotification(project, opts) {
-  const client = getClient8();
+  const client = getClient9();
   const result = await client.createNotification(project, {
     channel: "webhook",
     url: opts.webhook,
@@ -4278,7 +4556,7 @@ async function addNotification(project, opts) {
   printNotification(result);
 }
 async function listNotifications(project, format) {
-  const client = getClient8();
+  const client = getClient9();
   const results = await client.listNotifications(project);
   if (format === "json") {
     console.log(JSON.stringify(results, null, 2));
@@ -4296,7 +4574,7 @@ async function listNotifications(project, format) {
   }
 }
 async function removeNotification(project, id, format) {
-  const client = getClient8();
+  const client = getClient9();
   await client.deleteNotification(project, id);
   if (format === "json") {
     console.log(JSON.stringify({ project, id, removed: true }, null, 2));
@@ -4305,7 +4583,7 @@ async function removeNotification(project, id, format) {
   console.log(`Notification ${id} removed from "${project}"`);
 }
 async function testNotification(project, id, format) {
-  const client = getClient8();
+  const client = getClient9();
   const result = await client.testNotification(project, id);
   if (format === "json") {
     console.log(JSON.stringify({ project, id, ...result }, null, 2));
@@ -4318,10 +4596,10 @@ async function testNotification(project, id, format) {
   }
 }
 var EVENT_DESCRIPTIONS = {
-  "citation.lost": "A keyword lost its citation status",
-  "citation.gained": "A keyword gained citation status",
-  "run.completed": "A visibility run completed successfully",
-  "run.failed": "A visibility run failed",
+  "citation.lost": "A query lost its citation status",
+  "citation.gained": "A query gained citation status",
+  "run.completed": "An AEO sweep completed successfully",
+  "run.failed": "An AEO sweep failed",
   "insight.critical": "A critical-severity insight was generated",
   "insight.high": "A high-severity insight was generated"
 };
@@ -4427,13 +4705,13 @@ var NOTIFY_CLI_COMMANDS = [
 ];
 
 // src/commands/apply.ts
-import fs3 from "fs";
+import fs4 from "fs";
 import { parseAllDocuments } from "yaml";
 async function applyConfigFile(filePath) {
-  if (!fs3.existsSync(filePath)) {
+  if (!fs4.existsSync(filePath)) {
     throw new Error(`File not found: ${filePath}`);
   }
-  const content = fs3.readFileSync(filePath, "utf-8");
+  const content = fs4.readFileSync(filePath, "utf-8");
   const docs = parseAllDocuments(content);
   const client = createApiClient();
   const errors = [];
@@ -4496,11 +4774,11 @@ async function applyConfigs(filePaths, format) {
 }
 
 // src/commands/analytics.ts
-function getClient9() {
+function getClient10() {
   return createApiClient();
 }
 async function showAnalytics(project, options) {
-  const client = getClient9();
+  const client = getClient10();
   const features = options.feature ? [options.feature] : ["metrics", "gaps", "sources"];
   const results = {};
   for (const feature of features) {
@@ -4571,19 +4849,19 @@ Brand Gap Analysis`);
   if (data.gap.length > 0) {
     console.log(`
   Opportunity Gaps (competitors cited, you're not):`);
-    for (const kw of data.gap) {
-      const competitors2 = kw.competitorsCiting.join(", ");
-      const cons = kw.consistency.totalRuns > 0 ? ` [cited ${kw.consistency.citedRuns}/${kw.consistency.totalRuns} runs]` : "";
-      console.log(`    \u2022 ${kw.keyword}${cons}`);
+    for (const q of data.gap) {
+      const competitors2 = q.competitorsCiting.join(", ");
+      const cons = q.consistency.totalRuns > 0 ? ` [cited ${q.consistency.citedRuns}/${q.consistency.totalRuns} runs]` : "";
+      console.log(`    \u2022 ${q.query}${cons}`);
       console.log(`      Competitors: ${competitors2}`);
     }
   }
   if (data.cited.length > 0) {
     console.log(`
-  Cited Keywords:`);
-    for (const kw of data.cited) {
-      const cons = kw.consistency.totalRuns > 0 ? ` [${kw.consistency.citedRuns}/${kw.consistency.totalRuns} runs]` : "";
-      console.log(`    \u2713 ${kw.keyword} (${kw.providers.join(", ")})${cons}`);
+  Cited Queries:`);
+    for (const q of data.cited) {
+      const cons = q.consistency.totalRuns > 0 ? ` [${q.consistency.citedRuns}/${q.consistency.totalRuns} runs]` : "";
+      console.log(`    \u2713 ${q.query} (${q.providers.join(", ")})${cons}`);
     }
   }
 }
@@ -4603,22 +4881,22 @@ Source Origin Breakdown`);
 }
 
 // src/commands/evidence.ts
-function getClient10() {
+function getClient11() {
   return createApiClient();
 }
 async function showEvidence(project, format) {
-  const client = getClient10();
+  const client = getClient11();
   const timeline = await client.getTimeline(project);
   if (format === "json") {
     const enriched = timeline.map((entry) => ({
       ...entry,
-      cited: entry.runs[entry.runs.length - 1]?.citationState === "cited"
+      cited: entry.runs[entry.runs.length - 1]?.citationState === CitationStates.cited
     }));
     console.log(JSON.stringify(enriched, null, 2));
     return;
   }
   if (timeline.length === 0) {
-    console.log('No keyword evidence yet. Trigger a run first with "canonry run".');
+    console.log('No query evidence yet. Trigger a run first with "canonry run".');
     return;
   }
   console.log(`Evidence: ${project}
@@ -4626,13 +4904,13 @@ async function showEvidence(project, format) {
   for (const entry of timeline) {
     const latest = entry.runs[entry.runs.length - 1];
     if (!latest) continue;
-    const state = latest.citationState === "cited" ? "\u2713 cited" : "\u2717 not-cited";
+    const state = latest.citationState === CitationStates.cited ? "\u2713 cited" : "\u2717 not-cited";
     const transition = latest.transition !== latest.citationState ? ` (${latest.transition})` : "";
-    console.log(`  ${state}${transition}  ${entry.keyword}`);
+    console.log(`  ${state}${transition}  ${entry.query}`);
   }
   console.log(`
-  Keywords: ${timeline.length}`);
-  const cited = timeline.filter((e) => e.runs[e.runs.length - 1]?.citationState === "cited").length;
+  Queries: ${timeline.length}`);
+  const cited = timeline.filter((e) => e.runs[e.runs.length - 1]?.citationState === CitationStates.cited).length;
   console.log(`  Cited:    ${cited} / ${timeline.length}`);
 }
 
@@ -4667,11 +4945,11 @@ async function loadLatestRunForExport(client, project) {
 }
 
 // src/commands/history.ts
-function getClient11() {
+function getClient12() {
   return createApiClient();
 }
 async function showHistory(project, format) {
-  const client = getClient11();
+  const client = getClient12();
   try {
     const entries = await client.getHistory(project);
     if (format === "json") {
@@ -4706,11 +4984,11 @@ async function showHistory(project, format) {
 }
 
 // src/commands/status.ts
-function getClient12() {
+function getClient13() {
   return createApiClient();
 }
 async function showStatus(project, format) {
-  const client = getClient12();
+  const client = getClient13();
   const projectData = await client.getProject(project);
   const latest = await getLatestRunSummary(client, project);
   if (format === "json") {
@@ -4841,11 +5119,11 @@ var OPERATOR_CLI_COMMANDS = [
 ];
 
 // src/commands/project.ts
-function getClient13() {
+function getClient14() {
   return createApiClient();
 }
 async function createProject(name, opts) {
-  const client = getClient13();
+  const client = getClient14();
   const result = await client.putProject(name, {
     displayName: opts.displayName,
     canonicalDomain: opts.domain,
@@ -4860,7 +5138,7 @@ async function createProject(name, opts) {
   console.log(`Project created: ${result.name} (${result.id})`);
 }
 async function listProjects(format) {
-  const client = getClient13();
+  const client = getClient14();
   const projects2 = await client.listProjects();
   if (format === "json") {
     console.log(JSON.stringify(projects2, null, 2));
@@ -4888,7 +5166,7 @@ async function listProjects(format) {
   }
 }
 async function showProject(name, format) {
-  const client = getClient13();
+  const client = getClient14();
   const project = await client.getProject(name);
   if (format === "json") {
     console.log(JSON.stringify(project, null, 2));
@@ -4914,7 +5192,7 @@ async function showProject(name, format) {
   if (project.updatedAt) console.log(`  Updated:          ${project.updatedAt}`);
 }
 async function updateProjectSettings(name, opts) {
-  const client = getClient13();
+  const client = getClient14();
   const project = await client.getProject(name);
   let ownedDomains = opts.ownedDomains ?? project.ownedDomains ?? [];
   if (opts.addOwnedDomain) {
@@ -4939,7 +5217,7 @@ async function updateProjectSettings(name, opts) {
   console.log(`Project updated: ${result.name}`);
 }
 async function deleteProject(name, format) {
-  const client = getClient13();
+  const client = getClient14();
   await client.deleteProject(name);
   if (format === "json") {
     console.log(JSON.stringify({ name, deleted: true }, null, 2));
@@ -4948,7 +5226,7 @@ async function deleteProject(name, format) {
   console.log(`Project deleted: ${name}`);
 }
 async function addLocation(project, opts) {
-  const client = getClient13();
+  const client = getClient14();
   const location = await client.addLocation(project, {
     label: opts.label,
     city: opts.city,
@@ -4963,7 +5241,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 = getClient13();
+  const client = getClient14();
   const result = await client.listLocations(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -4989,7 +5267,7 @@ async function listLocations(project, format) {
   }
 }
 async function removeLocation(project, label, format) {
-  const client = getClient13();
+  const client = getClient14();
   await client.removeLocation(project, label);
   if (format === "json") {
     console.log(JSON.stringify({ project, label, removed: true }, null, 2));
@@ -4998,7 +5276,7 @@ async function removeLocation(project, label, format) {
   console.log(`Location removed: ${label}`);
 }
 async function setDefaultLocation(project, label, format) {
-  const client = getClient13();
+  const client = getClient14();
   const result = await client.setDefaultLocation(project, label);
   if (format === "json") {
     console.log(JSON.stringify({ project, ...result }, null, 2));
@@ -5177,7 +5455,7 @@ var PROJECT_CLI_COMMANDS = [
 ];
 
 // src/commands/report.ts
-import fs4 from "fs";
+import fs5 from "fs";
 import path3 from "path";
 function defaultOutputPath(project) {
   const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -5193,10 +5471,10 @@ async function runReportCommand(project, opts = {}) {
   const html = renderReportHtml(report);
   const targetPath = opts.output ? path3.resolve(opts.output) : defaultOutputPath(project);
   const dir = path3.dirname(targetPath);
-  if (!fs4.existsSync(dir)) {
-    fs4.mkdirSync(dir, { recursive: true });
+  if (!fs5.existsSync(dir)) {
+    fs5.mkdirSync(dir, { recursive: true });
   }
-  fs4.writeFileSync(targetPath, html, "utf-8");
+  fs5.writeFileSync(targetPath, html, "utf-8");
   console.log(`Report written to ${targetPath}`);
 }
 
@@ -5220,12 +5498,12 @@ var REPORT_CLI_COMMANDS = [
 ];
 
 // src/commands/run.ts
-function getClient14() {
+function getClient15() {
   return createApiClient();
 }
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
 async function triggerRun(project, opts) {
-  const client = getClient14();
+  const client = getClient15();
   const body = {};
   if (opts?.provider) {
     const providerInputs = opts.provider.split(",").map((s) => s.trim()).filter(Boolean);
@@ -5321,7 +5599,7 @@ async function triggerRun(project, opts) {
   }
 }
 async function triggerRunAll(opts) {
-  const client = getClient14();
+  const client = getClient15();
   const projects2 = await client.listProjects();
   if (projects2.length === 0) {
     if (opts?.format === "json") {
@@ -5379,7 +5657,7 @@ async function triggerRunAll(opts) {
   }
 }
 async function cancelRun(project, runId, format) {
-  const client = getClient14();
+  const client = getClient15();
   let targetId = runId;
   if (!targetId) {
     const runs2 = await client.listRuns(project);
@@ -5411,7 +5689,7 @@ To cancel by ID  : canonry run cancel ${project} <run-id>`,
   console.log(`Run ${result.id} cancelled.`);
 }
 async function showRun(id, format) {
-  const client = getClient14();
+  const client = getClient15();
   const run = await client.getRun(id);
   if (format === "json") {
     console.log(JSON.stringify(run, null, 2));
@@ -5420,7 +5698,7 @@ async function showRun(id, format) {
   printRunDetail(run);
 }
 async function listRuns(project, opts) {
-  const client = getClient14();
+  const client = getClient15();
   const runs2 = await client.listRuns(project, opts?.limit);
   if (opts?.format === "json") {
     console.log(JSON.stringify(runs2, null, 2));
@@ -5473,11 +5751,12 @@ function printRunDetail(run) {
   }
   if (run.snapshots && run.snapshots.length > 0) {
     console.log(`
-  Snapshots: ${run.snapshots.length}`);
+  Snapshots: ${run.snapshots.length}  (cell = [citation][mention];  C=cited c=not, M=mentioned m=not, \u2013=no data)`);
     for (const s of run.snapshots) {
-      const state = typeof s.answerMentioned === "boolean" ? s.answerMentioned ? "  visible  " : "  not-vis  " : s.citationState === "cited" ? "  cited    " : "  not-cited";
+      const citationGlyph = s.citationState === CitationStates.cited ? "C" : "c";
+      const mentionGlyph = typeof s.answerMentioned === "boolean" ? s.answerMentioned ? "M" : "m" : "\u2013";
       const modelLabel = s.model ? ` (${s.model})` : "";
-      console.log(`    ${state}  ${s.provider}${modelLabel}  ${s.keyword}`);
+      console.log(`    [${citationGlyph}${mentionGlyph}]  ${s.provider}${modelLabel}  ${s.query}`);
     }
   }
 }
@@ -5572,11 +5851,11 @@ var RUN_CLI_COMMANDS = [
 ];
 
 // src/commands/schedule.ts
-function getClient15() {
+function getClient16() {
   return createApiClient();
 }
 async function setSchedule(project, opts) {
-  const client = getClient15();
+  const client = getClient16();
   const body = {};
   if (opts.preset) body.preset = opts.preset;
   if (opts.cron) body.cron = opts.cron;
@@ -5591,7 +5870,7 @@ async function setSchedule(project, opts) {
   printSchedule(result);
 }
 async function showSchedule(project, format) {
-  const client = getClient15();
+  const client = getClient16();
   const result = await client.getSchedule(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -5600,7 +5879,7 @@ async function showSchedule(project, format) {
   printSchedule(result);
 }
 async function enableSchedule(project, format) {
-  const client = getClient15();
+  const client = getClient16();
   const current = await client.getSchedule(project);
   const body = { timezone: current.timezone, enabled: true };
   if (current.preset) body.preset = current.preset;
@@ -5614,7 +5893,7 @@ async function enableSchedule(project, format) {
   console.log(`Schedule enabled for "${project}"`);
 }
 async function disableSchedule(project, format) {
-  const client = getClient15();
+  const client = getClient16();
   const current = await client.getSchedule(project);
   const body = { timezone: current.timezone, enabled: false };
   if (current.preset) body.preset = current.preset;
@@ -5628,7 +5907,7 @@ async function disableSchedule(project, format) {
   console.log(`Schedule disabled for "${project}"`);
 }
 async function removeSchedule(project, format) {
-  const client = getClient15();
+  const client = getClient16();
   await client.deleteSchedule(project);
   if (format === "json") {
     console.log(JSON.stringify({ project, removed: true }, null, 2));
@@ -5735,11 +6014,11 @@ var SCHEDULE_CLI_COMMANDS = [
 ];
 
 // src/commands/settings.ts
-function getClient16() {
+function getClient17() {
   return createApiClient();
 }
 async function setProvider(name, opts) {
-  const client = getClient16();
+  const client = getClient17();
   const { format, ...payload } = opts;
   const result = await client.updateProvider(name, payload);
   if (format === "json") {
@@ -5755,7 +6034,7 @@ async function setProvider(name, opts) {
   }
 }
 async function showSettings(format) {
-  const client = getClient16();
+  const client = getClient17();
   const config = loadConfig();
   const settings = await client.getSettings();
   if (format === "json") {
@@ -5927,7 +6206,7 @@ Usage: canonry settings provider ${name} --api-key <key> [--model <model>] [--ma
 ];
 
 // src/commands/skills.ts
-import fs5 from "fs";
+import fs6 from "fs";
 import path4 from "path";
 import { fileURLToPath } from "url";
 var BUNDLED_SKILL_NAMES = ["canonry-setup", "aero"];
@@ -5939,7 +6218,7 @@ function resolveBundledSkillsRoot(pkgDir) {
     path4.join(here, "../../../../skills")
   ];
   for (const candidate of candidates) {
-    if (BUNDLED_SKILL_NAMES.every((name) => fs5.existsSync(path4.join(candidate, name, "SKILL.md")))) {
+    if (BUNDLED_SKILL_NAMES.every((name) => fs6.existsSync(path4.join(candidate, name, "SKILL.md")))) {
       return candidate;
     }
   }
@@ -5962,13 +6241,13 @@ function getBundledSkills(pkgDir) {
   return BUNDLED_SKILL_NAMES.map((name) => {
     const skillDir = path4.join(root, name);
     const skillFile = path4.join(skillDir, "SKILL.md");
-    const content = fs5.readFileSync(skillFile, "utf-8");
+    const content = fs6.readFileSync(skillFile, "utf-8");
     return { name, description: parseDescription(content), bundledPath: skillDir };
   });
 }
 function walkRelative(dir, prefix = "") {
   const out = [];
-  for (const entry of fs5.readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of fs6.readdirSync(dir, { withFileTypes: true })) {
     const rel = prefix ? path4.join(prefix, entry.name) : entry.name;
     const full = path4.join(dir, entry.name);
     if (entry.isDirectory()) {
@@ -5980,28 +6259,28 @@ function walkRelative(dir, prefix = "") {
   return out.sort();
 }
 function compareDirContent(srcDir, destDir) {
-  if (!fs5.existsSync(destDir)) return "missing";
-  if (!fs5.statSync(destDir).isDirectory()) return "different";
+  if (!fs6.existsSync(destDir)) return "missing";
+  if (!fs6.statSync(destDir).isDirectory()) return "different";
   const srcFiles = walkRelative(srcDir);
   const destFiles = walkRelative(destDir);
   if (srcFiles.length !== destFiles.length) return "different";
   for (let i = 0; i < srcFiles.length; i++) {
     if (srcFiles[i] !== destFiles[i]) return "different";
-    const srcBytes = fs5.readFileSync(path4.join(srcDir, srcFiles[i]));
-    const destBytes = fs5.readFileSync(path4.join(destDir, destFiles[i]));
+    const srcBytes = fs6.readFileSync(path4.join(srcDir, srcFiles[i]));
+    const destBytes = fs6.readFileSync(path4.join(destDir, destFiles[i]));
     if (!srcBytes.equals(destBytes)) return "different";
   }
   return "match";
 }
 function copyDirRecursive(src, dest) {
-  fs5.mkdirSync(dest, { recursive: true });
-  for (const entry of fs5.readdirSync(src, { withFileTypes: true })) {
+  fs6.mkdirSync(dest, { recursive: true });
+  for (const entry of fs6.readdirSync(src, { withFileTypes: true })) {
     const srcPath = path4.join(src, entry.name);
     const destPath = path4.join(dest, entry.name);
     if (entry.isDirectory()) {
       copyDirRecursive(srcPath, destPath);
     } else if (entry.isFile()) {
-      fs5.copyFileSync(srcPath, destPath);
+      fs6.copyFileSync(srcPath, destPath);
     }
   }
 }
@@ -6026,7 +6305,7 @@ function installClaudeSkill(skill, targetDir, force) {
     });
   }
   if (compare === "different") {
-    fs5.rmSync(targetPath, { recursive: true, force: true });
+    fs6.rmSync(targetPath, { recursive: true, force: true });
   }
   copyDirRecursive(skill.bundledPath, targetPath);
   return {
@@ -6041,15 +6320,15 @@ function installCodexSymlink(skill, targetDir, force) {
   const codexPath = path4.join(targetDir, ".codex", "skills", skill.name);
   const claudePath = path4.join(targetDir, ".claude", "skills", skill.name);
   const linkTarget = path4.relative(path4.dirname(codexPath), claudePath);
-  fs5.mkdirSync(path4.dirname(codexPath), { recursive: true });
+  fs6.mkdirSync(path4.dirname(codexPath), { recursive: true });
   let stat;
   try {
-    stat = fs5.lstatSync(codexPath);
+    stat = fs6.lstatSync(codexPath);
   } catch {
     stat = void 0;
   }
   if (stat?.isSymbolicLink()) {
-    const existing = fs5.readlinkSync(codexPath);
+    const existing = fs6.readlinkSync(codexPath);
     if (existing === linkTarget) {
       return {
         skill: skill.name,
@@ -6067,8 +6346,8 @@ function installCodexSymlink(skill, targetDir, force) {
         exitCode: 1
       });
     }
-    fs5.unlinkSync(codexPath);
-    fs5.symlinkSync(linkTarget, codexPath);
+    fs6.unlinkSync(codexPath);
+    fs6.symlinkSync(linkTarget, codexPath);
     return {
       skill: skill.name,
       client: CodingAgents.codex,
@@ -6086,9 +6365,9 @@ function installCodexSymlink(skill, targetDir, force) {
         exitCode: 1
       });
     }
-    fs5.rmSync(codexPath, { recursive: true, force: true });
+    fs6.rmSync(codexPath, { recursive: true, force: true });
   }
-  fs5.symlinkSync(linkTarget, codexPath);
+  fs6.symlinkSync(linkTarget, codexPath);
   return {
     skill: skill.name,
     client: CodingAgents.codex,
@@ -6120,7 +6399,7 @@ async function installSkills(opts = {}) {
     });
   }
   const skillsToInstall = allSkills.filter((s) => requestedNames.includes(s.name));
-  fs5.mkdirSync(targetDir, { recursive: true });
+  fs6.mkdirSync(targetDir, { recursive: true });
   const results = [];
   for (const skill of skillsToInstall) {
     results.push(installClaudeSkill(skill, targetDir, force));
@@ -6221,11 +6500,11 @@ var SKILLS_CLI_COMMANDS = [
 ];
 
 // src/commands/snapshot.ts
-import fs7 from "fs";
+import fs8 from "fs";
 import path6 from "path";
 
 // src/snapshot-pdf.ts
-import fs6 from "fs";
+import fs7 from "fs";
 import path5 from "path";
 import { PDFDocument, StandardFonts, rgb } from "pdf-lib";
 var PAGE_WIDTH = 612;
@@ -6436,8 +6715,8 @@ async function writeSnapshotPdf(report, outputPath) {
   renderQueries(pdf, report);
   const bytes = await doc.save();
   const resolvedPath = path5.resolve(outputPath);
-  fs6.mkdirSync(path5.dirname(resolvedPath), { recursive: true });
-  fs6.writeFileSync(resolvedPath, bytes);
+  fs7.mkdirSync(path5.dirname(resolvedPath), { recursive: true });
+  fs7.writeFileSync(resolvedPath, bytes);
   return resolvedPath;
 }
 function renderCover(pdf, report) {
@@ -6453,7 +6732,7 @@ function renderCover(pdf, report) {
     minute: "2-digit"
   }));
   pdf.keyValue("AEO Audit", `${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
-  pdf.keyValue("Visibility Gap", report.summary.visibilityGap);
+  pdf.keyValue("Visibility Gap (Citations + Mentions)", report.summary.visibilityGap);
   pdf.paragraph(report.profile.summary, { size: 11, color: INK, lineHeight: 16 });
   pdf.rule();
 }
@@ -6500,9 +6779,9 @@ function renderCompetitors(pdf, report) {
 }
 function renderQueries(pdf, report) {
   pdf.heading("Provider Comparison");
-  for (const query of report.queryResults) {
-    pdf.subheading(query.phrase, 11);
-    for (const result of query.providerResults) {
+  for (const queryResult of report.queryResults) {
+    pdf.subheading(queryResult.query, 11);
+    for (const result of queryResult.providerResults) {
       const status = result.error ? "error" : result.mentioned ? result.cited ? "mentioned and cited" : "mentioned" : "not mentioned";
       const accuracy = result.describedAccurately === "not-mentioned" ? "" : `; accuracy: ${result.describedAccurately}`;
       const competitors2 = result.recommendedCompetitors.length > 0 ? `; recommended instead: ${result.recommendedCompetitors.join(", ")}` : "";
@@ -6552,7 +6831,7 @@ function wrapText(font, text, size, maxWidth) {
 }
 
 // src/commands/snapshot.ts
-function getClient17() {
+function getClient18() {
   return createApiClient();
 }
 function slugify(value) {
@@ -6563,11 +6842,11 @@ function autoOutputPath(companyName, ext) {
   return `${slugify(companyName)}-snapshot-${date}.${ext}`;
 }
 async function createSnapshotReport(companyName, opts) {
-  const client = getClient17();
+  const client = getClient18();
   const report = await client.createSnapshot({
     companyName,
     domain: opts.domain,
-    ...opts.phrases && opts.phrases.length > 0 ? { phrases: opts.phrases } : {},
+    ...opts.queries && opts.queries.length > 0 ? { queries: opts.queries } : {},
     ...opts.competitors && opts.competitors.length > 0 ? { competitors: opts.competitors } : {}
   });
   let savedMdPath;
@@ -6596,8 +6875,8 @@ PDF saved: ${savedPdfPath}`);
 }
 function writeSnapshotMarkdown(report, outputPath) {
   const resolvedPath = path6.resolve(outputPath);
-  fs7.mkdirSync(path6.dirname(resolvedPath), { recursive: true });
-  fs7.writeFileSync(resolvedPath, formatSnapshotMarkdown(report), "utf-8");
+  fs8.mkdirSync(path6.dirname(resolvedPath), { recursive: true });
+  fs8.writeFileSync(resolvedPath, formatSnapshotMarkdown(report), "utf-8");
   return resolvedPath;
 }
 function formatSnapshotMarkdown(report) {
@@ -6608,7 +6887,7 @@ function formatSnapshotMarkdown(report) {
   lines.push(`**Generated:** ${new Date(report.generatedAt).toLocaleString("en-US", { year: "numeric", month: "long", day: "numeric", hour: "numeric", minute: "2-digit" })}`);
   lines.push(`**AEO Audit Score:** ${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
   lines.push("");
-  lines.push("## Visibility Gap");
+  lines.push("## Visibility Gap (Citations + Mentions)");
   lines.push("");
   lines.push(report.summary.visibilityGap);
   lines.push("");
@@ -6640,12 +6919,12 @@ function formatSnapshotMarkdown(report) {
   }
   lines.push("## Provider Comparison");
   lines.push("");
-  for (const query of report.queryResults) {
-    lines.push(`### "${query.phrase}"`);
+  for (const queryResult of report.queryResults) {
+    lines.push(`### "${queryResult.query}"`);
     lines.push("");
     lines.push("| Provider | Mentioned | Cited | Accuracy | Competitors Recommended |");
     lines.push("|----------|-----------|-------|----------|------------------------|");
-    for (const result of query.providerResults) {
+    for (const result of queryResult.providerResults) {
       if (result.error) {
         lines.push(`| ${result.displayName} | ERROR | - | - | ${result.error} |`);
         continue;
@@ -6696,11 +6975,11 @@ function formatSnapshotText(report) {
   }
   const providerWidth = Math.max(
     8,
-    ...report.queryResults.flatMap((query) => query.providerResults.map((result) => result.displayName.length))
+    ...report.queryResults.flatMap((queryResult) => queryResult.providerResults.map((result) => result.displayName.length))
   );
-  for (const query of report.queryResults) {
-    lines.push(`"${query.phrase}"`);
-    for (const result of query.providerResults) {
+  for (const queryResult of report.queryResults) {
+    lines.push(`"${queryResult.query}"`);
+    for (const result of queryResult.providerResults) {
       lines.push(`  ${result.displayName.padEnd(providerWidth)}  ${formatProviderLine(result)}`);
     }
     lines.push("");
@@ -6741,9 +7020,10 @@ function parseCsvOption(value) {
 var SNAPSHOT_CLI_COMMANDS = [
   {
     path: ["snapshot"],
-    usage: 'canonry snapshot <company-name> --domain <domain> [--phrases "a,b"] [--competitors "x,y"] [--md] [--output <path>] [--pdf] [--format table|json]',
+    usage: 'canonry snapshot <company-name> --domain <domain> [--queries "a,b"] [--phrases "a,b" (legacy alias)] [--competitors "x,y"] [--md] [--output <path>] [--pdf] [--format table|json]',
     options: {
       domain: stringOption(),
+      queries: stringOption(),
       phrases: stringOption(),
       competitors: stringOption(),
       md: { type: "boolean" },
@@ -6751,7 +7031,7 @@ var SNAPSHOT_CLI_COMMANDS = [
       output: stringOption()
     },
     run: async (input) => {
-      const usage = 'canonry snapshot <company-name> --domain <domain> [--phrases "a,b"] [--competitors "x,y"] [--md] [--output <path>] [--pdf] [--format table|json]';
+      const usage = 'canonry snapshot <company-name> --domain <domain> [--queries "a,b"] [--phrases "a,b" (legacy alias)] [--competitors "x,y"] [--md] [--output <path>] [--pdf] [--format table|json]';
       const companyName = requirePositional(input, 0, {
         command: "snapshot",
         usage,
@@ -6768,7 +7048,7 @@ var SNAPSHOT_CLI_COMMANDS = [
       const wantsMd = explicitMd || !!outputPath && !wantsPdf;
       await createSnapshotReport(companyName, {
         domain,
-        phrases: parseCsvOption(getString(input.values, "phrases")),
+        queries: parseCsvOption(getString(input.values, "queries") ?? getString(input.values, "phrases")),
         competitors: parseCsvOption(getString(input.values, "competitors")),
         md: wantsMd,
         pdf: wantsPdf,
@@ -6867,7 +7147,7 @@ async function showOverview(project, opts) {
     console.log(JSON.stringify(overview, null, 2));
     return;
   }
-  const { project: meta, latestRun, health, topInsights, keywordCounts, providers, transitions } = overview;
+  const { project: meta, latestRun, health, topInsights, queryCounts, providers, transitions } = overview;
   console.log(`Overview: ${meta.displayName ?? meta.name} (${meta.name})
 `);
   console.log(`  Domain:   ${meta.canonicalDomain}`);
@@ -6882,7 +7162,7 @@ async function showOverview(project, opts) {
     console.log("\n  No runs yet.");
   }
   console.log(`
-  Keywords cited: ${keywordCounts.citedKeywords}/${keywordCounts.totalKeywords} (${pct(keywordCounts.citedRate)})`);
+  Queries cited: ${queryCounts.citedQueries}/${queryCounts.totalQueries} (${pct(queryCounts.citedRate)})`);
   if (providers.length > 0) {
     console.log("  Providers:");
     for (const p of providers) {
@@ -6924,14 +7204,14 @@ async function searchProject(project, opts) {
   }
   for (const hit of result.hits) {
     if (hit.kind === "snapshot") {
-      console.log(`  [snapshot] ${hit.keyword} (${hit.provider}, ${hit.citationState}) \u2014 ${hit.matchedField}`);
+      console.log(`  [snapshot] ${hit.query} (${hit.provider}, ${hit.citationState}) \u2014 ${hit.matchedField}`);
       console.log(`    ${hit.snippet}`);
       console.log(`    run=${hit.runId}  at ${hit.createdAt}`);
     } else {
       const dismissed = hit.dismissed ? " [dismissed]" : "";
       console.log(`  [insight ${hit.severity.toUpperCase()}] ${hit.type} \u2014 ${hit.title}${dismissed}`);
       console.log(`    ${hit.snippet}`);
-      console.log(`    keyword=${hit.keyword}  at ${hit.createdAt}`);
+      console.log(`    query=${hit.query}  at ${hit.createdAt}`);
     }
     console.log("");
   }
@@ -6946,8 +7226,8 @@ async function showCitationVisibility(project, opts) {
     return;
   }
   if (data.status === "no-data") {
-    if (data.reason === "no-keywords") {
-      console.log("No keywords configured. Add some with `canonry keyword add`.");
+    if (data.reason === "no-queries") {
+      console.log("No queries configured. Add some with `canonry query add`.");
     } else {
       console.log("No citation data yet \u2014 run a sweep first (canonry run <project>).");
     }
@@ -6966,49 +7246,49 @@ function printSummary(data) {
     providersCiting,
     providersMentioning,
     providersConfigured,
-    totalKeywords,
-    keywordsCitedAndMentioned,
-    keywordsCitedOnly,
-    keywordsMentionedOnly,
-    keywordsInvisible
+    totalQueries,
+    queriesCitedAndMentioned,
+    queriesCitedOnly,
+    queriesMentionedOnly,
+    queriesInvisible
   } = data.summary;
-  console.log("Citation visibility");
+  console.log("AEO visibility (citations + mentions)");
   if (data.summary.latestRunAt) {
     console.log(`Latest run:           ${data.summary.latestRunAt}`);
   }
   console.log(`Cited in sources:     ${providersCiting}/${providersConfigured} engines`);
   console.log(`Mentioned in answers: ${providersMentioning}/${providersConfigured} engines`);
   console.log("");
-  console.log(`Keywords (${totalKeywords} total):`);
-  console.log(`  cited + mentioned:  ${keywordsCitedAndMentioned}`);
-  console.log(`  cited only:         ${keywordsCitedOnly}`);
-  console.log(`  mentioned only:     ${keywordsMentionedOnly}`);
-  console.log(`  invisible:          ${keywordsInvisible}`);
+  console.log(`Queries (${totalQueries} total):`);
+  console.log(`  cited + mentioned:  ${queriesCitedAndMentioned}`);
+  console.log(`  cited only:         ${queriesCitedOnly}`);
+  console.log(`  mentioned only:     ${queriesMentionedOnly}`);
+  console.log(`  invisible:          ${queriesInvisible}`);
 }
 function printCoverage(data) {
-  if (data.byKeyword.length === 0) {
-    console.log("No keyword coverage rows.");
+  if (data.byQuery.length === 0) {
+    console.log("No query coverage rows.");
     return;
   }
   const providerSet = /* @__PURE__ */ new Set();
-  for (const row of data.byKeyword) {
+  for (const row of data.byQuery) {
     for (const p of row.providers) providerSet.add(p.provider);
   }
   const providerColumns = Array.from(providerSet).sort();
   if (providerColumns.length === 0) {
-    console.log("Per-keyword coverage:");
-    for (const row of data.byKeyword) {
-      console.log(`  ${row.keyword.padEnd(35)} no snapshots`);
+    console.log("Per-query coverage:");
+    for (const row of data.byQuery) {
+      console.log(`  ${row.query.padEnd(35)} no snapshots`);
     }
     return;
   }
   const cellWidth = Math.max(6, ...providerColumns.map((p) => p.length));
-  const keywordWidth = Math.max(7, ...data.byKeyword.map((r) => r.keyword.length));
-  const header = ["Keyword".padEnd(keywordWidth), ...providerColumns.map((p) => p.padEnd(cellWidth)), "Cite", "Ment"].join("  ");
-  console.log("Per-keyword coverage:  (cell = [citation][mention];  C=cited c=not, M=mentioned m=not, \u2013=no data)");
+  const queryWidth = Math.max(7, ...data.byQuery.map((r) => r.query.length));
+  const header = ["Query".padEnd(queryWidth), ...providerColumns.map((p) => p.padEnd(cellWidth)), "Cite", "Ment"].join("  ");
+  console.log("Per-query coverage:  (cell = [citation][mention];  C=cited c=not, M=mentioned m=not, \u2013=no data)");
   console.log(header);
   console.log("\u2500".repeat(header.length));
-  for (const row of data.byKeyword) {
+  for (const row of data.byQuery) {
     const cells = providerColumns.map((p) => {
       const provider = row.providers.find((x) => x.provider === p);
       if (!provider) return "\u2013".padEnd(cellWidth);
@@ -7018,16 +7298,16 @@ function printCoverage(data) {
     });
     const citeCol = `${row.citedCount}/${row.totalProviders}`;
     const mentCol = `${row.mentionedCount}/${row.totalProviders}`;
-    console.log([row.keyword.padEnd(keywordWidth), ...cells, citeCol, mentCol].join("  "));
+    console.log([row.query.padEnd(queryWidth), ...cells, citeCol, mentCol].join("  "));
   }
 }
 function printGaps2(data) {
   console.log("Competitor gaps (not cited but a competitor is):");
-  const keywordWidth = Math.max(7, ...data.competitorGaps.map((g) => g.keyword.length));
+  const queryWidth = Math.max(7, ...data.competitorGaps.map((g) => g.query.length));
   const providerWidth = Math.max(8, ...data.competitorGaps.map((g) => g.provider.length));
   for (const gap of data.competitorGaps) {
     console.log(
-      `  ${gap.keyword.padEnd(keywordWidth)}  ${gap.provider.padEnd(providerWidth)}  ${gap.citingCompetitors.join(", ")}`
+      `  ${gap.query.padEnd(queryWidth)}  ${gap.provider.padEnd(providerWidth)}  ${gap.citingCompetitors.join(", ")}`
     );
   }
 }
@@ -7469,7 +7749,7 @@ async function bootstrapCommand(_opts) {
 
 // src/commands/daemon.ts
 import { spawn } from "child_process";
-import fs8 from "fs";
+import fs9 from "fs";
 import path8 from "path";
 function getPidPath() {
   return path8.join(getConfigDir(), "canonry.pid");
@@ -7499,8 +7779,8 @@ async function waitForReady(host, port, maxMs = 1e4) {
 async function startDaemon(opts) {
   const pidPath = getPidPath();
   const format = opts.format ?? "text";
-  if (fs8.existsSync(pidPath)) {
-    const existingPid = parseInt(fs8.readFileSync(pidPath, "utf-8").trim(), 10);
+  if (fs9.existsSync(pidPath)) {
+    const existingPid = parseInt(fs9.readFileSync(pidPath, "utf-8").trim(), 10);
     if (!isNaN(existingPid) && isProcessAlive(existingPid)) {
       throw new CliError({
         code: "DAEMON_ALREADY_RUNNING",
@@ -7511,7 +7791,7 @@ async function startDaemon(opts) {
         }
       });
     }
-    fs8.unlinkSync(pidPath);
+    fs9.unlinkSync(pidPath);
   }
   const cliPath = path8.resolve(new URL(import.meta.url).pathname);
   const inSourceMode = new URL(import.meta.url).pathname.endsWith(".ts");
@@ -7532,10 +7812,10 @@ async function startDaemon(opts) {
     });
   }
   const configDir = getConfigDir();
-  if (!fs8.existsSync(configDir)) {
-    fs8.mkdirSync(configDir, { recursive: true });
+  if (!fs9.existsSync(configDir)) {
+    fs9.mkdirSync(configDir, { recursive: true });
   }
-  fs8.writeFileSync(pidPath, String(child.pid), "utf-8");
+  fs9.writeFileSync(pidPath, String(child.pid), "utf-8");
   const port = opts.port ?? "4100";
   const host = opts.host ?? "127.0.0.1";
   if (format !== "json") {
@@ -7544,7 +7824,7 @@ async function startDaemon(opts) {
   const ready = await waitForReady(host, port);
   if (!ready) {
     try {
-      fs8.unlinkSync(pidPath);
+      fs9.unlinkSync(pidPath);
     } catch {
     }
     throw new CliError({
@@ -7576,7 +7856,7 @@ async function startDaemon(opts) {
 }
 function stopDaemon(format = "text") {
   const pidPath = getPidPath();
-  if (!fs8.existsSync(pidPath)) {
+  if (!fs9.existsSync(pidPath)) {
     if (format === "json") {
       console.log(JSON.stringify({
         stopped: false,
@@ -7587,7 +7867,7 @@ function stopDaemon(format = "text") {
     console.log("Canonry is not running (no PID file found)");
     return;
   }
-  const pid = parseInt(fs8.readFileSync(pidPath, "utf-8").trim(), 10);
+  const pid = parseInt(fs9.readFileSync(pidPath, "utf-8").trim(), 10);
   if (isNaN(pid)) {
     if (format === "json") {
       console.log(JSON.stringify({
@@ -7598,7 +7878,7 @@ function stopDaemon(format = "text") {
     } else {
       console.error("Invalid PID file. Removing it.");
     }
-    fs8.unlinkSync(pidPath);
+    fs9.unlinkSync(pidPath);
     return;
   }
   if (!isProcessAlive(pid)) {
@@ -7612,12 +7892,12 @@ function stopDaemon(format = "text") {
     } else {
       console.log(`Canonry is not running (stale PID: ${pid}). Cleaning up.`);
     }
-    fs8.unlinkSync(pidPath);
+    fs9.unlinkSync(pidPath);
     return;
   }
   try {
     process.kill(pid, "SIGTERM");
-    fs8.unlinkSync(pidPath);
+    fs9.unlinkSync(pidPath);
     if (format === "json") {
       console.log(JSON.stringify({
         stopped: true,
@@ -7641,7 +7921,7 @@ function stopDaemon(format = "text") {
 
 // src/commands/init.ts
 import crypto2 from "crypto";
-import fs9 from "fs";
+import fs10 from "fs";
 import readline from "readline";
 import path9 from "path";
 function prompt(question) {
@@ -7665,7 +7945,7 @@ var PROJECT_MARKERS = [".git", "canonry.yaml", "canonry.yml", "package.json"];
 function cwdLooksLikeProject(dir) {
   const home = process.env.HOME ?? "";
   if (home && path9.resolve(dir) === path9.resolve(home)) return false;
-  return PROJECT_MARKERS.some((marker) => fs9.existsSync(path9.join(dir, marker)));
+  return PROJECT_MARKERS.some((marker) => fs10.existsSync(path9.join(dir, marker)));
 }
 var DEFAULT_AGENT_MODELS = {
   anthropic: "anthropic/claude-sonnet-4-6",
@@ -7695,8 +7975,8 @@ async function initCommand(opts) {
     return void 0;
   }
   const configDir = getConfigDir();
-  if (!fs9.existsSync(configDir)) {
-    fs9.mkdirSync(configDir, { recursive: true });
+  if (!fs10.existsSync(configDir)) {
+    fs10.mkdirSync(configDir, { recursive: true });
   }
   const bootstrapEnv = getBootstrapEnv(process.env, {
     GEMINI_API_KEY: opts?.geminiKey,
@@ -8259,10 +8539,10 @@ var SYSTEM_CLI_COMMANDS = [
 ];
 
 // src/cli-commands/wordpress.ts
-import fs10 from "fs";
+import fs11 from "fs";
 
 // src/commands/wordpress.ts
-function getClient18() {
+function getClient19() {
   return createApiClient();
 }
 function printJson2(value) {
@@ -8409,7 +8689,7 @@ async function wordpressConnect(project, opts) {
       details: { project }
     });
   }
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressConnect(project, {
     url: opts.url,
     stagingUrl: opts.stagingUrl,
@@ -8426,7 +8706,7 @@ async function wordpressConnect(project, opts) {
   printWordpressStatus(project, result);
 }
 async function wordpressDisconnect(project, format) {
-  const client = getClient18();
+  const client = getClient19();
   await client.wordpressDisconnect(project);
   if (format === "json") {
     printJson2({ project, disconnected: true });
@@ -8435,7 +8715,7 @@ async function wordpressDisconnect(project, format) {
   console.log(`WordPress disconnected from project "${project}".`);
 }
 async function wordpressStatus(project, format) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressStatus(project);
   if (format === "json") {
     printJson2(result);
@@ -8444,7 +8724,7 @@ async function wordpressStatus(project, format) {
   printWordpressStatus(project, result);
 }
 async function wordpressPages(project, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressPages(project, opts.env);
   if (opts.format === "json") {
     printJson2(result);
@@ -8453,7 +8733,7 @@ async function wordpressPages(project, opts) {
   printPages(project, result.env, result.pages);
 }
 async function wordpressPage(project, slug, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressPage(project, slug, opts.env);
   if (opts.format === "json") {
     printJson2(result);
@@ -8462,7 +8742,7 @@ async function wordpressPage(project, slug, opts) {
   printPageDetail(result);
 }
 async function wordpressCreatePage(project, body) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressCreatePage(project, body);
   if (body.format === "json") {
     printJson2(result);
@@ -8473,7 +8753,7 @@ async function wordpressCreatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressUpdatePage(project, body) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressUpdatePage(project, body);
   if (body.format === "json") {
     printJson2(result);
@@ -8484,7 +8764,7 @@ async function wordpressUpdatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressSetMeta(project, body) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressSetMeta(project, body);
   if (body.format === "json") {
     printJson2(result);
@@ -8495,12 +8775,12 @@ async function wordpressSetMeta(project, body) {
   printPageDetail(result);
 }
 async function wordpressBulkSetMeta(project, opts) {
-  const fs11 = await import("fs/promises");
+  const fs12 = await import("fs/promises");
   const path10 = await import("path");
   const filePath = path10.resolve(opts.from);
   let raw;
   try {
-    raw = await fs11.readFile(filePath, "utf8");
+    raw = await fs12.readFile(filePath, "utf8");
   } catch {
     throw new CliError({
       code: "FILE_READ_ERROR",
@@ -8534,7 +8814,7 @@ async function wordpressBulkSetMeta(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressBulkSetMeta(project, { entries, env: opts.env });
   if (opts.format === "json") {
     printJson2(result);
@@ -8577,7 +8857,7 @@ async function wordpressBulkSetMeta(project, opts) {
 Total: ${applied.length} applied, ${skipped.length} skipped, ${manual.length} manual`);
 }
 async function wordpressSchema(project, slug, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressSchema(project, slug, opts.env);
   if (opts.format === "json") {
     printJson2(result);
@@ -8588,7 +8868,7 @@ async function wordpressSchema(project, slug, opts) {
   printSchemaBlocks(result.blocks);
 }
 async function wordpressSetSchema(project, body) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressSetSchema(project, body);
   if (body.format === "json") {
     printJson2(result);
@@ -8597,13 +8877,13 @@ async function wordpressSetSchema(project, body) {
   printManualAssist(`Schema update for "${body.slug}"`, result);
 }
 async function wordpressSchemaDeploy(project, opts) {
-  const fs11 = await import("fs/promises");
+  const fs12 = await import("fs/promises");
   const path10 = await import("path");
   const yaml = await import("yaml").catch(() => null);
   const filePath = path10.resolve(opts.profile);
   let raw;
   try {
-    raw = await fs11.readFile(filePath, "utf8");
+    raw = await fs12.readFile(filePath, "utf8");
   } catch {
     throw new CliError({
       code: "FILE_READ_ERROR",
@@ -8636,7 +8916,7 @@ async function wordpressSchemaDeploy(project, opts) {
       details: { path: filePath }
     });
   }
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressSchemaDeploy(project, { profile: parsed, env: opts.env });
   if (opts.format === "json") {
     printJson2(result);
@@ -8675,7 +8955,7 @@ async function wordpressSchemaDeploy(project, opts) {
 Total: ${deployed} deployed, ${stripped} stripped, ${skipped} skipped, ${failed} failed`);
 }
 async function wordpressSchemaStatus(project, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressSchemaStatus(project, opts.env);
   if (opts.format === "json") {
     printJson2(result);
@@ -8708,13 +8988,13 @@ async function wordpressOnboard(project, opts) {
   }
   let profileData;
   if (opts.profile) {
-    const fs11 = await import("fs/promises");
+    const fs12 = await import("fs/promises");
     const path10 = await import("path");
     const yaml = await import("yaml").catch(() => null);
     const filePath = path10.resolve(opts.profile);
     let raw;
     try {
-      raw = await fs11.readFile(filePath, "utf8");
+      raw = await fs12.readFile(filePath, "utf8");
     } catch {
       throw new CliError({
         code: "FILE_READ_ERROR",
@@ -8734,7 +9014,7 @@ async function wordpressOnboard(project, opts) {
       });
     }
   }
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressOnboard(project, {
     url: opts.url,
     username: opts.user,
@@ -8759,7 +9039,7 @@ async function wordpressOnboard(project, opts) {
   }
 }
 async function wordpressLlmsTxt(project, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressLlmsTxt(project, opts.env);
   if (opts.format === "json") {
     printJson2(result);
@@ -8770,7 +9050,7 @@ async function wordpressLlmsTxt(project, opts) {
   console.log(result.content ?? "(not found)");
 }
 async function wordpressSetLlmsTxt(project, body) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressSetLlmsTxt(project, body);
   if (body.format === "json") {
     printJson2(result);
@@ -8779,7 +9059,7 @@ async function wordpressSetLlmsTxt(project, body) {
   printManualAssist(`llms.txt update for "${project}"`, result);
 }
 async function wordpressAudit(project, opts) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressAudit(project, opts.env);
   if (opts.format === "json") {
     printJson2(result);
@@ -8793,7 +9073,7 @@ async function wordpressAudit(project, opts) {
   printAuditIssues(result.issues);
 }
 async function wordpressDiff(project, slug, format) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressDiff(project, slug);
   if (format === "json") {
     printJson2(result);
@@ -8802,7 +9082,7 @@ async function wordpressDiff(project, slug, format) {
   printDiff(result);
 }
 async function wordpressStagingStatus(project, format) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressStagingStatus(project);
   if (format === "json") {
     printJson2(result);
@@ -8816,7 +9096,7 @@ async function wordpressStagingStatus(project, format) {
   console.log(`  Admin URL:         ${result.adminUrl}`);
 }
 async function wordpressStagingPush(project, format) {
-  const client = getClient18();
+  const client = getClient19();
   const result = await client.wordpressStagingPush(project);
   if (format === "json") {
     printJson2(result);
@@ -8863,7 +9143,7 @@ function resolveContent(input, command, usage, options) {
   }
   if (contentFile) {
     try {
-      return fs10.readFileSync(contentFile, "utf-8");
+      return fs11.readFileSync(contentFile, "utf-8");
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       throw usageError(`Error: could not read --content-file "${contentFile}": ${message}`, {
@@ -9795,6 +10075,7 @@ var REGISTERED_CLI_COMMANDS = [
   ...SYSTEM_CLI_COMMANDS,
   ...PROJECT_CLI_COMMANDS,
   ...REPORT_CLI_COMMANDS,
+  ...QUERY_CLI_COMMANDS,
   ...KEYWORD_CLI_COMMANDS,
   ...COMPETITOR_CLI_COMMANDS,
   ...SETTINGS_CLI_COMMANDS,
@@ -9832,14 +10113,14 @@ Setup:
 
 Projects:
   project               Create, update, list, show, delete projects
-  keyword               Add, replace, remove, list, import, generate key phrases
+  query                 Add, replace, remove, list, import, generate queries
   competitor            Add, remove, list competitors
 
 Monitoring:
   run                   Trigger visibility sweeps
   snapshot              One-shot AI perception report
   status <project>      Show project summary
-  evidence <project>    Show per-phrase results
+  evidence <project>    Show per-query results
   analytics <project>   Show analytics (metrics, gaps, sources)
   insights <project>    Show intelligence insights
   health <project>      Show citation health
@@ -9893,7 +10174,7 @@ async function runCli(args = process.argv.slice(2)) {
     showFirstRunNotice();
     getOrCreateAnonymousId();
   }
-  const SUBCOMMAND_COMMANDS = /* @__PURE__ */ new Set(["backfill", "project", "keyword", "competitor", "schedule", "notify", "settings", "telemetry", "google", "bing", "wordpress", "cdp"]);
+  const SUBCOMMAND_COMMANDS = /* @__PURE__ */ new Set(["backfill", "project", "query", "keyword", "competitor", "schedule", "notify", "settings", "telemetry", "google", "bing", "wordpress", "cdp"]);
   const MIXED_SUBCOMMANDS = {
     insights: /* @__PURE__ */ new Set(["dismiss"]),
     run: /* @__PURE__ */ new Set(["show", "cancel"])