@ainyc/canonry 4.34.0 → 4.36.0

package/dist/cli.js

@@ -1,26 +1,27 @@
 #!/usr/bin/env node --import tsx
 import {
+  backfillAiReferralPaths,
+  backfillAiReferralPathsCommand,
+  backfillAnswerMentionsCommand,
+  backfillAnswerVisibilityCommand,
+  backfillInsightsCommand,
+  backfillNormalizedPaths,
+  backfillNormalizedPathsCommand,
+  checkLatestVersionForCli,
   coerceAgentProvider,
-  computeCompetitorOverlap,
   createServer,
   detectAndTrackUpgrade,
-  determineCitationState,
-  extractRecommendedCompetitors,
   formatAuditFactorScore,
   getOrCreateAnonymousId,
   isFirstRun,
   isTelemetryEnabled,
   listAgentProviders,
   renderReportHtml,
-  reparseStoredResult,
-  reparseStoredResult2,
-  reparseStoredResult3,
-  reparseStoredResult4,
   setGoogleAuthConfig,
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-7AF6B3L6.js";
+} from "./chunk-F2G67CIU.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -36,42 +37,33 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-5EBN7736.js";
+} from "./chunk-O7S623DL.js";
 import {
   apiKeys,
-  competitors,
   createClient,
-  gaAiReferrals,
-  gaTrafficSnapshots,
   migrate,
-  parseJsonColumn,
   projects,
-  queries,
-  querySnapshots,
-  runs
-} from "./chunk-7256SFYT.js";
+  queries
+} from "./chunk-JQQXMCQ7.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
   CheckStatuses,
   CitationStates,
   CodingAgents,
-  ProviderNames,
-  RunKinds,
   RunStatuses,
   SkillsClients,
   TrafficEventKinds,
-  determineAnswerMentioned,
   discoveryBucketSchema,
   discoveryCompetitorTypeSchema,
   effectiveDomains,
   formatRunErrorOneLine,
-  normalizeUrlPath,
+  normalizeProjectAliases,
   notificationEventSchema,
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-XW3F5EEW.js";
+} from "./chunk-XJVYVURK.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -121,17 +113,11 @@ function matchesPath(args, path10) {
   if (args.length < path10.length) return false;
   return path10.every((segment, index) => args[index] === segment);
 }
-function withFormatOption(options) {
-  if (!options) {
-    return {
-      format: { type: "string" }
-    };
-  }
-  if ("format" in options) return options;
-  return {
-    ...options,
-    format: { type: "string" }
-  };
+function withGlobalOptions(options) {
+  const base = options ? { ...options } : {};
+  if (!("format" in base)) base.format = { type: "string" };
+  if (!("dry-run" in base)) base["dry-run"] = { type: "boolean" };
+  return base;
 }
 function toFormat(value, fallbackFormat) {
   return value === "json" ? "json" : fallbackFormat;
@@ -187,7 +173,7 @@ Usage:  ${single.usage}
   try {
     const parsed = parseArgs({
       args: remainingArgs,
-      options: withFormatOption(spec.options),
+      options: withGlobalOptions(spec.options),
       allowPositionals: spec.allowPositionals ?? true
     });
     values = parsed.values;
@@ -203,509 +189,25 @@ Usage: ${spec.usage}`, {
       }
     });
   }
+  const dryRunRequested = values["dry-run"] === true;
+  if (dryRunRequested && !spec.supportsDryRun) {
+    throw usageError(
+      `Command "${spec.path.join(" ")}" does not support --dry-run. Either drop the flag, or run a different command that supports preview mode (e.g. \`canonry doctor\` for health checks, \`canonry status <project>\` for read-only state).`,
+      {
+        message: `Command "${spec.path.join(" ")}" does not support --dry-run`,
+        details: { command: commandId(spec), usage: spec.usage }
+      }
+    );
+  }
   await spec.run({
     positionals,
     values,
-    format: toFormat(values.format, fallbackFormat)
+    format: toFormat(values.format, fallbackFormat),
+    dryRun: dryRunRequested
   });
   return true;
 }
 
-// src/commands/backfill.ts
-import { and, eq, inArray } from "drizzle-orm";
-var SNAPSHOT_BATCH_SIZE = 500;
-async function backfillAnswerVisibilityCommand(opts) {
-  const config = loadConfig();
-  const db = createClient(config.database);
-  migrate(db);
-  const projectFilter = opts?.project?.trim();
-  const scopedProjects = projectFilter ? db.select().from(projects).where(eq(projects.name, projectFilter)).all() : db.select().from(projects).all();
-  let examined = 0;
-  let updated = 0;
-  let mentioned = 0;
-  let reparsed = 0;
-  let providerErrors = 0;
-  if (scopedProjects.length > 0) {
-    const runRows = projectFilter ? db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(and(
-      eq(runs.kind, RunKinds["answer-visibility"]),
-      inArray(runs.projectId, scopedProjects.map((project) => project.id))
-    )).all() : db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(eq(runs.kind, RunKinds["answer-visibility"])).all();
-    const runIdsByProject = /* @__PURE__ */ new Map();
-    for (const run of runRows) {
-      const existing = runIdsByProject.get(run.projectId);
-      if (existing) existing.push(run.id);
-      else runIdsByProject.set(run.projectId, [run.id]);
-    }
-    for (const project of scopedProjects) {
-      const competitorDomains = db.select({ domain: competitors.domain }).from(competitors).where(eq(competitors.projectId, project.id)).all().map((row) => row.domain);
-      const runIds = runIdsByProject.get(project.id) ?? [];
-      if (runIds.length === 0) continue;
-      const projectDomains = effectiveDomains({
-        canonicalDomain: project.canonicalDomain,
-        ownedDomains: parseJsonColumn(project.ownedDomains, [])
-      });
-      for (let offset = 0; offset < runIds.length; offset += SNAPSHOT_BATCH_SIZE) {
-        const batchRunIds = runIds.slice(offset, offset + SNAPSHOT_BATCH_SIZE);
-        const snapshotRows = db.select({
-          id: querySnapshots.id,
-          provider: querySnapshots.provider,
-          citationState: querySnapshots.citationState,
-          answerMentioned: querySnapshots.answerMentioned,
-          answerText: querySnapshots.answerText,
-          citedDomains: querySnapshots.citedDomains,
-          competitorOverlap: querySnapshots.competitorOverlap,
-          recommendedCompetitors: querySnapshots.recommendedCompetitors,
-          rawResponse: querySnapshots.rawResponse
-        }).from(querySnapshots).where(inArray(querySnapshots.runId, batchRunIds)).all();
-        const pendingUpdates = [];
-        for (const snapshot of snapshotRows) {
-          examined++;
-          const reparsedResult = reparseProviderSnapshot(snapshot.provider, snapshot.rawResponse);
-          if (reparsedResult) reparsed++;
-          if (reparsedResult?.providerError) providerErrors++;
-          const answerText = reparsedResult?.answerText ?? snapshot.answerText ?? "";
-          const nextValue = determineAnswerMentioned(answerText, project.displayName, projectDomains);
-          if (nextValue) mentioned++;
-          const nextPatch = {};
-          if (snapshot.answerMentioned !== nextValue) {
-            nextPatch.answerMentioned = nextValue;
-          }
-          if ((snapshot.answerText ?? "") !== answerText) {
-            nextPatch.answerText = answerText;
-          }
-          if (reparsedResult) {
-            const normalized = {
-              provider: snapshot.provider,
-              answerText,
-              citedDomains: reparsedResult.citedDomains,
-              groundingSources: reparsedResult.groundingSources,
-              searchQueries: reparsedResult.searchQueries
-            };
-            const nextCitationState = determineCitationState(normalized, projectDomains);
-            const nextCitedDomains = JSON.stringify(reparsedResult.citedDomains);
-            const nextCompetitorOverlap = JSON.stringify(
-              computeCompetitorOverlap(normalized, competitorDomains)
-            );
-            const nextRecommendedCompetitors = JSON.stringify(
-              extractRecommendedCompetitors(
-                normalized.answerText,
-                projectDomains,
-                normalized.citedDomains,
-                competitorDomains
-              )
-            );
-            const nextRawResponse = stringifyStoredSnapshotEnvelope(
-              snapshot.rawResponse,
-              reparsedResult
-            );
-            if (snapshot.citationState !== nextCitationState) {
-              nextPatch.citationState = nextCitationState;
-            }
-            if (snapshot.citedDomains !== nextCitedDomains) {
-              nextPatch.citedDomains = nextCitedDomains;
-            }
-            if (snapshot.competitorOverlap !== nextCompetitorOverlap) {
-              nextPatch.competitorOverlap = nextCompetitorOverlap;
-            }
-            if (snapshot.recommendedCompetitors !== nextRecommendedCompetitors) {
-              nextPatch.recommendedCompetitors = nextRecommendedCompetitors;
-            }
-            if (snapshot.rawResponse !== nextRawResponse) {
-              nextPatch.rawResponse = nextRawResponse;
-            }
-          }
-          if (Object.keys(nextPatch).length > 0) {
-            pendingUpdates.push({ id: snapshot.id, patch: nextPatch });
-          }
-        }
-        if (pendingUpdates.length > 0) {
-          db.transaction((tx) => {
-            for (const update of pendingUpdates) {
-              tx.update(querySnapshots).set(update.patch).where(eq(querySnapshots.id, update.id)).run();
-            }
-          });
-          updated += pendingUpdates.length;
-        }
-      }
-    }
-  }
-  const result = {
-    project: projectFilter ?? null,
-    projects: scopedProjects.length,
-    examined,
-    updated,
-    mentioned,
-    reparsed,
-    providerErrors
-  };
-  if (opts?.format === "json") {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-  console.log("Answer visibility backfill complete.\n");
-  if (projectFilter) {
-    console.log(`  Project:  ${projectFilter}`);
-  }
-  console.log(`  Projects: ${scopedProjects.length}`);
-  console.log(`  Examined:  ${examined}`);
-  console.log(`  Updated:   ${updated}`);
-  console.log(`  Mentioned: ${mentioned}`);
-  console.log(`  Reparsed:  ${reparsed}`);
-  console.log(`  Errors:    ${providerErrors}`);
-}
-function backfillNormalizedPaths(db, opts) {
-  const baseConditions = [];
-  if (opts?.projectId) {
-    baseConditions.push(eq(gaTrafficSnapshots.projectId, opts.projectId));
-  }
-  const rows = db.select({
-    id: gaTrafficSnapshots.id,
-    landingPage: gaTrafficSnapshots.landingPage,
-    landingPageNormalized: gaTrafficSnapshots.landingPageNormalized
-  }).from(gaTrafficSnapshots).where(baseConditions.length > 0 ? and(...baseConditions) : void 0).all();
-  let updated = 0;
-  let unchanged = 0;
-  if (rows.length > 0) {
-    db.transaction((tx) => {
-      for (const row of rows) {
-        const next = normalizeUrlPath(row.landingPage);
-        if (next === null) {
-          unchanged++;
-          continue;
-        }
-        if (row.landingPageNormalized === next) {
-          unchanged++;
-          continue;
-        }
-        tx.update(gaTrafficSnapshots).set({ landingPageNormalized: next }).where(eq(gaTrafficSnapshots.id, row.id)).run();
-        updated++;
-      }
-    });
-  }
-  return { examined: rows.length, updated, unchanged };
-}
-async function backfillNormalizedPathsCommand(opts) {
-  const config = loadConfig();
-  const db = createClient(config.database);
-  migrate(db);
-  const projectFilter = opts?.project?.trim();
-  let projectId;
-  if (projectFilter) {
-    const project = db.select({ id: projects.id }).from(projects).where(eq(projects.name, projectFilter)).get();
-    if (!project) {
-      const result2 = {
-        project: projectFilter,
-        examined: 0,
-        updated: 0,
-        unchanged: 0
-      };
-      if (opts?.format === "json") {
-        console.log(JSON.stringify(result2, null, 2));
-        return;
-      }
-      console.log(`Backfill normalized-paths: project "${projectFilter}" not found.`);
-      return;
-    }
-    projectId = project.id;
-  }
-  const { examined, updated, unchanged } = backfillNormalizedPaths(db, { projectId });
-  const result = {
-    project: projectFilter ?? null,
-    examined,
-    updated,
-    unchanged
-  };
-  if (opts?.format === "json") {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-  console.log("Normalized-path backfill complete.\n");
-  if (projectFilter) console.log(`  Project:   ${projectFilter}`);
-  console.log(`  Examined:  ${examined}`);
-  console.log(`  Updated:   ${updated}`);
-  console.log(`  Unchanged: ${unchanged}`);
-}
-function backfillAiReferralPaths(db, opts) {
-  const baseConditions = [];
-  if (opts?.projectId) {
-    baseConditions.push(eq(gaAiReferrals.projectId, opts.projectId));
-  }
-  const rows = db.select({
-    id: gaAiReferrals.id,
-    landingPage: gaAiReferrals.landingPage,
-    landingPageNormalized: gaAiReferrals.landingPageNormalized
-  }).from(gaAiReferrals).where(baseConditions.length > 0 ? and(...baseConditions) : void 0).all();
-  let updated = 0;
-  let unchanged = 0;
-  if (rows.length > 0) {
-    db.transaction((tx) => {
-      for (const row of rows) {
-        const next = normalizeUrlPath(row.landingPage);
-        if (next === null) {
-          unchanged++;
-          continue;
-        }
-        if (row.landingPageNormalized === next) {
-          unchanged++;
-          continue;
-        }
-        tx.update(gaAiReferrals).set({ landingPageNormalized: next }).where(eq(gaAiReferrals.id, row.id)).run();
-        updated++;
-      }
-    });
-  }
-  return { examined: rows.length, updated, unchanged };
-}
-async function backfillAiReferralPathsCommand(opts) {
-  const config = loadConfig();
-  const db = createClient(config.database);
-  migrate(db);
-  const projectFilter = opts?.project?.trim();
-  let projectId;
-  if (projectFilter) {
-    const project = db.select({ id: projects.id }).from(projects).where(eq(projects.name, projectFilter)).get();
-    if (!project) {
-      const result2 = {
-        project: projectFilter,
-        examined: 0,
-        updated: 0,
-        unchanged: 0
-      };
-      if (opts?.format === "json") {
-        console.log(JSON.stringify(result2, null, 2));
-        return;
-      }
-      console.log(`Backfill ai-referral-paths: project "${projectFilter}" not found.`);
-      return;
-    }
-    projectId = project.id;
-  }
-  const { examined, updated, unchanged } = backfillAiReferralPaths(db, { projectId });
-  const result = {
-    project: projectFilter ?? null,
-    examined,
-    updated,
-    unchanged
-  };
-  if (opts?.format === "json") {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-  console.log("AI referral landing-page backfill complete.\n");
-  if (projectFilter) console.log(`  Project:   ${projectFilter}`);
-  console.log(`  Examined:  ${examined}`);
-  console.log(`  Updated:   ${updated}`);
-  console.log(`  Unchanged: ${unchanged}`);
-}
-async function backfillAnswerMentionsCommand(opts) {
-  const config = loadConfig();
-  const db = createClient(config.database);
-  migrate(db);
-  const projectFilter = opts?.project?.trim();
-  const scopedProjects = projectFilter ? db.select().from(projects).where(eq(projects.name, projectFilter)).all() : db.select().from(projects).all();
-  let examined = 0;
-  let updated = 0;
-  let mentioned = 0;
-  if (scopedProjects.length > 0) {
-    const runRows = projectFilter ? db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(and(
-      eq(runs.kind, RunKinds["answer-visibility"]),
-      inArray(runs.projectId, scopedProjects.map((project) => project.id))
-    )).all() : db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(eq(runs.kind, RunKinds["answer-visibility"])).all();
-    const runIdsByProject = /* @__PURE__ */ new Map();
-    for (const run of runRows) {
-      const existing = runIdsByProject.get(run.projectId);
-      if (existing) existing.push(run.id);
-      else runIdsByProject.set(run.projectId, [run.id]);
-    }
-    for (const project of scopedProjects) {
-      const competitorDomains = db.select({ domain: competitors.domain }).from(competitors).where(eq(competitors.projectId, project.id)).all().map((row) => row.domain);
-      const runIds = runIdsByProject.get(project.id) ?? [];
-      if (runIds.length === 0) continue;
-      const projectDomains = effectiveDomains({
-        canonicalDomain: project.canonicalDomain,
-        ownedDomains: parseJsonColumn(project.ownedDomains, [])
-      });
-      for (let offset = 0; offset < runIds.length; offset += SNAPSHOT_BATCH_SIZE) {
-        const batchRunIds = runIds.slice(offset, offset + SNAPSHOT_BATCH_SIZE);
-        const snapshotRows = db.select({
-          id: querySnapshots.id,
-          provider: querySnapshots.provider,
-          answerMentioned: querySnapshots.answerMentioned,
-          answerText: querySnapshots.answerText,
-          citedDomains: querySnapshots.citedDomains,
-          competitorOverlap: querySnapshots.competitorOverlap,
-          recommendedCompetitors: querySnapshots.recommendedCompetitors,
-          rawResponse: querySnapshots.rawResponse
-        }).from(querySnapshots).where(inArray(querySnapshots.runId, batchRunIds)).all();
-        const pendingUpdates = [];
-        for (const snapshot of snapshotRows) {
-          examined++;
-          const answerText = snapshot.answerText ?? "";
-          const nextAnswerMentioned = determineAnswerMentioned(answerText, project.displayName, projectDomains);
-          if (nextAnswerMentioned) mentioned++;
-          const citedDomains = parseJsonColumn(snapshot.citedDomains, []);
-          const groundingSources = readStoredGroundingSources(snapshot.rawResponse);
-          const normalized = {
-            provider: snapshot.provider,
-            answerText,
-            citedDomains,
-            groundingSources,
-            searchQueries: []
-          };
-          const nextCompetitorOverlap = JSON.stringify(
-            computeCompetitorOverlap(normalized, competitorDomains)
-          );
-          const nextRecommendedCompetitors = JSON.stringify(
-            extractRecommendedCompetitors(
-              answerText,
-              projectDomains,
-              citedDomains,
-              competitorDomains
-            )
-          );
-          const nextPatch = {};
-          if (snapshot.answerMentioned !== nextAnswerMentioned) {
-            nextPatch.answerMentioned = nextAnswerMentioned;
-          }
-          if (snapshot.competitorOverlap !== nextCompetitorOverlap) {
-            nextPatch.competitorOverlap = nextCompetitorOverlap;
-          }
-          if (snapshot.recommendedCompetitors !== nextRecommendedCompetitors) {
-            nextPatch.recommendedCompetitors = nextRecommendedCompetitors;
-          }
-          if (Object.keys(nextPatch).length > 0) {
-            pendingUpdates.push({ id: snapshot.id, patch: nextPatch });
-          }
-        }
-        if (pendingUpdates.length > 0) {
-          db.transaction((tx) => {
-            for (const update of pendingUpdates) {
-              tx.update(querySnapshots).set(update.patch).where(eq(querySnapshots.id, update.id)).run();
-            }
-          });
-          updated += pendingUpdates.length;
-        }
-      }
-    }
-  }
-  const result = {
-    project: projectFilter ?? null,
-    projects: scopedProjects.length,
-    examined,
-    updated,
-    mentioned
-  };
-  if (opts?.format === "json") {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-  console.log("Answer mentions backfill complete.\n");
-  if (projectFilter) console.log(`  Project:   ${projectFilter}`);
-  console.log(`  Projects:  ${scopedProjects.length}`);
-  console.log(`  Examined:  ${examined}`);
-  console.log(`  Updated:   ${updated}`);
-  console.log(`  Mentioned: ${mentioned}`);
-}
-function readStoredGroundingSources(rawResponse) {
-  const envelope = parseJsonColumn(rawResponse, {});
-  const sources = envelope.groundingSources;
-  if (!Array.isArray(sources)) return [];
-  const result = [];
-  for (const source of sources) {
-    if (source && typeof source === "object") {
-      const uri = source.uri;
-      const title = source.title;
-      if (typeof uri === "string") {
-        result.push({ uri, title: typeof title === "string" ? title : "" });
-      }
-    }
-  }
-  return result;
-}
-async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-3P2DMYRR.js");
-  const config = loadConfig();
-  const db = createClient(config.database);
-  migrate(db);
-  const service = new IntelligenceService(db);
-  const isJson = opts?.format === "json";
-  if (!isJson) {
-    process.stderr.write(`Backfilling insights for "${project}"...
-`);
-  }
-  const result = service.backfill(project, {
-    fromRunId: opts?.fromRun,
-    toRunId: opts?.toRun
-  }, (info) => {
-    if (!isJson) {
-      process.stderr.write(`  [${info.index}/${info.total}] ${info.runId} \u2014 ${info.insights} insights
-`);
-    }
-  });
-  const output = {
-    project,
-    processed: result.processed,
-    skipped: result.skipped,
-    totalInsights: result.totalInsights
-  };
-  if (isJson) {
-    console.log(JSON.stringify(output, null, 2));
-    return;
-  }
-  console.log(`
-Backfill complete.`);
-  console.log(`  Processed: ${result.processed}`);
-  console.log(`  Skipped:   ${result.skipped}`);
-  console.log(`  Insights:  ${result.totalInsights}`);
-}
-function reparseProviderSnapshot(provider, rawResponse) {
-  const envelope = parseJsonColumn(rawResponse, {});
-  const apiResponse = resolveStoredApiResponse(envelope);
-  if (!apiResponse) return null;
-  switch (provider) {
-    case ProviderNames.openai:
-      return reparseStoredResult(apiResponse);
-    case ProviderNames.claude:
-      return reparseStoredResult2(apiResponse);
-    case ProviderNames.gemini:
-      return reparseStoredResult3(apiResponse);
-    case ProviderNames.perplexity:
-      return reparseStoredResult4(apiResponse);
-    default:
-      return null;
-  }
-}
-function resolveStoredApiResponse(parsed) {
-  const nested = parsed.apiResponse;
-  if (nested !== null && typeof nested === "object" && !Array.isArray(nested)) {
-    return nested;
-  }
-  if (looksLikeProviderApiResponse(parsed)) {
-    return parsed;
-  }
-  return null;
-}
-function looksLikeProviderApiResponse(value) {
-  return Array.isArray(value.output) || Array.isArray(value.content) || Array.isArray(value.candidates) || Array.isArray(value.choices);
-}
-function stringifyStoredSnapshotEnvelope(rawResponse, reparsed) {
-  const parsed = parseJsonColumn(rawResponse, {});
-  const apiResponse = resolveStoredApiResponse(parsed);
-  const envelope = apiResponse === parsed ? {} : { ...parsed };
-  delete envelope.answerText;
-  delete envelope.citedDomains;
-  delete envelope.competitorOverlap;
-  delete envelope.recommendedCompetitors;
-  delete envelope.providerError;
-  return JSON.stringify({
-    ...envelope,
-    groundingSources: reparsed.groundingSources,
-    searchQueries: reparsed.searchQueries,
-    ...reparsed.providerError ? { providerError: reparsed.providerError } : {},
-    ...apiResponse ? { apiResponse } : {}
-  });
-}
-
 // src/cli-command-helpers.ts
 function getString(values, key) {
   const value = values[key];
@@ -818,17 +320,21 @@ var BACKFILL_CLI_COMMANDS = [
   },
   {
     path: ["backfill", "insights"],
-    usage: "canonry backfill insights <project> [--from-run <id>] [--to-run <id>] [--format json]",
+    usage: "canonry backfill insights <project> [--from-run <id>] [--to-run <id>] [--since <date>] [--dry-run] [--format json]",
     options: {
       "from-run": stringOption(),
-      "to-run": stringOption()
+      "to-run": stringOption(),
+      "since": stringOption()
     },
+    supportsDryRun: true,
     run: async (input) => {
-      const usage = "canonry backfill insights <project> [--from-run <id>] [--to-run <id>] [--format json]";
+      const usage = "canonry backfill insights <project> [--from-run <id>] [--to-run <id>] [--since <date>] [--dry-run] [--format json]";
       const project = requireProject(input, "backfill insights", usage);
       await backfillInsightsCommand(project, {
         fromRun: getString(input.values, "from-run"),
         toRun: getString(input.values, "to-run"),
+        since: getString(input.values, "since"),
+        dryRun: input.dryRun,
         format: input.format
       });
     }
@@ -1996,18 +1502,18 @@ function errorMessage(err) {
 async function discoverRun(project, opts) {
   const client = getClient4();
   const { angles, multiAngle } = resolveIcpAngles(opts);
-  const runs2 = [];
+  const runs = [];
   for (const angle of angles) {
     try {
       const start = await client.triggerDiscoveryRun(project, buildRunBody(opts, angle));
-      runs2.push({ angle, start });
+      runs.push({ angle, start });
     } catch (err) {
-      if (runs2.length > 0) {
+      if (runs.length > 0) {
         process.stderr.write(
           `
 Failed to start ${angle ? `angle "${angle}"` : "discovery run"}: ${errorMessage(err)}
 Sessions already started (recover with \`canonry discover show ${project} <id>\`):
-` + runs2.map((r) => `  ${r.start.sessionId}`).join("\n") + "\n"
+` + runs.map((r) => `  ${r.start.sessionId}`).join("\n") + "\n"
         );
       }
       throw err;
@@ -2015,10 +1521,10 @@ Sessions already started (recover with \`canonry discover show ${project} <id>\`
   }
   if (!opts.wait) {
     if (opts.format === "json") {
-      console.log(JSON.stringify(multiAngle ? runs2.map((r) => r.start) : runs2[0].start, null, 2));
+      console.log(JSON.stringify(multiAngle ? runs.map((r) => r.start) : runs[0].start, null, 2));
       return;
     }
-    for (const { angle, start } of runs2) {
+    for (const { angle, start } of runs) {
       if (angle) console.log(`[${angle}]`);
       if (start.consolidated) {
         console.log(`Reusing in-flight discovery session: ${start.sessionId}`);
@@ -2031,20 +1537,20 @@ Sessions already started (recover with \`canonry discover show ${project} <id>\`
         console.log(`  Status:  ${start.status}`);
         console.log(`  Tail:    canonry discover show ${project} ${start.sessionId}`);
       }
-      if (runs2.length > 1) console.log();
+      if (runs.length > 1) console.log();
     }
     return;
   }
-  const parallel = runs2.length > 1;
-  if (parallel) process.stderr.write(`Waiting for ${runs2.length} discovery sessions...
+  const parallel = runs.length > 1;
+  if (parallel) process.stderr.write(`Waiting for ${runs.length} discovery sessions...
 `);
   const settled = await Promise.allSettled(
-    runs2.map((r) => pollSession(client, project, r.start.sessionId, parallel))
+    runs.map((r) => pollSession(client, project, r.start.sessionId, parallel))
   );
   const results = [];
   const failures = [];
   settled.forEach((outcome, i) => {
-    const run = runs2[i];
+    const run = runs[i];
     if (outcome.status === "fulfilled") {
       results.push({ angle: run.angle, session: outcome.value });
     } else {
@@ -2084,7 +1590,7 @@ Sessions already started (recover with \`canonry discover show ${project} <id>\`
     }
     throw new CliError({
       code: "DISCOVERY_INCOMPLETE",
-      message: `${failures.length} of ${runs2.length} discovery session(s) did not complete`,
+      message: `${failures.length} of ${runs.length} discovery session(s) did not complete`,
       details: { failed: failures.map((f) => f.sessionId) }
     });
   }
@@ -6069,10 +5575,10 @@ Brand Gap Analysis`);
     console.log(`
   Opportunity Gaps (competitors cited, you're not):`);
     for (const q of data.gap) {
-      const competitors2 = q.competitorsCiting.join(", ");
+      const competitors = 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}`);
+      console.log(`      Competitors: ${competitors}`);
     }
   }
   if (data.cited.length > 0) {
@@ -6155,9 +5661,9 @@ async function loadLatestRunForExport(client, project) {
   } catch (err) {
     if (!isEndpointMissing(err)) throw err;
   }
-  const runs2 = await client.listRuns(project);
-  if (runs2.length === 0) return null;
-  const latestRun = runs2.reduce(
+  const runs = await client.listRuns(project);
+  if (runs.length === 0) return null;
+  const latestRun = runs.reduce(
     (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
   );
   return client.getRun(latestRun.id);
@@ -6211,14 +5717,14 @@ async function showStatus(project, format) {
   const projectData = await client.getProject(project);
   const latest = await getLatestRunSummary(client, project);
   if (format === "json") {
-    let runs2 = [];
+    let runs = [];
     try {
-      runs2 = await client.listRuns(project);
+      runs = await client.listRuns(project);
     } catch {
     }
     console.log(JSON.stringify({
       project: projectData,
-      runs: runs2,
+      runs,
       latestRun: latest.run,
       totalRuns: latest.totalRuns
     }, null, 2));
@@ -6249,15 +5755,15 @@ async function getLatestRunSummary(client, project) {
     return await client.getLatestRun(project);
   } catch (err) {
     if (!isEndpointMissing(err)) throw err;
-    const runs2 = await client.listRuns(project);
-    if (runs2.length === 0) {
+    const runs = await client.listRuns(project);
+    if (runs.length === 0) {
       return { totalRuns: 0, run: null };
     }
-    const latestRun = runs2.reduce(
+    const latestRun = runs.reduce(
       (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
     );
     return {
-      totalRuns: runs2.length,
+      totalRuns: runs.length,
       run: latestRun
     };
   }
@@ -6347,6 +5853,7 @@ async function createProject(name, opts) {
     displayName: opts.displayName,
     canonicalDomain: opts.domain,
     ownedDomains: opts.ownedDomains ?? [],
+    aliases: normalizeProjectAliases(opts.displayName, opts.aliases ?? []),
     country: opts.country,
     language: opts.language
   });
@@ -6400,6 +5907,9 @@ async function showProject(name, format) {
   if (secondaryDomains.length > 0) {
     console.log(`  Owned domains:    ${secondaryDomains.join(", ")}`);
   }
+  if (project.aliases && project.aliases.length > 0) {
+    console.log(`  Aliases:          ${project.aliases.join(", ")}`);
+  }
   console.log(`  Country:          ${project.country}`);
   console.log(`  Language:         ${project.language}`);
   console.log(`  Config source:    ${project.configSource}`);
@@ -6422,10 +5932,22 @@ async function updateProjectSettings(name, opts) {
     const toRemove = new Set(opts.removeOwnedDomain);
     ownedDomains = ownedDomains.filter((d) => !toRemove.has(d));
   }
+  const nextDisplayName = opts.displayName ?? project.displayName ?? project.name;
+  let aliases = opts.aliases ?? project.aliases ?? [];
+  if (opts.addAlias) {
+    const existingKeys = new Set(aliases.map((a) => a.toLowerCase()));
+    const toAdd = opts.addAlias.filter((a) => !existingKeys.has(a.toLowerCase()));
+    aliases = [...aliases, ...toAdd];
+  }
+  if (opts.removeAlias) {
+    const toRemove = new Set(opts.removeAlias.map((a) => a.toLowerCase()));
+    aliases = aliases.filter((a) => !toRemove.has(a.toLowerCase()));
+  }
   const result = await client.putProject(name, {
-    displayName: opts.displayName ?? project.displayName ?? project.name,
+    displayName: nextDisplayName,
     canonicalDomain: opts.domain ?? project.canonicalDomain,
     ownedDomains,
+    aliases: normalizeProjectAliases(nextDisplayName, aliases),
     country: opts.country ?? project.country,
     language: opts.language ?? project.language
   });
@@ -6435,10 +5957,31 @@ async function updateProjectSettings(name, opts) {
   }
   console.log(`Project updated: ${result.name}`);
 }
-async function deleteProject(name, format) {
+async function deleteProject(name, opts) {
   const client = getClient16();
+  const isJson = opts?.format === "json";
+  if (opts?.dryRun) {
+    const preview = await client.previewProjectDelete(name);
+    if (isJson) {
+      console.log(JSON.stringify({ dryRun: true, ...preview }, null, 2));
+      return;
+    }
+    const { cascadeRows: cr, detachedRows: dr } = preview;
+    console.log(`Project delete preview for "${name}":`);
+    console.log(`  Cascade-deletes:`);
+    console.log(`    queries:      ${cr.queries}`);
+    console.log(`    competitors:  ${cr.competitors}`);
+    console.log(`    runs:         ${cr.runs}`);
+    console.log(`    snapshots:    ${cr.snapshots}`);
+    console.log(`    insights:     ${cr.insights}`);
+    console.log(`  Detached (project_id set to NULL):`);
+    console.log(`    audit_log:    ${dr.auditLog}`);
+    console.log(``);
+    console.log(`No DB writes performed. Re-run without --dry-run to delete.`);
+    return;
+  }
   await client.deleteProject(name);
-  if (format === "json") {
+  if (isJson) {
     console.log(JSON.stringify({ name, deleted: true }, null, 2));
     return;
   }
@@ -6508,10 +6051,11 @@ async function setDefaultLocation(project, label, format) {
 var PROJECT_CLI_COMMANDS = [
   {
     path: ["project", "create"],
-    usage: "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--country <code>] [--language <lang>] [--display-name <name>] [--format json]",
+    usage: "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--format json]",
     options: {
       domain: { type: "string", short: "d" },
       "owned-domain": multiStringOption(),
+      alias: multiStringOption(),
       country: stringOption(),
       language: stringOption(),
       "display-name": stringOption()
@@ -6520,11 +6064,12 @@ var PROJECT_CLI_COMMANDS = [
       const name = requireProject(
         input,
         "project.create",
-        "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--country <code>] [--language <lang>] [--display-name <name>] [--format json]"
+        "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--format json]"
       );
       await createProject(name, {
         domain: getString(input.values, "domain") ?? name,
         ownedDomains: getStringArray(input.values, "owned-domain") ?? [],
+        aliases: getStringArray(input.values, "alias") ?? [],
         country: getString(input.values, "country") ?? "US",
         language: getString(input.values, "language") ?? "en",
         displayName: getString(input.values, "display-name") ?? name,
@@ -6534,12 +6079,15 @@ var PROJECT_CLI_COMMANDS = [
   },
   {
     path: ["project", "update"],
-    usage: "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--country <code>] [--language <lang>] [--display-name <name>] [--format json]",
+    usage: "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--format json]",
     options: {
       domain: { type: "string", short: "d" },
       "owned-domain": multiStringOption(),
       "add-domain": multiStringOption(),
       "remove-domain": multiStringOption(),
+      alias: multiStringOption(),
+      "add-alias": multiStringOption(),
+      "remove-alias": multiStringOption(),
       country: stringOption(),
       language: stringOption(),
       "display-name": stringOption()
@@ -6548,7 +6096,7 @@ var PROJECT_CLI_COMMANDS = [
       const name = requireProject(
         input,
         "project.update",
-        "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--country <code>] [--language <lang>] [--display-name <name>] [--format json]"
+        "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--format json]"
       );
       await updateProjectSettings(name, {
         displayName: getString(input.values, "display-name"),
@@ -6556,6 +6104,9 @@ var PROJECT_CLI_COMMANDS = [
         ownedDomains: getStringArray(input.values, "owned-domain"),
         addOwnedDomain: getStringArray(input.values, "add-domain"),
         removeOwnedDomain: getStringArray(input.values, "remove-domain"),
+        aliases: getStringArray(input.values, "alias"),
+        addAlias: getStringArray(input.values, "add-alias"),
+        removeAlias: getStringArray(input.values, "remove-alias"),
         country: getString(input.values, "country"),
         language: getString(input.values, "language"),
         format: input.format
@@ -6580,10 +6131,11 @@ var PROJECT_CLI_COMMANDS = [
   },
   {
     path: ["project", "delete"],
-    usage: "canonry project delete <name> [--format json]",
+    usage: "canonry project delete <name> [--dry-run] [--format json]",
+    supportsDryRun: true,
     run: async (input) => {
-      const name = requireProject(input, "project.delete", "canonry project delete <name> [--format json]");
-      await deleteProject(name, input.format);
+      const name = requireProject(input, "project.delete", "canonry project delete <name> [--dry-run] [--format json]");
+      await deleteProject(name, { dryRun: input.dryRun, format: input.format });
     }
   },
   {
@@ -6892,8 +6444,8 @@ async function cancelRun(project, runId, format) {
   const client = getClient17();
   let targetId = runId;
   if (!targetId) {
-    const runs2 = await client.listRuns(project);
-    const active = runs2.find((r) => r.status === "queued" || r.status === "running");
+    const runs = await client.listRuns(project);
+    const active = runs.find((r) => r.status === "queued" || r.status === "running");
     if (!active) {
       throw new CliError({
         code: "NO_ACTIVE_RUN",
@@ -6931,20 +6483,20 @@ async function showRun(id, format) {
 }
 async function listRuns(project, opts) {
   const client = getClient17();
-  const runs2 = await client.listRuns(project, opts?.limit);
+  const runs = await client.listRuns(project, opts?.limit);
   if (opts?.format === "json") {
-    console.log(JSON.stringify(runs2, null, 2));
+    console.log(JSON.stringify(runs, null, 2));
     return;
   }
-  if (runs2.length === 0) {
+  if (runs.length === 0) {
     console.log(`No runs found for "${project}".`);
     return;
   }
-  console.log(`Runs for "${project}" (${runs2.length}):
+  console.log(`Runs for "${project}" (${runs.length}):
 `);
   console.log("  ID                                    STATUS      KIND                TRIGGER    CREATED");
   console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-  for (const run of runs2) {
+  for (const run of runs) {
     console.log(
       `  ${run.id}  ${run.status.padEnd(10)}  ${run.kind.padEnd(18)}  ${run.trigger.padEnd(9)}  ${run.createdAt}`
     );
@@ -7465,6 +7017,7 @@ Usage: canonry settings provider ${name} --api-key <key> [--model <model>] [--ma
 
 // src/commands/skills.ts
 import fs7 from "fs";
+import os2 from "os";
 import path4 from "path";
 import { fileURLToPath } from "url";
 var BUNDLED_SKILL_NAMES = ["canonry", "aero"];
@@ -7641,7 +7194,7 @@ function buildSummaryMessage(results) {
   return `Skills install summary: ${parts.join(", ")}.`;
 }
 async function installSkills(opts = {}) {
-  const targetDir = path4.resolve(opts.dir ?? process.cwd());
+  const targetDir = opts.user ? os2.homedir() : path4.resolve(opts.dir ?? process.cwd());
   const client = opts.client ?? SkillsClients.all;
   const force = opts.force ?? false;
   const allSkills = getBundledSkills();
@@ -7727,9 +7280,10 @@ var SKILLS_CLI_COMMANDS = [
   },
   {
     path: ["skills", "install"],
-    usage: "canonry skills install [skill...] [--dir <path>] [--client claude|codex|all] [--force] [--format json]",
+    usage: "canonry skills install [skill...] [--dir <path> | --user] [--client claude|codex|all] [--force] [--format json]",
     options: {
       dir: stringOption(),
+      user: { type: "boolean" },
       client: stringOption(),
       force: { type: "boolean" }
     },
@@ -7737,6 +7291,7 @@ var SKILLS_CLI_COMMANDS = [
     run: async (input) => {
       const summary = await installSkills({
         dir: getString(input.values, "dir"),
+        user: getBoolean(input.values, "user"),
         skills: input.positionals.length > 0 ? input.positionals : void 0,
         client: parseSkillsClient(getString(input.values, "client")),
         force: getBoolean(input.values, "force")
@@ -8042,8 +7597,8 @@ function renderQueries(pdf, report) {
     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(", ")}` : "";
-      const line = `${result.displayName}: ${status}${accuracy}${competitors2}`;
+      const competitors = result.recommendedCompetitors.length > 0 ? `; recommended instead: ${result.recommendedCompetitors.join(", ")}` : "";
+      const line = `${result.displayName}: ${status}${accuracy}${competitors}`;
       pdf.bullet(line);
       if (result.error) {
         pdf.paragraph(`Error: ${result.error}`, { size: 9, color: FAIL, lineHeight: 12 });
@@ -8190,8 +7745,8 @@ function formatSnapshotMarkdown(report) {
       const mentioned = result.mentioned ? "Yes" : "No";
       const cited = result.cited ? "Yes" : "No";
       const accuracy = result.describedAccurately === "not-mentioned" ? "-" : result.describedAccurately;
-      const competitors2 = result.recommendedCompetitors.length > 0 ? result.recommendedCompetitors.join(", ") : "-";
-      lines.push(`| ${result.displayName} | ${mentioned} | ${cited} | ${accuracy} | ${competitors2} |`);
+      const competitors = result.recommendedCompetitors.length > 0 ? result.recommendedCompetitors.join(", ") : "-";
+      lines.push(`| ${result.displayName} | ${mentioned} | ${cited} | ${accuracy} | ${competitors} |`);
     }
     lines.push("");
   }
@@ -8421,7 +7976,7 @@ function renderHuman(overview) {
     transitions,
     scores,
     movementSummary,
-    competitors: competitors2,
+    competitors,
     providerScores,
     attentionItems,
     runHistory,
@@ -8469,9 +8024,9 @@ function renderHuman(overview) {
     console.log(`
   Transitions since ${transitions.since}: +${transitions.gained} gained, -${transitions.lost} lost, ${transitions.emerging} emerging`);
   }
-  if (competitors2.length > 0) {
+  if (competitors.length > 0) {
     console.log("\n  Competitors:");
-    for (const c of competitors2) {
+    for (const c of competitors) {
       console.log(`    ${c.domain.padEnd(28)} ${c.citationCount}/${c.totalQueries} ${c.pressureLabel}`);
     }
   }
@@ -8860,7 +8415,7 @@ var CONTENT_CLI_COMMANDS = [
 // src/commands/bootstrap.ts
 import crypto from "crypto";
 import path7 from "path";
-import { eq as eq2 } from "drizzle-orm";
+import { eq } from "drizzle-orm";
 
 // ../config/src/index.ts
 import { z } from "zod";
@@ -8898,7 +8453,11 @@ var envSchema = z.object({
   PERPLEXITY_MODEL: z.string().optional(),
   PERPLEXITY_MAX_CONCURRENCY: z.coerce.number().int().positive().default(2),
   PERPLEXITY_MAX_REQUESTS_PER_MINUTE: z.coerce.number().int().positive().default(10),
-  PERPLEXITY_MAX_REQUESTS_PER_DAY: z.coerce.number().int().positive().default(1e3)
+  PERPLEXITY_MAX_REQUESTS_PER_DAY: z.coerce.number().int().positive().default(1e3),
+  // Secret for HMAC-signing Google OAuth state parameters. Required for
+  // cloud deployments that mount googleRoutes; the plugin refuses to register
+  // without it (see packages/api-routes/src/google.ts).
+  GOOGLE_STATE_SECRET: z.string().optional()
 });
 var bootstrapEnvSchema = z.object({
   CANONRY_API_KEY: z.string().optional(),
@@ -9038,7 +8597,7 @@ async function bootstrapCommand(_opts) {
   const db = createClient(databasePath);
   migrate(db);
   db.transaction((tx) => {
-    tx.delete(apiKeys).where(eq2(apiKeys.name, "default")).run();
+    tx.delete(apiKeys).where(eq(apiKeys.name, "default")).run();
     tx.insert(apiKeys).values({
       id: crypto.randomUUID(),
       name: "default",
@@ -11558,6 +11117,18 @@ async function runCli(args = process.argv.slice(2)) {
       ...setupState ? { setup_state: setupState } : {}
     });
   }
+  if (!isHelpRequest && command !== "telemetry") {
+    void checkLatestVersionForCli().then((update) => {
+      if (!update) return;
+      process.stderr.write(
+        `
+\u2192 canonry ${update.latest} is available (you have ${update.current}).
+  Upgrade: ${update.upgradeCommand}
+
+`
+      );
+    });
+  }
   try {
     if (await dispatchRegisteredCommand(args, format, REGISTERED_CLI_COMMANDS)) {
       return 0;