@ainyc/canonry 1.28.2 → 1.30.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-GF5TI2U2.js";
+} from "./chunk-LMSO32GF.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);
   }
@@ -506,6 +510,9 @@ var ApiClient = class {
   async wordpressSetMeta(project, body) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/page/meta`, body);
   }
+  async wordpressBulkSetMeta(project, body) {
+    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/pages/meta/bulk`, body);
+  }
   async wordpressSchema(project, slug, env) {
     const params = new URLSearchParams({ slug });
     if (env) params.set("env", env);
@@ -514,6 +521,18 @@ var ApiClient = class {
   async wordpressSetSchema(project, body) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/schema/manual`, body);
   }
+  async wordpressSchemaDeploy(project, body) {
+    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/schema/deploy`, body);
+  }
+  async wordpressSchemaStatus(project, env) {
+    const params = new URLSearchParams();
+    if (env) params.set("env", env);
+    const qs = params.toString();
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/schema/status${qs ? `?${qs}` : ""}`);
+  }
+  async wordpressOnboard(project, body) {
+    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/onboard`, body);
+  }
   async wordpressLlmsTxt(project, env) {
     const qs = env ? `?env=${encodeURIComponent(env)}` : "";
     return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/llms-txt${qs}`);
@@ -1275,9 +1294,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) {
@@ -1338,7 +1357,8 @@ async function gaSync(project, opts) {
     return;
   }
   console.log(`GA4 sync complete for "${project}".`);
-  console.log(`  Rows synced: ${result.rowCount}`);
+  console.log(`  Page rows:   ${result.rowCount}`);
+  console.log(`  AI rows:     ${result.aiReferralCount}`);
   console.log(`  Period:      ${result.days} days`);
   console.log(`  Synced at:   ${result.syncedAt}`);
 }
@@ -1351,7 +1371,7 @@ async function gaTraffic(project, opts) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  if (result.topPages.length === 0) {
+  if (result.topPages.length === 0 && result.aiReferrals.length === 0) {
     console.log('No GA4 traffic data. Run "canonry ga sync <project>" first.');
     return;
   }
@@ -1361,14 +1381,28 @@ async function gaTraffic(project, opts) {
   console.log(`  Organic Sessions:        ${result.totalOrganicSessions}`);
   console.log(`  Total Users:             ${result.totalUsers}`);
   console.log();
-  const pageWidth = Math.min(60, Math.max(15, ...result.topPages.map((r) => r.landingPage.length)));
-  console.log(`  ${"LANDING PAGE".padEnd(pageWidth)}  ${"SESSIONS".padEnd(10)}${"ORGANIC".padEnd(10)}${"USERS".padEnd(8)}`);
-  console.log(`  ${"\u2500".repeat(pageWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(10)}${"\u2500".repeat(8)}`);
-  for (const row of result.topPages) {
-    const page = row.landingPage.length > pageWidth ? row.landingPage.slice(0, pageWidth - 3) + "..." : row.landingPage;
-    console.log(
-      `  ${page.padEnd(pageWidth)}  ${String(row.sessions).padEnd(10)}${String(row.organicSessions).padEnd(10)}${String(row.users).padEnd(8)}`
-    );
+  if (result.aiReferrals.length > 0) {
+    console.log("  AI REFERRAL SOURCES");
+    console.log(`  ${"SOURCE".padEnd(25)}  ${"MEDIUM".padEnd(15)}  ${"SESSIONS".padEnd(10)}${"USERS".padEnd(8)}`);
+    console.log(`  ${"\u2500".repeat(25)}  ${"\u2500".repeat(15)}  ${"\u2500".repeat(10)}${"\u2500".repeat(8)}`);
+    for (const ref of result.aiReferrals) {
+      console.log(
+        `  ${ref.source.padEnd(25)}  ${ref.medium.padEnd(15)}  ${String(ref.sessions).padEnd(10)}${String(ref.users).padEnd(8)}`
+      );
+    }
+    console.log();
+  }
+  if (result.topPages.length > 0) {
+    const pageWidth = Math.min(60, Math.max(15, ...result.topPages.map((r) => r.landingPage.length)));
+    console.log(`  TOP LANDING PAGES`);
+    console.log(`  ${"PAGE".padEnd(pageWidth)}  ${"SESSIONS".padEnd(10)}${"ORGANIC".padEnd(10)}${"USERS".padEnd(8)}`);
+    console.log(`  ${"\u2500".repeat(pageWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(10)}${"\u2500".repeat(8)}`);
+    for (const row of result.topPages) {
+      const page = row.landingPage.length > pageWidth ? row.landingPage.slice(0, pageWidth - 3) + "..." : row.landingPage;
+      console.log(
+        `  ${page.padEnd(pageWidth)}  ${String(row.sessions).padEnd(10)}${String(row.organicSessions).padEnd(10)}${String(row.users).padEnd(8)}`
+      );
+    }
   }
   if (result.lastSyncedAt) {
     console.log(`
@@ -4212,9 +4246,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 +4847,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 +4915,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 +4945,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 +4957,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 +4978,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 +4990,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 +5022,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 +5033,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 +5044,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 +5058,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 +5087,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 +5126,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 +5242,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 +5595,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 +5755,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 +5772,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 +5781,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 +5790,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 +5799,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 +5808,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 +5819,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 +5830,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);
@@ -5353,8 +5840,90 @@ 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);
+  let raw;
+  try {
+    raw = await fs7.readFile(filePath, "utf8");
+  } catch {
+    throw new CliError({
+      code: "FILE_READ_ERROR",
+      message: `Cannot read file: ${filePath}`,
+      displayMessage: `Error: cannot read file "${opts.from}". Check the path and permissions.`,
+      details: { path: filePath }
+    });
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new CliError({
+      code: "INVALID_JSON",
+      message: `File is not valid JSON: ${filePath}`,
+      displayMessage: `Error: "${opts.from}" is not valid JSON.`,
+      details: { path: filePath }
+    });
+  }
+  const entries = Object.entries(parsed).map(([slug, meta]) => ({
+    slug,
+    title: meta.title,
+    description: meta.description,
+    noindex: meta.noindex
+  }));
+  if (entries.length === 0) {
+    throw new CliError({
+      code: "EMPTY_META_FILE",
+      message: "Meta file contains no entries",
+      displayMessage: `Error: "${opts.from}" contains no entries. Expected JSON object keyed by slug.`,
+      details: { path: filePath }
+    });
+  }
+  const client = getClient17();
+  const result = await client.wordpressBulkSetMeta(project, { entries, env: opts.env });
+  if (opts.format === "json") {
+    printJson(result);
+    return;
+  }
+  const applied = result.results.filter((r) => r.status === "applied");
+  const skipped = result.results.filter((r) => r.status === "skipped");
+  const manual = result.results.filter((r) => r.status === "manual");
+  console.log(`Bulk SEO meta update (${result.env}, strategy: ${result.strategy}):
+`);
+  if (applied.length > 0) {
+    console.log(`  Applied (${applied.length}):`);
+    for (const r of applied) {
+      console.log(`    ${r.slug}`);
+    }
+  }
+  if (skipped.length > 0) {
+    console.log(`
+  Skipped (${skipped.length}):`);
+    for (const r of skipped) {
+      console.log(`    ${r.slug}: ${r.error ?? "unknown reason"}`);
+    }
+  }
+  if (manual.length > 0) {
+    console.log(`
+  Manual action required (${manual.length}):`);
+    console.log("  No SEO plugin with REST-writable meta fields was detected.");
+    console.log("  Install Yoast SEO, Rank Math, or AIOSEO, or update these pages manually:\n");
+    for (const r of manual) {
+      if (r.manualAssist) {
+        console.log(`    ${r.slug}:`);
+        console.log(`      Admin: ${r.manualAssist.adminUrl ?? "-"}`);
+        console.log(`      Values: ${r.manualAssist.content}`);
+      } else {
+        console.log(`    ${r.slug}`);
+      }
+    }
+  }
+  console.log(`
+Total: ${applied.length} applied, ${skipped.length} skipped, ${manual.length} manual`);
+}
 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 +5934,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);
@@ -5373,8 +5942,170 @@ 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 yaml = await import("yaml").catch(() => null);
+  const filePath = path5.resolve(opts.profile);
+  let raw;
+  try {
+    raw = await fs7.readFile(filePath, "utf8");
+  } catch {
+    throw new CliError({
+      code: "FILE_READ_ERROR",
+      message: `Cannot read file: ${filePath}`,
+      displayMessage: `Error: cannot read file "${opts.profile}". Check the path and permissions.`,
+      details: { path: filePath }
+    });
+  }
+  let parsed;
+  try {
+    if (yaml?.parse) {
+      parsed = yaml.parse(raw);
+    } else {
+      parsed = JSON.parse(raw);
+    }
+  } catch {
+    throw new CliError({
+      code: "INVALID_PROFILE",
+      message: `File is not valid YAML or JSON: ${filePath}`,
+      displayMessage: `Error: "${opts.profile}" is not valid YAML or JSON.`,
+      details: { path: filePath }
+    });
+  }
+  const profile = parsed;
+  if (!profile?.business?.name || !profile?.pages || Object.keys(profile.pages).length === 0) {
+    throw new CliError({
+      code: "INVALID_PROFILE",
+      message: "Profile must have business.name and non-empty pages",
+      displayMessage: "Error: profile file must contain business.name and at least one page entry.",
+      details: { path: filePath }
+    });
+  }
+  const client = getClient17();
+  const result = await client.wordpressSchemaDeploy(project, { profile: parsed, env: opts.env });
+  if (opts.format === "json") {
+    printJson(result);
+    return;
+  }
+  console.log(`Schema deploy (${result.env}):
+`);
+  for (const r of result.results) {
+    const types = r.schemasInjected?.join(", ") ?? "";
+    switch (r.status) {
+      case "deployed":
+        console.log(`  ${r.slug}: deployed (${types})`);
+        break;
+      case "stripped":
+        console.log(`  ${r.slug}: STRIPPED \u2014 WordPress removed <script> tags. Manual action required.`);
+        if (r.manualAssist) {
+          console.log(`    Admin: ${r.manualAssist.adminUrl ?? "-"}`);
+          for (const step of r.manualAssist.nextSteps) {
+            console.log(`    - ${step}`);
+          }
+        }
+        break;
+      case "skipped":
+        console.log(`  ${r.slug}: skipped \u2014 ${r.error ?? "unknown"}`);
+        break;
+      case "failed":
+        console.log(`  ${r.slug}: FAILED \u2014 ${r.error ?? "unknown"}`);
+        break;
+    }
+  }
+  const deployed = result.results.filter((r) => r.status === "deployed").length;
+  const stripped = result.results.filter((r) => r.status === "stripped").length;
+  const skipped = result.results.filter((r) => r.status === "skipped").length;
+  const failed = result.results.filter((r) => r.status === "failed").length;
+  console.log(`
+Total: ${deployed} deployed, ${stripped} stripped, ${skipped} skipped, ${failed} failed`);
+}
+async function wordpressSchemaStatus(project, opts) {
+  const client = getClient17();
+  const result = await client.wordpressSchemaStatus(project, opts.env);
+  if (opts.format === "json") {
+    printJson(result);
+    return;
+  }
+  console.log(`Schema status (${result.env}):
+`);
+  if (result.pages.length === 0) {
+    console.log("  No pages found.");
+    return;
+  }
+  const slugWidth = Math.max(4, ...result.pages.map((p) => p.slug.length));
+  console.log(`  ${"SLUG".padEnd(slugWidth)}  CANONRY           THIRD-PARTY`);
+  console.log(`  ${"\u2500".repeat(slugWidth)}  ${"\u2500".repeat(17)}  ${"\u2500".repeat(20)}`);
+  for (const page of result.pages) {
+    const canonry = page.canonrySchemas.length > 0 ? page.canonrySchemas.join(", ") : "-";
+    const thirdParty = page.thirdPartySchemas.length > 0 ? page.thirdPartySchemas.join(", ") : "-";
+    console.log(`  ${page.slug.padEnd(slugWidth)}  ${canonry.padEnd(17)}  ${thirdParty}`);
+  }
+}
+async function wordpressOnboard(project, opts) {
+  const appPassword = opts.appPassword ?? await promptForAppPassword();
+  if (!appPassword) {
+    throw new CliError({
+      code: "WORDPRESS_APP_PASSWORD_REQUIRED",
+      message: "WordPress Application Password is required",
+      displayMessage: "Error: WordPress Application Password is required (pass --app-password or enter interactively).",
+      details: { project }
+    });
+  }
+  let profileData;
+  if (opts.profile) {
+    const fs7 = await import("fs/promises");
+    const path5 = await import("path");
+    const yaml = await import("yaml").catch(() => null);
+    const filePath = path5.resolve(opts.profile);
+    let raw;
+    try {
+      raw = await fs7.readFile(filePath, "utf8");
+    } catch {
+      throw new CliError({
+        code: "FILE_READ_ERROR",
+        message: `Cannot read file: ${filePath}`,
+        displayMessage: `Error: cannot read file "${opts.profile}".`,
+        details: { path: filePath }
+      });
+    }
+    try {
+      profileData = yaml?.parse ? yaml.parse(raw) : JSON.parse(raw);
+    } catch {
+      throw new CliError({
+        code: "INVALID_PROFILE",
+        message: `File is not valid YAML or JSON: ${filePath}`,
+        displayMessage: `Error: "${opts.profile}" is not valid YAML or JSON.`,
+        details: { path: filePath }
+      });
+    }
+  }
+  const client = getClient17();
+  const result = await client.wordpressOnboard(project, {
+    url: opts.url,
+    username: opts.user,
+    appPassword,
+    stagingUrl: opts.stagingUrl,
+    defaultEnv: opts.defaultEnv,
+    profile: profileData,
+    skipSchema: opts.skipSchema,
+    skipSubmit: opts.skipSubmit
+  });
+  if (opts.format === "json") {
+    printJson(result);
+    return;
+  }
+  console.log(`WordPress onboarding for "${project}":
+`);
+  for (const step of result.steps) {
+    const icon = step.status === "completed" ? "+" : step.status === "skipped" ? "-" : "x";
+    console.log(`  [${icon}] ${step.name}: ${step.status}`);
+    if (step.summary) console.log(`      ${step.summary}`);
+    if (step.error) console.log(`      Error: ${step.error}`);
+  }
+}
 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 +6116,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 +6125,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 +6139,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 +6148,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 +6162,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 +6209,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}`, {
@@ -5650,15 +6381,27 @@ var WORDPRESS_CLI_COMMANDS = [
   },
   {
     path: ["wordpress", "set-meta"],
-    usage: "canonry wordpress set-meta <project> <slug> [--title <title>] [--description <text>] [--noindex|--index] [--live|--staging] [--format json]",
+    usage: "canonry wordpress set-meta <project> <slug> [--title <title>] [--description <text>] [--noindex|--index] [--from <file>] [--live|--staging] [--format json]",
     options: {
       title: stringOption(),
       description: stringOption(),
       noindex: { type: "boolean", default: false },
       index: { type: "boolean", default: false },
+      from: stringOption(),
       ...envOptions
     },
     run: async (input) => {
+      const fromFile = getString(input.values, "from");
+      if (fromFile) {
+        const usage2 = "canonry wordpress set-meta <project> --from <file> [--live|--staging] [--format json]";
+        const project2 = requireProject(input, "wordpress.set-meta", usage2);
+        await wordpressBulkSetMeta(project2, {
+          from: fromFile,
+          env: resolveEnv(input, "wordpress.set-meta", usage2),
+          format: input.format
+        });
+        return;
+      }
       const usage = "canonry wordpress set-meta <project> <slug> [--title <title>] [--description <text>] [--noindex|--index] [--live|--staging] [--format json]";
       const project = requireProject(input, "wordpress.set-meta", usage);
       const slug = requirePositional(input, 1, {
@@ -5676,6 +6419,41 @@ var WORDPRESS_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["wordpress", "schema", "deploy"],
+    usage: "canonry wordpress schema deploy <project> --profile <file> [--live|--staging] [--format json]",
+    options: {
+      profile: stringOption(),
+      ...envOptions
+    },
+    run: async (input) => {
+      const usage = "canonry wordpress schema deploy <project> --profile <file> [--live|--staging] [--format json]";
+      const project = requireProject(input, "wordpress.schema.deploy", usage);
+      const profile = requireStringOption(input, "profile", {
+        message: "--profile is required",
+        command: "wordpress.schema.deploy",
+        usage
+      });
+      await wordpressSchemaDeploy(project, {
+        profile,
+        env: resolveEnv(input, "wordpress.schema.deploy", usage),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["wordpress", "schema", "status"],
+    usage: "canonry wordpress schema status <project> [--live|--staging] [--format json]",
+    options: envOptions,
+    run: async (input) => {
+      const usage = "canonry wordpress schema status <project> [--live|--staging] [--format json]";
+      const project = requireProject(input, "wordpress.schema.status", usage);
+      await wordpressSchemaStatus(project, {
+        env: resolveEnv(input, "wordpress.schema.status", usage),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["wordpress", "schema"],
     usage: "canonry wordpress schema <project> <slug> [--live|--staging] [--format json]",
@@ -5757,6 +6535,45 @@ var WORDPRESS_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["wordpress", "onboard"],
+    usage: "canonry wordpress onboard <project> --url <url> --user <user> [--app-password <pw>] [--profile <file>] [--skip-schema] [--skip-submit] [--live|--staging] [--format json]",
+    options: {
+      url: stringOption(),
+      user: stringOption(),
+      "app-password": stringOption(),
+      "staging-url": stringOption(),
+      profile: stringOption(),
+      "skip-schema": { type: "boolean", default: false },
+      "skip-submit": { type: "boolean", default: false },
+      ...envOptions
+    },
+    run: async (input) => {
+      const usage = "canonry wordpress onboard <project> --url <url> --user <user> [--app-password <pw>] [--profile <file>] [--format json]";
+      const project = requireProject(input, "wordpress.onboard", usage);
+      const url = requireStringOption(input, "url", {
+        message: "--url is required",
+        command: "wordpress.onboard",
+        usage
+      });
+      const user = requireStringOption(input, "user", {
+        message: "--user is required",
+        command: "wordpress.onboard",
+        usage
+      });
+      await wordpressOnboard(project, {
+        url,
+        user,
+        appPassword: getString(input.values, "app-password"),
+        stagingUrl: getString(input.values, "staging-url"),
+        defaultEnv: resolveEnv(input, "wordpress.onboard", usage),
+        profile: getString(input.values, "profile"),
+        skipSchema: getBoolean(input.values, "skip-schema"),
+        skipSubmit: getBoolean(input.values, "skip-submit"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["wordpress", "audit"],
     usage: "canonry wordpress audit <project> [--live|--staging] [--format json]",
@@ -5831,6 +6648,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 +6688,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
@@ -5933,8 +6752,12 @@ Usage:
   canonry wordpress create-page <project>  Create a WordPress page (--title, --slug, --content/--content-file)
   canonry wordpress update-page <project> <slug>  Update a WordPress page (--content/--content-file)
   canonry wordpress set-meta <project> <slug>  Update REST-exposed SEO meta
+  canonry wordpress set-meta <project> --from <file>  Bulk update SEO meta from JSON file
   canonry wordpress schema <project> <slug>  Read rendered JSON-LD schema
+  canonry wordpress schema deploy <project> --profile <file>  Deploy JSON-LD schema to pages
+  canonry wordpress schema status <project>  Show schema status per page
   canonry wordpress set-schema <project> <slug>  Generate manual schema handoff
+  canonry wordpress onboard <project> --url <url> --user <user>  Full onboarding workflow
   canonry wordpress llms-txt <project>  Read /llms.txt
   canonry wordpress set-llms-txt <project>  Generate manual llms.txt handoff
   canonry wordpress audit <project>  Audit WordPress pages for SEO/content issues
@@ -5971,6 +6794,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