@ainyc/canonry 1.29.0 → 1.31.0

package/dist/cli.js

@@ -21,7 +21,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-IWUQVYU3.js";
+} from "./chunk-YW4IZ34Z.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -510,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);
@@ -518,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}`);
@@ -1342,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}`);
 }
@@ -1355,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;
   }
@@ -1365,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(`
@@ -3762,11 +3792,10 @@ function printRunDetail(run) {
   if (run.finishedAt) console.log(`  Finished: ${run.finishedAt}`);
   if (run.createdAt) console.log(`  Created:  ${run.createdAt}`);
   if (run.error) console.log(`  Error:    ${run.error}`);
-  const snapshots = run.snapshots;
-  if (snapshots && snapshots.length > 0) {
+  if (run.snapshots && run.snapshots.length > 0) {
     console.log(`
-  Snapshots: ${snapshots.length}`);
-    for (const s of snapshots) {
+  Snapshots: ${run.snapshots.length}`);
+    for (const s of run.snapshots) {
       const state = s.citationState === "cited" ? "  cited    " : "  not-cited";
       const modelLabel = s.model ? ` (${s.model})` : "";
       console.log(`    ${state}  ${s.provider}${modelLabel}  ${s.keyword}`);
@@ -5810,6 +5839,88 @@ 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 = getClient17();
   const result = await client.wordpressSchema(project, slug, opts.env);
@@ -5830,6 +5941,168 @@ 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 = getClient17();
   const result = await client.wordpressLlmsTxt(project, opts.env);
@@ -6107,15 +6380,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, {
@@ -6133,6 +6418,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]",
@@ -6214,6 +6534,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]",
@@ -6392,8 +6751,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

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createServer,
   loadConfig
-} from "./chunk-IWUQVYU3.js";
+} from "./chunk-YW4IZ34Z.js";
 export {
   createServer,
   loadConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "1.29.0",
+  "version": "1.31.0",
   "type": "module",
   "description": "The ultimate open-source AEO monitoring tool - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -54,19 +54,19 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-google": "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-gemini": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0"
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsup && tsx build-web.ts",