@ainyc/canonry 2.4.5 → 2.4.6

package/README.md

@@ -166,7 +166,17 @@ Integration setup guides: [Google Search Console](docs/google-search-console-set
 
 ## Skills
 
-Canonry ships a bundled `canonry-setup` skill that documents the CLI commands, provider setup, analysis workflows, and troubleshooting patterns an agent needs to operate the platform. **Claude Code** picks up the skill automatically from `.claude/skills/canonry-setup/` when you open this repo.
+Canonry ships a bundled `canonry-setup` skill that turns Aero (or any Claude-powered agent) into an AEO/SEO operator. **Claude Code** picks it up automatically from `.claude/skills/canonry-setup/` when you open this repo; the same content lives under [`skills/canonry-setup/`](skills/canonry-setup/) for portable use with other harnesses.
+
+The skill covers the end-to-end answer-engine optimization loop:
+
+- **AEO monitoring.** Running citation sweeps across Gemini, ChatGPT, Claude, and Perplexity via `canonry run` / `canonry evidence` / `canonry status`, including how to interpret per-phrase citation state and regressions.
+- **Technical SEO audits.** Driving the companion [`@ainyc/aeo-audit`](https://www.npmjs.com/package/@ainyc/aeo-audit) CLI for 14-factor scoring — structured data (JSON-LD), content depth, AI-readable files (`llms.txt`, `llms-full.txt`), E-E-A-T signals, FAQ blocks, definition blocks, H1/alt/meta hygiene.
+- **Indexing diagnosis.** Google Search Console and Bing Webmaster Tools coverage, URL inspection, and one-shot submissions via `canonry google request-indexing` / `canonry bing request-indexing`.
+- **Schema & content execution.** Patterns for injecting LocalBusiness/FAQPage JSON-LD, writing `llms.txt` with service-area detail, trimming keyphrase lists to high-intent queries, and handling WordPress/Elementor specifics (REST API, Application Passwords, Elementor Custom Code).
+- **Diagnose → prioritize → execute → monitor → report workflow.** Opinionated defaults for new sites (0 citations), regressions on established sites, and county-level targeting — with guardrails like "never fabricate citation data" and "back up `~/.canonry/config.yaml` before editing".
+
+See [`skills/canonry-setup/SKILL.md`](skills/canonry-setup/SKILL.md) plus the reference files under [`skills/canonry-setup/references/`](skills/canonry-setup/references/) (`canonry-cli.md`, `aeo-analysis.md`, `indexing.md`, `wordpress-integration.md`) for the full playbook. Aero loads the same material natively, so anything an external agent can do through the skill, Aero can do from the CLI or dashboard command bar.
 
 ## Deployment
 

package/dist/cli.js

@@ -2181,6 +2181,7 @@ var COMPETITOR_CLI_COMMANDS = [
 ];
 
 // src/commands/google.ts
+var INDEXING_API_SCOPE_NOTICE = "Note: Google's Indexing API officially supports only pages with JobPosting or BroadcastEvent (livestream VideoObject) structured data. For other URL types, submissions are accepted (HTTP 200) but not guaranteed to be prioritized for crawling. For general pages, submit a sitemap and use URL Inspection to monitor status.";
 function getClient6() {
   return createApiClient();
 }
@@ -2630,27 +2631,32 @@ async function googleRequestIndexing(project, opts) {
       details: { command: "google.request-indexing" }
     });
   }
+  if (opts.format !== "json") {
+    console.error(INDEXING_API_SCOPE_NOTICE);
+    console.error();
+  }
   const result = await client.googleRequestIndexing(project, body);
   let indexingConfirmed = false;
+  const lastInspection = /* @__PURE__ */ new Map();
   if (opts.wait && result.results.some((r) => r.status === "success")) {
     const successUrls = result.results.filter((r) => r.status === "success").map((r) => r.url);
-    const timeout = 10 * 60 * 1e3;
+    const timeout = opts.waitTimeoutMs ?? 10 * 60 * 1e3;
+    const pollInterval = opts.waitPollIntervalMs ?? 1e4;
     const start = Date.now();
-    process.stderr.write("Waiting for indexing confirmation");
+    process.stderr.write("Polling URL Inspection for indexed verdict");
     while (Date.now() - start < timeout) {
-      await new Promise((r) => setTimeout(r, 1e4));
+      await new Promise((r) => setTimeout(r, pollInterval));
       process.stderr.write(".");
       let allIndexed = true;
       for (const url of successUrls) {
         try {
           const inspection = await client.gscInspect(project, url);
-          if (inspection.indexingState !== "INDEXING_ALLOWED") {
+          lastInspection.set(url, inspection);
+          if (inspection.verdict !== "PASS") {
             allIndexed = false;
-            break;
           }
         } catch {
           allIndexed = false;
-          break;
         }
       }
       if (allIndexed) {
@@ -2661,13 +2667,23 @@ async function googleRequestIndexing(project, opts) {
     }
     if (!indexingConfirmed) {
       process.stderr.write("\n");
+      const observed = successUrls.map((url) => {
+        const i = lastInspection.get(url);
+        return {
+          url,
+          verdict: i?.verdict ?? null,
+          coverageState: i?.coverageState ?? null,
+          indexingState: i?.indexingState ?? null
+        };
+      });
       throw new CliError({
         code: "GOOGLE_INDEXING_CONFIRMATION_TIMEOUT",
-        message: "Timed out waiting for indexing confirmation. URLs may still be processing.",
-        displayMessage: "Timed out waiting for indexing confirmation. URLs may still be processing.",
+        message: "Timed out waiting for Google to report verdict=PASS. Google typically takes hours to days to index new URLs, so this is expected and does not mean the submission failed. Re-check later with `canonry google gsc inspect <url>`.",
+        displayMessage: "Timed out waiting for Google to report verdict=PASS. Google typically takes hours to days to index new URLs \u2014 this is not a failure. Re-check later with `canonry google gsc inspect <url>`.",
         details: {
           project,
-          urls: successUrls
+          urls: successUrls,
+          lastObserved: observed
         }
       });
     }
@@ -2692,7 +2708,7 @@ async function googleRequestIndexing(project, opts) {
     console.log(`Summary: ${result.summary.succeeded} succeeded, ${result.summary.failed} failed (${result.summary.total} total)`);
   }
   if (indexingConfirmed) {
-    console.log("All requested URLs are now indexed.");
+    console.log("URL Inspection now reports verdict=PASS for the requested URLs (indexed in Google Search).");
   }
 }
 async function googleRefresh(project, format) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "2.4.5",
+  "version": "2.4.6",
   "type": "module",
   "description": "The ultimate open-source AEO monitoring tool - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -57,21 +57,21 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0"
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",