@ainyc/canonry 1.28.1 → 1.29.0

package/dist/cli.js

@@ -5,6 +5,7 @@ import {
   createClient,
   createServer,
   effectiveDomains,
+  formatAuditFactorScore,
   getConfigDir,
   getConfigPath,
   getOrCreateAnonymousId,
@@ -20,7 +21,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-2WEJYH27.js";
+} from "./chunk-IWUQVYU3.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -96,9 +97,9 @@ import { parseArgs } from "util";
 function commandId(spec) {
   return spec.path.join(".");
 }
-function matchesPath(args, path4) {
-  if (args.length < path4.length) return false;
-  return path4.every((segment, index) => args[index] === segment);
+function matchesPath(args, path5) {
+  if (args.length < path5.length) return false;
+  return path5.every((segment, index) => args[index] === segment);
 }
 function withFormatOption(options) {
   if (!options) {
@@ -197,9 +198,9 @@ var ApiClient = class {
     }
     return this.probePromise;
   }
-  async request(method, path4, body) {
+  async request(method, path5, body) {
     await this.probeBasePath();
-    const url = `${this.baseUrl}${path4}`;
+    const url = `${this.baseUrl}${path5}`;
     const serializedBody = body != null ? JSON.stringify(body) : void 0;
     const headers = {
       "Authorization": `Bearer ${this.apiKey}`,
@@ -297,6 +298,9 @@ var ApiClient = class {
   async getSettings() {
     return this.request("GET", "/settings");
   }
+  async createSnapshot(body) {
+    return this.request("POST", "/snapshot", body);
+  }
   async updateProvider(name, body) {
     return this.request("PUT", `/settings/providers/${encodeURIComponent(name)}`, body);
   }
@@ -1275,9 +1279,9 @@ async function gaConnect(project, opts) {
     propertyId: opts.propertyId
   };
   if (opts.keyFile) {
-    const fs6 = await import("fs");
+    const fs7 = await import("fs");
     try {
-      const content = fs6.readFileSync(opts.keyFile, "utf-8");
+      const content = fs7.readFileSync(opts.keyFile, "utf-8");
       JSON.parse(content);
       body.keyJson = content;
     } catch (e) {
@@ -4212,9 +4216,462 @@ Usage: canonry settings provider ${name} --api-key <key> [--model <model>] [--ma
   }
 ];
 
+// src/snapshot-pdf.ts
+import fs3 from "fs";
+import path from "path";
+import { PDFDocument, StandardFonts, rgb } from "pdf-lib";
+var PAGE_WIDTH = 612;
+var PAGE_HEIGHT = 792;
+var MARGIN = 48;
+var BRAND = rgb(0.58, 0, 0);
+var INK = rgb(0.1, 0.1, 0.1);
+var MUTED = rgb(0.38, 0.38, 0.38);
+var LINE = rgb(0.82, 0.8, 0.76);
+var PASS = rgb(0.18, 0.49, 0.31);
+var CAUTION = rgb(0.72, 0.45, 0.2);
+var FAIL = rgb(0.7, 0.15, 0.15);
+var PdfWriter = class {
+  constructor(doc, regular, bold) {
+    this.doc = doc;
+    this.regular = regular;
+    this.bold = bold;
+    this.addPage();
+  }
+  usableWidth = PAGE_WIDTH - MARGIN * 2;
+  page;
+  y = 0;
+  addPage() {
+    this.page = this.doc.addPage([PAGE_WIDTH, PAGE_HEIGHT]);
+    this.y = PAGE_HEIGHT - MARGIN;
+  }
+  ensureSpace(height) {
+    if (this.y - height < MARGIN) {
+      this.addPage();
+    }
+  }
+  heading(text, size = 18) {
+    this.ensureSpace(size + 12);
+    this.page.drawText(text, {
+      x: MARGIN,
+      y: this.y,
+      size,
+      font: this.bold,
+      color: BRAND
+    });
+    this.y -= size + 8;
+  }
+  subheading(text, size = 12) {
+    this.ensureSpace(size + 8);
+    this.page.drawText(text, {
+      x: MARGIN,
+      y: this.y,
+      size,
+      font: this.bold,
+      color: INK
+    });
+    this.y -= size + 6;
+  }
+  paragraph(text, opts) {
+    const size = opts?.size ?? 10;
+    const color = opts?.color ?? INK;
+    const lineHeight = opts?.lineHeight ?? size + 4;
+    const lines = wrapText(this.regular, text, size, this.usableWidth);
+    this.ensureSpace(lines.length * lineHeight + 4);
+    for (const line of lines) {
+      this.page.drawText(line, {
+        x: MARGIN,
+        y: this.y,
+        size,
+        font: this.regular,
+        color
+      });
+      this.y -= lineHeight;
+    }
+    this.y -= 2;
+  }
+  bullet(text) {
+    const lines = wrapText(this.regular, text, 10, this.usableWidth - 14);
+    this.ensureSpace(lines.length * 14 + 2);
+    this.page.drawText("-", {
+      x: MARGIN,
+      y: this.y,
+      size: 10,
+      font: this.bold,
+      color: BRAND
+    });
+    let first = true;
+    for (const line of lines) {
+      this.page.drawText(line, {
+        x: MARGIN + 14,
+        y: this.y,
+        size: 10,
+        font: this.regular,
+        color: INK
+      });
+      this.y -= 14;
+      if (first) first = false;
+    }
+    this.y -= 2;
+  }
+  rule() {
+    this.ensureSpace(8);
+    this.page.drawLine({
+      start: { x: MARGIN, y: this.y },
+      end: { x: PAGE_WIDTH - MARGIN, y: this.y },
+      thickness: 1,
+      color: LINE
+    });
+    this.y -= 10;
+  }
+  keyValue(label, value) {
+    const size = 10;
+    const labelWidth = this.bold.widthOfTextAtSize(`${label}: `, size);
+    this.ensureSpace(16);
+    this.page.drawText(`${label}:`, {
+      x: MARGIN,
+      y: this.y,
+      size,
+      font: this.bold,
+      color: INK
+    });
+    const lines = wrapText(this.regular, value, size, this.usableWidth - labelWidth - 4);
+    let currentY = this.y;
+    for (const line of lines) {
+      this.page.drawText(line, {
+        x: MARGIN + labelWidth + 4,
+        y: currentY,
+        size,
+        font: this.regular,
+        color: INK
+      });
+      currentY -= 14;
+    }
+    this.y = currentY - 2;
+  }
+  table(headers, rows, widths) {
+    const columnWidths = widths ?? headers.map(() => this.usableWidth / headers.length);
+    const headerHeight = 20;
+    this.ensureSpace(headerHeight + 10);
+    let x = MARGIN;
+    for (let i = 0; i < headers.length; i++) {
+      const width = columnWidths[i];
+      this.page.drawRectangle({
+        x,
+        y: this.y - headerHeight + 4,
+        width,
+        height: headerHeight,
+        color: BRAND
+      });
+      const lines = wrapText(this.bold, headers[i], 9, width - 8);
+      let lineY = this.y - 10;
+      for (const line of lines) {
+        this.page.drawText(line, {
+          x: x + 4,
+          y: lineY,
+          size: 9,
+          font: this.bold,
+          color: rgb(1, 0.98, 0.93)
+        });
+        lineY -= 10;
+      }
+      x += width;
+    }
+    this.y -= headerHeight + 4;
+    for (const row of rows) {
+      const lineCounts = row.map((cell, index) => wrapText(this.regular, cell, 9, columnWidths[index] - 8).length);
+      const rowHeight = Math.max(18, Math.max(...lineCounts) * 11 + 6);
+      this.ensureSpace(rowHeight + 4);
+      let cellX = MARGIN;
+      for (let i = 0; i < row.length; i++) {
+        const width = columnWidths[i];
+        this.page.drawRectangle({
+          x: cellX,
+          y: this.y - rowHeight + 4,
+          width,
+          height: rowHeight,
+          borderColor: LINE,
+          borderWidth: 0.5
+        });
+        const lines = wrapText(this.regular, row[i], 9, width - 8);
+        let lineY = this.y - 10;
+        for (const line of lines) {
+          this.page.drawText(line, {
+            x: cellX + 4,
+            y: lineY,
+            size: 9,
+            font: this.regular,
+            color: INK
+          });
+          lineY -= 11;
+        }
+        cellX += width;
+      }
+      this.y -= rowHeight + 2;
+    }
+    this.y -= 4;
+  }
+};
+async function writeSnapshotPdf(report, outputPath) {
+  const doc = await PDFDocument.create();
+  doc.setTitle(`${report.companyName} AI Perception Snapshot`);
+  doc.setAuthor("Canonry");
+  doc.setSubject("AEO snapshot report");
+  doc.setProducer("Canonry");
+  doc.setCreator("Canonry");
+  const regular = await doc.embedFont(StandardFonts.Helvetica);
+  const bold = await doc.embedFont(StandardFonts.HelveticaBold);
+  const pdf = new PdfWriter(doc, regular, bold);
+  renderCover(pdf, report);
+  renderSummary(pdf, report);
+  renderAudit(pdf, report);
+  renderCompetitors(pdf, report);
+  renderQueries(pdf, report);
+  const bytes = await doc.save();
+  const resolvedPath = path.resolve(outputPath);
+  fs3.mkdirSync(path.dirname(resolvedPath), { recursive: true });
+  fs3.writeFileSync(resolvedPath, bytes);
+  return resolvedPath;
+}
+function renderCover(pdf, report) {
+  pdf.heading("AI Perception Snapshot", 24);
+  pdf.paragraph(report.companyName, { size: 15, color: INK, lineHeight: 18 });
+  pdf.paragraph(report.domain, { size: 11, color: MUTED, lineHeight: 14 });
+  pdf.rule();
+  pdf.keyValue("Generated", new Date(report.generatedAt).toLocaleString("en-US", {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+    hour: "numeric",
+    minute: "2-digit"
+  }));
+  pdf.keyValue("AEO Audit", `${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
+  pdf.keyValue("Visibility Gap", report.summary.visibilityGap);
+  pdf.paragraph(report.profile.summary, { size: 11, color: INK, lineHeight: 16 });
+  pdf.rule();
+}
+function renderSummary(pdf, report) {
+  pdf.heading("What This Means");
+  for (const line of report.summary.whatThisMeans) {
+    pdf.bullet(line);
+  }
+  pdf.subheading("Recommended Actions");
+  for (const action of report.summary.recommendedActions) {
+    pdf.bullet(action);
+  }
+  pdf.rule();
+}
+function renderAudit(pdf, report) {
+  pdf.heading("Audit Snapshot");
+  pdf.paragraph(report.audit.summary, { size: 10, color: MUTED, lineHeight: 14 });
+  const factorRows = [...report.audit.factors].sort((a, b) => a.score - b.score || a.name.localeCompare(b.name)).slice(0, 5).map((factor) => [
+    factor.name,
+    formatAuditFactorScore(factor),
+    factor.status
+  ]);
+  if (factorRows.length > 0) {
+    pdf.table(["Weakest factor", "Score / Weight", "Status"], factorRows, [270, 120, 126]);
+  }
+  pdf.rule();
+}
+function renderCompetitors(pdf, report) {
+  pdf.heading("Recommended Instead");
+  if (report.summary.topCompetitors.length === 0) {
+    pdf.paragraph("No clear competitor cluster was extracted from the responses.", {
+      size: 10,
+      color: MUTED
+    });
+    pdf.rule();
+    return;
+  }
+  pdf.table(
+    ["Competitor", "Mentions"],
+    report.summary.topCompetitors.map((entry) => [entry.name, String(entry.count)]),
+    [420, 96]
+  );
+  pdf.rule();
+}
+function renderQueries(pdf, report) {
+  pdf.heading("Provider Comparison");
+  for (const query of report.queryResults) {
+    pdf.subheading(query.phrase, 11);
+    for (const result of query.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 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 });
+      } else if (result.accuracyNotes) {
+        const color = result.describedAccurately === "yes" ? PASS : result.describedAccurately === "no" ? FAIL : CAUTION;
+        pdf.paragraph(result.accuracyNotes, { size: 9, color, lineHeight: 12 });
+      }
+    }
+    pdf.rule();
+  }
+}
+function wrapText(font, text, size, maxWidth) {
+  const normalized = text.replace(/\s+/g, " ").trim();
+  if (!normalized) return [""];
+  const words = normalized.split(" ");
+  const lines = [];
+  let current = "";
+  for (const word of words) {
+    const next = current ? `${current} ${word}` : word;
+    if (font.widthOfTextAtSize(next, size) <= maxWidth) {
+      current = next;
+      continue;
+    }
+    if (current) {
+      lines.push(current);
+      current = word;
+      continue;
+    }
+    let chunk = "";
+    for (const char of word) {
+      const candidate = `${chunk}${char}`;
+      if (font.widthOfTextAtSize(candidate, size) <= maxWidth) {
+        chunk = candidate;
+      } else {
+        if (chunk) lines.push(chunk);
+        chunk = char;
+      }
+    }
+    current = chunk;
+  }
+  if (current) lines.push(current);
+  return lines;
+}
+
+// src/commands/snapshot.ts
+function getClient16() {
+  return createApiClient();
+}
+async function createSnapshotReport(companyName, opts) {
+  const client = getClient16();
+  const report = await client.createSnapshot({
+    companyName,
+    domain: opts.domain,
+    ...opts.phrases && opts.phrases.length > 0 ? { phrases: opts.phrases } : {},
+    ...opts.competitors && opts.competitors.length > 0 ? { competitors: opts.competitors } : {}
+  });
+  let savedPdfPath;
+  if (opts.pdf) {
+    savedPdfPath = await writeSnapshotPdf(report, opts.pdf);
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify(report, null, 2));
+    if (savedPdfPath) {
+      process.stderr.write(`Saved PDF: ${savedPdfPath}
+`);
+    }
+    return;
+  }
+  console.log(formatSnapshotText(report));
+  if (savedPdfPath) {
+    console.log(`
+PDF saved: ${savedPdfPath}`);
+  }
+}
+function formatSnapshotText(report) {
+  const lines = [];
+  lines.push(`Snapshot: ${report.companyName} (${report.domain})`);
+  lines.push(`AEO audit: ${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
+  lines.push(report.summary.visibilityGap);
+  lines.push("");
+  if (report.summary.topCompetitors.length > 0) {
+    lines.push(
+      `Top competitors AI recommended instead: ${report.summary.topCompetitors.map((entry) => `${entry.name} (${entry.count})`).join(", ")}`
+    );
+    lines.push("");
+  }
+  if (report.summary.whatThisMeans.length > 0) {
+    lines.push("What this means:");
+    for (const item of report.summary.whatThisMeans) {
+      lines.push(`  - ${item}`);
+    }
+    lines.push("");
+  }
+  const providerWidth = Math.max(
+    8,
+    ...report.queryResults.flatMap((query) => query.providerResults.map((result) => result.displayName.length))
+  );
+  for (const query of report.queryResults) {
+    lines.push(`"${query.phrase}"`);
+    for (const result of query.providerResults) {
+      lines.push(`  ${result.displayName.padEnd(providerWidth)}  ${formatProviderLine(result)}`);
+    }
+    lines.push("");
+  }
+  if (report.summary.recommendedActions.length > 0) {
+    lines.push("Recommended actions:");
+    for (const action of report.summary.recommendedActions) {
+      lines.push(`  - ${action}`);
+    }
+  }
+  return lines.join("\n").trimEnd();
+}
+function formatProviderLine(result) {
+  if (result.error) {
+    return `ERROR: ${result.error}`;
+  }
+  const bits = [];
+  bits.push(result.mentioned ? "YES mentioned" : "NO mention");
+  if (result.cited) bits.push("cited");
+  if (result.describedAccurately !== "not-mentioned") {
+    bits.push(`accuracy=${result.describedAccurately}`);
+  }
+  if (result.recommendedCompetitors.length > 0) {
+    bits.push(`recommended instead: ${result.recommendedCompetitors.join(", ")}`);
+  }
+  if (result.incorrectClaims.length > 0) {
+    bits.push(`incorrect: ${result.incorrectClaims.join("; ")}`);
+  }
+  return bits.join(" | ");
+}
+
+// src/cli-commands/snapshot.ts
+function parseCsvOption(value) {
+  if (!value) return void 0;
+  const parts = value.split(",").map((part) => part.trim()).filter(Boolean);
+  return parts.length > 0 ? [...new Set(parts)] : void 0;
+}
+var SNAPSHOT_CLI_COMMANDS = [
+  {
+    path: ["snapshot"],
+    usage: 'canonry snapshot <company-name> --domain <domain> [--phrases "a,b"] [--competitors "x,y"] [--pdf <path>] [--format table|json]',
+    options: {
+      domain: stringOption(),
+      phrases: stringOption(),
+      competitors: stringOption(),
+      pdf: stringOption()
+    },
+    run: async (input) => {
+      const usage = 'canonry snapshot <company-name> --domain <domain> [--phrases "a,b"] [--competitors "x,y"] [--pdf <path>] [--format table|json]';
+      const companyName = requirePositional(input, 0, {
+        command: "snapshot",
+        usage,
+        message: "company name is required"
+      });
+      const domain = requireStringOption(input, "domain", {
+        command: "snapshot",
+        usage,
+        message: "--domain is required"
+      });
+      await createSnapshotReport(companyName, {
+        domain,
+        phrases: parseCsvOption(getString(input.values, "phrases")),
+        competitors: parseCsvOption(getString(input.values, "competitors")),
+        pdf: getString(input.values, "pdf"),
+        format: input.format
+      });
+    }
+  }
+];
+
 // src/commands/bootstrap.ts
 import crypto from "crypto";
-import path from "path";
+import path2 from "path";
 import { eq } from "drizzle-orm";
 
 // ../config/src/index.ts
@@ -4360,7 +4817,7 @@ async function bootstrapCommand(_opts) {
     );
   }
   const configDir = getConfigDir();
-  const databasePath = env.databasePath || path.join(configDir, "data.db");
+  const databasePath = env.databasePath || path2.join(configDir, "data.db");
   const existing = configExists();
   const existingConfig = existing ? loadConfig() : void 0;
   let rawApiKey;
@@ -4428,10 +4885,10 @@ async function bootstrapCommand(_opts) {
 
 // src/commands/daemon.ts
 import { spawn } from "child_process";
-import fs3 from "fs";
-import path2 from "path";
+import fs4 from "fs";
+import path3 from "path";
 function getPidPath() {
-  return path2.join(getConfigDir(), "canonry.pid");
+  return path3.join(getConfigDir(), "canonry.pid");
 }
 function isProcessAlive(pid) {
   try {
@@ -4458,8 +4915,8 @@ async function waitForReady(host, port, maxMs = 1e4) {
 async function startDaemon(opts) {
   const pidPath = getPidPath();
   const format = opts.format ?? "text";
-  if (fs3.existsSync(pidPath)) {
-    const existingPid = parseInt(fs3.readFileSync(pidPath, "utf-8").trim(), 10);
+  if (fs4.existsSync(pidPath)) {
+    const existingPid = parseInt(fs4.readFileSync(pidPath, "utf-8").trim(), 10);
     if (!isNaN(existingPid) && isProcessAlive(existingPid)) {
       throw new CliError({
         code: "DAEMON_ALREADY_RUNNING",
@@ -4470,9 +4927,9 @@ async function startDaemon(opts) {
         }
       });
     }
-    fs3.unlinkSync(pidPath);
+    fs4.unlinkSync(pidPath);
   }
-  const cliPath = path2.resolve(new URL(import.meta.url).pathname);
+  const cliPath = path3.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);
@@ -4491,10 +4948,10 @@ async function startDaemon(opts) {
     });
   }
   const configDir = getConfigDir();
-  if (!fs3.existsSync(configDir)) {
-    fs3.mkdirSync(configDir, { recursive: true });
+  if (!fs4.existsSync(configDir)) {
+    fs4.mkdirSync(configDir, { recursive: true });
   }
-  fs3.writeFileSync(pidPath, String(child.pid), "utf-8");
+  fs4.writeFileSync(pidPath, String(child.pid), "utf-8");
   const port = opts.port ?? "4100";
   const host = opts.host ?? "127.0.0.1";
   if (format !== "json") {
@@ -4503,7 +4960,7 @@ async function startDaemon(opts) {
   const ready = await waitForReady(host, port);
   if (!ready) {
     try {
-      fs3.unlinkSync(pidPath);
+      fs4.unlinkSync(pidPath);
     } catch {
     }
     throw new CliError({
@@ -4535,7 +4992,7 @@ async function startDaemon(opts) {
 }
 function stopDaemon(format = "text") {
   const pidPath = getPidPath();
-  if (!fs3.existsSync(pidPath)) {
+  if (!fs4.existsSync(pidPath)) {
     if (format === "json") {
       console.log(JSON.stringify({
         stopped: false,
@@ -4546,7 +5003,7 @@ function stopDaemon(format = "text") {
     console.log("Canonry is not running (no PID file found)");
     return;
   }
-  const pid = parseInt(fs3.readFileSync(pidPath, "utf-8").trim(), 10);
+  const pid = parseInt(fs4.readFileSync(pidPath, "utf-8").trim(), 10);
   if (isNaN(pid)) {
     if (format === "json") {
       console.log(JSON.stringify({
@@ -4557,7 +5014,7 @@ function stopDaemon(format = "text") {
     } else {
       console.error("Invalid PID file. Removing it.");
     }
-    fs3.unlinkSync(pidPath);
+    fs4.unlinkSync(pidPath);
     return;
   }
   if (!isProcessAlive(pid)) {
@@ -4571,12 +5028,12 @@ function stopDaemon(format = "text") {
     } else {
       console.log(`Canonry is not running (stale PID: ${pid}). Cleaning up.`);
     }
-    fs3.unlinkSync(pidPath);
+    fs4.unlinkSync(pidPath);
     return;
   }
   try {
     process.kill(pid, "SIGTERM");
-    fs3.unlinkSync(pidPath);
+    fs4.unlinkSync(pidPath);
     if (format === "json") {
       console.log(JSON.stringify({
         stopped: true,
@@ -4600,9 +5057,9 @@ function stopDaemon(format = "text") {
 
 // src/commands/init.ts
 import crypto2 from "crypto";
-import fs4 from "fs";
+import fs5 from "fs";
 import readline from "readline";
-import path3 from "path";
+import path4 from "path";
 function prompt(question) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -4639,8 +5096,8 @@ async function initCommand(opts) {
     return;
   }
   const configDir = getConfigDir();
-  if (!fs4.existsSync(configDir)) {
-    fs4.mkdirSync(configDir, { recursive: true });
+  if (!fs5.existsSync(configDir)) {
+    fs5.mkdirSync(configDir, { recursive: true });
   }
   const bootstrapEnv = getBootstrapEnv(process.env, {
     GEMINI_API_KEY: opts?.geminiKey,
@@ -4755,7 +5212,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 = path3.join(configDir, "data.db");
+  const databasePath = path4.join(configDir, "data.db");
   const db = createClient(databasePath);
   migrate(db);
   db.insert(apiKeys).values({
@@ -5108,10 +5565,10 @@ var SYSTEM_CLI_COMMANDS = [
 ];
 
 // src/cli-commands/wordpress.ts
-import fs5 from "fs";
+import fs6 from "fs";
 
 // src/commands/wordpress.ts
-function getClient16() {
+function getClient17() {
   return createApiClient();
 }
 async function promptForAppPassword() {
@@ -5268,7 +5725,7 @@ async function wordpressConnect(project, opts) {
       details: { project }
     });
   }
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressConnect(project, {
     url: opts.url,
     stagingUrl: opts.stagingUrl,
@@ -5285,7 +5742,7 @@ async function wordpressConnect(project, opts) {
   printWordpressStatus(project, result);
 }
 async function wordpressDisconnect(project, format) {
-  const client = getClient16();
+  const client = getClient17();
   await client.wordpressDisconnect(project);
   if (format === "json") {
     printJson({ project, disconnected: true });
@@ -5294,7 +5751,7 @@ async function wordpressDisconnect(project, format) {
   console.log(`WordPress disconnected from project "${project}".`);
 }
 async function wordpressStatus(project, format) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressStatus(project);
   if (format === "json") {
     printJson(result);
@@ -5303,7 +5760,7 @@ async function wordpressStatus(project, format) {
   printWordpressStatus(project, result);
 }
 async function wordpressPages(project, opts) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressPages(project, opts.env);
   if (opts.format === "json") {
     printJson(result);
@@ -5312,7 +5769,7 @@ async function wordpressPages(project, opts) {
   printPages(project, result.env, result.pages);
 }
 async function wordpressPage(project, slug, opts) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressPage(project, slug, opts.env);
   if (opts.format === "json") {
     printJson(result);
@@ -5321,7 +5778,7 @@ async function wordpressPage(project, slug, opts) {
   printPageDetail(result);
 }
 async function wordpressCreatePage(project, body) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressCreatePage(project, body);
   if (body.format === "json") {
     printJson(result);
@@ -5332,7 +5789,7 @@ async function wordpressCreatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressUpdatePage(project, body) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressUpdatePage(project, body);
   if (body.format === "json") {
     printJson(result);
@@ -5343,7 +5800,7 @@ async function wordpressUpdatePage(project, body) {
   printPageDetail(result);
 }
 async function wordpressSetMeta(project, body) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressSetMeta(project, body);
   if (body.format === "json") {
     printJson(result);
@@ -5354,7 +5811,7 @@ async function wordpressSetMeta(project, body) {
   printPageDetail(result);
 }
 async function wordpressSchema(project, slug, opts) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressSchema(project, slug, opts.env);
   if (opts.format === "json") {
     printJson(result);
@@ -5365,7 +5822,7 @@ async function wordpressSchema(project, slug, opts) {
   printSchemaBlocks(result.blocks);
 }
 async function wordpressSetSchema(project, body) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressSetSchema(project, body);
   if (body.format === "json") {
     printJson(result);
@@ -5374,7 +5831,7 @@ async function wordpressSetSchema(project, body) {
   printManualAssist(`Schema update for "${body.slug}"`, result);
 }
 async function wordpressLlmsTxt(project, opts) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressLlmsTxt(project, opts.env);
   if (opts.format === "json") {
     printJson(result);
@@ -5385,7 +5842,7 @@ async function wordpressLlmsTxt(project, opts) {
   console.log(result.content ?? "(not found)");
 }
 async function wordpressSetLlmsTxt(project, body) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressSetLlmsTxt(project, body);
   if (body.format === "json") {
     printJson(result);
@@ -5394,7 +5851,7 @@ async function wordpressSetLlmsTxt(project, body) {
   printManualAssist(`llms.txt update for "${project}"`, result);
 }
 async function wordpressAudit(project, opts) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressAudit(project, opts.env);
   if (opts.format === "json") {
     printJson(result);
@@ -5408,7 +5865,7 @@ async function wordpressAudit(project, opts) {
   printAuditIssues(result.issues);
 }
 async function wordpressDiff(project, slug, format) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressDiff(project, slug);
   if (format === "json") {
     printJson(result);
@@ -5417,7 +5874,7 @@ async function wordpressDiff(project, slug, format) {
   printDiff(result);
 }
 async function wordpressStagingStatus(project, format) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressStagingStatus(project);
   if (format === "json") {
     printJson(result);
@@ -5431,7 +5888,7 @@ async function wordpressStagingStatus(project, format) {
   console.log(`  Admin URL:         ${result.adminUrl}`);
 }
 async function wordpressStagingPush(project, format) {
-  const client = getClient16();
+  const client = getClient17();
   const result = await client.wordpressStagingPush(project);
   if (format === "json") {
     printJson(result);
@@ -5478,7 +5935,7 @@ function resolveContent(input, command, usage, options) {
   }
   if (contentFile) {
     try {
-      return fs5.readFileSync(contentFile, "utf-8");
+      return fs6.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}`, {
@@ -5831,6 +6288,7 @@ var REGISTERED_CLI_COMMANDS = [
   ...KEYWORD_CLI_COMMANDS,
   ...COMPETITOR_CLI_COMMANDS,
   ...SETTINGS_CLI_COMMANDS,
+  ...SNAPSHOT_CLI_COMMANDS,
   ...RUN_CLI_COMMANDS,
   ...OPERATOR_CLI_COMMANDS,
   ...SCHEDULE_CLI_COMMANDS,
@@ -5870,6 +6328,7 @@ Usage:
   canonry keyword generate <project>  Auto-generate key phrases (--provider, --count, --save)
   canonry competitor add <project> <domain>  Add competitors
   canonry competitor list <project>   List competitors
+  canonry snapshot <company> --domain <domain>  One-shot AI perception report
   canonry run <project>               Trigger a run (all providers)
   canonry run <project> --provider <name>  Trigger a run for a specific provider
   canonry run <project> --location <label> Run with a specific location
@@ -5971,6 +6430,9 @@ Options:
   --language <lang>    Language code (default: en)
   --provider <name>    Provider to use (gemini, openai, claude, perplexity, local, cdp:chatgpt, or cdp for all CDP targets)
   --format <fmt>       Output format: text (default) or json
+  --phrases <list>     Comma-separated category queries (snapshot)
+  --competitors <list> Comma-separated competitor hints (snapshot)
+  --pdf <path>         Write a PDF snapshot report to a file
   --location <label>   Run with a specific configured location
   --all-locations      Run for every configured location
   --no-location        Explicitly skip location context