@ainyc/canonry 4.1.1 → 4.2.2

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

@@ -12,7 +12,7 @@ import {
   queryGenerateRequestSchema,
   runTriggerRequestSchema,
   scheduleUpsertRequestSchema
-} from "./chunk-O5JZQUPX.js";
+} from "./chunk-T2I6AO7D.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,13 +1158,20 @@ 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",

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

@@ -1509,7 +1509,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(),

package/dist/cli.js

@@ -18,7 +18,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-BQN6BBHI.js";
+} from "./chunk-HJZY4EOE.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -33,7 +33,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-KCETXLDF.js";
+} from "./chunk-SR7TGHHG.js";
 import {
   apiKeys,
   competitors,
@@ -45,11 +45,12 @@ import {
   projects,
   querySnapshots,
   runs
-} from "./chunk-NCWCPBOT.js";
+} from "./chunk-7YSI4GFA.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
   CheckStatuses,
+  CitationStates,
   CodingAgents,
   ProviderNames,
   RunKinds,
@@ -63,7 +64,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-O5JZQUPX.js";
+} from "./chunk-T2I6AO7D.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -579,7 +580,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-EITZP4KG.js");
+  const { IntelligenceService } = await import("./intelligence-service-CQGAXKKN.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -4597,8 +4598,8 @@ async function testNotification(project, id, format) {
 var EVENT_DESCRIPTIONS = {
   "citation.lost": "A query lost its citation status",
   "citation.gained": "A query gained citation status",
-  "run.completed": "A visibility run completed successfully",
-  "run.failed": "A visibility run failed",
+  "run.completed": "An AEO sweep completed successfully",
+  "run.failed": "An AEO sweep failed",
   "insight.critical": "A critical-severity insight was generated",
   "insight.high": "A high-severity insight was generated"
 };
@@ -4889,7 +4890,7 @@ async function showEvidence(project, format) {
   if (format === "json") {
     const enriched = timeline.map((entry) => ({
       ...entry,
-      cited: entry.runs[entry.runs.length - 1]?.citationState === "cited"
+      cited: entry.runs[entry.runs.length - 1]?.citationState === CitationStates.cited
     }));
     console.log(JSON.stringify(enriched, null, 2));
     return;
@@ -4903,13 +4904,13 @@ async function showEvidence(project, format) {
   for (const entry of timeline) {
     const latest = entry.runs[entry.runs.length - 1];
     if (!latest) continue;
-    const state = latest.citationState === "cited" ? "\u2713 cited" : "\u2717 not-cited";
+    const state = latest.citationState === CitationStates.cited ? "\u2713 cited" : "\u2717 not-cited";
     const transition = latest.transition !== latest.citationState ? ` (${latest.transition})` : "";
     console.log(`  ${state}${transition}  ${entry.query}`);
   }
   console.log(`
   Queries: ${timeline.length}`);
-  const cited = timeline.filter((e) => e.runs[e.runs.length - 1]?.citationState === "cited").length;
+  const cited = timeline.filter((e) => e.runs[e.runs.length - 1]?.citationState === CitationStates.cited).length;
   console.log(`  Cited:    ${cited} / ${timeline.length}`);
 }
 
@@ -5750,11 +5751,12 @@ function printRunDetail(run) {
   }
   if (run.snapshots && run.snapshots.length > 0) {
     console.log(`
-  Snapshots: ${run.snapshots.length}`);
+  Snapshots: ${run.snapshots.length}  (cell = [citation][mention];  C=cited c=not, M=mentioned m=not, \u2013=no data)`);
     for (const s of run.snapshots) {
-      const state = typeof s.answerMentioned === "boolean" ? s.answerMentioned ? "  visible  " : "  not-vis  " : s.citationState === "cited" ? "  cited    " : "  not-cited";
+      const citationGlyph = s.citationState === CitationStates.cited ? "C" : "c";
+      const mentionGlyph = typeof s.answerMentioned === "boolean" ? s.answerMentioned ? "M" : "m" : "\u2013";
       const modelLabel = s.model ? ` (${s.model})` : "";
-      console.log(`    ${state}  ${s.provider}${modelLabel}  ${s.query}`);
+      console.log(`    [${citationGlyph}${mentionGlyph}]  ${s.provider}${modelLabel}  ${s.query}`);
     }
   }
 }
@@ -6730,7 +6732,7 @@ function renderCover(pdf, report) {
     minute: "2-digit"
   }));
   pdf.keyValue("AEO Audit", `${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
-  pdf.keyValue("Visibility Gap", report.summary.visibilityGap);
+  pdf.keyValue("Visibility Gap (Citations + Mentions)", report.summary.visibilityGap);
   pdf.paragraph(report.profile.summary, { size: 11, color: INK, lineHeight: 16 });
   pdf.rule();
 }
@@ -6885,7 +6887,7 @@ function formatSnapshotMarkdown(report) {
   lines.push(`**Generated:** ${new Date(report.generatedAt).toLocaleString("en-US", { year: "numeric", month: "long", day: "numeric", hour: "numeric", minute: "2-digit" })}`);
   lines.push(`**AEO Audit Score:** ${report.audit.overallScore}/100 (${report.audit.overallGrade})`);
   lines.push("");
-  lines.push("## Visibility Gap");
+  lines.push("## Visibility Gap (Citations + Mentions)");
   lines.push("");
   lines.push(report.summary.visibilityGap);
   lines.push("");
@@ -7140,17 +7142,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(`
@@ -7159,17 +7181,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(`
@@ -7181,6 +7234,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)}%`;
@@ -7250,7 +7316,7 @@ function printSummary(data) {
     queriesMentionedOnly,
     queriesInvisible
   } = data.summary;
-  console.log("Citation visibility");
+  console.log("AEO visibility (citations + mentions)");
   if (data.summary.latestRunAt) {
     console.log(`Latest run:           ${data.summary.latestRunAt}`);
   }
@@ -7359,12 +7425,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-BQN6BBHI.js";
+} from "./chunk-HJZY4EOE.js";
 import {
   loadConfig
-} from "./chunk-KCETXLDF.js";
-import "./chunk-NCWCPBOT.js";
-import "./chunk-O5JZQUPX.js";
+} from "./chunk-SR7TGHHG.js";
+import "./chunk-7YSI4GFA.js";
+import "./chunk-T2I6AO7D.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-EITZP4KG.js → intelligence-service-CQGAXKKN.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-NCWCPBOT.js";
-import "./chunk-O5JZQUPX.js";
+} from "./chunk-7YSI4GFA.js";
+import "./chunk-T2I6AO7D.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-SR7TGHHG.js";
+import "./chunk-T2I6AO7D.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.1",
+  "version": "4.2.2",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -60,20 +60,20 @@
     "tsup": "^8.5.1",
     "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-intelligence": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "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-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-provider-openai": "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-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",