@ainyc/canonry 4.1.3 → 4.7.2

package/dist/{chunk-KCETXLDF.js → chunk-VDEMEI64.js}

@@ -12,7 +12,7 @@ import {
   queryGenerateRequestSchema,
   runTriggerRequestSchema,
   scheduleUpsertRequestSchema
-} from "./chunk-O5JZQUPX.js";
+} from "./chunk-XAW66QUX.js";
 
 // src/config.ts
 import fs from "fs";
@@ -864,8 +864,13 @@ var ApiClient = class {
   async getHealth(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/health/latest`);
   }
-  async getProjectOverview(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/overview`);
+  async getProjectOverview(project, opts) {
+    const params = new URLSearchParams();
+    if (opts?.location) params.set("location", opts.location);
+    if (opts?.since) params.set("since", opts.since);
+    const query = params.toString();
+    const path2 = `/projects/${encodeURIComponent(project)}/overview${query ? `?${query}` : ""}`;
+    return this.request("GET", path2);
   }
   async searchProject(project, opts) {
     const params = new URLSearchParams({ q: opts.q });
@@ -1153,18 +1158,25 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_project_overview",
     title: "Get project overview (composite)",
-    description: 'One-call summary for "how is project X doing?" \u2014 bundles project info, latest run, top undismissed insights, latest health snapshot, query cited rate, per-provider breakdown, and gained/lost/emerging vs the previous run. Prefer this over fanning out to separate tools.',
+    description: 'One-call summary for "how is project X doing?" \u2014 bundles project info, latest run, top undismissed insights, latest health snapshot, query cited rate, per-provider breakdown, gained/lost/emerging vs the previous run, the five score gauges (visibility, gap queries, index coverage, competitor pressure, run status), per-(provider, model) scores, configured competitors with pressure labels, an attention queue of critical/high insights, and a recent-runs sparkline. Filterable by location and time window. Prefer this over fanning out to separate tools.',
     access: "read",
     tier: "core",
-    inputSchema: projectInputSchema,
+    inputSchema: z2.object({
+      project: projectNameSchema,
+      location: z2.string().optional().describe('Filter to runs from this location label (e.g. "Boston, MA, US"). Omit for all locations.'),
+      since: z2.string().optional().describe("ISO 8601 datetime \u2014 only include runs at or after this time. Omit for full history.")
+    }),
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/overview"],
-    handler: (client, input) => client.getProjectOverview(input.project)
+    handler: (client, input) => client.getProjectOverview(input.project, {
+      location: input.location,
+      since: input.since
+    })
   }),
   defineTool({
     name: "canonry_report",
     title: "Get aggregated AEO report",
-    description: "Returns the full client-facing AEO report bundle for a project \u2014 executive summary, per-query \xD7 per-provider citation matrix, competitor landscape, AI citation sources, GSC/GA4 performance, social and AI referrals, indexing health, citations trend, prioritized insights, and recommended next steps. Same payload `canonry report <project>` consumes to render the self-contained HTML.",
+    description: "Returns the full canonical AEO report bundle for a project \u2014 executive summary, client summary, agency diagnostics, action plan, per-query \xD7 per-provider citation matrix, competitor landscape, AI citation sources, GSC/GA4 performance, social and AI referrals, indexing health, citations trend, prioritized insights, and recommended next steps. Same payload `canonry report <project>` consumes to render audience-specific HTML.",
     access: "read",
     tier: "monitoring",
     inputSchema: projectInputSchema,

package/dist/{chunk-O5JZQUPX.js → chunk-XAW66QUX.js}

@@ -42,6 +42,39 @@ var locationContextSchema = z.object({
   country: z.string().length(2),
   timezone: z.string().optional()
 });
+var PROVIDER_LOCATION_HANDLING = {
+  gemini: {
+    treatment: "prompt",
+    description: "Location appended to the query text the Gemini model receives."
+  },
+  perplexity: {
+    treatment: "prompt",
+    description: "Location appended to the query text the Perplexity model receives."
+  },
+  local: {
+    treatment: "prompt",
+    description: "Location appended to the system message sent to the local model."
+  },
+  openai: {
+    treatment: "request-param",
+    description: "Location sent as a structured `user_location` field on OpenAI\u2019s web_search_preview tool."
+  },
+  claude: {
+    treatment: "request-param",
+    description: "Location sent as a structured `user_location` field on Anthropic\u2019s web_search_20250305 tool."
+  },
+  "cdp:chatgpt": {
+    treatment: "browser-geo",
+    description: "CDP relies on the browser session\u2019s own geolocation; canonry\u2019s configured location is not forwarded."
+  }
+};
+var UNKNOWN_PROVIDER_HANDLING = {
+  treatment: "ignored",
+  description: "No documented location handling for this provider \u2014 assume the configured location was not applied."
+};
+function getProviderLocationHandling(provider) {
+  return PROVIDER_LOCATION_HANDLING[provider] ?? UNKNOWN_PROVIDER_HANDLING;
+}
 
 // ../contracts/src/run.ts
 var runStatusSchema = z2.enum(["queued", "running", "completed", "partial", "failed", "cancelled"]);
@@ -1030,6 +1063,29 @@ function windowCutoff(window) {
 
 // ../contracts/src/source-categories.ts
 var SOURCE_CATEGORY_RULES = [
+  // Directories, marketplaces & review platforms — generic across industries.
+  // Industry-specific directories (NRCA, GAF, etc.) intentionally omitted;
+  // they would slip past for the next vertical and create maintenance churn.
+  { pattern: "yelp.com", category: "directory", label: "Yelp" },
+  { pattern: "angi.com", category: "directory", label: "Angi" },
+  { pattern: "angieslist.com", category: "directory", label: "Angi" },
+  { pattern: "homeadvisor.com", category: "directory", label: "HomeAdvisor" },
+  { pattern: "bbb.org", category: "directory", label: "Better Business Bureau" },
+  { pattern: "trustpilot.com", category: "directory", label: "Trustpilot" },
+  { pattern: "houzz.com", category: "directory", label: "Houzz" },
+  { pattern: "thumbtack.com", category: "directory", label: "Thumbtack" },
+  { pattern: "nextdoor.com", category: "directory", label: "Nextdoor" },
+  { pattern: "yellowpages.com", category: "directory", label: "Yellow Pages" },
+  { pattern: "manta.com", category: "directory", label: "Manta" },
+  { pattern: "foursquare.com", category: "directory", label: "Foursquare" },
+  { pattern: "g2.com", category: "directory", label: "G2" },
+  { pattern: "capterra.com", category: "directory", label: "Capterra" },
+  { pattern: "getapp.com", category: "directory", label: "GetApp" },
+  { pattern: "softwareadvice.com", category: "directory", label: "Software Advice" },
+  { pattern: "trustradius.com", category: "directory", label: "TrustRadius" },
+  { pattern: "producthunt.com", category: "directory", label: "Product Hunt" },
+  { pattern: "glassdoor.com", category: "directory", label: "Glassdoor" },
+  { pattern: "indeed.com", category: "directory", label: "Indeed" },
   // Forums
   { pattern: "reddit.com", category: "forum", label: "Reddit" },
   { pattern: "quora.com", category: "forum", label: "Quora" },
@@ -1090,6 +1146,8 @@ var SOURCE_CATEGORY_RULES = [
   { pattern: ".edu", category: "academic", label: "Academic (.edu)" }
 ];
 var CATEGORY_LABELS = {
+  competitor: "Tracked competitors",
+  directory: "Directories & review sites",
   social: "Social Media",
   forum: "Forums & Q&A",
   news: "News & Media",
@@ -1098,7 +1156,7 @@ var CATEGORY_LABELS = {
   ecommerce: "E-commerce",
   video: "Video",
   academic: "Academic",
-  other: "Other"
+  other: "Independent sites"
 };
 function categorizeSource(uri) {
   let domain;
@@ -1116,6 +1174,13 @@ function categorizeSource(uri) {
   }
   return { category: "other", label: CATEGORY_LABELS.other, domain };
 }
+function categorizeSourceWithCompetitors(uri, competitorDomains, isCompetitorMatch) {
+  const base = categorizeSource(uri);
+  if (isCompetitorMatch(base.domain, competitorDomains)) {
+    return { category: "competitor", label: CATEGORY_LABELS.competitor, domain: base.domain };
+  }
+  return base;
+}
 function categoryLabel(category) {
   return CATEGORY_LABELS[category];
 }
@@ -1509,7 +1574,16 @@ var projectSearchInsightHitSchema = z15.object({
   kind: z15.literal("insight"),
   id: z15.string(),
   runId: z15.string().nullable(),
-  type: z15.enum(["regression", "gain", "opportunity"]),
+  type: z15.enum([
+    "regression",
+    "gain",
+    "opportunity",
+    "first-citation",
+    "provider-pickup",
+    "persistent-gap",
+    "competitor-gained",
+    "competitor-lost"
+  ]),
   severity: z15.enum(["critical", "high", "medium", "low"]),
   title: z15.string(),
   query: z15.string(),
@@ -1888,6 +1962,14 @@ function citationStateToCited(state) {
   return state === "cited";
 }
 
+// ../contracts/src/report.ts
+function reportActionTone(action) {
+  if (action.horizon === "immediate") return "negative";
+  if (action.confidence === "high") return "caution";
+  if (action.confidence === "low") return "neutral";
+  return "caution";
+}
+
 // ../contracts/src/skills.ts
 import { z as z19 } from "zod";
 var codingAgentSchema = z19.enum(["claude", "codex"]);
@@ -1902,6 +1984,7 @@ export {
   isBrowserProvider,
   resolveProviderInput,
   locationContextSchema,
+  getProviderLocationHandling,
   notificationEventSchema,
   notificationCreateRequestSchema,
   findDuplicateLocationLabels,
@@ -1951,6 +2034,7 @@ export {
   parseWindow,
   windowCutoff,
   categorizeSource,
+  categorizeSourceWithCompetitors,
   categoryLabel,
   extractAnswerMentions,
   determineAnswerMentioned,
@@ -1971,6 +2055,7 @@ export {
   normalizeUrlPath,
   emptyCitationVisibility,
   citationStateToCited,
+  reportActionTone,
   CodingAgents,
   skillsClientSchema,
   SkillsClients

package/dist/cli.js

@@ -18,7 +18,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-JV6X6AFT.js";
+} from "./chunk-DVTPGC6O.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -33,7 +33,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-KCETXLDF.js";
+} from "./chunk-VDEMEI64.js";
 import {
   apiKeys,
   competitors,
@@ -45,7 +45,7 @@ import {
   projects,
   querySnapshots,
   runs
-} from "./chunk-AXMSAMKN.js";
+} from "./chunk-OOADR2Q5.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -64,7 +64,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-O5JZQUPX.js";
+} from "./chunk-XAW66QUX.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -580,7 +580,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-WPY4PDBU.js");
+  const { IntelligenceService } = await import("./intelligence-service-ABHO5HHA.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -5457,19 +5457,20 @@ var PROJECT_CLI_COMMANDS = [
 // src/commands/report.ts
 import fs5 from "fs";
 import path3 from "path";
-function defaultOutputPath(project) {
+function defaultOutputPath(project, audience) {
   const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  return path3.resolve(process.cwd(), `canonry-report-${project}-${date}.html`);
+  return path3.resolve(process.cwd(), `canonry-report-${project}-${audience}-${date}.html`);
 }
 async function runReportCommand(project, opts = {}) {
   const client = createApiClient();
   const report = await client.getReport(project);
+  const audience = opts.audience ?? "agency";
   if (opts.format === "json") {
     console.log(JSON.stringify(report, null, 2));
     return;
   }
-  const html = renderReportHtml(report);
-  const targetPath = opts.output ? path3.resolve(opts.output) : defaultOutputPath(project);
+  const html = renderReportHtml(report, { audience });
+  const targetPath = opts.output ? path3.resolve(opts.output) : defaultOutputPath(project, audience);
   const dir = path3.dirname(targetPath);
   if (!fs5.existsSync(dir)) {
     fs5.mkdirSync(dir, { recursive: true });
@@ -5479,18 +5480,27 @@ async function runReportCommand(project, opts = {}) {
 }
 
 // src/cli-commands/report.ts
-var USAGE2 = "canonry report <project> [--output <path>] [--format json]";
+var USAGE2 = "canonry report <project> [--audience agency|client] [--output <path>] [--format json]";
+function parseAudience(value) {
+  if (value === void 0) return void 0;
+  if (value === "agency" || value === "client") return value;
+  throw usageError(`Error: --audience must be "agency" or "client"
+
+Usage: ${USAGE2}`);
+}
 var REPORT_CLI_COMMANDS = [
   {
     path: ["report"],
     usage: USAGE2,
     options: {
+      audience: { type: "string" },
       output: { type: "string", short: "o" }
     },
     run: async (input) => {
       const project = requireProject(input, "report", USAGE2);
       await runReportCommand(project, {
         format: input.format,
+        audience: parseAudience(getString(input.values, "audience")),
         output: getString(input.values, "output")
       });
     }
@@ -7142,17 +7152,37 @@ async function showHealth(project, opts) {
 // src/commands/overview.ts
 async function showOverview(project, opts) {
   const client = createApiClient();
-  const overview = await client.getProjectOverview(project);
+  const overview = await client.getProjectOverview(project, {
+    location: opts.location,
+    since: opts.since
+  });
   if (opts.format === "json") {
     console.log(JSON.stringify(overview, null, 2));
     return;
   }
-  const { project: meta, latestRun, health, topInsights, queryCounts, providers, transitions } = overview;
-  console.log(`Overview: ${meta.displayName ?? meta.name} (${meta.name})
-`);
+  renderHuman(overview);
+}
+function renderHuman(overview) {
+  const {
+    project: meta,
+    latestRun,
+    health,
+    topInsights,
+    queryCounts,
+    providers,
+    transitions,
+    scores,
+    movementSummary,
+    competitors: competitors2,
+    providerScores,
+    attentionItems,
+    runHistory,
+    dateRangeLabel,
+    contextLabel
+  } = overview;
+  console.log(`Overview: ${meta.displayName ?? meta.name} (${meta.name})`);
   console.log(`  Domain:   ${meta.canonicalDomain}`);
-  console.log(`  Country:  ${meta.country}`);
-  console.log(`  Language: ${meta.language}`);
+  console.log(`  Context:  ${contextLabel} \xB7 ${dateRangeLabel}`);
   if (latestRun.run) {
     const finished = latestRun.run.finishedAt ?? "\u2014";
     console.log(`
@@ -7161,17 +7191,48 @@ async function showOverview(project, opts) {
   } else {
     console.log("\n  No runs yet.");
   }
+  console.log("\nScores:");
+  printScore("Visibility       ", scores.visibility);
+  printScore("Gap queries      ", scores.gapQueries);
+  printScore("Index coverage   ", scores.indexCoverage);
+  printScore("Competitor press.", scores.competitorPressure);
+  printScore("Run status       ", scores.runStatus);
   console.log(`
   Queries cited: ${queryCounts.citedQueries}/${queryCounts.totalQueries} (${pct(queryCounts.citedRate)})`);
+  if (movementSummary.hasPreviousRun) {
+    console.log(`  Movement: +${movementSummary.gained} gained, -${movementSummary.lost} lost (${movementSummary.tone})`);
+  } else if (movementSummary.gained > 0) {
+    console.log(`  Movement: ${movementSummary.gained} cited in first run`);
+  }
   if (providers.length > 0) {
-    console.log("  Providers:");
+    console.log("\n  Providers:");
     for (const p of providers) {
-      console.log(`    ${p.provider.padEnd(10)} ${p.cited}/${p.total} (${pct(p.citedRate)})`);
+      console.log(`    ${p.provider.padEnd(12)} ${p.cited}/${p.total} (${pct(p.citedRate)})`);
+    }
+  }
+  if (providerScores.length > 0) {
+    console.log("\n  Models:");
+    for (const m of providerScores) {
+      const label = `${m.provider}/${m.model ?? "unknown"}`.padEnd(28);
+      console.log(`    ${label} ${m.cited}/${m.total} (${m.score}%)`);
     }
   }
   if (transitions.since) {
     console.log(`
-  vs run at ${transitions.since}: +${transitions.gained} gained, -${transitions.lost} lost, ${transitions.emerging} emerging`);
+  Transitions since ${transitions.since}: +${transitions.gained} gained, -${transitions.lost} lost, ${transitions.emerging} emerging`);
+  }
+  if (competitors2.length > 0) {
+    console.log("\n  Competitors:");
+    for (const c of competitors2) {
+      console.log(`    ${c.domain.padEnd(28)} ${c.citationCount}/${c.totalQueries} ${c.pressureLabel}`);
+    }
+  }
+  if (attentionItems.length > 0) {
+    console.log("\n  Attention:");
+    for (const item of attentionItems) {
+      console.log(`    [${item.actionLabel}] ${item.title}`);
+      if (item.detail) console.log(`        ${item.detail}`);
+    }
   }
   if (health) {
     console.log(`
@@ -7183,6 +7244,19 @@ async function showOverview(project, opts) {
       console.log(`    [${insight.severity.toUpperCase()}] ${insight.type} \u2014 ${insight.title}`);
     }
   }
+  if (runHistory.length > 0) {
+    console.log(`
+  Run history (last ${runHistory.length}):`);
+    for (const point of runHistory) {
+      const bar = "\u2588".repeat(Math.round(point.citationRate / 10));
+      console.log(`    ${point.createdAt.slice(0, 10)} ${String(point.citationRate).padStart(3)}% ${bar}`);
+    }
+  }
+}
+function printScore(prefix, score) {
+  const tone = `[${score.tone}]`.padEnd(11);
+  const value = score.value.padEnd(8);
+  console.log(`  ${prefix} ${tone} ${value} ${score.delta}`);
 }
 function pct(value) {
   return `${(value * 100).toFixed(1)}%`;
@@ -7361,12 +7435,17 @@ var INTELLIGENCE_CLI_COMMANDS = [
   },
   {
     path: ["overview"],
-    usage: "canonry overview <project> [--format json]",
-    options: {},
+    usage: "canonry overview <project> [--location <label>] [--since <iso>] [--format json]",
+    options: {
+      location: { type: "string" },
+      since: { type: "string" }
+    },
     run: async (input) => {
-      const usage = "canonry overview <project> [--format json]";
+      const usage = "canonry overview <project> [--location <label>] [--since <iso>] [--format json]";
       const project = requireProject(input, "overview", usage);
-      await showOverview(project, { format: input.format });
+      const location = getString(input.values, "location");
+      const since = getString(input.values, "since");
+      await showOverview(project, { format: input.format, location, since });
     }
   },
   {

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-JV6X6AFT.js";
+} from "./chunk-DVTPGC6O.js";
 import {
   loadConfig
-} from "./chunk-KCETXLDF.js";
-import "./chunk-AXMSAMKN.js";
-import "./chunk-O5JZQUPX.js";
+} from "./chunk-VDEMEI64.js";
+import "./chunk-OOADR2Q5.js";
+import "./chunk-XAW66QUX.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-WPY4PDBU.js → intelligence-service-ABHO5HHA.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-AXMSAMKN.js";
-import "./chunk-O5JZQUPX.js";
+} from "./chunk-OOADR2Q5.js";
+import "./chunk-XAW66QUX.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -2,8 +2,8 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-KCETXLDF.js";
-import "./chunk-O5JZQUPX.js";
+} from "./chunk-VDEMEI64.js";
+import "./chunk-XAW66QUX.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.1.3",
+  "version": "4.7.2",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -59,19 +59,19 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "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-provider-perplexity": "0.0.0"
   },