@ainyc/canonry 3.6.3 → 4.1.1

package/dist/{chunk-GLPZ5NVP.js → chunk-KCETXLDF.js}

@@ -8,9 +8,11 @@ import {
   notificationEventSchema,
   projectConfigSchema,
   projectUpsertRequestSchema,
+  queryBatchRequestSchema,
+  queryGenerateRequestSchema,
   runTriggerRequestSchema,
   scheduleUpsertRequestSchema
-} from "./chunk-RDX6GBWM.js";
+} from "./chunk-O5JZQUPX.js";
 
 // src/config.ts
 import fs from "fs";
@@ -454,6 +456,18 @@ var ApiClient = class {
   async deleteProject(name) {
     await this.request("DELETE", `/projects/${encodeURIComponent(name)}`);
   }
+  async putQueries(project, queries) {
+    await this.request("PUT", `/projects/${encodeURIComponent(project)}/queries`, { queries });
+  }
+  async listQueries(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/queries`);
+  }
+  async deleteQueries(project, queries) {
+    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/queries`, { queries });
+  }
+  async appendQueries(project, queries) {
+    await this.request("POST", `/projects/${encodeURIComponent(project)}/queries`, { queries });
+  }
   async putKeywords(project, keywords) {
     await this.request("PUT", `/projects/${encodeURIComponent(project)}/keywords`, { keywords });
   }
@@ -567,6 +581,13 @@ var ApiClient = class {
   async updateTelemetry(enabled) {
     return this.request("PUT", "/telemetry", { enabled });
   }
+  async generateQueries(project, provider, count) {
+    return this.request(
+      "POST",
+      `/projects/${encodeURIComponent(project)}/queries/generate`,
+      { provider, count }
+    );
+  }
   async generateKeywords(project, provider, count) {
     return this.request(
       "POST",
@@ -1042,6 +1063,14 @@ var gaWindowInputSchema = z2.object({
 var gaTrafficInputSchema = gaWindowInputSchema.extend({
   limit: z2.number().int().positive().max(500).optional()
 });
+var queriesInputSchema = z2.object({
+  project: projectNameSchema,
+  request: queryBatchRequestSchema
+});
+var queryGenerateInputSchema = z2.object({
+  project: projectNameSchema,
+  request: queryGenerateRequestSchema
+});
 var keywordsInputSchema = z2.object({
   project: projectNameSchema,
   request: keywordBatchRequestSchema
@@ -1124,7 +1153,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_project_overview",
     title: "Get project overview (composite)",
-    description: 'One-call summary for "how is project X doing?" \u2014 bundles project info, latest run, top undismissed insights, latest health snapshot, keyword cited rate, per-provider breakdown, and gained/lost/emerging vs the previous run. Prefer this over fanning out to separate tools.',
+    description: 'One-call summary for "how is project X doing?" \u2014 bundles project info, latest run, top undismissed insights, latest health snapshot, query cited rate, per-provider breakdown, and gained/lost/emerging vs the previous run. Prefer this over fanning out to separate tools.',
     access: "read",
     tier: "core",
     inputSchema: projectInputSchema,
@@ -1135,7 +1164,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_report",
     title: "Get aggregated AEO report",
-    description: "Returns the full client-facing AEO report bundle for a project \u2014 executive summary, per-keyword \xD7 per-provider citation matrix, competitor landscape, AI citation sources, GSC/GA4 performance, social and AI referrals, indexing health, citations trend, prioritized insights, and recommended next steps. Same payload `canonry report <project>` consumes to render the self-contained HTML.",
+    description: "Returns the full client-facing AEO report bundle for a project \u2014 executive summary, per-query \xD7 per-provider citation matrix, competitor landscape, AI citation sources, GSC/GA4 performance, social and AI referrals, indexing health, citations trend, prioritized insights, and recommended next steps. Same payload `canonry report <project>` consumes to render the self-contained HTML.",
     access: "read",
     tier: "monitoring",
     inputSchema: projectInputSchema,
@@ -1146,7 +1175,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_search",
     title: "Search project (composite)",
-    description: "Search query snapshots and intelligence insights for the given text. Looks at snapshot answer text, cited domains, raw provider responses, and insight title/keyword/recommendation/cause. Returns ranked hits with snippets \u2014 use it instead of paginating snapshots when you need to find a competitor mention or term.",
+    description: "Search query snapshots and intelligence insights for the given text. Looks at snapshot answer text, cited domains, raw provider responses, and insight title/query/recommendation/cause. Returns ranked hits with snippets \u2014 use it instead of paginating snapshots when you need to find a competitor mention or term.",
     access: "read",
     tier: "core",
     inputSchema: z2.object({
@@ -1227,7 +1256,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_timeline_get",
     title: "Get project timeline",
-    description: "Get per-keyword citation history for a Canonry project.",
+    description: "Get per-query citation history for a Canonry project.",
     access: "read",
     tier: "monitoring",
     inputSchema: timelineInputSchema,
@@ -1308,7 +1337,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_citations_visibility",
     title: "Get citation visibility",
-    description: 'Single-call AI citation surface for a Canonry project. Returns the project headline (cited by N of M engines), per-keyword engine coverage rows from the latest snapshot per (keyword \xD7 provider), and a competitor-gap list (keywords where a configured competitor is cited but the project is not). Carries `status: "no-data"` with `reason: "no-keywords"` or `"no-runs-yet"` when inputs are missing.',
+    description: 'Single-call AI citation surface for a Canonry project. Returns the project headline (cited by N of M engines), per-query engine coverage rows from the latest snapshot per (query \xD7 provider), and a competitor-gap list (queries where a configured competitor is cited but the project is not). Carries `status: "no-data"` with `reason: "no-queries"` or `"no-runs-yet"` when inputs are missing.',
     access: "read",
     tier: "monitoring",
     inputSchema: projectInputSchema,
@@ -1352,10 +1381,21 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/content/gaps"],
     handler: (client, input) => client.getContentGaps(input.project)
   }),
+  defineTool({
+    name: "canonry_queries_list",
+    title: "List queries",
+    description: "List tracked queries for a Canonry project.",
+    access: "read",
+    tier: "setup",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/queries"],
+    handler: (client, input) => client.listQueries(input.project)
+  }),
   defineTool({
     name: "canonry_keywords_list",
-    title: "List keywords",
-    description: "List tracked keywords for a Canonry project.",
+    title: "List keywords (legacy alias)",
+    description: "Legacy alias for canonry_queries_list. Returns tracked queries using the pre-queries keyword response shape.",
     access: "read",
     tier: "setup",
     inputSchema: projectInputSchema,
@@ -1609,10 +1649,21 @@ var canonryMcpTools = [
     openApiOperations: ["POST /api/v1/apply"],
     handler: (client, input) => client.apply(input.config)
   }),
+  defineTool({
+    name: "canonry_queries_generate",
+    title: "Generate query suggestions",
+    description: "Generate candidate queries using a configured provider. Returns suggestions only; use canonry_queries_add to persist them.",
+    access: "write",
+    tier: "setup",
+    inputSchema: queryGenerateInputSchema,
+    annotations: writeAnnotations({ idempotentHint: false, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/queries/generate"],
+    handler: (client, input) => client.generateQueries(input.project, input.request.provider, input.request.count)
+  }),
   defineTool({
     name: "canonry_keywords_generate",
-    title: "Generate keyword suggestions",
-    description: "Generate candidate key phrases using a configured provider. Returns suggestions only; use canonry_keywords_add to persist them.",
+    title: "Generate keyword suggestions (legacy alias)",
+    description: "Legacy alias for canonry_queries_generate. Returns suggestions using the pre-queries keyword response shape.",
     access: "write",
     tier: "setup",
     inputSchema: keywordGenerateInputSchema,
@@ -1620,10 +1671,23 @@ var canonryMcpTools = [
     openApiOperations: ["POST /api/v1/projects/{name}/keywords/generate"],
     handler: (client, input) => client.generateKeywords(input.project, input.request.provider, input.request.count)
   }),
+  defineTool({
+    name: "canonry_queries_replace",
+    title: "Replace queries",
+    description: "Replace the tracked query set for a Canonry project.",
+    access: "write",
+    tier: "setup",
+    inputSchema: queriesInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true }),
+    openApiOperations: ["PUT /api/v1/projects/{name}/queries"],
+    handler: async (client, input) => {
+      await client.putQueries(input.project, uniqueStrings(input.request.queries));
+    }
+  }),
   defineTool({
     name: "canonry_keywords_replace",
-    title: "Replace keywords",
-    description: "Replace the tracked keyword set for a Canonry project.",
+    title: "Replace keywords (legacy alias)",
+    description: "Legacy alias for canonry_queries_replace. Replaces the same canonical tracked query set.",
     access: "write",
     tier: "setup",
     inputSchema: keywordsInputSchema,
@@ -1655,10 +1719,23 @@ var canonryMcpTools = [
     openApiOperations: ["POST /api/v1/runs/{id}/cancel"],
     handler: (client, input) => client.cancelRun(input.runId)
   }),
+  defineTool({
+    name: "canonry_queries_add",
+    title: "Add queries",
+    description: "Append tracked queries to a Canonry project; existing queries are skipped by the API.",
+    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));
+    }
+  }),
   defineTool({
     name: "canonry_keywords_add",
-    title: "Add keywords",
-    description: "Append tracked keywords to a Canonry project; existing keywords are skipped by the API.",
+    title: "Add keywords (legacy alias)",
+    description: "Legacy alias for canonry_queries_add. Appends to the same canonical tracked query set.",
     access: "write",
     tier: "setup",
     inputSchema: keywordsInputSchema,
@@ -1668,10 +1745,23 @@ var canonryMcpTools = [
       await client.appendKeywords(input.project, uniqueStrings(input.request.keywords));
     }
   }),
+  defineTool({
+    name: "canonry_queries_remove",
+    title: "Remove queries",
+    description: "Remove tracked queries from a Canonry project.",
+    access: "write",
+    tier: "setup",
+    inputSchema: queriesInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true }),
+    openApiOperations: ["DELETE /api/v1/projects/{name}/queries"],
+    handler: async (client, input) => {
+      await client.deleteQueries(input.project, uniqueStrings(input.request.queries));
+    }
+  }),
   defineTool({
     name: "canonry_keywords_remove",
-    title: "Remove keywords",
-    description: "Remove tracked keywords from a Canonry project.",
+    title: "Remove keywords (legacy alias)",
+    description: "Legacy alias for canonry_queries_remove. Removes from the same canonical tracked query set.",
     access: "write",
     tier: "setup",
     inputSchema: keywordsInputSchema,

package/dist/{chunk-W463NVVC.js → chunk-NCWCPBOT.js}

@@ -2,7 +2,7 @@ import {
   ContentActions,
   RunKinds,
   __export
-} from "./chunk-RDX6GBWM.js";
+} from "./chunk-O5JZQUPX.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";
@@ -40,10 +40,10 @@ __export(schema_exports, {
   gscUrlInspections: () => gscUrlInspections,
   healthSnapshots: () => healthSnapshots,
   insights: () => insights,
-  keywords: () => keywords,
   migrationsTable: () => migrationsTable,
   notifications: () => notifications,
   projects: () => projects,
+  queries: () => queries,
   querySnapshots: () => querySnapshots,
   runs: () => runs,
   schedules: () => schedules,
@@ -69,14 +69,14 @@ var projects = sqliteTable("projects", {
   createdAt: text("created_at").notNull(),
   updatedAt: text("updated_at").notNull()
 });
-var keywords = sqliteTable("keywords", {
+var queries = sqliteTable("queries", {
   id: text("id").primaryKey(),
   projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
-  keyword: text("keyword").notNull(),
+  query: text("query").notNull(),
   createdAt: text("created_at").notNull()
 }, (table) => [
-  index("idx_keywords_project").on(table.projectId),
-  uniqueIndex("idx_keywords_project_keyword").on(table.projectId, table.keyword)
+  index("idx_queries_project").on(table.projectId),
+  uniqueIndex("idx_queries_project_query").on(table.projectId, table.query)
 ]);
 var competitors = sqliteTable("competitors", {
   id: text("id").primaryKey(),
@@ -105,7 +105,7 @@ var runs = sqliteTable("runs", {
 var querySnapshots = sqliteTable("query_snapshots", {
   id: text("id").primaryKey(),
   runId: text("run_id").notNull().references(() => runs.id, { onDelete: "cascade" }),
-  keywordId: text("keyword_id").notNull().references(() => keywords.id, { onDelete: "cascade" }),
+  queryId: text("query_id").notNull().references(() => queries.id, { onDelete: "cascade" }),
   provider: text("provider").notNull().default("gemini"),
   model: text("model"),
   citationState: text("citation_state").notNull(),
@@ -120,7 +120,7 @@ var querySnapshots = sqliteTable("query_snapshots", {
   createdAt: text("created_at").notNull()
 }, (table) => [
   index("idx_snapshots_run").on(table.runId),
-  index("idx_snapshots_keyword").on(table.keywordId),
+  index("idx_snapshots_query").on(table.queryId),
   index("idx_snapshots_citation_state").on(table.citationState),
   index("idx_snapshots_provider_model").on(table.provider, table.model),
   index("idx_snapshots_location").on(table.location),
@@ -428,7 +428,7 @@ var insights = sqliteTable("insights", {
   type: text("type").notNull(),
   severity: text("severity").notNull(),
   title: text("title").notNull(),
-  keyword: text("keyword").notNull(),
+  query: text("query").notNull(),
   provider: text("provider").notNull(),
   recommendation: text("recommendation"),
   cause: text("cause"),
@@ -438,7 +438,7 @@ var insights = sqliteTable("insights", {
   index("idx_insights_project").on(table.projectId),
   index("idx_insights_run").on(table.runId),
   index("idx_insights_created").on(table.createdAt),
-  index("idx_insights_keyword_provider").on(table.keyword, table.provider)
+  index("idx_insights_query_provider").on(table.query, table.provider)
 ]);
 var healthSnapshots = sqliteTable("health_snapshots", {
   id: text("id").primaryKey(),
@@ -580,12 +580,12 @@ CREATE TABLE IF NOT EXISTS projects (
   updated_at        TEXT NOT NULL
 );
 
-CREATE TABLE IF NOT EXISTS keywords (
+CREATE TABLE IF NOT EXISTS queries (
   id          TEXT PRIMARY KEY,
   project_id  TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
-  keyword     TEXT NOT NULL,
+  query       TEXT NOT NULL,
   created_at  TEXT NOT NULL,
-  UNIQUE(project_id, keyword)
+  UNIQUE(project_id, query)
 );
 
 CREATE TABLE IF NOT EXISTS competitors (
@@ -611,7 +611,7 @@ CREATE TABLE IF NOT EXISTS runs (
 CREATE TABLE IF NOT EXISTS query_snapshots (
   id                  TEXT PRIMARY KEY,
   run_id              TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
-  keyword_id          TEXT NOT NULL REFERENCES keywords(id) ON DELETE CASCADE,
+  query_id            TEXT NOT NULL REFERENCES queries(id) ON DELETE CASCADE,
   provider            TEXT NOT NULL DEFAULT 'gemini',
   citation_state      TEXT NOT NULL,
   answer_text         TEXT,
@@ -653,12 +653,12 @@ CREATE TABLE IF NOT EXISTS usage_counters (
   UNIQUE(scope, period, metric)
 );
 
-CREATE INDEX IF NOT EXISTS idx_keywords_project ON keywords(project_id);
+CREATE INDEX IF NOT EXISTS idx_queries_project ON queries(project_id);
 CREATE INDEX IF NOT EXISTS idx_competitors_project ON competitors(project_id);
 CREATE INDEX IF NOT EXISTS idx_runs_project ON runs(project_id);
 CREATE INDEX IF NOT EXISTS idx_runs_status ON runs(status);
 CREATE INDEX IF NOT EXISTS idx_snapshots_run ON query_snapshots(run_id);
-CREATE INDEX IF NOT EXISTS idx_snapshots_keyword ON query_snapshots(keyword_id);
+CREATE INDEX IF NOT EXISTS idx_snapshots_query ON query_snapshots(query_id);
 CREATE INDEX IF NOT EXISTS idx_audit_log_project ON audit_log(project_id);
 CREATE INDEX IF NOT EXISTS idx_audit_log_created ON audit_log(created_at);
 CREATE TABLE IF NOT EXISTS schedules (
@@ -975,7 +975,7 @@ var MIGRATION_VERSIONS = [
     version: 19,
     name: "named-unique-indexes",
     statements: [
-      `CREATE UNIQUE INDEX IF NOT EXISTS idx_keywords_project_keyword ON keywords(project_id, keyword)`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_queries_project_query ON queries(project_id, query)`,
       `CREATE UNIQUE INDEX IF NOT EXISTS idx_competitors_project_domain ON competitors(project_id, domain)`,
       `CREATE UNIQUE INDEX IF NOT EXISTS idx_schedules_project ON schedules(project_id)`,
       `CREATE UNIQUE INDEX IF NOT EXISTS idx_usage_scope_period_metric ON usage_counters(scope, period, metric)`,
@@ -1020,7 +1020,7 @@ var MIGRATION_VERSIONS = [
         type            TEXT NOT NULL,
         severity        TEXT NOT NULL,
         title           TEXT NOT NULL,
-        keyword         TEXT NOT NULL,
+        query           TEXT NOT NULL,
         provider        TEXT NOT NULL,
         recommendation  TEXT,
         cause           TEXT,
@@ -1029,7 +1029,7 @@ var MIGRATION_VERSIONS = [
       )`,
       `CREATE INDEX IF NOT EXISTS idx_insights_project ON insights(project_id)`,
       `CREATE INDEX IF NOT EXISTS idx_insights_created ON insights(created_at)`,
-      `CREATE INDEX IF NOT EXISTS idx_insights_keyword_provider ON insights(keyword, provider)`
+      `CREATE INDEX IF NOT EXISTS idx_insights_query_provider ON insights(query, provider)`
     ]
   },
   {
@@ -1373,6 +1373,26 @@ var MIGRATION_VERSIONS = [
       `CREATE INDEX IF NOT EXISTS idx_ga_window_summary_run
          ON ga_traffic_window_summaries(sync_run_id)`
     ]
+  },
+  {
+    version: 48,
+    name: "rename-keywords-to-queries",
+    // The actual legacy rename runs before bootstrap SQL so existing DBs never
+    // see new-name indexes before their old columns have been renamed. This
+    // version records the schema cutover and lands the final index names.
+    statements: [
+      `DROP INDEX IF EXISTS idx_keywords_project`,
+      `DROP INDEX IF EXISTS idx_keywords_project_keyword`,
+      `DROP INDEX IF EXISTS idx_snapshots_keyword`,
+      `DROP INDEX IF EXISTS idx_insights_keyword_provider`,
+      `CREATE INDEX IF NOT EXISTS idx_queries_project ON queries(project_id)`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_queries_project_query ON queries(project_id, query)`,
+      `CREATE INDEX IF NOT EXISTS idx_snapshots_query ON query_snapshots(query_id)`,
+      `CREATE INDEX IF NOT EXISTS idx_insights_query_provider ON insights(query, provider)`
+    ],
+    run: (tx) => {
+      normalizeLegacyQuerySchema(tx);
+    }
   }
 ];
 function isDuplicateColumnError(err) {
@@ -1387,6 +1407,44 @@ function columnExists(db, table, column) {
   ));
   return (rows[0]?.c ?? 0) > 0;
 }
+function tableExists(db, table) {
+  const rows = db.all(sql.raw(
+    `SELECT COUNT(*) as c FROM sqlite_master WHERE type = 'table' AND name = '${table}'`
+  ));
+  return (rows[0]?.c ?? 0) > 0;
+}
+function tableIsEmpty(db, table) {
+  const rows = db.all(sql.raw(`SELECT COUNT(*) as c FROM ${table}`));
+  return (rows[0]?.c ?? 0) === 0;
+}
+function hasLegacyQuerySchema(db) {
+  return tableExists(db, "keywords") || columnExists(db, "query_snapshots", "keyword_id") || columnExists(db, "insights", "keyword");
+}
+function normalizeLegacyQuerySchema(db) {
+  if (!hasLegacyQuerySchema(db)) return;
+  if (tableExists(db, "keywords") && tableExists(db, "queries")) {
+    if (!tableIsEmpty(db, "queries")) {
+      throw new Error("Cannot migrate keywords to queries because both tables contain data");
+    }
+    db.run(sql.raw(`DROP TABLE queries`));
+  }
+  db.run(sql.raw(`DROP INDEX IF EXISTS idx_keywords_project`));
+  db.run(sql.raw(`DROP INDEX IF EXISTS idx_keywords_project_keyword`));
+  db.run(sql.raw(`DROP INDEX IF EXISTS idx_snapshots_keyword`));
+  db.run(sql.raw(`DROP INDEX IF EXISTS idx_insights_keyword_provider`));
+  if (tableExists(db, "keywords")) {
+    db.run(sql.raw(`ALTER TABLE keywords RENAME TO queries`));
+  }
+  if (columnExists(db, "queries", "keyword")) {
+    db.run(sql.raw(`ALTER TABLE queries RENAME COLUMN keyword TO query`));
+  }
+  if (columnExists(db, "query_snapshots", "keyword_id")) {
+    db.run(sql.raw(`ALTER TABLE query_snapshots RENAME COLUMN keyword_id TO query_id`));
+  }
+  if (columnExists(db, "insights", "keyword")) {
+    db.run(sql.raw(`ALTER TABLE insights RENAME COLUMN keyword TO query`));
+  }
+}
 function dropColumnIfExists(db, table, column) {
   try {
     db.run(sql.raw(`ALTER TABLE ${table} DROP COLUMN ${column}`));
@@ -1466,6 +1524,9 @@ function recordMigration(db, version, name) {
   db.run(sql`INSERT OR IGNORE INTO _migrations (version, name) VALUES (${version}, ${name})`);
 }
 function migrate(db) {
+  db.transaction((tx) => {
+    normalizeLegacyQuerySchema(tx);
+  });
   const statements = MIGRATION_SQL.split(";").map((s) => s.trim()).filter((s) => s.length > 0);
   for (const statement of statements) {
     db.run(sql.raw(statement));
@@ -1482,6 +1543,7 @@ function migrate(db) {
           throw err;
         }
       }
+      mv.run?.(tx);
       recordMigration(tx, mv.version, mv.name);
     });
   }
@@ -1493,18 +1555,18 @@ function detectRegressions(currentRun, previousRun) {
   const previousCited = /* @__PURE__ */ new Map();
   for (const snap of previousRun.snapshots) {
     if (snap.cited) {
-      previousCited.set(`${snap.keyword}:${snap.provider}`, {
+      previousCited.set(`${snap.query}:${snap.provider}`, {
         citationUrl: snap.citationUrl,
         position: snap.position
       });
     }
   }
   for (const snap of currentRun.snapshots) {
-    const key = `${snap.keyword}:${snap.provider}`;
+    const key = `${snap.query}:${snap.provider}`;
     if (!snap.cited && previousCited.has(key)) {
       const prev = previousCited.get(key);
       regressions.push({
-        keyword: snap.keyword,
+        query: snap.query,
         provider: snap.provider,
         previousCitationUrl: prev.citationUrl,
         previousPosition: prev.position,
@@ -1522,14 +1584,14 @@ function detectGains(currentRun, previousRun) {
   const previousCited = /* @__PURE__ */ new Set();
   for (const snap of previousRun.snapshots) {
     if (snap.cited) {
-      previousCited.add(`${snap.keyword}:${snap.provider}`);
+      previousCited.add(`${snap.query}:${snap.provider}`);
     }
   }
   for (const snap of currentRun.snapshots) {
-    const key = `${snap.keyword}:${snap.provider}`;
+    const key = `${snap.query}:${snap.provider}`;
     if (snap.cited && !previousCited.has(key)) {
       gains.push({
-        keyword: snap.keyword,
+        query: snap.query,
         provider: snap.provider,
         citationUrl: snap.citationUrl,
         position: snap.position,
@@ -1588,18 +1650,18 @@ function computeHealthTrend(runs2) {
 // ../intelligence/src/causes.ts
 function analyzeCause(regression, currentSnapshots) {
   const currentSnap = currentSnapshots.find(
-    (s) => s.keyword === regression.keyword && s.provider === regression.provider && !s.cited && s.competitorDomain
+    (s) => s.query === regression.query && s.provider === regression.provider && !s.cited && s.competitorDomain
   );
   if (currentSnap) {
     return {
       cause: "competitor_gain",
       competitorDomain: currentSnap.competitorDomain,
-      details: `Competitor ${currentSnap.competitorDomain} now cited for "${regression.keyword}" on ${regression.provider}`
+      details: `Competitor ${currentSnap.competitorDomain} now cited for "${regression.query}" on ${regression.provider}`
     };
   }
   return {
     cause: "unknown",
-    details: `No specific cause identified for loss of "${regression.keyword}" on ${regression.provider}`
+    details: `No specific cause identified for loss of "${regression.query}" on ${regression.provider}`
   };
 }
 
@@ -1609,14 +1671,14 @@ function generateInsights(regressions, gains, health, causes) {
   const insights2 = [];
   const now = (/* @__PURE__ */ new Date()).toISOString();
   for (const reg of regressions) {
-    const key = `${reg.keyword}:${reg.provider}`;
+    const key = `${reg.query}:${reg.provider}`;
     const cause = causes.get(key);
     insights2.push({
       id: `ins_${randomUUID().slice(0, 8)}`,
       type: "regression",
       severity: "high",
-      title: `Lost ${reg.provider} citation for "${reg.keyword}"`,
-      keyword: reg.keyword,
+      title: `Lost ${reg.provider} citation for "${reg.query}"`,
+      query: reg.query,
       provider: reg.provider,
       recommendation: {
         action: "audit",
@@ -1632,8 +1694,8 @@ function generateInsights(regressions, gains, health, causes) {
       id: `ins_${randomUUID().slice(0, 8)}`,
       type: "gain",
       severity: "low",
-      title: `New ${gain.provider} citation for "${gain.keyword}"`,
-      keyword: gain.keyword,
+      title: `New ${gain.provider} citation for "${gain.query}"`,
+      query: gain.query,
       provider: gain.provider,
       recommendation: {
         action: "monitor",
@@ -1655,7 +1717,7 @@ function analyzeRuns(currentRun, previousRun, allRuns) {
   const causes = /* @__PURE__ */ new Map();
   for (const reg of regressions) {
     const cause = analyzeCause(reg, currentRun.snapshots);
-    causes.set(`${reg.keyword}:${reg.provider}`, cause);
+    causes.set(`${reg.query}:${reg.provider}`, cause);
   }
   const insights2 = generateInsights(regressions, gains, health, causes);
   return {
@@ -2027,7 +2089,7 @@ function classifyRegressionSeverity(signals) {
 }
 
 // ../intelligence/src/insight-grouping.ts
-function groupInsights(insights2, keyFn = (i) => `${i.keyword} ${i.provider} ${i.type}`) {
+function groupInsights(insights2, keyFn = (i) => `${i.query} ${i.provider} ${i.type}`) {
   const order = [];
   const buckets = /* @__PURE__ */ new Map();
   for (const i of insights2) {
@@ -2254,10 +2316,10 @@ var IntelligenceService = class {
   }
   persistResult(result, runId, projectId) {
     const previouslyDismissed = /* @__PURE__ */ new Set();
-    const existingInsights = this.db.select({ keyword: insights.keyword, provider: insights.provider, type: insights.type, dismissed: insights.dismissed }).from(insights).where(eq(insights.runId, runId)).all();
+    const existingInsights = this.db.select({ query: insights.query, provider: insights.provider, type: insights.type, dismissed: insights.dismissed }).from(insights).where(eq(insights.runId, runId)).all();
     for (const row of existingInsights) {
       if (row.dismissed) {
-        previouslyDismissed.add(`${row.keyword}:${row.provider}:${row.type}`);
+        previouslyDismissed.add(`${row.query}:${row.provider}:${row.type}`);
       }
     }
     this.db.transaction((tx) => {
@@ -2265,7 +2327,7 @@ var IntelligenceService = class {
       tx.delete(healthSnapshots).where(eq(healthSnapshots.runId, runId)).run();
       const now = (/* @__PURE__ */ new Date()).toISOString();
       for (const insight of result.insights) {
-        const wasDismissed = previouslyDismissed.has(`${insight.keyword}:${insight.provider}:${insight.type}`);
+        const wasDismissed = previouslyDismissed.has(`${insight.query}:${insight.provider}:${insight.type}`);
         tx.insert(insights).values({
           id: insight.id,
           projectId,
@@ -2273,7 +2335,7 @@ var IntelligenceService = class {
           type: insight.type,
           severity: insight.severity,
           title: insight.title,
-          keyword: insight.keyword,
+          query: insight.query,
           provider: insight.provider,
           recommendation: insight.recommendation ? JSON.stringify(insight.recommendation) : null,
           cause: insight.cause ? JSON.stringify(insight.cause) : null,
@@ -2315,10 +2377,10 @@ var IntelligenceService = class {
     if (regressions.length === 0) return rawInsights;
     const gscRows = this.db.select({ query: gscSearchData.query, impressions: gscSearchData.impressions }).from(gscSearchData).where(eq(gscSearchData.projectId, projectId)).all();
     const gscConnected = gscRows.length > 0;
-    const gscImpressionsByKeyword = /* @__PURE__ */ new Map();
+    const gscImpressionsByQuery = /* @__PURE__ */ new Map();
     for (const row of gscRows) {
       const key = row.query.toLowerCase();
-      gscImpressionsByKeyword.set(key, (gscImpressionsByKeyword.get(key) ?? 0) + row.impressions);
+      gscImpressionsByQuery.set(key, (gscImpressionsByQuery.get(key) ?? 0) + row.impressions);
     }
     const recentRunIds = this.db.select({ id: runs.id }).from(runs).where(
       and(
@@ -2330,16 +2392,16 @@ var IntelligenceService = class {
     const haveHistory = recentRunIds.length > 0;
     const priorRegressionsByPair = /* @__PURE__ */ new Map();
     if (haveHistory) {
-      const priorRows = this.db.select({ keyword: insights.keyword, provider: insights.provider }).from(insights).where(and(eq(insights.type, "regression"), inArray(insights.runId, recentRunIds))).all();
+      const priorRows = this.db.select({ query: insights.query, provider: insights.provider }).from(insights).where(and(eq(insights.type, "regression"), inArray(insights.runId, recentRunIds))).all();
       for (const row of priorRows) {
-        const key = `${row.keyword}:${row.provider}`;
+        const key = `${row.query}:${row.provider}`;
         priorRegressionsByPair.set(key, (priorRegressionsByPair.get(key) ?? 0) + 1);
       }
     }
     return rawInsights.map((insight) => {
       if (insight.type !== "regression") return insight;
-      const gscImpressions = gscConnected ? gscImpressionsByKeyword.get(insight.keyword.toLowerCase()) ?? 0 : void 0;
-      const recurrenceCount = haveHistory ? priorRegressionsByPair.get(`${insight.keyword}:${insight.provider}`) ?? 0 : void 0;
+      const gscImpressions = gscConnected ? gscImpressionsByQuery.get(insight.query.toLowerCase()) ?? 0 : void 0;
+      const recurrenceCount = haveHistory ? priorRegressionsByPair.get(`${insight.query}:${insight.provider}`) ?? 0 : void 0;
       const severity = classifyRegressionSeverity({
         gscImpressions,
         recurrenceCount
@@ -2349,17 +2411,17 @@ var IntelligenceService = class {
   }
   buildRunData(runId, projectId, completedAt) {
     const rows = this.db.select({
-      keyword: keywords.keyword,
+      query: queries.query,
       provider: querySnapshots.provider,
       citationState: querySnapshots.citationState,
       citedDomains: querySnapshots.citedDomains,
       competitorOverlap: querySnapshots.competitorOverlap
-    }).from(querySnapshots).leftJoin(keywords, eq(querySnapshots.keywordId, keywords.id)).where(eq(querySnapshots.runId, runId)).all();
+    }).from(querySnapshots).leftJoin(queries, eq(querySnapshots.queryId, queries.id)).where(eq(querySnapshots.runId, runId)).all();
     const snapshots = rows.map((r) => {
       const domains = parseJsonColumn(r.citedDomains, []);
       const competitors2 = parseJsonColumn(r.competitorOverlap, []);
       return {
-        keyword: r.keyword ?? "",
+        query: r.query ?? "",
         provider: r.provider,
         cited: r.citationState === "cited",
         citationUrl: domains[0] ?? void 0,
@@ -2372,7 +2434,7 @@ var IntelligenceService = class {
 
 export {
   projects,
-  keywords,
+  queries,
   competitors,
   runs,
   querySnapshots,