@ainyc/canonry 1.39.5 → 1.40.0

package/dist/{chunk-FQEUZHFU.js → chunk-FXHVGU5S.js}

@@ -13620,7 +13620,8 @@ var Notifier = class {
     if (lostTransitions.length > 0) events.push("citation.lost");
     if (gainedTransitions.length > 0) events.push("citation.gained");
     for (const notif of notifs) {
-      const config = JSON.parse(notif.config);
+      const config = parseJsonColumn(notif.config, { url: "", events: [] });
+      if (!config.url) continue;
       const subscribedEvents = config.events;
       const matchingEvents = events.filter((e) => subscribedEvents.includes(e));
       log5.info("notification.match", { notificationId: notif.id, subscribedEvents, matchedEvents: matchingEvents });
@@ -14971,12 +14972,8 @@ async function createServer(opts) {
           after: afterConfig
         });
         const affectedProjectIds = opts.db.select({ id: projects.id, providers: projects.providers }).from(projects).all().filter((project) => {
-          try {
-            const configuredProviders = JSON.parse(project.providers || "[]");
-            return configuredProviders.length === 0 || configuredProviders.includes(name);
-          } catch {
-            return false;
-          }
+          const configuredProviders = parseJsonColumn(project.providers, []);
+          return configuredProviders.length === 0 || configuredProviders.includes(name);
         }).map((project) => project.id);
         const targetProjectIds = affectedProjectIds.length > 0 ? affectedProjectIds : [null];
         const createdAt = (/* @__PURE__ */ new Date()).toISOString();

package/dist/cli.js

@@ -28,7 +28,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-FQEUZHFU.js";
+} from "./chunk-FXHVGU5S.js";
 import {
   apiKeys,
   competitors,
@@ -118,9 +118,9 @@ import { parseArgs } from "util";
 function commandId(spec) {
   return spec.path.join(".");
 }
-function matchesPath(args, path5) {
-  if (args.length < path5.length) return false;
-  return path5.every((segment, index) => args[index] === segment);
+function matchesPath(args, path6) {
+  if (args.length < path6.length) return false;
+  return path6.every((segment, index) => args[index] === segment);
 }
 function withFormatOption(options) {
   if (!options) {
@@ -613,9 +613,9 @@ var ApiClient = class {
     }
     return this.probePromise;
   }
-  async request(method, path5, body) {
+  async request(method, path6, body) {
     await this.probeBasePath();
-    const url = `${this.baseUrl}${path5}`;
+    const url = `${this.baseUrl}${path6}`;
     const serializedBody = body != null ? JSON.stringify(body) : void 0;
     const headers = {
       "Authorization": `Bearer ${this.apiKey}`,
@@ -1641,9 +1641,9 @@ async function gaConnect(project, opts) {
     propertyId: opts.propertyId
   };
   if (opts.keyFile) {
-    const fs7 = await import("fs");
+    const fs8 = await import("fs");
     try {
-      const content = fs7.readFileSync(opts.keyFile, "utf-8");
+      const content = fs8.readFileSync(opts.keyFile, "utf-8");
       JSON.parse(content);
       body.keyJson = content;
     } catch (e) {
@@ -4657,6 +4657,10 @@ Usage: canonry settings provider ${name} --api-key <key> [--model <model>] [--ma
   }
 ];
 
+// src/commands/snapshot.ts
+import fs4 from "fs";
+import path2 from "path";
+
 // src/snapshot-pdf.ts
 import fs3 from "fs";
 import path from "path";
@@ -4988,6 +4992,13 @@ function wrapText(font, text, size, maxWidth) {
 function getClient16() {
   return createApiClient();
 }
+function slugify(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function autoOutputPath(companyName, ext) {
+  const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return `${slugify(companyName)}-snapshot-${date}.${ext}`;
+}
 async function createSnapshotReport(companyName, opts) {
   const client = getClient16();
   const report = await client.createSnapshot({
@@ -4996,23 +5007,110 @@ async function createSnapshotReport(companyName, opts) {
     ...opts.phrases && opts.phrases.length > 0 ? { phrases: opts.phrases } : {},
     ...opts.competitors && opts.competitors.length > 0 ? { competitors: opts.competitors } : {}
   });
+  let savedMdPath;
+  if (opts.md) {
+    const mdPath = opts.outputPath ?? autoOutputPath(companyName, "md");
+    savedMdPath = writeSnapshotMarkdown(report, mdPath);
+  }
   let savedPdfPath;
   if (opts.pdf) {
-    savedPdfPath = await writeSnapshotPdf(report, opts.pdf);
+    const pdfPath = opts.outputPath && !opts.md ? opts.outputPath : autoOutputPath(companyName, "pdf");
+    savedPdfPath = await writeSnapshotPdf(report, pdfPath);
   }
   if (opts.format === "json") {
     console.log(JSON.stringify(report, null, 2));
-    if (savedPdfPath) {
-      process.stderr.write(`Saved PDF: ${savedPdfPath}
+    if (savedMdPath) process.stderr.write(`Saved markdown: ${savedMdPath}
+`);
+    if (savedPdfPath) process.stderr.write(`Saved PDF: ${savedPdfPath}
 `);
-    }
     return;
   }
   console.log(formatSnapshotText(report));
-  if (savedPdfPath) {
-    console.log(`
+  if (savedMdPath) console.log(`
+Markdown saved: ${savedMdPath}`);
+  if (savedPdfPath) console.log(`
 PDF saved: ${savedPdfPath}`);
+}
+function writeSnapshotMarkdown(report, outputPath) {
+  const resolvedPath = path2.resolve(outputPath);
+  fs4.mkdirSync(path2.dirname(resolvedPath), { recursive: true });
+  fs4.writeFileSync(resolvedPath, formatSnapshotMarkdown(report), "utf-8");
+  return resolvedPath;
+}
+function formatSnapshotMarkdown(report) {
+  const lines = [];
+  lines.push(`# AI Perception Snapshot: ${report.companyName}`);
+  lines.push("");
+  lines.push(`**Domain:** ${report.domain}`);
+  lines.push(`**Generated:** ${new Date(report.generatedAt).toLocaleString("en-US", { year: "numeric", month: "long", day: "numeric", hour: "numeric", minute: "2-digit" })}`);
+  lines.push(`**AEO Audit Score:** ${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
+  lines.push("");
+  lines.push("## Visibility Gap");
+  lines.push("");
+  lines.push(report.summary.visibilityGap);
+  lines.push("");
+  if (report.summary.whatThisMeans.length > 0) {
+    lines.push("## What This Means");
+    lines.push("");
+    for (const item of report.summary.whatThisMeans) {
+      lines.push(`- ${item}`);
+    }
+    lines.push("");
   }
+  if (report.summary.recommendedActions.length > 0) {
+    lines.push("## Recommended Actions");
+    lines.push("");
+    for (const action of report.summary.recommendedActions) {
+      lines.push(`- ${action}`);
+    }
+    lines.push("");
+  }
+  if (report.summary.topCompetitors.length > 0) {
+    lines.push("## Competitors AI Recommends Instead");
+    lines.push("");
+    lines.push("| Competitor | Mentions |");
+    lines.push("|------------|----------|");
+    for (const entry of report.summary.topCompetitors) {
+      lines.push(`| ${entry.name} | ${entry.count} |`);
+    }
+    lines.push("");
+  }
+  lines.push("## Provider Comparison");
+  lines.push("");
+  for (const query of report.queryResults) {
+    lines.push(`### "${query.phrase}"`);
+    lines.push("");
+    lines.push("| Provider | Mentioned | Cited | Accuracy | Competitors Recommended |");
+    lines.push("|----------|-----------|-------|----------|------------------------|");
+    for (const result of query.providerResults) {
+      if (result.error) {
+        lines.push(`| ${result.displayName} | ERROR | - | - | ${result.error} |`);
+        continue;
+      }
+      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} |`);
+    }
+    lines.push("");
+  }
+  if (report.audit.factors.length > 0) {
+    lines.push("## Audit Factors");
+    lines.push("");
+    lines.push(report.audit.summary);
+    lines.push("");
+    lines.push("| Factor | Score | Weight | Status |");
+    lines.push("|--------|-------|--------|--------|");
+    const sorted = [...report.audit.factors].sort((a, b) => a.score - b.score);
+    for (const factor of sorted) {
+      lines.push(`| ${factor.name} | ${factor.score} | ${factor.weight} | ${factor.status} |`);
+    }
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push(`*Generated by [Canonry](https://github.com/AINYC/canonry)*`);
+  return lines.join("\n");
 }
 function formatSnapshotText(report) {
   const lines = [];
@@ -5080,15 +5178,17 @@ function parseCsvOption(value) {
 var SNAPSHOT_CLI_COMMANDS = [
   {
     path: ["snapshot"],
-    usage: 'canonry snapshot <company-name> --domain <domain> [--phrases "a,b"] [--competitors "x,y"] [--pdf <path>] [--format table|json]',
+    usage: 'canonry snapshot <company-name> --domain <domain> [--phrases "a,b"] [--competitors "x,y"] [--md] [--output <path>] [--pdf] [--format table|json]',
     options: {
       domain: stringOption(),
       phrases: stringOption(),
       competitors: stringOption(),
-      pdf: stringOption()
+      md: { type: "boolean" },
+      pdf: { type: "boolean" },
+      output: stringOption()
     },
     run: async (input) => {
-      const usage = 'canonry snapshot <company-name> --domain <domain> [--phrases "a,b"] [--competitors "x,y"] [--pdf <path>] [--format table|json]';
+      const usage = 'canonry snapshot <company-name> --domain <domain> [--phrases "a,b"] [--competitors "x,y"] [--md] [--output <path>] [--pdf] [--format table|json]';
       const companyName = requirePositional(input, 0, {
         command: "snapshot",
         usage,
@@ -5099,11 +5199,17 @@ var SNAPSHOT_CLI_COMMANDS = [
         usage,
         message: "--domain is required"
       });
+      const outputPath = getString(input.values, "output");
+      const explicitMd = getBoolean(input.values, "md");
+      const wantsPdf = getBoolean(input.values, "pdf");
+      const wantsMd = explicitMd || !!outputPath && !wantsPdf;
       await createSnapshotReport(companyName, {
         domain,
         phrases: parseCsvOption(getString(input.values, "phrases")),
         competitors: parseCsvOption(getString(input.values, "competitors")),
-        pdf: getString(input.values, "pdf"),
+        md: wantsMd,
+        pdf: wantsPdf,
+        outputPath,
         format: input.format
       });
     }
@@ -5232,7 +5338,7 @@ var INTELLIGENCE_CLI_COMMANDS = [
 
 // src/commands/bootstrap.ts
 import crypto from "crypto";
-import path2 from "path";
+import path3 from "path";
 import { eq as eq2 } from "drizzle-orm";
 
 // ../config/src/index.ts
@@ -5379,7 +5485,7 @@ async function bootstrapCommand(_opts) {
     );
   }
   const configDir = getConfigDir();
-  const databasePath = env.databasePath || path2.join(configDir, "data.db");
+  const databasePath = env.databasePath || path3.join(configDir, "data.db");
   const existing = configExists();
   const existingConfig = existing ? loadConfig() : void 0;
   let rawApiKey;
@@ -5449,10 +5555,10 @@ async function bootstrapCommand(_opts) {
 
 // src/commands/daemon.ts
 import { spawn } from "child_process";
-import fs4 from "fs";
-import path3 from "path";
+import fs5 from "fs";
+import path4 from "path";
 function getPidPath() {
-  return path3.join(getConfigDir(), "canonry.pid");
+  return path4.join(getConfigDir(), "canonry.pid");
 }
 function isProcessAlive(pid) {
   try {
@@ -5479,8 +5585,8 @@ async function waitForReady(host, port, maxMs = 1e4) {
 async function startDaemon(opts) {
   const pidPath = getPidPath();
   const format = opts.format ?? "text";
-  if (fs4.existsSync(pidPath)) {
-    const existingPid = parseInt(fs4.readFileSync(pidPath, "utf-8").trim(), 10);
+  if (fs5.existsSync(pidPath)) {
+    const existingPid = parseInt(fs5.readFileSync(pidPath, "utf-8").trim(), 10);
     if (!isNaN(existingPid) && isProcessAlive(existingPid)) {
       throw new CliError({
         code: "DAEMON_ALREADY_RUNNING",
@@ -5491,9 +5597,9 @@ async function startDaemon(opts) {
         }
       });
     }
-    fs4.unlinkSync(pidPath);
+    fs5.unlinkSync(pidPath);
   }
-  const cliPath = path3.resolve(new URL(import.meta.url).pathname);
+  const cliPath = path4.resolve(new URL(import.meta.url).pathname);
   const inSourceMode = new URL(import.meta.url).pathname.endsWith(".ts");
   const args = inSourceMode ? ["--import", "tsx", cliPath, "serve"] : [cliPath, "serve"];
   if (opts.port) args.push("--port", opts.port);
@@ -5512,10 +5618,10 @@ async function startDaemon(opts) {
     });
   }
   const configDir = getConfigDir();
-  if (!fs4.existsSync(configDir)) {
-    fs4.mkdirSync(configDir, { recursive: true });
+  if (!fs5.existsSync(configDir)) {
+    fs5.mkdirSync(configDir, { recursive: true });
   }
-  fs4.writeFileSync(pidPath, String(child.pid), "utf-8");
+  fs5.writeFileSync(pidPath, String(child.pid), "utf-8");
   const port = opts.port ?? "4100";
   const host = opts.host ?? "127.0.0.1";
   if (format !== "json") {
@@ -5524,7 +5630,7 @@ async function startDaemon(opts) {
   const ready = await waitForReady(host, port);
   if (!ready) {
     try {
-      fs4.unlinkSync(pidPath);
+      fs5.unlinkSync(pidPath);
     } catch {
     }
     throw new CliError({
@@ -5556,7 +5662,7 @@ async function startDaemon(opts) {
 }
 function stopDaemon(format = "text") {
   const pidPath = getPidPath();
-  if (!fs4.existsSync(pidPath)) {
+  if (!fs5.existsSync(pidPath)) {
     if (format === "json") {
       console.log(JSON.stringify({
         stopped: false,
@@ -5567,7 +5673,7 @@ function stopDaemon(format = "text") {
     console.log("Canonry is not running (no PID file found)");
     return;
   }
-  const pid = parseInt(fs4.readFileSync(pidPath, "utf-8").trim(), 10);
+  const pid = parseInt(fs5.readFileSync(pidPath, "utf-8").trim(), 10);
   if (isNaN(pid)) {
     if (format === "json") {
       console.log(JSON.stringify({
@@ -5578,7 +5684,7 @@ function stopDaemon(format = "text") {
     } else {
       console.error("Invalid PID file. Removing it.");
     }
-    fs4.unlinkSync(pidPath);
+    fs5.unlinkSync(pidPath);
     return;
   }
   if (!isProcessAlive(pid)) {
@@ -5592,12 +5698,12 @@ function stopDaemon(format = "text") {
     } else {
       console.log(`Canonry is not running (stale PID: ${pid}). Cleaning up.`);
     }
-    fs4.unlinkSync(pidPath);
+    fs5.unlinkSync(pidPath);
     return;
   }
   try {
     process.kill(pid, "SIGTERM");
-    fs4.unlinkSync(pidPath);
+    fs5.unlinkSync(pidPath);
     if (format === "json") {
       console.log(JSON.stringify({
         stopped: true,
@@ -5621,9 +5727,9 @@ function stopDaemon(format = "text") {
 
 // src/commands/init.ts
 import crypto2 from "crypto";
-import fs5 from "fs";
+import fs6 from "fs";
 import readline from "readline";
-import path4 from "path";
+import path5 from "path";
 function prompt(question) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -5660,8 +5766,8 @@ async function initCommand(opts) {
     return;
   }
   const configDir = getConfigDir();
-  if (!fs5.existsSync(configDir)) {
-    fs5.mkdirSync(configDir, { recursive: true });
+  if (!fs6.existsSync(configDir)) {
+    fs6.mkdirSync(configDir, { recursive: true });
   }
   const bootstrapEnv = getBootstrapEnv(process.env, {
     GEMINI_API_KEY: opts?.geminiKey,
@@ -5776,7 +5882,7 @@ async function initCommand(opts) {
   const rawApiKey = `cnry_${crypto2.randomBytes(16).toString("hex")}`;
   const keyHash = crypto2.createHash("sha256").update(rawApiKey).digest("hex");
   const keyPrefix = rawApiKey.slice(0, 9);
-  const databasePath = path4.join(configDir, "data.db");
+  const databasePath = path5.join(configDir, "data.db");
   const db = createClient(databasePath);
   migrate(db);
   db.insert(apiKeys).values({
@@ -6138,7 +6244,7 @@ var SYSTEM_CLI_COMMANDS = [
 ];
 
 // src/cli-commands/wordpress.ts
-import fs6 from "fs";
+import fs7 from "fs";
 
 // src/commands/wordpress.ts
 function getClient17() {
@@ -6374,12 +6480,12 @@ async function wordpressSetMeta(project, body) {
   printPageDetail(result);
 }
 async function wordpressBulkSetMeta(project, opts) {
-  const fs7 = await import("fs/promises");
-  const path5 = await import("path");
-  const filePath = path5.resolve(opts.from);
+  const fs8 = await import("fs/promises");
+  const path6 = await import("path");
+  const filePath = path6.resolve(opts.from);
   let raw;
   try {
-    raw = await fs7.readFile(filePath, "utf8");
+    raw = await fs8.readFile(filePath, "utf8");
   } catch {
     throw new CliError({
       code: "FILE_READ_ERROR",
@@ -6476,13 +6582,13 @@ async function wordpressSetSchema(project, body) {
   printManualAssist(`Schema update for "${body.slug}"`, result);
 }
 async function wordpressSchemaDeploy(project, opts) {
-  const fs7 = await import("fs/promises");
-  const path5 = await import("path");
+  const fs8 = await import("fs/promises");
+  const path6 = await import("path");
   const yaml = await import("yaml").catch(() => null);
-  const filePath = path5.resolve(opts.profile);
+  const filePath = path6.resolve(opts.profile);
   let raw;
   try {
-    raw = await fs7.readFile(filePath, "utf8");
+    raw = await fs8.readFile(filePath, "utf8");
   } catch {
     throw new CliError({
       code: "FILE_READ_ERROR",
@@ -6587,13 +6693,13 @@ async function wordpressOnboard(project, opts) {
   }
   let profileData;
   if (opts.profile) {
-    const fs7 = await import("fs/promises");
-    const path5 = await import("path");
+    const fs8 = await import("fs/promises");
+    const path6 = await import("path");
     const yaml = await import("yaml").catch(() => null);
-    const filePath = path5.resolve(opts.profile);
+    const filePath = path6.resolve(opts.profile);
     let raw;
     try {
-      raw = await fs7.readFile(filePath, "utf8");
+      raw = await fs8.readFile(filePath, "utf8");
     } catch {
       throw new CliError({
         code: "FILE_READ_ERROR",
@@ -6742,7 +6848,7 @@ function resolveContent(input, command, usage, options) {
   }
   if (contentFile) {
     try {
-      return fs6.readFileSync(contentFile, "utf-8");
+      return fs7.readFileSync(contentFile, "utf-8");
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       throw usageError(`Error: could not read --content-file "${contentFile}": ${message}`, {

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createServer,
   loadConfig
-} from "./chunk-FQEUZHFU.js";
+} from "./chunk-FXHVGU5S.js";
 import "./chunk-FOWWBLXD.js";
 export {
   createServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "1.39.5",
+  "version": "1.40.0",
   "type": "module",
   "description": "The ultimate open-source AEO monitoring tool - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -54,17 +54,17 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"