@ainyc/canonry 3.6.4 → 4.1.3

package/dist/{chunk-GP2P2WPS.js → chunk-AXMSAMKN.js}

@@ -1,8 +1,9 @@
 import {
+  CitationStates,
   ContentActions,
   RunKinds,
   __export
-} from "./chunk-O7EVT3AF.js";
+} from "./chunk-O5JZQUPX.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";
@@ -40,10 +41,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 +70,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 +106,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 +121,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 +429,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 +439,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 +581,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 +612,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 +654,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 +976,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 +1021,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 +1030,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 +1374,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 +1408,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 +1525,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 +1544,7 @@ function migrate(db) {
           throw err;
         }
       }
+      mv.run?.(tx);
       recordMigration(tx, mv.version, mv.name);
     });
   }
@@ -1493,18 +1556,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 +1585,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 +1651,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 +1672,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 +1695,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 +1718,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 +2090,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 +2317,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 +2328,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 +2336,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 +2378,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 +2393,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,19 +2412,19 @@ 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",
+        cited: r.citationState === CitationStates.cited,
         citationUrl: domains[0] ?? void 0,
         competitorDomain: competitors2[0] ?? void 0
       };
@@ -2372,7 +2435,7 @@ var IntelligenceService = class {
 
 export {
   projects,
-  keywords,
+  queries,
   competitors,
   runs,
   querySnapshots,