@ainyc/canonry 1.12.0 → 1.13.3

package/dist/cli.js

@@ -19,7 +19,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-O4HLQBL7.js";
+} from "./chunk-JKIWFSYI.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -319,7 +319,7 @@ async function initCommand(opts) {
     createdAt: (/* @__PURE__ */ new Date()).toISOString()
   }).run();
   saveConfig({
-    apiUrl: "http://localhost:4100",
+    apiUrl: `http://localhost:${process.env.CANONRY_PORT || "4100"}`,
     database: databasePath,
     apiKey: rawApiKey,
     providers,
@@ -344,6 +344,7 @@ async function serveCommand() {
   const config = loadConfig();
   const port = parseInt(process.env.CANONRY_PORT ?? "4100", 10);
   const host = process.env.CANONRY_HOST ?? "127.0.0.1";
+  config.port = port;
   const db = createClient(config.database);
   migrate(db);
   const app = await createServer({ config, db });
@@ -476,16 +477,17 @@ var ApiClient = class {
   }
   async request(method, path4, body) {
     const url = `${this.baseUrl}${path4}`;
+    const serializedBody = body != null ? JSON.stringify(body) : void 0;
     const headers = {
       "Authorization": `Bearer ${this.apiKey}`,
-      "Content-Type": "application/json"
+      ...serializedBody != null ? { "Content-Type": "application/json" } : {}
     };
     let res;
     try {
       res = await fetch(url, {
         method,
         headers,
-        body: body != null ? JSON.stringify(body) : void 0
+        body: serializedBody
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -529,6 +531,9 @@ var ApiClient = class {
   async listKeywords(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/keywords`);
   }
+  async deleteKeywords(project, keywords) {
+    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/keywords`, { keywords });
+  }
   async appendKeywords(project, keywords) {
     await this.request("POST", `/projects/${encodeURIComponent(project)}/keywords`, { keywords });
   }
@@ -589,6 +594,18 @@ var ApiClient = class {
   async testNotification(project, id) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/notifications/${encodeURIComponent(id)}/test`);
   }
+  async addLocation(project, body) {
+    return this.request("POST", `/projects/${encodeURIComponent(project)}/locations`, body);
+  }
+  async listLocations(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/locations`);
+  }
+  async removeLocation(project, label) {
+    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/locations/${encodeURIComponent(label)}`);
+  }
+  async setDefaultLocation(project, label) {
+    return this.request("PUT", `/projects/${encodeURIComponent(project)}/locations/default`, { label });
+  }
   async getTelemetry() {
     return this.request("GET", "/telemetry");
   }
@@ -636,6 +653,16 @@ var ApiClient = class {
   async gscDeindexed(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/deindexed`);
   }
+  async gscCoverage(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/coverage`);
+  }
+  async gscCoverageHistory(project, params) {
+    const qs = params?.limit != null ? `?limit=${params.limit}` : "";
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/coverage/history${qs}`);
+  }
+  async gscInspectSitemap(project, body) {
+    return this.request("POST", `/projects/${encodeURIComponent(project)}/google/gsc/inspect-sitemap`, body ?? {});
+  }
 };
 
 // src/commands/project.ts
@@ -734,6 +761,47 @@ async function deleteProject(name) {
   await client.deleteProject(name);
   console.log(`Project deleted: ${name}`);
 }
+async function addLocation(project, opts) {
+  const client = getClient();
+  await client.addLocation(project, opts);
+  console.log(`Location added: ${opts.label} (${opts.city}, ${opts.region}, ${opts.country})`);
+}
+async function listLocations(project, format) {
+  const client = getClient();
+  const result = await client.listLocations(project);
+  if (format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  if (result.locations.length === 0) {
+    console.log(`No locations configured for "${project}".`);
+    return;
+  }
+  console.log(`Locations for "${project}" (${result.locations.length}):
+`);
+  console.log("  LABEL            CITY                 REGION               COUNTRY  DEFAULT");
+  console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  for (const loc of result.locations) {
+    const isDefault = loc.label === result.defaultLocation ? "  *" : "";
+    console.log(
+      `  ${loc.label.padEnd(15)}  ${loc.city.padEnd(19)}  ${loc.region.padEnd(19)}  ${loc.country.padEnd(7)}${isDefault}`
+    );
+  }
+  if (result.defaultLocation) {
+    console.log(`
+  Default: ${result.defaultLocation}`);
+  }
+}
+async function removeLocation(project, label) {
+  const client = getClient();
+  await client.removeLocation(project, label);
+  console.log(`Location removed: ${label}`);
+}
+async function setDefaultLocation(project, label) {
+  const client = getClient();
+  await client.setDefaultLocation(project, label);
+  console.log(`Default location set to: ${label}`);
+}
 
 // src/commands/keyword.ts
 import fs3 from "fs";
@@ -746,6 +814,14 @@ async function addKeywords(project, keywords) {
   await client.appendKeywords(project, keywords);
   console.log(`Added ${keywords.length} key phrase(s) to "${project}".`);
 }
+async function removeKeywords(project, keywords) {
+  const client = getClient2();
+  const existing = await client.listKeywords(project);
+  const existingSet = new Set(existing.map((k) => k.keyword));
+  const actuallyDeleted = keywords.filter((k) => existingSet.has(k)).length;
+  await client.deleteKeywords(project, keywords);
+  console.log(`Removed ${actuallyDeleted} key phrase(s) from "${project}".`);
+}
 async function listKeywords(project, format) {
   const client = getClient2();
   const kws = await client.listKeywords(project);
@@ -838,7 +914,63 @@ async function triggerRun(project, opts) {
   if (opts?.provider) {
     body.providers = [opts.provider];
   }
-  const run = await client.triggerRun(project, body);
+  if (opts?.location) {
+    body.location = opts.location;
+  }
+  if (opts?.allLocations) {
+    body.allLocations = true;
+  }
+  if (opts?.noLocation) {
+    body.noLocation = true;
+  }
+  const response = await client.triggerRun(project, body);
+  if (Array.isArray(response)) {
+    const locationRuns = response;
+    if (opts?.format === "json") {
+      if (opts?.wait) {
+        const settled = await Promise.all(
+          locationRuns.map(async (r) => {
+            if (!r.id || r.status === "conflict") return r;
+            const final = await pollRun(client, r.id);
+            return { ...r, ...final };
+          })
+        );
+        console.log(JSON.stringify(settled, null, 2));
+      } else {
+        console.log(JSON.stringify(locationRuns, null, 2));
+      }
+      return;
+    }
+    console.log(`Triggered ${locationRuns.length} location sweep(s) \u2014 ${locationRuns.length}\xD7 API calls:
+`);
+    console.log("  LOCATION         RUN ID                                STATUS");
+    console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    for (const r of locationRuns) {
+      const loc = (r.location ?? "(unknown)").padEnd(15);
+      const id = (r.id ?? "(conflict)").padEnd(36);
+      console.log(`  ${loc}  ${id}  ${r.status}`);
+    }
+    if (opts?.wait) {
+      const pending = locationRuns.filter((r) => r.id && r.status !== "conflict");
+      if (pending.length > 0) {
+        process.stderr.write(`Waiting for ${pending.length} run(s)`);
+        await Promise.all(
+          pending.map(async (r) => {
+            const final = await pollRun(client, r.id);
+            r.status = final.status;
+          })
+        );
+        process.stderr.write("\n");
+        console.log("\nFinal statuses:");
+        for (const r of locationRuns) {
+          const loc = (r.location ?? "(unknown)").padEnd(15);
+          console.log(`  ${loc}  ${r.status}`);
+        }
+      }
+    }
+    return;
+  }
+  const run = response;
   if (opts?.wait) {
     process.stderr.write(`Run ${run.id} started`);
     const result = await pollRun(client, run.id);
@@ -1581,6 +1713,109 @@ async function googleInspections(project, opts) {
     );
   }
 }
+async function googleCoverage(project, format) {
+  const client = getClient11();
+  const result = await client.gscCoverage(project);
+  if (format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  const { summary } = result;
+  if (summary.total === 0) {
+    console.log('No URL inspections found. Run "canonry google inspect-sitemap <project>" first.');
+    return;
+  }
+  const pctColor = summary.percentage >= 80 ? "\x1B[32m" : summary.percentage >= 50 ? "\x1B[33m" : "\x1B[31m";
+  const reset = "\x1B[0m";
+  console.log(`
+Index Coverage for "${project}"
+`);
+  console.log(`  SUMMARY: ${pctColor}${summary.indexed} / ${summary.total} pages indexed (${summary.percentage}%)${reset}
+`);
+  if (result.indexed.length > 0) {
+    console.log(`  INDEXED (${result.indexed.length}):`);
+    for (const page of result.indexed) {
+      const crawl = page.crawlTime ? ` (crawled: ${page.crawlTime.split("T")[0]})` : "";
+      console.log(`    ${page.url}${crawl}`);
+    }
+    console.log();
+  }
+  if (result.notIndexed.length > 0) {
+    console.log(`  NOT INDEXED (${result.notIndexed.length}):`);
+    for (const page of result.notIndexed) {
+      const reason = page.coverageState ? ` \u2014 ${page.coverageState}` : "";
+      console.log(`    ${page.url}${reason}`);
+    }
+    console.log();
+  }
+  if (result.deindexed.length > 0) {
+    console.log(`  DEINDEXED (${result.deindexed.length}):`);
+    for (const page of result.deindexed) {
+      console.log(`    ${page.url}  (${page.previousState} -> ${page.currentState})`);
+    }
+    console.log();
+  }
+  if (result.lastInspectedAt) {
+    console.log(`  Last inspected: ${result.lastInspectedAt}`);
+  }
+}
+async function googleInspectSitemap(project, opts) {
+  const client = getClient11();
+  const run = await client.gscInspectSitemap(project, {
+    sitemapUrl: opts.sitemapUrl
+  });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(run, null, 2));
+    return;
+  }
+  console.log(`Sitemap inspection started (run ${run.id})`);
+  if (opts.wait) {
+    const timeout = 30 * 60 * 1e3;
+    const start = Date.now();
+    process.stderr.write("Waiting for sitemap inspection to complete");
+    while (Date.now() - start < timeout) {
+      await new Promise((r) => setTimeout(r, 3e3));
+      const current = await client.getRun(run.id);
+      process.stderr.write(".");
+      if (current.status === "completed" || current.status === "partial" || current.status === "failed") {
+        process.stderr.write("\n");
+        if (current.status === "completed") {
+          console.log("Sitemap inspection completed successfully.");
+        } else if (current.status === "partial") {
+          console.log("Sitemap inspection completed with some errors.");
+        } else {
+          console.error("Sitemap inspection failed.");
+        }
+        return;
+      }
+    }
+    process.stderr.write("\n");
+    console.error("Timed out waiting for sitemap inspection to complete.");
+    process.exit(1);
+  }
+}
+async function googleCoverageHistory(project, opts) {
+  const client = getClient11();
+  const rows = await client.gscCoverageHistory(project, { limit: opts.limit });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  if (rows.length === 0) {
+    console.log("No coverage history found. Run a GSC sync or sitemap inspection first.");
+    return;
+  }
+  console.log(`
+GSC Coverage History for "${project}" (${rows.length} snapshots):
+`);
+  console.log(`  ${"DATE".padEnd(12)}${"INDEXED".padEnd(10)}${"NOT INDEXED".padEnd(14)}TOP REASON`);
+  console.log(`  ${"\u2500".repeat(12)}${"\u2500".repeat(10)}${"\u2500".repeat(14)}${"\u2500".repeat(30)}`);
+  for (const row of rows) {
+    const topReason = Object.entries(row.reasonBreakdown).sort((a, b) => b[1] - a[1])[0];
+    const reasonStr = topReason ? `${topReason[0]} (${topReason[1]})` : "-";
+    console.log(`  ${row.date.padEnd(12)}${String(row.indexed).padEnd(10)}${String(row.notIndexed).padEnd(14)}${reasonStr}`);
+  }
+}
 async function googleDeindexed(project, format) {
   const client = getClient11();
   const rows = await client.gscDeindexed(project);
@@ -1618,7 +1853,12 @@ Usage:
   canonry project list                List all projects
   canonry project show <name>         Show project details
   canonry project delete <name>       Delete a project
+  canonry project add-location <name> Add a location (--label, --city, --region, --country)
+  canonry project locations <name>    List locations for a project
+  canonry project remove-location <name> <label>  Remove a location
+  canonry project set-default-location <name> <label>  Set default location
   canonry keyword add <project> <kw>  Add key phrases to a project
+  canonry keyword remove <project> <kw>  Remove key phrases from a project
   canonry keyword list <project>      List key phrases for a project
   canonry keyword import <project> <file>  Import key phrases from file
   canonry keyword generate <project>  Auto-generate key phrases (--provider, --count, --save)
@@ -1626,6 +1866,9 @@ Usage:
   canonry competitor list <project>   List competitors
   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
+  canonry run <project> --all-locations    Run for every configured location (N\xD7 API calls)
+  canonry run <project> --no-location      Explicitly skip location context
   canonry run <project> --wait        Trigger and wait for completion
   canonry run --all                   Trigger runs for all projects
   canonry run show <id>               Show run details and snapshots
@@ -1653,6 +1896,8 @@ Usage:
   canonry google sync <project>       Sync GSC data (--days 30, --full, --wait)
   canonry google performance <project>  Show GSC search performance data
   canonry google inspect <project> <url>  Inspect a URL via GSC
+  canonry google inspect-sitemap <project>  Bulk inspect all URLs from sitemap (--sitemap-url, --wait)
+  canonry google coverage <project>  Show index coverage summary
   canonry google inspections <project>  Show URL inspection history (--url <url>)
   canonry google deindexed <project>  Show pages that lost indexing
   canonry settings                    Show active provider and quota settings
@@ -1684,6 +1929,9 @@ Options:
   --language <lang>    Language code (default: en)
   --provider <name>    Provider to use (gemini, openai, claude, local)
   --format <fmt>       Output format: text (default) or json
+  --location <label>   Run with a specific configured location
+  --all-locations      Run for every configured location
+  --no-location        Explicitly skip location context
   --wait               Wait for run to complete before returning
   --all                Run all projects (with 'run' command)
   --include-results    Include results in export
@@ -1877,9 +2125,68 @@ async function main() {
             await deleteProject(name);
             break;
           }
+          case "add-location": {
+            const name = args[2];
+            if (!name) {
+              console.error("Error: project name is required");
+              process.exit(1);
+            }
+            const { values: locValues } = parseArgs({
+              args: args.slice(3),
+              options: {
+                label: { type: "string" },
+                city: { type: "string" },
+                region: { type: "string" },
+                country: { type: "string" },
+                timezone: { type: "string" }
+              },
+              allowPositionals: false
+            });
+            if (!locValues.label || !locValues.city || !locValues.region || !locValues.country) {
+              console.error("Error: --label, --city, --region, and --country are all required");
+              process.exit(1);
+            }
+            await addLocation(name, {
+              label: locValues.label,
+              city: locValues.city,
+              region: locValues.region,
+              country: locValues.country,
+              timezone: locValues.timezone
+            });
+            break;
+          }
+          case "locations": {
+            const name = args[2];
+            if (!name) {
+              console.error("Error: project name is required");
+              process.exit(1);
+            }
+            await listLocations(name, format);
+            break;
+          }
+          case "remove-location": {
+            const name = args[2];
+            const label = args[3];
+            if (!name || !label) {
+              console.error("Error: project name and location label are required");
+              process.exit(1);
+            }
+            await removeLocation(name, label);
+            break;
+          }
+          case "set-default-location": {
+            const name = args[2];
+            const label = args[3];
+            if (!name || !label) {
+              console.error("Error: project name and location label are required");
+              process.exit(1);
+            }
+            await setDefaultLocation(name, label);
+            break;
+          }
           default:
             console.error(`Unknown project subcommand: ${subcommand ?? "(none)"}`);
-            console.log("Available: create, update, list, show, delete");
+            console.log("Available: create, update, list, show, delete, add-location, locations, remove-location, set-default-location");
             process.exit(1);
         }
         break;
@@ -1897,6 +2204,17 @@ async function main() {
             await addKeywords(project, kws);
             break;
           }
+          case "remove":
+          case "delete": {
+            const project = args[2];
+            const kws = args.slice(3).filter((a, i, arr) => !a.startsWith("--") && !(i > 0 && arr[i - 1].startsWith("--")));
+            if (!project || kws.length === 0) {
+              console.error("Error: project name and at least one key phrase required");
+              process.exit(1);
+            }
+            await removeKeywords(project, kws);
+            break;
+          }
           case "list": {
             const project = args[2];
             if (!project) {
@@ -1944,7 +2262,7 @@ async function main() {
           }
           default:
             console.error(`Unknown keyword subcommand: ${subcommand ?? "(none)"}`);
-            console.log("Available: add, list, import, generate");
+            console.log("Available: add, remove, list, import, generate");
             process.exit(1);
         }
         break;
@@ -1994,6 +2312,9 @@ async function main() {
             provider: { type: "string" },
             wait: { type: "boolean", default: false },
             all: { type: "boolean", default: false },
+            location: { type: "string" },
+            "all-locations": { type: "boolean", default: false },
+            "no-location": { type: "boolean", default: false },
             format: { type: "string" }
           },
           allowPositionals: true
@@ -2018,6 +2339,9 @@ async function main() {
           await triggerRun(project, {
             provider: runParsed.values.provider,
             wait: runParsed.values.wait,
+            location: runParsed.values.location,
+            allLocations: runParsed.values["all-locations"],
+            noLocation: runParsed.values["no-location"],
             format: runFormat
           });
         }
@@ -2420,6 +2744,58 @@ async function main() {
             });
             break;
           }
+          case "inspect-sitemap": {
+            const project = args[2];
+            if (!project) {
+              console.error("Error: project name is required");
+              process.exit(1);
+            }
+            const { values: inspSitemapValues } = parseArgs({
+              args: args.slice(3),
+              options: {
+                "sitemap-url": { type: "string" },
+                wait: { type: "boolean", default: false },
+                format: { type: "string" }
+              },
+              allowPositionals: false
+            });
+            await googleInspectSitemap(project, {
+              sitemapUrl: inspSitemapValues["sitemap-url"],
+              wait: inspSitemapValues.wait ?? false,
+              format: inspSitemapValues.format === "json" ? "json" : format
+            });
+            break;
+          }
+          case "coverage": {
+            const project = args[2];
+            if (!project) {
+              console.error("Error: project name is required");
+              process.exit(1);
+            }
+            await googleCoverage(project, format);
+            break;
+          }
+          case "coverage-history": {
+            const project = args[2];
+            if (!project) {
+              console.error("Error: project name is required");
+              process.exit(1);
+            }
+            const { values: histValues } = parseArgs({
+              args: args.slice(3),
+              options: {
+                limit: { type: "string" },
+                format: { type: "string" }
+              },
+              allowPositionals: false
+            });
+            const limitNum = histValues.limit ? parseInt(histValues.limit, 10) : void 0;
+            await googleCoverageHistory(project, {
+              limit: limitNum != null && !Number.isNaN(limitNum) ? limitNum : void 0,
+              format: histValues.format === "json" ? "json" : format
+            });
+            break;
+          }
           case "deindexed": {
             const project = args[2];
             if (!project) {
@@ -2431,7 +2807,7 @@ async function main() {
           }
           default:
             console.error(`Unknown google subcommand: ${subcommand ?? "(none)"}`);
-            console.log("Available: connect, disconnect, status, properties, set-property, sync, performance, inspect, inspections, deindexed");
+            console.log("Available: connect, disconnect, status, properties, set-property, sync, performance, inspect, inspect-sitemap, coverage, coverage-history, inspections, deindexed");
             process.exit(1);
         }
         break;

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "1.12.0",
+  "version": "1.13.3",
   "type": "module",
   "description": "The ultimate open-source AEO monitoring tool - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -53,12 +53,12 @@
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0"
   },
   "scripts": {