@ainyc/canonry 4.35.0 → 4.39.0

package/dist/{chunk-EM5GVF3C.js → chunk-XJVYVURK.js}

@@ -1858,7 +1858,9 @@ var checkCategorySchema = z17.enum([
   "providers",
   "integrations",
   "database",
-  "schedules"
+  "schedules",
+  /** Discoverability checks for agent integrations (skills installed, MCP setup). */
+  "agent"
 ]);
 var CheckCategories = checkCategorySchema.enum;
 var checkResultSchema = z17.object({

package/dist/cli.js

@@ -21,7 +21,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-NLV4MZZF.js";
+} from "./chunk-Q57CMOL6.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -37,14 +37,14 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-B3FBOECD.js";
+} from "./chunk-JS6KRBBZ.js";
 import {
   apiKeys,
   createClient,
   migrate,
   projects,
   queries
-} from "./chunk-MLS5KJWK.js";
+} from "./chunk-DOUV45KI.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -63,7 +63,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-EM5GVF3C.js";
+} from "./chunk-XJVYVURK.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -113,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;
@@ -179,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;
@@ -195,10 +189,21 @@ 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;
 }
@@ -287,45 +292,53 @@ 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
       });
     }
   },
   {
     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
       });
     }
@@ -4682,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,
@@ -4825,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 });
     }
   },
   {
@@ -5948,10 +5985,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;
   }
@@ -6101,10 +6159,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 });
     }
   },
   {
@@ -6986,6 +7045,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"];
@@ -7162,7 +7222,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();
@@ -7224,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);
@@ -7248,9 +7333,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" }
     },
@@ -7258,6 +7344,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")
@@ -9137,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,11 +1,11 @@
 import {
   createServer
-} from "./chunk-NLV4MZZF.js";
+} from "./chunk-Q57CMOL6.js";
 import {
   loadConfig
-} from "./chunk-B3FBOECD.js";
-import "./chunk-MLS5KJWK.js";
-import "./chunk-EM5GVF3C.js";
+} from "./chunk-JS6KRBBZ.js";
+import "./chunk-DOUV45KI.js";
+import "./chunk-XJVYVURK.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-WAJOEOJV.js → intelligence-service-CIGYPPMR.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-MLS5KJWK.js";
-import "./chunk-EM5GVF3C.js";
+} from "./chunk-DOUV45KI.js";
+import "./chunk-XJVYVURK.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -2,8 +2,8 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-B3FBOECD.js";
-import "./chunk-EM5GVF3C.js";
+} from "./chunk-JS6KRBBZ.js";
+import "./chunk-XJVYVURK.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.35.0",
+  "version": "4.39.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -60,23 +60,23 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "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-claude": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",