@ainyc/canonry 4.36.0 → 4.40.0

package/dist/{chunk-O7S623DL.js → chunk-JS6KRBBZ.js}

@@ -472,6 +472,13 @@ var ApiClient = class {
   async putQueries(project, queries) {
     await this.request("PUT", `/projects/${encodeURIComponent(project)}/queries`, { queries });
   }
+  async previewReplaceQueries(project, queries) {
+    return this.request(
+      "POST",
+      `/projects/${encodeURIComponent(project)}/queries/replace-preview`,
+      { queries }
+    );
+  }
   async listQueries(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/queries`);
   }
@@ -1995,6 +2002,17 @@ var canonryMcpTools = [
       await client.putQueries(input.project, uniqueStrings(input.request.queries));
     }
   }),
+  defineTool({
+    name: "canonry_queries_replace_preview",
+    title: "Preview query replace",
+    description: "Preview the impact of replacing a project's tracked query set: current vs proposed, added/removed/unchanged diff, and the count of snapshots that would detach (queryId \u2192 NULL; queryText preserved). Read-only.",
+    access: "read",
+    tier: "setup",
+    inputSchema: queriesInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["POST /api/v1/projects/{name}/queries/replace-preview"],
+    handler: (client, input) => client.previewReplaceQueries(input.project, uniqueStrings(input.request.queries))
+  }),
   defineTool({
     name: "canonry_keywords_replace",
     title: "Replace keywords (legacy alias)",

package/dist/cli.js

@@ -21,7 +21,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-F2G67CIU.js";
+} from "./chunk-H6COOYA6.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -37,14 +37,14 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-O7S623DL.js";
+} from "./chunk-JS6KRBBZ.js";
 import {
   apiKeys,
   createClient,
   migrate,
   projects,
   queries
-} from "./chunk-JQQXMCQ7.js";
+} from "./chunk-EWYUJ2DG.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -292,28 +292,32 @@ Usage: ${config.usage}`, {
 var BACKFILL_CLI_COMMANDS = [
   {
     path: ["backfill", "answer-visibility"],
-    usage: "canonry backfill answer-visibility [--project <name>] [--format json]",
+    usage: "canonry backfill answer-visibility [--project <name>] [--dry-run] [--format json]",
     options: {
       project: stringOption()
     },
     allowPositionals: false,
+    supportsDryRun: true,
     run: async (input) => {
       await backfillAnswerVisibilityCommand({
         project: getString(input.values, "project"),
+        dryRun: input.dryRun,
         format: input.format
       });
     }
   },
   {
     path: ["backfill", "answer-mentions"],
-    usage: "canonry backfill answer-mentions [--project <name>] [--format json]",
+    usage: "canonry backfill answer-mentions [--project <name>] [--dry-run] [--format json]",
     options: {
       project: stringOption()
     },
     allowPositionals: false,
+    supportsDryRun: true,
     run: async (input) => {
       await backfillAnswerMentionsCommand({
         project: getString(input.values, "project"),
+        dryRun: input.dryRun,
         format: input.format
       });
     }
@@ -4691,10 +4695,33 @@ async function addQueries(project, queries2, format) {
   }
   console.log(`Added ${queries2.length} ${queries2.length === 1 ? "query" : "queries"} to "${project}".`);
 }
-async function replaceQueries(project, queries2, format) {
+async function replaceQueries(project, queries2, opts) {
   const client = getClient10();
+  const isJson = opts?.format === "json";
+  if (opts?.dryRun) {
+    const preview = await client.previewReplaceQueries(project, queries2);
+    if (isJson) {
+      console.log(JSON.stringify({ dryRun: true, ...preview }, null, 2));
+      return;
+    }
+    const { diff, snapshotImpact } = preview;
+    console.log(`Query replace preview for "${project}":`);
+    console.log(`  Current: ${preview.current.length} ${preview.current.length === 1 ? "query" : "queries"}`);
+    console.log(`  Proposed: ${preview.proposed.length} ${preview.proposed.length === 1 ? "query" : "queries"}`);
+    console.log(`  Diff:`);
+    console.log(`    + added:     ${diff.added.length}${diff.added.length ? `  (${diff.added.join(", ")})` : ""}`);
+    console.log(`    - removed:   ${diff.removed.length}${diff.removed.length ? `  (${diff.removed.join(", ")})` : ""}`);
+    console.log(`    = unchanged: ${diff.unchanged.length}${diff.unchanged.length ? `  (${diff.unchanged.join(", ")})` : ""}`);
+    console.log(`  Snapshot impact:`);
+    console.log(`    Replace wipes every queries row and re-inserts with new IDs, so ALL`);
+    console.log(`    existing snapshots get detached (queryId \u2192 NULL; queryText preserved).`);
+    console.log(`    Snapshots affected: ${snapshotImpact.snapshotsDetached} across ${snapshotImpact.affectedQueries} ${snapshotImpact.affectedQueries === 1 ? "query" : "queries"}`);
+    console.log(``);
+    console.log(`No DB writes performed. Re-run without --dry-run to apply.`);
+    return;
+  }
   await client.putQueries(project, queries2);
-  if (format === "json") {
+  if (isJson) {
     console.log(JSON.stringify({
       project,
       queries: queries2,
@@ -4834,20 +4861,21 @@ var QUERY_CLI_COMMANDS = [
   },
   {
     path: ["query", "replace"],
-    usage: "canonry query replace <project> <query...> [--format json]",
+    usage: "canonry query replace <project> <query...> [--dry-run] [--format json]",
+    supportsDryRun: true,
     run: async (input) => {
-      const project = requireProject(input, "query.replace", "canonry query replace <project> <query...> [--format json]");
+      const project = requireProject(input, "query.replace", "canonry query replace <project> <query...> [--dry-run] [--format json]");
       const queries2 = input.positionals.slice(1);
       if (queries2.length === 0) {
-        throw usageError("Error: project name and at least one query required\nUsage: canonry query replace <project> <query...> [--format json]", {
+        throw usageError("Error: project name and at least one query required\nUsage: canonry query replace <project> <query...> [--dry-run] [--format json]", {
           message: "project name and at least one query required",
           details: {
             command: "query.replace",
-            usage: "canonry query replace <project> <query...> [--format json]"
+            usage: "canonry query replace <project> <query...> [--dry-run] [--format json]"
           }
         });
       }
-      await replaceQueries(project, queries2, input.format);
+      await replaceQueries(project, queries2, { dryRun: input.dryRun, format: input.format });
     }
   },
   {
@@ -7256,6 +7284,31 @@ function emitInstallSummary(summary, format) {
 Target: ${summary.targetDir}`);
   console.log(summary.message);
 }
+function getMissingUserSkillsNudge(home) {
+  if (!home) return null;
+  const skillsBase = path4.join(home, ".claude", "skills");
+  const installed = [];
+  const missing = [];
+  for (const name of BUNDLED_SKILL_NAMES) {
+    const skillFile = path4.join(skillsBase, name, "SKILL.md");
+    if (existsSafe(skillFile)) installed.push(name);
+    else missing.push(name);
+  }
+  if (missing.length === 0) return null;
+  const fix = missing.length === BUNDLED_SKILL_NAMES.length ? "canonry skills install --user" : `canonry skills install ${missing.join(" ")} --user`;
+  return {
+    message: `Tip: ${missing.join(" + ")} skill${missing.length === 1 ? "" : "s"} not installed in ~/.claude/skills/. Run \`${fix}\` so Claude/Codex sessions on this host auto-load the canonry reference docs.`,
+    missing,
+    installed
+  };
+}
+function existsSafe(p) {
+  try {
+    return fs7.existsSync(p);
+  } catch {
+    return false;
+  }
+}
 function parseSkillsClient(value) {
   if (!value) return SkillsClients.all;
   const parsed = skillsClientSchema.safeParse(value);
@@ -9171,6 +9224,9 @@ Received ${signal}, stopping server...`);
       console.log(`
 Canonry server running at ${url}`);
       console.log("Press Ctrl+C to stop.\n");
+      const nudge = getMissingUserSkillsNudge(process.env.HOME);
+      if (nudge) process.stderr.write(`${nudge.message}
+`);
     }
     setTelemetrySource("cli-server");
     const providerNames = Object.keys(config.providers ?? {}).filter(

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   createServer
-} from "./chunk-F2G67CIU.js";
+} from "./chunk-H6COOYA6.js";
 import {
   loadConfig
-} from "./chunk-O7S623DL.js";
-import "./chunk-JQQXMCQ7.js";
+} from "./chunk-JS6KRBBZ.js";
+import "./chunk-EWYUJ2DG.js";
 import "./chunk-XJVYVURK.js";
 export {
   createServer,

package/dist/{intelligence-service-7AWRUNI2.js → intelligence-service-ZZP3TVZZ.js}

@@ -1,6 +1,6 @@
 import {
   IntelligenceService
-} from "./chunk-JQQXMCQ7.js";
+} from "./chunk-EWYUJ2DG.js";
 import "./chunk-XJVYVURK.js";
 export {
   IntelligenceService

package/dist/mcp.js

@@ -2,7 +2,7 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-O7S623DL.js";
+} from "./chunk-JS6KRBBZ.js";
 import "./chunk-XJVYVURK.js";
 
 // src/mcp/cli.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.36.0",
+  "version": "4.40.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -61,20 +61,20 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"
   },